bguard 0.5.0 → 0.7.0

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

@@ -1,9 +1,33 @@
 import { WithObject } from '../../commonTypes.mjs';
-import { O as ObjectShapeSchemaType } from '../../CommonSchema-BIfYCtcQ.mjs';
-import { ObjectSchema } from '../../schemas/ObjectSchema.mjs';
-import '../../ExceptionContext.mjs';
+import { CommonSchema, ValidatorContext, ObjectShapeSchemaType } from '../../core.mjs';
 import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
+declare class ObjectSchema extends CommonSchema {
+    protected _object: number;
+    constructor(ctx: ValidatorContext, shapeSchema: ObjectShapeSchemaType);
+    private validateObjectEntry;
+    /**
+     * @method allowUnrecognized
+     * @description Allows unrecognized properties in the validated object.
+     * When this method is called, the validation will not fail
+     * if the received object contains properties not specified
+     * in the validation schema.
+     * @returns {this} The current ObjectSchema instance.
+     * @example
+     *  const userSchema = object({
+     *    name: string(),
+     *    age: number(),
+     *  }).allowUnrecognized();
+     *
+     * parseOrFail(userSchema, ({ name: 'John', age: 30, extra: 'value' }););
+     * //  No error thrown
+     *
+     * @public
+     */
+    allowUnrecognized(): this;
+}
 /**
  * @description Creates a new schema for validating objects where each property must match the specified schema.
  * @template T
@@ -21,4 +45,4 @@ import '../../InferType.mjs';
  */
 declare function object<T extends ObjectShapeSchemaType>(shapeSchema: T): WithObject<ObjectSchema, T>;
 
-export { object };
+export { ObjectSchema, object };

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

@@ -1,9 +1,33 @@
 import { WithObject } from '../../commonTypes.js';
-import { O as ObjectShapeSchemaType } from '../../CommonSchema-DIDMH9R7.js';
-import { ObjectSchema } from '../../schemas/ObjectSchema.js';
-import '../../ExceptionContext.js';
+import { CommonSchema, ValidatorContext, ObjectShapeSchemaType } from '../../core.js';
 import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
+declare class ObjectSchema extends CommonSchema {
+    protected _object: number;
+    constructor(ctx: ValidatorContext, shapeSchema: ObjectShapeSchemaType);
+    private validateObjectEntry;
+    /**
+     * @method allowUnrecognized
+     * @description Allows unrecognized properties in the validated object.
+     * When this method is called, the validation will not fail
+     * if the received object contains properties not specified
+     * in the validation schema.
+     * @returns {this} The current ObjectSchema instance.
+     * @example
+     *  const userSchema = object({
+     *    name: string(),
+     *    age: number(),
+     *  }).allowUnrecognized();
+     *
+     * parseOrFail(userSchema, ({ name: 'John', age: 30, extra: 'value' }););
+     * //  No error thrown
+     *
+     * @public
+     */
+    allowUnrecognized(): this;
+}
 /**
  * @description Creates a new schema for validating objects where each property must match the specified schema.
  * @template T
@@ -21,4 +45,4 @@ import '../../InferType.js';
  */
 declare function object<T extends ObjectShapeSchemaType>(shapeSchema: T): WithObject<ObjectSchema, T>;
 
-export { object };
+export { ObjectSchema, object };

package/lib/asserts/object/index.js

@@ -1,18 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkBURPSYZ3js = require('../../chunk-BURPSYZ3.js');
-require('../../chunk-MMWS3SXR.js');
-require('../../chunk-PQ4GCO3Q.js');
-require('../../chunk-EXVTHIT5.js');
-require('../../chunk-PE55R4KH.js');
+
+var _chunkJLEQOYDWjs = require('../../chunk-JLEQOYDW.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-FIDPCCCW.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
 
-// src/asserts/object/index.ts
-function object(shapeSchema) {
-  return new (0, _chunkBURPSYZ3js.ObjectSchema)({ type: [], requiredValidations: [] }, shapeSchema);
-}
 
 
-exports.object = object;
+exports.ObjectSchema = _chunkJLEQOYDWjs.ObjectSchema; exports.object = _chunkJLEQOYDWjs.object;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/object/index.js","../../../src/asserts/object/index.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACA;ACSO,SAAS,MAAA,CAAwC,WAAA,EAA6C;AACnG,EAAA,OAAO,IAAI,kCAAA,CAAa,EAAE,IAAA,EAAM,CAAC,CAAA,EAAG,mBAAA,EAAqB,CAAC,EAAE,CAAA,EAAG,WAAW,CAAA;AAC5E;ADPA;AACE;AACF,wBAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/object/index.js","sourcesContent":[null,"import { WithObject } from '../../commonTypes';\nimport { ObjectShapeSchemaType } from '../../schemas/CommonSchema';\nimport { ObjectSchema } from '../../schemas/ObjectSchema';\n\n/**\n * @description Creates a new schema for validating objects where each property must match the specified schema.\n * @template T\n * @param {T} shapeSchema - The schema that each property of the object must match.\n * @returns {WithObject<ObjectSchema, T>} A new instance of `ObjectSchema` for validating objects with properties matching the specified schema.\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number()\n * });\n * parseOrFail(schema, { name: 'John', age: 30 }); // Validates successfully\n * parseOrFail(schema, { name: 'John', age: '30' }); // Throws a validation error\n *\n * @instance Of ObjectSchema\n */\nexport function object<T extends ObjectShapeSchemaType>(shapeSchema: T): WithObject<ObjectSchema, T> {\n  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema) as WithObject<ObjectSchema, T>;\n}\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/object/index.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACA;AACF,+FAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/object/index.js"}

package/lib/asserts/object/index.mjs

@@ -1,18 +1,14 @@
 import {
-  ObjectSchema
-} from "../../chunk-CCNK27CX.mjs";
-import "../../chunk-UEYMBPZN.mjs";
-import "../../chunk-IFQLPXCZ.mjs";
-import "../../chunk-QWPHP26D.mjs";
-import "../../chunk-MQRXWXHP.mjs";
+  ObjectSchema,
+  object
+} from "../../chunk-KAFZGQ2W.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/object/index.ts
-function object(shapeSchema) {
-  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema);
-}
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
+  ObjectSchema,
   object
 };
 //# sourceMappingURL=index.mjs.map

package/lib/asserts/object/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/object/index.ts"],"sourcesContent":["import { WithObject } from '../../commonTypes';\nimport { ObjectShapeSchemaType } from '../../schemas/CommonSchema';\nimport { ObjectSchema } from '../../schemas/ObjectSchema';\n\n/**\n * @description Creates a new schema for validating objects where each property must match the specified schema.\n * @template T\n * @param {T} shapeSchema - The schema that each property of the object must match.\n * @returns {WithObject<ObjectSchema, T>} A new instance of `ObjectSchema` for validating objects with properties matching the specified schema.\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number()\n * });\n * parseOrFail(schema, { name: 'John', age: 30 }); // Validates successfully\n * parseOrFail(schema, { name: 'John', age: '30' }); // Throws a validation error\n *\n * @instance Of ObjectSchema\n */\nexport function object<T extends ObjectShapeSchemaType>(shapeSchema: T): WithObject<ObjectSchema, T> {\n  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema) as WithObject<ObjectSchema, T>;\n}\n"],"mappings":";;;;;;;;;;;AAmBO,SAAS,OAAwC,aAA6C;AACnG,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,GAAG,WAAW;AAC5E;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/object/maxKeys.d.mts

@@ -1,5 +1,8 @@
-import { RequiredValidation } from '../../ExceptionContext.mjs';
+import { RequiredValidation } from '../../core.mjs';
 import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
 
 /**
  * @description Ensures that the object has no more than the specified number of keys.
@@ -23,7 +26,7 @@ import '../../commonTypes.mjs';
  * @translation Error Translation Key = 'o:maxKeys'
  */
 declare const maxKeys: {
-    (expected: number): RequiredValidation;
+    (expected: number): RequiredValidation<Record<string, unknown>>;
     key: string;
     message: string;
 };

package/lib/asserts/object/maxKeys.d.ts

@@ -1,5 +1,8 @@
-import { RequiredValidation } from '../../ExceptionContext.js';
+import { RequiredValidation } from '../../core.js';
 import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
 
 /**
  * @description Ensures that the object has no more than the specified number of keys.
@@ -23,7 +26,7 @@ import '../../commonTypes.js';
  * @translation Error Translation Key = 'o:maxKeys'
  */
 declare const maxKeys: {
-    (expected: number): RequiredValidation;
+    (expected: number): RequiredValidation<Record<string, unknown>>;
     key: string;
     message: string;
 };

package/lib/asserts/object/maxKeys.js

@@ -1,21 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEXVTHIT5js = require('../../chunk-EXVTHIT5.js');
-require('../../chunk-FIDPCCCW.js');
+var _chunkKDPYWGMJjs = require('../../chunk-KDPYWGMJ.js');
+require('../../chunk-WOPNDC4R.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-ZWFSAKQK.js');
 
-// src/asserts/object/maxKeys.ts
-var maxKeysErrorMessage = "The received number of keys is greater than expected";
-var maxKeysErrorKey = "o:maxKeys";
-var maxKeys = (expected) => (receivedObject, ctx) => {
-  const keysCount = Object.keys(receivedObject).length;
-  if (keysCount > expected) {
-    ctx.addIssue(expected, keysCount, maxKeysErrorKey);
-  }
-};
-maxKeys.key = maxKeysErrorKey;
-maxKeys.message = maxKeysErrorMessage;
-_chunkEXVTHIT5js.setToDefaultLocale.call(void 0, maxKeys);
 
-
-exports.maxKeys = maxKeys;
+exports.maxKeys = _chunkKDPYWGMJjs.maxKeys;
 //# sourceMappingURL=maxKeys.js.map

package/lib/asserts/object/maxKeys.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/object/maxKeys.js","../../../src/asserts/object/maxKeys.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC;AACA;ACFA,IAAM,oBAAA,EAAsB,sDAAA;AAC5B,IAAM,gBAAA,EAAkB,WAAA;AAuBjB,IAAM,QAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,cAAA,EAAyC,GAAA,EAAA,GAA0B;AAClE,EAAA,MAAM,UAAA,EAAY,MAAA,CAAO,IAAA,CAAK,cAAc,CAAA,CAAE,MAAA;AAC9C,EAAA,GAAA,CAAI,UAAA,EAAY,QAAA,EAAU;AACxB,IAAA,GAAA,CAAI,QAAA,CAAS,QAAA,EAAU,SAAA,EAAW,eAAe,CAAA;AAAA,EACnD;AACF,CAAA;AAEF,OAAA,CAAQ,IAAA,EAAM,eAAA;AACd,OAAA,CAAQ,QAAA,EAAU,mBAAA;AAClB,iDAAA,OAA0B,CAAA;ADrB1B;AACE;AACF,0BAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/object/maxKeys.js","sourcesContent":[null,"import { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst maxKeysErrorMessage = 'The received number of keys is greater than expected';\nconst maxKeysErrorKey = 'o:maxKeys';\n\n/**\n * @description Ensures that the object has no more than the specified number of keys.\n * @param {number} expected - The maximum number of keys allowed in the object.\n * @returns {RequiredValidation} A validation function that takes a received object and an exception context.\n * @throws {ValidationError} if the number of the received keys is greater than the expected value.\n * @example\n * const schema = object({\n *   name: string(),\n *   email: string(),\n * })\n *   .allowUnrecognized()\n *   .custom(maxKeys(2));\n *\n * // This will pass\n * parseOrFail(schema, { name: 'John', email: 'john@example.com' });\n *\n * // This will throw an error because there are 3 keys\n * parseOrFail(schema, { name: 'John', email: 'john@example.com', address: '123 Main St' });\n *\n * @translation Error Translation Key = 'o:maxKeys'\n */\nexport const maxKeys =\n  (expected: number): RequiredValidation =>\n  (receivedObject: Record<string, unknown>, ctx: ExceptionContext) => {\n    const keysCount = Object.keys(receivedObject).length;\n    if (keysCount > expected) {\n      ctx.addIssue(expected, keysCount, maxKeysErrorKey);\n    }\n  };\n\nmaxKeys.key = maxKeysErrorKey;\nmaxKeys.message = maxKeysErrorMessage;\nsetToDefaultLocale(maxKeys);\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/object/maxKeys.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,2CAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/object/maxKeys.js"}

package/lib/asserts/object/maxKeys.mjs

@@ -1,20 +1,9 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-QWPHP26D.mjs";
-import "../../chunk-ZTCXXAKD.mjs";
-
-// src/asserts/object/maxKeys.ts
-var maxKeysErrorMessage = "The received number of keys is greater than expected";
-var maxKeysErrorKey = "o:maxKeys";
-var maxKeys = (expected) => (receivedObject, ctx) => {
-  const keysCount = Object.keys(receivedObject).length;
-  if (keysCount > expected) {
-    ctx.addIssue(expected, keysCount, maxKeysErrorKey);
-  }
-};
-maxKeys.key = maxKeysErrorKey;
-maxKeys.message = maxKeysErrorMessage;
-setToDefaultLocale(maxKeys);
+  maxKeys
+} from "../../chunk-QM4MJTTD.mjs";
+import "../../chunk-VERUOTB3.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-O2WD4JBG.mjs";
 export {
   maxKeys
 };

package/lib/asserts/object/maxKeys.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/object/maxKeys.ts"],"sourcesContent":["import { ExceptionContext, RequiredValidation } from '../../ExceptionContext';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst maxKeysErrorMessage = 'The received number of keys is greater than expected';\nconst maxKeysErrorKey = 'o:maxKeys';\n\n/**\n * @description Ensures that the object has no more than the specified number of keys.\n * @param {number} expected - The maximum number of keys allowed in the object.\n * @returns {RequiredValidation} A validation function that takes a received object and an exception context.\n * @throws {ValidationError} if the number of the received keys is greater than the expected value.\n * @example\n * const schema = object({\n *   name: string(),\n *   email: string(),\n * })\n *   .allowUnrecognized()\n *   .custom(maxKeys(2));\n *\n * // This will pass\n * parseOrFail(schema, { name: 'John', email: 'john@example.com' });\n *\n * // This will throw an error because there are 3 keys\n * parseOrFail(schema, { name: 'John', email: 'john@example.com', address: '123 Main St' });\n *\n * @translation Error Translation Key = 'o:maxKeys'\n */\nexport const maxKeys =\n  (expected: number): RequiredValidation =>\n  (receivedObject: Record<string, unknown>, ctx: ExceptionContext) => {\n    const keysCount = Object.keys(receivedObject).length;\n    if (keysCount > expected) {\n      ctx.addIssue(expected, keysCount, maxKeysErrorKey);\n    }\n  };\n\nmaxKeys.key = maxKeysErrorKey;\nmaxKeys.message = maxKeysErrorMessage;\nsetToDefaultLocale(maxKeys);\n"],"mappings":";;;;;;AAGA,IAAM,sBAAsB;AAC5B,IAAM,kBAAkB;AAuBjB,IAAM,UACX,CAAC,aACD,CAAC,gBAAyC,QAA0B;AAClE,QAAM,YAAY,OAAO,KAAK,cAAc,EAAE;AAC9C,MAAI,YAAY,UAAU;AACxB,QAAI,SAAS,UAAU,WAAW,eAAe;AAAA,EACnD;AACF;AAEF,QAAQ,MAAM;AACd,QAAQ,UAAU;AAClB,mBAAmB,OAAO;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/object/omit.d.mts

@@ -0,0 +1,27 @@
+import { WithObject } from '../../commonTypes.mjs';
+import { ObjectShapeSchemaType, CommonSchema } from '../../core.mjs';
+import { ObjectSchema } from './index.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * @description Creates a new object schema without the named properties.
+ *
+ * The original is untouched.
+ *
+ * @template T
+ * @template K
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to narrow.
+ * @param {readonly K[]} keys - The properties to drop.
+ * @returns A new object schema without those properties.
+ * @example
+ * const userSchema = object({ id: string(), name: string(), secret: string() });
+ * const publicSchema = omit(userSchema, ['secret']);
+ * parseOrFail(publicSchema, { id: '1', name: 'a' }); // Validates successfully
+ *
+ * @instance Of CommonSchema
+ */
+declare function omit<T extends ObjectShapeSchemaType, K extends keyof T & string>(schema: WithObject<CommonSchema, T>, keys: readonly K[]): WithObject<ObjectSchema, Omit<T, K>>;
+
+export { omit };

package/lib/asserts/object/omit.d.ts

@@ -0,0 +1,27 @@
+import { WithObject } from '../../commonTypes.js';
+import { ObjectShapeSchemaType, CommonSchema } from '../../core.js';
+import { ObjectSchema } from './index.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * @description Creates a new object schema without the named properties.
+ *
+ * The original is untouched.
+ *
+ * @template T
+ * @template K
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to narrow.
+ * @param {readonly K[]} keys - The properties to drop.
+ * @returns A new object schema without those properties.
+ * @example
+ * const userSchema = object({ id: string(), name: string(), secret: string() });
+ * const publicSchema = omit(userSchema, ['secret']);
+ * parseOrFail(publicSchema, { id: '1', name: 'a' }); // Validates successfully
+ *
+ * @instance Of CommonSchema
+ */
+declare function omit<T extends ObjectShapeSchemaType, K extends keyof T & string>(schema: WithObject<CommonSchema, T>, keys: readonly K[]): WithObject<ObjectSchema, Omit<T, K>>;
+
+export { omit };

package/lib/asserts/object/omit.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkJHONMWCEjs = require('../../chunk-JHONMWCE.js');
+require('../../chunk-AO6DKPJZ.js');
+require('../../chunk-JLEQOYDW.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.omit = _chunkJHONMWCEjs.omit;
+//# sourceMappingURL=omit.js.map

package/lib/asserts/object/omit.js.map

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

package/lib/asserts/object/omit.mjs

@@ -0,0 +1,14 @@
+import {
+  omit
+} from "../../chunk-VT2JBMWQ.mjs";
+import "../../chunk-A36G62K5.mjs";
+import "../../chunk-KAFZGQ2W.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  omit
+};
+//# sourceMappingURL=omit.mjs.map

package/lib/asserts/object/partial.d.mts

@@ -0,0 +1,34 @@
+import { WithObject, WithUndefined } from '../../commonTypes.mjs';
+import { ObjectShapeSchemaType, CommonSchema } from '../../core.mjs';
+import { ObjectSchema } from './index.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * Named rather than written inline in both the signature and the cast: the two spellings of the same
+ * mapped type are not provably identical to the compiler once `~standard` puts a deferred
+ * `InferType<this>` inside them.
+ */
+type PartialShape<T extends ObjectShapeSchemaType> = {
+    [K in keyof T]: WithUndefined<T[K]>;
+};
+/**
+ * @description Creates a new object schema in which every property is optional.
+ *
+ * Each property schema is made optional in its own right, so the original schema and the property
+ * schemas it holds are unchanged.
+ *
+ * @template T
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to relax.
+ * @returns A new object schema with every property optional.
+ * @example
+ * const userSchema = object({ id: string(), name: string() });
+ * const patchSchema = partial(userSchema);
+ * parseOrFail(patchSchema, {}); // Validates successfully
+ *
+ * @instance Of CommonSchema
+ */
+declare function partial<T extends ObjectShapeSchemaType>(schema: WithObject<CommonSchema, T>): WithObject<ObjectSchema, PartialShape<T>>;
+
+export { partial };

package/lib/asserts/object/partial.d.ts

@@ -0,0 +1,34 @@
+import { WithObject, WithUndefined } from '../../commonTypes.js';
+import { ObjectShapeSchemaType, CommonSchema } from '../../core.js';
+import { ObjectSchema } from './index.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * Named rather than written inline in both the signature and the cast: the two spellings of the same
+ * mapped type are not provably identical to the compiler once `~standard` puts a deferred
+ * `InferType<this>` inside them.
+ */
+type PartialShape<T extends ObjectShapeSchemaType> = {
+    [K in keyof T]: WithUndefined<T[K]>;
+};
+/**
+ * @description Creates a new object schema in which every property is optional.
+ *
+ * Each property schema is made optional in its own right, so the original schema and the property
+ * schemas it holds are unchanged.
+ *
+ * @template T
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to relax.
+ * @returns A new object schema with every property optional.
+ * @example
+ * const userSchema = object({ id: string(), name: string() });
+ * const patchSchema = partial(userSchema);
+ * parseOrFail(patchSchema, {}); // Validates successfully
+ *
+ * @instance Of CommonSchema
+ */
+declare function partial<T extends ObjectShapeSchemaType>(schema: WithObject<CommonSchema, T>): WithObject<ObjectSchema, PartialShape<T>>;
+
+export { partial };

package/lib/asserts/object/partial.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkYOF36UOSjs = require('../../chunk-YOF36UOS.js');
+require('../../chunk-AO6DKPJZ.js');
+require('../../chunk-JLEQOYDW.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+exports.partial = _chunkYOF36UOSjs.partial;
+//# sourceMappingURL=partial.js.map

package/lib/asserts/object/partial.js.map

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

package/lib/asserts/object/partial.mjs

@@ -0,0 +1,14 @@
+import {
+  partial
+} from "../../chunk-BZ6R6RWE.mjs";
+import "../../chunk-A36G62K5.mjs";
+import "../../chunk-KAFZGQ2W.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  partial
+};
+//# sourceMappingURL=partial.mjs.map

package/lib/asserts/object/pick.d.mts

@@ -0,0 +1,32 @@
+import { WithObject } from '../../commonTypes.mjs';
+import { CommonSchema, ObjectShapeSchemaType } from '../../core.mjs';
+import { ObjectSchema } from './index.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * @description Creates a new object schema keeping only the named properties.
+ *
+ * The original is untouched, and the properties keep the schemas they had, including their assertions
+ * and metadata.
+ *
+ * @template T
+ * @template K
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to narrow.
+ * @param {readonly K[]} keys - The properties to keep.
+ * @returns A new object schema with only those properties.
+ * @example
+ * const userSchema = object({ id: string(), name: string(), secret: string() });
+ * const publicSchema = pick(userSchema, ['id', 'name']);
+ * parseOrFail(publicSchema, { id: '1', name: 'a' }); // Validates successfully
+ *
+ * @instance Of CommonSchema
+ */
+declare function pick<T extends ObjectShapeSchemaType, K extends keyof T & string>(schema: WithObject<CommonSchema, T>, keys: readonly K[]): WithObject<ObjectSchema, Pick<T, K>>;
+/** Reads the shape of a schema that must be an object schema. Shared by the object utilities. */
+declare function _shapeOf(schema: CommonSchema, methodName: string): ObjectShapeSchemaType;
+/** Builds a new object schema from a shape, carrying over the source's own settings. */
+declare function _objectFrom(source: CommonSchema, shape: ObjectShapeSchemaType): ObjectSchema;
+
+export { _objectFrom, _shapeOf, pick };

package/lib/asserts/object/pick.d.ts

@@ -0,0 +1,32 @@
+import { WithObject } from '../../commonTypes.js';
+import { CommonSchema, ObjectShapeSchemaType } from '../../core.js';
+import { ObjectSchema } from './index.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
+import '../../standardSchema.js';
+
+/**
+ * @description Creates a new object schema keeping only the named properties.
+ *
+ * The original is untouched, and the properties keep the schemas they had, including their assertions
+ * and metadata.
+ *
+ * @template T
+ * @template K
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to narrow.
+ * @param {readonly K[]} keys - The properties to keep.
+ * @returns A new object schema with only those properties.
+ * @example
+ * const userSchema = object({ id: string(), name: string(), secret: string() });
+ * const publicSchema = pick(userSchema, ['id', 'name']);
+ * parseOrFail(publicSchema, { id: '1', name: 'a' }); // Validates successfully
+ *
+ * @instance Of CommonSchema
+ */
+declare function pick<T extends ObjectShapeSchemaType, K extends keyof T & string>(schema: WithObject<CommonSchema, T>, keys: readonly K[]): WithObject<ObjectSchema, Pick<T, K>>;
+/** Reads the shape of a schema that must be an object schema. Shared by the object utilities. */
+declare function _shapeOf(schema: CommonSchema, methodName: string): ObjectShapeSchemaType;
+/** Builds a new object schema from a shape, carrying over the source's own settings. */
+declare function _objectFrom(source: CommonSchema, shape: ObjectShapeSchemaType): ObjectSchema;
+
+export { _objectFrom, _shapeOf, pick };

package/lib/asserts/object/pick.js

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkAO6DKPJZjs = require('../../chunk-AO6DKPJZ.js');
+require('../../chunk-JLEQOYDW.js');
+require('../../chunk-6LUSV3SS.js');
+require('../../chunk-ZJGY6EOE.js');
+require('../../chunk-VBTWYDEM.js');
+require('../../chunk-LHEU4XAC.js');
+require('../../chunk-ZWFSAKQK.js');
+
+
+
+
+exports._objectFrom = _chunkAO6DKPJZjs._objectFrom; exports._shapeOf = _chunkAO6DKPJZjs._shapeOf; exports.pick = _chunkAO6DKPJZjs.pick;
+//# sourceMappingURL=pick.js.map

package/lib/asserts/object/pick.js.map

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

package/lib/asserts/object/pick.mjs

@@ -0,0 +1,17 @@
+import {
+  _objectFrom,
+  _shapeOf,
+  pick
+} from "../../chunk-A36G62K5.mjs";
+import "../../chunk-KAFZGQ2W.mjs";
+import "../../chunk-LDZFOOWN.mjs";
+import "../../chunk-65X7NTUS.mjs";
+import "../../chunk-YBVMP4EI.mjs";
+import "../../chunk-C76DLZFD.mjs";
+import "../../chunk-O2WD4JBG.mjs";
+export {
+  _objectFrom,
+  _shapeOf,
+  pick
+};
+//# sourceMappingURL=pick.mjs.map

package/lib/asserts/object/required.d.mts

@@ -0,0 +1,39 @@
+import { WithObject } from '../../commonTypes.mjs';
+import { ObjectShapeSchemaType, CommonSchema } from '../../core.mjs';
+import { ObjectSchema } from './index.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
+import '../../standardSchema.mjs';
+
+/**
+ * Named rather than written inline in both the signature and the cast: the two spellings of the same
+ * mapped type are not provably identical to the compiler once `~standard` puts a deferred
+ * `InferType<this>` inside them.
+ *
+ * Removing the brand rather than trying to recover the type it wraps, because an intersection cannot
+ * be taken apart again. What matters to `InferType` is that the result no longer carries the marker.
+ */
+type RequiredShape<T extends ObjectShapeSchemaType> = {
+    [K in keyof T]: Omit<T[K], 'validation_undefined'>;
+};
+/**
+ * @description Creates a new object schema in which every property is required, the counterpart to
+ * `partial`.
+ *
+ * A property that carried a default keeps it, so it may still be omitted — a default is what makes a
+ * property supply its own value rather than optional.
+ *
+ * @template T
+ * @param {WithObject<CommonSchema, T>} schema - The object schema to tighten.
+ * @returns A new object schema with every property required.
+ * @example
+ * const patchSchema = partial(object({ id: string(), name: string() }));
+ * const fullSchema = required(patchSchema);
+ * parseOrFail(fullSchema, { id: '1', name: 'a' }); // Validates successfully
+ * parseOrFail(fullSchema, {}); // Throws a validation error
+ *
+ * @instance Of CommonSchema
+ */
+declare function required<T extends ObjectShapeSchemaType>(schema: WithObject<CommonSchema, T>): WithObject<ObjectSchema, RequiredShape<T>>;
+
+export { required };