bguard 0.6.0 → 0.7.1

package/lib/asserts/bigint/index.d.ts

@@ -2,6 +2,7 @@ import { WithBGuardType } from '../../commonTypes.js';
 import { CommonSchema } from '../../core.js';
 import '../../InferType.js';
 import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
  * @description - Creates a new schema for validating bigint values.
@@ -22,7 +23,7 @@ declare class BigIntSchema extends CommonSchema {
      * @method equalTo
      * @description Restricts the schema to exactly match the specified value and infers the literal value as the TypeScript type.
      * @param expectedValue - The value that the schema must exactly match.
-     * @returns The schema instance restricted to the specified value, with the literal value inferred as the TypeScript type
+     * @returns A new schema restricted to the specified value, with the literal value inferred as the TypeScript type
      * @example
      * bigint().equalTo(42n); // Infers the type 42n
      *
@@ -33,14 +34,18 @@ declare class BigIntSchema extends CommonSchema {
      * @method oneOfValues
      * @description Restricts the schema to match one of the specified values and infers the union of those values as the TypeScript type.
      * @param expectedValues - An array of values that the schema can match.
-     * @returns The schema instance restricted to one of the specified values, with the union of those values inferred as the TypeScript type.
+     * @returns A new schema restricted to one of the specified values, with the union of those values inferred as the TypeScript type.
      * @example
      * bigint().oneOfValues([5n, 7n]); // Infers the type 5n | 7n
      *
      * @public
      */
     oneOfValues<Y extends bigint>(expectedValue: Y[]): WithBGuardType<this, Y>;
-    private limitCheck;
+    /**
+     * Reads the once-only flag without setting it. The flag belongs on the schema that `custom`
+     * returns, not on the one it was derived from.
+     */
+    private limitGuard;
 }
 
-export { bigint };
+export { BigIntSchema, bigint };

package/lib/asserts/bigint/index.js

@@ -1,15 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkZ4XOKGU3js = require('../../chunk-Z4XOKGU3.js');
-require('../../chunk-PAV4SQQL.js');
-require('../../chunk-TLPVFRWR.js');
-require('../../chunk-XDVSL5B6.js');
-require('../../chunk-VN4GLOEN.js');
+
+var _chunkWH7WJMFFjs = require('../../chunk-WH7WJMFF.js');
+require('../../chunk-OPA6AXSH.js');
+require('../../chunk-3D6TPN7F.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-TJQ5NVL4.js');
-require('../../chunk-FIDPCCCW.js');
-require('../../chunk-AXKX5BGH.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
 
 
-exports.bigint = _chunkZ4XOKGU3js.bigint;
+exports.BigIntSchema = _chunkWH7WJMFFjs.BigIntSchema; exports.bigint = _chunkWH7WJMFFjs.bigint;
 //# sourceMappingURL=index.js.map

package/lib/asserts/bigint/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,yCAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACA;AACF,+FAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/index.js"}

package/lib/asserts/bigint/index.mjs

@@ -1,15 +1,17 @@
 import {
+  BigIntSchema,
   bigint
-} from "../../chunk-NFD7D5GZ.mjs";
-import "../../chunk-W3U7RYLP.mjs";
-import "../../chunk-4ZKU4RJL.mjs";
-import "../../chunk-THU5VBSO.mjs";
-import "../../chunk-QIPGUTIG.mjs";
+} from "../../chunk-5PXMSVTE.mjs";
+import "../../chunk-YQP44G45.mjs";
+import "../../chunk-D42AL6CN.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-OE3L7EKN.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-import "../../chunk-2ANPCB4O.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
+  BigIntSchema,
   bigint
 };
 //# sourceMappingURL=index.mjs.map

package/lib/asserts/boolean/index.d.mts

@@ -2,6 +2,7 @@ import { WithBGuardType } from '../../commonTypes.mjs';
 import { CommonSchema } from '../../core.mjs';
 import '../../InferType.mjs';
 import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
 /**
  * @description Creates a new schema for validating boolean values.
@@ -16,10 +17,16 @@ import '../../helpers/constants.mjs';
 declare function boolean(): WithBGuardType<BooleanSchema, boolean>;
 declare class BooleanSchema extends CommonSchema {
     protected _boolean: number;
+    private limit;
+    /**
+     * Reads the once-only flag without setting it, matching the string, number and bigint schemas.
+     * Without it, onlyTrue().onlyFalse() built a schema that rejects both true and false.
+     */
+    private limitGuard;
     /**
      * @method onlyTrue
      * @description Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.
-     * @returns The schema instance restricted to the value true, with the true value inferred as the TypeScript type
+     * @returns A new schema restricted to the value true, with the true value inferred as the TypeScript type
      * @example
      * boolean().onlyTrue(); // Infers the type true
      *
@@ -29,7 +36,7 @@ declare class BooleanSchema extends CommonSchema {
     /**
      * @method onlyFalse
      * @description Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.
-     * @returns The schema instance restricted to the value false, with the false value inferred as the TypeScript type
+     * @returns A new schema restricted to the value false, with the false value inferred as the TypeScript type
      * @example
      * boolean().onlyFalse(); // Infers the type false
      *
@@ -38,4 +45,4 @@ declare class BooleanSchema extends CommonSchema {
     onlyFalse(): WithBGuardType<this, false>;
 }
 
-export { boolean };
+export { BooleanSchema, boolean };

package/lib/asserts/boolean/index.d.ts

@@ -2,6 +2,7 @@ import { WithBGuardType } from '../../commonTypes.js';
 import { CommonSchema } from '../../core.js';
 import '../../InferType.js';
 import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
  * @description Creates a new schema for validating boolean values.
@@ -16,10 +17,16 @@ import '../../helpers/constants.js';
 declare function boolean(): WithBGuardType<BooleanSchema, boolean>;
 declare class BooleanSchema extends CommonSchema {
     protected _boolean: number;
+    private limit;
+    /**
+     * Reads the once-only flag without setting it, matching the string, number and bigint schemas.
+     * Without it, onlyTrue().onlyFalse() built a schema that rejects both true and false.
+     */
+    private limitGuard;
     /**
      * @method onlyTrue
      * @description Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.
-     * @returns The schema instance restricted to the value true, with the true value inferred as the TypeScript type
+     * @returns A new schema restricted to the value true, with the true value inferred as the TypeScript type
      * @example
      * boolean().onlyTrue(); // Infers the type true
      *
@@ -29,7 +36,7 @@ declare class BooleanSchema extends CommonSchema {
     /**
      * @method onlyFalse
      * @description Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.
-     * @returns The schema instance restricted to the value false, with the false value inferred as the TypeScript type
+     * @returns A new schema restricted to the value false, with the false value inferred as the TypeScript type
      * @example
      * boolean().onlyFalse(); // Infers the type false
      *
@@ -38,4 +45,4 @@ declare class BooleanSchema extends CommonSchema {
     onlyFalse(): WithBGuardType<this, false>;
 }
 
-export { boolean };
+export { BooleanSchema, boolean };

package/lib/asserts/boolean/index.js

@@ -1,13 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk2HGS4STDjs = require('../../chunk-2HGS4STD.js');
-require('../../chunk-XDVSL5B6.js');
-require('../../chunk-VN4GLOEN.js');
+
+var _chunk23R5R7PLjs = require('../../chunk-23R5R7PL.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-TJQ5NVL4.js');
-require('../../chunk-FIDPCCCW.js');
-require('../../chunk-AXKX5BGH.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
 
 
-exports.boolean = _chunk2HGS4STDjs.boolean;
+exports.BooleanSchema = _chunk23R5R7PLjs.BooleanSchema; exports.boolean = _chunk23R5R7PLjs.boolean;
 //# sourceMappingURL=index.js.map

package/lib/asserts/boolean/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,2CAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACA;AACF,mGAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/boolean/index.js"}

package/lib/asserts/boolean/index.mjs

@@ -1,13 +1,15 @@
 import {
+  BooleanSchema,
   boolean
-} from "../../chunk-5NYVRFG3.mjs";
-import "../../chunk-THU5VBSO.mjs";
-import "../../chunk-QIPGUTIG.mjs";
+} from "../../chunk-KGXWQ3XP.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-OE3L7EKN.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-import "../../chunk-2ANPCB4O.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
+  BooleanSchema,
   boolean
 };
 //# sourceMappingURL=index.mjs.map

package/lib/asserts/coerce/bigint.d.mts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { BigIntSchema } from '../bigint/index.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a bigint before validating it.
+ *
+ * `BigInt` throws on a value it cannot read, so the original is kept for validation to reject rather
+ * than the error escaping.
+ *
+ * @returns A bigint schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBigInt(), '42'); // 42n
+ */
+declare const coerceBigInt: () => WithInput<WithBGuardType<BigIntSchema, bigint>, unknown>;
+
+export { coerceBigInt };

package/lib/asserts/coerce/bigint.d.ts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { BigIntSchema } from '../bigint/index.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a bigint before validating it.
+ *
+ * `BigInt` throws on a value it cannot read, so the original is kept for validation to reject rather
+ * than the error escaping.
+ *
+ * @returns A bigint schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBigInt(), '42'); // 42n
+ */
+declare const coerceBigInt: () => WithInput<WithBGuardType<BigIntSchema, bigint>, unknown>;
+
+export { coerceBigInt };

package/lib/asserts/coerce/bigint.js

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkWLZZTIOVjs = require('../../chunk-WLZZTIOV.js');
+require('../../chunk-WH7WJMFF.js');
+require('../../chunk-OPA6AXSH.js');
+require('../../chunk-3D6TPN7F.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.coerceBigInt = _chunkWLZZTIOVjs.coerceBigInt;
+//# sourceMappingURL=bigint.js.map

package/lib/asserts/coerce/bigint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/coerce/bigint.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,qDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/coerce/bigint.js"}

package/lib/asserts/coerce/bigint.mjs

@@ -0,0 +1,16 @@
+import {
+  coerceBigInt
+} from "../../chunk-ET2I4EXQ.mjs";
+import "../../chunk-5PXMSVTE.mjs";
+import "../../chunk-YQP44G45.mjs";
+import "../../chunk-D42AL6CN.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  coerceBigInt
+};
+//# sourceMappingURL=bigint.mjs.map

package/lib/asserts/coerce/bigint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/coerce/boolean.d.mts

@@ -0,0 +1,35 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { BooleanSchema } from '../boolean/index.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a boolean before validating it.
+ *
+ * Only the values that unambiguously mean a boolean are converted: the strings `'true'` and `'false'`
+ * in any case, and the numbers `1` and `0`. Everything else is left for validation to reject.
+ *
+ * Deliberately narrower than passing the value through `Boolean`, which would accept every input and
+ * quietly read `'false'` as `true`.
+ *
+ * @returns A boolean schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBoolean(), 'false'); // false
+ */
+declare const coerceBoolean: () => WithInput<WithBGuardType<BooleanSchema, boolean>, unknown>;
+
+export { coerceBoolean };

package/lib/asserts/coerce/boolean.d.ts

@@ -0,0 +1,35 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { BooleanSchema } from '../boolean/index.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a boolean before validating it.
+ *
+ * Only the values that unambiguously mean a boolean are converted: the strings `'true'` and `'false'`
+ * in any case, and the numbers `1` and `0`. Everything else is left for validation to reject.
+ *
+ * Deliberately narrower than passing the value through `Boolean`, which would accept every input and
+ * quietly read `'false'` as `true`.
+ *
+ * @returns A boolean schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceBoolean(), 'false'); // false
+ */
+declare const coerceBoolean: () => WithInput<WithBGuardType<BooleanSchema, boolean>, unknown>;
+
+export { coerceBoolean };

package/lib/asserts/coerce/boolean.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk56TWNROCjs = require('../../chunk-56TWNROC.js');
+require('../../chunk-23R5R7PL.js');
+require('../../chunk-FTHEF6SB.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.coerceBoolean = _chunk56TWNROCjs.coerceBoolean;
+//# sourceMappingURL=boolean.js.map

package/lib/asserts/coerce/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/coerce/boolean.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,uDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/coerce/boolean.js"}

package/lib/asserts/coerce/boolean.mjs

@@ -0,0 +1,14 @@
+import {
+  coerceBoolean
+} from "../../chunk-FA3S35LQ.mjs";
+import "../../chunk-KGXWQ3XP.mjs";
+import "../../chunk-IIL6D2UL.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  coerceBoolean
+};
+//# sourceMappingURL=boolean.mjs.map

package/lib/asserts/coerce/boolean.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/coerce/date.d.mts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { DateSchema } from '../date/index.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a Date before validating it. Anything that is not already
+ * a Date is passed through `new Date`.
+ *
+ * An unreadable value becomes an invalid Date, which `date()` rejects.
+ *
+ * @returns A date schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceDate(), '2024-01-01'); // Date
+ */
+declare const coerceDate: () => WithInput<WithBGuardType<DateSchema, Date>, unknown>;
+
+export { coerceDate };

package/lib/asserts/coerce/date.d.ts

@@ -0,0 +1,32 @@
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { DateSchema } from '../date/index.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * A coercing transform must never throw: it runs before validation, and throwing would replace a clear
+ * validation error with an unexplained failure. Anything it cannot convert is passed through unchanged
+ * so that validation reports the type problem itself.
+ *
+ * `null` is never coerced, so `nullable()` still decides whether it is allowed rather than it becoming
+ * the string `'null'` or the number `0`.
+ *
+ * The return type is inferred rather than written out. Naming it flattened the schema to
+ * `CommonSchema`, which silently dropped the methods only the concrete classes define — `equalTo`,
+ * `oneOfValues`, `onlyTrue`, `onlyFalse`.
+ */
+/**
+ * @description Coerces the received value to a Date before validating it. Anything that is not already
+ * a Date is passed through `new Date`.
+ *
+ * An unreadable value becomes an invalid Date, which `date()` rejects.
+ *
+ * @returns A date schema that accepts `unknown` as its input type.
+ * @example
+ * parseOrFail(coerceDate(), '2024-01-01'); // Date
+ */
+declare const coerceDate: () => WithInput<WithBGuardType<DateSchema, Date>, unknown>;
+
+export { coerceDate };

package/lib/asserts/coerce/date.js

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkK7CDOU6Fjs = require('../../chunk-K7CDOU6F.js');
+require('../../chunk-YPOEO3UF.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.coerceDate = _chunkK7CDOU6Fjs.coerceDate;
+//# sourceMappingURL=date.js.map

package/lib/asserts/coerce/date.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/coerce/date.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,iDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/coerce/date.js"}

package/lib/asserts/coerce/date.mjs

@@ -0,0 +1,13 @@
+import {
+  coerceDate
+} from "../../chunk-MUXY6Q45.mjs";
+import "../../chunk-FU5WAVRB.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  coerceDate
+};
+//# sourceMappingURL=date.mjs.map

package/lib/asserts/coerce/date.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/coerce/index.d.mts

@@ -0,0 +1,41 @@
+import { DateSchema } from '../date/index.mjs';
+import { BigIntSchema } from '../bigint/index.mjs';
+import { BooleanSchema } from '../boolean/index.mjs';
+import { NumberSchema } from '../number/index.mjs';
+import { WithInput, WithBGuardType } from '../../commonTypes.mjs';
+import { StringSchema } from '../string/index.mjs';
+export { coerceBigInt } from './bigint.mjs';
+export { coerceBoolean } from './boolean.mjs';
+export { coerceDate } from './date.mjs';
+export { coerceNumber } from './number.mjs';
+export { coerceString } from './string.mjs';
+import '../../core.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * The coercing schemas gathered under one name, for when reaching for several of them reads better than
+ * five imports.
+ *
+ * Note that this object references all five, so a bundler has to keep all five wherever it is used —
+ * importing it for `coerce.number()` alone still pulls in the string, boolean, bigint and date schemas.
+ * Import the one you need from its own module when that matters:
+ *
+ * ```typescript
+ * import { coerceNumber } from 'bguard/coerce/number';
+ * ```
+ *
+ * @example
+ * const querySchema = object({ page: coerce.number().default(1), q: coerce.string() });
+ * parseOrFail(querySchema, { page: '3', q: 'shoes' }); // { page: 3, q: 'shoes' }
+ */
+declare const coerce: {
+    string: () => WithInput<WithBGuardType<StringSchema, string>, unknown>;
+    number: () => WithInput<WithBGuardType<NumberSchema, number>, unknown>;
+    boolean: () => WithInput<WithBGuardType<BooleanSchema, boolean>, unknown>;
+    bigint: () => WithInput<WithBGuardType<BigIntSchema, bigint>, unknown>;
+    date: () => WithInput<WithBGuardType<DateSchema, Date>, unknown>;
+};
+
+export { coerce };

package/lib/asserts/coerce/index.d.ts

@@ -0,0 +1,41 @@
+import { DateSchema } from '../date/index.js';
+import { BigIntSchema } from '../bigint/index.js';
+import { BooleanSchema } from '../boolean/index.js';
+import { NumberSchema } from '../number/index.js';
+import { WithInput, WithBGuardType } from '../../commonTypes.js';
+import { StringSchema } from '../string/index.js';
+export { coerceBigInt } from './bigint.js';
+export { coerceBoolean } from './boolean.js';
+export { coerceDate } from './date.js';
+export { coerceNumber } from './number.js';
+export { coerceString } from './string.js';
+import '../../core.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * The coercing schemas gathered under one name, for when reaching for several of them reads better than
+ * five imports.
+ *
+ * Note that this object references all five, so a bundler has to keep all five wherever it is used —
+ * importing it for `coerce.number()` alone still pulls in the string, boolean, bigint and date schemas.
+ * Import the one you need from its own module when that matters:
+ *
+ * ```typescript
+ * import { coerceNumber } from 'bguard/coerce/number';
+ * ```
+ *
+ * @example
+ * const querySchema = object({ page: coerce.number().default(1), q: coerce.string() });
+ * parseOrFail(querySchema, { page: '3', q: 'shoes' }); // { page: 3, q: 'shoes' }
+ */
+declare const coerce: {
+    string: () => WithInput<WithBGuardType<StringSchema, string>, unknown>;
+    number: () => WithInput<WithBGuardType<NumberSchema, number>, unknown>;
+    boolean: () => WithInput<WithBGuardType<BooleanSchema, boolean>, unknown>;
+    bigint: () => WithInput<WithBGuardType<BigIntSchema, bigint>, unknown>;
+    date: () => WithInput<WithBGuardType<DateSchema, Date>, unknown>;
+};
+
+export { coerce };