@oxog/vld 1.3.1 → 1.5.0

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
@@ -104,6 +182,8 @@ export declare class VldTransform<TInput, TBase, TOutput> extends VldBase<TInput
 }
 /**
  * Default validator - provides default value for undefined
+ * Note: Does not validate the default value at construction time.
+ * Use .prefault() to validate the default value at parse time.
  */
 export declare class VldDefault<TInput, TOutput> extends VldBase<TInput | undefined, TOutput> {
     private readonly baseValidator;
@@ -111,9 +191,29 @@ 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
+ * BUG-NPM-003 FIX: Validate fallback value at construction time
  */
 export declare class VldCatch<TInput, TOutput> extends VldBase<TInput, TOutput> {
     private readonly baseValidator;
@@ -131,6 +231,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 +242,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 +253,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
@@ -125,6 +228,8 @@ export class VldTransform extends VldBase {
 }
 /**
  * Default validator - provides default value for undefined
+ * Note: Does not validate the default value at construction time.
+ * Use .prefault() to validate the default value at parse time.
  */
 export class VldDefault extends VldBase {
     constructor(baseValidator, defaultValue) {
@@ -144,15 +249,58 @@ 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
+ * BUG-NPM-003 FIX: Validate fallback value at construction time
  */
 export class VldCatch extends VldBase {
     constructor(baseValidator, fallbackValue) {
         super();
         this.baseValidator = baseValidator;
         this.fallbackValue = fallbackValue;
+        // BUG-NPM-003 FIX: Validate the fallback value to ensure type safety
+        const validation = baseValidator.safeParse(fallbackValue);
+        if (!validation.success) {
+            throw new Error(`Invalid fallback value: ${validation.error.message}`);
+        }
     }
     parse(value) {
         try {
@@ -193,6 +341,9 @@ export class VldOptional extends VldBase {
         }
         return this.baseValidator.safeParse(value);
     }
+    unwrap() {
+        return this.baseValidator;
+    }
 }
 /**
  * Nullable validator - allows null
@@ -217,6 +368,9 @@ export class VldNullable extends VldBase {
         }
         return this.baseValidator.safeParse(value);
     }
+    unwrap() {
+        return this.baseValidator;
+    }
 }
 /**
  * Nullish validator - allows null or undefined
@@ -241,5 +395,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

package/dist/validators/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/validators/base.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Base result type for validation\n */\nexport type ParseResult<T> = \n  | { readonly success: true; readonly data: T }\n  | { readonly success: false; readonly error: Error };\n\n/**\n * Abstract base class for all validators\n * Implements immutable pattern to prevent memory leaks and race conditions\n */\nexport abstract class VldBase<TInput, TOutput = TInput> {\n  /**\n   * Parse and validate a value, throwing an error if invalid\n   * @param value The value to validate\n   * @returns The validated value\n   * @throws {Error} If validation fails\n   */\n  abstract parse(value: unknown): TOutput;\n  \n  /**\n   * Safely parse and validate a value, returning a result object\n   * @param value The value to validate\n   * @returns A result object with either success and data, or failure and error\n   */\n  abstract safeParse(value: unknown): ParseResult<TOutput>;\n  \n  /**\n   * Check if a value is valid according to this validator\n   * @param value The value to check\n   * @returns True if valid, false otherwise\n   */\n  isValid(value: unknown): boolean {\n    return this.safeParse(value).success;\n  }\n  \n  /**\n   * Parse a value or return a default if validation fails\n   * @param value The value to validate\n   * @param defaultValue The default value to return on failure\n   * @returns The validated value or default\n   */\n  parseOrDefault(value: unknown, defaultValue: TOutput): TOutput {\n    const result = this.safeParse(value);\n    return result.success ? result.data : defaultValue;\n  }\n  \n  /**\n   * Create a new validator that refines this one with a custom predicate\n   * @param predicate The refinement predicate\n   * @param message Optional custom error message\n   * @returns A new refined validator\n   */\n  refine<TRefined extends TOutput>(\n    predicate: (value: TOutput) => value is TRefined,\n    message?: string\n  ): VldRefine<TInput, TOutput, TRefined>;\n  refine(\n    predicate: (value: TOutput) => boolean,\n    message?: string\n  ): VldRefine<TInput, TOutput, TOutput>;\n  refine(\n    predicate: (value: TOutput) => boolean,\n    message?: string\n  ): VldRefine<TInput, TOutput, TOutput> {\n    return new VldRefine(this, predicate, message);\n  }\n  \n  /**\n   * Create a new validator that transforms the output\n   * @param transformer The transformation function\n   * @returns A new transformed validator\n   */\n  transform<TTransformed>(\n    transformer: (value: TOutput) => TTransformed\n  ): VldTransform<TInput, TOutput, TTransformed> {\n    return new VldTransform(this, transformer);\n  }\n  \n  /**\n   * Create a new validator with a default value for undefined inputs\n   * @param defaultValue The default value\n   * @returns A new validator with default\n   */\n  default(defaultValue: TOutput): VldDefault<TInput, TOutput> {\n    return new VldDefault(this, defaultValue);\n  }\n  \n  /**\n   * Create a new validator that catches errors and returns a fallback\n   * @param fallbackValue The fallback value\n   * @returns A new validator with catch\n   */\n  catch(fallbackValue: TOutput): VldCatch<TInput, TOutput> {\n    return new VldCatch(this, fallbackValue);\n  }\n  \n  /**\n   * Make this validator optional (allows undefined)\n   * @returns A new optional validator\n   */\n  optional(): VldOptional<TInput, TOutput> {\n    return new VldOptional(this);\n  }\n  \n  /**\n   * Make this validator nullable (allows null)\n   * @returns A new nullable validator\n   */\n  nullable(): VldNullable<TInput, TOutput> {\n    return new VldNullable(this);\n  }\n  \n  /**\n   * Make this validator nullish (allows null or undefined)\n   * @returns A new nullish validator\n   */\n  nullish(): VldNullish<TInput, TOutput> {\n    return new VldNullish(this);\n  }\n}\n\n/**\n * Refine validator - adds custom validation\n */\nexport class VldRefine<TInput, TBase, TOutput extends TBase = TBase> extends VldBase<TInput, TOutput> {\n  constructor(\n    private readonly baseValidator: VldBase<TInput, TBase>,\n    private readonly predicate: (value: TBase) => boolean,\n    private readonly customMessage?: string\n  ) {\n    super();\n  }\n  \n  parse(value: unknown): TOutput {\n    const baseResult = this.baseValidator.parse(value);\n    \n    if (!this.predicate(baseResult)) {\n      throw new Error(this.customMessage || 'Refinement check failed');\n    }\n    \n    return baseResult as TOutput;\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput> {\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/**\n * Transform validator - transforms data after validation\n */\nexport class VldTransform<TInput, TBase, TOutput> extends VldBase<TInput, TOutput> {\n  constructor(\n    private readonly baseValidator: VldBase<TInput, TBase>,\n    private readonly transformer: (value: TBase) => TOutput\n  ) {\n    super();\n  }\n  \n  parse(value: unknown): TOutput {\n    const baseResult = this.baseValidator.parse(value);\n    \n    try {\n      return this.transformer(baseResult);\n    } catch (error) {\n      throw new Error(`Transform failed: ${(error as Error).message}`);\n    }\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput> {\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/**\n * Default validator - provides default value for undefined\n */\nexport class VldDefault<TInput, TOutput> extends VldBase<TInput | undefined, TOutput> {\n  constructor(\n    private readonly baseValidator: VldBase<TInput, TOutput>,\n    private readonly defaultValue: TOutput\n  ) {\n    super();\n  }\n  \n  parse(value: unknown): TOutput {\n    if (value === undefined) {\n      return this.defaultValue;\n    }\n    return this.baseValidator.parse(value);\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput> {\n    if (value === undefined) {\n      return { success: true, data: this.defaultValue };\n    }\n    return this.baseValidator.safeParse(value);\n  }\n}\n\n/**\n * Catch validator - provides fallback value on validation error\n */\nexport class VldCatch<TInput, TOutput> extends VldBase<TInput, TOutput> {\n  constructor(\n    private readonly baseValidator: VldBase<TInput, TOutput>,\n    private readonly fallbackValue: TOutput\n  ) {\n    super();\n  }\n  \n  parse(value: unknown): TOutput {\n    try {\n      return this.baseValidator.parse(value);\n    } catch {\n      return this.fallbackValue;\n    }\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput> {\n    const result = this.baseValidator.safeParse(value);\n    if (result.success) {\n      return result;\n    }\n    return { success: true, data: this.fallbackValue };\n  }\n}\n\n/**\n * Optional validator - allows undefined\n */\nexport class VldOptional<TInput, TOutput> extends VldBase<TInput | undefined, TOutput | undefined> {\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\n    super();\n  }\n  \n  static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldOptional<TInput, TOutput> {\n    return new VldOptional(baseValidator);\n  }\n  \n  parse(value: unknown): TOutput | undefined {\n    if (value === undefined) {\n      return undefined;\n    }\n    return this.baseValidator.parse(value);\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput | undefined> {\n    if (value === undefined) {\n      return { success: true, data: undefined };\n    }\n    return this.baseValidator.safeParse(value);\n  }\n}\n\n/**\n * Nullable validator - allows null\n */\nexport class VldNullable<TInput, TOutput> extends VldBase<TInput | null, TOutput | null> {\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\n    super();\n  }\n  \n  static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullable<TInput, TOutput> {\n    return new VldNullable(baseValidator);\n  }\n  \n  parse(value: unknown): TOutput | null {\n    if (value === null) {\n      return null;\n    }\n    return this.baseValidator.parse(value);\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput | null> {\n    if (value === null) {\n      return { success: true, data: null };\n    }\n    return this.baseValidator.safeParse(value);\n  }\n}\n\n/**\n * Nullish validator - allows null or undefined\n */\nexport class VldNullish<TInput, TOutput> extends VldBase<TInput | null | undefined, TOutput | null | undefined> {\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\n    super();\n  }\n  \n  static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullish<TInput, TOutput> {\n    return new VldNullish(baseValidator);\n  }\n  \n  parse(value: unknown): TOutput | null | undefined {\n    if (value === null || value === undefined) {\n      return value as null | undefined;\n    }\n    return this.baseValidator.parse(value);\n  }\n  \n  safeParse(value: unknown): ParseResult<TOutput | null | undefined> {\n    if (value === null || value === undefined) {\n      return { success: true, data: value as null | undefined };\n    }\n    return this.baseValidator.safeParse(value);\n  }\n}"]}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/validators/base.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Base result type for validation\r\n */\r\nexport type ParseResult<T> =\r\n  | { readonly success: true; readonly data: T }\r\n  | { readonly success: false; readonly error: Error };\r\n\r\n/**\r\n * Context for superRefine - allows adding multiple issues\r\n */\r\nexport interface SuperRefineContext {\r\n  addIssue(issue: { message: string; code?: string }): void;\r\n  path: (string | number)[];\r\n}\r\n\r\n/**\r\n * Abstract base class for all validators\r\n * Implements immutable pattern to prevent memory leaks and race conditions\r\n */\r\nexport abstract class VldBase<TInput, TOutput = TInput> {\r\n  /**\r\n   * Parse and validate a value, throwing an error if invalid\r\n   * @param value The value to validate\r\n   * @returns The validated value\r\n   * @throws {Error} If validation fails\r\n   */\r\n  abstract parse(value: unknown): TOutput;\r\n  \r\n  /**\r\n   * Safely parse and validate a value, returning a result object\r\n   * @param value The value to validate\r\n   * @returns A result object with either success and data, or failure and error\r\n   */\r\n  abstract safeParse(value: unknown): ParseResult<TOutput>;\r\n  \r\n  /**\r\n   * Check if a value is valid according to this validator\r\n   * @param value The value to check\r\n   * @returns True if valid, false otherwise\r\n   */\r\n  isValid(value: unknown): boolean {\r\n    return this.safeParse(value).success;\r\n  }\r\n  \r\n  /**\r\n   * Parse a value or return a default if validation fails\r\n   * BUG-NEW-017 FIX: Validate default value to ensure type safety\r\n   * @param value The value to validate\r\n   * @param defaultValue The default value to return on failure\r\n   * @returns The validated value or default\r\n   */\r\n  parseOrDefault(value: unknown, defaultValue: TOutput): TOutput {\r\n    const result = this.safeParse(value);\r\n    if (result.success) {\r\n      return result.data;\r\n    }\r\n\r\n    // Validate the default value to ensure it's actually valid\r\n    const defaultResult = this.safeParse(defaultValue);\r\n    if (!defaultResult.success) {\r\n      throw new Error(`Invalid default value provided: ${defaultResult.error.message}`);\r\n    }\r\n\r\n    return defaultResult.data;\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator that refines this one with a custom predicate\r\n   * @param predicate The refinement predicate\r\n   * @param message Optional custom error message\r\n   * @returns A new refined validator\r\n   */\r\n  refine<TRefined extends TOutput>(\r\n    predicate: (value: TOutput) => value is TRefined,\r\n    message?: string\r\n  ): VldRefine<TInput, TOutput, TRefined>;\r\n  refine(\r\n    predicate: (value: TOutput) => boolean,\r\n    message?: string\r\n  ): VldRefine<TInput, TOutput, TOutput>;\r\n  refine(\r\n    predicate: (value: TOutput) => boolean,\r\n    message?: string\r\n  ): VldRefine<TInput, TOutput, TOutput> {\r\n    return new VldRefine(this, predicate, message);\r\n  }\r\n\r\n  /**\r\n   * Advanced refinement with context for adding multiple issues\r\n   * @param refinement The refinement function with context\r\n   * @returns A new super refined validator\r\n   */\r\n  superRefine(\r\n    refinement: (value: TOutput, ctx: SuperRefineContext) => void | Promise<void>\r\n  ): VldSuperRefine<TInput, TOutput> {\r\n    return new VldSuperRefine(this, refinement);\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that transforms the output\r\n   * @param transformer The transformation function\r\n   * @returns A new transformed validator\r\n   */\r\n  transform<TTransformed>(\r\n    transformer: (value: TOutput) => TTransformed\r\n  ): VldTransform<TInput, TOutput, TTransformed> {\r\n    return new VldTransform(this, transformer);\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator with a default value for undefined inputs\r\n   * @param defaultValue The default value\r\n   * @returns A new validator with default\r\n   */\r\n  default(defaultValue: TOutput): VldDefault<TInput, TOutput> {\r\n    return new VldDefault(this, defaultValue);\r\n  }\r\n  \r\n  /**\r\n   * Create a new validator that catches errors and returns a fallback\r\n   * @param fallbackValue The fallback value\r\n   * @returns A new validator with catch\r\n   */\r\n  catch(fallbackValue: TOutput): VldCatch<TInput, TOutput> {\r\n    return new VldCatch(this, fallbackValue);\r\n  }\r\n  \r\n  /**\r\n   * Make this validator optional (allows undefined)\r\n   * @returns A new optional validator\r\n   */\r\n  optional(): VldOptional<TInput, TOutput> {\r\n    return new VldOptional(this);\r\n  }\r\n  \r\n  /**\r\n   * Make this validator nullable (allows null)\r\n   * @returns A new nullable validator\r\n   */\r\n  nullable(): VldNullable<TInput, TOutput> {\r\n    return new VldNullable(this);\r\n  }\r\n  \r\n  /**\r\n   * Make this validator nullish (allows null or undefined)\r\n   * @returns A new nullish validator\r\n   */\r\n  nullish(): VldNullish<TInput, TOutput> {\r\n    return new VldNullish(this);\r\n  }\r\n\r\n  /**\r\n   * Pipe the output of this validator into another validator\r\n   * @param next The next validator to pipe into\r\n   * @returns A new piped validator\r\n   */\r\n  pipe<TNextOutput>(next: VldBase<TOutput, TNextOutput>): VldPipe<TInput, TOutput, TNextOutput> {\r\n    return new VldPipe(this, next);\r\n  }\r\n\r\n  /**\r\n   * Create a new validator that returns readonly output\r\n   * Zod 4 API parity - marks output as readonly for TypeScript\r\n   * @returns A new readonly validator\r\n   */\r\n  readonly(): VldReadonly<TInput, TOutput> {\r\n    return new VldReadonly(this);\r\n  }\r\n\r\n  /**\r\n   * Brand the output type with a unique brand for nominal typing\r\n   * Zod 4 API parity - prevents accidental assignment of similarly typed values\r\n   * @returns A new branded validator\r\n   * @example\r\n   * const userIdSchema = v.string().brand<'UserId'>();\r\n   * const productIdSchema = v.string().brand<'ProductId'>();\r\n   *\r\n   * let userId: UserId = userIdSchema.parse('abc');\r\n   * let productId: ProductId = productIdSchema.parse('xyz');\r\n   *\r\n   * userId = productId; // TypeScript error: types are incompatible\r\n   */\r\n  brand<TBrand extends string>(): VldBrand<TInput, TOutput, TBrand> {\r\n    return new VldBrand(this);\r\n  }\r\n\r\n  /**\r\n   * Apply an external function to transform this validator\r\n   * Zod 4 API parity - allows external function chaining\r\n   * @param fn External function that takes this validator and returns a new validator\r\n   * @returns The result of applying the function to this validator\r\n   * @example\r\n   * const withLength = (schema: VldBase<unknown, string>) => schema.transform(s => s.length);\r\n   * const lengthSchema = v.string().apply(withLength); // validates string, returns number\r\n   */\r\n  apply<TNewOutput>(fn: (schema: this) => VldBase<TInput, TNewOutput>): VldBase<TInput, TNewOutput> {\r\n    return fn(this);\r\n  }\r\n}\r\n\r\n/**\r\n * Readonly validator - marks output as readonly\r\n */\r\nexport class VldReadonly<TInput, TOutput> extends VldBase<TInput, Readonly<TOutput>> {\r\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\r\n    super();\r\n  }\r\n\r\n  parse(value: unknown): Readonly<TOutput> {\r\n    return this.baseValidator.parse(value);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<Readonly<TOutput>> {\r\n    const result = this.baseValidator.safeParse(value);\r\n    if (result.success) {\r\n      return { success: true, data: result.data as Readonly<TOutput> };\r\n    }\r\n    return result as ParseResult<Readonly<TOutput>>;\r\n  }\r\n}\r\n\r\n/**\r\n * Brand validator - adds a unique brand to the output type for nominal typing\r\n * Uses TypeScript's branded types pattern to prevent accidental assignment\r\n */\r\nexport class VldBrand<TInput, TOutput, TBrand extends string> extends VldBase<\r\n  TInput,\r\n  TOutput & { readonly __brand: TBrand }\r\n> {\r\n  constructor(\r\n    private readonly baseValidator: VldBase<TInput, TOutput>\r\n  ) {\r\n    super();\r\n  }\r\n\r\n  parse(value: unknown): TOutput & { readonly __brand: TBrand } {\r\n    return this.baseValidator.parse(value) as TOutput & {\r\n      readonly __brand: TBrand;\r\n    };\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput & { readonly __brand: TBrand }> {\r\n    const result = this.baseValidator.safeParse(value);\r\n    if (result.success) {\r\n      return {\r\n        success: true,\r\n        data: result.data as TOutput & { readonly __brand: TBrand }\r\n      };\r\n    }\r\n    return result as ParseResult<TOutput & { readonly __brand: TBrand }>;\r\n  }\r\n}\r\n\r\n/**\r\n * Refine validator - adds custom validation\r\n */\r\nexport class VldRefine<TInput, TBase, TOutput extends TBase = TBase> extends VldBase<TInput, TOutput> {\r\n  constructor(\r\n    private readonly baseValidator: VldBase<TInput, TBase>,\r\n    private readonly predicate: (value: TBase) => boolean,\r\n    private readonly customMessage?: string\r\n  ) {\r\n    super();\r\n  }\r\n  \r\n  parse(value: unknown): TOutput {\r\n    const baseResult = this.baseValidator.parse(value);\r\n    \r\n    if (!this.predicate(baseResult)) {\r\n      throw new Error(this.customMessage || 'Refinement check failed');\r\n    }\r\n    \r\n    return baseResult as TOutput;\r\n  }\r\n  \r\n  safeParse(value: unknown): ParseResult<TOutput> {\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/**\r\n * Transform validator - transforms data after validation\r\n */\r\nexport class VldTransform<TInput, TBase, TOutput> extends VldBase<TInput, TOutput> {\r\n  constructor(\r\n    private readonly baseValidator: VldBase<TInput, TBase>,\r\n    private readonly transformer: (value: TBase) => TOutput\r\n  ) {\r\n    super();\r\n  }\r\n  \r\n  parse(value: unknown): TOutput {\r\n    const baseResult = this.baseValidator.parse(value);\r\n    \r\n    try {\r\n      return this.transformer(baseResult);\r\n    } catch (error) {\r\n      throw new Error(`Transform failed: ${(error as Error).message}`);\r\n    }\r\n  }\r\n  \r\n  safeParse(value: unknown): ParseResult<TOutput> {\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/**\r\n * Default validator - provides default value for undefined\r\n * Note: Does not validate the default value at construction time.\r\n * Use .prefault() to validate the default value at parse time.\r\n */\r\nexport class VldDefault<TInput, TOutput> extends VldBase<TInput | undefined, TOutput> {\r\n  constructor(\r\n    private readonly baseValidator: VldBase<TInput, TOutput>,\r\n    private readonly defaultValue: TOutput\r\n  ) {\r\n    super();\r\n  }\r\n\r\n  parse(value: unknown): TOutput {\r\n    if (value === undefined) {\r\n      return this.defaultValue;\r\n    }\r\n    return this.baseValidator.parse(value);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput> {\r\n    if (value === undefined) {\r\n      return { success: true, data: this.defaultValue };\r\n    }\r\n    return this.baseValidator.safeParse(value);\r\n  }\r\n\r\n  /**\r\n   * Pre-parse default - validates the default value instead of returning it directly\r\n   * This is useful when the default value needs to be validated against the schema\r\n   */\r\n  prefault(): VldPrefault<TInput, TOutput> {\r\n    // Return a new validator that validates the default value when parse(undefined) is called\r\n    return new VldPrefault(this.baseValidator, this.defaultValue);\r\n  }\r\n}\r\n\r\n/**\r\n * Prefault validator - validates the default value instead of returning it directly\r\n */\r\nexport class VldPrefault<TInput, TOutput> extends VldBase<TInput | undefined, TOutput> {\r\n  constructor(\r\n    private readonly baseValidator: VldBase<TInput, TOutput>,\r\n    private readonly defaultValue: TOutput\r\n  ) {\r\n    super();\r\n  }\r\n\r\n  parse(value: unknown): TOutput {\r\n    if (value === undefined) {\r\n      // Validate the default value through the base validator\r\n      return this.baseValidator.parse(this.defaultValue as unknown);\r\n    }\r\n    return this.baseValidator.parse(value);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput> {\r\n    if (value === undefined) {\r\n      return this.baseValidator.safeParse(this.defaultValue as unknown);\r\n    }\r\n    return this.baseValidator.safeParse(value);\r\n  }\r\n\r\n  /**\r\n   * Calling prefault multiple times should be safe - return self\r\n   */\r\n  prefault(): VldPrefault<TInput, TOutput> {\r\n    return this;\r\n  }\r\n}\r\n\r\n/**\r\n * Catch validator - provides fallback value on validation error\r\n * BUG-NPM-003 FIX: Validate fallback value at construction time\r\n */\r\nexport class VldCatch<TInput, TOutput> extends VldBase<TInput, TOutput> {\r\n  constructor(\r\n    private readonly baseValidator: VldBase<TInput, TOutput>,\r\n    private readonly fallbackValue: TOutput\r\n  ) {\r\n    super();\r\n    // BUG-NPM-003 FIX: Validate the fallback value to ensure type safety\r\n    const validation = baseValidator.safeParse(fallbackValue);\r\n    if (!validation.success) {\r\n      throw new Error(`Invalid fallback value: ${validation.error.message}`);\r\n    }\r\n  }\r\n  \r\n  parse(value: unknown): TOutput {\r\n    try {\r\n      return this.baseValidator.parse(value);\r\n    } catch {\r\n      return this.fallbackValue;\r\n    }\r\n  }\r\n  \r\n  safeParse(value: unknown): ParseResult<TOutput> {\r\n    const result = this.baseValidator.safeParse(value);\r\n    if (result.success) {\r\n      return result;\r\n    }\r\n    return { success: true, data: this.fallbackValue };\r\n  }\r\n}\r\n\r\n/**\r\n * Optional validator - allows undefined\r\n */\r\nexport class VldOptional<TInput, TOutput> extends VldBase<TInput | undefined, TOutput | undefined> {\r\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\r\n    super();\r\n  }\r\n\r\n  static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldOptional<TInput, TOutput> {\r\n    return new VldOptional(baseValidator);\r\n  }\r\n\r\n  parse(value: unknown): TOutput | undefined {\r\n    if (value === undefined) {\r\n      return undefined;\r\n    }\r\n    return this.baseValidator.parse(value);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput | undefined> {\r\n    if (value === undefined) {\r\n      return { success: true, data: undefined };\r\n    }\r\n    return this.baseValidator.safeParse(value);\r\n  }\r\n\r\n  unwrap(): VldBase<TInput, TOutput> {\r\n    return this.baseValidator;\r\n  }\r\n}\r\n\r\n/**\r\n * Nullable validator - allows null\r\n */\r\nexport class VldNullable<TInput, TOutput> extends VldBase<TInput | null, TOutput | null> {\r\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\r\n    super();\r\n  }\r\n\r\n  static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullable<TInput, TOutput> {\r\n    return new VldNullable(baseValidator);\r\n  }\r\n\r\n  parse(value: unknown): TOutput | null {\r\n    if (value === null) {\r\n      return null;\r\n    }\r\n    return this.baseValidator.parse(value);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput | null> {\r\n    if (value === null) {\r\n      return { success: true, data: null };\r\n    }\r\n    return this.baseValidator.safeParse(value);\r\n  }\r\n\r\n  unwrap(): VldBase<TInput, TOutput> {\r\n    return this.baseValidator;\r\n  }\r\n}\r\n\r\n/**\r\n * Nullish validator - allows null or undefined\r\n */\r\nexport class VldNullish<TInput, TOutput> extends VldBase<TInput | null | undefined, TOutput | null | undefined> {\r\n  constructor(private readonly baseValidator: VldBase<TInput, TOutput>) {\r\n    super();\r\n  }\r\n\r\n  static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullish<TInput, TOutput> {\r\n    return new VldNullish(baseValidator);\r\n  }\r\n\r\n  parse(value: unknown): TOutput | null | undefined {\r\n    if (value === null || value === undefined) {\r\n      return value as null | undefined;\r\n    }\r\n    return this.baseValidator.parse(value);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput | null | undefined> {\r\n    if (value === null || value === undefined) {\r\n      return { success: true, data: value as null | undefined };\r\n    }\r\n    return this.baseValidator.safeParse(value);\r\n  }\r\n\r\n  unwrap(): VldBase<TInput, TOutput> {\r\n    return this.baseValidator;\r\n  }\r\n}\r\n\r\n/**\r\n * Pipe validator - chains validators, passing output of one to the next\r\n */\r\nexport class VldPipe<TInput, TIntermediate, TOutput> extends VldBase<TInput, TOutput> {\r\n  constructor(\r\n    private readonly first: VldBase<TInput, TIntermediate>,\r\n    private readonly second: VldBase<TIntermediate, TOutput>\r\n  ) {\r\n    super();\r\n  }\r\n\r\n  parse(value: unknown): TOutput {\r\n    const intermediateResult = this.first.parse(value);\r\n    return this.second.parse(intermediateResult);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput> {\r\n    const firstResult = this.first.safeParse(value);\r\n    if (!firstResult.success) {\r\n      return firstResult as ParseResult<TOutput>;\r\n    }\r\n    return this.second.safeParse(firstResult.data);\r\n  }\r\n}\r\n\r\n/**\r\n * SuperRefine validator - advanced refinement with context\r\n */\r\nexport class VldSuperRefine<TInput, TOutput> extends VldBase<TInput, TOutput> {\r\n  constructor(\r\n    private readonly _inner: VldBase<TInput, TOutput>,\r\n    private readonly _refinement: (value: TOutput, ctx: SuperRefineContext) => void | Promise<void>\r\n  ) {\r\n    super();\r\n  }\r\n\r\n  parse(value: unknown): TOutput {\r\n    const result = this._inner.parse(value);\r\n\r\n    const issues: { message: string; code?: string }[] = [];\r\n    const ctx: SuperRefineContext = {\r\n      addIssue: (issue) => issues.push(issue),\r\n      path: []\r\n    };\r\n\r\n    const maybePromise = this._refinement(result, ctx);\r\n    if (maybePromise instanceof Promise) {\r\n      throw new Error('Use parseAsync for async refinements');\r\n    }\r\n\r\n    if (issues.length > 0) {\r\n      throw new Error(issues.map(i => i.message).join('; '));\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput> {\r\n    const result = this._inner.safeParse(value);\r\n    if (!result.success) return result as ParseResult<TOutput>;\r\n\r\n    const issues: { message: string; code?: string }[] = [];\r\n    const ctx: SuperRefineContext = {\r\n      addIssue: (issue) => issues.push(issue),\r\n      path: []\r\n    };\r\n\r\n    const maybePromise = this._refinement(result.data, ctx);\r\n    if (maybePromise instanceof Promise) {\r\n      throw new Error('Use safeParseAsync for async refinements');\r\n    }\r\n\r\n    if (issues.length > 0) {\r\n      return {\r\n        success: false,\r\n        error: new Error(issues.map(i => i.message).join('; '))\r\n      };\r\n    }\r\n\r\n    return result;\r\n  }\r\n}\r\n\r\n/**\r\n * Preprocess validator - transforms input before validation\r\n */\r\nexport class VldPreprocess<TInput, TOutput> extends VldBase<unknown, TOutput> {\r\n  constructor(\r\n    private readonly _preprocessor: (input: unknown) => unknown,\r\n    private readonly _schema: VldBase<TInput, TOutput>\r\n  ) {\r\n    super();\r\n  }\r\n\r\n  static create<TInput, TOutput>(\r\n    preprocessor: (input: unknown) => unknown,\r\n    schema: VldBase<TInput, TOutput>\r\n  ): VldPreprocess<TInput, TOutput> {\r\n    return new VldPreprocess(preprocessor, schema);\r\n  }\r\n\r\n  parse(value: unknown): TOutput {\r\n    const preprocessed = this._preprocessor(value);\r\n    return this._schema.parse(preprocessed);\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<TOutput> {\r\n    try {\r\n      const preprocessed = this._preprocessor(value);\r\n      return this._schema.safeParse(preprocessed);\r\n    } catch (error) {\r\n      return {\r\n        success: false,\r\n        error: error as Error\r\n      };\r\n    }\r\n  }\r\n}"]}

package/dist/validators/base64.js

@@ -1,6 +1,6 @@
 import { VldBase } from './base.js';
 import { VldError, createIssue } from '../errors.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Base64 string validator
  */