bguard 0.4.1 → 0.6.0

package/README.md

@@ -32,6 +32,8 @@ Table of contents
  * [Built-in Custom Assert Documentation](#builtin_custom_assert_documentation) 
 
      * [string](#assertdir_string)
+          * [equalTo](#assert_string_method_equalto)
+          * [oneOfValues](#assert_string_method_oneofvalues)
           * [atLeastOneDigit](#assert_atleastonedigit_string)
           * [atLeastOneLowerChar](#assert_atleastonelowerchar_string)
           * [atLeastOneSpecialChar](#assert_atleastonespecialchar_string)
@@ -56,6 +58,8 @@ Table of contents
           * [uuidV5](#assert_uuidv5_string)
           * [validUrl](#assert_validurl_string)
      * [number](#assertdir_number)
+          * [equalTo](#assert_number_method_equalto)
+          * [oneOfValues](#assert_number_method_oneofvalues)
           * [max](#assert_max_number)
           * [maxExcluded](#assert_maxexcluded_number)
           * [min](#assert_min_number)
@@ -66,6 +70,8 @@ Table of contents
           * [maxArrayLength](#assert_maxarraylength_array)
           * [minArrayLength](#assert_minarraylength_array)
      * [bigint](#assertdir_bigint)
+          * [equalTo](#assert_bigint_method_equalto)
+          * [oneOfValues](#assert_bigint_method_oneofvalues)
           * [bigintMax](#assert_bigintmax_bigint)
           * [bigintMaxExcluded](#assert_bigintmaxexcluded_bigint)
           * [bigintMin](#assert_bigintmin_bigint)
@@ -77,6 +83,7 @@ Table of contents
           * [equalTo](#assert_equalto_mix)
           * [oneOfValues](#assert_oneofvalues_mix)
      * [object](#assertdir_object)
+          * [allowUnrecognized](#assert_object_method_allowunrecognized)
           * [maxKeys](#assert_maxkeys_object)
 
 ### <a id="h3_features"> Features </a>
@@ -459,8 +466,7 @@ Bguard allows developers to create custom validation functions that can be integ
 Example: Creating a `minLength` Custom Validation
 
 ```typescript
-import { guardException } from 'bguard/exceptions';
-import { ExceptionContext, RequiredValidation } from 'bguard/commonTypes';
+import { ExceptionContext, RequiredValidation } from 'bguard/ExceptionContext';
 import { setToDefaultLocale } from 'bguard/translationMap';
 
 const minLengthErrorMessage = 'The received value {{r}} is shorter than the expected length {{e}}';
@@ -470,7 +476,7 @@ export const minLength =
   (expected: number): RequiredValidation =>
   (received: string, ctx: ExceptionContext) => {
     if (received.length < expected) {
-      guardException(expected, received, ctx, minLengthErrorKey);
+      ctx.addIssue(expected, received, minLengthErrorKey);
     }
   };
 
@@ -485,17 +491,30 @@ Explanation
 
 - Error Message (`minLength.message`): The message supports [interpolation](#translation), where `{{e}}` will be replaced by the expected value, and `{{r}}` will be replaced by the received value during validation .
 
-- Exception Handling (`guardException`): This function is responsible for throwing the error when the validation fails. The `ctx` parameter must be passed to ensure the internal logic of the application works correctly.
+- Exception Handling (`ctx.addIssue`): This method is responsible for throwing the error when the validation fails.
 
 - Localization Support (`setToDefaultLocale`): This function registers the default error message with its associated key. If you later decide to support multiple languages, you can easily map this key to different messages.
 
+ - Using `ctx.ref` to Reference Other Properties: The `ctx.ref` method allows you to reference other properties in the input object during validation. Method ctx.ref can access nested properties by passing a string that references them, with each level of nesting separated by a dot (.). However, it's important to note that `ctx.ref` retrieves the <b>original</b> value from the object before any transformations (e.g., `transformBeforeValidation`). This ensures that validations based on cross-property references work consistently, regardless of any transformations applied before validation.
+ ```typescript
+const loginSchema = object({
+  password: string().custom(minLength(8)),
+  confirmPassword: string().custom((received, ctx) => {
+    if (received !== ctx.ref('password')) {
+      ctx.addIssue(ctx.ref('password'), received, 'Not equal to password');
+    }
+  })
+});
+
+```
+
 - Key Points for Developers:
 
   1. Always create unique error keys for custom validations to avoid potential conflicts with Bguard's built-in validations.
   2. Custom validations should use prefixes other than `s:`, `n:`, `b:`, and similar ones reserved for Bguard's internal validations.
   3. The `minLengthErrorMessage` serves as the default message. If you want to provide translations, you can do so by mapping the error key in the translationMap.
-     For single-language applications, you can override the default message by directly passing your custom message to `guardException`.
-
+     For single-language applications, you can override the default message by directly passing your custom message to `addIssue` method.
+  4. If we have a nested object { foo: { bar: 'baz' } }, we should use `ctx.ref('foo.bar')` to access the value 'baz' in custom assertions.
 ### <a id="translation"> Translation </a>
 
 Bguard provides default translations for error messages, but you can customize them as needed. Each potential error has an `errorKey` and `errorMessage`.
@@ -626,6 +645,22 @@ import { string } from 'bguard/string';
  parseOrFail(schema, 'hello'); // Validates successfully
  parseOrFail(schema, 123); // Throws a validation error
 ```
+
+##### <a id="assert_string_method_equalto"> equalTo </a>
+ * _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.
+* _Example_
+```typescript
+ string().equalTo('hello'); // Infers the type 'hello'
+```
+
+##### <a id="assert_string_method_oneofvalues"> oneOfValues </a>
+ * _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.
+* _Example_
+```typescript
+ string().oneOfValues(['foo', 'bar']); // Infers the type 'foo' | 'bar'
+```
    
         
 ##### <a id="assert_atleastonedigit_string"> atLeastOneDigit </a>
@@ -669,7 +704,7 @@ import { atLeastOneSpecialChar } from 'bguard/string/atLeastOneSpecialChar';
 ```
         
 * _Description_ Asserts that a string value contains at least one special character.
-* _Param_ {string} [allowedSpecialChars=* '@!#%&()^~{}'] The string containing allowed special characters. Defaults to '*@!#%&()^~{}'.
+* _Param_ {string} [allowedSpecialChars=*] The string containing allowed special characters. Defaults to '*@$!#%&()^~{}'.
 * _Throws_ {ValidationError} if the received value does not contain at least one of the allowed special characters.
 * _Example_
 ```typescript
@@ -1073,6 +1108,22 @@ import { number } from 'bguard/number';
  parseOrFail(schema, 42); // Validates successfully
  parseOrFail(schema, '42'); // Throws a validation error
 ```
+
+##### <a id="assert_number_method_equalto"> equalTo </a>
+ * _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.
+* _Example_
+```typescript
+ number().equalTo(42); // Infers the type 42
+```
+
+##### <a id="assert_number_method_oneofvalues"> oneOfValues </a>
+ * _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.
+* _Example_
+```typescript
+ number().oneOfValues([5, 7]); // Infers the type 5 | 7
+```
    
         
 ##### <a id="assert_max_number"> max </a>
@@ -1250,7 +1301,7 @@ import { minArrayLength } from 'bguard/array/minArrayLength';
 import { bigint } from 'bguard/bigint';
 ```
    
-* _Description_ Creates a new schema for validating bigint values.
+* _Description_ - Creates a new schema for validating bigint values.
 * _Example_
 ```typescript
  const schema = bigint();
@@ -1258,6 +1309,22 @@ import { bigint } from 'bguard/bigint';
  parseOrFail(schema, 42); // Throws a validation error
  parseOrFail(schema, '42'); // Throws a validation error
 ```
+
+##### <a id="assert_bigint_method_equalto"> equalTo </a>
+ * _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.
+* _Example_
+```typescript
+ bigint().equalTo(42n); // Infers the type 42n
+```
+
+##### <a id="assert_bigint_method_oneofvalues"> oneOfValues </a>
+ * _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.
+* _Example_
+```typescript
+ bigint().oneOfValues([5n, 7n]); // Infers the type 5n | 7n
+```
    
         
 ##### <a id="assert_bigintmax_bigint"> bigintMax </a>
@@ -1398,7 +1465,6 @@ import { oneOfTypes } from 'bguard/mix';
 ```
    
 * _Description_ Creates a new schema for validating values that can match any one of the specified primitive types.
-
  
 * _Param_ {T} valueTypes - An array of primitive types that the value can match.
 * _Example_
@@ -1456,6 +1522,22 @@ import { oneOfValues } from 'bguard/mix/oneOfValues';
 import { object } from 'bguard/object';
 ```
    
+##### <a id="assert_object_method_allowunrecognized"> allowUnrecognized </a>
+ * _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.
+* _Example_
+```typescript
+  const userSchema = object({
+    name: string(),
+    age: number(),
+  }).allowUnrecognized();
+
+ parseOrFail(userSchema, ({ name: 'John', age: 30, extra: 'value' }););
+ //  No error thrown
+```
+
 * _Description_ Creates a new schema for validating objects where each property must match the specified schema.
  
 * _Param_ {T} shapeSchema - The schema that each property of the object must match.

package/lib/InferType.d.mts

@@ -1,4 +1,4 @@
-import { WithBGuardType, ExtractFromBGuardType, WithArray, ExtractFromArray, WithObject, WithUndefined, WithNull } from './commonTypes.mjs';
+import { WithBGuardType, WithUndefined, WithNull, ExtractFromBGuardType, WithArray, ExtractFromArray, WithObject } from './commonTypes.mjs';
 
 type ResolveNullish<T, Y> = T extends WithUndefined<WithNull<unknown>> ? Y | null | undefined : T extends WithUndefined<unknown> ? Y | undefined : T extends WithNull<unknown> ? Y | null : Y;
 type InferType<T> = T extends WithBGuardType<unknown, unknown> ? ResolveNullish<T, ExtractFromBGuardType<T>> : T extends WithArray<unknown, unknown> ? ResolveNullish<T, InferType<ExtractFromArray<T>>[]> : T extends WithObject<unknown, unknown> ? ResolveNullish<T, ExtractFromObject<T>> : unknown;

package/lib/InferType.d.ts

@@ -1,4 +1,4 @@
-import { WithBGuardType, ExtractFromBGuardType, WithArray, ExtractFromArray, WithObject, WithUndefined, WithNull } from './commonTypes.js';
+import { WithBGuardType, WithUndefined, WithNull, ExtractFromBGuardType, WithArray, ExtractFromArray, WithObject } from './commonTypes.js';
 
 type ResolveNullish<T, Y> = T extends WithUndefined<WithNull<unknown>> ? Y | null | undefined : T extends WithUndefined<unknown> ? Y | undefined : T extends WithNull<unknown> ? Y | null : Y;
 type InferType<T> = T extends WithBGuardType<unknown, unknown> ? ResolveNullish<T, ExtractFromBGuardType<T>> : T extends WithArray<unknown, unknown> ? ResolveNullish<T, InferType<ExtractFromArray<T>>[]> : T extends WithObject<unknown, unknown> ? ResolveNullish<T, ExtractFromObject<T>> : unknown;

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

@@ -1,7 +1,7 @@
 import { WithArray } from '../../commonTypes.mjs';
-import { ArraySchema } from '../../schemas/ArraySchema.mjs';
-import { C as CommonSchema } from '../../CommonSchema-wi9MOXGF.mjs';
+import { CommonSchema, ValidatorContext } from '../../core.mjs';
 import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
 
 /**
  * @description Creates a new schema for validating arrays where each element must match the specified schema.
@@ -16,5 +16,10 @@ import '../../InferType.mjs';
  * @instance Of ArraySchema
  */
 declare function array<T extends CommonSchema>(arraySchema: T): WithArray<ArraySchema, T>;
+declare class ArraySchema extends CommonSchema {
+    protected _array: number;
+    constructor(ctx: ValidatorContext, arraySchema: CommonSchema);
+    private validateArrayEntry;
+}
 
 export { array };

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

@@ -1,7 +1,7 @@
 import { WithArray } from '../../commonTypes.js';
-import { ArraySchema } from '../../schemas/ArraySchema.js';
-import { C as CommonSchema } from '../../CommonSchema-DOh3bsL-.js';
+import { CommonSchema, ValidatorContext } from '../../core.js';
 import '../../InferType.js';
+import '../../helpers/constants.js';
 
 /**
  * @description Creates a new schema for validating arrays where each element must match the specified schema.
@@ -16,5 +16,10 @@ import '../../InferType.js';
  * @instance Of ArraySchema
  */
 declare function array<T extends CommonSchema>(arraySchema: T): WithArray<ArraySchema, T>;
+declare class ArraySchema extends CommonSchema {
+    protected _array: number;
+    constructor(ctx: ValidatorContext, arraySchema: CommonSchema);
+    private validateArrayEntry;
+}
 
 export { array };

package/lib/asserts/array/index.js

@@ -1,18 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkVW4RMQD4js = require('../../chunk-VW4RMQD4.js');
-require('../../chunk-SHJVKSEZ.js');
-require('../../chunk-G55SHHAR.js');
-require('../../chunk-X762EUSZ.js');
+var _chunkTCDQA2NUjs = require('../../chunk-TCDQA2NU.js');
+require('../../chunk-VN4GLOEN.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-5YYRBKDP.js');
-require('../../chunk-5P6AZJCN.js');
+require('../../chunk-TJQ5NVL4.js');
+require('../../chunk-FIDPCCCW.js');
+require('../../chunk-AXKX5BGH.js');
 
-// src/asserts/array/index.ts
-function array(arraySchema) {
-  return new (0, _chunkVW4RMQD4js.ArraySchema)({ type: [], requiredValidations: [] }, arraySchema);
-}
 
-
-exports.array = array;
+exports.array = _chunkTCDQA2NUjs.array;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/index.js","../../../src/asserts/array/index.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACA;ACMO,SAAS,KAAA,CAA8B,WAAA,EAA2C;AACvF,EAAA,OAAO,IAAI,iCAAA,CAAY,EAAE,IAAA,EAAM,CAAC,CAAA,EAAG,mBAAA,EAAqB,CAAC,EAAE,CAAA,EAAG,WAAW,CAAA;AAC3E;ADJA;AACE;AACF,sBAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/index.js","sourcesContent":[null,"import { WithArray } from '../../commonTypes';\nimport { ArraySchema } from '../../schemas/ArraySchema';\nimport { CommonSchema } from '../../schemas/CommonSchema';\n\n/**\n * @description Creates a new schema for validating arrays where each element must match the specified schema.\n * @template T\n * @param {T} arraySchema - The schema that each element of the array must match.\n * @returns {WithArray<ArraySchema, T>} A new instance of `ArraySchema` for validating arrays of elements that match the specified schema.\n * @example\n * const schema = array(string());\n * parseOrFail(schema, ['hello', 'world']); // Validates successfully\n * parseOrFail(schema, ['hello', 123]); // Throws a validation error\n *\n * @instance Of ArraySchema\n */\nexport function array<T extends CommonSchema>(arraySchema: T): WithArray<ArraySchema, T> {\n  return new ArraySchema({ type: [], requiredValidations: [] }, arraySchema) as WithArray<ArraySchema, T>;\n}\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,uCAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/index.js"}

package/lib/asserts/array/index.mjs

@@ -1,17 +1,11 @@
 import {
-  ArraySchema
-} from "../../chunk-LPR3G5T3.mjs";
-import "../../chunk-7NBOVYSP.mjs";
-import "../../chunk-TRGMD7LA.mjs";
-import "../../chunk-BNCT7NOR.mjs";
+  array
+} from "../../chunk-6WKSLMJG.mjs";
+import "../../chunk-QIPGUTIG.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-H32B3NHW.mjs";
-import "../../chunk-FGZKNBDP.mjs";
-
-// src/asserts/array/index.ts
-function array(arraySchema) {
-  return new ArraySchema({ type: [], requiredValidations: [] }, arraySchema);
-}
+import "../../chunk-OE3L7EKN.mjs";
+import "../../chunk-ZTCXXAKD.mjs";
+import "../../chunk-2ANPCB4O.mjs";
 export {
   array
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/array/index.ts"],"sourcesContent":["import { WithArray } from '../../commonTypes';\nimport { ArraySchema } from '../../schemas/ArraySchema';\nimport { CommonSchema } from '../../schemas/CommonSchema';\n\n/**\n * @description Creates a new schema for validating arrays where each element must match the specified schema.\n * @template T\n * @param {T} arraySchema - The schema that each element of the array must match.\n * @returns {WithArray<ArraySchema, T>} A new instance of `ArraySchema` for validating arrays of elements that match the specified schema.\n * @example\n * const schema = array(string());\n * parseOrFail(schema, ['hello', 'world']); // Validates successfully\n * parseOrFail(schema, ['hello', 123]); // Throws a validation error\n *\n * @instance Of ArraySchema\n */\nexport function array<T extends CommonSchema>(arraySchema: T): WithArray<ArraySchema, T> {\n  return new ArraySchema({ type: [], requiredValidations: [] }, arraySchema) as WithArray<ArraySchema, T>;\n}\n"],"mappings":";;;;;;;;;;;AAgBO,SAAS,MAA8B,aAA2C;AACvF,SAAO,IAAI,YAAY,EAAE,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,GAAG,WAAW;AAC3E;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/array/maxArrayLength.d.mts

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.mjs';
+import { RequiredValidation } from '../../core.mjs';
+import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
 
 /**
  * @description Asserts that the length of an array is not greater than a specified maximum length.

package/lib/asserts/array/maxArrayLength.d.ts

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.js';
+import { RequiredValidation } from '../../core.js';
+import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
 
 /**
  * @description Asserts that the length of an array is not greater than a specified maximum length.

package/lib/asserts/array/maxArrayLength.js

@@ -1,20 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk5YYRBKDPjs = require('../../chunk-5YYRBKDP.js');
+var _chunkYMPRYKNYjs = require('../../chunk-YMPRYKNY.js');
+require('../../chunk-TJQ5NVL4.js');
+require('../../chunk-FIDPCCCW.js');
 
 
-var _chunk5P6AZJCNjs = require('../../chunk-5P6AZJCN.js');
-
-// src/asserts/array/maxArrayLength.ts
-var maxArrayLengthErrorMessage = "The received value length is greater than expected";
-var maxArrayLengthErrorKey = "a:maxArrayLength";
-var maxArrayLength = (expected) => (received, ctx) => {
-  if (received.length > expected) _chunk5P6AZJCNjs.guardException.call(void 0, expected, received, ctx, maxArrayLengthErrorMessage);
-};
-maxArrayLength.key = maxArrayLengthErrorKey;
-maxArrayLength.message = maxArrayLengthErrorMessage;
-_chunk5YYRBKDPjs.setToDefaultLocale.call(void 0, maxArrayLength);
-
-
-exports.maxArrayLength = maxArrayLength;
+exports.maxArrayLength = _chunkYMPRYKNYjs.maxArrayLength;
 //# sourceMappingURL=maxArrayLength.js.map

package/lib/asserts/array/maxArrayLength.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/maxArrayLength.js","../../../src/asserts/array/maxArrayLength.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC;AACE;AACF,0DAAgC;AAChC;AACA;ACHA,IAAM,2BAAA,EAA6B,oDAAA;AACnC,IAAM,uBAAA,EAAyB,kBAAA;AAexB,IAAM,eAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,QAAA,EAAqB,GAAA,EAAA,GAA0B;AAC9C,EAAA,GAAA,CAAI,QAAA,CAAS,OAAA,EAAS,QAAA,EAAU,6CAAA,QAAe,EAAU,QAAA,EAAU,GAAA,EAAK,0BAA0B,CAAA;AACpG,CAAA;AAEF,cAAA,CAAe,IAAA,EAAM,sBAAA;AACrB,cAAA,CAAe,QAAA,EAAU,0BAAA;AACzB,iDAAA,cAAiC,CAAA;ADZjC;AACE;AACF,wCAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/maxArrayLength.js","sourcesContent":[null,"import { guardException } from '../../exceptions';\nimport { ExceptionContext, RequiredValidation } from '../../commonTypes';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst maxArrayLengthErrorMessage = 'The received value length is greater than expected';\nconst maxArrayLengthErrorKey = 'a:maxArrayLength';\n\n/**\n * @description Asserts that the length of an array is not greater than a specified maximum length.\n * @param {number} expected The maximum allowed length for the array.\n * @returns {RequiredValidation} A validation function that takes a received array and an exception context.\n * @throws {ValidationError} if the length of the received value is greater than the expected length.\n * @example\n * const schema = array(string()).custom(maxArrayLength(3));\n * parseOrFail(schema, ['adequate', 'array']);   // Valid\n * parseOrFail(schema, ['adequate', 'array', 'length']);   // Valid\n * parseOrFail(schema, ['adequate', 'array', 'length', 'test']); // Throws an error: 'The received value length is greater than expected'\n *\n * @translation Error Translation Key = 'a:maxArrayLength'\n */\nexport const maxArrayLength =\n  (expected: number): RequiredValidation =>\n  (received: unknown[], ctx: ExceptionContext) => {\n    if (received.length > expected) guardException(expected, received, ctx, maxArrayLengthErrorMessage);\n  };\n\nmaxArrayLength.key = maxArrayLengthErrorKey;\nmaxArrayLength.message = maxArrayLengthErrorMessage;\nsetToDefaultLocale(maxArrayLength);\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/maxArrayLength.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,yDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/maxArrayLength.js"}

package/lib/asserts/array/maxArrayLength.mjs

@@ -1,19 +1,8 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-H32B3NHW.mjs";
-import {
-  guardException
-} from "../../chunk-FGZKNBDP.mjs";
-
-// src/asserts/array/maxArrayLength.ts
-var maxArrayLengthErrorMessage = "The received value length is greater than expected";
-var maxArrayLengthErrorKey = "a:maxArrayLength";
-var maxArrayLength = (expected) => (received, ctx) => {
-  if (received.length > expected) guardException(expected, received, ctx, maxArrayLengthErrorMessage);
-};
-maxArrayLength.key = maxArrayLengthErrorKey;
-maxArrayLength.message = maxArrayLengthErrorMessage;
-setToDefaultLocale(maxArrayLength);
+  maxArrayLength
+} from "../../chunk-NY2TPU6O.mjs";
+import "../../chunk-OE3L7EKN.mjs";
+import "../../chunk-ZTCXXAKD.mjs";
 export {
   maxArrayLength
 };

package/lib/asserts/array/maxArrayLength.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/array/maxArrayLength.ts"],"sourcesContent":["import { guardException } from '../../exceptions';\nimport { ExceptionContext, RequiredValidation } from '../../commonTypes';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst maxArrayLengthErrorMessage = 'The received value length is greater than expected';\nconst maxArrayLengthErrorKey = 'a:maxArrayLength';\n\n/**\n * @description Asserts that the length of an array is not greater than a specified maximum length.\n * @param {number} expected The maximum allowed length for the array.\n * @returns {RequiredValidation} A validation function that takes a received array and an exception context.\n * @throws {ValidationError} if the length of the received value is greater than the expected length.\n * @example\n * const schema = array(string()).custom(maxArrayLength(3));\n * parseOrFail(schema, ['adequate', 'array']);   // Valid\n * parseOrFail(schema, ['adequate', 'array', 'length']);   // Valid\n * parseOrFail(schema, ['adequate', 'array', 'length', 'test']); // Throws an error: 'The received value length is greater than expected'\n *\n * @translation Error Translation Key = 'a:maxArrayLength'\n */\nexport const maxArrayLength =\n  (expected: number): RequiredValidation =>\n  (received: unknown[], ctx: ExceptionContext) => {\n    if (received.length > expected) guardException(expected, received, ctx, maxArrayLengthErrorMessage);\n  };\n\nmaxArrayLength.key = maxArrayLengthErrorKey;\nmaxArrayLength.message = maxArrayLengthErrorMessage;\nsetToDefaultLocale(maxArrayLength);\n"],"mappings":";;;;;;;;AAIA,IAAM,6BAA6B;AACnC,IAAM,yBAAyB;AAexB,IAAM,iBACX,CAAC,aACD,CAAC,UAAqB,QAA0B;AAC9C,MAAI,SAAS,SAAS,SAAU,gBAAe,UAAU,UAAU,KAAK,0BAA0B;AACpG;AAEF,eAAe,MAAM;AACrB,eAAe,UAAU;AACzB,mBAAmB,cAAc;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/asserts/array/minArrayLength.d.mts

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.mjs';
+import { RequiredValidation } from '../../core.mjs';
+import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
 
 /**
  * @description Asserts that the length of na array is not less than a specified minimum length.

package/lib/asserts/array/minArrayLength.d.ts

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.js';
+import { RequiredValidation } from '../../core.js';
+import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
 
 /**
  * @description Asserts that the length of na array is not less than a specified minimum length.

package/lib/asserts/array/minArrayLength.js

@@ -1,20 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk5YYRBKDPjs = require('../../chunk-5YYRBKDP.js');
+var _chunkC2VSTWIDjs = require('../../chunk-C2VSTWID.js');
+require('../../chunk-TJQ5NVL4.js');
+require('../../chunk-FIDPCCCW.js');
 
 
-var _chunk5P6AZJCNjs = require('../../chunk-5P6AZJCN.js');
-
-// src/asserts/array/minArrayLength.ts
-var minArrayLengthErrorMessage = "The received value length is less than expected";
-var minArrayLengthErrorKey = "a:minArrayLength";
-var minArrayLength = (expected) => (received, ctx) => {
-  if (received.length < expected) _chunk5P6AZJCNjs.guardException.call(void 0, expected, received, ctx, minArrayLengthErrorMessage);
-};
-minArrayLength.key = minArrayLengthErrorKey;
-minArrayLength.message = minArrayLengthErrorMessage;
-_chunk5YYRBKDPjs.setToDefaultLocale.call(void 0, minArrayLength);
-
-
-exports.minArrayLength = minArrayLength;
+exports.minArrayLength = _chunkC2VSTWIDjs.minArrayLength;
 //# sourceMappingURL=minArrayLength.js.map

package/lib/asserts/array/minArrayLength.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/minArrayLength.js","../../../src/asserts/array/minArrayLength.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC;AACE;AACF,0DAAgC;AAChC;AACA;ACHA,IAAM,2BAAA,EAA6B,iDAAA;AACnC,IAAM,uBAAA,EAAyB,kBAAA;AAexB,IAAM,eAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,QAAA,EAAqB,GAAA,EAAA,GAA0B;AAC9C,EAAA,GAAA,CAAI,QAAA,CAAS,OAAA,EAAS,QAAA,EAAU,6CAAA,QAAe,EAAU,QAAA,EAAU,GAAA,EAAK,0BAA0B,CAAA;AACpG,CAAA;AAEF,cAAA,CAAe,IAAA,EAAM,sBAAA;AACrB,cAAA,CAAe,QAAA,EAAU,0BAAA;AACzB,iDAAA,cAAiC,CAAA;ADZjC;AACE;AACF,wCAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/minArrayLength.js","sourcesContent":[null,"import { guardException } from '../../exceptions';\nimport { ExceptionContext, RequiredValidation } from '../../commonTypes';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst minArrayLengthErrorMessage = 'The received value length is less than expected';\nconst minArrayLengthErrorKey = 'a:minArrayLength';\n\n/**\n * @description Asserts that the length of na array is not less than a specified minimum length.\n * @param {number} expected The minimum required length for the array.\n * @returns {RequiredValidation} A validation function that takes a received array and an exception context.\n * @throws {ValidationError} if the length of the received value is less than the expected length.\n * @example\n * const schema = array(string()).custom(minArrayLength(3));\n * parseOrFail(schema, ['short', 'array']);    // Throws an error: 'The received value length is less than expected'\n * parseOrFail(schema, ['adequate', 'array', 'length']); // Valid\n * parseOrFail(schema, ['adequate', 'array', 'length', 'test']); // Valid\n *\n * @translation Error Translation Key = 'a:minArrayLength'\n */\nexport const minArrayLength =\n  (expected: number): RequiredValidation =>\n  (received: unknown[], ctx: ExceptionContext) => {\n    if (received.length < expected) guardException(expected, received, ctx, minArrayLengthErrorMessage);\n  };\n\nminArrayLength.key = minArrayLengthErrorKey;\nminArrayLength.message = minArrayLengthErrorMessage;\nsetToDefaultLocale(minArrayLength);\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/array/minArrayLength.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,yDAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/array/minArrayLength.js"}

package/lib/asserts/array/minArrayLength.mjs

@@ -1,19 +1,8 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-H32B3NHW.mjs";
-import {
-  guardException
-} from "../../chunk-FGZKNBDP.mjs";
-
-// src/asserts/array/minArrayLength.ts
-var minArrayLengthErrorMessage = "The received value length is less than expected";
-var minArrayLengthErrorKey = "a:minArrayLength";
-var minArrayLength = (expected) => (received, ctx) => {
-  if (received.length < expected) guardException(expected, received, ctx, minArrayLengthErrorMessage);
-};
-minArrayLength.key = minArrayLengthErrorKey;
-minArrayLength.message = minArrayLengthErrorMessage;
-setToDefaultLocale(minArrayLength);
+  minArrayLength
+} from "../../chunk-YDTQASAY.mjs";
+import "../../chunk-OE3L7EKN.mjs";
+import "../../chunk-ZTCXXAKD.mjs";
 export {
   minArrayLength
 };

package/lib/asserts/array/minArrayLength.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/array/minArrayLength.ts"],"sourcesContent":["import { guardException } from '../../exceptions';\nimport { ExceptionContext, RequiredValidation } from '../../commonTypes';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst minArrayLengthErrorMessage = 'The received value length is less than expected';\nconst minArrayLengthErrorKey = 'a:minArrayLength';\n\n/**\n * @description Asserts that the length of na array is not less than a specified minimum length.\n * @param {number} expected The minimum required length for the array.\n * @returns {RequiredValidation} A validation function that takes a received array and an exception context.\n * @throws {ValidationError} if the length of the received value is less than the expected length.\n * @example\n * const schema = array(string()).custom(minArrayLength(3));\n * parseOrFail(schema, ['short', 'array']);    // Throws an error: 'The received value length is less than expected'\n * parseOrFail(schema, ['adequate', 'array', 'length']); // Valid\n * parseOrFail(schema, ['adequate', 'array', 'length', 'test']); // Valid\n *\n * @translation Error Translation Key = 'a:minArrayLength'\n */\nexport const minArrayLength =\n  (expected: number): RequiredValidation =>\n  (received: unknown[], ctx: ExceptionContext) => {\n    if (received.length < expected) guardException(expected, received, ctx, minArrayLengthErrorMessage);\n  };\n\nminArrayLength.key = minArrayLengthErrorKey;\nminArrayLength.message = minArrayLengthErrorMessage;\nsetToDefaultLocale(minArrayLength);\n"],"mappings":";;;;;;;;AAIA,IAAM,6BAA6B;AACnC,IAAM,yBAAyB;AAexB,IAAM,iBACX,CAAC,aACD,CAAC,UAAqB,QAA0B;AAC9C,MAAI,SAAS,SAAS,SAAU,gBAAe,UAAU,UAAU,KAAK,0BAA0B;AACpG;AAEF,eAAe,MAAM;AACrB,eAAe,UAAU;AACzB,mBAAmB,cAAc;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.mjs';
+import { RequiredValidation } from '../../core.mjs';
+import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
 
 /**
  * @description Asserts that a bigint value does not exceed a specified maximum value.

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

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.js';
+import { RequiredValidation } from '../../core.js';
+import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
 
 /**
  * @description Asserts that a bigint value does not exceed a specified maximum value.

package/lib/asserts/bigint/bigintMax.js

@@ -1,20 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk5YYRBKDPjs = require('../../chunk-5YYRBKDP.js');
+var _chunkLXZTBF7Fjs = require('../../chunk-LXZTBF7F.js');
+require('../../chunk-TJQ5NVL4.js');
+require('../../chunk-FIDPCCCW.js');
 
 
-var _chunk5P6AZJCNjs = require('../../chunk-5P6AZJCN.js');
-
-// src/asserts/bigint/bigintMax.ts
-var bigintMaxErrorMessage = "The received value is greater than expected";
-var bigintMaxErrorKey = "bi:max";
-var bigintMax = (expected) => (received, ctx) => {
-  if (expected < received) _chunk5P6AZJCNjs.guardException.call(void 0, expected, received, ctx, bigintMaxErrorKey);
-};
-bigintMax.key = bigintMaxErrorKey;
-bigintMax.message = bigintMaxErrorMessage;
-_chunk5YYRBKDPjs.setToDefaultLocale.call(void 0, bigintMax);
-
-
-exports.bigintMax = bigintMax;
+exports.bigintMax = _chunkLXZTBF7Fjs.bigintMax;
 //# sourceMappingURL=bigintMax.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMax.js","../../../src/asserts/bigint/bigintMax.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC;AACE;AACF,0DAAgC;AAChC;AACA;ACHA,IAAM,sBAAA,EAAwB,6CAAA;AAC9B,IAAM,kBAAA,EAAoB,QAAA;AAenB,IAAM,UAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,QAAA,EAAkB,GAAA,EAAA,GAA0B;AAC3C,EAAA,GAAA,CAAI,SAAA,EAAW,QAAA,EAAU,6CAAA,QAAe,EAAU,QAAA,EAAU,GAAA,EAAK,iBAAiB,CAAA;AACpF,CAAA;AAEF,SAAA,CAAU,IAAA,EAAM,iBAAA;AAChB,SAAA,CAAU,QAAA,EAAU,qBAAA;AACpB,iDAAA,SAA4B,CAAA;ADZ5B;AACE;AACF,8BAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMax.js","sourcesContent":[null,"import { setToDefaultLocale } from '../../translationMap';\nimport { guardException } from '../../exceptions';\nimport { ExceptionContext, RequiredValidation } from '../../commonTypes';\n\nconst bigintMaxErrorMessage = 'The received value is greater than expected';\nconst bigintMaxErrorKey = 'bi:max';\n\n/**\n * @description Asserts that a bigint value does not exceed a specified maximum value.\n * @param {bigint} expected The maximum allowable value.\n * @returns {RequiredValidation} A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value exceeds the expected maximum value.\n * @example\n * const schema = bigint().custom(bigintMax(100n));\n * parseOrFail(schema, 99n);  // Valid\n * parseOrFail(schema, 100n); // Valid\n * parseOrFail(schema, 101n); // Throws an error: 'The received value is greater than expected'\n *\n * @translation Error Translation Key = 'bi:max'\n */\nexport const bigintMax =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected < received) guardException(expected, received, ctx, bigintMaxErrorKey);\n  };\n\nbigintMax.key = bigintMaxErrorKey;\nbigintMax.message = bigintMaxErrorMessage;\nsetToDefaultLocale(bigintMax);\n"]}
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMax.js"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC,mCAAgC;AAChC,mCAAgC;AAChC;AACE;AACF,+CAAC","file":"/home/runner/work/bguard/bguard/lib/asserts/bigint/bigintMax.js"}

package/lib/asserts/bigint/bigintMax.mjs

@@ -1,19 +1,8 @@
 import {
-  setToDefaultLocale
-} from "../../chunk-H32B3NHW.mjs";
-import {
-  guardException
-} from "../../chunk-FGZKNBDP.mjs";
-
-// src/asserts/bigint/bigintMax.ts
-var bigintMaxErrorMessage = "The received value is greater than expected";
-var bigintMaxErrorKey = "bi:max";
-var bigintMax = (expected) => (received, ctx) => {
-  if (expected < received) guardException(expected, received, ctx, bigintMaxErrorKey);
-};
-bigintMax.key = bigintMaxErrorKey;
-bigintMax.message = bigintMaxErrorMessage;
-setToDefaultLocale(bigintMax);
+  bigintMax
+} from "../../chunk-QEG24G7E.mjs";
+import "../../chunk-OE3L7EKN.mjs";
+import "../../chunk-ZTCXXAKD.mjs";
 export {
   bigintMax
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/asserts/bigint/bigintMax.ts"],"sourcesContent":["import { setToDefaultLocale } from '../../translationMap';\nimport { guardException } from '../../exceptions';\nimport { ExceptionContext, RequiredValidation } from '../../commonTypes';\n\nconst bigintMaxErrorMessage = 'The received value is greater than expected';\nconst bigintMaxErrorKey = 'bi:max';\n\n/**\n * @description Asserts that a bigint value does not exceed a specified maximum value.\n * @param {bigint} expected The maximum allowable value.\n * @returns {RequiredValidation} A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value exceeds the expected maximum value.\n * @example\n * const schema = bigint().custom(bigintMax(100n));\n * parseOrFail(schema, 99n);  // Valid\n * parseOrFail(schema, 100n); // Valid\n * parseOrFail(schema, 101n); // Throws an error: 'The received value is greater than expected'\n *\n * @translation Error Translation Key = 'bi:max'\n */\nexport const bigintMax =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected < received) guardException(expected, received, ctx, bigintMaxErrorKey);\n  };\n\nbigintMax.key = bigintMaxErrorKey;\nbigintMax.message = bigintMaxErrorMessage;\nsetToDefaultLocale(bigintMax);\n"],"mappings":";;;;;;;;AAIA,IAAM,wBAAwB;AAC9B,IAAM,oBAAoB;AAenB,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,QAA0B;AAC3C,MAAI,WAAW,SAAU,gBAAe,UAAU,UAAU,KAAK,iBAAiB;AACpF;AAEF,UAAU,MAAM;AAChB,UAAU,UAAU;AACpB,mBAAmB,SAAS;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.mjs';
+import { RequiredValidation } from '../../core.mjs';
+import '../../commonTypes.mjs';
+import '../../InferType.mjs';
+import '../../helpers/constants.mjs';
 
 /**
  * @description - Asserts that a bigint value is strictly less than a specified maximum value (i.e., the maximum value is excluded).

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

@@ -1,4 +1,7 @@
-import { RequiredValidation } from '../../commonTypes.js';
+import { RequiredValidation } from '../../core.js';
+import '../../commonTypes.js';
+import '../../InferType.js';
+import '../../helpers/constants.js';
 
 /**
  * @description - Asserts that a bigint value is strictly less than a specified maximum value (i.e., the maximum value is excluded).