@oxog/vld 1.0.0 → 1.1.1

package/dist/validators/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/validators/array.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Configuration for array validator\n */\ninterface ArrayValidatorConfig<T> {\n  readonly itemValidator: VldBase<unknown, T>;\n  readonly minLength?: number;\n  readonly maxLength?: number;\n  readonly exactLength?: number;\n  readonly unique?: boolean;\n  readonly errorMessage?: string;\n}\n\n/**\n * Immutable array validator with chainable methods\n */\nexport class VldArray<T> extends VldBase<unknown[], T[]> {\n  private readonly config: ArrayValidatorConfig<T>;\n  \n  /**\n   * Private constructor to enforce immutability\n   */\n  private constructor(config: ArrayValidatorConfig<T>) {\n    super();\n    this.config = config;\n  }\n  \n  /**\n   * Create a new array validator\n   */\n  static create<T>(itemValidator: VldBase<unknown, T>): VldArray<T> {\n    return new VldArray({ itemValidator });\n  }\n  \n  /**\n   * Parse and validate an array value\n   */\n  parse(value: unknown): T[] {\n    if (!Array.isArray(value)) {\n      throw new Error(this.config.errorMessage || getMessages().invalidArray);\n    }\n    \n    // Validate length constraints\n    if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayLength(this.config.exactLength));\n    }\n    \n    if (this.config.minLength !== undefined && value.length < this.config.minLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayMin(this.config.minLength));\n    }\n    \n    if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {\n      throw new Error(this.config.errorMessage || getMessages().arrayMax(this.config.maxLength));\n    }\n    \n    // Validate each item with optimized loop and safeParse\n    const result: T[] = [];\n    const length = value.length;\n    \n    for (let i = 0; i < length; i++) {\n      const parseResult = this.config.itemValidator.safeParse(value[i]);\n      if (!parseResult.success) {\n        throw new Error(getMessages().arrayItem(i, parseResult.error.message));\n      }\n      result[i] = parseResult.data; // Direct assignment is faster than push\n    }\n    \n    // Check uniqueness if required\n    if (this.config.unique) {\n      const seen = new Set<any>();\n      for (const item of result) {\n        const key = typeof item === 'object' ? JSON.stringify(item) : item;\n        if (seen.has(key)) {\n          throw new Error('Array must contain unique items');\n        }\n        seen.add(key);\n      }\n    }\n    \n    return result;\n  }\n  \n  /**\n   * Safely parse and validate an array value\n   */\n  safeParse(value: unknown): ParseResult<T[]> {\n    try {\n      return { success: true, data: this.parse(value) };\n    } catch (error) {\n      return { success: false, error: error as Error };\n    }\n  }\n  \n  /**\n   * Create a new validator with minimum length constraint\n   */\n  min(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: length,\n      errorMessage: message || getMessages().arrayMin(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with maximum length constraint\n   */\n  max(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      maxLength: length,\n      errorMessage: message || getMessages().arrayMax(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with exact length constraint\n   */\n  length(length: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      exactLength: length,\n      minLength: undefined,\n      maxLength: undefined,\n      errorMessage: message || getMessages().arrayLength(length)\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures array is not empty\n   */\n  nonempty(message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: 1,\n      errorMessage: message || getMessages().arrayEmpty\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures array contains unique items\n   */\n  unique(message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      unique: true,\n      errorMessage: message || 'Array must contain unique items'\n    });\n  }\n  \n  /**\n   * Create a new validator with a range constraint for length\n   */\n  between(min: number, max: number, message?: string): VldArray<T> {\n    return new VldArray({\n      ...this.config,\n      minLength: min,\n      maxLength: max,\n      errorMessage: message || `Array length must be between ${min} and ${max}`\n    });\n  }\n}"]}

package/dist/validators/base.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Base result type for validation
+ */
+export type ParseResult<T> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly error: Error;
+};
+/**
+ * Abstract base class for all validators
+ * Implements immutable pattern to prevent memory leaks and race conditions
+ */
+export declare abstract class VldBase<TInput, TOutput = TInput> {
+    /**
+     * Parse and validate a value, throwing an error if invalid
+     * @param value The value to validate
+     * @returns The validated value
+     * @throws {Error} If validation fails
+     */
+    abstract parse(value: unknown): TOutput;
+    /**
+     * Safely parse and validate a value, returning a result object
+     * @param value The value to validate
+     * @returns A result object with either success and data, or failure and error
+     */
+    abstract safeParse(value: unknown): ParseResult<TOutput>;
+    /**
+     * Check if a value is valid according to this validator
+     * @param value The value to check
+     * @returns True if valid, false otherwise
+     */
+    isValid(value: unknown): boolean;
+    /**
+     * Parse a value or return a default if validation fails
+     * @param value The value to validate
+     * @param defaultValue The default value to return on failure
+     * @returns The validated value or default
+     */
+    parseOrDefault(value: unknown, defaultValue: TOutput): TOutput;
+    /**
+     * Create a new validator that refines this one with a custom predicate
+     * @param predicate The refinement predicate
+     * @param message Optional custom error message
+     * @returns A new refined validator
+     */
+    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>;
+    /**
+     * Create a new validator that transforms the output
+     * @param transformer The transformation function
+     * @returns A new transformed validator
+     */
+    transform<TTransformed>(transformer: (value: TOutput) => TTransformed): VldTransform<TInput, TOutput, TTransformed>;
+    /**
+     * Create a new validator with a default value for undefined inputs
+     * @param defaultValue The default value
+     * @returns A new validator with default
+     */
+    default(defaultValue: TOutput): VldDefault<TInput, TOutput>;
+    /**
+     * Create a new validator that catches errors and returns a fallback
+     * @param fallbackValue The fallback value
+     * @returns A new validator with catch
+     */
+    catch(fallbackValue: TOutput): VldCatch<TInput, TOutput>;
+    /**
+     * Make this validator optional (allows undefined)
+     * @returns A new optional validator
+     */
+    optional(): VldOptional<TInput, TOutput>;
+    /**
+     * Make this validator nullable (allows null)
+     * @returns A new nullable validator
+     */
+    nullable(): VldNullable<TInput, TOutput>;
+    /**
+     * Make this validator nullish (allows null or undefined)
+     * @returns A new nullish validator
+     */
+    nullish(): VldNullish<TInput, TOutput>;
+}
+/**
+ * Refine validator - adds custom validation
+ */
+export declare class VldRefine<TInput, TBase, TOutput extends TBase = TBase> extends VldBase<TInput, TOutput> {
+    private readonly baseValidator;
+    private readonly predicate;
+    private readonly customMessage?;
+    constructor(baseValidator: VldBase<TInput, TBase>, predicate: (value: TBase) => boolean, customMessage?: string | undefined);
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+}
+/**
+ * Transform validator - transforms data after validation
+ */
+export declare class VldTransform<TInput, TBase, TOutput> extends VldBase<TInput, TOutput> {
+    private readonly baseValidator;
+    private readonly transformer;
+    constructor(baseValidator: VldBase<TInput, TBase>, transformer: (value: TBase) => TOutput);
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+}
+/**
+ * Default validator - provides default value for undefined
+ */
+export declare class VldDefault<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>;
+}
+/**
+ * Catch validator - provides fallback value on validation error
+ */
+export declare class VldCatch<TInput, TOutput> extends VldBase<TInput, TOutput> {
+    private readonly baseValidator;
+    private readonly fallbackValue;
+    constructor(baseValidator: VldBase<TInput, TOutput>, fallbackValue: TOutput);
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+}
+/**
+ * Optional validator - allows undefined
+ */
+export declare class VldOptional<TInput, TOutput> extends VldBase<TInput | undefined, TOutput | undefined> {
+    private readonly baseValidator;
+    constructor(baseValidator: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldOptional<TInput, TOutput>;
+    parse(value: unknown): TOutput | undefined;
+    safeParse(value: unknown): ParseResult<TOutput | undefined>;
+}
+/**
+ * Nullable validator - allows null
+ */
+export declare class VldNullable<TInput, TOutput> extends VldBase<TInput | null, TOutput | null> {
+    private readonly baseValidator;
+    constructor(baseValidator: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullable<TInput, TOutput>;
+    parse(value: unknown): TOutput | null;
+    safeParse(value: unknown): ParseResult<TOutput | null>;
+}
+/**
+ * Nullish validator - allows null or undefined
+ */
+export declare class VldNullish<TInput, TOutput> extends VldBase<TInput | null | undefined, TOutput | null | undefined> {
+    private readonly baseValidator;
+    constructor(baseValidator: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullish<TInput, TOutput>;
+    parse(value: unknown): TOutput | null | undefined;
+    safeParse(value: unknown): ParseResult<TOutput | null | undefined>;
+}
+//# sourceMappingURL=base.d.ts.map

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

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

package/dist/validators/base.js

@@ -0,0 +1,245 @@
+/**
+ * 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
+     * @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;
+    }
+    refine(predicate, message) {
+        return new VldRefine(this, predicate, message);
+    }
+    /**
+     * 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);
+    }
+}
+/**
+ * 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
+ */
+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);
+    }
+}
+/**
+ * Catch validator - provides fallback value on validation error
+ */
+export class VldCatch extends VldBase {
+    constructor(baseValidator, fallbackValue) {
+        super();
+        this.baseValidator = baseValidator;
+        this.fallbackValue = fallbackValue;
+    }
+    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);
+    }
+}
+/**
+ * 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);
+    }
+}
+/**
+ * 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);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/validators/base.js.map

@@ -0,0 +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}"]}

package/dist/validators/bigint.d.ts

@@ -0,0 +1,60 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * Type for bigint validation check functions
+ */
+type BigIntCheck = (value: bigint) => boolean;
+/**
+ * Configuration for bigint validator
+ */
+interface BigIntValidatorConfig {
+    readonly checks: ReadonlyArray<BigIntCheck>;
+    readonly errorMessage?: string;
+}
+/**
+ * Immutable bigint validator
+ */
+export declare class VldBigInt extends VldBase<bigint, bigint> {
+    protected readonly config: BigIntValidatorConfig;
+    /**
+     * Protected constructor to allow extension while maintaining immutability
+     */
+    protected constructor(config?: Partial<BigIntValidatorConfig>);
+    /**
+     * Create a new bigint validator
+     */
+    static create(): VldBigInt;
+    /**
+     * Parse and validate a bigint value
+     */
+    parse(value: unknown): bigint;
+    /**
+     * Safely parse and validate a bigint value
+     */
+    safeParse(value: unknown): ParseResult<bigint>;
+    /**
+     * Create a new validator with minimum value constraint
+     */
+    min(value: bigint, message?: string): VldBigInt;
+    /**
+     * Create a new validator with maximum value constraint
+     */
+    max(value: bigint, message?: string): VldBigInt;
+    /**
+     * Create a new validator that checks for positive values
+     */
+    positive(message?: string): VldBigInt;
+    /**
+     * Create a new validator that checks for negative values
+     */
+    negative(message?: string): VldBigInt;
+    /**
+     * Create a new validator that checks for non-negative values
+     */
+    nonnegative(message?: string): VldBigInt;
+    /**
+     * Create a new validator that checks for non-positive values
+     */
+    nonpositive(message?: string): VldBigInt;
+}
+export {};
+//# sourceMappingURL=bigint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bigint.d.ts","sourceRoot":"","sources":["../../src/validators/bigint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAE9C;;GAEG;AACH,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEjD;;OAEG;IACH,SAAS,aAAa,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAQ7D;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,SAAS;IAI1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAe7B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;IAQ9C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAO/C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAO/C;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAOrC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAOrC;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAOxC;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAMzC"}

package/dist/validators/bigint.js

@@ -0,0 +1,104 @@
+import { VldBase } from './base.js';
+import { getMessages } from '../locales.js';
+/**
+ * Immutable bigint validator
+ */
+export class VldBigInt extends VldBase {
+    /**
+     * Protected constructor to allow extension while maintaining immutability
+     */
+    constructor(config) {
+        super();
+        this.config = {
+            checks: config?.checks || [],
+            errorMessage: config?.errorMessage
+        };
+    }
+    /**
+     * Create a new bigint validator
+     */
+    static create() {
+        return new VldBigInt();
+    }
+    /**
+     * Parse and validate a bigint value
+     */
+    parse(value) {
+        if (typeof value !== 'bigint') {
+            throw new Error(this.config.errorMessage || getMessages().invalidBigint);
+        }
+        // Apply all checks
+        for (const check of this.config.checks) {
+            if (!check(value)) {
+                throw new Error(this.config.errorMessage || getMessages().invalidBigint);
+            }
+        }
+        return value;
+    }
+    /**
+     * Safely parse and validate a bigint value
+     */
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    }
+    /**
+     * Create a new validator with minimum value constraint
+     */
+    min(value, message) {
+        return new VldBigInt({
+            checks: [...this.config.checks, (v) => v >= value],
+            errorMessage: message || `BigInt must be at least ${value}`
+        });
+    }
+    /**
+     * Create a new validator with maximum value constraint
+     */
+    max(value, message) {
+        return new VldBigInt({
+            checks: [...this.config.checks, (v) => v <= value],
+            errorMessage: message || `BigInt must be at most ${value}`
+        });
+    }
+    /**
+     * Create a new validator that checks for positive values
+     */
+    positive(message) {
+        return new VldBigInt({
+            checks: [...this.config.checks, (v) => v > 0n],
+            errorMessage: message || 'BigInt must be positive'
+        });
+    }
+    /**
+     * Create a new validator that checks for negative values
+     */
+    negative(message) {
+        return new VldBigInt({
+            checks: [...this.config.checks, (v) => v < 0n],
+            errorMessage: message || 'BigInt must be negative'
+        });
+    }
+    /**
+     * Create a new validator that checks for non-negative values
+     */
+    nonnegative(message) {
+        return new VldBigInt({
+            checks: [...this.config.checks, (v) => v >= 0n],
+            errorMessage: message || 'BigInt must be non-negative'
+        });
+    }
+    /**
+     * Create a new validator that checks for non-positive values
+     */
+    nonpositive(message) {
+        return new VldBigInt({
+            checks: [...this.config.checks, (v) => v <= 0n],
+            errorMessage: message || 'BigInt must be non-positive'
+        });
+    }
+}
+//# sourceMappingURL=bigint.js.map

package/dist/validators/bigint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint.js","sourceRoot":"","sources":["../../src/validators/bigint.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Type for bigint validation check functions\n */\ntype BigIntCheck = (value: bigint) => boolean;\n\n/**\n * Configuration for bigint validator\n */\ninterface BigIntValidatorConfig {\n  readonly checks: ReadonlyArray<BigIntCheck>;\n  readonly errorMessage?: string;\n}\n\n/**\n * Immutable bigint validator\n */\nexport class VldBigInt extends VldBase<bigint, bigint> {\n  protected readonly config: BigIntValidatorConfig;\n  \n  /**\n   * Protected constructor to allow extension while maintaining immutability\n   */\n  protected constructor(config?: Partial<BigIntValidatorConfig>) {\n    super();\n    this.config = {\n      checks: config?.checks || [],\n      errorMessage: config?.errorMessage\n    };\n  }\n  \n  /**\n   * Create a new bigint validator\n   */\n  static create(): VldBigInt {\n    return new VldBigInt();\n  }\n  \n  /**\n   * Parse and validate a bigint value\n   */\n  parse(value: unknown): bigint {\n    if (typeof value !== 'bigint') {\n      throw new Error(this.config.errorMessage || getMessages().invalidBigint);\n    }\n    \n    // Apply all checks\n    for (const check of this.config.checks) {\n      if (!check(value)) {\n        throw new Error(this.config.errorMessage || getMessages().invalidBigint);\n      }\n    }\n    \n    return value;\n  }\n  \n  /**\n   * Safely parse and validate a bigint value\n   */\n  safeParse(value: unknown): ParseResult<bigint> {\n    try {\n      return { success: true, data: this.parse(value) };\n    } catch (error) {\n      return { success: false, error: error as Error };\n    }\n  }\n  \n  /**\n   * Create a new validator with minimum value constraint\n   */\n  min(value: bigint, message?: string): VldBigInt {\n    return new VldBigInt({\n      checks: [...this.config.checks, (v: bigint) => v >= value],\n      errorMessage: message || `BigInt must be at least ${value}`\n    });\n  }\n  \n  /**\n   * Create a new validator with maximum value constraint\n   */\n  max(value: bigint, message?: string): VldBigInt {\n    return new VldBigInt({\n      checks: [...this.config.checks, (v: bigint) => v <= value],\n      errorMessage: message || `BigInt must be at most ${value}`\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for positive values\n   */\n  positive(message?: string): VldBigInt {\n    return new VldBigInt({\n      checks: [...this.config.checks, (v: bigint) => v > 0n],\n      errorMessage: message || 'BigInt must be positive'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for negative values\n   */\n  negative(message?: string): VldBigInt {\n    return new VldBigInt({\n      checks: [...this.config.checks, (v: bigint) => v < 0n],\n      errorMessage: message || 'BigInt must be negative'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for non-negative values\n   */\n  nonnegative(message?: string): VldBigInt {\n    return new VldBigInt({\n      checks: [...this.config.checks, (v: bigint) => v >= 0n],\n      errorMessage: message || 'BigInt must be non-negative'\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for non-positive values\n   */\n  nonpositive(message?: string): VldBigInt {\n    return new VldBigInt({\n      checks: [...this.config.checks, (v: bigint) => v <= 0n],\n      errorMessage: message || 'BigInt must be non-positive'\n    });\n  }\n}"]}