bguard 0.0.4 → 0.0.5

package/lib/__tests__/BooleanSchema.test.js

@@ -0,0 +1,219 @@
+"use strict";
+
+// jest/setup.ts
+function expectEqualTypes(areEqual) {
+  expect(typeof areEqual).toBe("boolean");
+}
+
+// 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/core.ts
+var ctxSymbol = Symbol("contextSymbol");
+function innerCheck(schema, receivedValue, pathToError) {
+  const ctx = schema[ctxSymbol];
+  if (receivedValue === void 0) {
+    if (!ctx.isOptional) throwException("Required", receivedValue, pathToError, "The required value is missing");
+    return receivedValue;
+  }
+  if (receivedValue === null) {
+    if (!ctx.isNullable) throwException("Not null", receivedValue, pathToError, "Value should not be null");
+    return receivedValue;
+  }
+  if (ctx.array) {
+    if (!Array.isArray(receivedValue))
+      throwException("Array", receivedValue, pathToError, "Expected an array but received a different type");
+    const schema2 = ctx.array;
+    receivedValue.forEach((elem, i) => {
+      innerCheck(schema2, elem, `${pathToError}[${i}]`);
+    });
+    return receivedValue;
+  }
+  const typeOfVal = typeof receivedValue;
+  if (ctx.object) {
+    if (typeOfVal !== "object")
+      throwException("Object", receivedValue, pathToError, "Expected an object but received a different type");
+    if (Array.isArray(receivedValue))
+      throwException(
+        "Object",
+        receivedValue,
+        pathToError,
+        "Expected an object but received an array. Invalid type of data"
+      );
+    const shapeSchema = ctx.object;
+    for (const keyPerReceivedValue of Object.keys(receivedValue)) {
+      if (shapeSchema[keyPerReceivedValue] === void 0)
+        throwException("Not allowed", keyPerReceivedValue, pathToError, "This key is not allowed in the object");
+    }
+    for (const [keyOfSchema, valueOfSchema] of Object.entries(shapeSchema)) {
+      const receivedObjectValuePropery = receivedValue[keyOfSchema];
+      if (receivedObjectValuePropery === void 0) {
+        if (!valueOfSchema[ctxSymbol].isOptional)
+          throwException(
+            "Required",
+            receivedObjectValuePropery,
+            pathToError,
+            "Missing required property in the object"
+          );
+      }
+      innerCheck(valueOfSchema, receivedObjectValuePropery, `${pathToError}.${keyOfSchema}`);
+    }
+    return receivedValue;
+  }
+  if (ctx.type.length) {
+    if (!ctx.type.includes(typeOfVal)) throwException(ctx.type, typeOfVal, pathToError, "Invalid type of data");
+  }
+  ctx.requiredValidations.forEach((requiredValidation) => {
+    requiredValidation(receivedValue, pathToError);
+  });
+  return receivedValue;
+}
+
+// src/parseSchema.ts
+function parseSchema(schema, receivedValue) {
+  try {
+    return innerCheck(schema, receivedValue, "");
+  } catch (e) {
+    if (e instanceof ValidationError) throw e;
+    throw new Error("Something unexpected happened");
+  }
+}
+
+// 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/BooleanSchema.ts
+var isBoolean = (expected) => (received, pathToError) => {
+  if (received !== expected) throwException(expected, received, pathToError, `The received value is not ${expected}`);
+};
+var BooleanSchema = class extends CommonSchema {
+  _boolean = 1;
+  /**
+   * 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() {
+    return this.custom(isBoolean(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() {
+    return this.custom(isBoolean(false));
+  }
+};
+
+// src/asserts/boolean/index.ts
+function boolean() {
+  return new BooleanSchema({ type: ["boolean"], requiredValidations: [] });
+}
+
+// src/__tests__/BooleanSchema.test.ts
+describe("BooleanSchema", () => {
+  it("should be a boolean", () => {
+    const booleanSchema = boolean();
+    expectEqualTypes(true);
+    expect(parseSchema(booleanSchema, true)).toBe(true);
+    expect(parseSchema(booleanSchema, false)).toBe(false);
+  });
+  it("should not be a boolean", () => {
+    const booleanSchema = boolean();
+    const actualNotBoolean = 9;
+    expectEqualTypes(false);
+    expect(() => parseSchema(booleanSchema, actualNotBoolean)).toThrow("Invalid type of data");
+  });
+  it("should be true", () => {
+    const booleanSchema = boolean().onlyTrue();
+    expectEqualTypes(true);
+    expectEqualTypes(false);
+    expect(parseSchema(booleanSchema, true)).toBe(true);
+    expect(() => parseSchema(booleanSchema, false)).toThrow("The received value is not true");
+  });
+  it("should be false", () => {
+    const booleanSchema = boolean().onlyFalse();
+    expectEqualTypes(true);
+    expectEqualTypes(false);
+    expect(parseSchema(booleanSchema, false)).toBe(false);
+    expect(() => parseSchema(booleanSchema, true)).toThrow("The received value is not false");
+  });
+  it("should have proper types", () => {
+    const booleanSchema = boolean();
+    const booleanOrNullSchema = boolean().nullable();
+    const booleanOrUndefinedSchema = boolean().optional();
+    const booleanOrNullOrUndefinedSchema = boolean().nullable().optional();
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    const falseSchema = boolean().onlyFalse();
+    const falseOrNullSchema = boolean().onlyFalse().nullable();
+    const falseOrUndefinedSchema = boolean().onlyFalse().optional();
+    const falseOrNullOrUndefinedSchema = boolean().onlyFalse().nullable().optional();
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    const trueSchema = boolean().onlyTrue();
+    const trueOrNullSchema = boolean().onlyTrue().nullable();
+    const trueOrUndefinedSchema = boolean().onlyTrue().optional();
+    const trueOrNullOrUndefinedSchema = boolean().onlyTrue().nullable().optional();
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+  });
+});
+//# sourceMappingURL=BooleanSchema.test.js.map

package/lib/__tests__/BooleanSchema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../jest/setup.ts","../../src/exceptions.ts","../../src/core.ts","../../src/parseSchema.ts","../../src/schemas/CommonSchema.ts","../../src/schemas/BooleanSchema.ts","../../src/asserts/boolean/index.ts","../../src/__tests__/BooleanSchema.test.ts"],"sourcesContent":["export type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport function expectEqualTypes<X, Y>(areEqual: Equal<X, Y>): void {\n  expect(typeof areEqual).toBe('boolean');\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 { InferType } from './InferType';\nimport { innerCheck } from './core';\nimport { ValidationError } from './exceptions';\nimport { CommonSchema } from './schemas/CommonSchema';\n\n/**\n * Parses and validates a value against the provided schema, returning a type-safe result.\n *\n * This function will throw a `ValidationError` if the value does not conform to the schema.\n * The inferred TypeScript type of the returned value will match the structure defined by the schema.\n *\n * @template T\n * @param {T} schema - The schema to validate the received value against. This schema dictates the expected structure and type of the value.\n * @param {unknown} receivedValue - The value to be validated and parsed according to the schema.\n * @returns {InferType<T>} The validated value, with its TypeScript type inferred from the schema.\n *\n * @throws {ValidationError} If the received value does not match the schema, a `ValidationError` will be thrown.\n * @throws {Error} If an unexpected error occurs during validation, an error will be thrown with a generic message.\n *\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number(),\n * });\n *\n * const result = parseSchema(schema, { name: 'Alice', age: 30 });\n * // result will be inferred as { name: string; age: number }\n *\n * parseSchema(schema, { name: 'Alice', age: '30' });\n * // Throws ValidationError because 'age' should be a number, not a string.\n */\nexport function parseSchema<T extends CommonSchema>(schema: T, receivedValue: unknown): InferType<T> {\n  try {\n    return innerCheck(schema, receivedValue, '') as InferType<T>;\n  } catch (e) {\n    if (e instanceof ValidationError) throw e;\n    /* istanbul ignore next */\n    throw new Error('Something unexpected happened');\n  }\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 { CommonSchema } from './CommonSchema';\nimport { throwException } from '../exceptions';\n\nconst isBoolean = (expected: boolean) => (received: boolean, pathToError: string) => {\n  if (received !== expected) throwException(expected, received, pathToError, `The received value is not ${expected}`);\n};\n\nexport class BooleanSchema extends CommonSchema {\n  _boolean = 1;\n\n  /**\n   * Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.\n   *\n   * @returns - The schema instance restricted to the value true, with the true value inferred as the TypeScript type\n   *\n   * @example - boolean().onlyTrue(); // Infers the type true\n   */\n  onlyTrue(): WithBoolean<this, true> {\n    return this.custom(isBoolean(true)) as WithBoolean<this, true>;\n  }\n\n  /**\n   * Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.\n   *\n   * @returns - The schema instance restricted to the value false, with the false value inferred as the TypeScript type\n   *\n   * @example - boolean().onlyFalse(); // Infers the type false\n   */\n  onlyFalse(): WithBoolean<this, false> {\n    return this.custom(isBoolean(false)) as WithBoolean<this, false>;\n  }\n}\n\nexport type WithBoolean<T extends BooleanSchema, Y = boolean> = T & { validation_boolean: Y };\nexport type ExtractFromBoolean<T> = T extends WithBoolean<BooleanSchema, infer Y> ? Y : never;\n","import { BooleanSchema } from '../../schemas/BooleanSchema';\n\n/**\n * Creates a new schema for validating boolean values.\n *\n * @returns {BooleanSchema} A new instance of `BooleanSchema` for validating booleans.\n *\n * @example\n * const schema = boolean();\n * parseSchema(schema, true); // Validates successfully\n * parseSchema(schema, 'true'); // Throws a validation error\n */\nexport function boolean(): BooleanSchema {\n  return new BooleanSchema({ type: ['boolean'], requiredValidations: [] });\n}\n","/* eslint-disable @typescript-eslint/no-unused-vars */\nimport { expectEqualTypes } from '../../jest/setup';\nimport { parseSchema } from '../parseSchema';\nimport { InferType } from '../InferType';\nimport { boolean } from '../asserts/boolean';\n\ndescribe('BooleanSchema', () => {\n  it('should be a boolean', () => {\n    const booleanSchema = boolean();\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(true);\n    expect(parseSchema(booleanSchema, true)).toBe(true);\n    expect(parseSchema(booleanSchema, false)).toBe(false);\n  });\n\n  it('should not be a boolean', () => {\n    const booleanSchema = boolean();\n    // eslint-disable-next-line @typescript-eslint/no-inferrable-types\n    const actualNotBoolean: number = 9;\n\n    expectEqualTypes<typeof actualNotBoolean, InferType<typeof booleanSchema>>(false);\n    expect(() => parseSchema(booleanSchema, actualNotBoolean)).toThrow('Invalid type of data');\n  });\n\n  it('should be true', () => {\n    const booleanSchema = boolean().onlyTrue();\n\n    expectEqualTypes<true, InferType<typeof booleanSchema>>(true);\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(false);\n    expect(parseSchema(booleanSchema, true)).toBe(true);\n    expect(() => parseSchema(booleanSchema, false)).toThrow('The received value is not true');\n  });\n\n  it('should be false', () => {\n    const booleanSchema = boolean().onlyFalse();\n\n    expectEqualTypes<false, InferType<typeof booleanSchema>>(true);\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(false);\n    expect(parseSchema(booleanSchema, false)).toBe(false);\n    expect(() => parseSchema(booleanSchema, true)).toThrow('The received value is not false');\n  });\n\n  it('should have proper types', () => {\n    const booleanSchema = boolean();\n    const booleanOrNullSchema = boolean().nullable();\n    const booleanOrUndefinedSchema = boolean().optional();\n    const booleanOrNullOrUndefinedSchema = boolean().nullable().optional();\n\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(true);\n    expectEqualTypes<boolean | null, InferType<typeof booleanOrNullSchema>>(true);\n    expectEqualTypes<boolean | undefined, InferType<typeof booleanOrUndefinedSchema>>(true);\n    expectEqualTypes<boolean | null | undefined, InferType<typeof booleanOrNullOrUndefinedSchema>>(true);\n\n    const falseSchema = boolean().onlyFalse();\n    const falseOrNullSchema = boolean().onlyFalse().nullable();\n    const falseOrUndefinedSchema = boolean().onlyFalse().optional();\n    const falseOrNullOrUndefinedSchema = boolean().onlyFalse().nullable().optional();\n\n    expectEqualTypes<false, InferType<typeof falseSchema>>(true);\n    expectEqualTypes<false | null, InferType<typeof falseOrNullSchema>>(true);\n    expectEqualTypes<false | undefined, InferType<typeof falseOrUndefinedSchema>>(true);\n    expectEqualTypes<false | null | undefined, InferType<typeof falseOrNullOrUndefinedSchema>>(true);\n\n    const trueSchema = boolean().onlyTrue();\n    const trueOrNullSchema = boolean().onlyTrue().nullable();\n    const trueOrUndefinedSchema = boolean().onlyTrue().optional();\n    const trueOrNullOrUndefinedSchema = boolean().onlyTrue().nullable().optional();\n\n    expectEqualTypes<true, InferType<typeof trueSchema>>(true);\n    expectEqualTypes<true | null, InferType<typeof trueOrNullSchema>>(true);\n    expectEqualTypes<true | undefined, InferType<typeof trueOrUndefinedSchema>>(true);\n    expectEqualTypes<true | null | undefined, InferType<typeof trueOrNullOrUndefinedSchema>>(true);\n  });\n});\n"],"mappings":"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","names":["schema"]}

package/lib/__tests__/BooleanSchema.test.mjs

@@ -0,0 +1,217 @@
+// jest/setup.ts
+function expectEqualTypes(areEqual) {
+  expect(typeof areEqual).toBe("boolean");
+}
+
+// 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/core.ts
+var ctxSymbol = Symbol("contextSymbol");
+function innerCheck(schema, receivedValue, pathToError) {
+  const ctx = schema[ctxSymbol];
+  if (receivedValue === void 0) {
+    if (!ctx.isOptional) throwException("Required", receivedValue, pathToError, "The required value is missing");
+    return receivedValue;
+  }
+  if (receivedValue === null) {
+    if (!ctx.isNullable) throwException("Not null", receivedValue, pathToError, "Value should not be null");
+    return receivedValue;
+  }
+  if (ctx.array) {
+    if (!Array.isArray(receivedValue))
+      throwException("Array", receivedValue, pathToError, "Expected an array but received a different type");
+    const schema2 = ctx.array;
+    receivedValue.forEach((elem, i) => {
+      innerCheck(schema2, elem, `${pathToError}[${i}]`);
+    });
+    return receivedValue;
+  }
+  const typeOfVal = typeof receivedValue;
+  if (ctx.object) {
+    if (typeOfVal !== "object")
+      throwException("Object", receivedValue, pathToError, "Expected an object but received a different type");
+    if (Array.isArray(receivedValue))
+      throwException(
+        "Object",
+        receivedValue,
+        pathToError,
+        "Expected an object but received an array. Invalid type of data"
+      );
+    const shapeSchema = ctx.object;
+    for (const keyPerReceivedValue of Object.keys(receivedValue)) {
+      if (shapeSchema[keyPerReceivedValue] === void 0)
+        throwException("Not allowed", keyPerReceivedValue, pathToError, "This key is not allowed in the object");
+    }
+    for (const [keyOfSchema, valueOfSchema] of Object.entries(shapeSchema)) {
+      const receivedObjectValuePropery = receivedValue[keyOfSchema];
+      if (receivedObjectValuePropery === void 0) {
+        if (!valueOfSchema[ctxSymbol].isOptional)
+          throwException(
+            "Required",
+            receivedObjectValuePropery,
+            pathToError,
+            "Missing required property in the object"
+          );
+      }
+      innerCheck(valueOfSchema, receivedObjectValuePropery, `${pathToError}.${keyOfSchema}`);
+    }
+    return receivedValue;
+  }
+  if (ctx.type.length) {
+    if (!ctx.type.includes(typeOfVal)) throwException(ctx.type, typeOfVal, pathToError, "Invalid type of data");
+  }
+  ctx.requiredValidations.forEach((requiredValidation) => {
+    requiredValidation(receivedValue, pathToError);
+  });
+  return receivedValue;
+}
+
+// src/parseSchema.ts
+function parseSchema(schema, receivedValue) {
+  try {
+    return innerCheck(schema, receivedValue, "");
+  } catch (e) {
+    if (e instanceof ValidationError) throw e;
+    throw new Error("Something unexpected happened");
+  }
+}
+
+// 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/BooleanSchema.ts
+var isBoolean = (expected) => (received, pathToError) => {
+  if (received !== expected) throwException(expected, received, pathToError, `The received value is not ${expected}`);
+};
+var BooleanSchema = class extends CommonSchema {
+  _boolean = 1;
+  /**
+   * 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() {
+    return this.custom(isBoolean(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() {
+    return this.custom(isBoolean(false));
+  }
+};
+
+// src/asserts/boolean/index.ts
+function boolean() {
+  return new BooleanSchema({ type: ["boolean"], requiredValidations: [] });
+}
+
+// src/__tests__/BooleanSchema.test.ts
+describe("BooleanSchema", () => {
+  it("should be a boolean", () => {
+    const booleanSchema = boolean();
+    expectEqualTypes(true);
+    expect(parseSchema(booleanSchema, true)).toBe(true);
+    expect(parseSchema(booleanSchema, false)).toBe(false);
+  });
+  it("should not be a boolean", () => {
+    const booleanSchema = boolean();
+    const actualNotBoolean = 9;
+    expectEqualTypes(false);
+    expect(() => parseSchema(booleanSchema, actualNotBoolean)).toThrow("Invalid type of data");
+  });
+  it("should be true", () => {
+    const booleanSchema = boolean().onlyTrue();
+    expectEqualTypes(true);
+    expectEqualTypes(false);
+    expect(parseSchema(booleanSchema, true)).toBe(true);
+    expect(() => parseSchema(booleanSchema, false)).toThrow("The received value is not true");
+  });
+  it("should be false", () => {
+    const booleanSchema = boolean().onlyFalse();
+    expectEqualTypes(true);
+    expectEqualTypes(false);
+    expect(parseSchema(booleanSchema, false)).toBe(false);
+    expect(() => parseSchema(booleanSchema, true)).toThrow("The received value is not false");
+  });
+  it("should have proper types", () => {
+    const booleanSchema = boolean();
+    const booleanOrNullSchema = boolean().nullable();
+    const booleanOrUndefinedSchema = boolean().optional();
+    const booleanOrNullOrUndefinedSchema = boolean().nullable().optional();
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    const falseSchema = boolean().onlyFalse();
+    const falseOrNullSchema = boolean().onlyFalse().nullable();
+    const falseOrUndefinedSchema = boolean().onlyFalse().optional();
+    const falseOrNullOrUndefinedSchema = boolean().onlyFalse().nullable().optional();
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    const trueSchema = boolean().onlyTrue();
+    const trueOrNullSchema = boolean().onlyTrue().nullable();
+    const trueOrUndefinedSchema = boolean().onlyTrue().optional();
+    const trueOrNullOrUndefinedSchema = boolean().onlyTrue().nullable().optional();
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+    expectEqualTypes(true);
+  });
+});
+//# sourceMappingURL=BooleanSchema.test.mjs.map

package/lib/__tests__/BooleanSchema.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../jest/setup.ts","../../src/exceptions.ts","../../src/core.ts","../../src/parseSchema.ts","../../src/schemas/CommonSchema.ts","../../src/schemas/BooleanSchema.ts","../../src/asserts/boolean/index.ts","../../src/__tests__/BooleanSchema.test.ts"],"sourcesContent":["export type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport function expectEqualTypes<X, Y>(areEqual: Equal<X, Y>): void {\n  expect(typeof areEqual).toBe('boolean');\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 { InferType } from './InferType';\nimport { innerCheck } from './core';\nimport { ValidationError } from './exceptions';\nimport { CommonSchema } from './schemas/CommonSchema';\n\n/**\n * Parses and validates a value against the provided schema, returning a type-safe result.\n *\n * This function will throw a `ValidationError` if the value does not conform to the schema.\n * The inferred TypeScript type of the returned value will match the structure defined by the schema.\n *\n * @template T\n * @param {T} schema - The schema to validate the received value against. This schema dictates the expected structure and type of the value.\n * @param {unknown} receivedValue - The value to be validated and parsed according to the schema.\n * @returns {InferType<T>} The validated value, with its TypeScript type inferred from the schema.\n *\n * @throws {ValidationError} If the received value does not match the schema, a `ValidationError` will be thrown.\n * @throws {Error} If an unexpected error occurs during validation, an error will be thrown with a generic message.\n *\n * @example\n * const schema = object({\n *   name: string(),\n *   age: number(),\n * });\n *\n * const result = parseSchema(schema, { name: 'Alice', age: 30 });\n * // result will be inferred as { name: string; age: number }\n *\n * parseSchema(schema, { name: 'Alice', age: '30' });\n * // Throws ValidationError because 'age' should be a number, not a string.\n */\nexport function parseSchema<T extends CommonSchema>(schema: T, receivedValue: unknown): InferType<T> {\n  try {\n    return innerCheck(schema, receivedValue, '') as InferType<T>;\n  } catch (e) {\n    if (e instanceof ValidationError) throw e;\n    /* istanbul ignore next */\n    throw new Error('Something unexpected happened');\n  }\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 { CommonSchema } from './CommonSchema';\nimport { throwException } from '../exceptions';\n\nconst isBoolean = (expected: boolean) => (received: boolean, pathToError: string) => {\n  if (received !== expected) throwException(expected, received, pathToError, `The received value is not ${expected}`);\n};\n\nexport class BooleanSchema extends CommonSchema {\n  _boolean = 1;\n\n  /**\n   * Restricts the schema to exactly match the boolean value true and infers the true value as the TypeScript type.\n   *\n   * @returns - The schema instance restricted to the value true, with the true value inferred as the TypeScript type\n   *\n   * @example - boolean().onlyTrue(); // Infers the type true\n   */\n  onlyTrue(): WithBoolean<this, true> {\n    return this.custom(isBoolean(true)) as WithBoolean<this, true>;\n  }\n\n  /**\n   * Restricts the schema to exactly match the boolean value false and infers the false value as the TypeScript type.\n   *\n   * @returns - The schema instance restricted to the value false, with the false value inferred as the TypeScript type\n   *\n   * @example - boolean().onlyFalse(); // Infers the type false\n   */\n  onlyFalse(): WithBoolean<this, false> {\n    return this.custom(isBoolean(false)) as WithBoolean<this, false>;\n  }\n}\n\nexport type WithBoolean<T extends BooleanSchema, Y = boolean> = T & { validation_boolean: Y };\nexport type ExtractFromBoolean<T> = T extends WithBoolean<BooleanSchema, infer Y> ? Y : never;\n","import { BooleanSchema } from '../../schemas/BooleanSchema';\n\n/**\n * Creates a new schema for validating boolean values.\n *\n * @returns {BooleanSchema} A new instance of `BooleanSchema` for validating booleans.\n *\n * @example\n * const schema = boolean();\n * parseSchema(schema, true); // Validates successfully\n * parseSchema(schema, 'true'); // Throws a validation error\n */\nexport function boolean(): BooleanSchema {\n  return new BooleanSchema({ type: ['boolean'], requiredValidations: [] });\n}\n","/* eslint-disable @typescript-eslint/no-unused-vars */\nimport { expectEqualTypes } from '../../jest/setup';\nimport { parseSchema } from '../parseSchema';\nimport { InferType } from '../InferType';\nimport { boolean } from '../asserts/boolean';\n\ndescribe('BooleanSchema', () => {\n  it('should be a boolean', () => {\n    const booleanSchema = boolean();\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(true);\n    expect(parseSchema(booleanSchema, true)).toBe(true);\n    expect(parseSchema(booleanSchema, false)).toBe(false);\n  });\n\n  it('should not be a boolean', () => {\n    const booleanSchema = boolean();\n    // eslint-disable-next-line @typescript-eslint/no-inferrable-types\n    const actualNotBoolean: number = 9;\n\n    expectEqualTypes<typeof actualNotBoolean, InferType<typeof booleanSchema>>(false);\n    expect(() => parseSchema(booleanSchema, actualNotBoolean)).toThrow('Invalid type of data');\n  });\n\n  it('should be true', () => {\n    const booleanSchema = boolean().onlyTrue();\n\n    expectEqualTypes<true, InferType<typeof booleanSchema>>(true);\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(false);\n    expect(parseSchema(booleanSchema, true)).toBe(true);\n    expect(() => parseSchema(booleanSchema, false)).toThrow('The received value is not true');\n  });\n\n  it('should be false', () => {\n    const booleanSchema = boolean().onlyFalse();\n\n    expectEqualTypes<false, InferType<typeof booleanSchema>>(true);\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(false);\n    expect(parseSchema(booleanSchema, false)).toBe(false);\n    expect(() => parseSchema(booleanSchema, true)).toThrow('The received value is not false');\n  });\n\n  it('should have proper types', () => {\n    const booleanSchema = boolean();\n    const booleanOrNullSchema = boolean().nullable();\n    const booleanOrUndefinedSchema = boolean().optional();\n    const booleanOrNullOrUndefinedSchema = boolean().nullable().optional();\n\n    expectEqualTypes<boolean, InferType<typeof booleanSchema>>(true);\n    expectEqualTypes<boolean | null, InferType<typeof booleanOrNullSchema>>(true);\n    expectEqualTypes<boolean | undefined, InferType<typeof booleanOrUndefinedSchema>>(true);\n    expectEqualTypes<boolean | null | undefined, InferType<typeof booleanOrNullOrUndefinedSchema>>(true);\n\n    const falseSchema = boolean().onlyFalse();\n    const falseOrNullSchema = boolean().onlyFalse().nullable();\n    const falseOrUndefinedSchema = boolean().onlyFalse().optional();\n    const falseOrNullOrUndefinedSchema = boolean().onlyFalse().nullable().optional();\n\n    expectEqualTypes<false, InferType<typeof falseSchema>>(true);\n    expectEqualTypes<false | null, InferType<typeof falseOrNullSchema>>(true);\n    expectEqualTypes<false | undefined, InferType<typeof falseOrUndefinedSchema>>(true);\n    expectEqualTypes<false | null | undefined, InferType<typeof falseOrNullOrUndefinedSchema>>(true);\n\n    const trueSchema = boolean().onlyTrue();\n    const trueOrNullSchema = boolean().onlyTrue().nullable();\n    const trueOrUndefinedSchema = boolean().onlyTrue().optional();\n    const trueOrNullOrUndefinedSchema = boolean().onlyTrue().nullable().optional();\n\n    expectEqualTypes<true, InferType<typeof trueSchema>>(true);\n    expectEqualTypes<true | null, InferType<typeof trueOrNullSchema>>(true);\n    expectEqualTypes<true | undefined, InferType<typeof trueOrUndefinedSchema>>(true);\n    expectEqualTypes<true | null | undefined, InferType<typeof trueOrNullOrUndefinedSchema>>(true);\n  });\n});\n"],"mappings":"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","names":["schema"]}

package/lib/__tests__/CommonSchema.test.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/lib/__tests__/CommonSchema.test.d.ts

@@ -0,0 +1,2 @@
+
+export {  }