@oxog/vld 1.5.0 → 2.0.1

package/dist/validators/array.js

@@ -1,190 +0,0 @@
-import { VldBase } from './base.js';
-import { getMessages } from '../locales/index.js';
-/**
- * Immutable array validator with chainable methods
- */
-export class VldArray extends VldBase {
-    /**
-     * Private constructor to enforce immutability
-     */
-    constructor(config) {
-        super();
-        this.config = config;
-    }
-    /**
-     * Create a new array validator
-     */
-    static create(itemValidator) {
-        return new VldArray({ itemValidator });
-    }
-    /**
-     * Parse and validate an array value
-     */
-    parse(value) {
-        if (!Array.isArray(value)) {
-            throw new Error(this.config.errorMessage || getMessages().invalidArray);
-        }
-        // Validate length constraints
-        if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {
-            throw new Error(this.config.errorMessage || getMessages().arrayLength(this.config.exactLength));
-        }
-        if (this.config.minLength !== undefined && value.length < this.config.minLength) {
-            throw new Error(this.config.errorMessage || getMessages().arrayMin(this.config.minLength));
-        }
-        if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {
-            throw new Error(this.config.errorMessage || getMessages().arrayMax(this.config.maxLength));
-        }
-        // Validate each item with optimized loop and safeParse
-        const result = [];
-        const length = value.length;
-        for (let i = 0; i < length; i++) {
-            const parseResult = this.config.itemValidator.safeParse(value[i]);
-            if (!parseResult.success) {
-                throw new Error(getMessages().arrayItem(i, parseResult.error.message));
-            }
-            result[i] = parseResult.data; // Direct assignment is faster than push
-        }
-        // Check uniqueness if required
-        if (this.config.unique) {
-            const seen = new Set();
-            for (const item of result) {
-                const key = typeof item === 'object' ? this.stableStringify(item) : item;
-                if (seen.has(key)) {
-                    throw new Error('Array must contain unique items');
-                }
-                seen.add(key);
-            }
-        }
-        return result;
-    }
-    /**
-     * Safely parse and validate an array value
-     */
-    safeParse(value) {
-        try {
-            return { success: true, data: this.parse(value) };
-        }
-        catch (error) {
-            return { success: false, error: error };
-        }
-    }
-    /**
-     * Create a stable string representation of an object for hashing
-     * Handles circular references and deep nesting gracefully
-     * BUG-006 FIX: Added depth limit to prevent stack overflow
-     * BUG-NEW-003 FIX: Fixed depth tracking to properly track recursion depth
-     */
-    stableStringify(obj) {
-        const seen = new WeakSet();
-        const MAX_DEPTH = 100; // Reasonable depth limit to prevent stack overflow
-        // Helper function to sort keys and create stable representation
-        const sortedStringify = (value, depth = 0) => {
-            // Check depth limit
-            if (depth > MAX_DEPTH) {
-                return '"[Max Depth Exceeded]"';
-            }
-            // Handle primitives
-            if (value === null)
-                return 'null';
-            if (value === undefined)
-                return 'undefined';
-            if (typeof value !== 'object')
-                return JSON.stringify(value);
-            // Handle circular references
-            if (seen.has(value)) {
-                return '"[Circular]"';
-            }
-            seen.add(value);
-            try {
-                // Handle arrays
-                if (Array.isArray(value)) {
-                    const items = value.map(item => sortedStringify(item, depth + 1));
-                    return `[${items.join(',')}]`;
-                }
-                // Handle objects - sort keys for stability
-                const keys = Object.keys(value).sort();
-                const pairs = keys.map(key => {
-                    const serializedKey = JSON.stringify(key);
-                    const serializedValue = sortedStringify(value[key], depth + 1);
-                    return `${serializedKey}:${serializedValue}`;
-                });
-                return `{${pairs.join(',')}}`;
-            }
-            finally {
-                // Clean up seen set for this branch
-                seen.delete(value);
-            }
-        };
-        try {
-            return sortedStringify(obj);
-        }
-        catch (error) {
-            // Fallback to safe representation if stringify fails
-            return String(obj);
-        }
-    }
-    /**
-     * Create a new validator with minimum length constraint
-     */
-    min(length, message) {
-        return new VldArray({
-            ...this.config,
-            minLength: length,
-            errorMessage: message || getMessages().arrayMin(length)
-        });
-    }
-    /**
-     * Create a new validator with maximum length constraint
-     */
-    max(length, message) {
-        return new VldArray({
-            ...this.config,
-            maxLength: length,
-            errorMessage: message || getMessages().arrayMax(length)
-        });
-    }
-    /**
-     * Create a new validator with exact length constraint
-     */
-    length(length, message) {
-        return new VldArray({
-            ...this.config,
-            exactLength: length,
-            minLength: undefined,
-            maxLength: undefined,
-            errorMessage: message || getMessages().arrayLength(length)
-        });
-    }
-    /**
-     * Create a new validator that ensures array is not empty
-     */
-    nonempty(message) {
-        return new VldArray({
-            ...this.config,
-            minLength: 1,
-            errorMessage: message || getMessages().arrayEmpty
-        });
-    }
-    /**
-     * Create a new validator that ensures array contains unique items
-     */
-    unique(message) {
-        return new VldArray({
-            ...this.config,
-            unique: true,
-            errorMessage: message || 'Array must contain unique items'
-        });
-    }
-    /**
-     * Create a new validator with a range constraint for length
-     */
-    between(min, max, message) {
-        return new VldArray({
-            ...this.config,
-            minLength: min,
-            maxLength: max,
-            errorMessage: message || `Array length must be between ${min} and ${max}`
-        });
-    }
-}
-//# sourceMappingURL=array.js.map

package/dist/validators/array.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Configuration for array validator\r\n */\r\ninterface ArrayValidatorConfig<T> {\r\n  readonly itemValidator: VldBase<unknown, T>;\r\n  readonly minLength?: number;\r\n  readonly maxLength?: number;\r\n  readonly exactLength?: number;\r\n  readonly unique?: boolean;\r\n  readonly errorMessage?: string;\r\n}\r\n\r\n/**\r\n * Immutable array validator with chainable methods\r\n */\r\nexport class VldArray<T> extends VldBase<unknown[], T[]> {\r\n  private readonly config: ArrayValidatorConfig<T>;\r\n  \r\n  /**\r\n   * Private constructor to enforce immutability\r\n   */\r\n  private constructor(config: ArrayValidatorConfig<T>) {\r\n    super();\r\n    this.config = config;\r\n  }\r\n  \r\n  /**\r\n   * Create a new array validator\r\n   */\r\n  static create<T>(itemValidator: VldBase<unknown, T>): VldArray<T> {\r\n    return new VldArray({ itemValidator });\r\n  }\r\n  \r\n  /**\r\n   * Parse and validate an array value\r\n   */\r\n  parse(value: unknown): T[] {\r\n    if (!Array.isArray(value)) {\r\n      throw new Error(this.config.errorMessage || getMessages().invalidArray);\r\n    }\r\n    \r\n    // Validate length constraints\r\n    if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {\r\n      throw new Error(this.config.errorMessage || getMessages().arrayLength(this.config.exactLength));\r\n    }\r\n    \r\n    if (this.config.minLength !== undefined && value.length < this.config.minLength) {\r\n      throw new Error(this.config.errorMessage || getMessages().arrayMin(this.config.minLength));\r\n    }\r\n    \r\n    if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {\r\n      throw new Error(this.config.errorMessage || getMessages().arrayMax(this.config.maxLength));\r\n    }\r\n    \r\n    // Validate each item with optimized loop and safeParse\r\n    const result: T[] = [];\r\n    const length = value.length;\r\n    \r\n    for (let i = 0; i < length; i++) {\r\n      const parseResult = this.config.itemValidator.safeParse(value[i]);\r\n      if (!parseResult.success) {\r\n        throw new Error(getMessages().arrayItem(i, parseResult.error.message));\r\n      }\r\n      result[i] = parseResult.data; // Direct assignment is faster than push\r\n    }\r\n    \r\n    // Check uniqueness if required\r\n    if (this.config.unique) {\r\n      const seen = new Set<any>();\r\n      for (const item of result) {\r\n        const key = typeof item === 'object' ? this.stableStringify(item) : item;\r\n        if (seen.has(key)) {\r\n          throw new Error('Array must contain unique items');\r\n        }\r\n        seen.add(key);\r\n      }\r\n    }\r\n    \r\n    return result;\r\n  }\r\n  \r\n  /**\r\n   * Safely parse and validate an array value\r\n   */\r\n  safeParse(value: unknown): ParseResult<T[]> {\r\n    try {\r\n      return { success: true, data: this.parse(value) };\r\n    } catch (error) {\r\n      return { success: false, error: error as Error };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Create a stable string representation of an object for hashing\r\n   * Handles circular references and deep nesting gracefully\r\n   * BUG-006 FIX: Added depth limit to prevent stack overflow\r\n   * BUG-NEW-003 FIX: Fixed depth tracking to properly track recursion depth\r\n   */\r\n  private stableStringify(obj: any): string {\r\n    const seen = new WeakSet();\r\n    const MAX_DEPTH = 100; // Reasonable depth limit to prevent stack overflow\r\n\r\n    // Helper function to sort keys and create stable representation\r\n    const sortedStringify = (value: any, depth: number = 0): string => {\r\n      // Check depth limit\r\n      if (depth > MAX_DEPTH) {\r\n        return '\"[Max Depth Exceeded]\"';\r\n      }\r\n\r\n      // Handle primitives\r\n      if (value === null) return 'null';\r\n      if (value === undefined) return 'undefined';\r\n      if (typeof value !== 'object') return JSON.stringify(value);\r\n\r\n      // Handle circular references\r\n      if (seen.has(value)) {\r\n        return '\"[Circular]\"';\r\n      }\r\n\r\n      seen.add(value);\r\n\r\n      try {\r\n        // Handle arrays\r\n        if (Array.isArray(value)) {\r\n          const items = value.map(item => sortedStringify(item, depth + 1));\r\n          return `[${items.join(',')}]`;\r\n        }\r\n\r\n        // Handle objects - sort keys for stability\r\n        const keys = Object.keys(value).sort();\r\n        const pairs = keys.map(key => {\r\n          const serializedKey = JSON.stringify(key);\r\n          const serializedValue = sortedStringify(value[key], depth + 1);\r\n          return `${serializedKey}:${serializedValue}`;\r\n        });\r\n\r\n        return `{${pairs.join(',')}}`;\r\n      } finally {\r\n        // Clean up seen set for this branch\r\n        seen.delete(value);\r\n      }\r\n    };\r\n\r\n    try {\r\n      return sortedStringify(obj);\r\n    } catch (error) {\r\n      // Fallback to safe representation if stringify fails\r\n      return String(obj);\r\n    }\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with minimum length constraint\r\n   */\r\n  min(length: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      minLength: length,\r\n      errorMessage: message || getMessages().arrayMin(length)\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with maximum length constraint\r\n   */\r\n  max(length: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      maxLength: length,\r\n      errorMessage: message || getMessages().arrayMax(length)\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with exact length constraint\r\n   */\r\n  length(length: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      exactLength: length,\r\n      minLength: undefined,\r\n      maxLength: undefined,\r\n      errorMessage: message || getMessages().arrayLength(length)\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator that ensures array is not empty\r\n   */\r\n  nonempty(message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      minLength: 1,\r\n      errorMessage: message || getMessages().arrayEmpty\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator that ensures array contains unique items\r\n   */\r\n  unique(message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      unique: true,\r\n      errorMessage: message || 'Array must contain unique items'\r\n    });\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with a range constraint for length\r\n   */\r\n  between(min: number, max: number, message?: string): VldArray<T> {\r\n    return new VldArray({\r\n      ...this.config,\r\n      minLength: min,\r\n      maxLength: max,\r\n      errorMessage: message || `Array length must be between ${min} and ${max}`\r\n    });\r\n  }\r\n}"]}