@zudojs/validation 0.0.1

package/dist/validationComposer/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/validation/validationComposer
+ *
+ * Schema composition and merging utilities.
+ */
+export * from "./validationComposer.core.js";
+//# sourceMappingURL=index.js.map

package/dist/validationComposer/index.js.map

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

package/dist/validationComposer/validationComposer.core.d.ts

@@ -0,0 +1,51 @@
+import type { ValidationConstraint } from "../validationConstraints/index.js";
+import type { ValidationResult } from "../validationResult/validationResult.type.js";
+import type { ValidationSchema } from "../validationSchema/validationSchema.core.js";
+/** A validation operation that receives unknown input. */
+export type ValidationStep<T> = (value: T) => ValidationResult<T>;
+/** Options for composing validation operations. */
+export interface ValidationComposerOptions {
+    readonly name?: string;
+    readonly stopOnFirstError?: boolean;
+}
+/** Reusable composed validator. */
+export interface ValidationComposer<T> {
+    readonly name: string;
+    validate(value: T): ValidationResult<T>;
+    assert(value: T): T;
+}
+/** Creates a reusable validator from validation steps. */
+export declare function createValidationComposer<T>(steps: readonly ValidationStep<T>[], options?: ValidationComposerOptions): ValidationComposer<T>;
+/** Composes multiple schemas into a sequential validation pipeline. */
+export declare function composeSchemas<T>(...schemas: readonly ValidationSchema<T>[]): ValidationSchema<T>;
+/** Creates a validation step from a schema. */
+export declare function schemaStep<T>(schema: ValidationSchema<T>): ValidationStep<T>;
+/** Creates a validation step from a constraint. */
+export declare function constraintStep<T>(constraint: ValidationConstraint<T>): ValidationStep<T>;
+/** Creates a validation step from multiple constraints. */
+export declare function constraintsStep<T>(constraints: readonly ValidationConstraint<T>[]): ValidationStep<T>;
+/** Combines validators using logical AND semantics. Every validator must succeed. */
+export declare function all<T>(...validators: readonly ValidationStep<T>[]): ValidationStep<T>;
+/** Combines validators using logical OR semantics. Succeeds when at least one validator succeeds. */
+export declare function any<T>(...validators: readonly ValidationStep<T>[]): ValidationStep<T>;
+/** Runs validators sequentially and returns the first successful result. */
+export declare function first<T>(...validators: readonly ValidationStep<T>[]): ValidationStep<T>;
+/** Negates a validation step. */
+export declare function negate<T>(validator: ValidationStep<T>): ValidationStep<T>;
+/** Makes a validation step optional. Undefined values bypass the validator. */
+export declare function optional<T>(validator: ValidationStep<T>): ValidationStep<T | undefined>;
+/** Makes a validation step nullable. Null values bypass the validator. */
+export declare function nullable<T>(validator: ValidationStep<T>): ValidationStep<T | null>;
+/** Makes a validation step optional and nullable. */
+export declare function optionalNullable<T>(validator: ValidationStep<T>): ValidationStep<T | null | undefined>;
+/** Adds a custom validation step to an existing pipeline. */
+export declare function append<T>(composer: ValidationComposer<T>, step: ValidationStep<T>, options?: ValidationComposerOptions): ValidationComposer<T>;
+/** Creates a pipeline that validates a value and returns the original value. */
+export declare function tap<T>(validator: ValidationStep<T>): ValidationStep<T>;
+/** Creates a validation step that only runs when a predicate matches. */
+export declare function when<T>(predicate: (value: T) => boolean, validator: ValidationStep<T>): ValidationStep<T>;
+/** Creates a validation step that runs only when a predicate does not match. */
+export declare function unless<T>(predicate: (value: T) => boolean, validator: ValidationStep<T>): ValidationStep<T>;
+/** Applies a mapping operation after successful validation. */
+export declare function mapValidated<T, U>(validator: ValidationStep<T>, mapper: (value: T) => U): ValidationStep<T>;
+//# sourceMappingURL=validationComposer.core.d.ts.map

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

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

package/dist/validationComposer/validationComposer.core.js

@@ -0,0 +1,191 @@
+import { failure, success } from "../validationResult/validationResult.type.js";
+import { validate } from "../validationSchema/validationSchema.core.js";
+import { checkConstraints } from "../validationConstraints/index.js";
+import { ConstraintValidationError } from "../validationErrors/validationError.types.js";
+/** Creates a reusable validator from validation steps. */
+export function createValidationComposer(steps, options = {}) {
+    const name = options.name ?? "ValidationComposer";
+    const stopOnFirstError = options.stopOnFirstError ?? false;
+    return Object.freeze({
+        name,
+        validate(value) {
+            let current = value;
+            const issues = [];
+            for (const step of steps) {
+                const result = step(current);
+                if (result.success) {
+                    current = result.data;
+                    continue;
+                }
+                issues.push(...result.issues);
+                if (stopOnFirstError)
+                    break;
+            }
+            return issues.length > 0 ? failure(issues) : success(current);
+        },
+        assert(value) {
+            const result = this.validate(value);
+            if (!result.success)
+                throw new ConstraintValidationError(`${name} validation failed.`, result.issues);
+            return result.data;
+        },
+    });
+}
+/** Composes multiple schemas into a sequential validation pipeline. */
+export function composeSchemas(...schemas) {
+    if (schemas.length === 0)
+        throw new TypeError("At least one schema is required.");
+    const [first, ...rest] = schemas;
+    return rest.reduce((current, schema) => current.pipe(schema), first);
+}
+/** Creates a validation step from a schema. */
+export function schemaStep(schema) {
+    return (value) => validate(schema, value);
+}
+/** Creates a validation step from a constraint. */
+export function constraintStep(constraint) {
+    return (value) => checkConstraints([constraint], value);
+}
+/** Creates a validation step from multiple constraints. */
+export function constraintsStep(constraints) {
+    return (value) => checkConstraints(constraints, value);
+}
+/** Combines validators using logical AND semantics. Every validator must succeed. */
+export function all(...validators) {
+    return (value) => {
+        const issues = [];
+        for (const validator of validators) {
+            const result = validator(value);
+            if (!result.success)
+                issues.push(...result.issues);
+        }
+        return issues.length > 0 ? failure(issues) : success(value);
+    };
+}
+/** Combines validators using logical OR semantics. Succeeds when at least one validator succeeds. */
+export function any(...validators) {
+    return (value) => {
+        const issues = [];
+        for (const validator of validators) {
+            const result = validator(value);
+            if (result.success)
+                return result;
+            issues.push(...result.issues);
+        }
+        return failure(issues.length > 0
+            ? issues
+            : [
+                {
+                    path: [],
+                    code: "no_validator_succeeded",
+                    message: "No validation rule accepted the value.",
+                    received: value,
+                },
+            ]);
+    };
+}
+/** Runs validators sequentially and returns the first successful result. */
+export function first(...validators) {
+    return (value) => {
+        let issues = [];
+        for (const validator of validators) {
+            const result = validator(value);
+            if (result.success)
+                return result;
+            issues = [...issues, ...result.issues];
+        }
+        return failure(issues.length > 0
+            ? issues
+            : [
+                {
+                    path: [],
+                    code: "no_validator_succeeded",
+                    message: "No validation rule accepted the value.",
+                    received: value,
+                },
+            ]);
+    };
+}
+/** Negates a validation step. */
+export function negate(validator) {
+    return (value) => {
+        const result = validator(value);
+        if (result.success)
+            return failure([
+                {
+                    path: [],
+                    code: "negated_validation_failed",
+                    message: "Value must not satisfy the supplied validation rule.",
+                    received: value,
+                },
+            ]);
+        return success(value);
+    };
+}
+/** Makes a validation step optional. Undefined values bypass the validator. */
+export function optional(validator) {
+    return (value) => {
+        if (value === undefined)
+            return success(undefined);
+        return validator(value);
+    };
+}
+/** Makes a validation step nullable. Null values bypass the validator. */
+export function nullable(validator) {
+    return (value) => {
+        if (value === null)
+            return success(null);
+        return validator(value);
+    };
+}
+/** Makes a validation step optional and nullable. */
+export function optionalNullable(validator) {
+    return (value) => {
+        if (value === null || value === undefined)
+            return success(value);
+        return validator(value);
+    };
+}
+/** Adds a custom validation step to an existing pipeline. */
+export function append(composer, step, options = {}) {
+    return createValidationComposer([composer.validate, step], {
+        ...options,
+        name: options.name ?? composer.name,
+    });
+}
+/** Creates a pipeline that validates a value and returns the original value. */
+export function tap(validator) {
+    return (value) => {
+        const result = validator(value);
+        if (!result.success)
+            return result;
+        return success(value);
+    };
+}
+/** Creates a validation step that only runs when a predicate matches. */
+export function when(predicate, validator) {
+    return (value) => {
+        if (!predicate(value))
+            return success(value);
+        return validator(value);
+    };
+}
+/** Creates a validation step that runs only when a predicate does not match. */
+export function unless(predicate, validator) {
+    return (value) => {
+        if (predicate(value))
+            return success(value);
+        return validator(value);
+    };
+}
+/** Applies a mapping operation after successful validation. */
+export function mapValidated(validator, mapper) {
+    return (value) => {
+        const result = validator(value);
+        if (!result.success)
+            return result;
+        mapper(result.data);
+        return success(result.data);
+    };
+}
+//# sourceMappingURL=validationComposer.core.js.map

package/dist/validationComposer/validationComposer.core.js.map

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

package/dist/validationConstraints/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @zudojs/validation/validationConstraints
+ *
+ * Built-in validation constraints and rules.
+ */
+export { createConstraint, checkConstraint, checkConstraints, combineConstraints, not, required, assertNonNegativeInteger, } from "./validationConstraints.base.js";
+export type { ValidationConstraint, ConstraintOptions, } from "./validationConstraints.base.js";
+export { nonEmptyString, minLength, maxLength, lengthBetween, matches, email, uuid, httpUrl, ascii, digits, letters, slug, } from "./validationConstraints.string.js";
+export { min, max, between, finiteNumber, integer, positive, nonNegative, even, odd, } from "./validationConstraints.number.js";
+export { oneOf, noneOf } from "./validationConstraints.collection.js";
+export { isoDate, futureDate, pastDate } from "./validationConstraints.date.js";
+export { minItems, maxItems, exactItems, everyItem, someItem, } from "./validationConstraints.array.js";
+export { assertNoCircularReference, hasCircularReference, } from "./validationConstraints.circular.js";
+export { getSerializationDepth, assertDepthWithinLimit, } from "./validationConstraints.depth.js";
+export { estimateSerializedSize, assertSizeWithinLimit, } from "./validationConstraints.size.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,GAAG,EACH,QAAQ,EACR,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,aAAa,EACb,OAAO,EACP,KAAK,EACL,IAAI,EACJ,OAAO,EACP,KAAK,EACL,MAAM,EACN,OAAO,EACP,IAAI,GACL,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,GAAG,EACH,GAAG,EACH,OAAO,EACP,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,GAAG,GACJ,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAGtE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhF,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC"}

package/dist/validationConstraints/index.js

@@ -0,0 +1,24 @@
+/**
+ * @zudojs/validation/validationConstraints
+ *
+ * Built-in validation constraints and rules.
+ */
+// Base constraints
+export { createConstraint, checkConstraint, checkConstraints, combineConstraints, not, required, assertNonNegativeInteger, } from "./validationConstraints.base.js";
+// String constraints
+export { nonEmptyString, minLength, maxLength, lengthBetween, matches, email, uuid, httpUrl, ascii, digits, letters, slug, } from "./validationConstraints.string.js";
+// Number constraints
+export { min, max, between, finiteNumber, integer, positive, nonNegative, even, odd, } from "./validationConstraints.number.js";
+// Collection constraints
+export { oneOf, noneOf } from "./validationConstraints.collection.js";
+// Date constraints
+export { isoDate, futureDate, pastDate } from "./validationConstraints.date.js";
+// Array constraints
+export { minItems, maxItems, exactItems, everyItem, someItem, } from "./validationConstraints.array.js";
+// Circular reference detection
+export { assertNoCircularReference, hasCircularReference, } from "./validationConstraints.circular.js";
+// Depth checking
+export { getSerializationDepth, assertDepthWithinLimit, } from "./validationConstraints.depth.js";
+// Size estimation
+export { estimateSerializedSize, assertSizeWithinLimit, } from "./validationConstraints.size.js";
+//# sourceMappingURL=index.js.map

package/dist/validationConstraints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validationConstraints/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,GAAG,EACH,QAAQ,EACR,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAOzC,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,aAAa,EACb,OAAO,EACP,KAAK,EACL,IAAI,EACJ,OAAO,EACP,KAAK,EACL,MAAM,EACN,OAAO,EACP,IAAI,GACL,MAAM,mCAAmC,CAAC;AAE3C,qBAAqB;AACrB,OAAO,EACL,GAAG,EACH,GAAG,EACH,OAAO,EACP,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,GAAG,GACJ,MAAM,mCAAmC,CAAC;AAE3C,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAEtE,mBAAmB;AACnB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhF,oBAAoB;AACpB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,kCAAkC,CAAC;AAE1C,+BAA+B;AAC/B,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,qCAAqC,CAAC;AAE7C,iBAAiB;AACjB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kCAAkC,CAAC;AAE1C,kBAAkB;AAClB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC"}

package/dist/validationConstraints/validationConstraints.array.d.ts

@@ -0,0 +1,22 @@
+import type { ValidationConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires an array to contain at least a given number of items.
+ */
+export declare function minItems<T>(minimum: number): ValidationConstraint<readonly T[]>;
+/**
+ * Requires an array to contain no more than a given number of items.
+ */
+export declare function maxItems<T>(maximum: number): ValidationConstraint<readonly T[]>;
+/**
+ * Requires an array to contain a specific number of items.
+ */
+export declare function exactItems<T>(length: number): ValidationConstraint<readonly T[]>;
+/**
+ * Requires every array item to satisfy a constraint.
+ */
+export declare function everyItem<T>(constraint: ValidationConstraint<T>): ValidationConstraint<readonly T[]>;
+/**
+ * Requires at least one array item to satisfy a constraint.
+ */
+export declare function someItem<T>(constraint: ValidationConstraint<T>): ValidationConstraint<readonly T[]>;
+//# sourceMappingURL=validationConstraints.array.d.ts.map

package/dist/validationConstraints/validationConstraints.array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.array.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAO5E;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,MAAM,GACd,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CAQpC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,MAAM,GACd,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CAQpC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CAQpC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAClC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CASpC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAClC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CASpC"}

package/dist/validationConstraints/validationConstraints.array.js

@@ -0,0 +1,55 @@
+import { createConstraint, assertNonNegativeInteger, } from "./validationConstraints.base.js";
+/**
+ * Requires an array to contain at least a given number of items.
+ */
+export function minItems(minimum) {
+    assertNonNegativeInteger(minimum, "minimum");
+    return createConstraint((value) => value.length >= minimum, {
+        name: `min_items_${minimum}`,
+        code: "min_items",
+        message: `Value must contain at least ${minimum} items.`,
+    });
+}
+/**
+ * Requires an array to contain no more than a given number of items.
+ */
+export function maxItems(maximum) {
+    assertNonNegativeInteger(maximum, "maximum");
+    return createConstraint((value) => value.length <= maximum, {
+        name: `max_items_${maximum}`,
+        code: "max_items",
+        message: `Value must contain at most ${maximum} items.`,
+    });
+}
+/**
+ * Requires an array to contain a specific number of items.
+ */
+export function exactItems(length) {
+    assertNonNegativeInteger(length, "length");
+    return createConstraint((value) => value.length === length, {
+        name: `exact_items_${length}`,
+        code: "exact_items",
+        message: `Value must contain exactly ${length} items.`,
+    });
+}
+/**
+ * Requires every array item to satisfy a constraint.
+ */
+export function everyItem(constraint) {
+    return createConstraint((values) => values.every((value) => constraint.validate(value)), {
+        name: `every_${constraint.name}`,
+        code: "item_constraint_failed",
+        message: constraint.message,
+    });
+}
+/**
+ * Requires at least one array item to satisfy a constraint.
+ */
+export function someItem(constraint) {
+    return createConstraint((values) => values.some((value) => constraint.validate(value)), {
+        name: `some_${constraint.name}`,
+        code: "some_item_constraint_failed",
+        message: `At least one item must satisfy ${constraint.name}.`,
+    });
+}
+//# sourceMappingURL=validationConstraints.array.js.map

package/dist/validationConstraints/validationConstraints.array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.array.js","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.array.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAe;IAEf,wBAAwB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE7C,OAAO,gBAAgB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,EAAE;QAC1D,IAAI,EAAE,aAAa,OAAO,EAAE;QAC5B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,+BAA+B,OAAO,SAAS;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAe;IAEf,wBAAwB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE7C,OAAO,gBAAgB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,EAAE;QAC1D,IAAI,EAAE,aAAa,OAAO,EAAE;QAC5B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,8BAA8B,OAAO,SAAS;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAAc;IAEd,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE3C,OAAO,gBAAgB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE;QAC1D,IAAI,EAAE,eAAe,MAAM,EAAE;QAC7B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,8BAA8B,MAAM,SAAS;KACvD,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,UAAmC;IAEnC,OAAO,gBAAgB,CACrB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAC/D;QACE,IAAI,EAAE,SAAS,UAAU,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,UAAmC;IAEnC,OAAO,gBAAgB,CACrB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAC9D;QACE,IAAI,EAAE,QAAQ,UAAU,CAAC,IAAI,EAAE;QAC/B,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,kCAAkC,UAAU,CAAC,IAAI,GAAG;KAC9D,CACF,CAAC;AACJ,CAAC"}

package/dist/validationConstraints/validationConstraints.base.d.ts

@@ -0,0 +1,47 @@
+import { type ValidationResult } from "../validationResult/validationResult.type.js";
+/**
+ * A reusable validation constraint.
+ */
+export interface ValidationConstraint<T> {
+    readonly name: string;
+    readonly validate: (value: T) => boolean;
+    readonly message: string;
+    readonly code: string;
+}
+/**
+ * Options for creating a validation constraint.
+ */
+export interface ConstraintOptions {
+    readonly name?: string;
+    readonly code?: string;
+    readonly message?: string;
+}
+/**
+ * Creates a reusable validation constraint.
+ */
+export declare function createConstraint<T>(validate: (value: T) => boolean, options?: ConstraintOptions): ValidationConstraint<T>;
+/**
+ * Executes a constraint against a value.
+ */
+export declare function checkConstraint<T>(constraint: ValidationConstraint<T>, value: T, path?: readonly (string | number)[]): ValidationResult<T>;
+/**
+ * Executes multiple constraints against a value.
+ */
+export declare function checkConstraints<T>(constraints: readonly ValidationConstraint<T>[], value: T, path?: readonly (string | number)[]): ValidationResult<T>;
+/**
+ * Combines constraints into a single constraint.
+ */
+export declare function combineConstraints<T>(...constraints: readonly ValidationConstraint<T>[]): ValidationConstraint<T>;
+/**
+ * Creates a negated constraint.
+ */
+export declare function not<T>(constraint: ValidationConstraint<T>, options?: ConstraintOptions): ValidationConstraint<T>;
+/**
+ * Requires a value to be defined.
+ */
+export declare const required: ValidationConstraint<unknown>;
+/**
+ * Asserts that a value is a non-negative integer.
+ */
+export declare function assertNonNegativeInteger(value: number, name: string): void;
+//# sourceMappingURL=validationConstraints.base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.base.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.base.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,8CAA8C,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAC/B,OAAO,GAAE,iBAAsB,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,EACR,IAAI,GAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GACtC,gBAAgB,CAAC,CAAC,CAAC,CAarB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,WAAW,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,EAC/C,KAAK,EAAE,CAAC,EACR,IAAI,GAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GACtC,gBAAgB,CAAC,CAAC,CAAC,CAmBrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,GAAG,WAAW,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,GACjD,oBAAoB,CAAC,CAAC,CAAC,CAWzB;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EACnB,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACnC,OAAO,GAAE,iBAAsB,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAMzB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,+BAOpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI1E"}

package/dist/validationConstraints/validationConstraints.base.js

@@ -0,0 +1,88 @@
+import { failure, success, } from "../validationResult/validationResult.type.js";
+/**
+ * Creates a reusable validation constraint.
+ */
+export function createConstraint(validate, options = {}) {
+    const name = options.name ?? "custom";
+    const code = options.code ?? "constraint_failed";
+    const message = options.message ?? "Validation constraint failed.";
+    return Object.freeze({
+        name,
+        validate,
+        message,
+        code,
+    });
+}
+/**
+ * Executes a constraint against a value.
+ */
+export function checkConstraint(constraint, value, path = []) {
+    if (constraint.validate(value)) {
+        return success(value);
+    }
+    const validationIssue = {
+        path: [...path],
+        code: constraint.code,
+        message: constraint.message,
+        received: value,
+    };
+    return failure([validationIssue]);
+}
+/**
+ * Executes multiple constraints against a value.
+ */
+export function checkConstraints(constraints, value, path = []) {
+    const issues = [];
+    for (const constraint of constraints) {
+        if (!constraint.validate(value)) {
+            issues.push({
+                path: [...path],
+                code: constraint.code,
+                message: constraint.message,
+                received: value,
+            });
+        }
+    }
+    if (issues.length > 0) {
+        return failure(issues);
+    }
+    return success(value);
+}
+/**
+ * Combines constraints into a single constraint.
+ */
+export function combineConstraints(...constraints) {
+    return createConstraint((value) => constraints.every((constraint) => constraint.validate(value)), {
+        name: constraints.map((constraint) => constraint.name).join("_and_") ||
+            "combined",
+        code: "combined_constraint_failed",
+        message: "One or more validation constraints failed.",
+    });
+}
+/**
+ * Creates a negated constraint.
+ */
+export function not(constraint, options = {}) {
+    return createConstraint((value) => !constraint.validate(value), {
+        name: options.name ?? `not_${constraint.name}`,
+        code: options.code ?? "negated_constraint_failed",
+        message: options.message ?? `Value must not satisfy ${constraint.name}.`,
+    });
+}
+/**
+ * Requires a value to be defined.
+ */
+export const required = createConstraint((value) => value !== undefined && value !== null, {
+    name: "required",
+    code: "required",
+    message: "Value is required.",
+});
+/**
+ * Asserts that a value is a non-negative integer.
+ */
+export function assertNonNegativeInteger(value, name) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new RangeError(`${name} must be a non-negative integer.`);
+    }
+}
+//# sourceMappingURL=validationConstraints.base.js.map

package/dist/validationConstraints/validationConstraints.base.js.map

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

package/dist/validationConstraints/validationConstraints.circular.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @zudojs/validation — Circular reference detection.
+ *
+ * Detects circular references in object graphs before serialization
+ * or validation to prevent stack overflows and provide clear error messages.
+ */
+/**
+ * Detect circular references in a value graph.
+ *
+ * Uses a WeakSet to track visited objects without preventing GC.
+ * Throws CircularReferenceError on first cycle detected.
+ *
+ * @param value - The value to check for circular references.
+ * @param path - Current traversal path for error reporting.
+ * @param seen - WeakSet tracking visited objects (internal).
+ */
+export declare function assertNoCircularReference(value: unknown, path?: string, seen?: WeakSet<object>): void;
+/**
+ * Check whether a value contains circular references.
+ *
+ * Returns true if a cycle is found, false otherwise.
+ * Does not throw — use assertNoCircularReference for throwing behavior.
+ */
+export declare function hasCircularReference(value: unknown): boolean;
+//# sourceMappingURL=validationConstraints.circular.d.ts.map

package/dist/validationConstraints/validationConstraints.circular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.circular.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.circular.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,IAAI,SAAS,EACb,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GACrB,IAAI,CA2CN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ5D"}