bguard 0.5.0 → 0.6.0

package/lib/chunk-OU5BTUDV.mjs

@@ -0,0 +1,23 @@
+import {
+  setToDefaultLocale
+} from "./chunk-OE3L7EKN.mjs";
+
+// src/asserts/string/atLeastOneSpecialChar.ts
+var atLeastOneSpecialCharErrorMessage = "The received value does not contain at least one special character";
+var atLeastOneSpecialCharErrorKey = "s:atLeastOneSpecialChar";
+var atLeastOneSpecialChar = (allowedSpecialChars) => {
+  const specialCharRegExp = new RegExp(
+    `[${(allowedSpecialChars ?? "*@$!#%&()^~{}").replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&")}]`
+  );
+  return (received, ctx) => {
+    if (!specialCharRegExp.test(received)) ctx.addIssue("special character", received, atLeastOneSpecialCharErrorKey);
+  };
+};
+atLeastOneSpecialChar.key = atLeastOneSpecialCharErrorKey;
+atLeastOneSpecialChar.message = atLeastOneSpecialCharErrorMessage;
+setToDefaultLocale(atLeastOneSpecialChar);
+
+export {
+  atLeastOneSpecialChar
+};
+//# sourceMappingURL=chunk-OU5BTUDV.mjs.map

package/lib/chunk-OU5BTUDV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asserts/string/atLeastOneSpecialChar.ts"],"sourcesContent":["import type { ExceptionContext, RequiredValidation } from '../../core';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst atLeastOneSpecialCharErrorMessage = 'The received value does not contain at least one special character';\nconst atLeastOneSpecialCharErrorKey = 's:atLeastOneSpecialChar';\n\n/**\n * @description Asserts that a string value contains at least one special character.\n * @param {string} [allowedSpecialChars=*] The string containing allowed special characters. Defaults to '*@$!#%&()^~{}'.\n * @returns {RequiredValidation} A validation function that takes a received string and an exception context.\n * @throws {ValidationError} if the received value does not contain at least one of the allowed special characters.\n * @example\n * const schema = string().custom(atLeastOneSpecialChar()); // Default special characters\n * parseOrFail(schema, 'abc!def'); // Valid\n * parseOrFail(schema, 'abcdef');  // Throws an error: 'The received value does not contain at least one special character'\n *\n * const customSchema = string().custom(atLeastOneSpecialChar('@$')); // Custom special characters\n * parseOrFail(customSchema, 'abc@def'); // Valid\n * parseOrFail(customSchema, 'abcdef');  // Throws an error: 'The received value does not contain at least one special character'\n *\n * @translation Error Translation Key = 's:atLeastOneSpecialChar'\n */\nexport const atLeastOneSpecialChar = (allowedSpecialChars?: string): RequiredValidation => {\n  const specialCharRegExp = new RegExp(\n    `[${(allowedSpecialChars ?? '*@$!#%&()^~{}').replace(/[-/\\\\^$*+?.()|[\\]{}]/g, '\\\\$&')}]`,\n  );\n  return (received: string, ctx: ExceptionContext) => {\n    if (!specialCharRegExp.test(received)) ctx.addIssue('special character', received, atLeastOneSpecialCharErrorKey);\n  };\n};\n\natLeastOneSpecialChar.key = atLeastOneSpecialCharErrorKey;\natLeastOneSpecialChar.message = atLeastOneSpecialCharErrorMessage;\nsetToDefaultLocale(atLeastOneSpecialChar);\n"],"mappings":";;;;;AAGA,IAAM,oCAAoC;AAC1C,IAAM,gCAAgC;AAkB/B,IAAM,wBAAwB,CAAC,wBAAqD;AACzF,QAAM,oBAAoB,IAAI;AAAA,IAC5B,KAAK,uBAAuB,iBAAiB,QAAQ,yBAAyB,MAAM,CAAC;AAAA,EACvF;AACA,SAAO,CAAC,UAAkB,QAA0B;AAClD,QAAI,CAAC,kBAAkB,KAAK,QAAQ,EAAG,KAAI,SAAS,qBAAqB,UAAU,6BAA6B;AAAA,EAClH;AACF;AAEA,sBAAsB,MAAM;AAC5B,sBAAsB,UAAU;AAChC,mBAAmB,qBAAqB;","names":[]}

package/lib/chunk-OZ3BTSSQ.mjs

@@ -0,0 +1,64 @@
+import {
+  oneOfValues
+} from "./chunk-W3U7RYLP.mjs";
+import {
+  equalTo
+} from "./chunk-4ZKU4RJL.mjs";
+import {
+  _setStrictType
+} from "./chunk-THU5VBSO.mjs";
+import {
+  CommonSchema
+} from "./chunk-QIPGUTIG.mjs";
+import {
+  BuildSchemaError
+} from "./chunk-ZTCXXAKD.mjs";
+import {
+  ONLY_ONCE
+} from "./chunk-2ANPCB4O.mjs";
+
+// src/asserts/number/index.ts
+function number() {
+  return new NumberSchema({ type: ["number"], requiredValidations: [] });
+}
+var NumberSchema = class extends CommonSchema {
+  _number = 1;
+  limit;
+  /**
+   * @method equalTo
+   * @description Restricts the schema to exactly match the specified value and infers the literal value as the TypeScript type.
+   * @param expectedValue - The value that the schema must exactly match.
+   * @returns The schema instance restricted to the specified value, with the literal value inferred as the TypeScript type
+   * @example
+   * number().equalTo(42); // Infers the type 42
+   *
+   * @public
+   */
+  equalTo(expectedValue) {
+    if (this.limit) throw new BuildSchemaError(ONLY_ONCE);
+    this.limit = true;
+    _setStrictType(this, expectedValue);
+    return this.custom(equalTo(expectedValue));
+  }
+  /**
+   * @method oneOfValues
+   * @description Restricts the schema to match one of the specified values and infers the union of those values as the TypeScript type.
+   * @param expectedValues - An array of values that the schema can match.
+   * @returns The schema instance restricted to one of the specified values, with the union of those values inferred as the TypeScript type.
+   * @example
+   * number().oneOfValues([5, 7]); // Infers the type 5 | 7
+   *
+   * @public
+   */
+  oneOfValues(expectedValue) {
+    if (this.limit) throw new BuildSchemaError(ONLY_ONCE);
+    this.limit = true;
+    _setStrictType(this, expectedValue);
+    return this.custom(oneOfValues(expectedValue));
+  }
+};
+
+export {
+  number
+};
+//# sourceMappingURL=chunk-OZ3BTSSQ.mjs.map

package/lib/chunk-OZ3BTSSQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asserts/number/index.ts"],"sourcesContent":["import { WithBGuardType } from '../../commonTypes';\nimport { BuildSchemaError } from '../../exceptions';\nimport { ONLY_ONCE } from '../../helpers/constants';\nimport { CommonSchema } from '../../core';\nimport { _setStrictType } from '../../helpers/setStrictType';\nimport { equalTo } from '../mix/equalTo';\nimport { oneOfValues } from '../mix/oneOfValues';\n\n/**\n * @description Creates a new schema for validating number values.\n * @returns {NumberSchema} A new instance of `NumberSchema` for validating numbers.\n * @example\n * const schema = number();\n * parseOrFail(schema, 42); // Validates successfully\n * parseOrFail(schema, '42'); // Throws a validation error\n *\n * @instance Of NumberSchema\n */\nexport function number(): WithBGuardType<NumberSchema, number> {\n  return new NumberSchema({ type: ['number'], requiredValidations: [] }) as WithBGuardType<NumberSchema, number>;\n}\n\nclass NumberSchema extends CommonSchema {\n  protected _number = 1;\n  private limit: boolean | undefined;\n\n  /**\n   * @method equalTo\n   * @description Restricts the schema to exactly match the specified value and infers the literal value as the TypeScript type.\n   * @param expectedValue - The value that the schema must exactly match.\n   * @returns The schema instance restricted to the specified value, with the literal value inferred as the TypeScript type\n   * @example\n   * number().equalTo(42); // Infers the type 42\n   *\n   * @public\n   */\n  public equalTo<Y extends number>(expectedValue: Y): WithBGuardType<this, Y> {\n    if (this.limit) throw new BuildSchemaError(ONLY_ONCE);\n    this.limit = true;\n    _setStrictType(this, expectedValue);\n    return this.custom(equalTo(expectedValue)) as WithBGuardType<this, Y>;\n  }\n\n  /**\n   * @method oneOfValues\n   * @description Restricts the schema to match one of the specified values and infers the union of those values as the TypeScript type.\n   * @param expectedValues - An array of values that the schema can match.\n   * @returns The schema instance restricted to one of the specified values, with the union of those values inferred as the TypeScript type.\n   * @example\n   * number().oneOfValues([5, 7]); // Infers the type 5 | 7\n   *\n   * @public\n   */\n  public oneOfValues<Y extends number>(expectedValue: Y[]): WithBGuardType<this, Y> {\n    if (this.limit) throw new BuildSchemaError(ONLY_ONCE);\n    this.limit = true;\n    _setStrictType(this, expectedValue);\n    return this.custom(oneOfValues(expectedValue)) as WithBGuardType<this, Y>;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBO,SAAS,SAA+C;AAC7D,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,QAAQ,GAAG,qBAAqB,CAAC,EAAE,CAAC;AACvE;AAEA,IAAM,eAAN,cAA2B,aAAa;AAAA,EAC5B,UAAU;AAAA,EACZ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYD,QAA0B,eAA2C;AAC1E,QAAI,KAAK,MAAO,OAAM,IAAI,iBAAiB,SAAS;AACpD,SAAK,QAAQ;AACb,mBAAe,MAAM,aAAa;AAClC,WAAO,KAAK,OAAO,QAAQ,aAAa,CAAC;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYO,YAA8B,eAA6C;AAChF,QAAI,KAAK,MAAO,OAAM,IAAI,iBAAiB,SAAS;AACpD,SAAK,QAAQ;AACb,mBAAe,MAAM,aAAa;AAClC,WAAO,KAAK,OAAO,YAAY,aAAa,CAAC;AAAA,EAC/C;AACF;","names":[]}

package/lib/{chunk-32MKEBKR.js → chunk-PAV4SQQL.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEXVTHIT5js = require('./chunk-EXVTHIT5.js');
+var _chunkTJQ5NVL4js = require('./chunk-TJQ5NVL4.js');
 
 // src/asserts/mix/oneOfValues.ts
 var oneOfValuesErrorMessage = "The received value is not equal to expected";
@@ -10,9 +10,9 @@ var oneOfValues = (expected) => (received, ctx) => {
 };
 oneOfValues.key = oneOfValuesErrorKey;
 oneOfValues.message = oneOfValuesErrorMessage;
-_chunkEXVTHIT5js.setToDefaultLocale.call(void 0, oneOfValues);
+_chunkTJQ5NVL4js.setToDefaultLocale.call(void 0, oneOfValues);
 
 
 
 exports.oneOfValues = oneOfValues;
-//# sourceMappingURL=chunk-32MKEBKR.js.map
+//# sourceMappingURL=chunk-PAV4SQQL.js.map

package/lib/chunk-PAV4SQQL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/chunk-PAV4SQQL.js","../src/asserts/mix/oneOfValues.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACDA,IAAM,wBAAA,EAA0B,6CAAA;AAChC,IAAM,oBAAA,EAAsB,eAAA;AAgBrB,IAAM,YAAA,EACX,CAAC,QAAA,EAAA,GACD,CAAC,QAAA,EAAmB,GAAA,EAAA,GAA0B;AAC5C,EAAA,GAAA,CAAI,CAAC,QAAA,CAAS,QAAA,CAAS,QAAQ,CAAA,EAAG,GAAA,CAAI,QAAA,CAAS,QAAA,EAAU,QAAA,EAAU,mBAAmB,CAAA;AACxF,CAAA;AAEF,WAAA,CAAY,IAAA,EAAM,mBAAA;AAClB,WAAA,CAAY,QAAA,EAAU,uBAAA;AACtB,iDAAA,WAA8B,CAAA;ADf9B;AACA;AACE;AACF,kCAAC","file":"/home/runner/work/bguard/bguard/lib/chunk-PAV4SQQL.js","sourcesContent":[null,"import type { ExceptionContext, RequiredValidation } from '../../core';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst oneOfValuesErrorMessage = 'The received value is not equal to expected';\nconst oneOfValuesErrorKey = 'm:oneOfValues';\n\n/**\n * @description Creates a custom assertion that checks if a value is equal to the one of expected values.\n * @notice It has already been implemented in the number, bigint and string schema. There is no need to use it as a custom assert.\n * @param {unknown} expected The value that the received value is expected to match.\n * @returns {RequiredValidation} A validation function that takes a received value and an exception context.\n * @throws {ValidationError} If the received value does not match at least one of the expected values.\n * @example\n * const schema = number().custom(oneOfValues([5, 4])); // Define a schema with a custom assertion\n * parseOrFail(schema, 5); // Valid\n * parseOrFail(schema, 4); // Valid\n * parseOrFail(schema, 3); // Throws an error: 'The received value is not equal to expected'\n *\n * @translation Error Translation Key = 'm:oneOfValues'\n */\nexport const oneOfValues =\n  (expected: unknown[]): RequiredValidation =>\n  (received: unknown, ctx: ExceptionContext) => {\n    if (!expected.includes(received)) ctx.addIssue(expected, received, oneOfValuesErrorKey);\n  };\n\noneOfValues.key = oneOfValuesErrorKey;\noneOfValues.message = oneOfValuesErrorMessage;\nsetToDefaultLocale(oneOfValues);\n"]}

package/lib/chunk-PNSDUVRE.mjs

@@ -0,0 +1,21 @@
+import {
+  setToDefaultLocale
+} from "./chunk-OE3L7EKN.mjs";
+
+// src/asserts/string/uuidV4.ts
+var uuidV4ErrorMessage = "The received value is not a valid UUID v4";
+var uuidV4ErrorKey = "s:uuidV4";
+var uuidV4Pattern = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var uuidV4 = () => (received, ctx) => {
+  if (!uuidV4Pattern.test(received)) {
+    ctx.addIssue("uuid v4", received, uuidV4ErrorKey);
+  }
+};
+uuidV4.key = uuidV4ErrorKey;
+uuidV4.message = uuidV4ErrorMessage;
+setToDefaultLocale(uuidV4);
+
+export {
+  uuidV4
+};
+//# sourceMappingURL=chunk-PNSDUVRE.mjs.map

package/lib/chunk-PNSDUVRE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asserts/string/uuidV4.ts"],"sourcesContent":["import type { ExceptionContext, RequiredValidation } from '../../core';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst uuidV4ErrorMessage = 'The received value is not a valid UUID v4';\nconst uuidV4ErrorKey = 's:uuidV4';\n\nconst uuidV4Pattern = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * @description Asserts that a string value matches the UUID v4 format.\n * @returns {RequiredValidation} A validation function that takes a received string and an exception context.\n * @throws {ValidationError} if the received value is not a valid UUID v4.\n * @example\n * const schema = string().custom(uuidV4());\n * parseOrFail(schema, '123e4567-e89b-42d3-a456-426614174000'); // Valid\n * parseOrFail(schema, '123e4567-e89b-12d3-a456-426614174000'); // Throws an error: 'The received value is not a valid UUID v4'\n * parseOrFail(schema, '123e4567-e89b-a2d3-a456-426614174000'); // Throws an error: 'The received value is not a valid UUID v4'\n * parseOrFail(schema, '123e4567-e89b-42d3-c456-426614174000'); // Throws an error: 'The received value is not a valid UUID v4'\n * parseOrFail(schema, 'invalid-uuid'); // Throws an error: 'The received value is not a valid UUID v4'\n *\n * @translation Error Translation Key = 's:uuidV4'\n */\nexport const uuidV4 = (): RequiredValidation => (received: string, ctx: ExceptionContext) => {\n  if (!uuidV4Pattern.test(received)) {\n    ctx.addIssue('uuid v4', received, uuidV4ErrorKey);\n  }\n};\n\nuuidV4.key = uuidV4ErrorKey;\nuuidV4.message = uuidV4ErrorMessage;\nsetToDefaultLocale(uuidV4);\n"],"mappings":";;;;;AAGA,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AAEvB,IAAM,gBAAgB;AAgBf,IAAM,SAAS,MAA0B,CAAC,UAAkB,QAA0B;AAC3F,MAAI,CAAC,cAAc,KAAK,QAAQ,GAAG;AACjC,QAAI,SAAS,WAAW,UAAU,cAAc;AAAA,EAClD;AACF;AAEA,OAAO,MAAM;AACb,OAAO,UAAU;AACjB,mBAAmB,MAAM;","names":[]}

package/lib/chunk-PVQALO2H.js

@@ -0,0 +1,23 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkTJQ5NVL4js = require('./chunk-TJQ5NVL4.js');
+
+// src/asserts/string/atLeastOneSpecialChar.ts
+var atLeastOneSpecialCharErrorMessage = "The received value does not contain at least one special character";
+var atLeastOneSpecialCharErrorKey = "s:atLeastOneSpecialChar";
+var atLeastOneSpecialChar = (allowedSpecialChars) => {
+  const specialCharRegExp = new RegExp(
+    `[${(_nullishCoalesce(allowedSpecialChars, () => ( "*@$!#%&()^~{}"))).replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&")}]`
+  );
+  return (received, ctx) => {
+    if (!specialCharRegExp.test(received)) ctx.addIssue("special character", received, atLeastOneSpecialCharErrorKey);
+  };
+};
+atLeastOneSpecialChar.key = atLeastOneSpecialCharErrorKey;
+atLeastOneSpecialChar.message = atLeastOneSpecialCharErrorMessage;
+_chunkTJQ5NVL4js.setToDefaultLocale.call(void 0, atLeastOneSpecialChar);
+
+
+
+exports.atLeastOneSpecialChar = atLeastOneSpecialChar;
+//# sourceMappingURL=chunk-PVQALO2H.js.map

package/lib/chunk-PVQALO2H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/chunk-PVQALO2H.js","../src/asserts/string/atLeastOneSpecialChar.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACDA,IAAM,kCAAA,EAAoC,oEAAA;AAC1C,IAAM,8BAAA,EAAgC,yBAAA;AAkB/B,IAAM,sBAAA,EAAwB,CAAC,mBAAA,EAAA,GAAqD;AACzF,EAAA,MAAM,kBAAA,EAAoB,IAAI,MAAA;AAAA,IAC5B,CAAA,CAAA,EAAA,kBAAK,mBAAA,UAAuB,iBAAA,CAAA,CAAiB,OAAA,CAAQ,uBAAA,EAAyB,MAAM,CAAC,CAAA,CAAA;AAAA,EACvF,CAAA;AACA,EAAA,OAAO,CAAC,QAAA,EAAkB,GAAA,EAAA,GAA0B;AAClD,IAAA,GAAA,CAAI,CAAC,iBAAA,CAAkB,IAAA,CAAK,QAAQ,CAAA,EAAG,GAAA,CAAI,QAAA,CAAS,mBAAA,EAAqB,QAAA,EAAU,6BAA6B,CAAA;AAAA,EAClH,CAAA;AACF,CAAA;AAEA,qBAAA,CAAsB,IAAA,EAAM,6BAAA;AAC5B,qBAAA,CAAsB,QAAA,EAAU,iCAAA;AAChC,iDAAA,qBAAwC,CAAA;ADfxC;AACA;AACE;AACF,sDAAC","file":"/home/runner/work/bguard/bguard/lib/chunk-PVQALO2H.js","sourcesContent":[null,"import type { ExceptionContext, RequiredValidation } from '../../core';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst atLeastOneSpecialCharErrorMessage = 'The received value does not contain at least one special character';\nconst atLeastOneSpecialCharErrorKey = 's:atLeastOneSpecialChar';\n\n/**\n * @description Asserts that a string value contains at least one special character.\n * @param {string} [allowedSpecialChars=*] The string containing allowed special characters. Defaults to '*@$!#%&()^~{}'.\n * @returns {RequiredValidation} A validation function that takes a received string and an exception context.\n * @throws {ValidationError} if the received value does not contain at least one of the allowed special characters.\n * @example\n * const schema = string().custom(atLeastOneSpecialChar()); // Default special characters\n * parseOrFail(schema, 'abc!def'); // Valid\n * parseOrFail(schema, 'abcdef');  // Throws an error: 'The received value does not contain at least one special character'\n *\n * const customSchema = string().custom(atLeastOneSpecialChar('@$')); // Custom special characters\n * parseOrFail(customSchema, 'abc@def'); // Valid\n * parseOrFail(customSchema, 'abcdef');  // Throws an error: 'The received value does not contain at least one special character'\n *\n * @translation Error Translation Key = 's:atLeastOneSpecialChar'\n */\nexport const atLeastOneSpecialChar = (allowedSpecialChars?: string): RequiredValidation => {\n  const specialCharRegExp = new RegExp(\n    `[${(allowedSpecialChars ?? '*@$!#%&()^~{}').replace(/[-/\\\\^$*+?.()|[\\]{}]/g, '\\\\$&')}]`,\n  );\n  return (received: string, ctx: ExceptionContext) => {\n    if (!specialCharRegExp.test(received)) ctx.addIssue('special character', received, atLeastOneSpecialCharErrorKey);\n  };\n};\n\natLeastOneSpecialChar.key = atLeastOneSpecialCharErrorKey;\natLeastOneSpecialChar.message = atLeastOneSpecialCharErrorMessage;\nsetToDefaultLocale(atLeastOneSpecialChar);\n"]}

package/lib/chunk-QEG24G7E.mjs

@@ -0,0 +1,18 @@
+import {
+  setToDefaultLocale
+} from "./chunk-OE3L7EKN.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) ctx.addIssue(expected, received, bigintMaxErrorKey);
+};
+bigintMax.key = bigintMaxErrorKey;
+bigintMax.message = bigintMaxErrorMessage;
+setToDefaultLocale(bigintMax);
+
+export {
+  bigintMax
+};
+//# sourceMappingURL=chunk-QEG24G7E.mjs.map

package/lib/chunk-QEG24G7E.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asserts/bigint/bigintMax.ts"],"sourcesContent":["import type { ExceptionContext, RequiredValidation } from '../../core';\nimport { setToDefaultLocale } from '../../translationMap';\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) ctx.addIssue(expected, received, bigintMaxErrorKey);\n  };\n\nbigintMax.key = bigintMaxErrorKey;\nbigintMax.message = bigintMaxErrorMessage;\nsetToDefaultLocale(bigintMax);\n"],"mappings":";;;;;AAGA,IAAM,wBAAwB;AAC9B,IAAM,oBAAoB;AAenB,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,QAA0B;AAC3C,MAAI,WAAW,SAAU,KAAI,SAAS,UAAU,UAAU,iBAAiB;AAC7E;AAEF,UAAU,MAAM;AAChB,UAAU,UAAU;AACpB,mBAAmB,SAAS;","names":[]}

package/lib/chunk-QIFA6S5U.mjs

@@ -0,0 +1,18 @@
+import {
+  setToDefaultLocale
+} from "./chunk-OE3L7EKN.mjs";
+
+// src/asserts/bigint/bigintMaxExcluded.ts
+var bigintMaxExcludedErrorMessage = "The received value is greater than or equal to expected";
+var bigintMaxExcludedErrorKey = "bi:maxExcluded";
+var bigintMaxExcluded = (expected) => (received, ctx) => {
+  if (expected <= received) ctx.addIssue(expected, received, bigintMaxExcludedErrorKey);
+};
+bigintMaxExcluded.key = bigintMaxExcludedErrorKey;
+bigintMaxExcluded.message = bigintMaxExcludedErrorMessage;
+setToDefaultLocale(bigintMaxExcluded);
+
+export {
+  bigintMaxExcluded
+};
+//# sourceMappingURL=chunk-QIFA6S5U.mjs.map

package/lib/chunk-QIFA6S5U.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asserts/bigint/bigintMaxExcluded.ts"],"sourcesContent":["import { setToDefaultLocale } from '../../translationMap';\nimport type { ExceptionContext, RequiredValidation } from '../../core';\n\nconst bigintMaxExcludedErrorMessage = 'The received value is greater than or equal to expected';\nconst bigintMaxExcludedErrorKey = 'bi:maxExcluded';\n\n/**\n * @description - Asserts that a bigint value is strictly less than a specified maximum value (i.e., the maximum value is excluded).\n * @param {bigint} expected - The maximum allowable value, which is excluded.\n * @returns {RequiredValidation} -  A validation function that takes a received bigint and an exception context.\n * @throws {ValidationError} if the received value is greater than or equal to the expected maximum value.\n * @example\n * const schema = bigint().custom(bigintMaxExcluded(100n));\n * parseOrFail(schema, 99n);  // Valid\n * parseOrFail(schema, 100n); // Throws an error: 'The received value is greater than or equal to expected'\n * parseOrFail(schema, 101n); // Throws an error: 'The received value is greater than or equal to expected'\n *\n * @translation Error Translation Key = 'bi:maxExcluded'\n */\nexport const bigintMaxExcluded =\n  (expected: bigint): RequiredValidation =>\n  (received: bigint, ctx: ExceptionContext) => {\n    if (expected <= received) ctx.addIssue(expected, received, bigintMaxExcludedErrorKey);\n  };\n\nbigintMaxExcluded.key = bigintMaxExcludedErrorKey;\nbigintMaxExcluded.message = bigintMaxExcludedErrorMessage;\nsetToDefaultLocale(bigintMaxExcluded);\n"],"mappings":";;;;;AAGA,IAAM,gCAAgC;AACtC,IAAM,4BAA4B;AAe3B,IAAM,oBACX,CAAC,aACD,CAAC,UAAkB,QAA0B;AAC3C,MAAI,YAAY,SAAU,KAAI,SAAS,UAAU,UAAU,yBAAyB;AACtF;AAEF,kBAAkB,MAAM;AACxB,kBAAkB,UAAU;AAC5B,mBAAmB,iBAAiB;","names":[]}

package/lib/chunk-QIPGUTIG.mjs

@@ -0,0 +1,302 @@
+import {
+  isValidDateInner
+} from "./chunk-YBVMP4EI.mjs";
+import {
+  getTranslationByLocale
+} from "./chunk-OE3L7EKN.mjs";
+import {
+  BuildSchemaError,
+  ValidationError
+} from "./chunk-ZTCXXAKD.mjs";
+import {
+  ctxSymbol
+} from "./chunk-2ANPCB4O.mjs";
+
+// src/core.ts
+var replacePlaceholdersRegex = /{{(.*?)}}/g;
+function replacePlaceholders(template, replacements) {
+  return template.replace(replacePlaceholdersRegex, (_, key) => {
+    return key in replacements ? `${replacements[key]}` : `{{${key}}}`;
+  });
+}
+var ExceptionContext = class _ExceptionContext {
+  constructor(initialReceived, t, pathToError, errors, meta) {
+    this.initialReceived = initialReceived;
+    this.t = t;
+    this.pathToError = pathToError;
+    this.errors = errors;
+    this.meta = meta;
+  }
+  createChild(childPathToError, childMeta) {
+    return new _ExceptionContext(this.initialReceived, this.t, childPathToError, this.errors, childMeta);
+  }
+  ref(path) {
+    let ref = this.initialReceived;
+    const parsedRefPath = path.split(".");
+    parsedRefPath.forEach((el) => {
+      ref = ref[el];
+    });
+    return ref;
+  }
+  addIssue(expected, received, messageKey) {
+    const rawMessage = this.t[messageKey] ?? messageKey;
+    const message = replacePlaceholders(rawMessage, { e: expected, r: received, p: this.pathToError });
+    if (this.errors) {
+      this.errors.push({
+        expected,
+        received,
+        pathToError: this.pathToError,
+        message
+      });
+      return;
+    }
+    throw new ValidationError(expected, received, this.pathToError, message, this.meta);
+  }
+};
+function innerCheck(schema, receivedValue, exCtx) {
+  const commonTmap = exCtx.t;
+  const schemaData = schema[ctxSymbol];
+  schemaData.transformListBefore?.forEach((transformCallback) => {
+    receivedValue = transformCallback(receivedValue);
+  });
+  if (receivedValue === void 0) {
+    if (schemaData.defaultValue !== void 0) return schemaData.defaultValue;
+    if (!schemaData.isOptional) exCtx.addIssue("Required", receivedValue, commonTmap["c:optional"]);
+    return receivedValue;
+  }
+  if (receivedValue === null) {
+    if (!schemaData.isNullable) exCtx.addIssue("Not null", receivedValue, commonTmap["c:nullable"]);
+    return receivedValue;
+  }
+  if (schemaData.date) {
+    if (!isValidDateInner(receivedValue)) exCtx.addIssue("Date", receivedValue, commonTmap["c:date"]);
+  }
+  const typeOfVal = typeof receivedValue;
+  if (schemaData.type.length) {
+    if (!schemaData.type.includes(typeOfVal)) exCtx.addIssue(schemaData.type, typeOfVal, commonTmap["c:invalidType"]);
+  }
+  if (schemaData.array) {
+    if (!Array.isArray(receivedValue)) return exCtx.addIssue("Array", receivedValue, commonTmap["c:array"]);
+    schemaData.requiredValidations.forEach((requiredValidation) => {
+      requiredValidation(receivedValue, exCtx);
+    });
+    const schema2 = schemaData.array;
+    const pathToError = exCtx.pathToError;
+    const parsedReceivedValue = [];
+    receivedValue.forEach((elem, i) => {
+      const parsedElement = innerCheck(schema2, elem, exCtx.createChild(`${pathToError}[${i}]`, schemaData.meta));
+      parsedReceivedValue.push(parsedElement);
+    });
+    return parsedReceivedValue;
+  }
+  if (schemaData.object) {
+    if (typeOfVal !== "object") exCtx.addIssue("Object", receivedValue, commonTmap["c:objectType"]);
+    if (Array.isArray(receivedValue)) exCtx.addIssue("Object", receivedValue, commonTmap["c:objectTypeAsArray"]);
+    schemaData.requiredValidations.forEach((requiredValidation) => {
+      requiredValidation(receivedValue, exCtx);
+    });
+    const shapeSchema = schemaData.object;
+    const parsedReceivedValue = {};
+    if (!schemaData.allowUnrecognizedObjectProps) {
+      for (const keyPerReceivedValue of Object.keys(receivedValue)) {
+        if (shapeSchema[keyPerReceivedValue] === void 0)
+          exCtx.addIssue("Unrecognized property", keyPerReceivedValue, commonTmap["c:unrecognizedProperty"]);
+      }
+    }
+    const pathToError = exCtx.pathToError;
+    for (const [keyOfSchema, valueOfSchema] of Object.entries(shapeSchema)) {
+      const receivedObjectValuePropery = receivedValue[keyOfSchema];
+      if (receivedObjectValuePropery === void 0) {
+        if (!valueOfSchema[ctxSymbol].isOptional)
+          exCtx.addIssue("Required", receivedObjectValuePropery, commonTmap["c:requiredProperty"]);
+      }
+      const parsedReceivedObjectValuePropery = innerCheck(
+        valueOfSchema,
+        receivedObjectValuePropery,
+        exCtx.createChild(`${pathToError}.${keyOfSchema}`, schemaData.meta)
+      );
+      parsedReceivedValue[keyOfSchema] = parsedReceivedObjectValuePropery;
+    }
+    return parsedReceivedValue;
+  }
+  schemaData.requiredValidations.forEach((requiredValidation) => {
+    requiredValidation(receivedValue, exCtx);
+  });
+  return receivedValue;
+}
+var CommonSchema = class {
+  [ctxSymbol];
+  constructor(ctx) {
+    this[ctxSymbol] = ctx;
+  }
+  /**
+   * @param validators - One or more custom validation functions.
+   * @returns {this} The schema instance with the added custom validation.
+   */
+  custom(...validators) {
+    this.defaultValueCheck();
+    this[ctxSymbol].requiredValidations.push(...validators);
+    return this;
+  }
+  /**
+   * Marks the schema as nullable, allowing the value to be `null`.
+   *
+   * @returns {WithNull<this>} The schema instance marked as nullable.
+   */
+  nullable() {
+    this.defaultValueCheck();
+    this[ctxSymbol].isNullable = true;
+    return this;
+  }
+  /**
+   * Marks the schema as optional, allowing the value to be `undefined`.
+   *
+   * @returns {WithUndefined<this>} The schema instance marked as optional.
+   */
+  optional() {
+    this.defaultValueCheck();
+    this[ctxSymbol].isOptional = true;
+    return this;
+  }
+  /**
+   * Marks the schema as optional, allowing the value to be `undefined`.
+   *
+   * @returns {this} The schema instance. This method should be used as a last one because it does the check of previous methods and
+   */
+  default(defaultValue) {
+    const ctx = this[ctxSymbol];
+    if (ctx.isOptional) {
+      throw new BuildSchemaError(`Cannot call method 'default' after method 'optional'`);
+    }
+    try {
+      parseOrFail(this, defaultValue);
+    } catch (e) {
+      throw new BuildSchemaError(e.message);
+    }
+    this[ctxSymbol].defaultValue = defaultValue;
+    return this;
+  }
+  /**
+   * Applies a transformation to the input value before any validation occurs.
+   * The transformation should return a value of the same type as the inferred type of the schema,
+   * ensuring that the overall type is not altered.
+   *
+   * @template In - The type of the input value before transformation (defaults to `unknown`).
+   * @param {TransformCallback<In, InferType<this>>} cb - The callback function that performs the transformation.
+   * @returns {this} The updated schema with the applied transformation.
+   *
+   * @example
+   * const schema = string()
+   *   .nullable()
+   *   .transformBeforeValidation((val) => val + '') // Ensure the value is a string
+   *   .transformBeforeValidation((val: string) => (val === '' ? null : val)); // Convert empty strings to null
+   *
+   * // Parse 'test' will pass as 'test' is a valid string longer than 3 characters.
+   * parseOrFail(schema, 'test');
+   *
+   * // Parsing '' will be transformed to null and will pass due to .nullable().
+   * parseOrFail(schema, '');
+   */
+  transformBeforeValidation(cb) {
+    const ctx = this[ctxSymbol];
+    if (ctx.transformListBefore) {
+      ctx.transformListBefore.push(cb);
+    } else {
+      ctx.transformListBefore = [cb];
+    }
+    return this;
+  }
+  /**
+   * Assigns a unique identifier to the schema.
+   * This ID can be used to track or map validation errors back to specific fields
+   * in a form or other structures.
+   *
+   * @param {string} value - The unique identifier for the schema.
+   * @returns {this} The updated schema with the assigned ID.
+   *
+   * @example
+   * const schema = string().id('username');
+   */
+  id(value) {
+    return this.meta("id", value);
+  }
+  /**
+   * Provides a description for the schema, offering additional context or information.
+   * The description can be used when displaying validation errors or for documentation purposes.
+   *
+   * @param {string} value - The description for the schema.
+   * @returns {this} The updated schema with the added description.
+   *
+   * @example
+   * const schema = string().description('The username of the account holder.');
+   */
+  description(value) {
+    return this.meta("description", value);
+  }
+  meta(key, value) {
+    const ctx = this[ctxSymbol];
+    ctx.meta = { ...ctx.meta, [key]: value };
+    return this;
+  }
+  defaultValueCheck() {
+    if (this[ctxSymbol].defaultValue !== void 0) {
+      throw new BuildSchemaError("Default value must be the last method called in schema");
+    }
+  }
+};
+function parseOrFail(schema, receivedValue, options) {
+  try {
+    const ctx = new ExceptionContext(
+      receivedValue,
+      getTranslationByLocale(options?.lng),
+      "",
+      void 0,
+      schema[ctxSymbol].meta
+    );
+    return innerCheck(schema, receivedValue, ctx);
+  } catch (e) {
+    if (e instanceof ValidationError) throw e;
+    throw new Error("Something unexpected happened");
+  }
+}
+function parse(schema, receivedValue, options) {
+  try {
+    const ctx = new ExceptionContext(
+      receivedValue,
+      getTranslationByLocale(options?.lng),
+      "",
+      options?.getAllErrors ? [] : void 0,
+      schema[ctxSymbol].meta
+    );
+    const parsedValue = innerCheck(schema, receivedValue, ctx);
+    if (ctx.errors?.length) {
+      return [ctx.errors, void 0];
+    }
+    return [void 0, parsedValue];
+  } catch (e) {
+    if (e instanceof ValidationError) {
+      delete e.stack;
+      return [[e], void 0];
+    }
+    return [
+      [
+        {
+          message: "Something unexpected happened",
+          expected: "",
+          received: "",
+          pathToError: "",
+          meta: void 0
+        }
+      ],
+      void 0
+    ];
+  }
+}
+
+export {
+  ExceptionContext,
+  CommonSchema,
+  parseOrFail,
+  parse
+};
+//# sourceMappingURL=chunk-QIPGUTIG.mjs.map

package/lib/chunk-QIPGUTIG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["import { isValidDateInner } from './helpers/isValidDateInner';\nimport {\n  BaseType,\n  MetaContext,\n  TransformCallback,\n  TranslationErrorMap,\n  ValidationErrorData,\n  WithNull,\n  WithUndefined,\n} from './commonTypes';\nimport { type InferType } from './InferType';\nimport { BuildSchemaError, ValidationError } from './exceptions';\nimport { getTranslationByLocale } from './translationMap';\nimport { ctxSymbol } from './helpers/constants';\n\nconst replacePlaceholdersRegex = /{{(.*?)}}/g;\n\nfunction replacePlaceholders(template: string, replacements: Record<string, unknown>): string {\n  return template.replace(replacePlaceholdersRegex, (_, key) => {\n    return key in replacements ? `${replacements[key] as string}` : `{{${key}}}`;\n  });\n}\n\nexport class ExceptionContext {\n  constructor(\n    public readonly initialReceived: unknown,\n    public readonly t: TranslationErrorMap,\n    public readonly pathToError: string,\n    public readonly errors?: ValidationErrorData[],\n    public readonly meta?: MetaContext,\n  ) {}\n\n  createChild(childPathToError: string, childMeta?: MetaContext) {\n    return new ExceptionContext(this.initialReceived, this.t, childPathToError, this.errors, childMeta);\n  }\n\n  public ref(path: string): unknown {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let ref: any = this.initialReceived;\n    const parsedRefPath = path.split('.');\n    parsedRefPath.forEach((el) => {\n      ref = ref[el];\n    });\n\n    return ref;\n  }\n\n  public addIssue(expected: unknown, received: unknown, messageKey: string): never | void {\n    const rawMessage = this.t[messageKey] ?? messageKey;\n    const message = replacePlaceholders(rawMessage, { e: expected, r: received, p: this.pathToError });\n\n    if (this.errors) {\n      this.errors.push({\n        expected,\n        received,\n        pathToError: this.pathToError,\n        message,\n      });\n\n      return;\n    }\n\n    throw new ValidationError(expected, received, this.pathToError, message, this.meta);\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type RequiredValidation = (received: any, ctx: ExceptionContext) => void;\n\nfunction innerCheck(schema: CommonSchema, receivedValue: unknown, exCtx: ExceptionContext): unknown {\n  const commonTmap = exCtx.t;\n  const schemaData = schema[ctxSymbol];\n\n  schemaData.transformListBefore?.forEach((transformCallback) => {\n    receivedValue = transformCallback(receivedValue);\n  });\n\n  if (receivedValue === undefined) {\n    if (schemaData.defaultValue !== undefined) return schemaData.defaultValue;\n    if (!schemaData.isOptional) exCtx.addIssue('Required', receivedValue, commonTmap['c:optional']);\n    return receivedValue;\n  }\n\n  if (receivedValue === null) {\n    if (!schemaData.isNullable) exCtx.addIssue('Not null', receivedValue, commonTmap['c:nullable']);\n    return receivedValue;\n  }\n\n  if (schemaData.date) {\n    if (!isValidDateInner(receivedValue)) exCtx.addIssue('Date', receivedValue, commonTmap['c:date']);\n  }\n\n  const typeOfVal = typeof receivedValue;\n\n  if (schemaData.type.length) {\n    if (!schemaData.type.includes(typeOfVal)) exCtx.addIssue(schemaData.type, typeOfVal, commonTmap['c:invalidType']);\n  }\n\n  if (schemaData.array) {\n    if (!Array.isArray(receivedValue)) return exCtx.addIssue('Array', receivedValue, commonTmap['c:array']);\n\n    schemaData.requiredValidations.forEach((requiredValidation) => {\n      requiredValidation(receivedValue, exCtx);\n    });\n\n    const schema = schemaData.array;\n    const pathToError = exCtx.pathToError;\n    const parsedReceivedValue: unknown[] = [];\n    receivedValue.forEach((elem, i) => {\n      const parsedElement = innerCheck(schema, elem, exCtx.createChild(`${pathToError}[${i}]`, schemaData.meta));\n      parsedReceivedValue.push(parsedElement);\n    });\n\n    return parsedReceivedValue;\n  }\n\n  if (schemaData.object) {\n    if (typeOfVal !== 'object') exCtx.addIssue('Object', receivedValue, commonTmap['c:objectType']);\n    if (Array.isArray(receivedValue)) exCtx.addIssue('Object', receivedValue, commonTmap['c:objectTypeAsArray']);\n\n    schemaData.requiredValidations.forEach((requiredValidation) => {\n      requiredValidation(receivedValue, exCtx);\n    });\n\n    const shapeSchema = schemaData.object;\n    const parsedReceivedValue: Record<string, unknown> = {};\n\n    if (!schemaData.allowUnrecognizedObjectProps) {\n      for (const keyPerReceivedValue of Object.keys(receivedValue)) {\n        if (shapeSchema[keyPerReceivedValue] === undefined)\n          exCtx.addIssue('Unrecognized property', keyPerReceivedValue, commonTmap['c:unrecognizedProperty']);\n      }\n    }\n\n    const pathToError = exCtx.pathToError;\n    for (const [keyOfSchema, valueOfSchema] of Object.entries(shapeSchema)) {\n      const receivedObjectValuePropery = (receivedValue as Record<string, unknown>)[keyOfSchema];\n      if (receivedObjectValuePropery === undefined) {\n        if (!valueOfSchema[ctxSymbol].isOptional)\n          exCtx.addIssue('Required', receivedObjectValuePropery, commonTmap['c:requiredProperty']);\n      }\n\n      const parsedReceivedObjectValuePropery = innerCheck(\n        valueOfSchema,\n        receivedObjectValuePropery,\n        exCtx.createChild(`${pathToError}.${keyOfSchema}`, schemaData.meta),\n      );\n\n      parsedReceivedValue[keyOfSchema] = parsedReceivedObjectValuePropery;\n    }\n\n    return parsedReceivedValue;\n  }\n\n  schemaData.requiredValidations.forEach((requiredValidation) => {\n    requiredValidation(receivedValue, exCtx);\n  });\n\n  return receivedValue;\n}\n\nexport type ObjectShapeSchemaType = Record<string, CommonSchema>;\n\nexport interface ValidatorContext {\n  type: BaseType[];\n  isNullable?: boolean;\n  isOptional?: boolean;\n  requiredValidations: RequiredValidation[];\n  array?: CommonSchema;\n  object?: ObjectShapeSchemaType;\n  allowUnrecognizedObjectProps?: boolean;\n  strictType?: boolean;\n  strictTypeValue?: unknown;\n  date?: boolean;\n  defaultValue?: unknown;\n  meta?: MetaContext;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  transformListBefore?: TransformCallback<any, any>[];\n}\n\nexport class CommonSchema {\n  [ctxSymbol]: ValidatorContext;\n  constructor(ctx: ValidatorContext) {\n    this[ctxSymbol] = ctx;\n  }\n\n  /**\n   * @param validators - One or more custom validation functions.\n   * @returns {this} The schema instance with the added custom validation.\n   */\n  public custom(...validators: RequiredValidation[]): this {\n    this.defaultValueCheck();\n    this[ctxSymbol].requiredValidations.push(...validators);\n    return this;\n  }\n\n  /**\n   * Marks the schema as nullable, allowing the value to be `null`.\n   *\n   * @returns {WithNull<this>} The schema instance marked as nullable.\n   */\n  public nullable(): WithNull<this> {\n    this.defaultValueCheck();\n    this[ctxSymbol].isNullable = true;\n    return this as WithNull<this>;\n  }\n\n  /**\n   * Marks the schema as optional, allowing the value to be `undefined`.\n   *\n   * @returns {WithUndefined<this>} The schema instance marked as optional.\n   */\n  public optional(): WithUndefined<this> {\n    this.defaultValueCheck();\n    this[ctxSymbol].isOptional = true;\n    return this as WithUndefined<this>;\n  }\n\n  /**\n   * Marks the schema as optional, allowing the value to be `undefined`.\n   *\n   * @returns {this} The schema instance. This method should be used as a last one because it does the check of previous methods and\n   */\n  public default(defaultValue: InferType<this>): this {\n    const ctx = this[ctxSymbol];\n    if (ctx.isOptional) {\n      throw new BuildSchemaError(`Cannot call method 'default' after method 'optional'`);\n    }\n\n    try {\n      parseOrFail(this, defaultValue);\n    } catch (e) {\n      throw new BuildSchemaError((e as Error).message);\n    }\n\n    this[ctxSymbol].defaultValue = defaultValue;\n    return this;\n  }\n\n  /**\n   * Applies a transformation to the input value before any validation occurs.\n   * The transformation should return a value of the same type as the inferred type of the schema,\n   * ensuring that the overall type is not altered.\n   *\n   * @template In - The type of the input value before transformation (defaults to `unknown`).\n   * @param {TransformCallback<In, InferType<this>>} cb - The callback function that performs the transformation.\n   * @returns {this} The updated schema with the applied transformation.\n   *\n   * @example\n   * const schema = string()\n   *   .nullable()\n   *   .transformBeforeValidation((val) => val + '') // Ensure the value is a string\n   *   .transformBeforeValidation((val: string) => (val === '' ? null : val)); // Convert empty strings to null\n   *\n   * // Parse 'test' will pass as 'test' is a valid string longer than 3 characters.\n   * parseOrFail(schema, 'test');\n   *\n   * // Parsing '' will be transformed to null and will pass due to .nullable().\n   * parseOrFail(schema, '');\n   */\n  public transformBeforeValidation<In>(cb: TransformCallback<In, InferType<this>>): this {\n    const ctx = this[ctxSymbol];\n    if (ctx.transformListBefore) {\n      ctx.transformListBefore.push(cb);\n    } else {\n      ctx.transformListBefore = [cb];\n    }\n\n    return this;\n  }\n\n  /**\n   * Assigns a unique identifier to the schema.\n   * This ID can be used to track or map validation errors back to specific fields\n   * in a form or other structures.\n   *\n   * @param {string} value - The unique identifier for the schema.\n   * @returns {this} The updated schema with the assigned ID.\n   *\n   * @example\n   * const schema = string().id('username');\n   */\n  public id(value: string): this {\n    return this.meta('id', value);\n  }\n\n  /**\n   * Provides a description for the schema, offering additional context or information.\n   * The description can be used when displaying validation errors or for documentation purposes.\n   *\n   * @param {string} value - The description for the schema.\n   * @returns {this} The updated schema with the added description.\n   *\n   * @example\n   * const schema = string().description('The username of the account holder.');\n   */\n  public description(value: string): this {\n    return this.meta('description', value);\n  }\n\n  private meta(key: string, value: string): this {\n    const ctx = this[ctxSymbol];\n    ctx.meta = { ...ctx.meta, [key]: value };\n    return this;\n  }\n\n  protected defaultValueCheck() {\n    if (this[ctxSymbol].defaultValue !== undefined) {\n      throw new BuildSchemaError('Default value must be the last method called in schema');\n    }\n  }\n}\n\ninterface ParseOptions {\n  /**\n   * Set language keyword to map error messages.\n   * @default 'default'\n   * @example 'sr' or 'Serbia' or any string to identify language\n   */\n  lng?: string;\n}\n\n/**\n * Parses and validates a value against the provided schema, returning a type-safe result.\n *\n * This function will throw a `ValidationError` if the value does not conform to the schema.\n * The inferred TypeScript type of the returned value will match the structure defined by the schema.\n *\n * @template T\n * @param {T} schema - The schema to validate the received value against. This schema dictates the expected structure and type of the value.\n * @param {unknown} receivedValue - The value to be validated and parsed according to the schema.\n * @param {ParseOptions} options - Options\n * @param {ParseOptions.lng} options.lng -  Set language keyword to map Error message\n * @returns {InferType<T>} The validated value, with its TypeScript type inferred from the schema.\n *\n * @throws {ValidationError} If the received value does not match the schema, a `ValidationError` will be thrown.\n * @throws {Error} If an unexpected error occurs during validation, an error will be thrown with a generic message.\n *\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number(),\n * });\n *\n * const result = parseOrFail(schema, { name: 'Alice', age: 30 });\n * // result will be inferred as { name: string; age: number }\n *\n * parseOrFail(schema, { name: 'Alice', age: '30' });\n * // Throws ValidationError because 'age' should be a number, not a string.\n */\nexport function parseOrFail<T extends CommonSchema>(\n  schema: T,\n  receivedValue: unknown,\n  options?: ParseOptions,\n): InferType<T> {\n  try {\n    const ctx = new ExceptionContext(\n      receivedValue,\n      getTranslationByLocale(options?.lng),\n      '',\n      undefined,\n      schema[ctxSymbol].meta,\n    );\n    return innerCheck(schema, receivedValue, ctx) as InferType<T>;\n  } catch (e) {\n    /* istanbul ignore next */\n    if (e instanceof ValidationError) throw e;\n    /* istanbul ignore next */\n    throw new Error('Something unexpected happened');\n  }\n}\n\ninterface ParseOptions {\n  /**\n   * Set language keyword to map error messages.\n   * @default 'default'\n   * @example 'sr' or 'Serbia' or any string to identify language\n   */\n  lng?: string;\n\n  /**\n   * If true, collects all validation errors and returns them.\n   * If false or undefined, returns the first validation error it can find and stops looking,\n   * which provides a small runtime optimization.\n   * @default undefined\n   */\n  getAllErrors?: boolean;\n}\n\n/**\n * Parses and validates a value against the provided schema, returning a type-safe parsedValue.\n *\n * This function will throw a `ValidationError` if the value does not conform to the schema.\n * The inferred TypeScript type of the returned value will match the structure defined by the schema.\n *\n * @template T\n * @param {T} schema - The schema to validate the received value against. This schema dictates the expected structure and type of the value.\n * @param {unknown} receivedValue - The value to be validated and parsed according to the schema.\n * @param {ParseOptions} options - Options\n * @param {ParseOptions.lng} options.lng -  Set language keyword to map Error messages\n * @param {ParseOptions.lng} options.getAllErrors - If `false` or `undefined` - returns the first validation error it can find and stops looking, which provides a small runtime optimization.\n * @returns {[undefined, InferType<T>]} A tuple of [undefined, InferType<T>] if parsing is successful.\n * @returns {[ValidationErrorData[], undefined]} A tuple of [ValidationErrorData[], undefined]] if errors occur.\n *\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number(),\n * });\n *\n * const [errors, parsedValue]  = parse(schema, { name: 'Alice', age: 30 });\n * // parsedValue will be inferred as { name: string; age: number }\n *\n *\n *  const [errors, parsedValue] = parse(schema, { name: 'Alice', age: '30' });\n * // First element in array \"errors\" will have an error because 'age' should be a number, not a string.\n * // Array 'errors' returns only one element.\n *\n *\n *  const [errors, parsedValue] = parse(schema, { name: true, age: '30' }, { getAllErrors: true});\n * // Returns array \"errors\" with multiple errors because 'age' should be a number and 'name' a string.\n * // With provided options { getAllErrors: true}, we can expecte more than one error in 'errors' array.\n *\n *\n *  const [errors, parsedValue] = parse(schema, { name: true, age: '30' }, { lng: 'SR'});\n * // First element in array \"errors\" will have an error because 'age' should be a number, not a string.\n * // With provided options { lng: 'SR'}, errors will be translated to a language mapped with keyword 'SR'\n */\nexport function parse<T extends CommonSchema>(\n  schema: T,\n  receivedValue: unknown,\n  options?: ParseOptions,\n): [ValidationErrorData[], undefined] | [undefined, InferType<T>] {\n  try {\n    const ctx = new ExceptionContext(\n      receivedValue,\n      getTranslationByLocale(options?.lng),\n      '',\n      options?.getAllErrors ? [] : undefined,\n      schema[ctxSymbol].meta,\n    );\n\n    const parsedValue = innerCheck(schema, receivedValue, ctx) as InferType<T>;\n\n    if (ctx.errors?.length) {\n      return [ctx.errors, undefined];\n    }\n\n    return [undefined, parsedValue];\n  } catch (e) {\n    /* istanbul ignore next */\n    if (e instanceof ValidationError) {\n      delete e.stack;\n      return [[e], undefined];\n    }\n    /* istanbul ignore next */\n    return [\n      [\n        {\n          message: 'Something unexpected happened',\n          expected: '',\n          received: '',\n          pathToError: '',\n          meta: undefined,\n        },\n      ],\n      undefined,\n    ];\n  }\n}\n"],"mappings":"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","names":["schema"]}

package/lib/chunk-QMIH3A4D.js

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkTJQ5NVL4js = require('./chunk-TJQ5NVL4.js');
+
+// src/asserts/string/lowerCase.ts
+var lowerCaseErrorMessage = "The received value is not in lowercase";
+var lowerCaseErrorKey = "s:lowerCase";
+var lowerCase = () => (received, ctx) => {
+  if (received !== received.toLowerCase()) ctx.addIssue("lower case", received, lowerCaseErrorKey);
+};
+lowerCase.key = lowerCaseErrorKey;
+lowerCase.message = lowerCaseErrorMessage;
+_chunkTJQ5NVL4js.setToDefaultLocale.call(void 0, lowerCase);
+
+
+
+exports.lowerCase = lowerCase;
+//# sourceMappingURL=chunk-QMIH3A4D.js.map

package/lib/chunk-QMIH3A4D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bguard/bguard/lib/chunk-QMIH3A4D.js","../src/asserts/string/lowerCase.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACDA,IAAM,sBAAA,EAAwB,wCAAA;AAC9B,IAAM,kBAAA,EAAoB,aAAA;AAanB,IAAM,UAAA,EAAY,CAAA,EAAA,GAA0B,CAAC,QAAA,EAAkB,GAAA,EAAA,GAA0B;AAC9F,EAAA,GAAA,CAAI,SAAA,IAAa,QAAA,CAAS,WAAA,CAAY,CAAA,EAAG,GAAA,CAAI,QAAA,CAAS,YAAA,EAAc,QAAA,EAAU,iBAAiB,CAAA;AACjG,CAAA;AAEA,SAAA,CAAU,IAAA,EAAM,iBAAA;AAChB,SAAA,CAAU,QAAA,EAAU,qBAAA;AACpB,iDAAA,SAA4B,CAAA;ADV5B;AACA;AACE;AACF,8BAAC","file":"/home/runner/work/bguard/bguard/lib/chunk-QMIH3A4D.js","sourcesContent":[null,"import type { ExceptionContext, RequiredValidation } from '../../core';\nimport { setToDefaultLocale } from '../../translationMap';\n\nconst lowerCaseErrorMessage = 'The received value is not in lowercase';\nconst lowerCaseErrorKey = 's:lowerCase';\n\n/**\n * @description Asserts that a string value is in lowercase.\n * @returns {RequiredValidation} A validation function that takes a received string and an exception context.\n * @throws {ValidationError} if the received value is not in lowercase.\n * @example\n * const schema = string().custom(lowerCase());\n * parseOrFail(schema, 'valid');   // Valid\n * parseOrFail(schema, 'Invalid'); // Throws an error: 'The received value is not in lowercase'\n *\n * @translation Error Translation Key = 's:lowerCase'\n */\nexport const lowerCase = (): RequiredValidation => (received: string, ctx: ExceptionContext) => {\n  if (received !== received.toLowerCase()) ctx.addIssue('lower case', received, lowerCaseErrorKey);\n};\n\nlowerCase.key = lowerCaseErrorKey;\nlowerCase.message = lowerCaseErrorMessage;\nsetToDefaultLocale(lowerCase);\n"]}

package/lib/chunk-R25HSJPH.js

@@ -0,0 +1,21 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkTJQ5NVL4js = require('./chunk-TJQ5NVL4.js');
+
+// src/asserts/string/uuidV4.ts
+var uuidV4ErrorMessage = "The received value is not a valid UUID v4";
+var uuidV4ErrorKey = "s:uuidV4";
+var uuidV4Pattern = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var uuidV4 = () => (received, ctx) => {
+  if (!uuidV4Pattern.test(received)) {
+    ctx.addIssue("uuid v4", received, uuidV4ErrorKey);
+  }
+};
+uuidV4.key = uuidV4ErrorKey;
+uuidV4.message = uuidV4ErrorMessage;
+_chunkTJQ5NVL4js.setToDefaultLocale.call(void 0, uuidV4);
+
+
+
+exports.uuidV4 = uuidV4;
+//# sourceMappingURL=chunk-R25HSJPH.js.map