@warlock.js/seal 4.0.162 → 4.0.164

package/esm/validators/tuple-validator.js

@@ -0,0 +1,121 @@
+import'@mongez/reinforcements';import {setKeyPath}from'../helpers/path-helpers.js';import'@mongez/supportive-is';import'net';import {arrayRule}from'../rules/common/type-rules.js';import {BaseValidator}from'./base-validator.js';import {applyNullable}from'../standard-schema/json-schema.js';/**
+ * Tuple validator class - validates fixed-length arrays with position-specific types
+ *
+ * @example
+ * ```ts
+ * // RGB color tuple
+ * v.tuple([v.number(), v.number(), v.number()])
+ * // Valid: [255, 128, 0]
+ * // Invalid: [255, 128] (too short)
+ *
+ * // Mixed types
+ * v.tuple([v.string(), v.int(), v.boolean()])
+ * // Valid: ["John", 25, true]
+ * ```
+ */
+class TupleValidator extends BaseValidator {
+    validators;
+    constructor(validators, errorMessage) {
+        super();
+        this.validators = validators;
+        this.addMutableRule(arrayRule, errorMessage);
+    }
+    /**
+     * Check if value is an array type
+     */
+    matchesType(value) {
+        return Array.isArray(value);
+    }
+    /**
+     * Clone the validator
+     */
+    clone() {
+        const cloned = super.clone();
+        cloned.validators = this.validators.map((v) => v.clone());
+        return cloned;
+    }
+    /**
+     * Validate tuple - check length then validate each position
+     */
+    async validate(data, context) {
+        const mutatedData = (await this.mutate(data, context)) || [];
+        const result = await super.validate(data, context);
+        if (result.isValid === false)
+            return result;
+        const errors = [];
+        // Tuple-specific: length validation
+        if (mutatedData.length !== this.validators.length) {
+            errors.push({
+                type: "tuple",
+                input: context.key || "value",
+                error: `Expected exactly ${this.validators.length} items, but got ${mutatedData.length}`,
+            });
+            return { isValid: false, errors, data: mutatedData };
+        }
+        // Validate each position with its specific validator in parallel
+        const validationPromises = this.validators.map(async (validator, index) => {
+            const childContext = {
+                ...context,
+                parent: mutatedData,
+                value: mutatedData[index],
+                key: index.toString(),
+                path: setKeyPath(context.path, index.toString()),
+            };
+            const childResult = await validator.validate(mutatedData[index], childContext);
+            // Update mutated data with validated result
+            mutatedData[index] = childResult.data;
+            // Collect errors from this element
+            if (childResult.isValid === false) {
+                errors.push(...childResult.errors);
+            }
+        });
+        await Promise.all(validationPromises);
+        return {
+            isValid: errors.length === 0,
+            errors,
+            data: await this.startTransformationPipeline(mutatedData, context),
+        };
+    }
+    /**
+     * @inheritdoc
+     *
+     * Tuple keyword diverges between targets:
+     * - `draft-2020-12` → `prefixItems` + `items: false` (exact length enforced)
+     * - `draft-07`      → `items` as array + `additionalItems: false`
+     * - `openapi-3.0`   → same as draft-07 (OpenAPI 3.0 is based on draft-07)
+     *
+     * @example
+     * ```ts
+     * v.tuple([v.string(), v.int(), v.boolean()]).toJsonSchema("draft-2020-12")
+     * // → {
+     * //   type: "array",
+     * //   prefixItems: [{ type: "string" }, { type: "integer" }, { type: "boolean" }],
+     * //   items: false,
+     * //   minItems: 3,
+     * //   maxItems: 3
+     * // }
+     * ```
+     */
+    toJsonSchema(target = "draft-2020-12") {
+        const itemSchemas = this.validators.map(v => v.toJsonSchema(target));
+        const length = this.validators.length;
+        const schema = {
+            type: "array",
+            minItems: length,
+            maxItems: length,
+        };
+        if (target === "draft-2020-12") {
+            // prefixItems is the draft-2020-12 keyword for positional tuple items
+            schema.prefixItems = itemSchemas;
+            schema.items = false; // no additional items beyond the tuple
+        }
+        else {
+            // draft-07 and openapi-3.0: items as array + additionalItems: false
+            schema.items = itemSchemas;
+            schema.additionalItems = false;
+        }
+        if (this.isNullable)
+            applyNullable(schema, target);
+        return schema;
+    }
+}export{TupleValidator};//# sourceMappingURL=tuple-validator.js.map

package/esm/validators/tuple-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple-validator.js","sources":["../../src/validators/tuple-validator.ts"],"sourcesContent":[null],"names":[],"mappings":"iSAOA;;;;;;;;;;;;;;AAcG;AACG,MAAO,cAAe,SAAQ,aAAa,CAAA;AAEtC,IAAA,UAAA,CAAA;IADT,WACS,CAAA,UAA2B,EAClC,YAAqB,EAAA;AAErB,QAAA,KAAK,EAAE,CAAC;QAHD,IAAU,CAAA,UAAA,GAAV,UAAU,CAAiB;AAIlC,QAAA,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;KAC9C;AAED;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;AAC3B,QAAA,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KAC7B;AAED;;AAEG;IACa,KAAK,GAAA;AACnB,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AAC7B,QAAA,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC1D,QAAA,OAAO,MAAM,CAAC;KACf;AAED;;AAEG;AACI,IAAA,MAAM,QAAQ,CAAC,IAAS,EAAE,OAAsB,EAAA;AACrD,QAAA,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAEnD,QAAA,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,OAAO,MAAM,CAAC;QAE5C,MAAM,MAAM,GAA+B,EAAE,CAAC;;QAG9C,IAAI,WAAW,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YACjD,MAAM,CAAC,IAAI,CAAC;AACV,gBAAA,IAAI,EAAE,OAAO;AACb,gBAAA,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO;gBAC7B,KAAK,EAAE,CAAoB,iBAAA,EAAA,IAAI,CAAC,UAAU,CAAC,MAAM,CAAmB,gBAAA,EAAA,WAAW,CAAC,MAAM,CAAE,CAAA;AACzF,aAAA,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACtD,SAAA;;AAGD,QAAA,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,SAAS,EAAE,KAAK,KAAI;AACxE,YAAA,MAAM,YAAY,GAAkB;AAClC,gBAAA,GAAG,OAAO;AACV,gBAAA,MAAM,EAAE,WAAW;AACnB,gBAAA,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;AACzB,gBAAA,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE;gBACrB,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;aACjD,CAAC;AAEF,YAAA,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;;AAG/E,YAAA,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;;AAGtC,YAAA,IAAI,WAAW,CAAC,OAAO,KAAK,KAAK,EAAE;gBACjC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,aAAA;AACH,SAAC,CAAC,CAAC;AAEH,QAAA,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAEtC,OAAO;AACL,YAAA,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,IAAI,EAAE,MAAM,IAAI,CAAC,2BAA2B,CAAC,WAAW,EAAE,OAAO,CAAC;SACnE,CAAC;KACH;AAED;;;;;;;;;;;;;;;;;;;AAmBG;IACa,YAAY,CAAC,SAA2B,eAAe,EAAA;AACrE,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AACrE,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;AAEtC,QAAA,MAAM,MAAM,GAAqB;AAC/B,YAAA,IAAI,EAAE,OAAO;AACb,YAAA,QAAQ,EAAE,MAAM;AAChB,YAAA,QAAQ,EAAE,MAAM;SACjB,CAAC;QAEF,IAAI,MAAM,KAAK,eAAe,EAAE;;AAE9B,YAAA,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;AACjC,YAAA,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;AACtB,SAAA;AAAM,aAAA;;AAEL,YAAA,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;AAC3B,YAAA,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;AAChC,SAAA;QAED,IAAI,IAAI,CAAC,UAAU;AAAE,YAAA,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,QAAA,OAAO,MAAM,CAAC;KACf;AACF"}

package/esm/validators/union-validator.d.ts

@@ -0,0 +1,55 @@
+import { BaseValidator } from "./base-validator";
+import type { JsonSchemaResult, JsonSchemaTarget } from "../standard-schema/json-schema";
+/**
+ * Union validator class - validates value against multiple validator types
+ *
+ * Tries each validator in order until one passes. If a validator's matchesType()
+ * returns false, it's skipped for optimization. First validator that both matches
+ * the type and passes validation wins.
+ *
+ * @example
+ * ```ts
+ * // Accept email or username
+ * const identifier = v.union([
+ *   v.string().email(),
+ *   v.string().alphanumeric().min(3).max(20)
+ * ]);
+ *
+ * // Accept different types
+ * const customValue = v.union([
+ *   v.string().required(),
+ *   v.number().required(),
+ *   v.boolean().required(),
+ *   v.file().required()
+ * ]);
+ * ```
+ */
+export declare class UnionValidator extends BaseValidator {
+    /**
+     * Set the validators to try for union validation
+     *
+     * @param validators - Array of validators to try
+     * @param errorMessage - Optional custom error message if all validators fail
+     * @returns This validator for chaining
+     *
+     * @example
+     * ```ts
+     * new UnionValidator()
+     *   .union([v.string(), v.number()], 'Must be string or number');
+     * ```
+     */
+    union(validators: BaseValidator[], errorMessage?: string): this;
+    /**
+     * @inheritdoc
+     *
+     * Generates `{ oneOf: [...] }` by mapping each sub-validator to its JSON Schema.
+     *
+     * @example
+     * ```ts
+     * v.union([v.string(), v.number()]).toJsonSchema("draft-2020-12")
+     * // → { oneOf: [{ type: "string" }, { type: "number" }] }
+     * ```
+     */
+    toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
+}
+//# sourceMappingURL=union-validator.d.ts.map

package/esm/validators/union-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union-validator.d.ts","sourceRoot":"","sources":["../../src/validators/union-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAI/D;;;;;;;;;;OAUG;IACa,YAAY,CAAC,MAAM,GAAE,gBAAkC,GAAG,gBAAgB;CAQ3F"}

package/esm/validators/union-validator.js

@@ -0,0 +1,60 @@
+import'@mongez/reinforcements';import'@mongez/supportive-is';import {unionRule}from'../rules/core/union.js';import'net';import {BaseValidator}from'./base-validator.js';import {getRuleOptions}from'../standard-schema/json-schema.js';/**
+ * Union validator class - validates value against multiple validator types
+ *
+ * Tries each validator in order until one passes. If a validator's matchesType()
+ * returns false, it's skipped for optimization. First validator that both matches
+ * the type and passes validation wins.
+ *
+ * @example
+ * ```ts
+ * // Accept email or username
+ * const identifier = v.union([
+ *   v.string().email(),
+ *   v.string().alphanumeric().min(3).max(20)
+ * ]);
+ *
+ * // Accept different types
+ * const customValue = v.union([
+ *   v.string().required(),
+ *   v.number().required(),
+ *   v.boolean().required(),
+ *   v.file().required()
+ * ]);
+ * ```
+ */
+class UnionValidator extends BaseValidator {
+    /**
+     * Set the validators to try for union validation
+     *
+     * @param validators - Array of validators to try
+     * @param errorMessage - Optional custom error message if all validators fail
+     * @returns This validator for chaining
+     *
+     * @example
+     * ```ts
+     * new UnionValidator()
+     *   .union([v.string(), v.number()], 'Must be string or number');
+     * ```
+     */
+    union(validators, errorMessage) {
+        return this.addRule(unionRule, errorMessage, { validators });
+    }
+    /**
+     * @inheritdoc
+     *
+     * Generates `{ oneOf: [...] }` by mapping each sub-validator to its JSON Schema.
+     *
+     * @example
+     * ```ts
+     * v.union([v.string(), v.number()]).toJsonSchema("draft-2020-12")
+     * // → { oneOf: [{ type: "string" }, { type: "number" }] }
+     * ```
+     */
+    toJsonSchema(target = "draft-2020-12") {
+        const opts = getRuleOptions(this.rules, "union");
+        const validators = (opts?.validators ?? []);
+        return {
+            oneOf: validators.map(v => v.toJsonSchema(target)),
+        };
+    }
+}export{UnionValidator};//# sourceMappingURL=union-validator.js.map

package/esm/validators/union-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"union-validator.js","sources":["../../src/validators/union-validator.ts"],"sourcesContent":[null],"names":[],"mappings":"uOAKA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,MAAO,cAAe,SAAQ,aAAa,CAAA;AAC/C;;;;;;;;;;;;AAYG;IACI,KAAK,CAAC,UAA2B,EAAE,YAAqB,EAAA;AAC7D,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;KAC9D;AAED;;;;;;;;;;AAUG;IACa,YAAY,CAAC,SAA2B,eAAe,EAAA;QACrE,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,UAAU,IAAI,IAAI,EAAE,UAAU,IAAI,EAAE,CAAoB,CAAC;QAE/D,OAAO;AACL,YAAA,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;SACnD,CAAC;KACH;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@warlock.js/seal",
-    "version": "4.0.162",
+    "version": "4.0.164",
     "description": "Comprehensive Validation library",
     "main": "./cjs/index.js",
     "dependencies": {