@warlock.js/seal 4.0.161 → 4.0.163

package/esm/validators/object-validator.js

@@ -0,0 +1,517 @@
+import {except}from'@mongez/reinforcements';import {isPlainObject}from'@mongez/supportive-is';import {setKeyPath}from'../helpers/path-helpers.js';import'dayjs';import {stripUnknownMutator,objectTrimMutator}from'../mutators/object-mutators.js';import'net';import {objectRule}from'../rules/common/type-rules.js';import {unknownKeyRule}from'../rules/common/unknown-key.js';import {wrapNullableStrict,applyNullable}from'../standard-schema/json-schema.js';import {BaseValidator}from'./base-validator.js';import {ComputedValidator}from'./computed-validator.js';/**
+ * Object validator class with generic schema type for proper type inference
+ */
+class ObjectValidator extends BaseValidator {
+    schema;
+    shouldAllowUnknown = false;
+    allowedKeys = [];
+    hasUnknownKeyRule = false;
+    constructor(schema, errorMessage) {
+        super();
+        this.schema = schema;
+        this.addMutableRule(objectRule, errorMessage);
+    }
+    /**
+     * Check if value is an object type (plain object, not array or date)
+     */
+    matchesType(value) {
+        return isPlainObject(value);
+    }
+    /** Strip unknown keys from the data */
+    stripUnknown() {
+        const validator = this.instance;
+        return validator.addMutator(stripUnknownMutator, {
+            get allowedKeys() {
+                return validator.allowedKeys;
+            },
+        });
+    }
+    /** Add list of allowed keys that could be in the data but not necessarily validated */
+    allow(...keys) {
+        const validator = this.instance;
+        validator.allowedKeys.push(...keys);
+        return validator;
+    }
+    /** Trim values of the object properties */
+    trim(recursive = true) {
+        const validator = this.instance;
+        return validator.addMutator(objectTrimMutator, { recursive });
+    }
+    /** Whether to allow unknown properties
+     * Please note it will allow only unknown direct children keys, not nested children keys
+     */
+    allowUnknown(allow = true) {
+        const validator = this.instance;
+        validator.shouldAllowUnknown = allow;
+        return validator;
+    }
+    /**
+     * Create a copy of this object validator with the same configuration
+     * Copies schema, rules, mutators, transformers, and object-specific settings
+     *
+     * @returns A new ObjectValidator instance with copied configuration
+     *
+     * @example
+     * ```ts
+     * const baseUser = v.object({ name: v.string() }).allowUnknown();
+     * const userCopy = baseUser.clone();
+     * // userCopy has the same schema and allowUnknown setting
+     * ```
+     */
+    clone(keys) {
+        // Get cloned instance with all BaseValidator properties
+        const cloned = super.clone();
+        // Clone schema with deep copy of validators
+        const newSchema = {};
+        for (const key in this.schema) {
+            if (keys && !keys.includes(key))
+                continue;
+            newSchema[key] = this.schema[key].clone();
+        }
+        cloned.schema = newSchema;
+        // Add ObjectValidator-specific properties
+        cloned.shouldAllowUnknown = this.shouldAllowUnknown;
+        cloned.allowedKeys = [...this.allowedKeys];
+        // NOTE: hasUnknownKeyRule is intentionally NOT copied.
+        // Each clone must add its own unknownKeyRule on first validate()
+        // so it holds references to its own schema/allowedKeys, not the original's.
+        return cloned;
+    }
+    /**
+     * Extend this schema with additional fields
+     * Clones the current validator and adds new fields to the schema
+     * **Keeps original configuration** (allowUnknown, stripUnknown, etc.)
+     *
+     * If an ObjectValidator is provided, only its schema is used - its configuration is ignored.
+     * This is useful for creating reusable field collections that can be added to different schemas.
+     *
+     * @param schemaOrValidator - Plain schema object or ObjectValidator to extend with
+     * @returns A new ObjectValidator with merged schema and original configuration
+     *
+     * @example
+     * ```ts
+     * // Extend with plain schema
+     * const baseUser = v.object({
+     *   name: v.string().required(),
+     *   email: v.string().email().required()
+     * }).allowUnknown();
+     *
+     * const adminUser = baseUser.extend({
+     *   role: v.string().in(['admin', 'superadmin']).required()
+     * });
+     * // adminUser has: name, email, role
+     * // adminUser keeps: allowUnknown() from base ✅
+     *
+     * // Extend with ObjectValidator (only schema is used)
+     * const auditFields = v.object({
+     *   createdAt: v.date().required(),
+     *   updatedAt: v.date().required()
+     * }).stripUnknown(); // This config is ignored!
+     *
+     * const fullUser = baseUser.extend(auditFields);
+     * // fullUser has: name, email, createdAt, updatedAt
+     * // fullUser keeps: allowUnknown() from base (NOT stripUnknown from auditFields) ✅
+     *
+     * // Chain multiple extends
+     * const complexSchema = baseUser
+     *   .extend(auditFields)
+     *   .extend({ metadata: v.object({}) });
+     * ```
+     */
+    extend(schemaOrValidator) {
+        // Clone current validator to preserve original
+        const extended = this.clone();
+        // Extract schema from parameter
+        const schemaToAdd = schemaOrValidator instanceof ObjectValidator ? schemaOrValidator.schema : schemaOrValidator;
+        // Merge schemas with cloned validators (later fields override earlier ones)
+        for (const key in schemaToAdd) {
+            extended.schema[key] = schemaToAdd[key].clone();
+        }
+        return extended;
+    }
+    /**
+     * Merge with another ObjectValidator
+     * Clones current validator, merges schemas, and **overrides configuration** with other validator's config
+     *
+     * Unlike extend(), merge() combines both schemas AND configurations.
+     * The other validator's configuration (allowUnknown, stripUnknown, etc.) takes precedence.
+     *
+     * @param validator - Another ObjectValidator to merge with
+     * @returns A new ObjectValidator with merged schema and configuration
+     *
+     * @example
+     * ```ts
+     * const baseUser = v.object({
+     *   name: v.string().required()
+     * }).allowUnknown();
+     *
+     * const timestamps = v.object({
+     *   createdAt: v.date().required(),
+     *   updatedAt: v.date().required()
+     * }).stripUnknown();
+     *
+     * const merged = baseUser.merge(timestamps);
+     * // merged has: name, createdAt, updatedAt
+     * // merged config: stripUnknown() from timestamps (overrides allowUnknown) ✅
+     *
+     * // Chain multiple merges
+     * const full = baseUser.merge(timestamps).merge(softDeleteSchema);
+     * ```
+     */
+    merge(validator) {
+        // Clone current validator
+        const merged = this.clone();
+        // Merge schemas with cloned validators (later fields override earlier ones)
+        for (const key in validator.schema) {
+            merged.schema[key] = validator.schema[key].clone();
+        }
+        // Override configuration with other validator's config
+        merged.shouldAllowUnknown = validator.shouldAllowUnknown;
+        merged.allowedKeys = [...merged.allowedKeys, ...validator.allowedKeys];
+        // Append rules, mutators, transformers from other validator
+        merged.rules.push(...validator.rules);
+        merged.mutators.push(...validator.mutators);
+        merged.dataTransformers.push(...validator.dataTransformers);
+        // Merge attributes text (later wins)
+        merged.attributesText = {
+            ...merged.attributesText,
+            ...validator.attributesText,
+        };
+        merged.translatedAttributes = {
+            ...merged.translatedAttributes,
+            ...validator.translatedAttributes,
+        };
+        return merged;
+    }
+    /**
+     * Create a new schema with only the specified fields
+     * Clones the current validator and keeps only the selected fields
+     * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)
+     *
+     * @param keys - Field names to keep in the schema
+     * @returns A new ObjectValidator with only the picked fields
+     *
+     * @example
+     * ```ts
+     * const fullUser = v.object({
+     *   id: v.int().required(),
+     *   name: v.string().required(),
+     *   email: v.string().email().required(),
+     *   password: v.string().required(),
+     *   role: v.string()
+     * }).allowUnknown();
+     *
+     * // For login - only need email and password
+     * const loginSchema = fullUser.pick('email', 'password');
+     * // loginSchema has: { email, password }
+     * // loginSchema keeps: allowUnknown() ✅
+     *
+     * // For public profile
+     * const publicSchema = fullUser.pick('id', 'name', 'role');
+     * // publicSchema has: { id, name, role }
+     * ```
+     */
+    pick(...keys) {
+        // Clone current validator
+        const picked = this.clone();
+        // Create new schema with only picked keys
+        const newSchema = {};
+        for (const key of keys) {
+            if (key in picked.schema) {
+                newSchema[key] = picked.schema[key];
+            }
+        }
+        picked.schema = newSchema;
+        return picked;
+    }
+    /**
+     * Mark all or the given schema fields as optional
+     */
+    partial(...keys) {
+        const validationSchema = this.clone();
+        if (keys.length === 0) {
+            keys = Object.keys(validationSchema.schema);
+        }
+        for (const key of keys) {
+            validationSchema.schema[key] = validationSchema.schema[key].optional();
+        }
+        return validationSchema;
+    }
+    /**
+     * Make the all or the given fields as required
+     */
+    requiredFields(...keys) {
+        const validationSchema = this.clone();
+        if (keys.length === 0) {
+            keys = Object.keys(validationSchema.schema);
+        }
+        for (const key of keys) {
+            validationSchema.schema[key] = validationSchema.schema[key].required();
+        }
+        return validationSchema;
+    }
+    /**
+     * Create a new schema excluding the specified fields
+     * Clones the current validator and removes the specified fields
+     * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)
+     *
+     * @param keys - Field names to exclude from the schema
+     * @returns A new ObjectValidator without the excluded fields
+     *
+     * @example
+     * ```ts
+     * const fullUser = v.object({
+     *   id: v.int().required(),
+     *   name: v.string().required(),
+     *   email: v.string().email().required(),
+     *   password: v.string().required(),
+     *   role: v.string()
+     * }).allowUnknown();
+     *
+     * // For updates - exclude id
+     * const updateSchema = fullUser.without('id');
+     * // updateSchema has: { name, email, password, role }
+     * // updateSchema keeps: allowUnknown() ✅
+     *
+     * // For public API - exclude sensitive fields
+     * const publicSchema = fullUser.without('password', 'role');
+     * // publicSchema has: { id, name, email }
+     *
+     * // Combine with other methods
+     * const patchSchema = fullUser.without('id', 'password');
+     * // patchSchema has: { name, email, role }
+     * ```
+     */
+    without(...keys) {
+        // Clone current validator
+        const filtered = this.clone();
+        // Create new schema excluding specified keys
+        const newSchema = {};
+        for (const key in filtered.schema) {
+            if (!keys.includes(key)) {
+                newSchema[key] = filtered.schema[key];
+            }
+        }
+        filtered.schema = newSchema;
+        return filtered;
+    }
+    /** Mutate the data */
+    mutate(data, context) {
+        if (!isPlainObject(data))
+            return data;
+        return super.mutate({ ...data }, context);
+    }
+    /** Validate the data */
+    async validate(data, context = { path: "" }) {
+        context.schema = this.schema;
+        const mutatedData = await this.mutate(data, context);
+        // Check for unknown properties
+        if (this.shouldAllowUnknown === false && !this.hasUnknownKeyRule) {
+            this.hasUnknownKeyRule = true;
+            const rule = this.addMutableRule(unknownKeyRule, undefined, {
+                allowedKeys: this.allowedKeys,
+                schema: this.schema,
+            });
+            this.setRuleAttributesList(rule);
+        }
+        const result = await super.validate(mutatedData, context);
+        if (result.isValid === false)
+            return result;
+        if (data === undefined)
+            return result;
+        // ═══════════════════════════════════════════════════════════
+        // PHASE 1: Validate user input fields (skip computed/managed)
+        // ═══════════════════════════════════════════════════════════
+        const errors = [];
+        const validatedData = {};
+        const userInputKeys = Object.keys(this.schema).filter((key) => !this.isComputedValidator(this.schema[key]));
+        const validationPromises = userInputKeys.map(async (key) => {
+            const validator = this.schema[key];
+            const value = mutatedData?.[key] !== undefined ? mutatedData[key] : validator.getDefaultValue();
+            const childContext = {
+                ...context,
+                parent: mutatedData,
+                value,
+                key,
+                path: setKeyPath(context.path, key),
+            };
+            const childResult = await validator.validate(value, childContext);
+            // Only include in validated data if not omitted
+            if (childResult.data !== undefined && !validator.isOmitted()) {
+                validatedData[key] = childResult.data;
+            }
+            if (childResult.isValid === false) {
+                errors.push(...childResult.errors);
+            }
+        });
+        await Promise.all(validationPromises);
+        // If Phase 1 failed, return early
+        if (errors.length > 0) {
+            return {
+                isValid: false,
+                errors,
+                data: undefined,
+            };
+        }
+        // ═══════════════════════════════════════════════════════════
+        // PHASE 2: Execute computed/managed fields with validated data
+        // ═══════════════════════════════════════════════════════════
+        const computedFields = this.getComputedFields();
+        const computedPromises = Object.keys(computedFields).map(async (key) => {
+            const validator = computedFields[key];
+            const childContext = {
+                ...context,
+                parent: validatedData,
+                value: undefined, // Computed fields don't have input value
+            };
+            // Execute computed callback with validated data
+            const childResult = await validator.validate(validatedData, childContext);
+            // Only include in final data if not omitted
+            if (childResult.data !== undefined && !validator.isOmitted()) {
+                validatedData[key] = childResult.data;
+            }
+            if (childResult.isValid === false) {
+                errors.push(...childResult.errors);
+            }
+        });
+        await Promise.all(computedPromises);
+        // If Phase 2 failed, return early
+        if (errors.length > 0) {
+            return {
+                isValid: false,
+                errors,
+                data: undefined,
+            };
+        }
+        // Remove undefined values
+        const cleanedData = removeUndefinedValues(validatedData);
+        const transformedData = await this.startTransformationPipeline(cleanedData, context);
+        const output = this.shouldAllowUnknown === false
+            ? transformedData
+            : {
+                ...transformedData,
+                ...except(mutatedData, Object.keys(this.schema)),
+            };
+        return {
+            isValid: true,
+            errors: [],
+            data: output,
+        };
+    }
+    /**
+     * Check if a validator is a computed or managed field
+     * ManagedValidator extends ComputedValidator, so instanceof catches both
+     */
+    isComputedValidator(validator) {
+        return validator instanceof ComputedValidator;
+    }
+    /**
+     * Get all computed/managed fields from the schema
+     */
+    getComputedFields() {
+        const computed = {};
+        for (const [key, validator] of Object.entries(this.schema)) {
+            if (validator instanceof ComputedValidator) {
+                computed[key] = validator;
+            }
+        }
+        return computed;
+    }
+    /**
+     * @inheritdoc
+     *
+     * Recursively generates JSON Schema for all input fields in the schema.
+     * Computed/managed fields are skipped — they have no input representation.
+     *
+     * **Standard targets** (`draft-2020-12`, `draft-07`, `openapi-3.0`):
+     * - Fields marked `.optional()` are excluded from `required`.
+     *
+     * **`openai-strict` target** (OpenAI Structured Outputs):
+     * - ALL fields appear in `required` — OpenAI rejects schemas with optional fields.
+     * - Optional fields are instead expressed as nullable types:
+     *   `{ type: ["string", "null"] }` so the model can output `null` for them.
+     * - Recursively applies `openai-strict` to all nested objects.
+     *
+     * @example
+     * ```ts
+     * v.object({
+     *   name: v.string().required(),
+     *   age: v.int().optional(),
+     * }).toJsonSchema("draft-2020-12")
+     * // → { type: "object",
+     * //     properties: { name: { type: "string" }, age: { type: "integer" } },
+     * //     required: ["name"], additionalProperties: false }
+     *
+     * v.object({
+     *   name: v.string().required(),
+     *   age: v.int().optional(),
+     * }).toJsonSchema("openai-strict")
+     * // → { type: "object",
+     * //     properties: { name: { type: "string" }, age: { type: ["integer", "null"] } },
+     * //     required: ["name", "age"],   ← all fields
+     * //     additionalProperties: false }
+     * ```
+     */
+    toJsonSchema(target = "draft-2020-12") {
+        const properties = {};
+        const required = [];
+        const isOpenAIStrict = target === "openai-strict";
+        for (const [key, validator] of Object.entries(this.schema)) {
+            // Skip computed/managed — runtime-only, no input schema
+            if (validator instanceof ComputedValidator)
+                continue;
+            let fieldSchema = validator.toJsonSchema(target);
+            if (isOpenAIStrict) {
+                // OpenAI strict: every field must be in required.
+                // Optional fields are expressed as nullable rather than absent.
+                if (validator.isOptional) {
+                    fieldSchema = wrapNullableStrict(fieldSchema);
+                }
+                required.push(key);
+            }
+            else {
+                // Standard JSON Schema: only non-optional fields go in required
+                if (!validator.isOptional) {
+                    required.push(key);
+                }
+            }
+            properties[key] = fieldSchema;
+        }
+        const schema = { type: "object", properties };
+        if (required.length > 0)
+            schema.required = required;
+        if (!this.shouldAllowUnknown)
+            schema.additionalProperties = false;
+        if (this.isNullable)
+            applyNullable(schema, target);
+        return schema;
+    }
+}
+/** Recursively remove undefined values from an object */
+function removeUndefinedValues(obj, visited = new WeakMap()) {
+    // Handle primitives and null
+    if (obj === null) {
+        return obj;
+    }
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        return obj.map((item) => removeUndefinedValues(item, visited));
+    }
+    // Skip non-plain objects (class instances, Dates, Buffers, etc.)
+    if (!isPlainObject(obj)) {
+        return obj;
+    }
+    // Handle circular references - return already processed result
+    if (visited.has(obj)) {
+        return visited.get(obj);
+    }
+    // Process plain objects
+    const result = {};
+    visited.set(obj, result); // Mark as processing BEFORE recursion
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            result[key] = removeUndefinedValues(value, visited);
+        }
+    }
+    return result;
+}export{ObjectValidator};//# sourceMappingURL=object-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object-validator.js","sources":["../../src/validators/object-validator.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -0,0 +1,70 @@
+import { BaseValidator } from "./base-validator";
+/**
+ * Abstract base validator for primitive-typed fields (string, number, boolean).
+ *
+ * Provides value-membership rules that are meaningful for any single primitive value
+ * but not for complex structures (object, array).
+ *
+ * Do NOT expose this on the `v` factory — it is an inheritance-only base class.
+ *
+ * Hierarchy:
+ *   BaseValidator
+ *     └── PrimitiveValidator    ← enum, in, oneOf, allowsOnly, forbids, notIn
+ *           ├── StringValidator
+ *           ├── NumberValidator
+ *           │     └── FloatValidator
+ *           ├── BooleanValidator
+ *           └── ScalarValidator  (extends PrimitiveValidator, adds asNumber/asString/accepted/declined)
+ *
+ * @example
+ * class MyValidator extends PrimitiveValidator {
+ *   // inherits: in(), forbids(), enum(), oneOf(), allowsOnly(), notIn()
+ * }
+ */
+export declare abstract class PrimitiveValidator extends BaseValidator {
+    /**
+     * Value must be one of the enum's values
+     *
+     * @example
+     * v.string().enum(Direction) // Direction is a TS enum
+     */
+    enum(values: any, errorMessage?: string): this;
+    /**
+     * Value must be one of the given values
+     *
+     * @example
+     * v.string().in(["admin", "user", "guest"])
+     * v.number().in([1, 2, 3])
+     */
+    in(values: any[], errorMessage?: string): this;
+    /**
+     * Alias for `in()`
+     *
+     * @example
+     * v.string().oneOf(["active", "inactive"])
+     */
+    oneOf(values: any[], errorMessage?: string): this;
+    /**
+     * Value must be one of the allowed values (stricter variant)
+     *
+     * @example
+     * v.string().allowsOnly(["yes", "no"])
+     */
+    allowsOnly(values: any[], errorMessage?: string): this;
+    /**
+     * Value must NOT be one of the given values
+     *
+     * @example
+     * v.string().forbids(["banned", "blacklisted"])
+     * v.number().forbids([0, -1])
+     */
+    forbids(values: any[], errorMessage?: string): this;
+    /**
+     * Alias for `forbids()`
+     *
+     * @example
+     * v.string().notIn(["OK", "NOT OK"])
+     */
+    notIn(values: any[], errorMessage?: string): this;
+}
+//# sourceMappingURL=primitive-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-validator.d.ts","sourceRoot":"","sources":["../../src/validators/primitive-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,kBAAmB,SAAQ,aAAa;IAC5D;;;;;OAKG;IACI,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM;IAI9C;;;;;;OAMG;IACI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAI9C;;;;;OAKG;IACI,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAIjD;;;;;OAKG;IACI,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAItD;;;;;;OAMG;IACI,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAInD;;;;;OAKG;IACI,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;CAGlD"}