@oxog/vld 1.5.0 → 2.0.2

package/dist/validators/base.js

@@ -1,499 +0,0 @@
-/**
- * Abstract base class for all validators
- * Implements immutable pattern to prevent memory leaks and race conditions
- */
-export class VldBase {
-    /**
-     * Check if a value is valid according to this validator
-     * @param value The value to check
-     * @returns True if valid, false otherwise
-     */
-    isValid(value) {
-        return this.safeParse(value).success;
-    }
-    /**
-     * 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);
-        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
-     * @returns A new transformed validator
-     */
-    transform(transformer) {
-        return new VldTransform(this, transformer);
-    }
-    /**
-     * Create a new validator with a default value for undefined inputs
-     * @param defaultValue The default value
-     * @returns A new validator with default
-     */
-    default(defaultValue) {
-        return new VldDefault(this, defaultValue);
-    }
-    /**
-     * Create a new validator that catches errors and returns a fallback
-     * @param fallbackValue The fallback value
-     * @returns A new validator with catch
-     */
-    catch(fallbackValue) {
-        return new VldCatch(this, fallbackValue);
-    }
-    /**
-     * Make this validator optional (allows undefined)
-     * @returns A new optional validator
-     */
-    optional() {
-        return new VldOptional(this);
-    }
-    /**
-     * Make this validator nullable (allows null)
-     * @returns A new nullable validator
-     */
-    nullable() {
-        return new VldNullable(this);
-    }
-    /**
-     * Make this validator nullish (allows null or undefined)
-     * @returns A new nullish validator
-     */
-    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
- */
-export class VldRefine extends VldBase {
-    constructor(baseValidator, predicate, customMessage) {
-        super();
-        this.baseValidator = baseValidator;
-        this.predicate = predicate;
-        this.customMessage = customMessage;
-    }
-    parse(value) {
-        const baseResult = this.baseValidator.parse(value);
-        if (!this.predicate(baseResult)) {
-            throw new Error(this.customMessage || 'Refinement check failed');
-        }
-        return baseResult;
-    }
-    safeParse(value) {
-        try {
-            return { success: true, data: this.parse(value) };
-        }
-        catch (error) {
-            return { success: false, error: error };
-        }
-    }
-}
-/**
- * Transform validator - transforms data after validation
- */
-export class VldTransform extends VldBase {
-    constructor(baseValidator, transformer) {
-        super();
-        this.baseValidator = baseValidator;
-        this.transformer = transformer;
-    }
-    parse(value) {
-        const baseResult = this.baseValidator.parse(value);
-        try {
-            return this.transformer(baseResult);
-        }
-        catch (error) {
-            throw new Error(`Transform failed: ${error.message}`);
-        }
-    }
-    safeParse(value) {
-        try {
-            return { success: true, data: this.parse(value) };
-        }
-        catch (error) {
-            return { success: false, error: error };
-        }
-    }
-}
-/**
- * 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) {
-        super();
-        this.baseValidator = baseValidator;
-        this.defaultValue = defaultValue;
-    }
-    parse(value) {
-        if (value === undefined) {
-            return this.defaultValue;
-        }
-        return this.baseValidator.parse(value);
-    }
-    safeParse(value) {
-        if (value === undefined) {
-            return { success: true, data: this.defaultValue };
-        }
-        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 {
-            return this.baseValidator.parse(value);
-        }
-        catch {
-            return this.fallbackValue;
-        }
-    }
-    safeParse(value) {
-        const result = this.baseValidator.safeParse(value);
-        if (result.success) {
-            return result;
-        }
-        return { success: true, data: this.fallbackValue };
-    }
-}
-/**
- * Optional validator - allows undefined
- */
-export class VldOptional extends VldBase {
-    constructor(baseValidator) {
-        super();
-        this.baseValidator = baseValidator;
-    }
-    static create(baseValidator) {
-        return new VldOptional(baseValidator);
-    }
-    parse(value) {
-        if (value === undefined) {
-            return undefined;
-        }
-        return this.baseValidator.parse(value);
-    }
-    safeParse(value) {
-        if (value === undefined) {
-            return { success: true, data: undefined };
-        }
-        return this.baseValidator.safeParse(value);
-    }
-    unwrap() {
-        return this.baseValidator;
-    }
-}
-/**
- * Nullable validator - allows null
- */
-export class VldNullable extends VldBase {
-    constructor(baseValidator) {
-        super();
-        this.baseValidator = baseValidator;
-    }
-    static create(baseValidator) {
-        return new VldNullable(baseValidator);
-    }
-    parse(value) {
-        if (value === null) {
-            return null;
-        }
-        return this.baseValidator.parse(value);
-    }
-    safeParse(value) {
-        if (value === null) {
-            return { success: true, data: null };
-        }
-        return this.baseValidator.safeParse(value);
-    }
-    unwrap() {
-        return this.baseValidator;
-    }
-}
-/**
- * Nullish validator - allows null or undefined
- */
-export class VldNullish extends VldBase {
-    constructor(baseValidator) {
-        super();
-        this.baseValidator = baseValidator;
-    }
-    static create(baseValidator) {
-        return new VldNullish(baseValidator);
-    }
-    parse(value) {
-        if (value === null || value === undefined) {
-            return value;
-        }
-        return this.baseValidator.parse(value);
-    }
-    safeParse(value) {
-        if (value === null || value === undefined) {
-            return { success: true, data: value };
-        }
-        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 +0,0 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/validators/base.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,OAAgB,OAAO;IAgB3B;;;;OAIG;IACH,OAAO,CAAC,KAAc;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,KAAc,EAAE,YAAqB;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,2DAA2D;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,CAAC;IAC5B,CAAC;IAgBD,MAAM,CACJ,SAAsC,EACtC,OAAgB;QAEhB,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,WAAW,CACT,UAA6E;QAE7E,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,SAAS,CACP,WAA6C;QAE7C,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAqB;QAC3B,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAsB;QAC1B,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAc,IAAmC;QACnD,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK;QACH,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAa,EAAiD;QACjE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAA6B,SAAQ,OAAkC;IAClF,YAA6B,aAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAA0B;IAEpE,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAyB,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,MAAwC,CAAC;IAClD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,QAAiD,SAAQ,OAGrE;IACC,YACmB,aAAuC;QAExD,KAAK,EAAE,CAAC;QAFS,kBAAa,GAAb,aAAa,CAA0B;IAG1D,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAEpC,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM,CAAC,IAA8C;aAC5D,CAAC;QACJ,CAAC;QACD,OAAO,MAA6D,CAAC;IACvE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAwD,SAAQ,OAAwB;IACnG,YACmB,aAAqC,EACrC,SAAoC,EACpC,aAAsB;QAEvC,KAAK,EAAE,CAAC;QAJS,kBAAa,GAAb,aAAa,CAAwB;QACrC,cAAS,GAAT,SAAS,CAA2B;QACpC,kBAAa,GAAb,aAAa,CAAS;IAGzC,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEnD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,yBAAyB,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,UAAqB,CAAC;IAC/B,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAqC,SAAQ,OAAwB;IAChF,YACmB,aAAqC,EACrC,WAAsC;QAEvD,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAAwB;QACrC,gBAAW,GAAX,WAAW,CAA2B;IAGzD,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qBAAsB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,UAA4B,SAAQ,OAAoC;IACnF,YACmB,aAAuC,EACvC,YAAqB;QAEtC,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAA0B;QACvC,iBAAY,GAAZ,YAAY,CAAS;IAGxC,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,0FAA0F;QAC1F,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAA6B,SAAQ,OAAoC;IACpF,YACmB,aAAuC,EACvC,YAAqB;QAEtC,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAA0B;QACvC,iBAAY,GAAZ,YAAY,CAAS;IAGxC,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,wDAAwD;YACxD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,YAAuB,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,YAAuB,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,QAA0B,SAAQ,OAAwB;IACrE,YACmB,aAAuC,EACvC,aAAsB;QAEvC,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAA0B;QACvC,kBAAa,GAAb,aAAa,CAAS;QAGvC,qEAAqE;QACrE,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;IACrD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAA6B,SAAQ,OAAgD;IAChG,YAA6B,aAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAA0B;IAEpE,CAAC;IAED,MAAM,CAAC,MAAM,CAAkB,aAAuC;QACpE,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAA6B,SAAQ,OAAsC;IACtF,YAA6B,aAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAA0B;IAEpE,CAAC;IAED,MAAM,CAAC,MAAM,CAAkB,aAAuC;QACpE,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAA4B,SAAQ,OAA8D;IAC7G,YAA6B,aAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAA0B;IAEpE,CAAC;IAED,MAAM,CAAC,MAAM,CAAkB,aAAuC;QACpE,OAAO,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,KAAyB,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAyB,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,OAAwC,SAAQ,OAAwB;IACnF,YACmB,KAAqC,EACrC,MAAuC;QAExD,KAAK,EAAE,CAAC;QAHS,UAAK,GAAL,KAAK,CAAgC;QACrC,WAAM,GAAN,MAAM,CAAiC;IAG1D,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,WAAmC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAgC,SAAQ,OAAwB;IAC3E,YACmB,MAAgC,EAChC,WAA8E;QAE/F,KAAK,EAAE,CAAC;QAHS,WAAM,GAAN,MAAM,CAA0B;QAChC,gBAAW,GAAX,WAAW,CAAmE;IAGjG,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAExC,MAAM,MAAM,GAAyC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAuB;YAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACvC,IAAI,EAAE,EAAE;SACT,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnD,IAAI,YAAY,YAAY,OAAO,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,MAA8B,CAAC;QAE3D,MAAM,MAAM,GAAyC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAuB;YAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACvC,IAAI,EAAE,EAAE;SACT,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,YAAY,YAAY,OAAO,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACxD,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAA+B,SAAQ,OAAyB;IAC3E,YACmB,aAA0C,EAC1C,OAAiC;QAElD,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAA6B;QAC1C,YAAO,GAAP,OAAO,CAA0B;IAGpD,CAAC;IAED,MAAM,CAAC,MAAM,CACX,YAAyC,EACzC,MAAgC;QAEhC,OAAO,IAAI,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAc;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;CACF","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,65 +0,0 @@
-import { VldBase } from './base.js';
-import { VldError, createIssue } from '../errors.js';
-import { getMessages } from '../locales/index.js';
-/**
- * Base64 string validator
- */
-export class VldBase64 extends VldBase {
-    constructor(urlSafe = false) {
-        super();
-        this.urlSafe = urlSafe;
-    }
-    parse(value) {
-        const result = this.safeParse(value);
-        if (!result.success) {
-            throw result.error;
-        }
-        return result.data;
-    }
-    safeParse(value) {
-        if (typeof value !== 'string') {
-            return {
-                success: false,
-                error: new VldError([
-                    createIssue('invalid_type', [], getMessages().expectedString)
-                ])
-            };
-        }
-        // Check if it's a valid base64 string
-        const regex = this.urlSafe ? VldBase64.BASE64_URL_REGEX : VldBase64.BASE64_REGEX;
-        // Check basic format
-        if (!regex.test(value)) {
-            return {
-                success: false,
-                error: new VldError([
-                    createIssue('custom', [], getMessages().invalidBase64)
-                ])
-            };
-        }
-        // For standard base64, check length is multiple of 4 (after padding)
-        // Empty strings are valid (decode to empty buffer)
-        // For URL-safe base64, padding is not required
-        if (!this.urlSafe && value.length > 0 && value.length % 4 !== 0) {
-            return {
-                success: false,
-                error: new VldError([
-                    createIssue('custom', [], getMessages().invalidBase64)
-                ])
-            };
-        }
-        return { success: true, data: value };
-    }
-    /**
-     * Create a URL-safe base64 validator
-     */
-    urlSafeMode() {
-        return new VldBase64(true);
-    }
-    static create(urlSafe = false) {
-        return new VldBase64(urlSafe);
-    }
-}
-VldBase64.BASE64_REGEX = /^[A-Za-z0-9+/]*={0,2}$/;
-// Note: RFC 4648 specifies URL-safe base64 should omit padding, but we allow it for compatibility
-VldBase64.BASE64_URL_REGEX = /^[A-Za-z0-9_-]*={0,2}$/;
-//# sourceMappingURL=base64.js.map

package/dist/validators/base64.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/validators/base64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,OAAuB;IAOpD,YAAY,OAAO,GAAG,KAAK;QACzB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC;iBAC9D,CAAC;aACH,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;QAEjF,qBAAqB;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,aAAa,CAAC;iBACvD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,qEAAqE;QACrE,mDAAmD;QACnD,+CAA+C;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,aAAa,CAAC;iBACvD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK;QAC3B,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;;AAlEuB,sBAAY,GAAG,wBAAwB,CAAC;AAChE,kGAAkG;AAC1E,0BAAgB,GAAG,wBAAwB,CAAC","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { VldError, createIssue } from '../errors';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Base64 string validator\r\n */\r\nexport class VldBase64 extends VldBase<string, string> {\r\n  private static readonly BASE64_REGEX = /^[A-Za-z0-9+/]*={0,2}$/;\r\n  // Note: RFC 4648 specifies URL-safe base64 should omit padding, but we allow it for compatibility\r\n  private static readonly BASE64_URL_REGEX = /^[A-Za-z0-9_-]*={0,2}$/;\r\n  \r\n  private readonly urlSafe: boolean;\r\n  \r\n  constructor(urlSafe = false) {\r\n    super();\r\n    this.urlSafe = urlSafe;\r\n  }\r\n  \r\n  parse(value: unknown): string {\r\n    const result = this.safeParse(value);\r\n    if (!result.success) {\r\n      throw result.error;\r\n    }\r\n    return result.data;\r\n  }\r\n  \r\n  safeParse(value: unknown): ParseResult<string> {\r\n    if (typeof value !== 'string') {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('invalid_type', [], getMessages().expectedString)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    // Check if it's a valid base64 string\r\n    const regex = this.urlSafe ? VldBase64.BASE64_URL_REGEX : VldBase64.BASE64_REGEX;\r\n\r\n    // Check basic format\r\n    if (!regex.test(value)) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().invalidBase64)\r\n        ])\r\n      };\r\n    }\r\n\r\n    // For standard base64, check length is multiple of 4 (after padding)\r\n    // Empty strings are valid (decode to empty buffer)\r\n    // For URL-safe base64, padding is not required\r\n    if (!this.urlSafe && value.length > 0 && value.length % 4 !== 0) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().invalidBase64)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    return { success: true, data: value };\r\n  }\r\n  \r\n  /**\r\n   * Create a URL-safe base64 validator\r\n   */\r\n  urlSafeMode(): VldBase64 {\r\n    return new VldBase64(true);\r\n  }\r\n  \r\n  static create(urlSafe = false): VldBase64 {\r\n    return new VldBase64(urlSafe);\r\n  }\r\n}"]}