@kensio/smartass 1.8.0 → 1.10.0

package/dist/assert/buffer-equal/buffer-equal.test.js

@@ -0,0 +1,170 @@
+import { describe, expect, it } from "vitest";
+import { assertBufferEqual } from "./buffer-equal.assert.js";
+import { bufferEqualTo } from "./buffer-equal.match.js";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("assertBufferEqual", () => {
+    describe("assertBufferEqual", () => {
+        it("does not throw when Uint8Arrays are equal", () => {
+            const a = new Uint8Array([1, 2, 3, 4]);
+            const b = new Uint8Array([1, 2, 3, 4]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("throws when Uint8Arrays differ in content", () => {
+            const a = new Uint8Array([1, 2, 3, 4]);
+            const b = new Uint8Array([1, 2, 5, 4]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).toThrow("Expected object Uint8Array(4) to equal object Uint8Array(4).");
+        });
+        it("throws when Uint8Arrays differ in length", () => {
+            const a = new Uint8Array([1, 2, 3]);
+            const b = new Uint8Array([1, 2, 3, 4]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).toThrow("Expected object Uint8Array(3) to equal object Uint8Array(4).");
+        });
+        it("works with Int8Array", () => {
+            const a = new Int8Array([-1, 2, -3, 4]);
+            const b = new Int8Array([-1, 2, -3, 4]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with Uint16Array", () => {
+            const a = new Uint16Array([256, 512, 1024]);
+            const b = new Uint16Array([256, 512, 1024]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with Int16Array", () => {
+            const a = new Int16Array([-256, 512, -1024]);
+            const b = new Int16Array([-256, 512, -1024]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with Uint32Array", () => {
+            const a = new Uint32Array([1_000_000, 2_000_000]);
+            const b = new Uint32Array([1_000_000, 2_000_000]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with Int32Array", () => {
+            const a = new Int32Array([-1_000_000, 2_000_000]);
+            const b = new Int32Array([-1_000_000, 2_000_000]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with Float32Array", () => {
+            const a = new Float32Array([1.5, 2.5, 3.5]);
+            const b = new Float32Array([1.5, 2.5, 3.5]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with Float64Array", () => {
+            const a = new Float64Array([1.123_456_789, 2.987_654_321]);
+            const b = new Float64Array([1.123_456_789, 2.987_654_321]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with BigInt64Array", () => {
+            const a = new BigInt64Array([
+                9007199254740991n,
+                -9007199254740991n,
+            ]);
+            const b = new BigInt64Array([
+                9007199254740991n,
+                -9007199254740991n,
+            ]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("works with BigUint64Array", () => {
+            const a = new BigUint64Array([
+                9007199254740991n,
+                18014398509481982n,
+            ]);
+            const b = new BigUint64Array([
+                9007199254740991n,
+                18014398509481982n,
+            ]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("throws when actual value is not a TypedArray", () => {
+            const a = [1, 2, 3];
+            const b = new Uint8Array([1, 2, 3]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).toThrow("Expected array [1,2,3] (len 3) to equal object Uint8Array(3).");
+        });
+        it("works with empty buffers", () => {
+            const a = new Uint8Array([]);
+            const b = new Uint8Array([]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).not.toThrow();
+        });
+        it("throws with custom message", () => {
+            const a = new Uint8Array([1, 2, 3]);
+            const b = new Uint8Array([1, 2, 4]);
+            expect(() => {
+                assertBufferEqual(a, b, "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("detects difference at first index", () => {
+            const a = new Uint8Array([99, 2, 3]);
+            const b = new Uint8Array([1, 2, 3]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).toThrow("Expected object Uint8Array(3) to equal object Uint8Array(3).");
+        });
+        it("detects difference at last index", () => {
+            const a = new Uint8Array([1, 2, 3, 99]);
+            const b = new Uint8Array([1, 2, 3, 4]);
+            expect(() => {
+                assertBufferEqual(a, b);
+            }).toThrow("Expected object Uint8Array(4) to equal object Uint8Array(4).");
+        });
+    });
+    describe("bufferEqualTo", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: Buffer.from("foobar") } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: bufferEqualTo(Buffer.from("foobar")) },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is a Buffer.
+            const foobar = foo.bar.foobar;
+            expect(foobar).toBeInstanceOf(Buffer);
+        });
+        it("matches equal TypedArrays", () => {
+            expect(bufferEqualTo(new Uint8Array([1, 2, 3])).matches(new Uint8Array([1, 2, 3]))).toBe(true);
+        });
+        it("does not match different TypedArrays", () => {
+            expect(bufferEqualTo(new Uint8Array([1, 2, 3])).matches(new Uint8Array([1, 2, 4]))).toBe(false);
+        });
+        it("does not match non-TypedArrays", () => {
+            expect(bufferEqualTo(new Uint8Array([1, 2, 3])).matches([1, 2, 3])).toBe(false);
+        });
+        it("describes and represents the bufferEqualTo matcher", () => {
+            const matcher = bufferEqualTo(new Uint8Array([1, 2, 3]));
+            expect(desc(matcher)).toBe("buffer equal to object Uint8Array(3)");
+            expect(repr(matcher)).toBe("Uint8Array(3)");
+        });
+    });
+});
+//# sourceMappingURL=buffer-equal.test.js.map

package/dist/assert/buffer-equal/buffer-equal.test.js.map

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

package/dist/assert/false/false.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=false.test.d.ts.map

package/dist/assert/false/false.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"false.test.d.ts","sourceRoot":"","sources":["../../../src/assert/false/false.test.ts"],"names":[],"mappings":""}

package/dist/assert/false/false.test.js

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import { assertFalse } from "./false.assert.js";
+describe("assertFalse", () => {
+    it("should pass when value is false", () => {
+        expect(() => {
+            assertFalse(false);
+        }).not.toThrow();
+    });
+    it("should fail when value is true", () => {
+        expect(() => {
+            assertFalse(true);
+        }).toThrow("Expected boolean true to be boolean false.");
+    });
+    it("should fail when value is falsy but not false", () => {
+        expect(() => {
+            assertFalse(0);
+        }).toThrow("Expected number 0 to be boolean false.");
+        expect(() => {
+            assertFalse("");
+        }).toThrow('Expected string "" to be boolean false.');
+        expect(() => {
+            assertFalse(null);
+        }).toThrow("Expected null to be boolean false.");
+        expect(() => {
+            assertFalse(undefined);
+        }).toThrow("Expected undefined to be boolean false.");
+    });
+    it("should fail when value is truthy", () => {
+        expect(() => {
+            assertFalse(1);
+        }).toThrow("Expected number 1 to be boolean false.");
+        expect(() => {
+            assertFalse("false");
+        }).toThrow('Expected string "false" to be boolean false.');
+        expect(() => {
+            assertFalse({});
+        }).toThrow("Expected object {} to be boolean false.");
+    });
+    it("should accept custom message", () => {
+        expect(() => {
+            assertFalse(true, "Custom error message");
+        }).toThrow("Custom error message");
+    });
+});
+//# sourceMappingURL=false.test.js.map

package/dist/assert/false/false.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"false.test.js","sourceRoot":"","sources":["../../../src/assert/false/false.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,EAAE;YACV,WAAW,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/assert/identical/identical.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identical.test.d.ts.map

package/dist/assert/identical/identical.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identical.test.d.ts","sourceRoot":"","sources":["../../../src/assert/identical/identical.test.ts"],"names":[],"mappings":""}

package/dist/assert/identical/identical.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it } from "vitest";
+import { assertIdentical } from "./identical.assert.js";
+describe("identical", () => {
+    it("throws when values are not identical", () => {
+        expect(() => {
+            assertIdentical("foo", "bar");
+        }).toThrow('Expected string "foo" to be identical to string "bar".');
+    });
+    it("does not throw when values are identical", () => {
+        expect(() => {
+            assertIdentical("foo", "foo");
+        }).not.toThrow();
+    });
+    it("throws with custom message", () => {
+        expect(() => {
+            assertIdentical(1, 2, "Custom error message");
+        }).toThrow("Custom error message");
+    });
+    it("uses === for comparison (not ==)", () => {
+        expect(() => {
+            assertIdentical(1, "1");
+        }).toThrow('Expected number 1 to be identical to string "1".');
+    });
+    it("works with object references", () => {
+        const obj = { foo: "bar" };
+        expect(() => {
+            assertIdentical(obj, obj);
+        }).not.toThrow();
+        expect(() => {
+            assertIdentical(obj, { foo: "bar" });
+        }).toThrow();
+    });
+    it("works with null and undefined", () => {
+        expect(() => {
+            assertIdentical(null, null);
+        }).not.toThrow();
+        expect(() => {
+            assertIdentical(undefined, undefined);
+        }).not.toThrow();
+        expect(() => {
+            assertIdentical(null, undefined);
+        }).toThrow();
+    });
+    it("works with numbers", () => {
+        expect(() => {
+            assertIdentical(42, 42);
+        }).not.toThrow();
+        expect(() => {
+            assertIdentical(42, 43);
+        }).toThrow("Expected number 42 to be identical to number 43");
+    });
+    it("works with booleans", () => {
+        expect(() => {
+            assertIdentical(true, true);
+        }).not.toThrow();
+        expect(() => {
+            assertIdentical(true, false);
+        }).toThrow();
+    });
+});
+//# sourceMappingURL=identical.test.js.map

package/dist/assert/identical/identical.test.js.map

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

package/dist/assert/instance-of/instance-of.assert.d.ts

@@ -1,5 +1,6 @@
+import { type InstanceOfConstructor } from "./instance-of.match.js";
 /**
  * Assertion function that checks if a value is an instance of a given class, with type-narrowing.
  */
-export declare function assertInstanceOf<T>(value: unknown, classConstructor: abstract new (...args: never[]) => T, message?: string): asserts value is T;
+export declare function assertInstanceOf<const TConstructor extends abstract new (...arguments_: never[]) => object>(value: unknown, classConstructor: TConstructor, message?: string): asserts value is InstanceOfConstructor<TConstructor>;
 //# sourceMappingURL=instance-of.assert.d.ts.map

package/dist/assert/instance-of/instance-of.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance-of.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.assert.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EACtD,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,CAAC,CASpB"}
+{"version":3,"file":"instance-of.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.assert.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEhF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,YAAY,SAAS,QAAQ,MAAM,GAAG,UAAU,EAAE,KAAK,EAAE,KAAK,MAAM,EAE1E,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,YAAY,EAC9B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,qBAAqB,CAAC,YAAY,CAAC,CAStD"}

package/dist/assert/instance-of/instance-of.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"instance-of.assert.js","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,gBAAsD,EACtD,OAAgB;IAEhB,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,wBAAwB,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EACxE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"instance-of.assert.js","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAA8B,MAAM,wBAAwB,CAAC;AAEhF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAG9B,KAAc,EACd,gBAA8B,EAC9B,OAAgB;IAEhB,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,wBAAwB,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EACxE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/instance-of/instance-of.match.d.ts

@@ -1,6 +1,7 @@
 import { type AssertionMatcher } from "../../match/match.js";
+export type InstanceOfConstructor<TConstructor> = TConstructor extends abstract new (...arguments_: never[]) => infer TInstance ? TInstance : never;
 /**
  * Matcher for a value being an instance of a given class.
  */
-export declare function instanceOf<T>(classConstructor: abstract new (...args: never[]) => T): AssertionMatcher<T>;
+export declare function instanceOf<const TConstructor extends abstract new (...arguments_: never[]) => object>(classConstructor: TConstructor): AssertionMatcher<InstanceOfConstructor<TConstructor>>;
 //# sourceMappingURL=instance-of.match.d.ts.map

package/dist/assert/instance-of/instance-of.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance-of.match.d.ts","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,gBAAgB,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GACrD,gBAAgB,CAAC,CAAC,CAAC,CAMrB"}
+{"version":3,"file":"instance-of.match.d.ts","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,qBAAqB,CAAC,YAAY,IAC5C,YAAY,SAAS,QAAQ,MAAM,GAAG,UAAU,EAAE,KAAK,EAAE,KAAK,MAAM,SAAS,GACzE,SAAS,GACT,KAAK,CAAC;AAEZ;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,CAAC,YAAY,SAAS,QAAQ,MAAM,GAAG,UAAU,EAAE,KAAK,EAAE,KAAK,MAAM,EAE1E,gBAAgB,EAAE,YAAY,GAC7B,gBAAgB,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAOvD"}

package/dist/assert/instance-of/instance-of.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"instance-of.match.js","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,gBAAsD;IAEtD,OAAO,aAAa,CAClB,CAAC,KAAK,EAAc,EAAE,CAAC,KAAK,YAAY,gBAAgB,EACxD,GAAG,EAAE,CAAC,eAAe,gBAAgB,CAAC,IAAI,EAAE,EAC5C,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,IAAI,IAAI,CACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"instance-of.match.js","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO5E;;GAEG;AACH,MAAM,UAAU,UAAU,CAGxB,gBAA8B;IAE9B,OAAO,aAAa,CAClB,CAAC,KAAK,EAAgD,EAAE,CACtD,KAAK,YAAY,gBAAgB,EACnC,GAAG,EAAE,CAAC,eAAe,gBAAgB,CAAC,IAAI,EAAE,EAC5C,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,IAAI,IAAI,CACnC,CAAC;AACJ,CAAC"}

package/dist/assert/instance-of/instance-of.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instance-of.test.d.ts.map

package/dist/assert/instance-of/instance-of.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-of.test.d.ts","sourceRoot":"","sources":["../../../src/assert/instance-of/instance-of.test.ts"],"names":[],"mappings":""}

package/dist/assert/instance-of/instance-of.test.js

@@ -0,0 +1,112 @@
+import { describe, expect, it } from "vitest";
+import { assertInstanceOf } from "./instance-of.assert.js";
+import { instanceOf } from "./instance-of.match.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+class TestClass {
+    value = 42;
+}
+class OtherClass {
+    data = "test";
+}
+describe("instance-of", () => {
+    describe("assertInstanceOf", () => {
+        it("does not throw when value is an instance of the class", () => {
+            const instance = new TestClass();
+            expect(() => {
+                assertInstanceOf(instance, TestClass);
+            }).not.toThrow();
+        });
+        it("throws when value is not an instance of the class", () => {
+            const instance = new OtherClass();
+            expect(() => {
+                assertInstanceOf(instance, TestClass);
+            }).toThrow("Expected value to be instance of TestClass, but it was not.");
+        });
+        it("throws when value is a plain object", () => {
+            const obj = { value: 42 };
+            expect(() => {
+                assertInstanceOf(obj, TestClass);
+            }).toThrow("Expected value to be instance of TestClass, but it was not.");
+        });
+        it("throws when value is null", () => {
+            expect(() => {
+                assertInstanceOf(null, TestClass);
+            }).toThrow("Expected value to be instance of TestClass, but it was not.");
+        });
+        it("throws when value is undefined", () => {
+            expect(() => {
+                assertInstanceOf(undefined, TestClass);
+            }).toThrow("Expected value to be instance of TestClass, but it was not.");
+        });
+        it("throws with custom message", () => {
+            expect(() => {
+                assertInstanceOf({}, TestClass, "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("works with built-in classes", () => {
+            expect(() => {
+                assertInstanceOf(new Date(), Date);
+            }).not.toThrow();
+            expect(() => {
+                assertInstanceOf(new Error("foobar"), Error);
+            }).not.toThrow();
+            expect(() => {
+                assertInstanceOf("string", Date);
+            }).toThrow("Expected value to be instance of Date, but it was not.");
+        });
+    });
+    describe("instanceOf", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: new TestClass() } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: instanceOf(TestClass) },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is an instance of TestClass.
+            const value = foo.bar.foobar.value;
+            const foobar = foo.bar.foobar;
+            expect(value).toBeTypeOf("number");
+            expect(foobar).toBeInstanceOf(TestClass);
+        });
+        it("explains failed composition", () => {
+            expect(() => {
+                assertObjectMatches({ bar: { foobar: new OtherClass() } }, {
+                    bar: { foobar: instanceOf(TestClass) },
+                });
+            }).toThrow('Expected object {"bar":{"foobar":OtherClass {"data":"test"}}} to match object {"bar":{"foobar":TestClass()}}. Mismatch at $.bar.foobar: expected TestClass(), got OtherClass {"data":"test"}.');
+        });
+        it("matches correct instances", () => {
+            expect(instanceOf(TestClass).matches(new TestClass())).toBe(true);
+        });
+        it("does not match incorrect instances", () => {
+            expect(instanceOf(TestClass).matches(new OtherClass())).toBe(false);
+        });
+        it("does not match plain objects", () => {
+            expect(instanceOf(TestClass).matches({ value: 42 })).toBe(false);
+        });
+        it("does not match null", () => {
+            expect(instanceOf(TestClass).matches(null)).toBe(false);
+        });
+        it("does not match undefined", () => {
+            expect(instanceOf(TestClass).matches(undefined)).toBe(false);
+        });
+        it("describes the matcher", () => {
+            expect(instanceOf(TestClass).describe()).toBe("instance of TestClass");
+        });
+        it("represents the matcher", () => {
+            expect(instanceOf(TestClass).represent()).toBe("TestClass()");
+        });
+        it("describes when constructor has no name", () => {
+            const noNameCtor = function () {
+                //
+            };
+            const matcher = instanceOf(noNameCtor);
+            expect(matcher.describe()).toBe("instance of noNameCtor");
+            expect(matcher.represent()).toBe("noNameCtor()");
+        });
+    });
+});
+//# sourceMappingURL=instance-of.test.js.map

package/dist/assert/instance-of/instance-of.test.js.map

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

package/dist/assert/non-nullable/non-nullable.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=non-nullable.test.d.ts.map

package/dist/assert/non-nullable/non-nullable.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-nullable.test.d.ts","sourceRoot":"","sources":["../../../src/assert/non-nullable/non-nullable.test.ts"],"names":[],"mappings":""}

package/dist/assert/non-nullable/non-nullable.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from "vitest";
+import { assertNonNullable } from "./non-nullable.assert.js";
+import { nonNullable } from "./non-nullable.match.js";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("non-nullable", () => {
+    describe("assertNonNullable", () => {
+        it("throws on null", () => {
+            expect(() => {
+                assertNonNullable(null);
+            }).toThrow("Expected null not to be null.");
+        });
+        it("throws on undefined", () => {
+            expect(() => {
+                assertNonNullable(undefined);
+            }).toThrow("Expected undefined not to be undefined.");
+        });
+        it("OK on non-nullable", () => {
+            expect(() => {
+                assertNonNullable("foobar");
+            }).not.toThrow();
+        });
+    });
+    describe("nonNullable", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: { something: "hello" } } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: { something: nonNullable() } },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar.something is a literal string "hello".
+            const hello = foo.bar.foobar.something;
+            expect(hello).toBe("hello");
+        });
+        it("matches non-null and non-undefined values", () => {
+            const matcher = nonNullable();
+            expect(matcher.matches("foobar")).toBe(true);
+            expect(matcher.matches(123)).toBe(true);
+            expect(matcher.matches(true)).toBe(true);
+            expect(matcher.matches({})).toBe(true);
+            expect(matcher.matches([])).toBe(true);
+        });
+        it("does not match null", () => {
+            const matcher = nonNullable();
+            expect(matcher.matches(null)).toBe(false);
+        });
+        it("does not match undefined", () => {
+            const matcher = nonNullable();
+            expect(matcher.matches(undefined)).toBe(false);
+        });
+        it("describes the matcher", () => {
+            const matcher = nonNullable();
+            expect(desc(matcher)).toBe("non-null defined value");
+        });
+        it("represents the matcher", () => {
+            const matcher = nonNullable();
+            expect(repr(matcher)).toBe("NonNullable");
+        });
+    });
+});
+//# sourceMappingURL=non-nullable.test.js.map

package/dist/assert/non-nullable/non-nullable.test.js.map

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

package/dist/assert/number-between/number-between.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=number-between.test.d.ts.map

package/dist/assert/number-between/number-between.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-between.test.d.ts","sourceRoot":"","sources":["../../../src/assert/number-between/number-between.test.ts"],"names":[],"mappings":""}