deep-guards 1.1.0 → 1.3.0

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2024 Niall Coleman-Clarke
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -54,6 +54,7 @@ if (vehicleGuard(value)) {
    6. [isUnionOf](#isunionof)
    7. [isIntersectionOf](#isintersectionof)
    8. [isExact](#isexact)
+   9. [isInstance](#isinstance)
 3. [Structures](#structures)
    1. [isAnyArray](#isanyarray)
    2. [isAnyRecord](#isanyrecord)
@@ -119,7 +120,7 @@ Has signature:
 
 ```ts
 function isOneOf<
-  const T extends (string | number | boolean | symbol | null | undefined)[]
+  const T extends (string | number | boolean | symbol | null | undefined)[],
 >(...values: T): Guard<(typeof values)[number]>;
 ```
 
@@ -138,10 +139,14 @@ Higher order guard. This takes in any amount of guards as arguments, and then pr
 Has signature:
 
 ```ts
-function isExact<const T>(expected: T, deep: boolean = true): Guard<T>;
+function isExact<const T>(expected: T): Guard<T>;
 ```
 
-This will pass if the incoming value exactly matches the `expected` parameter, optionally computing a deep equality.
+This will pass if the incoming value exactly matches the `expected` parameter. This memoizes checks upfront based on the expected value being passed in. So it's best to create these guards once, and then reuse the returned guard function.
+
+### isInstance
+
+Takes in a class and produces a guard to see if values are instances of that class, by using `instanceof`
 
 ## Structures
 
@@ -228,7 +233,7 @@ const carGuard = isObjectOf({
   passengers: isArrayOf(
     isObjectOf({
       name: isString,
-    })
+    }),
   ),
 });
 
@@ -240,7 +245,7 @@ const bikeGuard = isObjectOf({
 
 const vehicleGuard = isUnionOf(
   isDiscriminatedObjectOf("car", carGuard),
-  isDiscriminatedObjectOf("bike", bikeGuard)
+  isDiscriminatedObjectOf("bike", bikeGuard),
 );
 ```
 
@@ -254,7 +259,7 @@ You can then do things like:
 const cars = guardOrThrow(
   JSON.parse(readFileSync("cars.json").toString()),
   isArrayOf(isCar),
-  "Invalid car format"
+  "Invalid car format",
 );
 ```
 
@@ -272,7 +277,7 @@ const carGuard = isObjectOf({
   passengers: isArrayOf(
     isObjectOf({
       name: isString,
-    })
+    }),
   ),
 });
 

package/dist/compound.d.ts

@@ -11,5 +11,6 @@ type ArrayToIntersection<A extends readonly unknown[]> = A extends [
     ...infer R
 ] ? T & ArrayToIntersection<R> : unknown;
 export declare function isIntersectionOf<T extends readonly unknown[]>(...guards: GuardSchemaOf<T>): Guard<ArrayToIntersection<T>>;
-export declare function isExact<const T>(expected: T, deep?: boolean): Guard<T>;
+export declare function isExact<const T>(expected: T): Guard<T>;
+export declare function isInstance<C extends abstract new (...args: any) => unknown>(cls: C): Guard<InstanceType<C>>;
 export {};

package/dist/compound.js

@@ -36,29 +36,79 @@ export function isIntersectionOf(...guards) {
     }
     return (value) => guards.every((guard) => guard(value));
 }
-function objectEntriesChecks(a, b) {
-    const aKeys = objectKeys(a);
-    const bKeySet = new Set(objectKeys(b));
-    return (aKeys.length === bKeySet.size &&
-        aKeys.every((k) => bKeySet.has(k) && isExact(a[k], true)(b[k])));
+export function isExact(expected) {
+    // Primitive checks
+    if (typeof expected !== "object" || expected === null) {
+        // NaN check
+        if (typeof expected === "number" && Number.isNaN(expected)) {
+            return (value) => typeof value === "number" && Number.isNaN(value);
+        }
+        return (value) => value === expected;
+    }
+    // Date checks
+    if (expected instanceof Date) {
+        return (value) => value instanceof Date && expected.getTime() === value.getTime();
+    }
+    // RegExp checks
+    if (expected instanceof RegExp) {
+        return (value) => value instanceof RegExp &&
+            expected.source === value.source &&
+            expected.flags === value.flags;
+    }
+    // Error checks
+    if (expected instanceof Error) {
+        return (value) => value instanceof Error &&
+            expected.name === value.name &&
+            expected.message === value.message;
+    }
+    // Map checks
+    if (expected instanceof Map) {
+        const guards = Array.from(expected
+            .entries()
+            .map(([k, v]) => [k, isExact(v)]));
+        return (value) => value instanceof Map &&
+            expected.size === value.size &&
+            guards.every(([k, guard]) => value.has(k) && guard(value.get(k)));
+    }
+    // Set checks
+    if (expected instanceof Set) {
+        const guards = new Map(expected.values().map((v) => [v, isExact(v)]));
+        return (value) => value instanceof Set &&
+            expected.size === value.size &&
+            value.values().every((v) => guards.get(v)?.(v));
+    }
+    // Typed Array checks
+    if (ArrayBuffer.isView(expected) && !(expected instanceof DataView)) {
+        const guards = Array.from(expected).map((v) => isExact(v));
+        return (value) => ArrayBuffer.isView(value) &&
+            !(value instanceof DataView) &&
+            expected.constructor === value.constructor &&
+            expected.length ===
+                value.length &&
+            guards.every((guard, i) => guard(value[i]));
+    }
+    // Array checks
+    if (Array.isArray(expected)) {
+        const guards = expected.map((v) => isExact(v));
+        return (value) => Array.isArray(value) &&
+            expected.length === value.length &&
+            guards.every((guard, i) => guard(value[i]));
+    }
+    // Object checks
+    const guards = objectKeys(expected).map((k) => [k, isExact(expected[k])]);
+    function objectEntriesChecks(value) {
+        const valueKeys = new Set(objectKeys(value));
+        return (guards.length === valueKeys.size &&
+            guards.every(([k, guard]) => valueKeys.has(k) && guard(value[k])));
+    }
+    return (value) => typeof value === "object" &&
+        value != null &&
+        !Array.isArray(value) &&
+        objectKeys(value).length === guards.length &&
+        objectEntriesChecks(value);
 }
-export function isExact(expected, deep = true) {
-    return (value) => 
-    // Shallow checks
-    expected === value ||
-        (Number.isNaN(expected) && Number.isNaN(value)) ||
-        (deep &&
-            (Array.isArray(expected)
-                ? // Array checks
-                    Array.isArray(value) &&
-                        expected.length === value.length &&
-                        expected.every((v, i) => isExact(v, true)(value[i]))
-                : // Object checks
-                    expected != null &&
-                        value != null &&
-                        typeof expected === "object" &&
-                        typeof value === "object" &&
-                        !Array.isArray(value) &&
-                        objectEntriesChecks(expected, value)));
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function isInstance(cls) {
+    return (value) => value instanceof cls;
 }
 //# sourceMappingURL=compound.js.map

package/dist/compound.js.map

@@ -1 +1 @@
-{"version":3,"file":"compound.js","sourceRoot":"src/","sources":["compound.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compound.js","sourceRoot":"src/","sources":["compound.ts"],"names":[],"mappings":"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"}

package/dist/primitives.js

@@ -7,7 +7,5 @@ export const isString = (value) => typeof value === "string";
 export const isSymbol = (value) => typeof value === "symbol";
 export const isBoolean = (value) => value === true || value === false;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const isFunction = (value
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => typeof value === "function";
+export const isFunction = (value) => typeof value === "function";
 //# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"src/","sources":["primitives.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAmB,CAAC,MAAM,EAAqB,EAAE,CAAC,IAAI,CAAC;AAE7E,MAAM,CAAC,MAAM,MAAM,GAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAqB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;AAE5E,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAE5E,MAAM,CAAC,MAAM,SAAS,GAAkB,CAAC,KAAK,EAAmB,EAAE,CACjE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAE1B,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAE5E,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAE5E,MAAM,CAAC,MAAM,SAAS,GAAmB,CAAC,KAAK,EAAE,EAAE,CACjD,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAuC,CAC5D,KAAK;AACL,8DAA8D;EACxB,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC"}
+{"version":3,"file":"primitives.js","sourceRoot":"src/","sources":["primitives.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAmB,CAAC,MAAM,EAAqB,EAAE,CAAC,IAAI,CAAC;AAE7E,MAAM,CAAC,MAAM,MAAM,GAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAqB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;AAE5E,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAE5E,MAAM,CAAC,MAAM,SAAS,GAAkB,CAAC,KAAK,EAAmB,EAAE,CACjE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAE1B,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAE5E,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAE5E,MAAM,CAAC,MAAM,SAAS,GAAmB,CAAC,KAAK,EAAE,EAAE,CACjD,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAuC,CAC5D,KAAK,EAEiC,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC"}

package/eslint.config.js

@@ -28,8 +28,10 @@ export default tslint.config(
       "@typescript-eslint/no-unnecessary-condition": "error",
       "@stylistic/arrow-parens": "off",
       "@stylistic/indent": "off",
+      "@stylistic/indent-binary-ops": "off",
       "@stylistic/generator-star-spacing": "off",
       "@stylistic/quotes": "off",
+      "@stylistic/quote-props": "off",
       "@stylistic/operator-linebreak": "off",
 
       // CORE
@@ -62,5 +64,5 @@ export default tslint.config(
         { varsIgnorePattern: "^_", argsIgnorePattern: "^_" },
       ],
     },
-  }
+  },
 );

package/package.json

@@ -1,18 +1,21 @@
 {
   "author": "eniallator",
   "description": "Deep guarding package",
+  "engines": {
+    "node": ">=25.4.0"
+  },
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "name": "deep-guards",
-  "packageManager": "yarn@4.9.2",
+  "packageManager": "yarn@4.12.0",
   "type": "module",
   "types": "dist/index.d.ts",
   "homepage": "https://github.com/eniallator/Deep-Guards",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "scripts": {
-    "test": "jest",
+    "test": "vitest run --passWithNoTests",
     "build": "tsc",
-    "lint": "eslint ./src ./tests",
+    "lint": "eslint ./src",
     "typecheck": "tsc --noEmit",
     "findissues": "yarn typecheck && yarn lint",
     "publish": "npm publish --tolerate-republish",
@@ -21,34 +24,18 @@
     "release": "powershell -ExecutionPolicy Bypass -File ./scripts/release.ps1"
   },
   "devDependencies": {
-    "@babel/core": "^7.28.3",
-    "@babel/preset-env": "^7.28.3",
-    "@babel/preset-typescript": "^7.27.1",
-    "@eslint/compat": "^1.3.2",
-    "@eslint/js": "^9.33.0",
-    "@jest/globals": "^30.0.5",
-    "@stylistic/eslint-plugin": "^5.2.3",
-    "@types/babel__core": "^7.20.5",
-    "@types/babel__preset-env": "^7.10.0",
+    "@eslint/compat": "^2.0.2",
+    "@eslint/js": "^9.39.2",
+    "@stylistic/eslint-plugin": "^5.8.0",
     "@types/eslint__js": "^9.14.0",
-    "@types/jest": "^30.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.39.1",
-    "@typescript-eslint/parser": "^8.39.1",
-    "babel-jest": "^30.0.5",
-    "eslint": "^9.33.0",
+    "@types/node": "^25.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
+    "eslint": "^9.39.2",
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jest": "^29.0.1",
-    "jest": "^30.0.5",
-    "ts-jest": "^29.4.1",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.39.1"
-  },
-  "jest": {
-    "globals": {
-      "ts-jest": {
-        "tsConfig": "tsconfig.test.json"
-      }
-    }
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0",
+    "vitest": "^4.0.18"
   }
 }

package/src/compound.test.ts

@@ -0,0 +1,254 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  isExact,
+  isInstance,
+  isIntersectionOf,
+  isNonNullable,
+  isNot,
+  isNullable,
+  isOneOf,
+  isOptional,
+  isUnionOf,
+} from "./compound.ts";
+import { isNumber, isString } from "./primitives.ts";
+
+describe("isOptional", () => {
+  const guard = isOptional(isString);
+
+  it("succeeds for the expected type or undefined", () => {
+    expect(guard("foo")).toBe(true);
+    expect(guard(undefined)).toBe(true);
+  });
+
+  it("fails for any other value", () => {
+    expect(guard(null)).toBe(false);
+  });
+});
+
+describe("isNullable", () => {
+  const guard = isNullable(isString);
+
+  it("succeeds for the expected type, null, or undefined", () => {
+    expect(guard("foo")).toBe(true);
+    expect(guard(null)).toBe(true);
+    expect(guard(undefined)).toBe(true);
+  });
+
+  it("fails any other value", () => {
+    expect(guard(1)).toBe(false);
+  });
+});
+
+describe("isNonNullable", () => {
+  it("succeeds for the expected type, null, or undefined", () => {
+    expect(isNonNullable("foo")).toBe(true);
+    expect(isNonNullable(1)).toBe(true);
+  });
+
+  it("fails any other value", () => {
+    expect(isNonNullable(null)).toBe(false);
+    expect(isNonNullable(undefined)).toBe(false);
+  });
+});
+
+describe("isNot", () => {
+  const guard = isNot(isString);
+
+  it("succeeds for any other value", () => {
+    expect(guard(1)).toBe(true);
+  });
+
+  it("fails for the isNot type", () => {
+    expect(guard("foo")).toBe(false);
+  });
+});
+
+describe("isOneOf", () => {
+  const guard = isOneOf(1, "foo", true);
+
+  it("succeeds for all of the values", () => {
+    expect(guard(1)).toBe(true);
+    expect(guard("foo")).toBe(true);
+    expect(guard(true)).toBe(true);
+  });
+
+  expect(guard(2)).toBe(false);
+  it("fails any other value", () => {
+    expect(guard(null)).toBe(false);
+    expect(guard("bar")).toBe(false);
+    expect(guard(false)).toBe(false);
+  });
+});
+
+describe("isUnionOf", () => {
+  const guard = isUnionOf(isString, isNumber);
+  it("succeeds for the union types", () => {
+    expect(guard(1)).toBe(true);
+    expect(guard("foo")).toBe(true);
+  });
+
+  it("fails for any other type", () => {
+    expect(guard(true)).toBe(false);
+    expect(guard(null)).toBe(false);
+  });
+});
+
+describe("isIntersectionOf", () => {
+  const guard = isIntersectionOf(isOneOf("foo", "bar", "baz"), isExact("foo"));
+
+  it("succeeds for the intersection", () => {
+    expect(guard("foo")).toBe(true);
+  });
+
+  it("fails for any other type", () => {
+    expect(guard("bar")).toBe(false);
+    expect(guard(1)).toBe(false);
+  });
+});
+
+describe("isExact", () => {
+  describe("deep", () => {
+    const guard = isExact({ foo: "bar", hello: ["world", { key: "test" }] });
+
+    it("succeeds for the exact value", () => {
+      expect(guard({ foo: "bar", hello: ["world", { key: "test" }] })).toBe(
+        true,
+      );
+    });
+
+    it("fails for any other value", () => {
+      expect(guard({ foo: "baz", hello: ["world", { key: "test" }] })).toBe(
+        false,
+      );
+      expect(guard({ foo: "bar", hello: ["world", { key: "tester" }] })).toBe(
+        false,
+      );
+      expect(guard(1)).toBe(false);
+    });
+  });
+
+  describe("shallow", () => {
+    const guard = isExact("foo");
+
+    it("succeeds for the exact value", () => {
+      expect(guard("foo")).toBe(true);
+    });
+
+    it("fails for any other value", () => {
+      expect(guard("bar")).toBe(false);
+      expect(guard(1)).toBe(false);
+    });
+  });
+
+  describe("Date", () => {
+    const date = new Date("2000-01-01");
+    const guard = isExact(date);
+
+    it("succeeds for the exact same date", () => {
+      expect(guard(new Date("2000-01-01"))).toBe(true);
+    });
+
+    it("fails for different dates", () => {
+      expect(guard(new Date("2000-01-02"))).toBe(false);
+      expect(guard(date.getTime())).toBe(false);
+    });
+  });
+
+  describe("RegExp", () => {
+    const regex = /test/gi;
+    const guard = isExact(regex);
+
+    it("succeeds for the exact same regex", () => {
+      expect(guard(/test/gi)).toBe(true);
+    });
+
+    it("fails for different regexes", () => {
+      expect(guard(/test/i)).toBe(false);
+      expect(guard(/test2/gi)).toBe(false);
+      expect(guard("test")).toBe(false);
+    });
+  });
+
+  describe("Error", () => {
+    const error = new Error("test error");
+    const guard = isExact(error);
+
+    it("succeeds for the exact same error", () => {
+      expect(guard(new Error("test error"))).toBe(true);
+    });
+
+    it("fails for different errors", () => {
+      expect(guard(new Error("other error"))).toBe(false);
+      expect(guard(new TypeError("test error"))).toBe(false);
+      expect(guard("test error")).toBe(false);
+    });
+  });
+
+  describe("Map", () => {
+    const map = new Map([["key", "value"]]);
+    const guard = isExact(map);
+
+    it("succeeds for the exact same map", () => {
+      expect(guard(new Map([["key", "value"]]))).toBe(true);
+    });
+
+    it("fails for different maps", () => {
+      expect(guard(new Map([["key", "other"]]))).toBe(false);
+      expect(guard(new Map([["other", "value"]]))).toBe(false);
+      expect(guard(new Map())).toBe(false);
+      expect(guard({})).toBe(false);
+    });
+  });
+
+  describe("Set", () => {
+    const set = new Set([1, 2, 3]);
+    const guard = isExact(set);
+
+    it("succeeds for the exact same set", () => {
+      expect(guard(new Set([1, 2, 3]))).toBe(true);
+    });
+
+    it("fails for different sets", () => {
+      expect(guard(new Set([1, 2]))).toBe(false);
+      expect(guard(new Set([1, 2, 4]))).toBe(false);
+      expect(guard([1, 2, 3])).toBe(false);
+    });
+  });
+
+  describe("Typed Array", () => {
+    const array = new Uint8Array([1, 2, 3]);
+    const guard = isExact(array);
+
+    it("succeeds for the exact same typed array", () => {
+      expect(guard(new Uint8Array([1, 2, 3]))).toBe(true);
+    });
+
+    it("fails for different typed arrays", () => {
+      expect(guard(new Uint8Array([1, 2]))).toBe(false);
+      expect(guard(new Uint8Array([1, 2, 4]))).toBe(false);
+      expect(guard(new Int8Array([1, 2, 3]))).toBe(false);
+      expect(guard([1, 2, 3])).toBe(false);
+    });
+  });
+});
+
+describe("isInstance", () => {
+  class Test {
+    foo: string = "bar";
+
+    constructor(foo: string) {
+      this.foo = foo;
+    }
+  }
+  const guard = isInstance(Test);
+
+  it("succeeds for an instance", () => {
+    expect(guard(new Test("baz"))).toBe(true);
+  });
+
+  it("fails for any other type", () => {
+    expect(guard({})).toBe(false);
+    expect(guard(null)).toBe(false);
+  });
+});