@warlock.js/seal 4.0.48 → 4.0.59

package/cjs/validators/object-validator.d.ts

@@ -0,0 +1,187 @@
+import type { Schema, SchemaContext, ValidationResult } from "../types";
+import { BaseValidator } from "./base-validator";
+/**
+ * Object validator class with generic schema type for proper type inference
+ */
+export declare class ObjectValidator<TSchema extends Schema = Schema> extends BaseValidator {
+    schema: TSchema;
+    protected shouldAllowUnknown: boolean;
+    protected allowedKeys: string[];
+    constructor(schema: TSchema, errorMessage?: string);
+    /**
+     * Check if value is an object type (plain object, not array or date)
+     */
+    matchesType(value: any): boolean;
+    /** Strip unknown keys from the data */
+    stripUnknown(): this;
+    /** Add list of allowed keys that could be in the data but not necessarily validated */
+    allow(...keys: string[]): this;
+    /** Trim values of the object properties */
+    trim(recursive?: boolean): this;
+    /** Whether to allow unknown properties
+     * Please note it will allow only unknown direct children keys, not nested children keys
+     */
+    allowUnknown(allow?: boolean): this;
+    /**
+     * 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?: string[]): this;
+    /**
+     * 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<TExtension extends Schema>(schemaOrValidator: TExtension | ObjectValidator<TExtension>): ObjectValidator<TSchema & TExtension>;
+    /**
+     * 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<TMerge extends Schema>(validator: ObjectValidator<TMerge>): ObjectValidator<TSchema & TMerge>;
+    /**
+     * 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<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Pick<TSchema, K>>;
+    /**
+     * 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<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Omit<TSchema, K>>;
+    /** Mutate the data */
+    mutate(data: any, context: SchemaContext): any;
+    /** Validate the data */
+    validate(data: any, context: SchemaContext): Promise<ValidationResult>;
+    /**
+     * Check if a validator is a computed or managed field
+     * ManagedValidator extends ComputedValidator, so instanceof catches both
+     */
+    private isComputedValidator;
+    /**
+     * Get all computed/managed fields from the schema
+     */
+    private getComputedFields;
+}
+//# sourceMappingURL=object-validator.d.ts.map

package/cjs/validators/object-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-validator.d.ts","sourceRoot":"","sources":["../../src/validators/object-validator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;GAEG;AACH,qBAAa,eAAe,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa;IAKxE,MAAM,EAAE,OAAO;IAJxB,SAAS,CAAC,kBAAkB,UAAS;IACrC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAM;gBAG5B,MAAM,EAAE,OAAO,EACtB,YAAY,CAAC,EAAE,MAAM;IAMvB;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIvC,uCAAuC;IAChC,YAAY;IAWnB,uFAAuF;IAChF,KAAK,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE;IAK9B,2CAA2C;IACpC,IAAI,CAAC,SAAS,UAAO;IAK5B;;OAEG;IACI,YAAY,CAAC,KAAK,UAAO;IAKhC;;;;;;;;;;;;OAYG;IACa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAoB5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACI,MAAM,CAAC,UAAU,SAAS,MAAM,EACrC,iBAAiB,EAAE,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC,GAC1D,eAAe,CAAC,OAAO,GAAG,UAAU,CAAC;IAgBxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACI,KAAK,CAAC,MAAM,SAAS,MAAM,EAChC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,GACjC,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC;IAgCpC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACI,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAiBrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACI,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAiBxF,sBAAsB;IACf,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa;IAK/C,wBAAwB;IACX,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0HnF;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAW1B"}

package/cjs/validators/object-validator.js

@@ -0,0 +1,416 @@
+'use strict';var reinforcements=require('@mongez/reinforcements'),supportiveIs=require('@mongez/supportive-is'),pathHelpers=require('../helpers/path-helpers.js');require('dayjs');var objectMutators=require('../mutators/object-mutators.js');require('net');var typeRules=require('../rules/common/type-rules.js'),unknownKey=require('../rules/common/unknown-key.js'),baseValidator=require('./base-validator.js'),computedValidator=require('./computed-validator.js');/**
+ * Object validator class with generic schema type for proper type inference
+ */
+class ObjectValidator extends baseValidator.BaseValidator {
+    schema;
+    shouldAllowUnknown = false;
+    allowedKeys = [];
+    constructor(schema, errorMessage) {
+        super();
+        this.schema = schema;
+        this.addRule(typeRules.objectRule, errorMessage);
+    }
+    /**
+     * Check if value is an object type (plain object, not array or date)
+     */
+    matchesType(value) {
+        return supportiveIs.isPlainObject(value);
+    }
+    /** Strip unknown keys from the data */
+    stripUnknown() {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const validator = this;
+        this.addMutator(objectMutators.stripUnknownMutator, {
+            get allowedKeys() {
+                return validator.allowedKeys;
+            },
+        });
+        return this;
+    }
+    /** Add list of allowed keys that could be in the data but not necessarily validated */
+    allow(...keys) {
+        this.allowedKeys.push(...keys);
+        return this;
+    }
+    /** Trim values of the object properties */
+    trim(recursive = true) {
+        this.addMutator(objectMutators.objectTrimMutator, { recursive });
+        return this;
+    }
+    /** Whether to allow unknown properties
+     * Please note it will allow only unknown direct children keys, not nested children keys
+     */
+    allowUnknown(allow = true) {
+        this.shouldAllowUnknown = allow;
+        return this;
+    }
+    /**
+     * 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];
+        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;
+    }
+    /**
+     * 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 (!supportiveIs.isPlainObject(data))
+            return data;
+        return super.mutate({ ...data }, context);
+    }
+    /** Validate the data */
+    async validate(data, context) {
+        context.schema = this.schema;
+        const mutatedData = await this.mutate(data, context);
+        // Check for unknown properties
+        if (this.shouldAllowUnknown === false) {
+            const rule = this.addRule(unknownKey.unknownKeyRule);
+            rule.context.options.allowedKeys = this.allowedKeys;
+            rule.context.options.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: pathHelpers.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,
+                ...reinforcements.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.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.ComputedValidator) {
+                computed[key] = validator;
+            }
+        }
+        return computed;
+    }
+}
+/** 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 (!supportiveIs.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;
+}exports.ObjectValidator=ObjectValidator;//# sourceMappingURL=object-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object-validator.js","sources":["../../src/validators/object-validator.ts"],"sourcesContent":[null],"names":["BaseValidator","objectRule","isPlainObject","stripUnknownMutator","objectTrimMutator","unknownKeyRule","setKeyPath","except","ComputedValidator"],"mappings":"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"}

package/cjs/validators/record-validator.d.ts

@@ -0,0 +1,33 @@
+import type { SchemaContext, ValidationResult } from "../types";
+import { BaseValidator } from "./base-validator";
+/**
+ * Record validator class - validates objects with dynamic keys and consistent value types
+ *
+ * @example
+ * ```ts
+ * // Translations object
+ * v.record(v.string())
+ * // Valid: { en: "Hello", ar: "مرحبا", fr: "Bonjour" }
+ *
+ * // User preferences
+ * v.record(v.union([v.string(), v.number(), v.boolean()]))
+ * // Valid: { theme: "dark", fontSize: 16, notifications: true }
+ * ```
+ */
+export declare class RecordValidator extends BaseValidator {
+    valueValidator: BaseValidator;
+    constructor(valueValidator: BaseValidator, errorMessage?: string);
+    /**
+     * Check if value is a plain object type
+     */
+    matchesType(value: any): boolean;
+    /**
+     * Clone the validator
+     */
+    clone(): this;
+    /**
+     * Validate record - iterate all keys and validate each value
+     */
+    validate(data: any, context: SchemaContext): Promise<ValidationResult>;
+}
+//# sourceMappingURL=record-validator.d.ts.map

package/cjs/validators/record-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-validator.d.ts","sourceRoot":"","sources":["../../src/validators/record-validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAEvC,cAAc,EAAE,aAAa;gBAA7B,cAAc,EAAE,aAAa,EACpC,YAAY,CAAC,EAAE,MAAM;IAMvB;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIvC;;OAEG;IACa,KAAK,IAAI,IAAI;IAM7B;;OAEG;IACU,QAAQ,CACnB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,gBAAgB,CAAC;CAyC7B"}