schema-dsl 1.2.4 → 2.0.0

package/dist/Validator-C7GsVQOH.d.cts

@@ -0,0 +1,192 @@
+import { ValidateFunction, KeywordDefinition, Format, Ajv } from 'ajv';
+import { J as JSONSchema, c as ValidateOptions, V as ValidationResult } from './plugin-CIKtTMtS.cjs';
+
+type CacheValue = unknown;
+interface CacheStats {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+    evictions: number;
+    clears: number;
+    hitRate: string;
+    size: number;
+    maxSize: number;
+    enabled: boolean;
+}
+/**
+ * CacheManager — LRU cache for compiled AJV schemas.
+ *
+ * v2 delegates to cache-hub's MemoryCache (fix BD-04: miss returns undefined → normalized to null).
+ *
+ * cache-hub MemoryCache actual API:
+ *   get(key) → value | undefined
+ *   set(key, value, opts?) — opts.ttl in ms
+ *   del(key) → boolean           ← note: del, not delete
+ *   has(key) → boolean
+ *   clear() → void
+ *   keys() → string[]
+ *   getStats() → { hits, misses, hitRate, entries, sets, deletes, evictions, memoryUsage }
+ */
+declare class CacheManager {
+    private _enabled;
+    private _maxSize;
+    private _ttl;
+    private readonly _cache;
+    private _statsEnabled;
+    private _clears;
+    constructor(options?: {
+        maxSize?: number;
+        ttl?: number;
+        enabled?: boolean;
+        statsEnabled?: boolean;
+    });
+    get options(): {
+        maxSize: number;
+        ttl: number;
+        enabled: boolean;
+        statsEnabled: boolean;
+    };
+    set options(opts: Partial<{
+        maxSize: number;
+        ttl: number;
+        enabled: boolean;
+        statsEnabled: boolean;
+    }>);
+    /**
+     * Retrieve a cached AJV compile function.
+     * @returns cached compile function, or null on miss (BD-04: undefined → null)
+     */
+    get(key: string): CacheValue | null;
+    /**
+     * Write a value to the cache.
+     */
+    set(key: string, value: CacheValue, ttl?: number): void;
+    /**
+     * Delete a single cache entry.
+     */
+    delete(key: string): boolean;
+    /**
+     * Check whether a key exists in the cache.
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cache entries.
+     */
+    clear(): void;
+    /**
+     * Return the current number of cache entries.
+     */
+    size(): number;
+    /**
+     * Return cache statistics.
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset all hit/miss/eviction counters.
+     */
+    resetStats(): void;
+}
+
+type AjvValidateFn = ValidateFunction;
+type KeywordDefinitionInput = KeywordDefinition | ({
+    keyword?: string;
+    [key: string]: unknown;
+});
+/**
+ * ValidatorOptions — constructor options for Validator (extends AJV base options).
+ */
+interface ValidatorOptions {
+    allErrors?: boolean;
+    useDefaults?: boolean;
+    coerceTypes?: boolean | 'array';
+    removeAdditional?: boolean | 'all' | 'failing';
+    verbose?: boolean;
+    cache?: boolean | {
+        maxSize?: number;
+        ttl?: number;
+        enabled?: boolean;
+        statsEnabled?: boolean;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Validator — AJV-backed validator (v2).
+ *
+ * Fixes:
+ *   V-Y01: filter non-AJV options before new Ajv() to prevent unknown-option warnings
+ *   V-02:  sync cleanSchema.required when conditional fields are removed (v1 missed this)
+ *   V-Y03: _removeAdditional mode reuses cached internal Ajv instance (v1 created new Validator each time)
+ *   V-Y07: static quickValidate reuses a singleton Ajv (v1 created new Ajv each time)
+ */
+declare class Validator {
+    private readonly _ajvOptions;
+    private readonly _ajv;
+    private readonly _cache;
+    private readonly _errorFormatter;
+    private readonly _schemaMap;
+    private _schemaKeyCounter;
+    private readonly _conditionalFlagCache;
+    private readonly _conditionalValidator;
+    private _removeAdditionalAjv;
+    private static _quickValidateAjv;
+    constructor(options?: ValidatorOptions);
+    get ajvOptions(): Record<string, unknown>;
+    /**
+     * Compile a schema → AJV validate function (with cache).
+     */
+    compile(schema: JSONSchema, cacheKey?: string | null): AjvValidateFn;
+    /**
+     * Synchronous validation.
+     */
+    validate<T = unknown>(schema: JSONSchema | AjvValidateFn, data: T, options?: ValidateOptions): ValidationResult<T>;
+    /**
+     * Async validation (throws ValidationError on failure).
+     * V-Y02 fix: v1 validateAsync lacked smartCoerceTypes; v2 routes through _validateInternal uniformly.
+     * BC-6 fix: validateAsync runs async custom validators (sync AJV pass skips async fn; this method runs the full set).
+     */
+    validateAsync<T = unknown>(schema: JSONSchema | AjvValidateFn, data: T, options?: ValidateOptions): Promise<T>;
+    /**
+     * BC-6: run all validators in schema._customValidators (including async).
+     * AJV's sync keyword skips Promise-returning validators; this method runs the complete set in validateAsync.
+     * Returns the first failing ValidationErrorItem, or null if all pass.
+     */
+    private _runCustomValidators;
+    /**
+     * Batch validation (compile once, reuse for each item).
+     */
+    validateBatch<T = unknown>(schema: JSONSchema, dataArray: T[]): ValidationResult<T>[];
+    /**
+     * Add a custom keyword.
+     */
+    addKeyword(keyword: string, definition: KeywordDefinitionInput): this;
+    /**
+     * Add a custom format.
+     */
+    addFormat(name: string, validator: Format): this;
+    /**
+     * Add a schema reference.
+     */
+    addSchema(uri: string, schema: JSONSchema): this;
+    /**
+     * Remove a schema reference.
+     */
+    removeSchema(uri: string): this;
+    getAjv(): InstanceType<typeof Ajv>;
+    get cache(): CacheManager;
+    clearCache(): void;
+    getCacheStats(): CacheStats;
+    static create(options?: ValidatorOptions): Validator;
+    /**
+     * Quick validate (V-Y07 fix: reuses singleton Ajv instead of creating new Ajv each time).
+     */
+    static quickValidate(schema: JSONSchema, data: unknown): boolean;
+    private _validateInternal;
+    private _generateCacheKey;
+    private readonly _flatLocaleCache;
+    private _getFlatLocaleMessages;
+    private _formatErrors;
+    private _internalError;
+}
+
+export { CacheManager as C, Validator as V };

package/dist/Validator-hFWKGxir.d.ts

@@ -0,0 +1,192 @@
+import { ValidateFunction, KeywordDefinition, Format, Ajv } from 'ajv';
+import { J as JSONSchema, c as ValidateOptions, V as ValidationResult } from './plugin-CIKtTMtS.js';
+
+type CacheValue = unknown;
+interface CacheStats {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+    evictions: number;
+    clears: number;
+    hitRate: string;
+    size: number;
+    maxSize: number;
+    enabled: boolean;
+}
+/**
+ * CacheManager — LRU cache for compiled AJV schemas.
+ *
+ * v2 delegates to cache-hub's MemoryCache (fix BD-04: miss returns undefined → normalized to null).
+ *
+ * cache-hub MemoryCache actual API:
+ *   get(key) → value | undefined
+ *   set(key, value, opts?) — opts.ttl in ms
+ *   del(key) → boolean           ← note: del, not delete
+ *   has(key) → boolean
+ *   clear() → void
+ *   keys() → string[]
+ *   getStats() → { hits, misses, hitRate, entries, sets, deletes, evictions, memoryUsage }
+ */
+declare class CacheManager {
+    private _enabled;
+    private _maxSize;
+    private _ttl;
+    private readonly _cache;
+    private _statsEnabled;
+    private _clears;
+    constructor(options?: {
+        maxSize?: number;
+        ttl?: number;
+        enabled?: boolean;
+        statsEnabled?: boolean;
+    });
+    get options(): {
+        maxSize: number;
+        ttl: number;
+        enabled: boolean;
+        statsEnabled: boolean;
+    };
+    set options(opts: Partial<{
+        maxSize: number;
+        ttl: number;
+        enabled: boolean;
+        statsEnabled: boolean;
+    }>);
+    /**
+     * Retrieve a cached AJV compile function.
+     * @returns cached compile function, or null on miss (BD-04: undefined → null)
+     */
+    get(key: string): CacheValue | null;
+    /**
+     * Write a value to the cache.
+     */
+    set(key: string, value: CacheValue, ttl?: number): void;
+    /**
+     * Delete a single cache entry.
+     */
+    delete(key: string): boolean;
+    /**
+     * Check whether a key exists in the cache.
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cache entries.
+     */
+    clear(): void;
+    /**
+     * Return the current number of cache entries.
+     */
+    size(): number;
+    /**
+     * Return cache statistics.
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset all hit/miss/eviction counters.
+     */
+    resetStats(): void;
+}
+
+type AjvValidateFn = ValidateFunction;
+type KeywordDefinitionInput = KeywordDefinition | ({
+    keyword?: string;
+    [key: string]: unknown;
+});
+/**
+ * ValidatorOptions — constructor options for Validator (extends AJV base options).
+ */
+interface ValidatorOptions {
+    allErrors?: boolean;
+    useDefaults?: boolean;
+    coerceTypes?: boolean | 'array';
+    removeAdditional?: boolean | 'all' | 'failing';
+    verbose?: boolean;
+    cache?: boolean | {
+        maxSize?: number;
+        ttl?: number;
+        enabled?: boolean;
+        statsEnabled?: boolean;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Validator — AJV-backed validator (v2).
+ *
+ * Fixes:
+ *   V-Y01: filter non-AJV options before new Ajv() to prevent unknown-option warnings
+ *   V-02:  sync cleanSchema.required when conditional fields are removed (v1 missed this)
+ *   V-Y03: _removeAdditional mode reuses cached internal Ajv instance (v1 created new Validator each time)
+ *   V-Y07: static quickValidate reuses a singleton Ajv (v1 created new Ajv each time)
+ */
+declare class Validator {
+    private readonly _ajvOptions;
+    private readonly _ajv;
+    private readonly _cache;
+    private readonly _errorFormatter;
+    private readonly _schemaMap;
+    private _schemaKeyCounter;
+    private readonly _conditionalFlagCache;
+    private readonly _conditionalValidator;
+    private _removeAdditionalAjv;
+    private static _quickValidateAjv;
+    constructor(options?: ValidatorOptions);
+    get ajvOptions(): Record<string, unknown>;
+    /**
+     * Compile a schema → AJV validate function (with cache).
+     */
+    compile(schema: JSONSchema, cacheKey?: string | null): AjvValidateFn;
+    /**
+     * Synchronous validation.
+     */
+    validate<T = unknown>(schema: JSONSchema | AjvValidateFn, data: T, options?: ValidateOptions): ValidationResult<T>;
+    /**
+     * Async validation (throws ValidationError on failure).
+     * V-Y02 fix: v1 validateAsync lacked smartCoerceTypes; v2 routes through _validateInternal uniformly.
+     * BC-6 fix: validateAsync runs async custom validators (sync AJV pass skips async fn; this method runs the full set).
+     */
+    validateAsync<T = unknown>(schema: JSONSchema | AjvValidateFn, data: T, options?: ValidateOptions): Promise<T>;
+    /**
+     * BC-6: run all validators in schema._customValidators (including async).
+     * AJV's sync keyword skips Promise-returning validators; this method runs the complete set in validateAsync.
+     * Returns the first failing ValidationErrorItem, or null if all pass.
+     */
+    private _runCustomValidators;
+    /**
+     * Batch validation (compile once, reuse for each item).
+     */
+    validateBatch<T = unknown>(schema: JSONSchema, dataArray: T[]): ValidationResult<T>[];
+    /**
+     * Add a custom keyword.
+     */
+    addKeyword(keyword: string, definition: KeywordDefinitionInput): this;
+    /**
+     * Add a custom format.
+     */
+    addFormat(name: string, validator: Format): this;
+    /**
+     * Add a schema reference.
+     */
+    addSchema(uri: string, schema: JSONSchema): this;
+    /**
+     * Remove a schema reference.
+     */
+    removeSchema(uri: string): this;
+    getAjv(): InstanceType<typeof Ajv>;
+    get cache(): CacheManager;
+    clearCache(): void;
+    getCacheStats(): CacheStats;
+    static create(options?: ValidatorOptions): Validator;
+    /**
+     * Quick validate (V-Y07 fix: reuses singleton Ajv instead of creating new Ajv each time).
+     */
+    static quickValidate(schema: JSONSchema, data: unknown): boolean;
+    private _validateInternal;
+    private _generateCacheKey;
+    private readonly _flatLocaleCache;
+    private _getFlatLocaleMessages;
+    private _formatErrors;
+    private _internalError;
+}
+
+export { CacheManager as C, Validator as V };