@decaf-ts/decorator-validation 1.11.23 → 1.12.0

package/lib/utils/hashing.d.ts

@@ -1,82 +0,0 @@
-/**
- * @summary Mimics Java's String's Hash implementation
- *
- * @param {string | number | symbol | Date} obj
- * @return {number} hash value of obj
- *
- * @function hashCode
- * @memberOf module:decorator-validation
- * @category Model
- */
-export declare function hashCode(obj: string | number | symbol | Date): string;
-/**
- * @summary Defines teh type for a Hashing function
- * @memberOf module:decorator-validation
- * @category Model
- */
-export type HashingFunction = (value: any, ...args: any[]) => string;
-/**
- * @summary Hashes an object by combining the hash of all its properties
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashObj
- * @memberOf module:decorator-validation
- * @category Model
- */
-export declare function hashObj(obj: Record<string, any> | any[]): string;
-export declare const DefaultHashingMethod = "default";
-/**
- * @description Manages hashing methods and provides a unified hashing interface
- * @summary A utility class that provides a registry for different hashing functions and methods to hash objects.
- * The class maintains a cache of registered hashing functions and allows setting a default hashing method.
- * It prevents direct instantiation and provides static methods for registration and hashing.
- *
- * @class Hashing
- * @category Model
- *
- * @example
- * ```typescript
- * // Register a custom hashing function
- * Hashing.register('md5', (obj) => createMD5Hash(obj), true);
- *
- * // Hash an object using default method
- * const hash1 = Hashing.hash(myObject);
- *
- * // Hash using specific method
- * const hash2 = Hashing.hash(myObject, 'md5');
- * ```
- */
-export declare class Hashing {
-    /**
-     * @description Current default hashing method identifier
-     * @private
-     */
-    private static current;
-    /**
-     * @description Cache of registered hashing functions
-     * @private
-     */
-    private static cache;
-    private constructor();
-    /**
-     * @description Retrieves a registered hashing function
-     * @summary Fetches a hashing function from the cache by its key. Throws an error if the method is not registered.
-     *
-     * @param {string} key - The identifier of the hashing function to retrieve
-     * @return {HashingFunction} The requested hashing function
-     * @private
-     */
-    private static get;
-    /**
-     * @description Registers a new hashing function
-     * @summary Adds a new hashing function to the registry. Optionally sets it as the default method.
-     * Throws an error if a method with the same key is already registered.
-     *
-     * @param {string} key - The identifier for the hashing function
-     */
-    static register(key: string, func: HashingFunction, setDefault?: boolean): void;
-    static hash(obj: any, method?: string, ...args: any[]): any;
-    static setDefault(method: string): void;
-}

package/lib/utils/hashing.js.map

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

package/lib/utils/index.d.ts

@@ -1,11 +0,0 @@
-export * from "./constants";
-export * from "./DateBuilder";
-export * from "./dates";
-export * from "./equality";
-export * from "./hashing";
-export * from "./PathProxy";
-export * from "./registry";
-export * from "./serializers";
-export * from "./serialization";
-export * from "./strings";
-export * from "./types";

package/lib/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA4B;AAC5B,oDAA8B;AAC9B,8CAAwB;AACxB,iDAA2B;AAC3B,gDAA0B;AAC1B,kDAA4B;AAC5B,iDAA2B;AAC3B,oDAA8B,CAAC,kCAAkC;AACjE,sDAAgC;AAChC,gDAA0B;AAC1B,8CAAwB"}

package/lib/utils/registry.d.ts

@@ -1,68 +0,0 @@
-import { Constructor } from "@decaf-ts/decoration";
-/**
- * @summary Basic interface for Registries
- *
- * @interface IRegistry
- *
- * @category Model
- */
-export interface IRegistry<T> {
-    /**
-     * @summary Registers an Object
-     *
-     * @param {T} obj
-     * @param {any[]} args
-     *
-     * @method
-     */
-    register(obj: T | any, ...args: any[]): void;
-    /**
-     * @summary Retrieves an Object if it can find it
-     *
-     * @param {any} key
-     * @param {any[]} args
-     * @return {T | undefined}
-     *
-     * @method
-     */
-    get(key: any, ...args: any[]): T | undefined;
-}
-/**
- * @summary Basic Builder Registry Interface
- *
- * @template T
- * @interface BuilderRegistry<T>
- *
- * @category Model
- */
-export interface BuilderRegistry<T> extends IRegistry<Constructor<T>> {
-    /**
-     * @summary Retrieves an Builder Object by name if it can
-     *
-     * @param {string} name
-     * @param {any[]} args
-     *
-     * @method
-     */
-    get(name: string, ...args: any[]): Constructor<T> | undefined;
-    /**
-     * @summary Registers a constructor by name
-     *
-     * @param {Constructor<T>} [constructor]
-     * @param {name} name
-     * @param {any[]} args
-     *
-     * @method
-     */
-    register(constructor: Constructor<T>, name?: string, ...args: any[]): void;
-    /**
-     * @summary Builds an Object by name
-     *
-     * @param {{}} obj
-     * @param {any[]} args
-     * @return T
-     *
-     * @method
-     */
-    build(obj: Record<string, any> | T, ...args: any[]): T;
-}

package/lib/utils/serialization.d.ts

@@ -1,12 +0,0 @@
-import { Constructor } from "@decaf-ts/decoration";
-import { Serializer } from "./types";
-export declare class Serialization {
-    private static current;
-    private static cache;
-    private constructor();
-    private static get;
-    static register(key: string, func: Constructor<Serializer<any>>, setDefault?: boolean): void;
-    static serialize(obj: any, method?: string, ...args: any[]): any;
-    static deserialize(obj: string, method?: string, ...args: any[]): any;
-    static setDefault(method: string): void;
-}

package/lib/utils/serialization.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/utils/serialization.ts"],"names":[],"mappings":";;;AAEA,+CAAyD;AAEzD,MAAa,aAAa;aACT,YAAO,GAAW,sCAA0B,CAAC;IAI5D,gBAAuB,CAAC;IAEhB,MAAM,CAAC,GAAG,CAAC,GAAW;QAC5B,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,4CAA4C,GAAG,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,QAAQ,CACb,GAAW,EACX,IAAkC,EAClC,UAAU,GAAG,KAAK;QAElB,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK;YACnB,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,qBAAqB,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,UAAU;YAAE,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAQ,EAAE,MAAe,EAAE,GAAG,IAAW;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,GAAW,EAAE,MAAe,EAAE,GAAG,IAAW;QAC7D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAc;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;;AAnCH,sCAoCC"}

package/lib/utils/serializers.d.ts

@@ -1,41 +0,0 @@
-import { Serializer } from "./types";
-import { Model } from "../model/Model";
-/**
- * @summary Concrete implementation of a {@link Serializer} in JSON format
- * @description JS's native JSON.stringify (used here) is not deterministic
- * and therefore should not be used for hashing purposes
- *
- * To keep dependencies low, we will not implement this, but we recommend
- * implementing a similar {@link JSONSerializer} using 'deterministic-json' libraries
- *
- * @class JSONSerializer
- * @implements Serializer
- *
- * @category Model
- */
-export declare class JSONSerializer<T extends Model<boolean>> implements Serializer<T> {
-    constructor();
-    /**
-     * @summary prepares the model for serialization
-     * @description returns a shallow copy of the object, containing an enumerable {@link ModelKeys#ANCHOR} property
-     * so the object can be recognized upon deserialization
-     *
-     * @param {T} model
-     * @protected
-     */
-    protected preSerialize(model: T, ...args: any[]): Record<string, any>;
-    /**
-     * @summary Rebuilds a model from a serialization
-     * @param {string} str
-     *
-     * @throws {Error} If it fails to parse the string, or to build the model
-     */
-    deserialize(str: string, ...args: any[]): T;
-    /**
-     * @summary Serializes a model
-     * @param {T} model
-     *
-     * @throws {Error} if fails to serialize
-     */
-    serialize(model: T, ...args: any[]): string;
-}

package/lib/utils/serializers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serializers.js","sourceRoot":"","sources":["../../src/utils/serializers.ts"],"names":[],"mappings":";;;AACA,qDAA6D;AAC7D,gDAAuC;AACvC,+CAAwC;AACxC,uDAAgD;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAa,cAAc;IACzB,gBAAe,CAAC;IAChB;;;;;;;OAOG;IACH,6DAA6D;IACnD,YAAY,CAAC,KAAQ,EAAE,GAAG,IAAW;QAC7C,6EAA6E;QAC7E,wCAAwC;QACxC,MAAM,WAAW,GAAwB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,qBAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,WAA0B,CAAC,CAAC;YAChE,6DAA6D;QAC/D,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;QACD,WAAW,CAAC,qBAAS,CAAC,MAAM,CAAC,GAAG,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACnE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,6DAA6D;IAC7D,WAAW,CAAC,GAAW,EAAE,GAAG,IAAW;QACrC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,eAAe,CAAC,qBAAS,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS;YACZ,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,MAAM,KAAK,GAAM,aAAK,CAAC,KAAK,CAAC,eAAe,EAAE,SAAS,CAAiB,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,6DAA6D;IAC7D,SAAS,CAAC,KAAQ,EAAE,GAAG,IAAW;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;CACF;AApDD,wCAoDC;AAED,6BAAa,CAAC,OAAO,CAAC,GAAG;IACvB,IAAI,EAAE,IAAI,cAAc,EAAE;CAC3B,CAAC"}

package/lib/utils/strings.d.ts

@@ -1,25 +0,0 @@
-/**
- * @summary Util function to provide string format functionality similar to C#'s string.format
- *
- * @param {string} string
- * @param {Array<string | number>} [args] replacements made by order of appearance (replacement0 wil replace {0} and so on)
- * @return {string} formatted string
- *
- * @function stringFormat
- * @memberOf module:decorator-validation
- * @category Model
- */
-export declare function stringFormat(string: string, ...args: (string | number)[]): string;
-/**
- * @summary Util function to provide string format functionality similar to C#'s string.format
- * @description alias for {@link stringFormat}
- *
- * @param {string} string
- * @param {string} args replacements made by order of appearance (replacement0 wil replace {0} and so on)
- * @return {string} formatted string
- *
- * @function sf
- * @memberOf module:decorator-validation
- * @category Model
- */
-export declare const sf: typeof stringFormat;

package/lib/utils/strings.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":";;;AAWA,oCAMC;AAjBD;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAAC,MAAc,EAAE,GAAG,IAAyB;IACvE,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,KAAK,EAAE,MAAM;QACvD,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,WAAW;YACxC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;YACzB,CAAC,CAAC,WAAW,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACU,QAAA,EAAE,GAAG,YAAY,CAAC"}

package/lib/utils/types.d.ts

@@ -1,35 +0,0 @@
-import { Model } from "../model";
-/**
- * @description Interface for serializing and deserializing model objects
- * @summary Defines the contract for classes that can convert model objects to and from string representations.
- * Serializers are used to persist models or transmit them over networks.
- *
- * @interface Serializer
- * @template T Type of model that can be serialized, must extend Model
- * @memberOf module:decorator-validation
- * @category Model
- */
-export interface Serializer<M extends Model> {
-    /**
-     * @description Converts a model object to a string representation
-     * @summary Serializes a model instance into a string format that can be stored or transmitted.
-     * Additional arguments can be provided to customize the serialization process.
-     *
-     * @param {T} model - The model instance to serialize
-     * @param {...any} args - Additional arguments for the serialization process
-     * @return {string} The serialized representation of the model
-     * @throws {Error} If the model cannot be serialized
-     */
-    serialize(model: M, ...args: any[]): string;
-    /**
-     * @description Reconstructs a model object from its string representation
-     * @summary Deserializes a string back into a model instance.
-     * Additional arguments can be provided to customize the deserialization process.
-     *
-     * @param {string} str - The serialized string to convert back to a model
-     * @param {...any} args - Additional arguments for the deserialization process
-     * @return {T} The reconstructed model instance
-     * @throws {Error} If the string cannot be deserialized into a valid model
-     */
-    deserialize(str: string, ...args: any[]): M;
-}

package/lib/validation/Validation.d.ts

@@ -1,53 +0,0 @@
-import { Validator } from "./Validators/Validator";
-import { IValidatorRegistry, ValidatorDefinition } from "./types";
-/**
- * @summary Static class acting as a namespace for the Validation
- *
- * @class Validation
- * @static
- *
- * @category Validation
- */
-export declare class Validation {
-    private static actingValidatorRegistry?;
-    private constructor();
-    /**
-     * @summary Defines the acting ValidatorRegistry
-     *
-     * @param {IValidatorRegistry} validatorRegistry the new implementation of the validator Registry
-     * @param {function(Validator): Validator} [migrationHandler] the method to map the validator if required;
-     */
-    static setRegistry(validatorRegistry: IValidatorRegistry<Validator>, migrationHandler?: (validator: Validator) => Validator): void;
-    /**
-     * @summary Returns the current ValidatorRegistry
-     *
-     * @return IValidatorRegistry, defaults to {@link ValidatorRegistry}
-     */
-    private static getRegistry;
-    /**
-     * @summary Retrieves a validator
-     *
-     * @param {string} validatorKey one of the {@link ValidationKeys}
-     * @return {Validator | undefined} the registered Validator or undefined if there is nono matching the provided key
-     */
-    static get<T extends Validator>(validatorKey: string): T | undefined;
-    /**
-     * @summary Registers the provided validators onto the registry
-     *
-     * @param {T[] | ValidatorDefinition[]} validator
-     */
-    static register<T extends Validator>(...validator: (ValidatorDefinition | T)[]): void;
-    /**
-     * @summary Builds the key to store as Metadata under Reflections
-     * @description concatenates {@link ValidationKeys#REFLECT} with the provided key
-     *
-     * @param {string} key
-     */
-    static key(key: string): string;
-    /**
-     * @summary Returns all registered validation keys
-     */
-    static keys(): string[];
-    static registerDecorator(key: string, decorator: (...args: any[]) => PropertyDecorator): void;
-    static decoratorFromKey(key: string): any;
-}

package/lib/validation/Validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Validation.js","sourceRoot":"","sources":["../../src/validation/Validation.ts"],"names":[],"mappings":";;;AAEA,0EAAmE;AACnE,0DAAwD;AACxD,wDAA+C;AAC/C,qDAAgD;AAEhD;;;;;;;GAOG;AACH,MAAa,UAAU;aACN,4BAAuB,GACpC,SAAS,CAAC;IAEZ,gBAAuB,CAAC;IAExB;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAChB,iBAAgD,EAChD,gBAAsD;QAEtD,IAAI,gBAAgB,IAAI,UAAU,CAAC,uBAAuB;YACxD,UAAU,CAAC,uBAAuB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAS,EAAE,EAAE;gBACjE,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC3C,IAAI,SAAS;oBAAE,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;QACL,UAAU,CAAC,uBAAuB,GAAG,iBAAiB,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,WAAW;QACxB,IAAI,CAAC,UAAU,CAAC,uBAAuB;YACrC,UAAU,CAAC,uBAAuB,GAAG,IAAI,qCAAiB,EAAE,CAAC;QAC/D,OAAO,UAAU,CAAC,uBAAuB,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAsB,YAAoB;QAClD,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CACb,GAAG,SAAsC;QAEzC,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,OAAO,0BAAc,CAAC,OAAO,GAAG,GAAG,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,iBAAiB,CACtB,GAAW,EACX,SAAgD;QAEhD,MAAM,IAAI,GAAG,qBAAQ,CAAC,UAAU,CAAC,CAC/B,MAAM,CAAC,GAAG,CAAC,qBAAS,CAAC,UAAU,CAAC,EAChC,qBAAQ,CAAC,GAAG,CAAC,0BAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CACO,CAAC;QACnD,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO;QACxB,qBAAQ,CAAC,GAAG,CACV,qBAAS,CAAC,UAAU,EACpB,qBAAQ,CAAC,GAAG,CAAC,0BAAc,CAAC,OAAO,EAAE,GAAG,CAAC,EACzC,SAAS,CACV,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,GAAW;QACjC,IAAI,CAAC;YACH,OAAO,qBAAQ,CAAC,UAAU,CAAC,CACzB,MAAM,CAAC,GAAG,CAAC,qBAAS,CAAC,UAAU,CAAC,EAChC,qBAAQ,CAAC,GAAG,CAAC,0BAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;;AAlGH,gCAmGC"}

package/lib/validation/Validators/AsyncValidator.d.ts

@@ -1,72 +0,0 @@
-import type { ValidatorOptions } from "../types";
-import type { PathProxy } from "../../utils";
-import { BaseValidator } from "./BaseValidator";
-/**
- * @description
- * Abstract class for defining asynchronous validators.
- *
- * This class extends the base `Validator` and enforces that any implementation
- * of `hasErrors` must be asynchronous, always returning a Promise.
- *
- * Use this when the validation process involves asynchronous operations,
- * such as API calls, database lookups, or time-based checks (e.g., timeouts).
- *
- * @example
- * ```typescript
- * // Example of an asynchronous validator that compares value against a timeout
- * class TimeoutValidator extends AsyncValidator<{ timeout?: number }> {
- *   constructor(message: string = "Validation failed due to timeout") {
- *     super(message);
- *   }
- *
- *   async hasErrors(value: number, options?: { timeout?: number }) {
- *     const delay = options?.timeout ?? 100;
- *
- *     // async call
- *     await new Promise(res => setTimeout(res, delay));
- *
- *     if (value > delay) {
- *       // Rejects the validation after waiting the delay if value is greater
- *       return Promise.resolve(this.getMessage());
- *     }
- *
- *     // Passes the validation after waiting the delay
- *     return Promise.resolve(undefined);
- *   }
- * }
- *
- * // Example usage:
- * const validator = new TimeoutValidator();
- *
- * async function runValidation() {
- *  const error = await validator.hasErrors(50, { timeout: 100 });
- *  if (error) {
- *    return console.error('Validation error:', error);
- *  }
- *  console.log('Value is valid');
- * }
- *
- * await runValidation();
- * ```
- *
- * - If `value > timeout`, the validator waits for the delay and then rejects with an error.
- * - If `value <= timeout`, the validator waits for the delay and resolves successfully with `undefined`.
- *
- * @see {@link Validator} For the base synchronous validator.
- */
-export declare abstract class AsyncValidator<V extends ValidatorOptions> extends BaseValidator<V, true> {
-    protected constructor(message?: string, ...acceptedTypes: string[]);
-    /**
-     * @description
-     * Asynchronously validates a value.
-     *
-     * @template V - Type of the option object that can be passed to the validator
-     * @param {any} value - The value to validate
-     * @param {V} [options] - Optional configuration options for customizing validation behavior
-     * @param {PathProxy<any>} proxy -
-     * @return Promise<string | undefined> Error message if validation fails, undefined if validation passes
-     *
-     * @see {@link Validator}
-     */
-    abstract hasErrors(value: any, options?: V, proxy?: PathProxy<any>): Promise<string | undefined>;
-}

package/lib/validation/Validators/AsyncValidator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AsyncValidator.js","sourceRoot":"","sources":["../../../src/validation/Validators/AsyncValidator.ts"],"names":[],"mappings":";;;AAEA,uDAAgD;AAChD,+CAAqD;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAsB,cAEpB,SAAQ,6BAAsB;IAC9B,YACE,UAAkB,kCAAsB,CAAC,OAAO,EAChD,GAAG,aAAuB;QAE1B,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC;IACzC,CAAC;CAmBF;AA3BD,wCA2BC"}

package/lib/validation/Validators/BaseValidator.d.ts

@@ -1,118 +0,0 @@
-import { ValidatorOptions } from "../types";
-import type { PathProxy } from "../../utils";
-import type { ConditionalAsync } from "../../types";
-/**
- * @description Abstract base class for all validators in the validation framework.
- * @summary The BaseValidator class provides the foundation for all synchronous and asynchronous validator implementations.
- * It handles type checking, error message formatting, and defines the interface that all validators must implement.
- * This class is designed to be extended by specific validator classes that define their own validation logic.
- *
- * @template V - Validator options type
- * @template IsAsync - Whether the validator is async (true) or sync (false). Default `false`.
- *
- * @param {boolean} async - Defines if the validator is async (must match the subclass signature)
- * @param {string} message - Default error message to display when validation fails (defaults to {@link DEFAULT_ERROR_MESSAGES#DEFAULT})
- * @param {string[]} acceptedTypes - Type names that this validator accepts (used for runtime type checking)
- *
- * @class BaseValidator
- * @abstract
- *
- * @example
- * // Example of a synchronous validator
- * class SyncValidator extends BaseValidator<SomeOptions, false> {
- *   constructor() {
- *     super(false, "Sync validation failed", String.name);
- *   }
- *
- *   public hasErrors(value: any, options?: SomeOptions): string | undefined {
- *     if (typeof value !== "string") return this.getMessage(this.message);
- *     return undefined;
- *   }
- * }
- *
- * @example
- * // Example of an asynchronous custom validator
- * class AsyncValidator extends BaseValidator<SomeOptions, true> {
- *   constructor() {
- *     super(true, "Async validation failed", String.name);
- *   }
- *
- *   public async hasErrors(value: any, options?: SomeOptions): Promise<string | undefined> {
- *     const result = await someAsyncCheck(value);
- *     if (!result) return this.getMessage(this.message);
- *     return undefined;
- *   }
- * }
- *
- * @mermaid
- * sequenceDiagram
- *   participant C as Client
- *   participant V as Validator Subclass
- *   participant B as BaseValidator
- *
- *   C->>V: new CustomValidator(async, message)
- *   V->>B: super(async, message, acceptedTypes)
- *   B->>B: Store message, async flag, and accepted types
- *   B->>B: Optionally wrap hasErrors with type checking
- *   C->>V: hasErrors(value, options)
- *   alt value type not in acceptedTypes
- *     B-->>C: Type error message
- *   else value type is accepted
- *     V->>V: Custom validation logic
- *     V-->>C: Validation result
- *   end
- *
- * @category Validators
- */
-export declare abstract class BaseValidator<V extends ValidatorOptions = ValidatorOptions, Async extends boolean = false> {
-    readonly message: string;
-    readonly acceptedTypes?: string[];
-    readonly async?: Async;
-    protected constructor(async: Async, message?: string, ...acceptedTypes: string[]);
-    /**
-     * @description Formats an error message with optional arguments
-     * @summary Creates a formatted error message by replacing placeholders with provided arguments.
-     * This method uses the string formatting utility to generate consistent error messages
-     * across all validators.
-     *
-     * @param {string} message - The message template with placeholders
-     * @param {...any} args - Values to insert into the message template
-     * @return {string} The formatted error message
-     * @protected
-     */
-    protected getMessage(message: string, ...args: any[]): string;
-    /**
-     * @description Creates a type-checking wrapper around the hasErrors method
-     * @summary Wraps the hasErrors method with type validation logic to ensure that
-     * the value being validated is of an accepted type before performing specific validation.
-     * This method is called during construction if acceptedTypes are provided.
-     *
-     * @param {Function} unbound - The original hasErrors method to be wrapped
-     * @return {Function} A new function that performs type checking before calling the original method
-     * @private
-     */
-    private checkTypeAndHasErrors;
-    /**
-     * @description Validates a value against specific validation rules
-     * @summary Abstract method that must be implemented by all validator subclasses.
-     * This method contains the core validation logic that determines whether a value
-     * is valid according to the specific rules of the validator. If the value is valid,
-     * the method returns undefined; otherwise, it returns an error message.
-     *
-     * @template V - Type of the options object that can be passed to the validator
-     * @param {any} value - The value to validate
-     * @param {V} [options] - Optional configuration options for customizing validation behavior
-     * @param {PathProxy<any>} proxy -
-     * @return {string | undefined} Error message if validation fails, undefined if validation passes
-     *
-     * @abstract
-     *
-     * @see Model#validate
-     */
-    abstract hasErrors(value: any, options?: V, proxy?: PathProxy<any>): ConditionalAsync<Async, string | undefined>;
-    /**
-     * @summary Duck typing for Validators
-     * @param val
-     */
-    static isValidator(val: any): boolean;
-}

package/lib/validation/Validators/BaseValidator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"BaseValidator.js","sourceRoot":"","sources":["../../../src/validation/Validators/BaseValidator.ts"],"names":[],"mappings":";;;AAAA,+CAAqD;AACrD,uDAAyC;AAIzC,uCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAsB,aAAa;IAQjC,YACE,KAAY,EACZ,UAAkB,kCAAsB,CAAC,OAAO,EAChD,GAAG,aAAuB;QAE1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,aAAa,CAAC,MAAM;YAAE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QAC7D,IAAI,IAAI,CAAC,aAAa;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,qBAAqB,CACzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAQ,CAC1B,CAAC;IACb,CAAC;IAED;;;;;;;;;;OAUG;IACO,UAAU,CAAC,OAAe,EAAE,GAAG,IAAW;QAClD,OAAO,IAAA,YAAE,EAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;OASG;IACK,qBAAqB,CAC3B,OAKgD;QAEhD,OAAO,UAEL,KAAU,EACV,OAAU,EACV,KAAsB,EACtB,GAAG,IAAW;YAEd,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,aAAa;gBAC5C,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,IAAA,kBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;gBACxC,OAAO,IAAI,CAAC,UAAU,CACpB,kCAAsB,CAAC,IAAI,EAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAC7B,OAAO,KAAK,KAAK,QAAQ;oBACvB,CAAC,CAAC,OAAO,KAAK;oBACd,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;wBACZ,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,OAAO,KAAK,CACnB,CAAC;YACJ,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAyBD;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,GAAQ;QACzB,OAAO,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;CACF;AA7GD,sCA6GC"}

package/lib/validation/Validators/DateValidator.d.ts

@@ -1,60 +0,0 @@
-import { Validator } from "./Validator";
-import { DateValidatorOptions } from "../types";
-/**
- * @description Validator for checking if a value is a valid date
- * @summary The DateValidator checks if a value is a valid date object or a string that can be converted to a valid date.
- * It validates that the value represents a real date and not an invalid date like "2023-02-31".
- * @param {string} [message] - Custom error message to display when validation fails, defaults to {@link DEFAULT_ERROR_MESSAGES#DATE}
- * @class DateValidator
- * @extends Validator
- *
- * @category Validators
- * @example
- * ```typescript
- * // Create a date validator with default error message
- * const dateValidator = new DateValidator();
- *
- * // Create a date validator with custom error message
- * const customDateValidator = new DateValidator("Please enter a valid date");
- *
- * // Validate a date
- * const result = dateValidator.hasErrors(new Date()); // undefined (valid)
- * const invalidResult = dateValidator.hasErrors("not a date"); // Returns error message (invalid)
- * ```
- * @mermaid
- * sequenceDiagram
- *   participant C as Client
- *   participant V as DateValidator
- *
- *   C->>V: new DateValidator(message)
- *   C->>V: hasErrors(value, options)
- *   alt value is undefined
- *     V-->>C: undefined (valid)
- *   else value is string
- *     V->>V: Convert to Date
- *   end
- *   alt Date is invalid (NaN)
- *     V-->>C: Error message
- *   else Date is valid
- *     V-->>C: undefined (valid)
- *   end
- */
-export declare class DateValidator extends Validator<DateValidatorOptions> {
-    constructor(message?: string);
-    /**
-     * @description Checks if the provided value is a valid date
-     * @summary Validates that the given value is a valid date. If the value is a string,
-     * it attempts to convert it to a Date object. Returns an error message if the date is invalid,
-     * or undefined if the date is valid or if the value is undefined.
-     *
-     * @param {Date | string} value - The value to validate, can be a Date object or a string
-     * @param {DateValidatorOptions} [options={}] - Optional configuration options for the validator
-     *
-     * @return {string | undefined} Error message if validation fails, undefined if validation passes
-     *
-     * @override
-     *
-     * @see Validator#hasErrors
-     */
-    hasErrors(value: Date | string, options?: DateValidatorOptions): string | undefined;
-}

package/lib/validation/Validators/DateValidator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DateValidator.js","sourceRoot":"","sources":["../../../src/validation/Validators/DateValidator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+CAAwC;AACxC,+CAAqE;AACrE,iDAAyC;AAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,qBAA+B;IAChE,YAAY,UAAkB,kCAAsB,CAAC,IAAI;QACvD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,SAAS,CACd,KAAoB,EACpB,UAAgC,EAAE;QAElC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAEhC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAEvD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAClC,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;YACjC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF,CAAA;AAjCY,sCAAa;wBAAb,aAAa;IADzB,IAAA,sBAAS,EAAC,0BAAc,CAAC,IAAI,CAAC;;GAClB,aAAa,CAiCzB"}

package/lib/validation/Validators/DiffValidator.d.ts

@@ -1,29 +0,0 @@
-import { Validator } from "./Validator";
-import { DiffValidatorOptions } from "../types";
-import type { PathProxy } from "../../utils";
-/**
- * @summary Diff Validator
- *
- * @param {string} [message] defaults to {@link DEFAULT_ERROR_MESSAGES#DiffValidator}
- *
- * @class DiffValidator
- * @extends Validator
- *
- * @category Validators
- */
-export declare class DiffValidator extends Validator<DiffValidatorOptions> {
-    constructor(message?: string);
-    /**
-     * @summary Validates a model
-     *
-     * @param {string} value
-     * @param {DiffValidatorOptions} options
-     * @param {PathProxy<any>} accessor - Proxy-like object used to resolve values from nested structures via path strings.
-     *
-     * @return {string | undefined}
-     *
-     * @override
-     * @see Validator#hasErrors
-     */
-    hasErrors(value: any, options: DiffValidatorOptions, accessor: PathProxy<any>): string | undefined;
-}