@zudojs/validation 0.0.1

package/dist/validationNormalizer/validationNormalizer.core.js

@@ -0,0 +1,63 @@
+import { failure, success } from "../validationResult/validationResult.type.js";
+import { ConstraintValidationError } from "../validationErrors/validationError.types.js";
+/** Creates a reusable synchronous normalizer. */
+export function createNormalizer(normalizer, options = {}) {
+    const name = options.name ?? "ValidationNormalizer";
+    return Object.freeze({
+        name,
+        normalize(value) {
+            try {
+                return normalizer(value);
+            }
+            catch (error) {
+                throw new ConstraintValidationError(options.errorMessage ?? "Value normalization failed.", [], { cause: error });
+            }
+        },
+        safeNormalize(value) {
+            try {
+                return success(normalizer(value));
+            }
+            catch (error) {
+                return failure([
+                    {
+                        path: [],
+                        code: "normalization_failed",
+                        message: options.errorMessage ?? "Value normalization failed.",
+                        received: error instanceof Error ? error.message : error,
+                    },
+                ]);
+            }
+        },
+    });
+}
+/** Creates a reusable asynchronous normalizer. */
+export function createAsyncNormalizer(normalizer, options = {}) {
+    const name = options.name ?? "AsyncValidationNormalizer";
+    return Object.freeze({
+        name,
+        async normalize(value) {
+            try {
+                return await normalizer(value);
+            }
+            catch (error) {
+                throw new ConstraintValidationError(options.errorMessage ?? "Value normalization failed.", [], { cause: error });
+            }
+        },
+        async safeNormalize(value) {
+            try {
+                return success(await normalizer(value));
+            }
+            catch (error) {
+                return failure([
+                    {
+                        path: [],
+                        code: "normalization_failed",
+                        message: options.errorMessage ?? "Value normalization failed.",
+                        received: error instanceof Error ? error.message : error,
+                    },
+                ]);
+            }
+        },
+    });
+}
+//# sourceMappingURL=validationNormalizer.core.js.map

package/dist/validationNormalizer/validationNormalizer.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationNormalizer.core.js","sourceRoot":"","sources":["../../src/validationNormalizer/validationNormalizer.core.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AA4BzF,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAC9B,UAAyB,EACzB,OAAO,GAAsB,EAAE;IAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,sBAAsB,CAAC;IAEpD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,SAAS,CAAC,KAAQ;YAChB,IAAI,CAAC;gBACH,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,yBAAyB,CACjC,OAAO,CAAC,YAAY,IAAI,6BAA6B,EACrD,EAAE,EACF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,aAAa,CAAC,KAAQ;YACpB,IAAI,CAAC;gBACH,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,OAAO,CAAC;oBACb;wBACE,IAAI,EAAE,EAAE;wBACR,IAAI,EAAE,sBAAsB;wBAC5B,OAAO,EAAE,OAAO,CAAC,YAAY,IAAI,6BAA6B;wBAC9D,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;qBACzD;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,qBAAqB,CACnC,UAA8B,EAC9B,OAAO,GAAsB,EAAE;IAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,2BAA2B,CAAC;IAEzD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,KAAK,CAAC,SAAS,CAAC,KAAQ;YACtB,IAAI,CAAC;gBACH,OAAO,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,yBAAyB,CACjC,OAAO,CAAC,YAAY,IAAI,6BAA6B,EACrD,EAAE,EACF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,KAAQ;YAC1B,IAAI,CAAC;gBACH,OAAO,OAAO,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,OAAO,CAAC;oBACb;wBACE,IAAI,EAAE,EAAE;wBACR,IAAI,EAAE,sBAAsB;wBAC5B,OAAO,EAAE,OAAO,CAAC,YAAY,IAAI,6BAA6B;wBAC9D,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;qBACzD;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/validationNormalizer/validationNormalizer.helpers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * String normalization helpers.
+ */
+/** Trims leading and trailing whitespace. */
+export declare function normalizeTrim(value: string): string;
+/** Converts consecutive whitespace characters into a single space. */
+export declare function normalizeWhitespace(value: string): string;
+/** Converts a string to lowercase. */
+export declare function normalizeLowercase(value: string): string;
+/** Converts a string to uppercase. */
+export declare function normalizeUppercase(value: string): string;
+/** Normalizes Unicode text using NFC normalization. */
+export declare function normalizeUnicode(value: string): string;
+/** Normalizes an email address. */
+export declare function normalizeEmail(value: string): string;
+/** Normalizes a URL by removing surrounding whitespace. */
+export declare function normalizeUrl(value: string): string;
+/** Normalizes an identifier by trimming and lowercasing it. */
+export declare function normalizeIdentifier(value: string): string;
+/** Removes surrounding quotes from a string. */
+export declare function normalizeQuotes(value: string): string;
+/** Removes Unicode byte-order marks from the beginning of text. */
+export declare function removeBom(value: string): string;
+/** Normalizes an array by applying a normalizer to every item. */
+export declare function normalizeArray<T>(values: readonly T[], normalizer: (value: T) => T): T[];
+/** Normalizes an array asynchronously. */
+export declare function normalizeArrayAsync<T>(values: readonly T[], normalizer: (value: T) => T | Promise<T>): Promise<T[]>;
+/** Composes multiple normalizers into one. */
+export declare function composeNormalizers<T>(...normalizers: readonly ((value: T) => T)[]): (value: T) => T;
+/** Creates a normalizer that only changes a value when the predicate returns true. */
+export declare function conditionalNormalizer<T>(predicate: (value: T) => boolean, normalizer: (value: T) => T): (value: T) => T;
+/** Normalizes an optional string. */
+export declare function normalizeOptionalString(value: string | undefined): string | undefined;
+/** Normalizes a nullable string. */
+export declare function normalizeNullableString(value: string | null): string | null;
+/** Normalizes an optional nullable string. */
+export declare function normalizeOptionalNullableString(value: string | null | undefined): string | null | undefined;
+//# sourceMappingURL=validationNormalizer.helpers.d.ts.map

package/dist/validationNormalizer/validationNormalizer.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationNormalizer.helpers.d.ts","sourceRoot":"","sources":["../../src/validationNormalizer/validationNormalizer.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAC1B,CAAC,EAAE,CAEL;AAED,0CAA0C;AAC1C,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,EAAE,CAAC,CAEd;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,GAAG,WAAW,EAAE,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAC3C,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAMjB;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAC1B,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAEjB;AAED,qCAAqC;AACrC,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CAGpB;AAED,oCAAoC;AACpC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG3E;AAED,8CAA8C;AAC9C,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,GAAG,SAAS,CAG3B"}

package/dist/validationNormalizer/validationNormalizer.helpers.js

@@ -0,0 +1,89 @@
+/**
+ * String normalization helpers.
+ */
+/** Trims leading and trailing whitespace. */
+export function normalizeTrim(value) {
+    return value.trim();
+}
+/** Converts consecutive whitespace characters into a single space. */
+export function normalizeWhitespace(value) {
+    return value.trim().replace(/\s+/gu, " ");
+}
+/** Converts a string to lowercase. */
+export function normalizeLowercase(value) {
+    return value.toLowerCase();
+}
+/** Converts a string to uppercase. */
+export function normalizeUppercase(value) {
+    return value.toUpperCase();
+}
+/** Normalizes Unicode text using NFC normalization. */
+export function normalizeUnicode(value) {
+    return value.normalize("NFC");
+}
+/** Normalizes an email address. */
+export function normalizeEmail(value) {
+    return normalizeUnicode(normalizeWhitespace(value)).toLowerCase();
+}
+/** Normalizes a URL by removing surrounding whitespace. */
+export function normalizeUrl(value) {
+    return normalizeWhitespace(normalizeUnicode(value));
+}
+/** Normalizes an identifier by trimming and lowercasing it. */
+export function normalizeIdentifier(value) {
+    return normalizeLowercase(normalizeWhitespace(normalizeUnicode(value)));
+}
+/** Removes surrounding quotes from a string. */
+export function normalizeQuotes(value) {
+    const normalized = value.trim();
+    if (normalized.length >= 2 &&
+        ((normalized.startsWith('"') && normalized.endsWith('"')) ||
+            (normalized.startsWith("'") && normalized.endsWith("'")))) {
+        return normalized.slice(1, -1);
+    }
+    return normalized;
+}
+/** Removes Unicode byte-order marks from the beginning of text. */
+export function removeBom(value) {
+    return value.replace(/^\uFEFF/u, "");
+}
+/** Normalizes an array by applying a normalizer to every item. */
+export function normalizeArray(values, normalizer) {
+    return values.map(normalizer);
+}
+/** Normalizes an array asynchronously. */
+export async function normalizeArrayAsync(values, normalizer) {
+    return Promise.all(values.map(normalizer));
+}
+/** Composes multiple normalizers into one. */
+export function composeNormalizers(...normalizers) {
+    return (value) => {
+        let current = value;
+        for (const normalizer of normalizers)
+            current = normalizer(current);
+        return current;
+    };
+}
+/** Creates a normalizer that only changes a value when the predicate returns true. */
+export function conditionalNormalizer(predicate, normalizer) {
+    return (value) => (predicate(value) ? normalizer(value) : value);
+}
+/** Normalizes an optional string. */
+export function normalizeOptionalString(value) {
+    if (value === undefined)
+        return undefined;
+    return normalizeWhitespace(normalizeUnicode(value));
+}
+/** Normalizes a nullable string. */
+export function normalizeNullableString(value) {
+    if (value === null)
+        return null;
+    return normalizeWhitespace(normalizeUnicode(value));
+}
+/** Normalizes an optional nullable string. */
+export function normalizeOptionalNullableString(value) {
+    if (value === null || value === undefined)
+        return value;
+    return normalizeWhitespace(normalizeUnicode(value));
+}
+//# sourceMappingURL=validationNormalizer.helpers.js.map

package/dist/validationNormalizer/validationNormalizer.helpers.js.map

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

package/dist/validationParser/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/validation/validationParser
+ *
+ * Schema parsing and type inference.
+ */
+export * from "./validationParser.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validationParser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validationParser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,4BAA4B,CAAC"}

package/dist/validationParser/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/validation/validationParser
+ *
+ * Schema parsing and type inference.
+ */
+export * from "./validationParser.core.js";
+//# sourceMappingURL=index.js.map

package/dist/validationParser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validationParser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,4BAA4B,CAAC"}

package/dist/validationParser/validationParser.core.d.ts

@@ -0,0 +1,42 @@
+import type { ValidationSchema } from "../validationSchema/validationSchema.core.js";
+import type { ValidationResult } from "../validationResult/validationResult.type.js";
+import { SchemaValidationError } from "../validationErrors/validationError.types.js";
+/** Options for parser creation. */
+export interface ParserOptions {
+    readonly name?: string;
+}
+/** A synchronous parser created from a validation schema. */
+export interface ValidationParser<T> {
+    readonly name: string;
+    parse(value: unknown): T;
+    safeParse(value: unknown): ValidationResult<T>;
+    isValid(value: unknown): value is T;
+}
+/** An asynchronous parser created from a validation schema. */
+export interface AsyncValidationParser<T> {
+    readonly name: string;
+    parse(value: unknown): Promise<T>;
+    safeParse(value: unknown): Promise<ValidationResult<T>>;
+    isValid(value: unknown): Promise<boolean>;
+}
+/** Creates a reusable synchronous parser from a schema. */
+export declare function createValidationParser<T>(schema: ValidationSchema<T>, options?: ParserOptions): ValidationParser<T>;
+/** Creates a reusable asynchronous parser from a schema. */
+export declare function createAsyncValidationParser<T>(schema: ValidationSchema<T>, options?: ParserOptions): AsyncValidationParser<T>;
+/** Parses a value and returns a fallback when validation fails. */
+export declare function parseOr<T>(schema: ValidationSchema<T>, value: unknown, fallback: T): T;
+/** Parses a value and returns a fallback produced by a function when validation fails. */
+export declare function parseOrElse<T>(schema: ValidationSchema<T>, value: unknown, fallback: (error: SchemaValidationError) => T): T;
+/** Parses multiple values using the same schema. Succeeds only when every value is valid. */
+export declare function parseMany<T>(schema: ValidationSchema<T>, values: readonly unknown[]): ValidationResult<readonly T[]>;
+/** Parses multiple values asynchronously. */
+export declare function parseManyAsync<T>(schema: ValidationSchema<T>, values: readonly unknown[]): Promise<ValidationResult<readonly T[]>>;
+/** Parses a record of values using a schema. */
+export declare function parseRecord<T>(schema: ValidationSchema<T>, values: Readonly<Record<string, unknown>>): ValidationResult<Readonly<Record<string, T>>>;
+/** Parses an optional value. Undefined is accepted and returned as undefined. */
+export declare function parseOptional<T>(schema: ValidationSchema<T>, value: unknown): ValidationResult<T | undefined>;
+/** Parses a nullable value. Null is accepted and returned as null. */
+export declare function parseNullable<T>(schema: ValidationSchema<T>, value: unknown): ValidationResult<T | null>;
+/** Parses an optional nullable value. */
+export declare function parseOptionalNullable<T>(schema: ValidationSchema<T>, value: unknown): ValidationResult<T | null | undefined>;
+//# sourceMappingURL=validationParser.core.d.ts.map

package/dist/validationParser/validationParser.core.d.ts.map

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

package/dist/validationParser/validationParser.core.js

@@ -0,0 +1,118 @@
+import { parse, parseAsync, validate, validateAsync, } from "../validationSchema/validationSchema.core.js";
+import { SchemaValidationError } from "../validationErrors/validationError.types.js";
+/** Creates a reusable synchronous parser from a schema. */
+export function createValidationParser(schema, options = {}) {
+    const name = options.name ?? "ValidationParser";
+    return Object.freeze({
+        name,
+        parse(value) {
+            return parse(schema, value);
+        },
+        safeParse(value) {
+            return validate(schema, value);
+        },
+        isValid(value) {
+            return schema.safeParse(value).success;
+        },
+    });
+}
+/** Creates a reusable asynchronous parser from a schema. */
+export function createAsyncValidationParser(schema, options = {}) {
+    const name = options.name ?? "AsyncValidationParser";
+    return Object.freeze({
+        name,
+        async parse(value) {
+            return parseAsync(schema, value);
+        },
+        async safeParse(value) {
+            return validateAsync(schema, value);
+        },
+        async isValid(value) {
+            return (await schema.safeParseAsync(value)).success;
+        },
+    });
+}
+/** Parses a value and returns a fallback when validation fails. */
+export function parseOr(schema, value, fallback) {
+    const result = validate(schema, value);
+    return result.success ? result.data : fallback;
+}
+/** Parses a value and returns a fallback produced by a function when validation fails. */
+export function parseOrElse(schema, value, fallback) {
+    const result = validate(schema, value);
+    if (result.success)
+        return result.data;
+    return fallback(new SchemaValidationError("Schema validation failed.", result.issues));
+}
+/** Parses multiple values using the same schema. Succeeds only when every value is valid. */
+export function parseMany(schema, values) {
+    const parsed = [];
+    const issues = [];
+    for (let index = 0; index < values.length; index++) {
+        const result = validate(schema, values[index], { pathPrefix: [index] });
+        if (result.success) {
+            parsed.push(result.data);
+        }
+        else {
+            issues.push(...result.issues);
+        }
+    }
+    return issues.length > 0
+        ? { success: false, data: undefined, issues }
+        : { success: true, data: parsed, issues: [] };
+}
+/** Parses multiple values asynchronously. */
+export async function parseManyAsync(schema, values) {
+    const parsed = [];
+    const issues = [];
+    for (let index = 0; index < values.length; index++) {
+        const result = await validateAsync(schema, values[index], {
+            pathPrefix: [index],
+        });
+        if (result.success) {
+            parsed.push(result.data);
+        }
+        else {
+            issues.push(...result.issues);
+        }
+    }
+    return issues.length > 0
+        ? { success: false, data: undefined, issues }
+        : { success: true, data: parsed, issues: [] };
+}
+/** Parses a record of values using a schema. */
+export function parseRecord(schema, values) {
+    const parsed = {};
+    const issues = [];
+    for (const [key, value] of Object.entries(values)) {
+        const result = validate(schema, value, { pathPrefix: [key] });
+        if (result.success) {
+            parsed[key] = result.data;
+        }
+        else {
+            issues.push(...result.issues);
+        }
+    }
+    return issues.length > 0
+        ? { success: false, data: undefined, issues }
+        : { success: true, data: Object.freeze(parsed), issues: [] };
+}
+/** Parses an optional value. Undefined is accepted and returned as undefined. */
+export function parseOptional(schema, value) {
+    if (value === undefined)
+        return { success: true, data: undefined, issues: [] };
+    return validate(schema, value);
+}
+/** Parses a nullable value. Null is accepted and returned as null. */
+export function parseNullable(schema, value) {
+    if (value === null)
+        return { success: true, data: null, issues: [] };
+    return validate(schema, value);
+}
+/** Parses an optional nullable value. */
+export function parseOptionalNullable(schema, value) {
+    if (value === undefined || value === null)
+        return { success: true, data: value, issues: [] };
+    return validate(schema, value);
+}
+//# sourceMappingURL=validationParser.core.js.map

package/dist/validationParser/validationParser.core.js.map

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

package/dist/validationRegistry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/validation/validationRegistry
+ *
+ * Schema registration and lookup.
+ */
+export * from "./validationRegistry.core.js";
+export * from "./validationRegistry.readonly.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validationRegistry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validationRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC"}

package/dist/validationRegistry/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/validation/validationRegistry
+ *
+ * Schema registration and lookup.
+ */
+export * from "./validationRegistry.core.js";
+export * from "./validationRegistry.readonly.js";
+//# sourceMappingURL=index.js.map

package/dist/validationRegistry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validationRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC"}

package/dist/validationRegistry/validationRegistry.core.d.ts

@@ -0,0 +1,45 @@
+import type { ValidationConstraint } from "../validationConstraints/index.js";
+import type { ValidationResult } from "../validationResult/validationResult.type.js";
+import type { ValidationSchema } from "../validationSchema/validationSchema.core.js";
+import { ReadonlyValidationRegistry } from "./validationRegistry.readonly.js";
+/** A named validation rule. */
+export interface ValidationRule<T = unknown> {
+    readonly name: string;
+    readonly description?: string;
+    readonly schema?: ValidationSchema<T>;
+    readonly constraints?: readonly ValidationConstraint<T>[];
+}
+/** Options used when registering a validation rule. */
+export interface ValidationRuleOptions {
+    readonly overwrite?: boolean;
+}
+/** Registry of reusable validation schemas and constraints. */
+export declare class ValidationRegistry {
+    private readonly rules;
+    register<T>(rule: ValidationRule<T>, options?: ValidationRuleOptions): this;
+    registerSchema<T>(name: string, schema: ValidationSchema<T>, options?: {
+        readonly description?: string;
+        readonly overwrite?: boolean;
+    }): this;
+    registerConstraints<T>(name: string, constraints: readonly ValidationConstraint<T>[], options?: {
+        readonly description?: string;
+        readonly overwrite?: boolean;
+    }): this;
+    get<T = unknown>(name: string): ValidationRule<T> | undefined;
+    require<T = unknown>(name: string): ValidationRule<T>;
+    has(name: string): boolean;
+    unregister(name: string): boolean;
+    names(): readonly string[];
+    entries(): readonly ValidationRule[];
+    get size(): number;
+    clear(): void;
+    validate<T>(name: string, value: unknown): ValidationResult<T>;
+    clone(): ValidationRegistry;
+    extend(source: ValidationRegistry, options?: ValidationRuleOptions): this;
+    readonly(): ReadonlyValidationRegistry;
+}
+/** Creates an empty validation registry. */
+export declare function createValidationRegistry(): ValidationRegistry;
+/** Creates a registry from an initial collection of rules. */
+export declare function createRegistryFromRules(rules: readonly ValidationRule[]): ValidationRegistry;
+//# sourceMappingURL=validationRegistry.core.d.ts.map

package/dist/validationRegistry/validationRegistry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationRegistry.core.d.ts","sourceRoot":"","sources":["../../src/validationRegistry/validationRegistry.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAE9E,+BAA+B;AAC/B,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;CAC3D;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAUD,+DAA+D;AAC/D,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAEpD,QAAQ,CAAC,CAAC,EACf,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAWN;IAEM,cAAc,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE;QACP,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;KACzB,GACL,IAAI,CAKN;IAEM,mBAAmB,CAAC,CAAC,EAC1B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,EAC/C,OAAO,GAAE;QACP,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;KACzB,GACL,IAAI,CAKN;IAEM,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAGnE;IAEM,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAI3D;IAEM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhC;IAEM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvC;IAEM,KAAK,IAAI,SAAS,MAAM,EAAE,CAEhC;IAEM,OAAO,IAAI,SAAS,cAAc,EAAE,CAE1C;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,KAAK,IAAI,IAAI,CAEnB;IAEM,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAQpE;IAEM,KAAK,IAAI,kBAAkB,CAIjC;IAEM,MAAM,CACX,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAGN;IAEM,QAAQ,IAAI,0BAA0B,CAE5C;CACF;AAED,4CAA4C;AAC5C,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,kBAAkB,CAIpB"}

package/dist/validationRegistry/validationRegistry.core.js

@@ -0,0 +1,91 @@
+import { checkConstraints } from "../validationConstraints/index.js";
+import { validate } from "../validationSchema/validationSchema.core.js";
+import { ReadonlyValidationRegistry } from "./validationRegistry.readonly.js";
+/** Normalizes registry keys. */
+function normalizeRuleName(name) {
+    const normalized = name.trim();
+    if (normalized.length === 0)
+        throw new TypeError("Validation rule name cannot be empty.");
+    return normalized;
+}
+/** Registry of reusable validation schemas and constraints. */
+export class ValidationRegistry {
+    rules = new Map();
+    register(rule, options = {}) {
+        const name = normalizeRuleName(rule.name);
+        if (!options.overwrite && this.rules.has(name))
+            throw new Error(`Validation rule "${name}" is already registered.`);
+        if (!rule.schema && (!rule.constraints || rule.constraints.length === 0)) {
+            throw new TypeError(`Validation rule "${name}" must define a schema or at least one constraint.`);
+        }
+        this.rules.set(name, Object.freeze({ ...rule, name }));
+        return this;
+    }
+    registerSchema(name, schema, options = {}) {
+        return this.register({ name, description: options.description, schema }, options);
+    }
+    registerConstraints(name, constraints, options = {}) {
+        return this.register({ name, description: options.description, constraints }, options);
+    }
+    get(name) {
+        return this.rules.get(normalizeRuleName(name));
+    }
+    require(name) {
+        const rule = this.get(name);
+        if (!rule)
+            throw new Error(`Validation rule "${name}" is not registered.`);
+        return rule;
+    }
+    has(name) {
+        return this.rules.has(normalizeRuleName(name));
+    }
+    unregister(name) {
+        return this.rules.delete(normalizeRuleName(name));
+    }
+    names() {
+        return Object.freeze([...this.rules.keys()]);
+    }
+    entries() {
+        return Object.freeze([...this.rules.values()]);
+    }
+    get size() {
+        return this.rules.size;
+    }
+    clear() {
+        this.rules.clear();
+    }
+    validate(name, value) {
+        const rule = this.require(name);
+        if (rule.schema)
+            return validate(rule.schema, value);
+        if (rule.constraints && rule.constraints.length > 0)
+            return checkConstraints(rule.constraints, value);
+        throw new TypeError(`Validation rule "${name}" has no validation implementation.`);
+    }
+    clone() {
+        const registry = new ValidationRegistry();
+        for (const rule of this.rules.values())
+            registry.register(rule);
+        return registry;
+    }
+    extend(source, options = {}) {
+        for (const rule of source.entries())
+            this.register(rule, options);
+        return this;
+    }
+    readonly() {
+        return new ReadonlyValidationRegistry(this);
+    }
+}
+/** Creates an empty validation registry. */
+export function createValidationRegistry() {
+    return new ValidationRegistry();
+}
+/** Creates a registry from an initial collection of rules. */
+export function createRegistryFromRules(rules) {
+    const registry = new ValidationRegistry();
+    for (const rule of rules)
+        registry.register(rule);
+    return registry;
+}
+//# sourceMappingURL=validationRegistry.core.js.map

package/dist/validationRegistry/validationRegistry.core.js.map

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

package/dist/validationRegistry/validationRegistry.readonly.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Read-only facade over a validation registry.
+ */
+import type { ValidationResult } from "../validationResult/validationResult.type.js";
+import type { ValidationRule } from "./validationRegistry.core.js";
+import type { ValidationRegistry } from "./validationRegistry.core.js";
+export declare class ReadonlyValidationRegistry {
+    private readonly registry;
+    constructor(registry: ValidationRegistry);
+    get<T = unknown>(name: string): ValidationRule<T> | undefined;
+    require<T = unknown>(name: string): ValidationRule<T>;
+    has(name: string): boolean;
+    names(): readonly string[];
+    entries(): readonly ValidationRule[];
+    get size(): number;
+    validate<T>(name: string, value: unknown): ValidationResult<T>;
+}
+//# sourceMappingURL=validationRegistry.readonly.d.ts.map

package/dist/validationRegistry/validationRegistry.readonly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationRegistry.readonly.d.ts","sourceRoot":"","sources":["../../src/validationRegistry/validationRegistry.readonly.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,kBAAkB,EAAI;IAEtD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAEnE;IAEM,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAE3D;IAEM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhC;IAEM,KAAK,IAAI,SAAS,MAAM,EAAE,CAEhC;IAEM,OAAO,IAAI,SAAS,cAAc,EAAE,CAE1C;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAEpE;CACF"}