@jamesaphoenix/tx-test-utils 0.4.2

package/dist/helpers/effect.test.js

@@ -0,0 +1,271 @@
+/**
+ * Effect test helpers unit tests.
+ *
+ * Tests the Effect runners and assertions for correct behavior.
+ */
+import { describe, it, expect } from "vitest";
+import { Effect, Layer, Context, Data } from "effect";
+import { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext } from "./effect.js";
+import { Either } from "effect";
+// =============================================================================
+// Test Error Types
+// =============================================================================
+class TestError extends Data.TaggedError("TestError") {
+}
+class TestServiceTag extends Context.Tag("TestService")() {
+}
+const TestServiceLive = Layer.succeed(TestServiceTag, {
+    getValue: () => Effect.succeed(42),
+    getValueOrFail: (shouldFail) => shouldFail
+        ? Effect.fail(new TestError({ message: "Test failure" }))
+        : Effect.succeed(42)
+});
+// =============================================================================
+// runEffect Tests
+// =============================================================================
+describe("runEffect", () => {
+    it("returns the value for a successful Effect", async () => {
+        const result = await runEffect(Effect.succeed(42));
+        expect(result).toBe(42);
+    });
+    it("works with complex values", async () => {
+        const obj = { name: "test", value: 123 };
+        const result = await runEffect(Effect.succeed(obj));
+        expect(result).toEqual(obj);
+    });
+    it("throws an error for a failed Effect", async () => {
+        const effect = Effect.fail(new TestError({ message: "oops" }));
+        await expect(runEffect(effect)).rejects.toThrow("Effect failed:");
+    });
+    it("supports Layer injection", async () => {
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValue();
+        });
+        const result = await runEffect(effect, TestServiceLive);
+        expect(result).toBe(42);
+    });
+    it("throws when Effect times out", async () => {
+        const slowEffect = Effect.gen(function* () {
+            yield* Effect.sleep(1000);
+            return 42;
+        });
+        await expect(runEffect(slowEffect, undefined, { timeout: 50 })).rejects.toThrow("Effect failed:");
+    });
+});
+// =============================================================================
+// runEffectFail Tests
+// =============================================================================
+describe("runEffectFail", () => {
+    it("returns the cause for a failed Effect", async () => {
+        const effect = Effect.fail(new TestError({ message: "expected failure" }));
+        const cause = await runEffectFail(effect);
+        expect(cause).toBeDefined();
+    });
+    it("throws when Effect succeeds unexpectedly", async () => {
+        const effect = Effect.succeed(42);
+        await expect(runEffectFail(effect)).rejects.toThrow("Expected Effect to fail, but it succeeded");
+    });
+    it("supports Layer injection for failure cases", async () => {
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValueOrFail(true);
+        });
+        const cause = await runEffectFail(effect, TestServiceLive);
+        expect(cause).toBeDefined();
+    });
+});
+// =============================================================================
+// runEffectEither Tests
+// =============================================================================
+describe("runEffectEither", () => {
+    it("returns Right for successful Effect", async () => {
+        const result = await runEffectEither(Effect.succeed(42));
+        expect(Either.isRight(result)).toBe(true);
+        if (Either.isRight(result)) {
+            expect(result.right).toBe(42);
+        }
+    });
+    it("returns Left for failed Effect", async () => {
+        const effect = Effect.fail(new TestError({ message: "expected" }));
+        const result = await runEffectEither(effect);
+        expect(Either.isLeft(result)).toBe(true);
+        if (Either.isLeft(result)) {
+            expect(result.left._tag).toBe("TestError");
+        }
+    });
+    it("never throws for typed failures", async () => {
+        const effect = Effect.fail(new TestError({ message: "test" }));
+        // Should not throw
+        const result = await runEffectEither(effect);
+        expect(Either.isLeft(result)).toBe(true);
+    });
+    it("supports Layer injection", async () => {
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValue();
+        });
+        const result = await runEffectEither(effect, TestServiceLive);
+        expect(Either.isRight(result)).toBe(true);
+        if (Either.isRight(result)) {
+            expect(result.right).toBe(42);
+        }
+    });
+});
+// =============================================================================
+// expectEffectSuccess Tests
+// =============================================================================
+describe("expectEffectSuccess", () => {
+    it("returns the value for successful Effect", async () => {
+        const result = await expectEffectSuccess(Effect.succeed(42));
+        expect(result).toBe(42);
+    });
+    it("supports validation callback", async () => {
+        let validated = false;
+        const result = await expectEffectSuccess(Effect.succeed({ id: 1, name: "test" }), undefined, (value) => {
+            expect(value.id).toBe(1);
+            expect(value.name).toBe("test");
+            validated = true;
+        });
+        expect(result.id).toBe(1);
+        expect(validated).toBe(true);
+    });
+    it("throws when Effect fails", async () => {
+        const effect = Effect.fail(new TestError({ message: "fail" }));
+        await expect(expectEffectSuccess(effect)).rejects.toThrow("Effect failed:");
+    });
+    it("supports async validation", async () => {
+        let validated = false;
+        await expectEffectSuccess(Effect.succeed(42), undefined, async (value) => {
+            await Promise.resolve();
+            expect(value).toBe(42);
+            validated = true;
+        });
+        expect(validated).toBe(true);
+    });
+});
+// =============================================================================
+// expectEffectFailure Tests
+// =============================================================================
+describe("expectEffectFailure", () => {
+    it("returns the error for failed Effect", async () => {
+        const effect = Effect.fail(new TestError({ message: "expected" }));
+        const error = await expectEffectFailure(effect);
+        expect(error._tag).toBe("TestError");
+        expect(error.message).toBe("expected");
+    });
+    it("supports validation callback", async () => {
+        const effect = Effect.fail(new TestError({ message: "check me" }));
+        const error = await expectEffectFailure(effect, undefined, (err) => {
+            expect(err._tag).toBe("TestError");
+            expect(err.message).toBe("check me");
+        });
+        expect(error.message).toBe("check me");
+    });
+    it("throws when Effect succeeds", async () => {
+        const effect = Effect.succeed(42);
+        await expect(expectEffectFailure(effect)).rejects.toThrow("Expected Effect to fail, but it succeeded");
+    });
+    it("supports Layer injection", async () => {
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValueOrFail(true);
+        });
+        const error = await expectEffectFailure(effect, TestServiceLive, (err) => {
+            expect(err._tag).toBe("TestError");
+        });
+        expect(error._tag).toBe("TestError");
+    });
+});
+// =============================================================================
+// mergeLayers Tests
+// =============================================================================
+describe("mergeLayers", () => {
+    class ServiceATag extends Context.Tag("ServiceA")() {
+    }
+    class ServiceBTag extends Context.Tag("ServiceB")() {
+    }
+    const ServiceALive = Layer.succeed(ServiceATag, { a: 1 });
+    const ServiceBLive = Layer.succeed(ServiceBTag, { b: "hello" });
+    it("returns empty layer when no layers provided", () => {
+        const merged = mergeLayers();
+        expect(merged).toBeDefined();
+    });
+    it("returns the layer when single layer provided", () => {
+        const merged = mergeLayers(ServiceALive);
+        expect(merged).toBeDefined();
+    });
+    it("merges multiple layers", async () => {
+        const merged = mergeLayers(ServiceALive, ServiceBLive);
+        const effect = Effect.gen(function* () {
+            const a = yield* ServiceATag;
+            const b = yield* ServiceBTag;
+            return { a: a.a, b: b.b };
+        });
+        const result = await runEffect(effect, merged);
+        expect(result).toEqual({ a: 1, b: "hello" });
+    });
+});
+// =============================================================================
+// createTestContext Tests
+// =============================================================================
+describe("createTestContext", () => {
+    it("creates a context with runEffect method", async () => {
+        const ctx = createTestContext(() => TestServiceLive);
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValue();
+        });
+        const result = await ctx.runEffect(effect);
+        expect(result).toBe(42);
+    });
+    it("reuses the layer across multiple calls", async () => {
+        let layerCreationCount = 0;
+        const ctx = createTestContext(() => {
+            layerCreationCount++;
+            return TestServiceLive;
+        });
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValue();
+        });
+        await ctx.runEffect(effect);
+        await ctx.runEffect(effect);
+        await ctx.runEffect(effect);
+        expect(layerCreationCount).toBe(1);
+    });
+    it("supports runEffectFail", async () => {
+        const ctx = createTestContext(() => TestServiceLive);
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValueOrFail(true);
+        });
+        const cause = await ctx.runEffectFail(effect);
+        expect(cause).toBeDefined();
+    });
+    it("supports runEffectEither", async () => {
+        const ctx = createTestContext(() => TestServiceLive);
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValue();
+        });
+        const result = await ctx.runEffectEither(effect);
+        expect(Either.isRight(result)).toBe(true);
+    });
+    it("reset forces layer recreation", async () => {
+        let layerCreationCount = 0;
+        const ctx = createTestContext(() => {
+            layerCreationCount++;
+            return TestServiceLive;
+        });
+        const effect = Effect.gen(function* () {
+            const service = yield* TestServiceTag;
+            return yield* service.getValue();
+        });
+        await ctx.runEffect(effect);
+        ctx.reset();
+        await ctx.runEffect(effect);
+        expect(layerCreationCount).toBe(2);
+    });
+});
+//# sourceMappingURL=effect.test.js.map

package/dist/helpers/effect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.test.js","sourceRoot":"","sources":["../../src/helpers/effect.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACrD,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,SAAU,SAAQ,IAAI,CAAC,WAAW,CAAC,WAAW,CAElD;CAAG;AAWL,MAAM,cAAe,SAAQ,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAGpD;CAAG;AAEN,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CACnC,cAAc,EACd;IACE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAClC,cAAc,EAAE,CAAC,UAAU,EAAE,EAAE,CAC7B,UAAU;QACR,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;CACzB,CACF,CAAA;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;QACxC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;QAE9D,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACrC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACzB,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,CACV,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAClD,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAA;QAE1E,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAEjC,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACjD,2CAA2C,CAC5C,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAExD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAClE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;QAE5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;QAE9D,mBAAmB;QACnB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;QAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,MAAM,GAAG,MAAM,mBAAmB,CACtC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EACvC,SAAS,EACT,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACxB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC/B,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CACF,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACzB,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;QAE9D,MAAM,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,mBAAmB,CACvB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAClB,SAAS,EACT,KAAK,EAAE,KAAK,EAAE,EAAE;YACd,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YACvB,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACtB,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CACF,CAAA;QAED,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAElE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAY,MAAM,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAElE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CACrC,MAAM,EACN,SAAS,EACT,CAAC,GAAG,EAAE,EAAE;YACN,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACtC,CAAC,CACF,CAAA;QAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAEjC,MAAM,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACvD,2CAA2C,CAC5C,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,MAAM,mBAAmB,CACrC,MAAa,EACb,eAAsB,EACtB,CAAC,GAAG,EAAE,EAAE;YACN,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACpC,CAAC,CACF,CAAA;QAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAQ3B,MAAM,WAAY,SAAQ,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAyB;KAAG;IAC7E,MAAM,WAAY,SAAQ,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAyB;KAAG;IAE7E,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACzD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAE/D,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,WAAW,CAAA;YAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,WAAW,CAAA;YAC5B,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAa,CAAC,CAAA;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,IAAI,kBAAkB,GAAG,CAAC,CAAA;QAE1B,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE;YACjC,kBAAkB,EAAE,CAAA;YACpB,OAAO,eAAe,CAAA;QACxB,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC3B,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC3B,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAE3B,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,CAAC,eAAsB,CAAC,CAAA;QAE3D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,MAAa,CAAC,CAAA;QACpD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAA;QAEpD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;QAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,IAAI,kBAAkB,GAAG,CAAC,CAAA;QAE1B,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE;YACjC,kBAAkB,EAAE,CAAA;YACpB,OAAO,eAAe,CAAA;QACxB,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;YACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC3B,GAAG,CAAC,KAAK,EAAE,CAAA;QACX,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAE3B,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Test helper utilities.
+ *
+ * @module @tx/test-utils/helpers
+ */
+export { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext, type RunEffectOptions, type EffectResult } from "./effect.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAA"}

package/dist/helpers/index.js

@@ -0,0 +1,11 @@
+/**
+ * Test helper utilities.
+ *
+ * @module @tx/test-utils/helpers
+ */
+// Effect test helpers
+export { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext } from "./effect.js";
+// TODO: Implement temp file helpers
+// export { createTempDir, writeTestTypeScriptFile, createTestSourceFiles } from './temp-files.js'
+// export type { TempDir } from './temp-files.js'
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sBAAsB;AACtB,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAGlB,MAAM,aAAa,CAAA;AAEpB,oCAAoC;AACpC,kGAAkG;AAClG,iDAAiD"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @tx/test-utils - Test utilities, factories, fixtures, and helpers
+ *
+ * This package centralizes all test utilities across the tx monorepo.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createTestDatabase,
+ *   createTestLearning,
+ *   fixtureId,
+ *   runEffect
+ * } from '@tx/test-utils'
+ * ```
+ *
+ * @module @tx/test-utils
+ */
+export { fixtureId, namespacedFixtureId, sequentialFixtureIds, contentFixtureId } from "./fixtures/index.js";
+export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer } from "./database/index.js";
+export type { TestDatabase } from "./database/index.js";
+export { TaskFactory, createTestTask, createTestTasks, type CreateTaskOptions, LearningFactory, createTestLearning, createTestLearnings, type CreateLearningOptions, EdgeFactory, createTestEdge, createEdgeBetweenLearnings, type CreateEdgeOptions, AnchorFactory, createTestAnchor, type CreateAnchorOptions, CandidateFactory, createTestCandidate, type CreateCandidateOptions, type LearningCandidate, type CandidateConfidence, type CandidateStatus } from "./factories/index.js";
+export { hashInput, cachedLLMCall, withLLMCache, configureLLMCache, getCacheConfig, resetCacheConfig, getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./llm-cache/index.js";
+export type { CacheEntry, CachedLLMCallOptions, WithLLMCacheOptions, CacheStats, ClearCacheOptions } from "./llm-cache/index.js";
+export { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext, type RunEffectOptions, type EffectResult } from "./helpers/index.js";
+export { createMockAnthropic, createMockAnthropicForExtraction, type MockMessage, type MockAnthropicCall, type MockAnthropicResponse, type MockAnthropicConfig, type MockAnthropicResult, createMockOpenAI, createMockOpenAIForExtraction, createMockOpenAIForExtractionRaw, type MockOpenAIMessage, type MockOpenAIChatCall, type MockOpenAIChatResponse, type MockOpenAIConfig, type MockOpenAIResult } from "./mocks/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,EAEL,WAAW,EACX,cAAc,EACd,eAAe,EACf,KAAK,iBAAiB,EAEtB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,qBAAqB,EAE1B,WAAW,EACX,cAAc,EACd,0BAA0B,EAC1B,KAAK,iBAAiB,EAEtB,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,EAExB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAEL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAO3B,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAChC,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,6BAA6B,EAC7B,gCAAgC,EAChC,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,52 @@
+/**
+ * @tx/test-utils - Test utilities, factories, fixtures, and helpers
+ *
+ * This package centralizes all test utilities across the tx monorepo.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createTestDatabase,
+ *   createTestLearning,
+ *   fixtureId,
+ *   runEffect
+ * } from '@tx/test-utils'
+ * ```
+ *
+ * @module @tx/test-utils
+ */
+// Fixtures - SHA256-based deterministic IDs
+export { fixtureId, namespacedFixtureId, sequentialFixtureIds, contentFixtureId } from "./fixtures/index.js";
+// Database helpers
+export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer } from "./database/index.js";
+// Factories
+export { 
+// Task
+TaskFactory, createTestTask, createTestTasks, 
+// Learning
+LearningFactory, createTestLearning, createTestLearnings, 
+// Edge
+EdgeFactory, createTestEdge, createEdgeBetweenLearnings, 
+// Anchor
+AnchorFactory, createTestAnchor, 
+// Candidate
+CandidateFactory, createTestCandidate } from "./factories/index.js";
+// LLM Cache - SHA256-based response caching
+export { 
+// Core functions
+hashInput, cachedLLMCall, withLLMCache, configureLLMCache, getCacheConfig, resetCacheConfig, 
+// CLI utilities
+getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./llm-cache/index.js";
+// Effect Helpers
+export { runEffect, runEffectFail, runEffectEither, expectEffectSuccess, expectEffectFailure, mergeLayers, createTestContext } from "./helpers/index.js";
+// Temp Files (to be implemented)
+// export { createTempDir, writeTestTypeScriptFile, createTestSourceFiles } from './helpers/index.js'
+// export type { TempDir } from './helpers/index.js'
+// Mocks
+export { createMockAnthropic, createMockAnthropicForExtraction, createMockOpenAI, createMockOpenAIForExtraction, createMockOpenAIForExtractionRaw } from "./mocks/index.js";
+// TODO: Implement remaining mocks (tx-b28e5324)
+// export { MockAstGrepService } from './mocks/index.js'
+// export { MockFileSystem } from './mocks/index.js'
+// Setup (to be implemented)
+// export { default as vitestSetup } from './setup/index.js'
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4CAA4C;AAC5C,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAE5B,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,qBAAqB,CAAA;AAG5B,YAAY;AACZ,OAAO;AACL,OAAO;AACP,WAAW,EACX,cAAc,EACd,eAAe;AAEf,WAAW;AACX,eAAe,EACf,kBAAkB,EAClB,mBAAmB;AAEnB,OAAO;AACP,WAAW,EACX,cAAc,EACd,0BAA0B;AAE1B,SAAS;AACT,aAAa,EACb,gBAAgB;AAEhB,YAAY;AACZ,gBAAgB,EAChB,mBAAmB,EAKpB,MAAM,sBAAsB,CAAA;AAE7B,4CAA4C;AAC5C,OAAO;AACL,iBAAiB;AACjB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,gBAAgB;AAChB,gBAAgB;AAChB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAS7B,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAGlB,MAAM,oBAAoB,CAAA;AAE3B,iCAAiC;AACjC,qGAAqG;AACrG,oDAAoD;AAEpD,QAAQ;AACR,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAMhC,gBAAgB,EAChB,6BAA6B,EAC7B,gCAAgC,EAMjC,MAAM,kBAAkB,CAAA;AACzB,gDAAgD;AAChD,wDAAwD;AACxD,oDAAoD;AAEpD,4BAA4B;AAC5B,4DAA4D"}

package/dist/llm-cache/cache.d.ts

@@ -0,0 +1,152 @@
+/**
+ * LLM response caching with SHA256 keys.
+ *
+ * Caches expensive LLM API calls by hashing inputs with SHA256.
+ * Supports version-based cache invalidation and various bypass modes.
+ *
+ * @module @tx/test-utils/llm-cache/cache
+ */
+/**
+ * Global cache configuration.
+ */
+interface LLMCacheConfig {
+    /** Directory for cache files. Default: test/fixtures/llm-cache */
+    cacheDir: string;
+    /** Enable console logging. Default: true in non-CI environments */
+    logging: boolean;
+}
+/**
+ * Configure LLM cache settings.
+ *
+ * @example
+ * ```typescript
+ * configureLLMCache({
+ *   cacheDir: 'custom/cache/path',
+ *   logging: false
+ * })
+ * ```
+ */
+export declare const configureLLMCache: (options: Partial<LLMCacheConfig>) => void;
+/**
+ * Get current cache configuration.
+ */
+export declare const getCacheConfig: () => Readonly<LLMCacheConfig>;
+/**
+ * Reset cache configuration to defaults.
+ */
+export declare const resetCacheConfig: () => void;
+/**
+ * Cache entry stored in JSON files.
+ */
+export interface CacheEntry<T> {
+    /** SHA256 hash of input (also the filename) */
+    inputHash: string;
+    /** Truncated input for human readability */
+    input: string;
+    /** Cached response data */
+    response: T;
+    /** Model identifier (for debugging) */
+    model: string;
+    /** ISO timestamp when cached */
+    cachedAt: string;
+    /** Version for cache invalidation */
+    version: number;
+}
+/**
+ * Options for cachedLLMCall.
+ */
+export interface CachedLLMCallOptions {
+    /** Cache version - mismatch triggers cache miss */
+    version?: number;
+    /** Force refresh even if cached */
+    forceRefresh?: boolean;
+}
+/**
+ * Options for withLLMCache wrapper.
+ */
+export interface WithLLMCacheOptions<TInput> {
+    /** Model identifier for cache metadata */
+    model: string;
+    /** Custom serializer for input (default: JSON.stringify) */
+    serialize?: (input: TInput) => string;
+    /** Cache version for invalidation */
+    version?: number;
+}
+/**
+ * Compute SHA256 hash of input string for cache key.
+ *
+ * @example
+ * ```typescript
+ * const hash = hashInput("What is the capital of France?")
+ * // -> "a1b2c3d4e5f6..." (64 hex chars)
+ * ```
+ */
+export declare const hashInput: (input: string) => string;
+/**
+ * Get cached LLM response or execute and cache.
+ *
+ * Features:
+ * - TX_NO_LLM_CACHE=1 env var bypasses cache entirely
+ * - forceRefresh option forces fresh call even if cached
+ * - version option enables cache invalidation on version mismatch
+ *
+ * @example
+ * ```typescript
+ * const result = await cachedLLMCall(
+ *   "What is the capital of France?",
+ *   "claude-sonnet-4",
+ *   async () => {
+ *     const response = await anthropic.messages.create({...})
+ *     return response.content[0].text
+ *   },
+ *   { version: 2 }
+ * )
+ * ```
+ */
+export declare const cachedLLMCall: <T>(input: string, model: string, call: () => Promise<T>, options?: CachedLLMCallOptions) => Promise<T>;
+/**
+ * Wrap an async function to use LLM caching.
+ *
+ * Creates a cached version of any async function. The input is serialized
+ * and hashed to create a cache key.
+ *
+ * @example
+ * ```typescript
+ * // Wrap an extraction function
+ * const cachedExtract = withLLMCache(
+ *   async (transcript: string) => {
+ *     const response = await anthropic.messages.create({
+ *       model: "claude-sonnet-4-20250514",
+ *       messages: [{ role: "user", content: extractPrompt(transcript) }]
+ *     })
+ *     return JSON.parse(response.content[0].text)
+ *   },
+ *   { model: "claude-sonnet-4", version: 1 }
+ * )
+ *
+ * // Use it - results are cached
+ * const result1 = await cachedExtract("some transcript")
+ * const result2 = await cachedExtract("some transcript") // cache hit!
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom serializer for complex input
+ * interface ComplexInput {
+ *   transcript: string
+ *   metadata: { source: string }
+ * }
+ *
+ * const cachedProcess = withLLMCache(
+ *   async (input: ComplexInput) => processInput(input),
+ *   {
+ *     model: "claude-sonnet-4",
+ *     serialize: (input) => `${input.metadata.source}::${input.transcript}`,
+ *     version: 2
+ *   }
+ * )
+ * ```
+ */
+export declare const withLLMCache: <TInput, TOutput>(fn: (input: TInput) => Promise<TOutput>, options: WithLLMCacheOptions<TInput>) => ((input: TInput) => Promise<TOutput>);
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/llm-cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/llm-cache/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,UAAU,cAAc;IACtB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAA;CACjB;AAeD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,CAAC,cAAc,CAAC,KAAG,IAEpE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,QAAQ,CAAC,cAAc,CAAW,CAAA;AAEpE;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,IAKnC,CAAA;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,CAAA;IACX,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM;IACzC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAEzC,CAAA;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,GAAU,CAAC,EACnC,OAAO,MAAM,EACb,OAAO,MAAM,EACb,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,UAAS,oBAAyB,KACjC,OAAO,CAAC,CAAC,CAsDX,CAAA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,EAAE,OAAO,EAC1C,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvC,SAAS,mBAAmB,CAAC,MAAM,CAAC,KACnC,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAYtC,CAAA"}