bguard 0.4.0 → 0.5.0

package/README.md

@@ -11,12 +11,12 @@ Table of contents
  * [Usage](#h3_usage)
     * [Defining a Schema](#h4_usage_defining_a_schema)
     * [Inferring TypeScript Types](#h4_usage_inferring_typescript_types)
-    * [Generating TypeScript Types with `codeGen`](#h4_usage_generating_typescript_types_with_codeGen)
-    * [Generating Named TypeScript Types with `codeGenWithName`](#h4_usage_generating_typescript_types_with_codeGenWithName)
+    * [Generating TypeScript Types with `codeGen`](#h4_usage_generating_typescript_types_with_codegen)
+    * [Generating Named TypeScript Types with `codeGenWithName`](#h4_usage_generating_typescript_types_with_codegenwithname)
     * [Summary:](#h4_usage_summary)
  * [Validating Data](#h3_validating_data)
     * [`parse` Method](#h4_validating_data_parse)
-    * [`parseOrFail` Method](#h4_validating_data_parseOrFail)
+    * [`parseOrFail` Method](#h4_validating_data_parseorfail)
  * [Chaining Methods](#h3_chaining_methods)
     * [nullable()](#h4_chaining_nullable)
     * [optional()](#h4_chaining_optional)
@@ -32,52 +32,52 @@ Table of contents
  * [Built-in Custom Assert Documentation](#builtin_custom_assert_documentation) 
 
      * [string](#assertdir_string)
-          * [atLeastOneDigit](#assert_atLeastOneDigit_string)
-          * [atLeastOneLowerChar](#assert_atLeastOneLowerChar_string)
-          * [atLeastOneSpecialChar](#assert_atLeastOneSpecialChar_string)
-          * [atLeastOneUpperChar](#assert_atLeastOneUpperChar_string)
+          * [atLeastOneDigit](#assert_atleastonedigit_string)
+          * [atLeastOneLowerChar](#assert_atleastonelowerchar_string)
+          * [atLeastOneSpecialChar](#assert_atleastonespecialchar_string)
+          * [atLeastOneUpperChar](#assert_atleastoneupperchar_string)
           * [contains](#assert_contains_string)
           * [email](#assert_email_string)
-          * [endsWith](#assert_endsWith_string)
-          * [isValidDate](#assert_isValidDate_string)
-          * [isValidDateTime](#assert_isValidDateTime_string)
-          * [isValidTime](#assert_isValidTime_string)
-          * [lowerCase](#assert_lowerCase_string)
-          * [maxLength](#assert_maxLength_string)
-          * [minLength](#assert_minLength_string)
-          * [regExp](#assert_regExp_string)
-          * [startsWith](#assert_startsWith_string)
-          * [upperCase](#assert_upperCase_string)
+          * [endsWith](#assert_endswith_string)
+          * [isValidDate](#assert_isvaliddate_string)
+          * [isValidDateTime](#assert_isvaliddatetime_string)
+          * [isValidTime](#assert_isvalidtime_string)
+          * [lowerCase](#assert_lowercase_string)
+          * [maxLength](#assert_maxlength_string)
+          * [minLength](#assert_minlength_string)
+          * [regExp](#assert_regexp_string)
+          * [startsWith](#assert_startswith_string)
+          * [upperCase](#assert_uppercase_string)
           * [uuid](#assert_uuid_string)
-          * [uuidV1](#assert_uuidV1_string)
-          * [uuidV2](#assert_uuidV2_string)
-          * [uuidV3](#assert_uuidV3_string)
-          * [uuidV4](#assert_uuidV4_string)
-          * [uuidV5](#assert_uuidV5_string)
-          * [validUrl](#assert_validUrl_string)
+          * [uuidV1](#assert_uuidv1_string)
+          * [uuidV2](#assert_uuidv2_string)
+          * [uuidV3](#assert_uuidv3_string)
+          * [uuidV4](#assert_uuidv4_string)
+          * [uuidV5](#assert_uuidv5_string)
+          * [validUrl](#assert_validurl_string)
      * [number](#assertdir_number)
           * [max](#assert_max_number)
-          * [maxExcluded](#assert_maxExcluded_number)
+          * [maxExcluded](#assert_maxexcluded_number)
           * [min](#assert_min_number)
-          * [minExcluded](#assert_minExcluded_number)
+          * [minExcluded](#assert_minexcluded_number)
           * [negative](#assert_negative_number)
           * [positive](#assert_positive_number)
      * [array](#assertdir_array)
-          * [maxArrayLength](#assert_maxArrayLength_array)
-          * [minArrayLength](#assert_minArrayLength_array)
+          * [maxArrayLength](#assert_maxarraylength_array)
+          * [minArrayLength](#assert_minarraylength_array)
      * [bigint](#assertdir_bigint)
-          * [bigintMax](#assert_bigintMax_bigint)
-          * [bigintMaxExcluded](#assert_bigintMaxExcluded_bigint)
-          * [bigintMin](#assert_bigintMin_bigint)
-          * [bigintMinExcluded](#assert_bigintMinExcluded_bigint)
+          * [bigintMax](#assert_bigintmax_bigint)
+          * [bigintMaxExcluded](#assert_bigintmaxexcluded_bigint)
+          * [bigintMin](#assert_bigintmin_bigint)
+          * [bigintMinExcluded](#assert_bigintminexcluded_bigint)
      * [date](#assertdir_date)
-          * [dateMax](#assert_dateMax_date)
-          * [dateMin](#assert_dateMin_date)
+          * [dateMax](#assert_datemax_date)
+          * [dateMin](#assert_datemin_date)
      * [mix](#assertdir_mix)
-          * [equalTo](#assert_equalTo_mix)
-          * [oneOfValues](#assert_oneOfValues_mix)
+          * [equalTo](#assert_equalto_mix)
+          * [oneOfValues](#assert_oneofvalues_mix)
      * [object](#assertdir_object)
-          * [maxKeys](#assert_maxKeys_object)
+          * [maxKeys](#assert_maxkeys_object)
 
 ### <a id="h3_features"> Features </a>
 
@@ -158,7 +158,7 @@ type StudentSchema = {
 
 ```
 
-#### <a id="h4_usage_generating_typescript_types_with_codeGen"> Generating TypeScript Types with `codeGen` </a>
+#### <a id="h4_usage_generating_typescript_types_with_codegen"> Generating TypeScript Types with `codeGen` </a>
 
 If you prefer to generate TypeScript types as a string, you can use the `codeGen` function:
 
@@ -193,7 +193,7 @@ This would output a string:
 
 > **Notice:** The returned string does not include a type name or the `=` symbol. You would need to add these manually if you want a complete type definition.
 
-#### <a id="h4_usage_generating_typescript_types_with_codeGenWithName"> Generating Named TypeScript Types with `codeGenWithName` </a>
+#### <a id="h4_usage_generating_typescript_types_with_codegenwithname"> Generating Named TypeScript Types with `codeGenWithName` </a>
 
 For convenience, if you want to generate a complete type definition including a name, use the `codeGenWithName` function:
 
@@ -290,7 +290,7 @@ Options:
 - `lng`: Specifies the language for error messages. Default is `'default'`.
 - `getAllErrors`: If `true`, collects all validation errors. If `false` or `undefined`, stops at the first error. Turning off `getAllErrors` provides a runtime optimization, as it stops validation at the first error, avoiding unnecessary checks for the remaining received value.
 
-#### <a id="h4_validating_data_parseOrFail"> `parseOrFail` Method </a>
+#### <a id="h4_validating_data_parseorfail"> `parseOrFail` Method </a>
 
 The `parseOrFail` method validates the data and throws an error on the first validation failure. It is useful when you want to halt processing immediately upon encountering an error.
 
@@ -459,8 +459,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 +469,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 +484,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`.
@@ -628,7 +640,7 @@ import { string } from 'bguard/string';
 ```
    
         
-##### <a id="assert_atLeastOneDigit_string"> atLeastOneDigit </a>
+##### <a id="assert_atleastonedigit_string"> atLeastOneDigit </a>
         
 ```typescript
 import { atLeastOneDigit } from 'bguard/string/atLeastOneDigit';
@@ -645,7 +657,7 @@ import { atLeastOneDigit } from 'bguard/string/atLeastOneDigit';
 * _See_ Error Translation Key = 's:atLeastOneDigit'
         
         
-##### <a id="assert_atLeastOneLowerChar_string"> atLeastOneLowerChar </a>
+##### <a id="assert_atleastonelowerchar_string"> atLeastOneLowerChar </a>
         
 ```typescript
 import { atLeastOneLowerChar } from 'bguard/string/atLeastOneLowerChar';
@@ -662,14 +674,14 @@ import { atLeastOneLowerChar } from 'bguard/string/atLeastOneLowerChar';
 * _See_ Error Translation Key = 's:atLeastOneLowerChar'
         
         
-##### <a id="assert_atLeastOneSpecialChar_string"> atLeastOneSpecialChar </a>
+##### <a id="assert_atleastonespecialchar_string"> atLeastOneSpecialChar </a>
         
 ```typescript
 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
@@ -684,7 +696,7 @@ import { atLeastOneSpecialChar } from 'bguard/string/atLeastOneSpecialChar';
 * _See_ Error Translation Key = 's:atLeastOneSpecialChar'
         
         
-##### <a id="assert_atLeastOneUpperChar_string"> atLeastOneUpperChar </a>
+##### <a id="assert_atleastoneupperchar_string"> atLeastOneUpperChar </a>
         
 ```typescript
 import { atLeastOneUpperChar } from 'bguard/string/atLeastOneUpperChar';
@@ -736,7 +748,7 @@ import { email } from 'bguard/string/email';
 * _See_ - Error Translation Key = 's:email'
         
         
-##### <a id="assert_endsWith_string"> endsWith </a>
+##### <a id="assert_endswith_string"> endsWith </a>
         
 ```typescript
 import { endsWith } from 'bguard/string/endsWith';
@@ -754,7 +766,7 @@ import { endsWith } from 'bguard/string/endsWith';
 * _See_ Error Translation Key = 's:endsWith'
         
         
-##### <a id="assert_isValidDate_string"> isValidDate </a>
+##### <a id="assert_isvaliddate_string"> isValidDate </a>
         
 ```typescript
 import { isValidDate } from 'bguard/string/isValidDate';
@@ -772,7 +784,7 @@ import { isValidDate } from 'bguard/string/isValidDate';
 * _See_ Error Translation Key = 's:isValidDate'
         
         
-##### <a id="assert_isValidDateTime_string"> isValidDateTime </a>
+##### <a id="assert_isvaliddatetime_string"> isValidDateTime </a>
         
 ```typescript
 import { isValidDateTime } from 'bguard/string/isValidDateTime';
@@ -800,7 +812,7 @@ import { isValidDateTime } from 'bguard/string/isValidDateTime';
 * _See_ Error Translation Key = 's:isValidDateTime'
         
         
-##### <a id="assert_isValidTime_string"> isValidTime </a>
+##### <a id="assert_isvalidtime_string"> isValidTime </a>
         
 ```typescript
 import { isValidTime } from 'bguard/string/isValidTime';
@@ -823,7 +835,7 @@ import { isValidTime } from 'bguard/string/isValidTime';
 * _See_ Error Translation Key = 's:isValidTime'
         
         
-##### <a id="assert_lowerCase_string"> lowerCase </a>
+##### <a id="assert_lowercase_string"> lowerCase </a>
         
 ```typescript
 import { lowerCase } from 'bguard/string/lowerCase';
@@ -840,7 +852,7 @@ import { lowerCase } from 'bguard/string/lowerCase';
 * _See_ Error Translation Key = 's:lowerCase'
         
         
-##### <a id="assert_maxLength_string"> maxLength </a>
+##### <a id="assert_maxlength_string"> maxLength </a>
         
 ```typescript
 import { maxLength } from 'bguard/string/maxLength';
@@ -858,7 +870,7 @@ import { maxLength } from 'bguard/string/maxLength';
 * _See_ Error Translation Key = 's:maxLength'
         
         
-##### <a id="assert_minLength_string"> minLength </a>
+##### <a id="assert_minlength_string"> minLength </a>
         
 ```typescript
 import { minLength } from 'bguard/string/minLength';
@@ -876,7 +888,7 @@ import { minLength } from 'bguard/string/minLength';
 * _See_ Error Translation Key = 's:minLength'
         
         
-##### <a id="assert_regExp_string"> regExp </a>
+##### <a id="assert_regexp_string"> regExp </a>
         
 ```typescript
 import { regExp } from 'bguard/string/regExp';
@@ -894,7 +906,7 @@ import { regExp } from 'bguard/string/regExp';
 * _See_ Error Translation Key = 's:regExp'
         
         
-##### <a id="assert_startsWith_string"> startsWith </a>
+##### <a id="assert_startswith_string"> startsWith </a>
         
 ```typescript
 import { startsWith } from 'bguard/string/startsWith';
@@ -912,7 +924,7 @@ import { startsWith } from 'bguard/string/startsWith';
 * _See_ Error Translation Key = 's:startsWith'
         
         
-##### <a id="assert_upperCase_string"> upperCase </a>
+##### <a id="assert_uppercase_string"> upperCase </a>
         
 ```typescript
 import { upperCase } from 'bguard/string/upperCase';
@@ -947,7 +959,7 @@ import { uuid } from 'bguard/string/uuid';
 * _See_ Error Translation Key = 's:uuid'
         
         
-##### <a id="assert_uuidV1_string"> uuidV1 </a>
+##### <a id="assert_uuidv1_string"> uuidV1 </a>
         
 ```typescript
 import { uuidV1 } from 'bguard/string/uuidV1';
@@ -965,7 +977,7 @@ import { uuidV1 } from 'bguard/string/uuidV1';
 * _See_ Error Translation Key = 's:uuidV1'
         
         
-##### <a id="assert_uuidV2_string"> uuidV2 </a>
+##### <a id="assert_uuidv2_string"> uuidV2 </a>
         
 ```typescript
 import { uuidV2 } from 'bguard/string/uuidV2';
@@ -983,7 +995,7 @@ import { uuidV2 } from 'bguard/string/uuidV2';
 * _See_ Error Translation Key = 's:uuidV2'
         
         
-##### <a id="assert_uuidV3_string"> uuidV3 </a>
+##### <a id="assert_uuidv3_string"> uuidV3 </a>
         
 ```typescript
 import { uuidV3 } from 'bguard/string/uuidV3';
@@ -1001,7 +1013,7 @@ import { uuidV3 } from 'bguard/string/uuidV3';
 * _See_ Error Translation Key = 's:uuidV3'
         
         
-##### <a id="assert_uuidV4_string"> uuidV4 </a>
+##### <a id="assert_uuidv4_string"> uuidV4 </a>
         
 ```typescript
 import { uuidV4 } from 'bguard/string/uuidV4';
@@ -1021,7 +1033,7 @@ import { uuidV4 } from 'bguard/string/uuidV4';
 * _See_ Error Translation Key = 's:uuidV4'
         
         
-##### <a id="assert_uuidV5_string"> uuidV5 </a>
+##### <a id="assert_uuidv5_string"> uuidV5 </a>
         
 ```typescript
 import { uuidV5 } from 'bguard/string/uuidV5';
@@ -1039,7 +1051,7 @@ import { uuidV5 } from 'bguard/string/uuidV5';
 * _See_ Error Translation Key = 's:uuidV5'
         
         
-##### <a id="assert_validUrl_string"> validUrl </a>
+##### <a id="assert_validurl_string"> validUrl </a>
         
 ```typescript
 import { validUrl } from 'bguard/string/validUrl';
@@ -1094,7 +1106,7 @@ import { max } from 'bguard/number/max';
 * _See_ Error Translation Key = 'n:max'
         
         
-##### <a id="assert_maxExcluded_number"> maxExcluded </a>
+##### <a id="assert_maxexcluded_number"> maxExcluded </a>
         
 ```typescript
 import { maxExcluded } from 'bguard/number/maxExcluded';
@@ -1132,7 +1144,7 @@ import { min } from 'bguard/number/min';
 * _See_ Error Translation Key = 'n:min'
         
         
-##### <a id="assert_minExcluded_number"> minExcluded </a>
+##### <a id="assert_minexcluded_number"> minExcluded </a>
         
 ```typescript
 import { minExcluded } from 'bguard/number/minExcluded';
@@ -1205,7 +1217,7 @@ import { array } from 'bguard/array';
 ```
    
         
-##### <a id="assert_maxArrayLength_array"> maxArrayLength </a>
+##### <a id="assert_maxarraylength_array"> maxArrayLength </a>
         
 ```typescript
 import { maxArrayLength } from 'bguard/array/maxArrayLength';
@@ -1224,7 +1236,7 @@ import { maxArrayLength } from 'bguard/array/maxArrayLength';
 * _See_ Error Translation Key = 'a:maxArrayLength'
         
         
-##### <a id="assert_minArrayLength_array"> minArrayLength </a>
+##### <a id="assert_minarraylength_array"> minArrayLength </a>
         
 ```typescript
 import { minArrayLength } from 'bguard/array/minArrayLength';
@@ -1260,7 +1272,7 @@ import { bigint } from 'bguard/bigint';
 ```
    
         
-##### <a id="assert_bigintMax_bigint"> bigintMax </a>
+##### <a id="assert_bigintmax_bigint"> bigintMax </a>
         
 ```typescript
 import { bigintMax } from 'bguard/bigint/bigintMax';
@@ -1279,7 +1291,7 @@ import { bigintMax } from 'bguard/bigint/bigintMax';
 * _See_ Error Translation Key = 'bi:max'
         
         
-##### <a id="assert_bigintMaxExcluded_bigint"> bigintMaxExcluded </a>
+##### <a id="assert_bigintmaxexcluded_bigint"> bigintMaxExcluded </a>
         
 ```typescript
 import { bigintMaxExcluded } from 'bguard/bigint/bigintMaxExcluded';
@@ -1298,7 +1310,7 @@ import { bigintMaxExcluded } from 'bguard/bigint/bigintMaxExcluded';
 * _See_ Error Translation Key = 'bi:maxExcluded'
         
         
-##### <a id="assert_bigintMin_bigint"> bigintMin </a>
+##### <a id="assert_bigintmin_bigint"> bigintMin </a>
         
 ```typescript
 import { bigintMin } from 'bguard/bigint/bigintMin';
@@ -1317,7 +1329,7 @@ import { bigintMin } from 'bguard/bigint/bigintMin';
 * _See_ Error Translation Key = 'bi:min'
         
         
-##### <a id="assert_bigintMinExcluded_bigint"> bigintMinExcluded </a>
+##### <a id="assert_bigintminexcluded_bigint"> bigintMinExcluded </a>
         
 ```typescript
 import { bigintMinExcluded } from 'bguard/bigint/bigintMinExcluded';
@@ -1352,7 +1364,7 @@ import { date } from 'bguard/date';
 ```
    
         
-##### <a id="assert_dateMax_date"> dateMax </a>
+##### <a id="assert_datemax_date"> dateMax </a>
         
 ```typescript
 import { dateMax } from 'bguard/date/dateMax';
@@ -1371,7 +1383,7 @@ import { dateMax } from 'bguard/date/dateMax';
 * _See_ Error Translation Key = 'dt:max'
         
         
-##### <a id="assert_dateMin_date"> dateMin </a>
+##### <a id="assert_datemin_date"> dateMin </a>
         
 ```typescript
 import { dateMin } from 'bguard/date/dateMin';
@@ -1410,7 +1422,7 @@ import { oneOfTypes } from 'bguard/mix';
 ```
    
         
-##### <a id="assert_equalTo_mix"> equalTo </a>
+##### <a id="assert_equalto_mix"> equalTo </a>
         
 ```typescript
 import { equalTo } from 'bguard/mix/equalTo';
@@ -1429,7 +1441,7 @@ import { equalTo } from 'bguard/mix/equalTo';
 * _See_ Error Translation Key = 'm:equalTo'
         
         
-##### <a id="assert_oneOfValues_mix"> oneOfValues </a>
+##### <a id="assert_oneofvalues_mix"> oneOfValues </a>
         
 ```typescript
 import { oneOfValues } from 'bguard/mix/oneOfValues';
@@ -1470,7 +1482,7 @@ import { object } from 'bguard/object';
 ```
    
         
-##### <a id="assert_maxKeys_object"> maxKeys </a>
+##### <a id="assert_maxkeys_object"> maxKeys </a>
         
 ```typescript
 import { maxKeys } from 'bguard/object/maxKeys';
@@ -1497,4 +1509,4 @@ import { maxKeys } from 'bguard/object/maxKeys';
 * _See_ Error Translation Key = 'o:maxKeys'
         
 ### Contributing
-Contributions are welcome! Please open an issue or submit a pull request for any bugs or feature requests.
+Contributions are welcome! Please open an issue or submit a pull request for any bugs or feature requests.

package/lib/{CommonSchema-wi9MOXGF.d.mts → CommonSchema-BIfYCtcQ.d.mts}

@@ -1,8 +1,8 @@
+import { ExceptionContext, RequiredValidation } from './ExceptionContext.mjs';
 import { InferType } from './InferType.mjs';
-import { ExceptionContext, BaseType, RequiredValidation, MetaContext, TransformCallback, WithNull, WithUndefined } from './commonTypes.mjs';
+import { BaseType, MetaContext, TransformCallback, WithNull, WithUndefined } from './commonTypes.mjs';
 
 declare const ctxSymbol: unique symbol;
-
 declare function innerCheck(schema: CommonSchema, receivedValue: unknown, exCtx: ExceptionContext): unknown;
 
 type ObjectShapeSchemaType = Record<string, CommonSchema>;

package/lib/{CommonSchema-DOh3bsL-.d.ts → CommonSchema-DIDMH9R7.d.ts}

@@ -1,8 +1,8 @@
+import { ExceptionContext, RequiredValidation } from './ExceptionContext.js';
 import { InferType } from './InferType.js';
-import { ExceptionContext, BaseType, RequiredValidation, MetaContext, TransformCallback, WithNull, WithUndefined } from './commonTypes.js';
+import { BaseType, MetaContext, TransformCallback, WithNull, WithUndefined } from './commonTypes.js';
 
 declare const ctxSymbol: unique symbol;
-
 declare function innerCheck(schema: CommonSchema, receivedValue: unknown, exCtx: ExceptionContext): unknown;
 
 type ObjectShapeSchemaType = Record<string, CommonSchema>;

package/lib/ExceptionContext.d.mts

@@ -0,0 +1,16 @@
+import { TranslationErrorMap, ValidationErrorData, MetaContext } from './commonTypes.mjs';
+
+declare class ExceptionContext {
+    readonly initialReceived: unknown;
+    readonly t: TranslationErrorMap;
+    readonly pathToError: string;
+    readonly errors?: ValidationErrorData[] | undefined;
+    readonly meta?: MetaContext | undefined;
+    constructor(initialReceived: unknown, t: TranslationErrorMap, pathToError: string, errors?: ValidationErrorData[] | undefined, meta?: MetaContext | undefined);
+    createChild(childPathToError: string, childMeta?: MetaContext): ExceptionContext;
+    ref(path: string): unknown;
+    addIssue(expected: unknown, received: unknown, messageKey: string): never | void;
+}
+type RequiredValidation = (received: any, ctx: ExceptionContext) => void;
+
+export { ExceptionContext, type RequiredValidation };

package/lib/ExceptionContext.d.ts

@@ -0,0 +1,16 @@
+import { TranslationErrorMap, ValidationErrorData, MetaContext } from './commonTypes.js';
+
+declare class ExceptionContext {
+    readonly initialReceived: unknown;
+    readonly t: TranslationErrorMap;
+    readonly pathToError: string;
+    readonly errors?: ValidationErrorData[] | undefined;
+    readonly meta?: MetaContext | undefined;
+    constructor(initialReceived: unknown, t: TranslationErrorMap, pathToError: string, errors?: ValidationErrorData[] | undefined, meta?: MetaContext | undefined);
+    createChild(childPathToError: string, childMeta?: MetaContext): ExceptionContext;
+    ref(path: string): unknown;
+    addIssue(expected: unknown, received: unknown, messageKey: string): never | void;
+}
+type RequiredValidation = (received: any, ctx: ExceptionContext) => void;
+
+export { ExceptionContext, type RequiredValidation };

package/lib/ExceptionContext.js

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkPQ4GCO3Qjs = require('./chunk-PQ4GCO3Q.js');
+require('./chunk-EXVTHIT5.js');
+require('./chunk-PE55R4KH.js');
+require('./chunk-VBTWYDEM.js');
+require('./chunk-FIDPCCCW.js');
+
+
+exports.ExceptionContext = _chunkPQ4GCO3Qjs.ExceptionContext;
+//# sourceMappingURL=ExceptionContext.js.map

package/lib/ExceptionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/ExceptionContext.js"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACF,6DAAC","file":"/home/runner/work/bguard/bguard/lib/ExceptionContext.js"}

package/lib/ExceptionContext.mjs

@@ -0,0 +1,11 @@
+import {
+  ExceptionContext
+} from "./chunk-IFQLPXCZ.mjs";
+import "./chunk-QWPHP26D.mjs";
+import "./chunk-MQRXWXHP.mjs";
+import "./chunk-YBVMP4EI.mjs";
+import "./chunk-ZTCXXAKD.mjs";
+export {
+  ExceptionContext
+};
+//# sourceMappingURL=ExceptionContext.mjs.map

package/lib/ExceptionContext.mjs.map

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

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

@@ -1,6 +1,7 @@
 import { WithArray } from '../../commonTypes.mjs';
 import { ArraySchema } from '../../schemas/ArraySchema.mjs';
-import { C as CommonSchema } from '../../CommonSchema-wi9MOXGF.mjs';
+import { C as CommonSchema } from '../../CommonSchema-BIfYCtcQ.mjs';
+import '../../ExceptionContext.mjs';
 import '../../InferType.mjs';
 
 /**

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

@@ -1,6 +1,7 @@
 import { WithArray } from '../../commonTypes.js';
 import { ArraySchema } from '../../schemas/ArraySchema.js';
-import { C as CommonSchema } from '../../CommonSchema-DOh3bsL-.js';
+import { C as CommonSchema } from '../../CommonSchema-DIDMH9R7.js';
+import '../../ExceptionContext.js';
 import '../../InferType.js';
 
 /**

package/lib/asserts/array/index.js

@@ -1,16 +1,16 @@
 "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 _chunkP4Q22AZAjs = require('../../chunk-P4Q22AZA.js');
+require('../../chunk-MMWS3SXR.js');
+require('../../chunk-PQ4GCO3Q.js');
+require('../../chunk-EXVTHIT5.js');
+require('../../chunk-PE55R4KH.js');
 require('../../chunk-VBTWYDEM.js');
-require('../../chunk-5YYRBKDP.js');
-require('../../chunk-5P6AZJCN.js');
+require('../../chunk-FIDPCCCW.js');
 
 // src/asserts/array/index.ts
 function array(arraySchema) {
-  return new (0, _chunkVW4RMQD4js.ArraySchema)({ type: [], requiredValidations: [] }, arraySchema);
+  return new (0, _chunkP4Q22AZAjs.ArraySchema)({ type: [], requiredValidations: [] }, arraySchema);
 }
 
 

package/lib/asserts/array/index.mjs

@@ -1,12 +1,12 @@
 import {
   ArraySchema
-} from "../../chunk-LPR3G5T3.mjs";
-import "../../chunk-7NBOVYSP.mjs";
-import "../../chunk-TRGMD7LA.mjs";
-import "../../chunk-BNCT7NOR.mjs";
+} from "../../chunk-XG6K6N3A.mjs";
+import "../../chunk-UEYMBPZN.mjs";
+import "../../chunk-IFQLPXCZ.mjs";
+import "../../chunk-QWPHP26D.mjs";
+import "../../chunk-MQRXWXHP.mjs";
 import "../../chunk-YBVMP4EI.mjs";
-import "../../chunk-H32B3NHW.mjs";
-import "../../chunk-FGZKNBDP.mjs";
+import "../../chunk-ZTCXXAKD.mjs";
 
 // src/asserts/array/index.ts
 function array(arraySchema) {

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

@@ -1,4 +1,5 @@
-import { RequiredValidation } from '../../commonTypes.mjs';
+import { RequiredValidation } from '../../ExceptionContext.mjs';
+import '../../commonTypes.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,5 @@
-import { RequiredValidation } from '../../commonTypes.js';
+import { RequiredValidation } from '../../ExceptionContext.js';
+import '../../commonTypes.js';
 
 /**
  * @description Asserts that the length of an array is not greater than a specified maximum length.