@oxog/vld 1.2.0 → 1.4.0

package/dist/validators/array.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Immutable array validator with chainable methods
  */
@@ -48,7 +48,7 @@ export class VldArray extends VldBase {
         if (this.config.unique) {
             const seen = new Set();
             for (const item of result) {
-                const key = typeof item === 'object' ? JSON.stringify(item) : item;
+                const key = typeof item === 'object' ? this.stableStringify(item) : item;
                 if (seen.has(key)) {
                     throw new Error('Array must contain unique items');
                 }
@@ -68,6 +68,61 @@ export class VldArray extends VldBase {
             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
      */

package/dist/validators/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAczC;;GAEG;AACH,MAAM,OAAO,QAAY,SAAQ,OAAuB;IAGtD;;OAEG;IACH,YAAoB,MAA+B;QACjD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAI,aAAkC;QACjD,OAAO,IAAI,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC;QAC1E,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChF,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChF,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,uDAAuD;QACvD,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,wCAAwC;QACxE,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAO,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACrD,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAgB;QAClC,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAE,OAAgB;QAClC,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,OAAgB;QACrC,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAgB;QACvB,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,UAAU;SAClD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAgB;QACrB,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,OAAO,IAAI,iCAAiC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW,EAAE,GAAW,EAAE,OAAgB;QAChD,OAAO,IAAI,QAAQ,CAAC;YAClB,GAAG,IAAI,CAAC,MAAM;YACd,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,OAAO,IAAI,gCAAgC,GAAG,QAAQ,GAAG,EAAE;SAC1E,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Configuration for array validator\n */\ninterface ArrayValidatorConfig<T> {\n  readonly itemValidator: VldBase<unknown, T>;\n  readonly minLength?: number;\n  readonly maxLength?: number;\n  readonly exactLength?: number;\n  readonly unique?: boolean;\n  readonly errorMessage?: string;\n}\n\n/**\n * Immutable array validator with chainable methods\n */\nexport class VldArray<T> extends VldBase<unknown[], T[]> {\n  private readonly config: ArrayValidatorConfig<T>;\n  \n  /**\n   * Private constructor to enforce immutability\n   */\n  private constructor(config: ArrayValidatorConfig<T>) {\n    super();\n    this.config = config;\n  }\n  \n  /**\n   * Create a new array validator\n   */\n  static create<T>(itemValidator: VldBase<unknown, T>): VldArray<T> {\n    return new VldArray({ itemValidator });\n  }\n  \n  /**\n   * Parse and validate an array value\n   */\n  parse(value: unknown): T[] {\n    if (!Array.isArray(value)) {\n      throw new Error(this.config.errorMessage || getMessages().invalidArray);\n    }\n    \n    // Validate length constraints\n    if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayLength(this.config.exactLength));\n    }\n    \n    if (this.config.minLength !== undefined && value.length < this.config.minLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayMin(this.config.minLength));\n    }\n    \n    if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayMax(this.config.maxLength));\n    }\n    \n    // Validate each item with optimized loop and safeParse\n    const result: T[] = [];\n    const length = value.length;\n    \n    for (let i = 0; i < length; i++) {\n      const parseResult = this.config.itemValidator.safeParse(value[i]);\n      if (!parseResult.success) {\n        throw new Error(getMessages().arrayItem(i, parseResult.error.message));\n      }\n      result[i] = parseResult.data; // Direct assignment is faster than push\n    }\n    \n    // Check uniqueness if required\n    if (this.config.unique) {\n      const seen = new Set<any>();\n      for (const item of result) {\n        const key = typeof item === 'object' ? JSON.stringify(item) : item;\n        if (seen.has(key)) {\n          throw new Error('Array must contain unique items');\n        }\n        seen.add(key);\n      }\n    }\n    \n    return result;\n  }\n  \n  /**\n   * Safely parse and validate an array value\n   */\n  safeParse(value: unknown): ParseResult<T[]> {\n    try {\n      return { success: true, data: this.parse(value) };\n    } catch (error) {\n      return { success: false, error: error as Error };\n    }\n  }\n  \n  /**\n   * Create a new validator with minimum length constraint\n   */\n  min(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: length,\n      errorMessage: message || getMessages().arrayMin(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with maximum length constraint\n   */\n  max(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      maxLength: length,\n      errorMessage: message || getMessages().arrayMax(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with exact length constraint\n   */\n  length(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      exactLength: length,\n      minLength: undefined,\n      maxLength: undefined,\n      errorMessage: message || getMessages().arrayLength(length)\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures array is not empty\n   */\n  nonempty(message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: 1,\n      errorMessage: message || getMessages().arrayEmpty\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures array contains unique items\n   */\n  unique(message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      unique: true,\n      errorMessage: message || 'Array must contain unique items'\n    });\n  }\n  \n  /**\n   * Create a new validator with a range constraint for length\n   */\n  between(min: number, max: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: min,\n      maxLength: max,\n      errorMessage: message || `Array length must be between ${min} and ${max}`\n    });\n  }\n}"]}
+{"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}"]}

package/dist/validators/base.d.ts

@@ -8,6 +8,16 @@ export type ParseResult<T> = {
     readonly success: false;
     readonly error: Error;
 };
+/**
+ * Context for superRefine - allows adding multiple issues
+ */
+export interface SuperRefineContext {
+    addIssue(issue: {
+        message: string;
+        code?: string;
+    }): void;
+    path: (string | number)[];
+}
 /**
  * Abstract base class for all validators
  * Implements immutable pattern to prevent memory leaks and race conditions
@@ -34,6 +44,7 @@ export declare abstract class VldBase<TInput, TOutput = TInput> {
     isValid(value: unknown): boolean;
     /**
      * Parse a value or return a default if validation fails
+     * BUG-NEW-017 FIX: Validate default value to ensure type safety
      * @param value The value to validate
      * @param defaultValue The default value to return on failure
      * @returns The validated value or default
@@ -47,6 +58,12 @@ export declare abstract class VldBase<TInput, TOutput = TInput> {
      */
     refine<TRefined extends TOutput>(predicate: (value: TOutput) => value is TRefined, message?: string): VldRefine<TInput, TOutput, TRefined>;
     refine(predicate: (value: TOutput) => boolean, message?: string): VldRefine<TInput, TOutput, TOutput>;
+    /**
+     * Advanced refinement with context for adding multiple issues
+     * @param refinement The refinement function with context
+     * @returns A new super refined validator
+     */
+    superRefine(refinement: (value: TOutput, ctx: SuperRefineContext) => void | Promise<void>): VldSuperRefine<TInput, TOutput>;
     /**
      * Create a new validator that transforms the output
      * @param transformer The transformation function
@@ -80,6 +97,67 @@ export declare abstract class VldBase<TInput, TOutput = TInput> {
      * @returns A new nullish validator
      */
     nullish(): VldNullish<TInput, TOutput>;
+    /**
+     * Pipe the output of this validator into another validator
+     * @param next The next validator to pipe into
+     * @returns A new piped validator
+     */
+    pipe<TNextOutput>(next: VldBase<TOutput, TNextOutput>): VldPipe<TInput, TOutput, TNextOutput>;
+    /**
+     * Create a new validator that returns readonly output
+     * Zod 4 API parity - marks output as readonly for TypeScript
+     * @returns A new readonly validator
+     */
+    readonly(): VldReadonly<TInput, TOutput>;
+    /**
+     * Brand the output type with a unique brand for nominal typing
+     * Zod 4 API parity - prevents accidental assignment of similarly typed values
+     * @returns A new branded validator
+     * @example
+     * const userIdSchema = v.string().brand<'UserId'>();
+     * const productIdSchema = v.string().brand<'ProductId'>();
+     *
+     * let userId: UserId = userIdSchema.parse('abc');
+     * let productId: ProductId = productIdSchema.parse('xyz');
+     *
+     * userId = productId; // TypeScript error: types are incompatible
+     */
+    brand<TBrand extends string>(): VldBrand<TInput, TOutput, TBrand>;
+    /**
+     * Apply an external function to transform this validator
+     * Zod 4 API parity - allows external function chaining
+     * @param fn External function that takes this validator and returns a new validator
+     * @returns The result of applying the function to this validator
+     * @example
+     * const withLength = (schema: VldBase<unknown, string>) => schema.transform(s => s.length);
+     * const lengthSchema = v.string().apply(withLength); // validates string, returns number
+     */
+    apply<TNewOutput>(fn: (schema: this) => VldBase<TInput, TNewOutput>): VldBase<TInput, TNewOutput>;
+}
+/**
+ * Readonly validator - marks output as readonly
+ */
+export declare class VldReadonly<TInput, TOutput> extends VldBase<TInput, Readonly<TOutput>> {
+    private readonly baseValidator;
+    constructor(baseValidator: VldBase<TInput, TOutput>);
+    parse(value: unknown): Readonly<TOutput>;
+    safeParse(value: unknown): ParseResult<Readonly<TOutput>>;
+}
+/**
+ * Brand validator - adds a unique brand to the output type for nominal typing
+ * Uses TypeScript's branded types pattern to prevent accidental assignment
+ */
+export declare class VldBrand<TInput, TOutput, TBrand extends string> extends VldBase<TInput, TOutput & {
+    readonly __brand: TBrand;
+}> {
+    private readonly baseValidator;
+    constructor(baseValidator: VldBase<TInput, TOutput>);
+    parse(value: unknown): TOutput & {
+        readonly __brand: TBrand;
+    };
+    safeParse(value: unknown): ParseResult<TOutput & {
+        readonly __brand: TBrand;
+    }>;
 }
 /**
  * Refine validator - adds custom validation
@@ -111,6 +189,25 @@ export declare class VldDefault<TInput, TOutput> extends VldBase<TInput | undefi
     constructor(baseValidator: VldBase<TInput, TOutput>, defaultValue: TOutput);
     parse(value: unknown): TOutput;
     safeParse(value: unknown): ParseResult<TOutput>;
+    /**
+     * Pre-parse default - validates the default value instead of returning it directly
+     * This is useful when the default value needs to be validated against the schema
+     */
+    prefault(): VldPrefault<TInput, TOutput>;
+}
+/**
+ * Prefault validator - validates the default value instead of returning it directly
+ */
+export declare class VldPrefault<TInput, TOutput> extends VldBase<TInput | undefined, TOutput> {
+    private readonly baseValidator;
+    private readonly defaultValue;
+    constructor(baseValidator: VldBase<TInput, TOutput>, defaultValue: TOutput);
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+    /**
+     * Calling prefault multiple times should be safe - return self
+     */
+    prefault(): VldPrefault<TInput, TOutput>;
 }
 /**
  * Catch validator - provides fallback value on validation error
@@ -131,6 +228,7 @@ export declare class VldOptional<TInput, TOutput> extends VldBase<TInput | undef
     static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldOptional<TInput, TOutput>;
     parse(value: unknown): TOutput | undefined;
     safeParse(value: unknown): ParseResult<TOutput | undefined>;
+    unwrap(): VldBase<TInput, TOutput>;
 }
 /**
  * Nullable validator - allows null
@@ -141,6 +239,7 @@ export declare class VldNullable<TInput, TOutput> extends VldBase<TInput | null,
     static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullable<TInput, TOutput>;
     parse(value: unknown): TOutput | null;
     safeParse(value: unknown): ParseResult<TOutput | null>;
+    unwrap(): VldBase<TInput, TOutput>;
 }
 /**
  * Nullish validator - allows null or undefined
@@ -151,5 +250,37 @@ export declare class VldNullish<TInput, TOutput> extends VldBase<TInput | null |
     static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullish<TInput, TOutput>;
     parse(value: unknown): TOutput | null | undefined;
     safeParse(value: unknown): ParseResult<TOutput | null | undefined>;
+    unwrap(): VldBase<TInput, TOutput>;
+}
+/**
+ * Pipe validator - chains validators, passing output of one to the next
+ */
+export declare class VldPipe<TInput, TIntermediate, TOutput> extends VldBase<TInput, TOutput> {
+    private readonly first;
+    private readonly second;
+    constructor(first: VldBase<TInput, TIntermediate>, second: VldBase<TIntermediate, TOutput>);
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+}
+/**
+ * SuperRefine validator - advanced refinement with context
+ */
+export declare class VldSuperRefine<TInput, TOutput> extends VldBase<TInput, TOutput> {
+    private readonly _inner;
+    private readonly _refinement;
+    constructor(_inner: VldBase<TInput, TOutput>, _refinement: (value: TOutput, ctx: SuperRefineContext) => void | Promise<void>);
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+}
+/**
+ * Preprocess validator - transforms input before validation
+ */
+export declare class VldPreprocess<TInput, TOutput> extends VldBase<unknown, TOutput> {
+    private readonly _preprocessor;
+    private readonly _schema;
+    constructor(_preprocessor: (input: unknown) => unknown, _schema: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(preprocessor: (input: unknown) => unknown, schema: VldBase<TInput, TOutput>): VldPreprocess<TInput, TOutput>;
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/validators/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/validators/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/validators/base.ts"],"names":[],"mappings":"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"}

package/dist/validators/base.js

@@ -13,17 +13,34 @@ export class VldBase {
     }
     /**
      * Parse a value or return a default if validation fails
+     * BUG-NEW-017 FIX: Validate default value to ensure type safety
      * @param value The value to validate
      * @param defaultValue The default value to return on failure
      * @returns The validated value or default
      */
     parseOrDefault(value, defaultValue) {
         const result = this.safeParse(value);
-        return result.success ? result.data : defaultValue;
+        if (result.success) {
+            return result.data;
+        }
+        // Validate the default value to ensure it's actually valid
+        const defaultResult = this.safeParse(defaultValue);
+        if (!defaultResult.success) {
+            throw new Error(`Invalid default value provided: ${defaultResult.error.message}`);
+        }
+        return defaultResult.data;
     }
     refine(predicate, message) {
         return new VldRefine(this, predicate, message);
     }
+    /**
+     * Advanced refinement with context for adding multiple issues
+     * @param refinement The refinement function with context
+     * @returns A new super refined validator
+     */
+    superRefine(refinement) {
+        return new VldSuperRefine(this, refinement);
+    }
     /**
      * Create a new validator that transforms the output
      * @param transformer The transformation function
@@ -69,6 +86,92 @@ export class VldBase {
     nullish() {
         return new VldNullish(this);
     }
+    /**
+     * Pipe the output of this validator into another validator
+     * @param next The next validator to pipe into
+     * @returns A new piped validator
+     */
+    pipe(next) {
+        return new VldPipe(this, next);
+    }
+    /**
+     * Create a new validator that returns readonly output
+     * Zod 4 API parity - marks output as readonly for TypeScript
+     * @returns A new readonly validator
+     */
+    readonly() {
+        return new VldReadonly(this);
+    }
+    /**
+     * Brand the output type with a unique brand for nominal typing
+     * Zod 4 API parity - prevents accidental assignment of similarly typed values
+     * @returns A new branded validator
+     * @example
+     * const userIdSchema = v.string().brand<'UserId'>();
+     * const productIdSchema = v.string().brand<'ProductId'>();
+     *
+     * let userId: UserId = userIdSchema.parse('abc');
+     * let productId: ProductId = productIdSchema.parse('xyz');
+     *
+     * userId = productId; // TypeScript error: types are incompatible
+     */
+    brand() {
+        return new VldBrand(this);
+    }
+    /**
+     * Apply an external function to transform this validator
+     * Zod 4 API parity - allows external function chaining
+     * @param fn External function that takes this validator and returns a new validator
+     * @returns The result of applying the function to this validator
+     * @example
+     * const withLength = (schema: VldBase<unknown, string>) => schema.transform(s => s.length);
+     * const lengthSchema = v.string().apply(withLength); // validates string, returns number
+     */
+    apply(fn) {
+        return fn(this);
+    }
+}
+/**
+ * Readonly validator - marks output as readonly
+ */
+export class VldReadonly extends VldBase {
+    constructor(baseValidator) {
+        super();
+        this.baseValidator = baseValidator;
+    }
+    parse(value) {
+        return this.baseValidator.parse(value);
+    }
+    safeParse(value) {
+        const result = this.baseValidator.safeParse(value);
+        if (result.success) {
+            return { success: true, data: result.data };
+        }
+        return result;
+    }
+}
+/**
+ * Brand validator - adds a unique brand to the output type for nominal typing
+ * Uses TypeScript's branded types pattern to prevent accidental assignment
+ */
+export class VldBrand extends VldBase {
+    constructor(baseValidator) {
+        super();
+        this.baseValidator = baseValidator;
+    }
+    parse(value) {
+        return this.baseValidator.parse(value);
+    }
+    safeParse(value) {
+        const result = this.baseValidator.safeParse(value);
+        if (result.success) {
+            return {
+                success: true,
+                data: result.data
+            };
+        }
+        return result;
+    }
 }
 /**
  * Refine validator - adds custom validation
@@ -144,6 +247,43 @@ export class VldDefault extends VldBase {
         }
         return this.baseValidator.safeParse(value);
     }
+    /**
+     * Pre-parse default - validates the default value instead of returning it directly
+     * This is useful when the default value needs to be validated against the schema
+     */
+    prefault() {
+        // Return a new validator that validates the default value when parse(undefined) is called
+        return new VldPrefault(this.baseValidator, this.defaultValue);
+    }
+}
+/**
+ * Prefault validator - validates the default value instead of returning it directly
+ */
+export class VldPrefault extends VldBase {
+    constructor(baseValidator, defaultValue) {
+        super();
+        this.baseValidator = baseValidator;
+        this.defaultValue = defaultValue;
+    }
+    parse(value) {
+        if (value === undefined) {
+            // Validate the default value through the base validator
+            return this.baseValidator.parse(this.defaultValue);
+        }
+        return this.baseValidator.parse(value);
+    }
+    safeParse(value) {
+        if (value === undefined) {
+            return this.baseValidator.safeParse(this.defaultValue);
+        }
+        return this.baseValidator.safeParse(value);
+    }
+    /**
+     * Calling prefault multiple times should be safe - return self
+     */
+    prefault() {
+        return this;
+    }
 }
 /**
  * Catch validator - provides fallback value on validation error
@@ -193,6 +333,9 @@ export class VldOptional extends VldBase {
         }
         return this.baseValidator.safeParse(value);
     }
+    unwrap() {
+        return this.baseValidator;
+    }
 }
 /**
  * Nullable validator - allows null
@@ -217,6 +360,9 @@ export class VldNullable extends VldBase {
         }
         return this.baseValidator.safeParse(value);
     }
+    unwrap() {
+        return this.baseValidator;
+    }
 }
 /**
  * Nullish validator - allows null or undefined
@@ -241,5 +387,105 @@ export class VldNullish extends VldBase {
         }
         return this.baseValidator.safeParse(value);
     }
+    unwrap() {
+        return this.baseValidator;
+    }
+}
+/**
+ * Pipe validator - chains validators, passing output of one to the next
+ */
+export class VldPipe extends VldBase {
+    constructor(first, second) {
+        super();
+        this.first = first;
+        this.second = second;
+    }
+    parse(value) {
+        const intermediateResult = this.first.parse(value);
+        return this.second.parse(intermediateResult);
+    }
+    safeParse(value) {
+        const firstResult = this.first.safeParse(value);
+        if (!firstResult.success) {
+            return firstResult;
+        }
+        return this.second.safeParse(firstResult.data);
+    }
+}
+/**
+ * SuperRefine validator - advanced refinement with context
+ */
+export class VldSuperRefine extends VldBase {
+    constructor(_inner, _refinement) {
+        super();
+        this._inner = _inner;
+        this._refinement = _refinement;
+    }
+    parse(value) {
+        const result = this._inner.parse(value);
+        const issues = [];
+        const ctx = {
+            addIssue: (issue) => issues.push(issue),
+            path: []
+        };
+        const maybePromise = this._refinement(result, ctx);
+        if (maybePromise instanceof Promise) {
+            throw new Error('Use parseAsync for async refinements');
+        }
+        if (issues.length > 0) {
+            throw new Error(issues.map(i => i.message).join('; '));
+        }
+        return result;
+    }
+    safeParse(value) {
+        const result = this._inner.safeParse(value);
+        if (!result.success)
+            return result;
+        const issues = [];
+        const ctx = {
+            addIssue: (issue) => issues.push(issue),
+            path: []
+        };
+        const maybePromise = this._refinement(result.data, ctx);
+        if (maybePromise instanceof Promise) {
+            throw new Error('Use safeParseAsync for async refinements');
+        }
+        if (issues.length > 0) {
+            return {
+                success: false,
+                error: new Error(issues.map(i => i.message).join('; '))
+            };
+        }
+        return result;
+    }
+}
+/**
+ * Preprocess validator - transforms input before validation
+ */
+export class VldPreprocess extends VldBase {
+    constructor(_preprocessor, _schema) {
+        super();
+        this._preprocessor = _preprocessor;
+        this._schema = _schema;
+    }
+    static create(preprocessor, schema) {
+        return new VldPreprocess(preprocessor, schema);
+    }
+    parse(value) {
+        const preprocessed = this._preprocessor(value);
+        return this._schema.parse(preprocessed);
+    }
+    safeParse(value) {
+        try {
+            const preprocessed = this._preprocessor(value);
+            return this._schema.safeParse(preprocessed);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error
+            };
+        }
+    }
 }
 //# sourceMappingURL=base.js.map