@zudojs/validation 0.0.1

package/dist/validationConstraints/validationConstraints.circular.js

@@ -0,0 +1,73 @@
+/**
+ * @zudojs/validation — Circular reference detection.
+ *
+ * Detects circular references in object graphs before serialization
+ * or validation to prevent stack overflows and provide clear error messages.
+ */
+import { CircularReferenceError } from "@zudojs/errors";
+/**
+ * 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 function assertNoCircularReference(value, path = "root", seen) {
+    if (typeof value !== "object" || value === null)
+        return;
+    const tracker = seen ?? new WeakSet();
+    if (tracker.has(value)) {
+        throw new CircularReferenceError(path);
+    }
+    tracker.add(value);
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length; i++) {
+            assertNoCircularReference(value[i], `${path}[${i}]`, tracker);
+        }
+        return;
+    }
+    if (value instanceof Map) {
+        let i = 0;
+        for (const [k, v] of value) {
+            assertNoCircularReference(k, `${path}.key(${i})`, tracker);
+            assertNoCircularReference(v, `${path}[${String(k)}]`, tracker);
+            i++;
+        }
+        return;
+    }
+    if (value instanceof Set) {
+        let i = 0;
+        for (const v of value) {
+            assertNoCircularReference(v, `${path}.item(${i})`, tracker);
+            i++;
+        }
+        return;
+    }
+    if (ArrayBuffer.isView(value))
+        return;
+    const obj = value;
+    for (const key of Object.keys(obj)) {
+        assertNoCircularReference(obj[key], `${path}.${key}`, tracker);
+    }
+}
+/**
+ * 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 function hasCircularReference(value) {
+    try {
+        assertNoCircularReference(value);
+        return false;
+    }
+    catch (error) {
+        if (error instanceof CircularReferenceError)
+            return true;
+        throw error;
+    }
+}
+//# sourceMappingURL=validationConstraints.circular.js.map

package/dist/validationConstraints/validationConstraints.circular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.circular.js","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.circular.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,IAAI,GAAG,MAAM,EACb,IAAsB;IAEtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAExD,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,OAAO,EAAU,CAAC;IAE9C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAe,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;YAC3B,yBAAyB,CAAC,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3D,yBAAyB,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC,EAAE,CAAC;QACN,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,yBAAyB,CAAC,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5D,CAAC,EAAE,CAAC;QACN,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO;IAEtC,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC;QACH,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,sBAAsB;YAAE,OAAO,IAAI,CAAC;QACzD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/validationConstraints/validationConstraints.collection.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires a value to belong to a provided collection.
+ */
+export declare function oneOf<T>(values: readonly T[]): ValidationConstraint<T>;
+/**
+ * Requires a value not to belong to a provided collection.
+ */
+export declare function noneOf<T>(values: readonly T[]): ValidationConstraint<T>;
+//# sourceMappingURL=validationConstraints.collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.collection.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAI5E;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAStE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAMvE"}

package/dist/validationConstraints/validationConstraints.collection.js

@@ -0,0 +1,22 @@
+import { createConstraint, not } from "./validationConstraints.base.js";
+/**
+ * Requires a value to belong to a provided collection.
+ */
+export function oneOf(values) {
+    return createConstraint((value) => values.some((candidate) => Object.is(candidate, value)), {
+        name: "one_of",
+        code: "not_allowed",
+        message: "Value is not an allowed value.",
+    });
+}
+/**
+ * Requires a value not to belong to a provided collection.
+ */
+export function noneOf(values) {
+    return not(oneOf(values), {
+        name: "none_of",
+        code: "disallowed_value",
+        message: "Value is not allowed.",
+    });
+}
+//# sourceMappingURL=validationConstraints.collection.js.map

package/dist/validationConstraints/validationConstraints.collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.collection.js","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.collection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AAExE;;GAEG;AACH,MAAM,UAAU,KAAK,CAAI,MAAoB;IAC3C,OAAO,gBAAgB,CACrB,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAClE;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,gCAAgC;KAC1C,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAI,MAAoB;IAC5C,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QACxB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,uBAAuB;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/validationConstraints/validationConstraints.date.d.ts

@@ -0,0 +1,14 @@
+import type { ValidationConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires a string to be a valid ISO date representation.
+ */
+export declare const isoDate: ValidationConstraint<string>;
+/**
+ * Requires a date to be in the future.
+ */
+export declare const futureDate: ValidationConstraint<Date>;
+/**
+ * Requires a date to be in the past.
+ */
+export declare const pastDate: ValidationConstraint<Date>;
+//# sourceMappingURL=validationConstraints.date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.date.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAI5E;;GAEG;AACH,eAAO,MAAM,OAAO,8BAanB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,4BAOtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,4BAOpB,CAAC"}

package/dist/validationConstraints/validationConstraints.date.js

@@ -0,0 +1,30 @@
+import { createConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires a string to be a valid ISO date representation.
+ */
+export const isoDate = createConstraint((value) => {
+    const date = new Date(value);
+    return (!Number.isNaN(date.getTime()) &&
+        /^\d{4}-\d{2}-\d{2}(?:T.*)?$/u.test(value));
+}, {
+    name: "iso_date",
+    code: "invalid_date",
+    message: "Value must be a valid ISO date.",
+});
+/**
+ * Requires a date to be in the future.
+ */
+export const futureDate = createConstraint((value) => value.getTime() > Date.now(), {
+    name: "future_date",
+    code: "invalid_future_date",
+    message: "Date must be in the future.",
+});
+/**
+ * Requires a date to be in the past.
+ */
+export const pastDate = createConstraint((value) => value.getTime() < Date.now(), {
+    name: "past_date",
+    code: "invalid_past_date",
+    message: "Date must be in the past.",
+});
+//# sourceMappingURL=validationConstraints.date.js.map

package/dist/validationConstraints/validationConstraints.date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.date.js","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.date.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CACrC,CAAC,KAAK,EAAE,EAAE;IACR,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CACL,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3C,CAAC;AACJ,CAAC,EACD;IACE,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,iCAAiC;CAC3C,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CACxC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EACvC;IACE,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,6BAA6B;CACvC,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EACvC;IACE,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,2BAA2B;CACrC,CACF,CAAC"}

package/dist/validationConstraints/validationConstraints.depth.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @zudojs/validation — Depth checking.
+ *
+ * Computes and validates the nesting depth of object graphs
+ * to prevent stack overflows from deeply nested payloads.
+ */
+/**
+ * Compute the maximum nesting depth of a value.
+ *
+ * Primitives return 0. Arrays and objects return 1 + the maximum
+ * depth of their children.
+ */
+export declare function getSerializationDepth(value: unknown, currentDepth?: number): number;
+/**
+ * Assert that a value does not exceed the maximum allowed depth.
+ *
+ * @throws {SerializationDepthError} when depth exceeds the limit.
+ */
+export declare function assertDepthWithinLimit(value: unknown, maxDepth: number): void;
+//# sourceMappingURL=validationConstraints.depth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.depth.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.depth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,YAAY,SAAI,GACf,MAAM,CA2CR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK7E"}

package/dist/validationConstraints/validationConstraints.depth.js

@@ -0,0 +1,70 @@
+/**
+ * @zudojs/validation — Depth checking.
+ *
+ * Computes and validates the nesting depth of object graphs
+ * to prevent stack overflows from deeply nested payloads.
+ */
+import { SerializationDepthError } from "@zudojs/errors";
+/**
+ * Compute the maximum nesting depth of a value.
+ *
+ * Primitives return 0. Arrays and objects return 1 + the maximum
+ * depth of their children.
+ */
+export function getSerializationDepth(value, currentDepth = 0) {
+    if (value === null || value === undefined)
+        return currentDepth;
+    if (typeof value !== "object")
+        return currentDepth;
+    if (ArrayBuffer.isView(value))
+        return currentDepth;
+    if (Array.isArray(value)) {
+        let maxChild = currentDepth;
+        for (const item of value) {
+            const childDepth = getSerializationDepth(item, currentDepth + 1);
+            if (childDepth > maxChild)
+                maxChild = childDepth;
+        }
+        return maxChild;
+    }
+    if (value instanceof Map) {
+        let maxChild = currentDepth;
+        for (const [k, v] of value) {
+            const keyDepth = getSerializationDepth(k, currentDepth + 1);
+            const valDepth = getSerializationDepth(v, currentDepth + 1);
+            const localMax = keyDepth > valDepth ? keyDepth : valDepth;
+            if (localMax > maxChild)
+                maxChild = localMax;
+        }
+        return maxChild;
+    }
+    if (value instanceof Set) {
+        let maxChild = currentDepth;
+        for (const v of value) {
+            const childDepth = getSerializationDepth(v, currentDepth + 1);
+            if (childDepth > maxChild)
+                maxChild = childDepth;
+        }
+        return maxChild;
+    }
+    let maxChild = currentDepth;
+    const obj = value;
+    for (const key of Object.keys(obj)) {
+        const childDepth = getSerializationDepth(obj[key], currentDepth + 1);
+        if (childDepth > maxChild)
+            maxChild = childDepth;
+    }
+    return maxChild;
+}
+/**
+ * Assert that a value does not exceed the maximum allowed depth.
+ *
+ * @throws {SerializationDepthError} when depth exceeds the limit.
+ */
+export function assertDepthWithinLimit(value, maxDepth) {
+    const depth = getSerializationDepth(value);
+    if (depth > maxDepth) {
+        throw new SerializationDepthError(depth, maxDepth);
+    }
+}
+//# sourceMappingURL=validationConstraints.depth.js.map

package/dist/validationConstraints/validationConstraints.depth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.depth.js","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.depth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,YAAY,GAAG,CAAC;IAEhB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAE/D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC;IAEnD,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAEnD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,QAAQ,GAAG,YAAY,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YACjE,IAAI,UAAU,GAAG,QAAQ;gBAAE,QAAQ,GAAG,UAAU,CAAC;QACnD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,IAAI,QAAQ,GAAG,YAAY,CAAC;QAC5B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3D,IAAI,QAAQ,GAAG,QAAQ;gBAAE,QAAQ,GAAG,QAAQ,CAAC;QAC/C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,IAAI,QAAQ,GAAG,YAAY,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YAC9D,IAAI,UAAU,GAAG,QAAQ;gBAAE,QAAQ,GAAG,UAAU,CAAC;QACnD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,GAAG,YAAY,CAAC;IAC5B,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;QACrE,IAAI,UAAU,GAAG,QAAQ;YAAE,QAAQ,GAAG,UAAU,CAAC;IACnD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,QAAgB;IACrE,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/validationConstraints/validationConstraints.number.d.ts

@@ -0,0 +1,38 @@
+import type { ValidationConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires a numeric value to be greater than or equal to a minimum.
+ */
+export declare function min(minimum: number): ValidationConstraint<number>;
+/**
+ * Requires a numeric value to be less than or equal to a maximum.
+ */
+export declare function max(maximum: number): ValidationConstraint<number>;
+/**
+ * Requires a numeric value to fall within a range.
+ */
+export declare function between(minimum: number, maximum: number): ValidationConstraint<number>;
+/**
+ * Requires a finite number.
+ */
+export declare const finiteNumber: ValidationConstraint<number>;
+/**
+ * Requires an integer.
+ */
+export declare const integer: ValidationConstraint<number>;
+/**
+ * Requires a positive number.
+ */
+export declare const positive: ValidationConstraint<number>;
+/**
+ * Requires a non-negative number.
+ */
+export declare const nonNegative: ValidationConstraint<number>;
+/**
+ * Requires a number to be even.
+ */
+export declare const even: ValidationConstraint<number>;
+/**
+ * Requires a number to be odd.
+ */
+export declare const odd: ValidationConstraint<number>;
+//# sourceMappingURL=validationConstraints.number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.number.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAI5E;;GAEG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAUjE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAUjE;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,oBAAoB,CAAC,MAAM,CAAC,CAc9B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,8BAOxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,8BAOnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,8BAInB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,8BAItB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,IAAI,8BAOhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG,8BAOf,CAAC"}

package/dist/validationConstraints/validationConstraints.number.js

@@ -0,0 +1,92 @@
+import { createConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires a numeric value to be greater than or equal to a minimum.
+ */
+export function min(minimum) {
+    if (!Number.isFinite(minimum)) {
+        throw new RangeError("minimum must be a finite number.");
+    }
+    return createConstraint((value) => value >= minimum, {
+        name: `min_${minimum}`,
+        code: "min_value",
+        message: `Value must be greater than or equal to ${minimum}.`,
+    });
+}
+/**
+ * Requires a numeric value to be less than or equal to a maximum.
+ */
+export function max(maximum) {
+    if (!Number.isFinite(maximum)) {
+        throw new RangeError("maximum must be a finite number.");
+    }
+    return createConstraint((value) => value <= maximum, {
+        name: `max_${maximum}`,
+        code: "max_value",
+        message: `Value must be less than or equal to ${maximum}.`,
+    });
+}
+/**
+ * Requires a numeric value to fall within a range.
+ */
+export function between(minimum, maximum) {
+    if (!Number.isFinite(minimum) || !Number.isFinite(maximum)) {
+        throw new RangeError("minimum and maximum must be finite numbers.");
+    }
+    if (minimum > maximum) {
+        throw new RangeError("minimum cannot be greater than maximum.");
+    }
+    return createConstraint((value) => value >= minimum && value <= maximum, {
+        name: `between_${minimum}_${maximum}`,
+        code: "value_out_of_range",
+        message: `Value must be between ${minimum} and ${maximum}.`,
+    });
+}
+/**
+ * Requires a finite number.
+ */
+export const finiteNumber = createConstraint((value) => Number.isFinite(value), {
+    name: "finite_number",
+    code: "invalid_number",
+    message: "Value must be a finite number.",
+});
+/**
+ * Requires an integer.
+ */
+export const integer = createConstraint((value) => Number.isInteger(value), {
+    name: "integer",
+    code: "invalid_integer",
+    message: "Value must be an integer.",
+});
+/**
+ * Requires a positive number.
+ */
+export const positive = createConstraint((value) => value > 0, {
+    name: "positive",
+    code: "invalid_positive",
+    message: "Value must be greater than zero.",
+});
+/**
+ * Requires a non-negative number.
+ */
+export const nonNegative = createConstraint((value) => value >= 0, {
+    name: "non_negative",
+    code: "invalid_non_negative",
+    message: "Value must be zero or greater.",
+});
+/**
+ * Requires a number to be even.
+ */
+export const even = createConstraint((value) => Number.isInteger(value) && value % 2 === 0, {
+    name: "even",
+    code: "invalid_even",
+    message: "Value must be an even integer.",
+});
+/**
+ * Requires a number to be odd.
+ */
+export const odd = createConstraint((value) => Number.isInteger(value) && Math.abs(value % 2) === 1, {
+    name: "odd",
+    code: "invalid_odd",
+    message: "Value must be an odd integer.",
+});
+//# sourceMappingURL=validationConstraints.number.js.map

package/dist/validationConstraints/validationConstraints.number.js.map

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

package/dist/validationConstraints/validationConstraints.size.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @zudojs/validation — Size checking.
+ *
+ * Estimates serialized payload size to prevent memory exhaustion
+ * from excessively large payloads.
+ */
+/**
+ * Estimate the byte size of a value as JSON without allocating a string.
+ *
+ * Uses a recursive walk heuristic — accurate enough for limit checking
+ * without the overhead of actual serialization.
+ */
+export declare function estimateSerializedSize(value: unknown, seen?: WeakSet<object>): number;
+/**
+ * Assert that a value's estimated serialized size is within limits.
+ *
+ * @throws {SerializationPayloadTooLargeError} when the estimate exceeds maxSize.
+ */
+export declare function assertSizeWithinLimit(value: unknown, maxSize: number): void;
+//# sourceMappingURL=validationConstraints.size.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.size.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.size.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GACrB,MAAM,CA4DR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK3E"}

package/dist/validationConstraints/validationConstraints.size.js

@@ -0,0 +1,82 @@
+/**
+ * @zudojs/validation — Size checking.
+ *
+ * Estimates serialized payload size to prevent memory exhaustion
+ * from excessively large payloads.
+ */
+import { SerializationPayloadTooLargeError } from "@zudojs/errors";
+/**
+ * Estimate the byte size of a value as JSON without allocating a string.
+ *
+ * Uses a recursive walk heuristic — accurate enough for limit checking
+ * without the overhead of actual serialization.
+ */
+export function estimateSerializedSize(value, seen) {
+    if (value === null || value === undefined)
+        return 4;
+    switch (typeof value) {
+        case "string":
+            return value.length * 2 + 2;
+        case "number":
+            return 8;
+        case "boolean":
+            return 4;
+        case "bigint":
+            return value.toString().length + 2;
+        case "symbol":
+            return 0;
+        case "function":
+            return 0;
+    }
+    const tracker = seen ?? new WeakSet();
+    if (tracker.has(value))
+        return 0;
+    tracker.add(value);
+    if (ArrayBuffer.isView(value)) {
+        return value.byteLength;
+    }
+    if (Array.isArray(value)) {
+        let total = 2;
+        for (const item of value) {
+            total += estimateSerializedSize(item, tracker) + 1;
+        }
+        return total;
+    }
+    if (value instanceof Date)
+        return 24;
+    if (value instanceof RegExp)
+        return 20;
+    if (value instanceof Map) {
+        let total = 0;
+        for (const [k, v] of value) {
+            total +=
+                estimateSerializedSize(k, tracker) + estimateSerializedSize(v, tracker);
+        }
+        return total;
+    }
+    if (value instanceof Set) {
+        let total = 0;
+        for (const v of value) {
+            total += estimateSerializedSize(v, tracker);
+        }
+        return total;
+    }
+    let total = 2;
+    const obj = value;
+    for (const key of Object.keys(obj)) {
+        total += key.length + 3 + estimateSerializedSize(obj[key], tracker);
+    }
+    return total;
+}
+/**
+ * Assert that a value's estimated serialized size is within limits.
+ *
+ * @throws {SerializationPayloadTooLargeError} when the estimate exceeds maxSize.
+ */
+export function assertSizeWithinLimit(value, maxSize) {
+    const size = estimateSerializedSize(value);
+    if (size > maxSize) {
+        throw new SerializationPayloadTooLargeError(size, maxSize);
+    }
+}
+//# sourceMappingURL=validationConstraints.size.js.map

package/dist/validationConstraints/validationConstraints.size.js.map

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

package/dist/validationConstraints/validationConstraints.string.d.ts

@@ -0,0 +1,50 @@
+import type { ValidationConstraint } from "./validationConstraints.base.js";
+/**
+ * Requires a string to be non-empty after trimming.
+ */
+export declare const nonEmptyString: ValidationConstraint<string>;
+/**
+ * Requires a string to contain at least the specified number of characters.
+ */
+export declare function minLength(minimum: number): ValidationConstraint<string>;
+/**
+ * Requires a string to contain no more than the specified number of characters.
+ */
+export declare function maxLength(maximum: number): ValidationConstraint<string>;
+/**
+ * Requires a string length to fall within a range.
+ */
+export declare function lengthBetween(minimum: number, maximum: number): ValidationConstraint<string>;
+/**
+ * Requires a string to match a regular expression.
+ */
+export declare function matches(pattern: RegExp, message?: string): ValidationConstraint<string>;
+/**
+ * Requires a valid email-like format.
+ */
+export declare const email: ValidationConstraint<string>;
+/**
+ * Requires a UUID-like format.
+ */
+export declare const uuid: ValidationConstraint<string>;
+/**
+ * Requires an HTTP or HTTPS URL.
+ */
+export declare const httpUrl: ValidationConstraint<string>;
+/**
+ * Requires a string to contain only ASCII characters.
+ */
+export declare const ascii: ValidationConstraint<string>;
+/**
+ * Requires a string to contain only digits.
+ */
+export declare const digits: ValidationConstraint<string>;
+/**
+ * Requires a string to contain only letters.
+ */
+export declare const letters: ValidationConstraint<string>;
+/**
+ * Requires a string to contain only letters, numbers, underscores, or hyphens.
+ */
+export declare const slug: ValidationConstraint<string>;
+//# sourceMappingURL=validationConstraints.string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationConstraints.string.d.ts","sourceRoot":"","sources":["../../src/validationConstraints/validationConstraints.string.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAO5E;;GAEG;AACH,eAAO,MAAM,cAAc,8BAO1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAQvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAQvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,oBAAoB,CAAC,MAAM,CAAC,CAgB9B;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,SAAiC,GACvC,oBAAoB,CAAC,MAAM,CAAC,CAM9B;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,8BAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,8BAUhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,8BAcnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,8BAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,8BAOlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,8BAOnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,8BAOhB,CAAC"}