bguard 0.0.2 → 0.0.4

package/lib/asserts/number/positive.js

@@ -0,0 +1,53 @@
+"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/number/positive.ts
+var positive_exports = {};
+__export(positive_exports, {
+  positive: () => positive
+});
+module.exports = __toCommonJS(positive_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/number/positive.ts
+var positive = () => (received, pathToError) => {
+  if (received <= 0) throwException("positive", received, pathToError, "The received value is not a positive number");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  positive
+});
+//# sourceMappingURL=positive.js.map

package/lib/asserts/number/positive.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/number/positive.ts","../../../src/exceptions.ts"],"sourcesContent":["import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\n/**\n * Asserts that a number value is positive (greater than zero).\n *\n * @returns {RequiredValidation} - A validation function that takes a received number and a path to the error message. Throws an error if the received value is not positive.\n *\n * @example\n * const schema = number().custom(positive());\n * parseSchema(schema, 10);  // Valid\n * parseSchema(schema, 0);  // Throws an error: 'The received value is not a positive number'\n * parseSchema(schema, -5); // Throws an error: 'The received value is not a positive number'\n */\nexport const positive = (): RequiredValidation => (received: number, pathToError: string) => {\n  if (received <= 0) throwException('positive', received, pathToError, 'The received value is not a positive number');\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,WAAW,MAA0B,CAAC,UAAkB,gBAAwB;AAC3F,MAAI,YAAY,EAAG,gBAAe,YAAY,UAAU,aAAa,6CAA6C;AACpH;","names":[]}

package/lib/asserts/number/positive.mjs

@@ -0,0 +1,26 @@
+// 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/number/positive.ts
+var positive = () => (received, pathToError) => {
+  if (received <= 0) throwException("positive", received, pathToError, "The received value is not a positive number");
+};
+export {
+  positive
+};
+//# sourceMappingURL=positive.mjs.map

package/lib/asserts/number/positive.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/asserts/number/positive.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 number value is positive (greater than zero).\n *\n * @returns {RequiredValidation} - A validation function that takes a received number and a path to the error message. Throws an error if the received value is not positive.\n *\n * @example\n * const schema = number().custom(positive());\n * parseSchema(schema, 10);  // Valid\n * parseSchema(schema, 0);  // Throws an error: 'The received value is not a positive number'\n * parseSchema(schema, -5); // Throws an error: 'The received value is not a positive number'\n */\nexport const positive = (): RequiredValidation => (received: number, pathToError: string) => {\n  if (received <= 0) throwException('positive', received, pathToError, 'The received value is not a positive number');\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,WAAW,MAA0B,CAAC,UAAkB,gBAAwB;AAC3F,MAAI,YAAY,EAAG,gBAAe,YAAY,UAAU,aAAa,6CAA6C;AACpH;","names":[]}

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

@@ -0,0 +1,2 @@
+import '../../CommonSchema-DeTBsQhn.mjs';
+export { o as object } from '../../index-D3R2euaT.mjs';

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

@@ -0,0 +1,2 @@
+import '../../CommonSchema-DeTBsQhn.js';
+export { o as object } from '../../index-DPkImfCy.js';

package/lib/asserts/object/index.js

@@ -0,0 +1,94 @@
+"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/object/index.ts
+var object_exports = {};
+__export(object_exports, {
+  object: () => object
+});
+module.exports = __toCommonJS(object_exports);
+
+// src/exceptions.ts
+var BuildSchemaError = class extends Error {
+};
+
+// 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/ObjectSchema.ts
+var ObjectSchema = class extends CommonSchema {
+  _object = 1;
+  constructor(ctx, shapeSchema) {
+    super(ctx);
+    this.validateObjectEntry(shapeSchema);
+    this[ctxSymbol].object = shapeSchema;
+  }
+  validateObjectEntry(shapeSchema) {
+    if (!shapeSchema) throw new BuildSchemaError("Missing schema in object method");
+    if (shapeSchema instanceof CommonSchema) throw new BuildSchemaError("Invalid schema in object");
+    for (const [key, value] of Object.entries(shapeSchema)) {
+      if (!(value instanceof CommonSchema))
+        throw new BuildSchemaError(`Invalid schema in object method for property '${key}'`);
+    }
+  }
+};
+
+// src/asserts/object/index.ts
+function object(shapeSchema) {
+  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  object
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/object/index.ts","../../../src/exceptions.ts","../../../src/core.ts","../../../src/schemas/CommonSchema.ts","../../../src/schemas/ObjectSchema.ts"],"sourcesContent":["import { ObjectShapeSchemaType } from '../../schemas/CommonSchema';\nimport { ObjectSchema, WithObject } from '../../schemas/ObjectSchema';\n\n/**\n * Creates a new schema for validating objects where each property must match the specified schema.\n *\n * @template T\n * @param {T} shapeSchema - The schema that each property of the object must match.\n * @returns {WithObject<T>} A new instance of `ObjectSchema` for validating objects with properties matching the specified schema.\n *\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number()\n * });\n * parseSchema(schema, { name: 'John', age: 30 }); // Validates successfully\n * parseSchema(schema, { name: 'John', age: '30' }); // Throws a validation error\n */\nexport function object<T extends ObjectShapeSchemaType>(shapeSchema: T): WithObject<T> {\n  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema) as WithObject<T>;\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","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 { ctxSymbol } from '../core';\nimport { BuildSchemaError } from '../exceptions';\nimport { CommonSchema, ObjectShapeSchemaType, ValidatorContext } from './CommonSchema';\n\nexport class ObjectSchema extends CommonSchema {\n  _object = 1;\n  constructor(ctx: ValidatorContext, shapeSchema: ObjectShapeSchemaType) {\n    super(ctx);\n    this.validateObjectEntry(shapeSchema);\n    this[ctxSymbol].object = shapeSchema;\n  }\n\n  private validateObjectEntry(shapeSchema: ObjectShapeSchemaType) {\n    if (!shapeSchema) throw new BuildSchemaError('Missing schema in object method');\n    if (shapeSchema instanceof CommonSchema) throw new BuildSchemaError('Invalid schema in object');\n    for (const [key, value] of Object.entries(shapeSchema)) {\n      if (!(value instanceof CommonSchema))\n        throw new BuildSchemaError(`Invalid schema in object method for property '${key}'`);\n    }\n  }\n}\n\nexport type WithObject<Y extends ObjectShapeSchemaType> = ObjectSchema & { validation_object: Y };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcO,IAAM,mBAAN,cAA+B,MAAM;AAAC;;;ACdtC,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;;;AC9CO,IAAM,eAAN,cAA2B,aAAa;AAAA,EAC7C,UAAU;AAAA,EACV,YAAY,KAAuB,aAAoC;AACrE,UAAM,GAAG;AACT,SAAK,oBAAoB,WAAW;AACpC,SAAK,SAAS,EAAE,SAAS;AAAA,EAC3B;AAAA,EAEQ,oBAAoB,aAAoC;AAC9D,QAAI,CAAC,YAAa,OAAM,IAAI,iBAAiB,iCAAiC;AAC9E,QAAI,uBAAuB,aAAc,OAAM,IAAI,iBAAiB,0BAA0B;AAC9F,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,GAAG;AACtD,UAAI,EAAE,iBAAiB;AACrB,cAAM,IAAI,iBAAiB,iDAAiD,GAAG,GAAG;AAAA,IACtF;AAAA,EACF;AACF;;;AJFO,SAAS,OAAwC,aAA+B;AACrF,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,GAAG,WAAW;AAC5E;","names":[]}

package/lib/asserts/object/index.mjs

@@ -0,0 +1,67 @@
+// src/exceptions.ts
+var BuildSchemaError = class extends Error {
+};
+
+// 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/ObjectSchema.ts
+var ObjectSchema = class extends CommonSchema {
+  _object = 1;
+  constructor(ctx, shapeSchema) {
+    super(ctx);
+    this.validateObjectEntry(shapeSchema);
+    this[ctxSymbol].object = shapeSchema;
+  }
+  validateObjectEntry(shapeSchema) {
+    if (!shapeSchema) throw new BuildSchemaError("Missing schema in object method");
+    if (shapeSchema instanceof CommonSchema) throw new BuildSchemaError("Invalid schema in object");
+    for (const [key, value] of Object.entries(shapeSchema)) {
+      if (!(value instanceof CommonSchema))
+        throw new BuildSchemaError(`Invalid schema in object method for property '${key}'`);
+    }
+  }
+};
+
+// src/asserts/object/index.ts
+function object(shapeSchema) {
+  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema);
+}
+export {
+  object
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/core.ts","../../../src/schemas/CommonSchema.ts","../../../src/schemas/ObjectSchema.ts","../../../src/asserts/object/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","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 { ctxSymbol } from '../core';\nimport { BuildSchemaError } from '../exceptions';\nimport { CommonSchema, ObjectShapeSchemaType, ValidatorContext } from './CommonSchema';\n\nexport class ObjectSchema extends CommonSchema {\n  _object = 1;\n  constructor(ctx: ValidatorContext, shapeSchema: ObjectShapeSchemaType) {\n    super(ctx);\n    this.validateObjectEntry(shapeSchema);\n    this[ctxSymbol].object = shapeSchema;\n  }\n\n  private validateObjectEntry(shapeSchema: ObjectShapeSchemaType) {\n    if (!shapeSchema) throw new BuildSchemaError('Missing schema in object method');\n    if (shapeSchema instanceof CommonSchema) throw new BuildSchemaError('Invalid schema in object');\n    for (const [key, value] of Object.entries(shapeSchema)) {\n      if (!(value instanceof CommonSchema))\n        throw new BuildSchemaError(`Invalid schema in object method for property '${key}'`);\n    }\n  }\n}\n\nexport type WithObject<Y extends ObjectShapeSchemaType> = ObjectSchema & { validation_object: Y };\n","import { ObjectShapeSchemaType } from '../../schemas/CommonSchema';\nimport { ObjectSchema, WithObject } from '../../schemas/ObjectSchema';\n\n/**\n * Creates a new schema for validating objects where each property must match the specified schema.\n *\n * @template T\n * @param {T} shapeSchema - The schema that each property of the object must match.\n * @returns {WithObject<T>} A new instance of `ObjectSchema` for validating objects with properties matching the specified schema.\n *\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number()\n * });\n * parseSchema(schema, { name: 'John', age: 30 }); // Validates successfully\n * parseSchema(schema, { name: 'John', age: '30' }); // Throws a validation error\n */\nexport function object<T extends ObjectShapeSchemaType>(shapeSchema: T): WithObject<T> {\n  return new ObjectSchema({ type: [], requiredValidations: [] }, shapeSchema) as WithObject<T>;\n}\n"],"mappings":";AAcO,IAAM,mBAAN,cAA+B,MAAM;AAAC;;;ACdtC,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;;;AC9CO,IAAM,eAAN,cAA2B,aAAa;AAAA,EAC7C,UAAU;AAAA,EACV,YAAY,KAAuB,aAAoC;AACrE,UAAM,GAAG;AACT,SAAK,oBAAoB,WAAW;AACpC,SAAK,SAAS,EAAE,SAAS;AAAA,EAC3B;AAAA,EAEQ,oBAAoB,aAAoC;AAC9D,QAAI,CAAC,YAAa,OAAM,IAAI,iBAAiB,iCAAiC;AAC9E,QAAI,uBAAuB,aAAc,OAAM,IAAI,iBAAiB,0BAA0B;AAC9F,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,GAAG;AACtD,UAAI,EAAE,iBAAiB;AACrB,cAAM,IAAI,iBAAiB,iDAAiD,GAAG,GAAG;AAAA,IACtF;AAAA,EACF;AACF;;;ACFO,SAAS,OAAwC,aAA+B;AACrF,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,GAAG,WAAW;AAC5E;","names":[]}

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

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.mjs';
+
+/**
+ * Asserts that a string value matches the email pattern.
+ * The pattern is defined as /^[^@]+@[^@]+\.[^@]+$/, which checks for a basic email format.
+ *
+ * @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 email pattern.
+ *
+ * @example
+ * const schema = string().custom(email());
+ * parseSchema(schema, 'example@example.com'); // Valid
+ * parseSchema(schema, 'invalid-email');      // Throws an error: 'The received value does not match the required email pattern'
+ */
+declare const email: () => RequiredValidation;
+
+export { email };

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

@@ -0,0 +1,16 @@
+import { R as RequiredValidation } from '../../CommonSchema-DeTBsQhn.js';
+
+/**
+ * Asserts that a string value matches the email pattern.
+ * The pattern is defined as /^[^@]+@[^@]+\.[^@]+$/, which checks for a basic email format.
+ *
+ * @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 email pattern.
+ *
+ * @example
+ * const schema = string().custom(email());
+ * parseSchema(schema, 'example@example.com'); // Valid
+ * parseSchema(schema, 'invalid-email');      // Throws an error: 'The received value does not match the required email pattern'
+ */
+declare const email: () => RequiredValidation;
+
+export { email };

package/lib/asserts/string/email.js

@@ -0,0 +1,55 @@
+"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/email.ts
+var email_exports = {};
+__export(email_exports, {
+  email: () => email
+});
+module.exports = __toCommonJS(email_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/email.ts
+var emailRegExp = /^[^@]+@[^@]+\.[^@]+$/;
+var email = () => (received, pathToError) => {
+  if (!emailRegExp.test(received))
+    throwException(emailRegExp, received, pathToError, "The received value does not match the required email pattern");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  email
+});
+//# sourceMappingURL=email.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/string/email.ts","../../../src/exceptions.ts"],"sourcesContent":["import { throwException } from '../../exceptions';\nimport type { RequiredValidation } from '../../schemas/CommonSchema';\n\nconst emailRegExp = /^[^@]+@[^@]+\\.[^@]+$/;\n\n/**\n * Asserts that a string value matches the email pattern.\n * The pattern is defined as /^[^@]+@[^@]+\\.[^@]+$/, which checks for a basic email format.\n *\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 email pattern.\n *\n * @example\n * const schema = string().custom(email());\n * parseSchema(schema, 'example@example.com'); // Valid\n * parseSchema(schema, 'invalid-email');      // Throws an error: 'The received value does not match the required email pattern'\n */\nexport const email = (): RequiredValidation => (received: string, pathToError: string) => {\n  if (!emailRegExp.test(received))\n    throwException(emailRegExp, received, pathToError, 'The received value does not match the required email 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;;;ADfA,IAAM,cAAc;AAab,IAAM,QAAQ,MAA0B,CAAC,UAAkB,gBAAwB;AACxF,MAAI,CAAC,YAAY,KAAK,QAAQ;AAC5B,mBAAe,aAAa,UAAU,aAAa,8DAA8D;AACrH;","names":[]}

package/lib/asserts/string/email.mjs

@@ -0,0 +1,28 @@
+// 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/email.ts
+var emailRegExp = /^[^@]+@[^@]+\.[^@]+$/;
+var email = () => (received, pathToError) => {
+  if (!emailRegExp.test(received))
+    throwException(emailRegExp, received, pathToError, "The received value does not match the required email pattern");
+};
+export {
+  email
+};
+//# sourceMappingURL=email.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exceptions.ts","../../../src/asserts/string/email.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\nconst emailRegExp = /^[^@]+@[^@]+\\.[^@]+$/;\n\n/**\n * Asserts that a string value matches the email pattern.\n * The pattern is defined as /^[^@]+@[^@]+\\.[^@]+$/, which checks for a basic email format.\n *\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 email pattern.\n *\n * @example\n * const schema = string().custom(email());\n * parseSchema(schema, 'example@example.com'); // Valid\n * parseSchema(schema, 'invalid-email');      // Throws an error: 'The received value does not match the required email pattern'\n */\nexport const email = (): RequiredValidation => (received: string, pathToError: string) => {\n  if (!emailRegExp.test(received))\n    throwException(emailRegExp, received, pathToError, 'The received value does not match the required email 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;;;ACfA,IAAM,cAAc;AAab,IAAM,QAAQ,MAA0B,CAAC,UAAkB,gBAAwB;AACxF,MAAI,CAAC,YAAY,KAAK,QAAQ;AAC5B,mBAAe,aAAa,UAAU,aAAa,8DAA8D;AACrH;","names":[]}

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

@@ -0,0 +1,2 @@
+export { s as string } from '../../index-aBEYpJdZ.mjs';
+import '../../CommonSchema-DeTBsQhn.mjs';

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

@@ -0,0 +1,2 @@
+export { s as string } from '../../index-BEyBEBSm.js';
+import '../../CommonSchema-DeTBsQhn.js';

package/lib/asserts/string/index.js

@@ -0,0 +1,112 @@
+"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/index.ts
+var string_exports = {};
+__export(string_exports, {
+  string: () => string
+});
+module.exports = __toCommonJS(string_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/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: [] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  string
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/asserts/string/index.ts","../../../src/exceptions.ts","../../../src/asserts/common/equalTo.ts","../../../src/core.ts","../../../src/schemas/CommonSchema.ts","../../../src/schemas/StringSchema.ts"],"sourcesContent":["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","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"],"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;;;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;;;ALLO,SAAS,SAAuB;AACrC,SAAO,IAAI,aAAa,EAAE,MAAM,CAAC,QAAQ,GAAG,qBAAqB,CAAC,EAAE,CAAC;AACvE;","names":[]}