@oxog/vld 2.0.2 → 2.0.3

package/dist/cjs/mini.cjs

@@ -88,6 +88,16 @@ class VldBase {
     nullish() {
         return new VldNullish(this);
     }
+    /**
+     * Make this validator exactly optional - allows undefined but not missing
+     * Unlike .optional() which treats missing as undefined, exactOptional()
+     * requires the key to be present but allows undefined as a value
+     * Zod 4 API parity
+     * @returns A new exact optional validator
+     */
+    exactOptional() {
+        return new VldExactOptional(this);
+    }
     /**
      * Pipe the output of this validator into another validator
      * @param next The next validator to pipe into
@@ -132,6 +142,49 @@ class VldBase {
     apply(fn) {
         return fn(this);
     }
+    check(predicate, message) {
+        return new VldRefine(this, predicate, message);
+    }
+    /**
+     * Get or set metadata for this schema
+     */
+    meta(data) {
+        if (data === undefined) {
+            return undefined;
+        }
+        return new VldMeta(this, data);
+    }
+    /**
+     * Add a description to this schema
+     * Zod 4 API parity - convenience method for .meta({ description: ... })
+     * @param description The description to add
+     * @returns A new validator with the description
+     */
+    describe(description) {
+        return new VldMeta(this, { description });
+    }
+}
+/**
+ * Metadata validator - wraps a schema with metadata
+ */
+class VldMeta extends VldBase {
+    constructor(baseValidator, metadata) {
+        super();
+        this.baseValidator = baseValidator;
+        this.metadata = metadata;
+    }
+    parse(value) {
+        return this.baseValidator.parse(value);
+    }
+    safeParse(value) {
+        return this.baseValidator.safeParse(value);
+    }
+    /**
+     * Get the metadata
+     */
+    getMeta() {
+        return this.metadata;
+    }
 }
 /**
  * Readonly validator - marks output as readonly
@@ -347,6 +400,38 @@ class VldOptional extends VldBase {
         return this.baseValidator;
     }
 }
+/**
+ * Exact optional validator - allows undefined but requires key presence
+ * Unlike Optional which treats missing as undefined, ExactOptional
+ * requires the key to be present (not missing from object) but allows undefined
+ * Zod 4 API parity
+ */
+class VldExactOptional extends VldBase {
+    constructor(baseValidator) {
+        super();
+        this.baseValidator = baseValidator;
+    }
+    static create(baseValidator) {
+        return new VldExactOptional(baseValidator);
+    }
+    parse(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        return this.baseValidator.parse(value);
+    }
+    safeParse(value) {
+        // Unlike regular optional, undefined is explicitly valid
+        // but we still validate through the base validator
+        if (value === undefined) {
+            return { success: true, data: undefined };
+        }
+        return this.baseValidator.safeParse(value);
+    }
+    unwrap() {
+        return this.baseValidator;
+    }
+}
 /**
  * Nullable validator - allows null
  */
@@ -3995,6 +4080,66 @@ class VldNumber extends VldBase {
     lte(value, message) {
         return this.max(value, message);
     }
+    /**
+     * Create a validator for unsigned 32-bit integers
+     * Range: 0 to 4,294,967,295
+     */
+    uint32(message) {
+        return new VldNumber({
+            checks: [...this.config.checks, (v) => Number.isSafeInteger(v) && v >= 0 && v <= 4294967295],
+            errorMessage: message || 'Expected an unsigned 32-bit integer'
+        });
+    }
+    /**
+     * Create a validator for unsigned 64-bit integers
+     * Range: 0 to 2^53-1 (safe integer limit)
+     */
+    uint64(message) {
+        return new VldNumber({
+            checks: [...this.config.checks, (v) => Number.isSafeInteger(v) && v >= 0],
+            errorMessage: message || 'Expected an unsigned 64-bit integer'
+        });
+    }
+    /**
+     * Create a validator for signed 32-bit integers
+     * Range: -2,147,483,648 to 2,147,483,647
+     */
+    int32(message) {
+        return new VldNumber({
+            checks: [...this.config.checks, (v) => Number.isSafeInteger(v) && v >= -2147483648 && v <= 2147483647],
+            errorMessage: message || 'Expected a signed 32-bit integer'
+        });
+    }
+    /**
+     * Create a validator for signed 64-bit integers
+     * Range: -(2^53-1) to 2^53-1 (safe integer limit)
+     */
+    int64(message) {
+        return new VldNumber({
+            checks: [...this.config.checks, (v) => Number.isSafeInteger(v)],
+            errorMessage: message || 'Expected a signed 64-bit integer'
+        });
+    }
+    /**
+     * Create a validator for 32-bit floats (IEEE 754 single precision)
+     * Range: -3.4e38 to 3.4e38, precision ~7 decimal digits
+     */
+    float32(message) {
+        return new VldNumber({
+            checks: [...this.config.checks, (v) => Number.isFinite(v) && Math.abs(v) <= 3.4e38],
+            errorMessage: message || 'Expected a 32-bit float'
+        });
+    }
+    /**
+     * Create a validator for 64-bit floats (IEEE 754 double precision)
+     * Alias for standard number validation
+     */
+    float64(message) {
+        return new VldNumber({
+            checks: [...this.config.checks, (v) => Number.isFinite(v)],
+            errorMessage: message || 'Expected a 64-bit float'
+        });
+    }
 }
 
 /**