@oxog/vld 1.2.0 → 1.4.0

package/dist/validators/date.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Immutable date validator with chainable methods
  */
@@ -40,8 +40,8 @@ export class VldDate extends VldBase {
         }
         // Apply all checks
         for (const check of this.config.checks) {
-            if (!check(date)) {
-                throw new Error(this.config.errorMessage || getMessages().invalidDate);
+            if (!check.fn(date)) {
+                throw new Error(check.message);
             }
         }
         return date;
@@ -59,65 +59,110 @@ export class VldDate extends VldBase {
     }
     /**
      * Create a new validator with minimum date constraint
+     * BUG-NEW-009 FIX: Validate that min date is valid before creating validator
      */
     min(date, message) {
         const minDate = date instanceof Date ? date : new Date(date);
+        // Validate that minDate is valid
+        if (isNaN(minDate.getTime())) {
+            throw new Error(`Invalid date provided to min(): ${date}`);
+        }
         return new VldDate({
-            checks: [...this.config.checks, (v) => v >= minDate],
-            errorMessage: message || getMessages().dateMin(minDate)
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v >= minDate,
+                    message: message || getMessages().dateMin(minDate)
+                }]
         });
     }
     /**
      * Create a new validator with maximum date constraint
+     * BUG-NEW-009 FIX: Validate that max date is valid before creating validator
      */
     max(date, message) {
         const maxDate = date instanceof Date ? date : new Date(date);
+        // Validate that maxDate is valid
+        if (isNaN(maxDate.getTime())) {
+            throw new Error(`Invalid date provided to max(): ${date}`);
+        }
         return new VldDate({
-            checks: [...this.config.checks, (v) => v <= maxDate],
-            errorMessage: message || getMessages().dateMax(maxDate)
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v <= maxDate,
+                    message: message || getMessages().dateMax(maxDate)
+                }]
         });
     }
     /**
      * Create a new validator with a range constraint
+     * BUG-NEW-019 FIX: Validate that min/max dates are valid before creating validator
      */
     between(min, max, message) {
         const minDate = min instanceof Date ? min : new Date(min);
         const maxDate = max instanceof Date ? max : new Date(max);
+        // Validate that both dates are valid
+        if (isNaN(minDate.getTime())) {
+            throw new Error(`Invalid min date provided to between(): ${min}`);
+        }
+        if (isNaN(maxDate.getTime())) {
+            throw new Error(`Invalid max date provided to between(): ${max}`);
+        }
         return new VldDate({
-            checks: [...this.config.checks, (v) => v >= minDate && v <= maxDate],
-            errorMessage: message || `Date must be between ${minDate.toISOString()} and ${maxDate.toISOString()}`
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v >= minDate && v <= maxDate,
+                    message: message || `Date must be between ${minDate.toISOString()} and ${maxDate.toISOString()}`
+                }]
         });
     }
     /**
      * Create a new validator that checks if date is in the past
+     * BUG-NEW-006 FIX: Capture reference date at validator creation time for deterministic behavior
      */
     past(message) {
+        const referenceDate = new Date(); // Capture NOW at validator creation time
         return new VldDate({
-            checks: [...this.config.checks, (v) => v < new Date()],
-            errorMessage: message || 'Date must be in the past'
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v < referenceDate,
+                    message: message || 'Date must be in the past'
+                }]
         });
     }
     /**
      * Create a new validator that checks if date is in the future
+     * BUG-NEW-006 FIX: Capture reference date at validator creation time for deterministic behavior
      */
     future(message) {
+        const referenceDate = new Date(); // Capture NOW at validator creation time
         return new VldDate({
-            checks: [...this.config.checks, (v) => v > new Date()],
-            errorMessage: message || 'Date must be in the future'
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v > referenceDate,
+                    message: message || 'Date must be in the future'
+                }]
         });
     }
     /**
      * Create a new validator that checks if date is today
+     * BUG-NEW-008 FIX: Capture reference date at validator creation time for deterministic behavior
      */
     today(message) {
+        // Capture the reference date (today) at validator creation time
+        const referenceDate = new Date();
+        const refYear = referenceDate.getFullYear();
+        const refMonth = referenceDate.getMonth();
+        const refDate = referenceDate.getDate();
         return new VldDate({
-            checks: [...this.config.checks, (v) => {
-                    const today = new Date();
-                    return v.getFullYear() === today.getFullYear() &&
-                        v.getMonth() === today.getMonth() &&
-                        v.getDate() === today.getDate();
-                }],
-            errorMessage: message || 'Date must be today'
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => {
+                        return v.getFullYear() === refYear &&
+                            v.getMonth() === refMonth &&
+                            v.getDate() === refDate;
+                    },
+                    message: message || 'Date must be today'
+                }]
         });
     }
     /**
@@ -125,11 +170,14 @@ export class VldDate extends VldBase {
      */
     weekday(message) {
         return new VldDate({
-            checks: [...this.config.checks, (v) => {
-                    const day = v.getDay();
-                    return day >= 1 && day <= 5;
-                }],
-            errorMessage: message || 'Date must be a weekday'
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => {
+                        const day = v.getDay();
+                        return day >= 1 && day <= 5;
+                    },
+                    message: message || 'Date must be a weekday'
+                }]
         });
     }
     /**
@@ -137,11 +185,42 @@ export class VldDate extends VldBase {
      */
     weekend(message) {
         return new VldDate({
-            checks: [...this.config.checks, (v) => {
-                    const day = v.getDay();
-                    return day === 0 || day === 6;
-                }],
-            errorMessage: message || 'Date must be a weekend'
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => {
+                        const day = v.getDay();
+                        return day === 0 || day === 6;
+                    },
+                    message: message || 'Date must be a weekend'
+                }]
+        });
+    }
+    /**
+     * Create a new validator with strict greater than constraint
+     * Zod 4 API parity - strictly greater than (not equal to)
+     */
+    gt(value, message) {
+        const compareDate = value instanceof Date ? value : new Date(value);
+        return new VldDate({
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v.getTime() > compareDate.getTime(),
+                    message: message || `Date must be greater than ${compareDate.toISOString()}`
+                }]
+        });
+    }
+    /**
+     * Create a new validator with strict less than constraint
+     * Zod 4 API parity - strictly less than (not equal to)
+     */
+    lt(value, message) {
+        const compareDate = value instanceof Date ? value : new Date(value);
+        return new VldDate({
+            ...this.config,
+            checks: [...this.config.checks, {
+                    fn: (v) => v.getTime() < compareDate.getTime(),
+                    message: message || `Date must be less than ${compareDate.toISOString()}`
+                }]
         });
     }
 }

package/dist/validators/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/validators/date.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Type for date validation check functions\n */\ntype DateCheck = (value: Date) => boolean;\n\n/**\n * Configuration for date validator\n */\ninterface DateValidatorConfig {\n  readonly checks: ReadonlyArray<DateCheck>;\n  readonly errorMessage?: string;\n}\n\n/**\n * Immutable date validator with chainable methods\n */\nexport class VldDate extends VldBase<Date, Date> {\n  private readonly config: DateValidatorConfig;\n  \n  /**\n   * Protected constructor to allow extension while maintaining immutability\n   */\n  protected constructor(config?: Partial<DateValidatorConfig>) {\n    super();\n    this.config = {\n      checks: config?.checks || [],\n      errorMessage: config?.errorMessage\n    };\n  }\n  \n  /**\n   * Create a new date validator\n   */\n  static create(): VldDate {\n    return new VldDate();\n  }\n  \n  /**\n   * Parse and validate a date value\n   */\n  parse(value: unknown): Date {\n    let date: Date;\n    \n    if (value instanceof Date) {\n      date = value;\n    } else if (typeof value === 'string' || typeof value === 'number') {\n      date = new Date(value);\n    } else {\n      throw new Error(this.config.errorMessage || getMessages().invalidDate);\n    }\n    \n    // Check if the date is valid\n    if (isNaN(date.getTime())) {\n      throw new Error(this.config.errorMessage || getMessages().invalidDate);\n    }\n    \n    // Apply all checks\n    for (const check of this.config.checks) {\n      if (!check(date)) {\n        throw new Error(this.config.errorMessage || getMessages().invalidDate);\n      }\n    }\n    \n    return date;\n  }\n  \n  /**\n   * Safely parse and validate a date value\n   */\n  safeParse(value: unknown): ParseResult<Date> {\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 date constraint\n   */\n  min(date: Date | string | number, message?: string): VldDate {\n    const minDate = date instanceof Date ? date : new Date(date);\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => v >= minDate],\n      errorMessage: message || getMessages().dateMin(minDate)\n    });\n  }\n  \n  /**\n   * Create a new validator with maximum date constraint\n   */\n  max(date: Date | string | number, message?: string): VldDate {\n    const maxDate = date instanceof Date ? date : new Date(date);\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => v <= maxDate],\n      errorMessage: message || getMessages().dateMax(maxDate)\n    });\n  }\n  \n  /**\n   * Create a new validator with a range constraint\n   */\n  between(\n    min: Date | string | number,\n    max: Date | string | number,\n    message?: string\n  ): VldDate {\n    const minDate = min instanceof Date ? min : new Date(min);\n    const maxDate = max instanceof Date ? max : new Date(max);\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => v >= minDate && v <= maxDate],\n      errorMessage: message || `Date must be between ${minDate.toISOString()} and ${maxDate.toISOString()}`\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if date is in the past\n   */\n  past(message?: string): VldDate {\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => v < new Date()],\n      errorMessage: message || 'Date must be in the past'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if date is in the future\n   */\n  future(message?: string): VldDate {\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => v > new Date()],\n      errorMessage: message || 'Date must be in the future'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if date is today\n   */\n  today(message?: string): VldDate {\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => {\n        const today = new Date();\n        return v.getFullYear() === today.getFullYear() &&\n               v.getMonth() === today.getMonth() &&\n               v.getDate() === today.getDate();\n      }],\n      errorMessage: message || 'Date must be today'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if date is a weekday\n   */\n  weekday(message?: string): VldDate {\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => {\n        const day = v.getDay();\n        return day >= 1 && day <= 5;\n      }],\n      errorMessage: message || 'Date must be a weekday'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if date is a weekend\n   */\n  weekend(message?: string): VldDate {\n    return new VldDate({\n      checks: [...this.config.checks, (v: Date) => {\n        const day = v.getDay();\n        return day === 0 || day === 6;\n      }],\n      errorMessage: message || 'Date must be a weekend'\n    });\n  }\n}"]}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/validators/date.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Type for date validation check functions\r\n */\r\ntype DateCheckFn = (value: Date) => boolean;\r\n\r\ninterface DateCheck {\r\n  fn: DateCheckFn;\r\n  message: string;\r\n}\r\n\r\n/**\r\n * Configuration for date validator\r\n */\r\ninterface DateValidatorConfig {\r\n  readonly checks: ReadonlyArray<DateCheck>;\r\n  readonly errorMessage?: string;\r\n}\r\n\r\n/**\r\n * Immutable date validator with chainable methods\r\n */\r\nexport class VldDate extends VldBase<Date, Date> {\r\n  private readonly config: DateValidatorConfig;\r\n\r\n  /**\r\n   * Protected constructor to allow extension while maintaining immutability\r\n   */\r\n  protected constructor(config?: Partial<DateValidatorConfig>) {\r\n    super();\r\n    this.config = {\r\n      checks: config?.checks || [],\r\n      errorMessage: config?.errorMessage\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Create a new date validator\r\n   */\r\n  static create(): VldDate {\r\n    return new VldDate();\r\n  }\r\n\r\n  /**\r\n   * Parse and validate a date value\r\n   */\r\n  parse(value: unknown): Date {\r\n    let date: Date;\r\n\r\n    if (value instanceof Date) {\r\n      date = value;\r\n    } else if (typeof value === 'string' || typeof value === 'number') {\r\n      date = new Date(value);\r\n    } else {\r\n      throw new Error(this.config.errorMessage || getMessages().invalidDate);\r\n    }\r\n\r\n    // Check if the date is valid\r\n    if (isNaN(date.getTime())) {\r\n      throw new Error(this.config.errorMessage || getMessages().invalidDate);\r\n    }\r\n\r\n    // Apply all checks\r\n    for (const check of this.config.checks) {\r\n      if (!check.fn(date)) {\r\n        throw new Error(check.message);\r\n      }\r\n    }\r\n\r\n    return date;\r\n  }\r\n\r\n  /**\r\n   * Safely parse and validate a date value\r\n   */\r\n  safeParse(value: unknown): ParseResult<Date> {\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 new validator with minimum date constraint\r\n   * BUG-NEW-009 FIX: Validate that min date is valid before creating validator\r\n   */\r\n  min(date: Date | string | number, message?: string): VldDate {\r\n    const minDate = date instanceof Date ? date : new Date(date);\r\n\r\n    // Validate that minDate is valid\r\n    if (isNaN(minDate.getTime())) {\r\n      throw new Error(`Invalid date provided to min(): ${date}`);\r\n    }\r\n\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v >= minDate,\r\n        message: message || getMessages().dateMin(minDate)\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator with maximum date constraint\r\n   * BUG-NEW-009 FIX: Validate that max date is valid before creating validator\r\n   */\r\n  max(date: Date | string | number, message?: string): VldDate {\r\n    const maxDate = date instanceof Date ? date : new Date(date);\r\n\r\n    // Validate that maxDate is valid\r\n    if (isNaN(maxDate.getTime())) {\r\n      throw new Error(`Invalid date provided to max(): ${date}`);\r\n    }\r\n\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v <= maxDate,\r\n        message: message || getMessages().dateMax(maxDate)\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator with a range constraint\r\n   * BUG-NEW-019 FIX: Validate that min/max dates are valid before creating validator\r\n   */\r\n  between(\r\n    min: Date | string | number,\r\n    max: Date | string | number,\r\n    message?: string\r\n  ): VldDate {\r\n    const minDate = min instanceof Date ? min : new Date(min);\r\n    const maxDate = max instanceof Date ? max : new Date(max);\r\n\r\n    // Validate that both dates are valid\r\n    if (isNaN(minDate.getTime())) {\r\n      throw new Error(`Invalid min date provided to between(): ${min}`);\r\n    }\r\n    if (isNaN(maxDate.getTime())) {\r\n      throw new Error(`Invalid max date provided to between(): ${max}`);\r\n    }\r\n\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v >= minDate && v <= maxDate,\r\n        message: message || `Date must be between ${minDate.toISOString()} and ${maxDate.toISOString()}`\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that checks if date is in the past\r\n   * BUG-NEW-006 FIX: Capture reference date at validator creation time for deterministic behavior\r\n   */\r\n  past(message?: string): VldDate {\r\n    const referenceDate = new Date(); // Capture NOW at validator creation time\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v < referenceDate,\r\n        message: message || 'Date must be in the past'\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that checks if date is in the future\r\n   * BUG-NEW-006 FIX: Capture reference date at validator creation time for deterministic behavior\r\n   */\r\n  future(message?: string): VldDate {\r\n    const referenceDate = new Date(); // Capture NOW at validator creation time\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v > referenceDate,\r\n        message: message || 'Date must be in the future'\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that checks if date is today\r\n   * BUG-NEW-008 FIX: Capture reference date at validator creation time for deterministic behavior\r\n   */\r\n  today(message?: string): VldDate {\r\n    // Capture the reference date (today) at validator creation time\r\n    const referenceDate = new Date();\r\n    const refYear = referenceDate.getFullYear();\r\n    const refMonth = referenceDate.getMonth();\r\n    const refDate = referenceDate.getDate();\r\n\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => {\r\n          return v.getFullYear() === refYear &&\r\n                 v.getMonth() === refMonth &&\r\n                 v.getDate() === refDate;\r\n        },\r\n        message: message || 'Date must be today'\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that checks if date is a weekday\r\n   */\r\n  weekday(message?: string): VldDate {\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => {\r\n          const day = v.getDay();\r\n          return day >= 1 && day <= 5;\r\n        },\r\n        message: message || 'Date must be a weekday'\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that checks if date is a weekend\r\n   */\r\n  weekend(message?: string): VldDate {\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => {\r\n          const day = v.getDay();\r\n          return day === 0 || day === 6;\r\n        },\r\n        message: message || 'Date must be a weekend'\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator with strict greater than constraint\r\n   * Zod 4 API parity - strictly greater than (not equal to)\r\n   */\r\n  gt(value: Date | number, message?: string): VldDate {\r\n    const compareDate = value instanceof Date ? value : new Date(value);\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v.getTime() > compareDate.getTime(),\r\n        message: message || `Date must be greater than ${compareDate.toISOString()}`\r\n      }]\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Create a new validator with strict less than constraint\r\n   * Zod 4 API parity - strictly less than (not equal to)\r\n   */\r\n  lt(value: Date | number, message?: string): VldDate {\r\n    const compareDate = value instanceof Date ? value : new Date(value);\r\n    return new VldDate({\r\n      ...this.config,\r\n      checks: [...this.config.checks, {\r\n        fn: (v: Date) => v.getTime() < compareDate.getTime(),\r\n        message: message || `Date must be less than ${compareDate.toISOString()}`\r\n      }]\r\n    });\r\n  }\r\n}"]}

package/dist/validators/discriminated-union.d.ts

@@ -0,0 +1,29 @@
+/**
+ * VldDiscriminatedUnion - Fast union validation using discriminator field
+ * Part of Zod 4 API parity implementation
+ * Provides O(1) lookup performance by using a discriminator key
+ */
+import { VldBase } from './base';
+import type { ParseResult } from './base';
+/**
+ * Discriminated union validator - validates union based on discriminator key
+ * Much faster than regular union when you have a discriminator field
+ */
+export declare class VldDiscriminatedUnion<K extends string, Options extends VldBase<any, any>[]> extends VldBase<unknown, Options[number] extends VldBase<any, infer T> ? T : never> {
+    private readonly _discriminator;
+    private readonly _options;
+    private readonly _discriminatorMap;
+    constructor(_discriminator: K, _options: Options);
+    static create<K extends string, Options extends VldBase<any, any>[]>(discriminator: K, options: Options): VldDiscriminatedUnion<K, Options>;
+    parse(value: unknown): Options[number] extends VldBase<any, infer T> ? T : never;
+    safeParse(value: unknown): ParseResult<Options[number] extends VldBase<any, infer T> ? T : never>;
+    /**
+     * Get the discriminator key
+     */
+    getDiscriminator(): K;
+    /**
+     * Get all options
+     */
+    getOptions(): Options;
+}
+//# sourceMappingURL=discriminated-union.d.ts.map

package/dist/validators/discriminated-union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated-union.d.ts","sourceRoot":"","sources":["../../src/validators/discriminated-union.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAgB1C;;;GAGG;AACH,qBAAa,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CACtF,SAAQ,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAKjF,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;gBAGjD,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,OAAO;IA4BpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EACjE,aAAa,EAAE,CAAC,EAChB,OAAO,EAAE,OAAO,GACf,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC;IAIpC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;IAQhF,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAiCjG;;OAEG;IACH,gBAAgB,IAAI,CAAC;IAIrB;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/validators/discriminated-union.js

@@ -0,0 +1,98 @@
+/**
+ * VldDiscriminatedUnion - Fast union validation using discriminator field
+ * Part of Zod 4 API parity implementation
+ * Provides O(1) lookup performance by using a discriminator key
+ */
+import { VldBase } from './base.js';
+import { VldObject } from './object.js';
+import { VldLiteral } from './literal.js';
+import { VldEnum } from './enum.js';
+/**
+ * Extract literal values from a schema
+ */
+function extractLiteralValues(schema) {
+    if (schema instanceof VldLiteral) {
+        const value = schema.literal;
+        return [value];
+    }
+    if (schema instanceof VldEnum) {
+        return schema.values;
+    }
+    throw new Error('Discriminator must be a literal or enum schema');
+}
+/**
+ * Discriminated union validator - validates union based on discriminator key
+ * Much faster than regular union when you have a discriminator field
+ */
+export class VldDiscriminatedUnion extends VldBase {
+    constructor(_discriminator, _options) {
+        super();
+        this._discriminator = _discriminator;
+        this._options = _options;
+        // Build discriminator map for O(1) lookup
+        this._discriminatorMap = new Map();
+        for (const option of _options) {
+            if (!(option instanceof VldObject)) {
+                throw new Error('All options in a discriminated union must be objects');
+            }
+            const discriminatorSchema = option.config?.shape?.[this._discriminator];
+            if (!discriminatorSchema) {
+                throw new Error(`Missing discriminator key "${this._discriminator}" in one of the options`);
+            }
+            const values = extractLiteralValues(discriminatorSchema);
+            for (const value of values) {
+                if (this._discriminatorMap.has(value)) {
+                    throw new Error(`Duplicate discriminator value "${String(value)}" found in discriminated union`);
+                }
+                this._discriminatorMap.set(value, option);
+            }
+        }
+    }
+    static create(discriminator, options) {
+        return new VldDiscriminatedUnion(discriminator, options);
+    }
+    parse(value) {
+        const result = this.safeParse(value);
+        if (!result.success) {
+            throw result.error;
+        }
+        return result.data;
+    }
+    safeParse(value) {
+        // Check if input is an object
+        if (typeof value !== 'object' || value === null) {
+            return {
+                success: false,
+                error: new Error(`Expected object, received ${value === null ? 'null' : typeof value}`)
+            };
+        }
+        // Get discriminator value
+        const discriminatorValue = value[this._discriminator];
+        // Look up matching schema
+        const matchedSchema = this._discriminatorMap.get(discriminatorValue);
+        if (!matchedSchema) {
+            const validValues = Array.from(this._discriminatorMap.keys());
+            return {
+                success: false,
+                error: new Error(`Invalid discriminator value for "${this._discriminator}". ` +
+                    `Expected one of: ${JSON.stringify(validValues)}, ` +
+                    `received: ${JSON.stringify(discriminatorValue)}`)
+            };
+        }
+        // Validate against matched schema
+        return matchedSchema.safeParse(value);
+    }
+    /**
+     * Get the discriminator key
+     */
+    getDiscriminator() {
+        return this._discriminator;
+    }
+    /**
+     * Get all options
+     */
+    getOptions() {
+        return this._options;
+    }
+}
+//# sourceMappingURL=discriminated-union.js.map

package/dist/validators/discriminated-union.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated-union.js","sourceRoot":"","sources":["../../src/validators/discriminated-union.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * VldDiscriminatedUnion - Fast union validation using discriminator field\n * Part of Zod 4 API parity implementation\n * Provides O(1) lookup performance by using a discriminator key\n */\n\nimport { VldBase } from './base';\nimport { VldObject } from './object';\nimport { VldLiteral } from './literal';\nimport { VldEnum } from './enum';\nimport type { ParseResult } from './base';\n\n/**\n * Extract literal values from a schema\n */\nfunction extractLiteralValues(schema: VldBase<unknown, any>): unknown[] {\n  if (schema instanceof VldLiteral) {\n    const value = (schema as any).literal;\n    return [value];\n  }\n  if (schema instanceof VldEnum) {\n    return (schema as any).values as unknown[];\n  }\n  throw new Error('Discriminator must be a literal or enum schema');\n}\n\n/**\n * Discriminated union validator - validates union based on discriminator key\n * Much faster than regular union when you have a discriminator field\n */\nexport class VldDiscriminatedUnion<K extends string, Options extends VldBase<any, any>[]>\n  extends VldBase<unknown, Options[number] extends VldBase<any, infer T> ? T : never> {\n\n  private readonly _discriminatorMap: Map<unknown, VldBase<any, any>>;\n\n  constructor(\n    private readonly _discriminator: K,\n    private readonly _options: Options\n  ) {\n    super();\n\n    // Build discriminator map for O(1) lookup\n    this._discriminatorMap = new Map();\n\n    for (const option of _options) {\n      if (!(option instanceof VldObject)) {\n        throw new Error('All options in a discriminated union must be objects');\n      }\n\n      const discriminatorSchema = (option as any).config?.shape?.[this._discriminator];\n      if (!discriminatorSchema) {\n        throw new Error(`Missing discriminator key \"${this._discriminator}\" in one of the options`);\n      }\n\n      const values = extractLiteralValues(discriminatorSchema);\n\n      for (const value of values) {\n        if (this._discriminatorMap.has(value)) {\n          throw new Error(`Duplicate discriminator value \"${String(value)}\" found in discriminated union`);\n        }\n        this._discriminatorMap.set(value, option);\n      }\n    }\n  }\n\n  static create<K extends string, Options extends VldBase<any, any>[]>(\n    discriminator: K,\n    options: Options\n  ): VldDiscriminatedUnion<K, Options> {\n    return new VldDiscriminatedUnion(discriminator, options);\n  }\n\n  parse(value: unknown): Options[number] extends VldBase<any, infer T> ? T : never {\n    const result = this.safeParse(value);\n    if (!result.success) {\n      throw result.error;\n    }\n    return result.data;\n  }\n\n  safeParse(value: unknown): ParseResult<Options[number] extends VldBase<any, infer T> ? T : never> {\n    // Check if input is an object\n    if (typeof value !== 'object' || value === null) {\n      return {\n        success: false,\n        error: new Error(\n          `Expected object, received ${value === null ? 'null' : typeof value}`\n        )\n      };\n    }\n\n    // Get discriminator value\n    const discriminatorValue = (value as any)[this._discriminator];\n\n    // Look up matching schema\n    const matchedSchema = this._discriminatorMap.get(discriminatorValue);\n\n    if (!matchedSchema) {\n      const validValues = Array.from(this._discriminatorMap.keys());\n      return {\n        success: false,\n        error: new Error(\n          `Invalid discriminator value for \"${this._discriminator}\". ` +\n          `Expected one of: ${JSON.stringify(validValues)}, ` +\n          `received: ${JSON.stringify(discriminatorValue)}`\n        )\n      };\n    }\n\n    // Validate against matched schema\n    return matchedSchema.safeParse(value) as ParseResult<Options[number] extends VldBase<any, infer T> ? T : never>;\n  }\n\n  /**\n   * Get the discriminator key\n   */\n  getDiscriminator(): K {\n    return this._discriminator;\n  }\n\n  /**\n   * Get all options\n   */\n  getOptions(): Options {\n    return this._options;\n  }\n}\n"]}

package/dist/validators/enum.d.ts

@@ -21,5 +21,15 @@ export declare class VldEnum<T extends readonly [string, ...string[]]> extends V
      * Safely parse and validate an enum value
      */
     safeParse(value: unknown): ParseResult<T[number]>;
+    /**
+     * Exclude specific values from the enum
+     * Creates a new enum validator without the specified values
+     */
+    exclude<const E extends readonly string[]>(...excludeValues: E): VldEnum<T[number] extends E[number] ? never : T[number] extends Exclude<T[number], E[number]> ? T : Exclude<T, E>>;
+    /**
+     * Extract specific values from the enum
+     * Creates a new enum validator with only the specified values
+     */
+    extract<const E extends readonly string[]>(...extractValues: E): VldEnum<[string, ...string[]]>;
 }
 //# sourceMappingURL=enum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;GAEG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAE,SAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAK7F,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IALhC;;OAEG;IACH,OAAO;IAOP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAUhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CAYlD"}
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;GAEG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAE,SAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAK7F,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IALhC;;OAEG;IACH,OAAO;IAOP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAiBhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAuBjD;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,GAAG,OAAO,CACtE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1G;IASD;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;CAQhG"}

package/dist/validators/enum.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Immutable enum validator for string enum values
  */
@@ -22,6 +22,11 @@ export class VldEnum extends VldBase {
      * Parse and validate an enum value
      */
     parse(value) {
+        // BUG-002 FIX: Add type check before includes() to prevent type confusion
+        if (typeof value !== 'string') {
+            throw new Error(this.errorMessage ||
+                getMessages().enumExpected([...this.values], JSON.stringify(value)));
+        }
         if (!this.values.includes(value)) {
             throw new Error(this.errorMessage ||
                 getMessages().enumExpected([...this.values], JSON.stringify(value)));
@@ -32,6 +37,14 @@ export class VldEnum extends VldBase {
      * Safely parse and validate an enum value
      */
     safeParse(value) {
+        // BUG-002 FIX: Add type check before includes() to prevent type confusion
+        if (typeof value !== 'string') {
+            return {
+                success: false,
+                error: new Error(this.errorMessage ||
+                    getMessages().enumExpected([...this.values], JSON.stringify(value)))
+            };
+        }
         if (this.values.includes(value)) {
             return { success: true, data: value };
         }
@@ -41,5 +54,29 @@ export class VldEnum extends VldBase {
                 getMessages().enumExpected([...this.values], JSON.stringify(value)))
         };
     }
+    /**
+     * Exclude specific values from the enum
+     * Creates a new enum validator without the specified values
+     */
+    exclude(...excludeValues) {
+        const filtered = this.values.filter(v => !excludeValues.includes(v));
+        if (filtered.length === 0) {
+            throw new Error('Cannot exclude all enum values');
+        }
+        // Type assertion needed because TypeScript can't guarantee the filtered array maintains the required type
+        return new VldEnum(filtered, this.errorMessage);
+    }
+    /**
+     * Extract specific values from the enum
+     * Creates a new enum validator with only the specified values
+     */
+    extract(...extractValues) {
+        const extracted = this.values.filter(v => extractValues.includes(v));
+        if (extracted.length === 0) {
+            throw new Error('Cannot extract non-existent enum values');
+        }
+        // Type assertion needed because TypeScript can't guarantee the extracted array has the required type
+        return new VldEnum(extracted, this.errorMessage);
+    }
 }
 //# sourceMappingURL=enum.js.map

package/dist/validators/enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,OAAkD,SAAQ,OAA0B;IAC/F;;OAEG;IACH,YACmB,MAAS,EACT,YAAqB;QAEtC,KAAK,EAAE,CAAC;QAHS,WAAM,GAAN,MAAM,CAAG;QACT,iBAAY,GAAZ,YAAY,CAAS;IAGxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAA2C,MAAS;QAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAe,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,KAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACtB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAe,CAAC,EAAE,CAAC;YAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAkB,EAAE,CAAC;QACrD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,KAAK,CACd,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE;SACF,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Immutable enum validator for string enum values\n */\nexport class VldEnum<T extends readonly [string, ...string[]]> extends VldBase<string, T[number]> {\n  /**\n   * Private constructor to enforce immutability\n   */\n  private constructor(\n    private readonly values: T,\n    private readonly errorMessage?: string\n  ) {\n    super();\n  }\n  \n  /**\n   * Create a new enum validator\n   */\n  static create<T extends readonly [string, ...string[]]>(values: T): VldEnum<T> {\n    return new VldEnum(values);\n  }\n  \n  /**\n   * Parse and validate an enum value\n   */\n  parse(value: unknown): T[number] {\n    if (!this.values.includes(value as string)) {\n      throw new Error(\n        this.errorMessage || \n        getMessages().enumExpected([...this.values], JSON.stringify(value))\n      );\n    }\n    return value as T[number];\n  }\n  \n  /**\n   * Safely parse and validate an enum value\n   */\n  safeParse(value: unknown): ParseResult<T[number]> {\n    if (this.values.includes(value as string)) {\n      return { success: true, data: value as T[number] };\n    }\n    return { \n      success: false, \n      error: new Error(\n        this.errorMessage || \n        getMessages().enumExpected([...this.values], JSON.stringify(value))\n      )\n    };\n  }\n}"]}
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,OAAkD,SAAQ,OAA0B;IAC/F;;OAEG;IACH,YACmB,MAAS,EACT,YAAqB;QAEtC,KAAK,EAAE,CAAC;QAHS,WAAM,GAAN,MAAM,CAAG;QACT,iBAAY,GAAZ,YAAY,CAAS;IAGxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAA2C,MAAS;QAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,0EAA0E;QAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,KAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACtB,0EAA0E;QAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,KAAK,CACd,IAAI,CAAC,YAAY;oBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE;aACF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAkB,EAAE,CAAC;QACrD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,KAAK,CACd,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,OAAO,CAAoC,GAAG,aAAgB;QAG5D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,0GAA0G;QAC1G,OAAO,IAAI,OAAO,CAAC,QAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,OAAO,CAAoC,GAAG,aAAgB;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,qGAAqG;QACrG,OAAO,IAAI,OAAO,CAAC,SAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;CACF","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Immutable enum validator for string enum values\r\n */\r\nexport class VldEnum<T extends readonly [string, ...string[]]> extends VldBase<string, T[number]> {\r\n  /**\r\n   * Private constructor to enforce immutability\r\n   */\r\n  private constructor(\r\n    private readonly values: T,\r\n    private readonly errorMessage?: string\r\n  ) {\r\n    super();\r\n  }\r\n  \r\n  /**\r\n   * Create a new enum validator\r\n   */\r\n  static create<T extends readonly [string, ...string[]]>(values: T): VldEnum<T> {\r\n    return new VldEnum(values);\r\n  }\r\n  \r\n  /**\r\n   * Parse and validate an enum value\r\n   */\r\n  parse(value: unknown): T[number] {\r\n    // BUG-002 FIX: Add type check before includes() to prevent type confusion\r\n    if (typeof value !== 'string') {\r\n      throw new Error(\r\n        this.errorMessage ||\r\n        getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n      );\r\n    }\r\n    if (!this.values.includes(value)) {\r\n      throw new Error(\r\n        this.errorMessage ||\r\n        getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n      );\r\n    }\r\n    return value as T[number];\r\n  }\r\n\r\n  /**\r\n   * Safely parse and validate an enum value\r\n   */\r\n  safeParse(value: unknown): ParseResult<T[number]> {\r\n    // BUG-002 FIX: Add type check before includes() to prevent type confusion\r\n    if (typeof value !== 'string') {\r\n      return {\r\n        success: false,\r\n        error: new Error(\r\n          this.errorMessage ||\r\n          getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n        )\r\n      };\r\n    }\r\n    if (this.values.includes(value)) {\r\n      return { success: true, data: value as T[number] };\r\n    }\r\n    return {\r\n      success: false,\r\n      error: new Error(\r\n        this.errorMessage ||\r\n        getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n      )\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Exclude specific values from the enum\r\n   * Creates a new enum validator without the specified values\r\n   */\r\n  exclude<const E extends readonly string[]>(...excludeValues: E): VldEnum<\r\n    T[number] extends E[number] ? never : T[number] extends Exclude<T[number], E[number]> ? T : Exclude<T, E>\r\n  > {\r\n    const filtered = this.values.filter(v => !excludeValues.includes(v));\r\n    if (filtered.length === 0) {\r\n      throw new Error('Cannot exclude all enum values');\r\n    }\r\n    // Type assertion needed because TypeScript can't guarantee the filtered array maintains the required type\r\n    return new VldEnum(filtered as any, this.errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Extract specific values from the enum\r\n   * Creates a new enum validator with only the specified values\r\n   */\r\n  extract<const E extends readonly string[]>(...extractValues: E): VldEnum<[string, ...string[]]> {\r\n    const extracted = this.values.filter(v => extractValues.includes(v));\r\n    if (extracted.length === 0) {\r\n      throw new Error('Cannot extract non-existent enum values');\r\n    }\r\n    // Type assertion needed because TypeScript can't guarantee the extracted array has the required type\r\n    return new VldEnum(extracted as any, this.errorMessage);\r\n  }\r\n}"]}

package/dist/validators/file.d.ts

@@ -0,0 +1,57 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * File representation for validation
+ * In browsers: File object
+ * In Node.js: Object with size and type properties
+ */
+export type VldFileValue = File | {
+    size: number;
+    type: string;
+    name?: string;
+};
+/**
+ * Immutable file validator for file uploads
+ * Supports size and MIME type validation
+ */
+export declare class VldFile extends VldBase<unknown, VldFileValue> {
+    private readonly checks;
+    private constructor();
+    /**
+     * Create a new file validator
+     */
+    static create(): VldFile;
+    /**
+     * Parse and validate a file value
+     */
+    parse(value: unknown): VldFileValue;
+    /**
+     * Run all validation checks on the file
+     */
+    private runChecks;
+    /**
+     * Safely parse and validate a file value
+     */
+    safeParse(value: unknown): ParseResult<VldFileValue>;
+    /**
+     * Set minimum file size in bytes
+     */
+    min(bytes: number, message?: string): VldFile;
+    /**
+     * Set maximum file size in bytes
+     */
+    max(bytes: number, message?: string): VldFile;
+    /**
+     * Set allowed MIME types
+     */
+    mime(types: string | string[], message?: string): VldFile;
+    /**
+     * Set both minimum and maximum file size
+     */
+    size(min: number, max: number, message?: string): VldFile;
+}
+/**
+ * Helper function to create file validators
+ * Usage: v.file().min(1024).max(10485760).mime(['image/jpeg', 'image/png'])
+ */
+export declare function file(): VldFile;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/validators/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAW9C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC;IAEvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IADzB,OAAO;IAMP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,OAAO;IAIxB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY;IA2BnC;;OAEG;IACH,OAAO,CAAC,SAAS;IAqCjB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC;IAQpD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAKzD;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;CAG1D;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B"}