bguard 0.0.2 → 0.0.4

package/lib/asserts/string/index.mjs

@@ -0,0 +1,85 @@
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/common/equalTo.ts
+var equalTo = (expected) => (received, pathToError) => {
+  if (expected !== received)
+    throwException(expected, received, pathToError, "The received value is not equal to expected");
+};
+
+// src/core.ts
+var ctxSymbol = Symbol("contextSymbol");
+
+// src/schemas/CommonSchema.ts
+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[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[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[ctxSymbol].isOptional = true;
+    return this;
+  }
+};
+
+// src/schemas/StringSchema.ts
+var StringSchema = class extends CommonSchema {
+  _string = 1;
+  /**
+   * 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 - string().equalTo('hello'); // Infers the type 'hello'
+   */
+  equalTo(expectedValue) {
+    return this.custom(equalTo(expectedValue));
+  }
+};
+
+// src/asserts/string/index.ts
+function string() {
+  return new StringSchema({ type: ["string"], requiredValidations: [] });
+}
+export {
+  string
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/asserts/common/equalTo.ts","../../../src/core.ts","../../../src/schemas/CommonSchema.ts","../../../src/schemas/StringSchema.ts","../../../src/asserts/string/index.ts"],"sourcesContent":["export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n","import { throwException } from '../../exceptions';\nimport { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Creates a custom assertion that checks if a value is equal to the expected value.\n *\n * This assertion can be used within a `.custom` method to enforce that a value strictly matches the expected value.\n * It will throw a `ValidationError` if the values are not equal.\n *\n * @param {unknown} expected - The value that the received value is expected to match.\n * @returns {RequiredValidation} A function that takes the received value and the path to the error,\n * and throws a `ValidationError` if the received value does not equal the expected value.\n *\n * @throws {ValidationError} If the received value does not match the expected value.\n *\n * @example\n * import { number, equalTo } from 'bguard';\n *\n * // Define a schema with a custom assertion\n * const schema = number().custom(equalTo(5));\n *\n * // This will pass\n * parseSchema(schema, 5);\n *\n * // This will throw a ValidationError\n * parseSchema(schema, 3);\n */\nexport const equalTo =\n  (expected: unknown): RequiredValidation =>\n  (received: number, pathToError: string) => {\n    if (expected !== received)\n      throwException(expected, received, pathToError, 'The received value is not equal to expected');\n  };\n","export const ctxSymbol = Symbol('contextSymbol');\n\nimport { throwException } from './exceptions';\nimport type { CommonSchema } from './schemas/CommonSchema';\n\nexport function innerCheck(schema: CommonSchema, receivedValue: unknown, pathToError: string) {\n  const ctx = schema[ctxSymbol];\n  if (receivedValue === undefined) {\n    if (!ctx.isOptional) throwException('Required', receivedValue, pathToError, 'The required value is missing');\n    return receivedValue;\n  }\n\n  if (receivedValue === null) {\n    if (!ctx.isNullable) throwException('Not null', receivedValue, pathToError, 'Value should not be null');\n    return receivedValue;\n  }\n\n  if (ctx.array) {\n    if (!Array.isArray(receivedValue))\n      throwException('Array', receivedValue, pathToError, 'Expected an array but received a different type');\n    const schema = ctx.array;\n\n    receivedValue.forEach((elem, i) => {\n      innerCheck(schema, elem, `${pathToError}[${i}]`);\n    });\n\n    return receivedValue;\n  }\n\n  const typeOfVal = typeof receivedValue;\n\n  if (ctx.object) {\n    if (typeOfVal !== 'object')\n      throwException('Object', receivedValue, pathToError, 'Expected an object but received a different type');\n    if (Array.isArray(receivedValue))\n      throwException(\n        'Object',\n        receivedValue,\n        pathToError,\n        'Expected an object but received an array. Invalid type of data',\n      );\n    const shapeSchema = ctx.object;\n    for (const keyPerReceivedValue of Object.keys(receivedValue)) {\n      if (shapeSchema[keyPerReceivedValue] === undefined)\n        throwException('Not allowed', keyPerReceivedValue, pathToError, 'This key is not allowed in the object');\n    }\n\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          throwException(\n            'Required',\n            receivedObjectValuePropery,\n            pathToError,\n            'Missing required property in the object',\n          );\n      }\n      innerCheck(valueOfSchema, receivedObjectValuePropery, `${pathToError}.${keyOfSchema}`);\n    }\n\n    return receivedValue;\n  }\n\n  if (ctx.type.length) {\n    if (!ctx.type.includes(typeOfVal)) throwException(ctx.type, typeOfVal, pathToError, 'Invalid type of data');\n  }\n\n  ctx.requiredValidations.forEach((requiredValidation) => {\n    requiredValidation(receivedValue, pathToError);\n  });\n\n  return receivedValue;\n}\n","import { ctxSymbol } from '../core';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type RequiredValidation = (received: any, pathToError: string) => void;\nexport type ObjectShapeSchemaType = Record<string, CommonSchema>;\n\nexport type PrimitiveType = 'number' | 'string' | 'boolean' | 'undefined' | 'object' | 'function' | 'symbol' | 'bigint';\nexport interface ValidatorContext {\n  type: PrimitiveType[];\n  isNullable?: boolean;\n  isOptional?: boolean;\n  requiredValidations: RequiredValidation[];\n  array?: CommonSchema;\n  object?: ObjectShapeSchemaType;\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  custom(...validators: RequiredValidation[]): this {\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  nullable(): WithNull<this> {\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  optional(): WithUndefined<this> {\n    this[ctxSymbol].isOptional = true;\n    return this as WithUndefined<this>;\n  }\n}\n\nexport type WithNull<T extends CommonSchema> = T & { validation_null: true };\nexport type WithUndefined<T extends CommonSchema> = T & { validation_undefined: true };\n\ntype TypeMapping = {\n  number: number;\n  string: string;\n  boolean: boolean;\n  undefined: undefined;\n  object: object;\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  function: Function;\n  symbol: symbol;\n  bigint: bigint;\n};\n\nexport type WithMix<Y = unknown> = CommonSchema & { validation_mix: Y };\nexport type ExtractFromMix<T> = T extends WithMix<infer X> ? X : never;\n\nexport type MapMixTypes<T extends PrimitiveType[]> = T extends (infer U)[]\n  ? U extends keyof TypeMapping\n    ? TypeMapping[U]\n    : never\n  : never;\n","import { equalTo } from '../asserts/common/equalTo';\nimport { CommonSchema } from './CommonSchema';\n\nexport class StringSchema extends CommonSchema {\n  _string = 1;\n\n  /**\n   * Restricts the schema to exactly match the specified value and infers the literal value as the TypeScript type.\n   *\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   *\n   * @example - string().equalTo('hello'); // Infers the type 'hello'\n   */\n  equalTo<Y extends string>(expectedValue: Y): WithString<this, Y> {\n    return this.custom(equalTo(expectedValue)) as WithString<this, Y>;\n  }\n}\n\nexport type WithString<T extends StringSchema, Y = string> = T & { validation_string: Y };\nexport type ExtractFromString<T> = T extends WithString<StringSchema, infer Y> ? Y : never;\n","import { StringSchema } from '../../schemas/StringSchema';\n\n/**\n * Creates a new schema for validating string values.\n *\n * @returns {StringSchema} A new instance of `StringSchema` for validating strings.\n *\n * @example\n * const schema = string();\n * parseSchema(schema, 'hello'); // Validates successfully\n * parseSchema(schema, 123); // Throws a validation error\n */\nexport function string(): StringSchema {\n  return new StringSchema({ type: ['string'], requiredValidations: [] });\n}\n"],"mappings":";AAAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ACSO,IAAM,UACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,aAAa;AACf,mBAAe,UAAU,UAAU,aAAa,6CAA6C;AACjG;;;AChCK,IAAM,YAAY,OAAO,eAAe;;;ACgBxC,IAAM,eAAN,MAAmB;AAAA,EACxB,CAAC,SAAS;AAAA,EACV,YAAY,KAAuB;AACjC,SAAK,SAAS,IAAI;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,YAAwC;AAChD,SAAK,SAAS,EAAE,oBAAoB,KAAK,GAAG,UAAU;AACtD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,WAA2B;AACzB,SAAK,SAAS,EAAE,aAAa;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,WAAgC;AAC9B,SAAK,SAAS,EAAE,aAAa;AAC7B,WAAO;AAAA,EACT;AACF;;;AC/CO,IAAM,eAAN,cAA2B,aAAa;AAAA,EAC7C,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUV,QAA0B,eAAuC;AAC/D,WAAO,KAAK,OAAO,QAAQ,aAAa,CAAC;AAAA,EAC3C;AACF;;;ACLO,SAAS,SAAuB;AACrC,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,QAAQ,GAAG,qBAAqB,CAAC,EAAE,CAAC;AACvE;","names":[]}

package/lib/asserts/string/maxLength.d.mts

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.mjs';
+
+/**
+ * Asserts that the length of a string value is not greater than a specified maximum length.
+ *
+ * @param {number} expected - The maximum allowed length for the string.
+ * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is greater than the expected length.
+ *
+ * @example
+ * const schema = string().custom(maxLength(10));
+ * parseSchema(schema, 'short');   // Valid
+ * parseSchema(schema, 'this is a very long string'); // Throws an error: 'The received value length is greater than expected'
+ */
+declare const maxLength: (expected: number) => RequiredValidation;
+
+export { maxLength };

package/lib/asserts/string/maxLength.d.ts

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.js';
+
+/**
+ * Asserts that the length of a string value is not greater than a specified maximum length.
+ *
+ * @param {number} expected - The maximum allowed length for the string.
+ * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is greater than the expected length.
+ *
+ * @example
+ * const schema = string().custom(maxLength(10));
+ * parseSchema(schema, 'short');   // Valid
+ * parseSchema(schema, 'this is a very long string'); // Throws an error: 'The received value length is greater than expected'
+ */
+declare const maxLength: (expected: number) => RequiredValidation;
+
+export { maxLength };

package/lib/asserts/string/maxLength.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/asserts/string/maxLength.ts
+var maxLength_exports = {};
+__export(maxLength_exports, {
+  maxLength: () => maxLength
+});
+module.exports = __toCommonJS(maxLength_exports);
+
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/string/maxLength.ts
+var maxLength = (expected) => (received, pathToError) => {
+  if (received.length > expected)
+    throwException(expected, received, pathToError, "The received value length is greater than expected");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  maxLength
+});
+//# sourceMappingURL=maxLength.js.map

package/lib/asserts/string/maxLength.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/string/maxLength.ts","../../../src/exceptions.ts"],"sourcesContent":["import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that the length of a string value is not greater than a specified maximum length.\n *\n * @param {number} expected - The maximum allowed length for the string.\n * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is greater than the expected length.\n *\n * @example\n * const schema = string().custom(maxLength(10));\n * parseSchema(schema, 'short');   // Valid\n * parseSchema(schema, 'this is a very long string'); // Throws an error: 'The received value length is greater than expected'\n */\nexport const maxLength =\n  (expected: number): RequiredValidation =>\n  (received: string, pathToError: string) => {\n    if (received.length > expected)\n      throwException(expected, received, pathToError, 'The received value length is greater than expected');\n  };\n","export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ADJO,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,SAAS,SAAS;AACpB,mBAAe,UAAU,UAAU,aAAa,oDAAoD;AACxG;","names":[]}

package/lib/asserts/string/maxLength.mjs

@@ -0,0 +1,27 @@
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/string/maxLength.ts
+var maxLength = (expected) => (received, pathToError) => {
+  if (received.length > expected)
+    throwException(expected, received, pathToError, "The received value length is greater than expected");
+};
+export {
+  maxLength
+};
+//# sourceMappingURL=maxLength.mjs.map

package/lib/asserts/string/maxLength.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/asserts/string/maxLength.ts"],"sourcesContent":["export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n","import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that the length of a string value is not greater than a specified maximum length.\n *\n * @param {number} expected - The maximum allowed length for the string.\n * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is greater than the expected length.\n *\n * @example\n * const schema = string().custom(maxLength(10));\n * parseSchema(schema, 'short');   // Valid\n * parseSchema(schema, 'this is a very long string'); // Throws an error: 'The received value length is greater than expected'\n */\nexport const maxLength =\n  (expected: number): RequiredValidation =>\n  (received: string, pathToError: string) => {\n    if (received.length > expected)\n      throwException(expected, received, pathToError, 'The received value length is greater than expected');\n  };\n"],"mappings":";AAAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ACJO,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,SAAS,SAAS;AACpB,mBAAe,UAAU,UAAU,aAAa,oDAAoD;AACxG;","names":[]}

package/lib/asserts/string/minLength.d.mts

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.mjs';
+
+/**
+ * Asserts that the length of a string value is not less than a specified minimum length.
+ *
+ * @param {number} expected - The minimum required length for the string.
+ * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is less than the expected length.
+ *
+ * @example
+ * const schema = string().custom(minLength(5));
+ * parseSchema(schema, 'short');   // Throws an error: 'The received value length is less than expected'
+ * parseSchema(schema, 'adequate'); // Valid
+ */
+declare const minLength: (expected: number) => RequiredValidation;
+
+export { minLength };

package/lib/asserts/string/minLength.d.ts

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.js';
+
+/**
+ * Asserts that the length of a string value is not less than a specified minimum length.
+ *
+ * @param {number} expected - The minimum required length for the string.
+ * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is less than the expected length.
+ *
+ * @example
+ * const schema = string().custom(minLength(5));
+ * parseSchema(schema, 'short');   // Throws an error: 'The received value length is less than expected'
+ * parseSchema(schema, 'adequate'); // Valid
+ */
+declare const minLength: (expected: number) => RequiredValidation;
+
+export { minLength };

package/lib/asserts/string/minLength.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/asserts/string/minLength.ts
+var minLength_exports = {};
+__export(minLength_exports, {
+  minLength: () => minLength
+});
+module.exports = __toCommonJS(minLength_exports);
+
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/string/minLength.ts
+var minLength = (expected) => (received, pathToError) => {
+  if (received.length < expected)
+    throwException(expected, received, pathToError, "The received value length is less than expected");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  minLength
+});
+//# sourceMappingURL=minLength.js.map

package/lib/asserts/string/minLength.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/string/minLength.ts","../../../src/exceptions.ts"],"sourcesContent":["import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that the length of a string value is not less than a specified minimum length.\n *\n * @param {number} expected - The minimum required length for the string.\n * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is less than the expected length.\n *\n * @example\n * const schema = string().custom(minLength(5));\n * parseSchema(schema, 'short');   // Throws an error: 'The received value length is less than expected'\n * parseSchema(schema, 'adequate'); // Valid\n */\nexport const minLength =\n  (expected: number): RequiredValidation =>\n  (received: string, pathToError: string) => {\n    if (received.length < expected)\n      throwException(expected, received, pathToError, 'The received value length is less than expected');\n  };\n","export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ADJO,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,SAAS,SAAS;AACpB,mBAAe,UAAU,UAAU,aAAa,iDAAiD;AACrG;","names":[]}

package/lib/asserts/string/minLength.mjs

@@ -0,0 +1,27 @@
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/string/minLength.ts
+var minLength = (expected) => (received, pathToError) => {
+  if (received.length < expected)
+    throwException(expected, received, pathToError, "The received value length is less than expected");
+};
+export {
+  minLength
+};
+//# sourceMappingURL=minLength.mjs.map

package/lib/asserts/string/minLength.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/asserts/string/minLength.ts"],"sourcesContent":["export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n","import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that the length of a string value is not less than a specified minimum length.\n *\n * @param {number} expected - The minimum required length for the string.\n * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the length of the received value is less than the expected length.\n *\n * @example\n * const schema = string().custom(minLength(5));\n * parseSchema(schema, 'short');   // Throws an error: 'The received value length is less than expected'\n * parseSchema(schema, 'adequate'); // Valid\n */\nexport const minLength =\n  (expected: number): RequiredValidation =>\n  (received: string, pathToError: string) => {\n    if (received.length < expected)\n      throwException(expected, received, pathToError, 'The received value length is less than expected');\n  };\n"],"mappings":";AAAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ACJO,IAAM,YACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,SAAS,SAAS;AACpB,mBAAe,UAAU,UAAU,aAAa,iDAAiD;AACrG;","names":[]}

package/lib/asserts/string/regExp.d.mts

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.mjs';
+
+/**
+ * Asserts that a string value matches a specified regular expression pattern.
+ *
+ * @param {RegExp} expected - The regular expression pattern that the string value should match.
+ * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the received value does not match the expected pattern.
+ *
+ * @example
+ * const schema = string().custom(regExp(/^[A-Za-z0-9]+$/)); // Validates against alphanumeric pattern
+ * parseSchema(schema, 'valid123'); // Valid
+ * parseSchema(schema, 'invalid!@#'); // Throws an error: 'The received value does not match the required text pattern'
+ */
+declare const regExp: (expected: RegExp) => RequiredValidation;
+
+export { regExp };

package/lib/asserts/string/regExp.d.ts

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.js';
+
+/**
+ * Asserts that a string value matches a specified regular expression pattern.
+ *
+ * @param {RegExp} expected - The regular expression pattern that the string value should match.
+ * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the received value does not match the expected pattern.
+ *
+ * @example
+ * const schema = string().custom(regExp(/^[A-Za-z0-9]+$/)); // Validates against alphanumeric pattern
+ * parseSchema(schema, 'valid123'); // Valid
+ * parseSchema(schema, 'invalid!@#'); // Throws an error: 'The received value does not match the required text pattern'
+ */
+declare const regExp: (expected: RegExp) => RequiredValidation;
+
+export { regExp };

package/lib/asserts/string/regExp.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/asserts/string/regExp.ts
+var regExp_exports = {};
+__export(regExp_exports, {
+  regExp: () => regExp
+});
+module.exports = __toCommonJS(regExp_exports);
+
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/string/regExp.ts
+var regExp = (expected) => (received, pathToError) => {
+  if (!expected.test(received))
+    throwException(expected, received, pathToError, "The received value does not match the required text pattern");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  regExp
+});
+//# sourceMappingURL=regExp.js.map

package/lib/asserts/string/regExp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/string/regExp.ts","../../../src/exceptions.ts"],"sourcesContent":["import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that a string value matches a specified regular expression pattern.\n *\n * @param {RegExp} expected - The regular expression pattern that the string value should match.\n * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the received value does not match the expected pattern.\n *\n * @example\n * const schema = string().custom(regExp(/^[A-Za-z0-9]+$/)); // Validates against alphanumeric pattern\n * parseSchema(schema, 'valid123'); // Valid\n * parseSchema(schema, 'invalid!@#'); // Throws an error: 'The received value does not match the required text pattern'\n */\nexport const regExp =\n  (expected: RegExp): RequiredValidation =>\n  (received: string, pathToError: string) => {\n    if (!expected.test(received))\n      throwException(expected, received, pathToError, 'The received value does not match the required text pattern');\n  };\n","export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ADJO,IAAM,SACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,CAAC,SAAS,KAAK,QAAQ;AACzB,mBAAe,UAAU,UAAU,aAAa,6DAA6D;AACjH;","names":[]}

package/lib/asserts/string/regExp.mjs

@@ -0,0 +1,27 @@
+// src/exceptions.ts
+var ValidationError = class extends Error {
+  expected;
+  received;
+  pathToError;
+  message;
+  constructor(expected, received, pathToError, message) {
+    super();
+    this.expected = expected;
+    this.received = received;
+    this.pathToError = pathToError;
+    this.message = message;
+  }
+};
+function throwException(expected, received, pathToError, message) {
+  throw new ValidationError(expected, received, pathToError, message);
+}
+
+// src/asserts/string/regExp.ts
+var regExp = (expected) => (received, pathToError) => {
+  if (!expected.test(received))
+    throwException(expected, received, pathToError, "The received value does not match the required text pattern");
+};
+export {
+  regExp
+};
+//# sourceMappingURL=regExp.mjs.map

package/lib/asserts/string/regExp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/asserts/string/regExp.ts"],"sourcesContent":["export class ValidationError extends Error {\n  expected: unknown;\n  received: unknown;\n  pathToError: string;\n  message: string;\n  constructor(expected: unknown, received: unknown, pathToError: string, message: string) {\n    super();\n    this.expected = expected;\n    this.received = received;\n    this.pathToError = pathToError;\n    this.message = message;\n  }\n}\n\nexport class BuildSchemaError extends Error {}\n\nexport function throwException(expected: unknown, received: unknown, pathToError: string, message: string): never {\n  throw new ValidationError(expected, received, pathToError, message);\n}\n","import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that a string value matches a specified regular expression pattern.\n *\n * @param {RegExp} expected - The regular expression pattern that the string value should match.\n * @returns {RequiredValidation} - A validation function that takes a received string and a path to the error message. Throws an error if the received value does not match the expected pattern.\n *\n * @example\n * const schema = string().custom(regExp(/^[A-Za-z0-9]+$/)); // Validates against alphanumeric pattern\n * parseSchema(schema, 'valid123'); // Valid\n * parseSchema(schema, 'invalid!@#'); // Throws an error: 'The received value does not match the required text pattern'\n */\nexport const regExp =\n  (expected: RegExp): RequiredValidation =>\n  (received: string, pathToError: string) => {\n    if (!expected.test(received))\n      throwException(expected, received, pathToError, 'The received value does not match the required text pattern');\n  };\n"],"mappings":";AAAO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,UAAmB,UAAmB,aAAqB,SAAiB;AACtF,UAAM;AACN,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;AAIO,SAAS,eAAe,UAAmB,UAAmB,aAAqB,SAAwB;AAChH,QAAM,IAAI,gBAAgB,UAAU,UAAU,aAAa,OAAO;AACpE;;;ACJO,IAAM,SACX,CAAC,aACD,CAAC,UAAkB,gBAAwB;AACzC,MAAI,CAAC,SAAS,KAAK,QAAQ;AACzB,mBAAe,UAAU,UAAU,aAAa,6DAA6D;AACjH;","names":[]}

package/lib/index-B1yBez0g.d.ts

@@ -0,0 +1,39 @@
+import { C as CommonSchema } from './CommonSchema-DeTBsQhn.js';
+
+declare class BooleanSchema extends CommonSchema {
+    _boolean: number;
+    /**
+     * Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.
+     *
+     * @returns - The schema instance restricted to the value true, with the true value inferred as the TypeScript type
+     *
+     * @example - boolean().onlyTrue(); // Infers the type true
+     */
+    onlyTrue(): WithBoolean<this, true>;
+    /**
+     * Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.
+     *
+     * @returns - The schema instance restricted to the value false, with the false value inferred as the TypeScript type
+     *
+     * @example - boolean().onlyFalse(); // Infers the type false
+     */
+    onlyFalse(): WithBoolean<this, false>;
+}
+type WithBoolean<T extends BooleanSchema, Y = boolean> = T & {
+    validation_boolean: Y;
+};
+type ExtractFromBoolean<T> = T extends WithBoolean<BooleanSchema, infer Y> ? Y : never;
+
+/**
+ * Creates a new schema for validating boolean values.
+ *
+ * @returns {BooleanSchema} A new instance of `BooleanSchema` for validating booleans.
+ *
+ * @example
+ * const schema = boolean();
+ * parseSchema(schema, true); // Validates successfully
+ * parseSchema(schema, 'true'); // Throws a validation error
+ */
+declare function boolean(): BooleanSchema;
+
+export { BooleanSchema as B, type ExtractFromBoolean as E, type WithBoolean as W, boolean as b };

package/lib/index-B63cXDOm.d.mts

@@ -0,0 +1,32 @@
+import { C as CommonSchema } from './CommonSchema-DeTBsQhn.mjs';
+
+declare class NumberSchema extends CommonSchema {
+    _number: number;
+    /**
+     * 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
+     */
+    equalTo<Y extends number>(expectedValue: Y): WithNumber<this, Y>;
+}
+type WithNumber<T extends NumberSchema, Y = number> = T & {
+    validation_number: Y;
+};
+type ExtractFromNumber<T> = T extends WithNumber<NumberSchema, infer Y> ? Y : never;
+
+/**
+ * Creates a new schema for validating number values.
+ *
+ * @returns {NumberSchema} A new instance of `NumberSchema` for validating numbers.
+ *
+ * @example
+ * const schema = number();
+ * parseSchema(schema, 42); // Validates successfully
+ * parseSchema(schema, '42'); // Throws a validation error
+ */
+declare function number(): NumberSchema;
+
+export { type ExtractFromNumber as E, NumberSchema as N, type WithNumber as W, number as n };

package/lib/index-BEyBEBSm.d.ts

@@ -0,0 +1,32 @@
+import { C as CommonSchema } from './CommonSchema-DeTBsQhn.js';
+
+declare class StringSchema extends CommonSchema {
+    _string: number;
+    /**
+     * 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 - string().equalTo('hello'); // Infers the type 'hello'
+     */
+    equalTo<Y extends string>(expectedValue: Y): WithString<this, Y>;
+}
+type WithString<T extends StringSchema, Y = string> = T & {
+    validation_string: Y;
+};
+type ExtractFromString<T> = T extends WithString<StringSchema, infer Y> ? Y : never;
+
+/**
+ * Creates a new schema for validating string values.
+ *
+ * @returns {StringSchema} A new instance of `StringSchema` for validating strings.
+ *
+ * @example
+ * const schema = string();
+ * parseSchema(schema, 'hello'); // Validates successfully
+ * parseSchema(schema, 123); // Throws a validation error
+ */
+declare function string(): StringSchema;
+
+export { type ExtractFromString as E, StringSchema as S, type WithString as W, string as s };

package/lib/index-CK_g_aEC.d.ts

@@ -0,0 +1,32 @@
+import { C as CommonSchema } from './CommonSchema-DeTBsQhn.js';
+
+declare class NumberSchema extends CommonSchema {
+    _number: number;
+    /**
+     * 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
+     */
+    equalTo<Y extends number>(expectedValue: Y): WithNumber<this, Y>;
+}
+type WithNumber<T extends NumberSchema, Y = number> = T & {
+    validation_number: Y;
+};
+type ExtractFromNumber<T> = T extends WithNumber<NumberSchema, infer Y> ? Y : never;
+
+/**
+ * Creates a new schema for validating number values.
+ *
+ * @returns {NumberSchema} A new instance of `NumberSchema` for validating numbers.
+ *
+ * @example
+ * const schema = number();
+ * parseSchema(schema, 42); // Validates successfully
+ * parseSchema(schema, '42'); // Throws a validation error
+ */
+declare function number(): NumberSchema;
+
+export { type ExtractFromNumber as E, NumberSchema as N, type WithNumber as W, number as n };