@kensio/smartass 1.8.0 → 1.10.0

package/dist/assert/number-between/number-between.test.js

@@ -0,0 +1,185 @@
+import { describe, expect, it } from "vitest";
+import { assertNumberBetween } from "./number-between.assert.js";
+import { numberBetween } from "./number-between.match.js";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("number-between", () => {
+    describe("with numbers", () => {
+        it("does not throw when value is within range", () => {
+            expect(() => {
+                assertNumberBetween(5, 1, 10);
+            }).not.toThrow();
+        });
+        it("does not throw when value equals min", () => {
+            expect(() => {
+                assertNumberBetween(1, 1, 10);
+            }).not.toThrow();
+        });
+        it("does not throw when value equals max", () => {
+            expect(() => {
+                assertNumberBetween(10, 1, 10);
+            }).not.toThrow();
+        });
+        it("throws when value is below min", () => {
+            expect(() => {
+                assertNumberBetween(0, 1, 10);
+            }).toThrow("Expected number 0 to be between number 1 and number 10 inclusive.");
+        });
+        it("throws when value is above max", () => {
+            expect(() => {
+                assertNumberBetween(11, 1, 10);
+            }).toThrow("Expected number 11 to be between number 1 and number 10 inclusive.");
+        });
+        it("throws with custom message", () => {
+            expect(() => {
+                assertNumberBetween(100, 1, 10, "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("works with negative numbers", () => {
+            expect(() => {
+                assertNumberBetween(-5, -10, 0);
+            }).not.toThrow();
+            expect(() => {
+                assertNumberBetween(-15, -10, 0);
+            }).toThrow("Expected number -15 to be between number -10 and number 0 inclusive.");
+        });
+        it("works with decimals", () => {
+            expect(() => {
+                assertNumberBetween(1.5, 1, 2);
+            }).not.toThrow();
+            expect(() => {
+                assertNumberBetween(2.1, 1, 2);
+            }).toThrow();
+        });
+    });
+    describe("with bigint", () => {
+        it("does not throw when value is within range", () => {
+            expect(() => {
+                assertNumberBetween(5n, 1n, 10n);
+            }).not.toThrow();
+        });
+        it("does not throw when value equals min", () => {
+            expect(() => {
+                assertNumberBetween(1n, 1n, 10n);
+            }).not.toThrow();
+        });
+        it("does not throw when value equals max", () => {
+            expect(() => {
+                assertNumberBetween(10n, 1n, 10n);
+            }).not.toThrow();
+        });
+        it("throws when value is below min", () => {
+            expect(() => {
+                assertNumberBetween(0n, 1n, 10n);
+            }).toThrow("Expected bigint 0n to be between bigint 1n and bigint 10n inclusive.");
+        });
+        it("throws when value is above max", () => {
+            expect(() => {
+                assertNumberBetween(11n, 1n, 10n);
+            }).toThrow("Expected bigint 11n to be between bigint 1n and bigint 10n inclusive.");
+        });
+    });
+    describe("type checking", () => {
+        it("throws when value is not a number or bigint", () => {
+            expect(() => {
+                assertNumberBetween("5", 1, 10);
+            }).toThrow('Expected string "5" to be between number 1 and number 10 inclusive.');
+        });
+    });
+    describe("numberBetween", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: 123 } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: numberBetween(100, 150) },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is a number.
+            const foobar = foo.bar.foobar;
+            expect(foobar).toBeTypeOf("number");
+        });
+        describe("with numbers", () => {
+            it("matches values within range", () => {
+                const matcher = numberBetween(1, 10);
+                expect(matcher.matches(5)).toBe(true);
+            });
+            it("matches values equal to min", () => {
+                const matcher = numberBetween(1, 10);
+                expect(matcher.matches(1)).toBe(true);
+            });
+            it("matches values equal to max", () => {
+                const matcher = numberBetween(1, 10);
+                expect(matcher.matches(10)).toBe(true);
+            });
+            it("does not match values below min", () => {
+                const matcher = numberBetween(1, 10);
+                expect(matcher.matches(0)).toBe(false);
+            });
+            it("does not match values above max", () => {
+                const matcher = numberBetween(1, 10);
+                expect(matcher.matches(11)).toBe(false);
+            });
+            it("works with negative numbers", () => {
+                const matcher = numberBetween(-10, 0);
+                expect(matcher.matches(-5)).toBe(true);
+                expect(matcher.matches(-15)).toBe(false);
+            });
+            it("works with decimals", () => {
+                const matcher = numberBetween(1, 2);
+                expect(matcher.matches(1.5)).toBe(true);
+                expect(matcher.matches(2.1)).toBe(false);
+            });
+        });
+        describe("with bigint", () => {
+            it("matches values within range", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(matcher.matches(5n)).toBe(true);
+            });
+            it("matches values equal to min", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(matcher.matches(1n)).toBe(true);
+            });
+            it("matches values equal to max", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(matcher.matches(10n)).toBe(true);
+            });
+            it("does not match values below min", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(matcher.matches(0n)).toBe(false);
+            });
+            it("does not match values above max", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(matcher.matches(11n)).toBe(false);
+            });
+        });
+        describe("type checking", () => {
+            it("does not match non-numeric values", () => {
+                const matcher = numberBetween(1, 10);
+                expect(matcher.matches("5")).toBe(false);
+                expect(matcher.matches(null)).toBe(false);
+                expect(matcher.matches(undefined)).toBe(false);
+            });
+        });
+        describe("description", () => {
+            it("describes the matcher correctly", () => {
+                const matcher = numberBetween(1, 10);
+                expect(desc(matcher)).toBe("number between number 1 and number 10 inclusive");
+            });
+            it("represents the matcher correctly", () => {
+                const matcher = numberBetween(1, 10);
+                expect(repr(matcher)).toBe("1<>10");
+            });
+            it("describes bigint correctly", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(desc(matcher)).toBe("number between bigint 1n and bigint 10n inclusive");
+            });
+            it("represents bigint correctly", () => {
+                const matcher = numberBetween(1n, 10n);
+                expect(repr(matcher)).toBe("1n<>10n");
+            });
+        });
+    });
+});
+//# sourceMappingURL=number-between.test.js.map

package/dist/assert/number-between/number-between.test.js.map

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

package/dist/assert/number-to-nearest/number-to-nearest.test.d.ts

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

package/dist/assert/number-to-nearest/number-to-nearest.test.d.ts.map

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

package/dist/assert/number-to-nearest/number-to-nearest.test.js

@@ -0,0 +1,129 @@
+import { describe, expect, it } from "vitest";
+import { desc, repr } from "../../describe/describe.js";
+import { assertNumberToNearest } from "./number-to-nearest.assert.js";
+import { numberToNearest } from "./number-to-nearest.match.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("number-to-nearest", () => {
+    describe("assertNumberToNearest", () => {
+        it("does not throw when value rounds to expected", () => {
+            expect(() => {
+                assertNumberToNearest(12.3, 1, 12);
+            }).not.toThrow();
+        });
+        it("rounds to nearest 10", () => {
+            expect(() => {
+                assertNumberToNearest(47, 10, 50);
+            }).not.toThrow();
+            expect(() => {
+                assertNumberToNearest(43, 10, 40);
+            }).not.toThrow();
+        });
+        it("rounds to nearest 0.1", () => {
+            expect(() => {
+                assertNumberToNearest(1.234, 0.1, 1.2);
+            }).not.toThrow();
+            expect(() => {
+                assertNumberToNearest(1.267, 0.1, 1.3);
+            }).not.toThrow();
+        });
+        it("rounds to nearest 5", () => {
+            expect(() => {
+                assertNumberToNearest(7, 5, 5);
+            }).not.toThrow();
+            expect(() => {
+                assertNumberToNearest(8, 5, 10);
+            }).not.toThrow();
+        });
+        it("throws when rounded value does not match expected", () => {
+            expect(() => {
+                assertNumberToNearest(47, 10, 40);
+            }).toThrow("Expected 47 to equal 40 to nearest 10.");
+        });
+        it("throws with custom message", () => {
+            expect(() => {
+                assertNumberToNearest(47, 10, 40, "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("handles exact values", () => {
+            expect(() => {
+                assertNumberToNearest(50, 10, 50);
+            }).not.toThrow();
+        });
+        it("handles negative numbers", () => {
+            expect(() => {
+                assertNumberToNearest(-47, 10, -50);
+            }).not.toThrow();
+            expect(() => {
+                assertNumberToNearest(-43, 10, -40);
+            }).not.toThrow();
+        });
+        it("throws when value is not a number", () => {
+            expect(() => {
+                assertNumberToNearest("47", 10, 50);
+            }).toThrow('Expected string "47" to be of type number.');
+        });
+    });
+    describe("numberToNearest", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: 47 } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: numberToNearest(10, 50) },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is a number.
+            const foobar = foo.bar.foobar;
+            expect(foobar).toBeTypeOf("number");
+        });
+        it("matches when value rounds to expected", () => {
+            const matcher = numberToNearest(1, 12);
+            expect(matcher.matches(12.3)).toBe(true);
+        });
+        it("matches to nearest 10", () => {
+            const matcher = numberToNearest(10, 50);
+            expect(matcher.matches(47)).toBe(true);
+            expect(matcher.matches(43)).toBe(false);
+        });
+        it("matches to nearest 0.1", () => {
+            const matcher = numberToNearest(0.1, 1.2);
+            expect(matcher.matches(1.234)).toBe(true);
+            expect(matcher.matches(1.267)).toBe(false);
+        });
+        it("matches to nearest 5", () => {
+            const matcher = numberToNearest(5, 10);
+            expect(matcher.matches(8)).toBe(true);
+            expect(matcher.matches(7)).toBe(false);
+        });
+        it("matches exact values", () => {
+            const matcher = numberToNearest(10, 50);
+            expect(matcher.matches(50)).toBe(true);
+        });
+        it("matches negative numbers", () => {
+            const matcher = numberToNearest(10, -50);
+            expect(matcher.matches(-47)).toBe(true);
+            expect(matcher.matches(-43)).toBe(false);
+        });
+        it("does not match non-number values", () => {
+            const matcher = numberToNearest(10, 50);
+            expect(matcher.matches("47")).toBe(false);
+            expect(matcher.matches(null)).toBe(false);
+            expect(matcher.matches(undefined)).toBe(false);
+        });
+        it("describes the matcher", () => {
+            const matcher = numberToNearest(10, 50);
+            expect(desc(matcher)).toBe("equal 50 to nearest 10");
+        });
+        it("represents the matcher", () => {
+            const matcher = numberToNearest(10, 50);
+            expect(repr(matcher)).toBe("≈₍10₎50");
+        });
+        it("describes and represents decimal increments", () => {
+            const matcher = numberToNearest(0.1, 1.2);
+            expect(desc(matcher)).toBe("equal 1.2 to nearest 0.1");
+            expect(repr(matcher)).toBe("≈₍0.1₎1.2");
+        });
+    });
+});
+//# sourceMappingURL=number-to-nearest.test.js.map

package/dist/assert/number-to-nearest/number-to-nearest.test.js.map

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

package/dist/assert/object-equals/object-equals.test.d.ts

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

package/dist/assert/object-equals/object-equals.test.d.ts.map

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

package/dist/assert/object-equals/object-equals.test.js

@@ -0,0 +1,87 @@
+import { describe, expect, it } from "vitest";
+import { assertObjectEquals } from "./object-equals.assert.js";
+describe("object-equals", () => {
+    it("does not throw when objects are deeply equal by value", () => {
+        expect(() => {
+            assertObjectEquals({
+                user: {
+                    name: "Ada",
+                    roles: ["admin", "editor"],
+                },
+                active: true,
+            }, {
+                user: {
+                    name: "Ada",
+                    roles: ["admin", "editor"],
+                },
+                active: true,
+            });
+        }).not.toThrow();
+    });
+    it("throws when nested object values differ", () => {
+        expect(() => {
+            assertObjectEquals({
+                user: {
+                    name: "Ada",
+                    age: 36,
+                },
+            }, {
+                user: {
+                    name: "Ada",
+                    age: 37,
+                },
+            });
+        }).toThrow('Expected object {"user":{"name":"Ada","age":36}} to equal object {"user":{"name":"Ada","age":37}}. Mismatch at $.user.age: expected 37, got 36.');
+    });
+    it("throws when arrays differ by value", () => {
+        expect(() => {
+            assertObjectEquals({
+                values: [1, 2, 3],
+            }, {
+                values: [1, 2, 4],
+            });
+        }).toThrow('Expected object {"values":[1,2,3]} to equal object {"values":[1,2,4]}. Mismatch at $.values[2]: expected 4, got 3.');
+    });
+    it("throws when actual object has extra keys", () => {
+        expect(() => {
+            assertObjectEquals({
+                name: "Ada",
+                extra: true,
+            }, {
+                name: "Ada",
+            });
+        }).toThrow();
+    });
+    it("throws when actual object is missing expected keys", () => {
+        expect(() => {
+            assertObjectEquals({
+                name: "Ada",
+            }, {
+                name: "Ada",
+                active: true,
+            });
+        }).toThrow('Expected object {"name":"Ada"} to equal object {"name":"Ada","active":true}. Mismatch at $: expected {"name":"Ada","active":true}, got {"name":"Ada"}.');
+    });
+    it("throws with custom message", () => {
+        expect(() => {
+            assertObjectEquals({ a: 1 }, { a: 2 }, "Custom error message");
+        }).toThrow("Custom error message");
+    });
+    it("narrows the actual value to the expected object type", () => {
+        const value = {
+            status: "active",
+            nested: {
+                count: 1,
+            },
+        };
+        assertObjectEquals(value, {
+            status: "active",
+            nested: {
+                count: 1,
+            },
+        });
+        expect(value.status).toBe("active");
+        expect(value.nested.count).toBe(1);
+    });
+});
+//# sourceMappingURL=object-equals.test.js.map

package/dist/assert/object-equals/object-equals.test.js.map

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

package/dist/assert/object-has-property/object-has-property.assert.d.ts

@@ -3,5 +3,5 @@ import { type ObjectWithProperty } from "./object-has-property.match.js";
  * Assert that an object has a certain named property.
  * The property only has to exist on the object, but could be undefined.
  */
-export declare function assertObjectHasProperty<T extends object, K extends PropertyKey>(value: T, key: K, message?: string): asserts value is T & ObjectWithProperty<K>;
+export declare function assertObjectHasProperty<T extends object, K extends PropertyKey>(value: T, key: K, message?: string): asserts value is T & ObjectWithProperty<K, T>;
 //# sourceMappingURL=object-has-property.assert.d.ts.map

package/dist/assert/object-has-property/object-has-property.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-has-property.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.assert.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,WAAW,EAErB,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAU5C"}
+{"version":3,"file":"object-has-property.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.assert.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,WAAW,EAErB,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAU/C"}

package/dist/assert/object-has-property/object-has-property.match.d.ts

@@ -1,8 +1,13 @@
-import { type AssertionMatcher } from "../../match/match.js";
-export type ObjectWithProperty<K extends PropertyKey> = object & Record<K, unknown>;
+import { type AssertionMatcher, type refinement } from "../../match/match.js";
+export type ObjectWithProperty<K extends PropertyKey, TActual = unknown> = K extends keyof NonNullable<TActual> ? Omit<NonNullable<TActual>, K> & {
+    [P in K]-?: Exclude<NonNullable<TActual>[P], undefined>;
+} : object & Record<K, unknown>;
+export type ObjectWithPropertyMatcher<K extends PropertyKey> = AssertionMatcher<ObjectWithProperty<K>> & {
+    readonly [refinement]?: <TActual>(actual: TActual) => ObjectWithProperty<K, TActual>;
+};
 /**
  * Matcher for an object with a certain named property.
  * The property only has to exist on the object, but could be undefined.
  */
-export declare function objectWithProperty<K extends PropertyKey>(key: K): AssertionMatcher<ObjectWithProperty<K>>;
+export declare function objectWithProperty<K extends PropertyKey>(key: K): ObjectWithPropertyMatcher<K>;
 //# sourceMappingURL=object-has-property.match.d.ts.map

package/dist/assert/object-has-property/object-has-property.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-has-property.match.d.ts","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,MAAM,GAC5D,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAErB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACtD,GAAG,EAAE,CAAC,GACL,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAOzC"}
+{"version":3,"file":"object-has-property.match.d.ts","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.match.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,kBAAkB,CAC5B,CAAC,SAAS,WAAW,EACrB,OAAO,GAAG,OAAO,IACf,CAAC,SAAS,MAAM,WAAW,CAAC,OAAO,CAAC,GACpC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG;KAC7B,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CACxD,GACD,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAEhC,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,WAAW,IAAI,gBAAgB,CAC7E,kBAAkB,CAAC,CAAC,CAAC,CACtB,GAAG;IACF,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,OAAO,EAC9B,MAAM,EAAE,OAAO,KACZ,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACtD,GAAG,EAAE,CAAC,GACL,yBAAyB,CAAC,CAAC,CAAC,CAO9B"}

package/dist/assert/object-has-property/object-has-property.match.js

@@ -1,5 +1,5 @@
 import { desc, repr } from "../../describe/describe.js";
-import { createMatcher } from "../../match/match.js";
+import { createMatcher, } from "../../match/match.js";
 /**
  * Matcher for an object with a certain named property.
  * The property only has to exist on the object, but could be undefined.

package/dist/assert/object-has-property/object-has-property.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"object-has-property.match.js","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK5E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAM;IAEN,OAAO,aAAa,CAClB,CAAC,KAAK,EAAkC,EAAE,CACxC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,EAC7D,GAAG,EAAE,CAAC,wBAAwB,IAAI,CAAC,GAAG,CAAC,EAAE,EACzC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CACvB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"object-has-property.match.js","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAEL,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAmB9B;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAM;IAEN,OAAO,aAAa,CAClB,CAAC,KAAK,EAAkC,EAAE,CACxC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,EAC7D,GAAG,EAAE,CAAC,wBAAwB,IAAI,CAAC,GAAG,CAAC,EAAE,EACzC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CACvB,CAAC;AACJ,CAAC"}

package/dist/assert/object-has-property/object-has-property.test.d.ts

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

package/dist/assert/object-has-property/object-has-property.test.d.ts.map

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

package/dist/assert/object-has-property/object-has-property.test.js

@@ -0,0 +1,123 @@
+import { describe, expect, it } from "vitest";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectHasProperty } from "./object-has-property.assert.js";
+import { objectWithProperty } from "./object-has-property.match.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("object-has-property", () => {
+    describe("assertObjectHasProperty", () => {
+        it("throws when object does not have property", () => {
+            expect(() => {
+                assertObjectHasProperty({ a: 1 }, "b");
+            }).toThrow('Expected object {"a":1} to be object with property string "b".');
+        });
+        it("does not throw when object has property", () => {
+            expect(() => {
+                assertObjectHasProperty({ a: 1 }, "a");
+            }).not.toThrow();
+        });
+        it("throws with custom message", () => {
+            expect(() => {
+                assertObjectHasProperty({ a: 1 }, "b", "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("works with nested objects", () => {
+            const obj = { outer: { inner: "value" } };
+            expect(() => {
+                assertObjectHasProperty(obj, "outer");
+            }).not.toThrow();
+            expect(() => {
+                assertObjectHasProperty(obj.outer, "inner");
+            }).not.toThrow();
+        });
+        it("works with arrays (has length property)", () => {
+            expect(() => {
+                assertObjectHasProperty([1, 2, 3], "length");
+            }).not.toThrow();
+        });
+        it("works with inherited properties", () => {
+            const obj = { a: 1 };
+            // Prototype property is accessible via 'toString'
+            expect(() => {
+                assertObjectHasProperty(obj, "toString");
+            }).not.toThrow();
+        });
+        it("works with undefined property value", () => {
+            expect(() => {
+                assertObjectHasProperty({ a: undefined }, "a");
+            }).not.toThrow();
+        });
+        it("works with empty object", () => {
+            expect(() => {
+                assertObjectHasProperty({}, "__proto__");
+            }).not.toThrow();
+        });
+        it("narrows the value type to include the property", () => {
+            const value = { name: "Ada" };
+            assertObjectHasProperty(value, "name");
+            expect(value.name).toBe("Ada");
+        });
+    });
+    describe("objectWithProperty", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { name: "test", id: 123 } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: objectWithProperty("name"),
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar has a "name" property with a string value.
+            const name = foo.bar.name;
+            const id = foo.bar.id;
+            expect(foo.bar).toHaveProperty("name");
+            expect(name).toBeTypeOf("string");
+            expect(["number", "undefined"]).toContain(typeof id);
+        });
+        it("matches objects with the property", () => {
+            const matcher = objectWithProperty("a");
+            expect(matcher.matches({ a: 1 })).toBe(true);
+        });
+        it("does not match objects without the property", () => {
+            const matcher = objectWithProperty("b");
+            expect(matcher.matches({ a: 1 })).toBe(false);
+        });
+        it("matches inherited properties", () => {
+            const matcher = objectWithProperty("toString");
+            expect(matcher.matches({ a: 1 })).toBe(true);
+        });
+        it("matches properties with undefined values", () => {
+            const matcher = objectWithProperty("a");
+            expect(matcher.matches({ a: undefined })).toBe(true);
+        });
+        it("matches array properties", () => {
+            const matcher = objectWithProperty("length");
+            expect(matcher.matches([1, 2, 3])).toBe(true);
+        });
+        it("matches symbol properties", () => {
+            const key = Symbol("test");
+            const matcher = objectWithProperty(key);
+            expect(matcher.matches({ [key]: 1 })).toBe(true);
+            expect(matcher.matches({})).toBe(false);
+        });
+        it("does not match null", () => {
+            const matcher = objectWithProperty("a");
+            expect(matcher.matches(null)).toBe(false);
+        });
+        it("does not match non-object values", () => {
+            const matcher = objectWithProperty("length");
+            expect(matcher.matches("abc")).toBe(false);
+            expect(matcher.matches(123)).toBe(false);
+            expect(matcher.matches(undefined)).toBe(false);
+        });
+        it("describes the matcher", () => {
+            const matcher = objectWithProperty("a");
+            expect(desc(matcher)).toBe('object with property string "a"');
+        });
+        it("represents the matcher", () => {
+            const matcher = objectWithProperty("a");
+            expect(repr(matcher)).toBe('{"a"}');
+        });
+    });
+});
+//# sourceMappingURL=object-has-property.test.js.map