@shivaedev/effect-test 0.0.0-bootstrap.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0 - 2026-08-30
+
+### Added
+
+- Add `makeEffectIt` for generator Effect tests on a worker-scoped Layer, with
+  TestClock by default, an optional `around` hook, and a Clock-aware
+  `eventually` helper.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShivaeDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# `@shivaedev/effect-test`
+
+A Vitest runner for Effect programs. The test Layer is built once per worker.
+Each test gets a fresh Scope, a generator body, and TestClock unless you ask
+for the live clock.
+
+Prisma and tRPC testing helpers in this repository are thin wrappers around
+`makeEffectIt`. Use this package directly when those wrappers are the wrong
+shape.
+
+This package currently targets exact early-access versions of Effect v4. It is
+built for ShivaeDev applications and may change without a deprecation period.
+
+## Install
+
+```sh
+pnpm add --save-dev @shivaedev/effect-test @effect/vitest effect vitest
+```
+
+## `makeEffectIt`
+
+```ts
+import { Layer } from "effect"
+import { makeEffectIt } from "@shivaedev/effect-test"
+
+const { effectApp } = makeEffectIt({
+  layer: TestLive,
+  makeHarness: () => Effect.succeed({}),
+})
+
+effectApp("reads a service from the test Layer", function* (_harness, _context) {
+  const movies = yield* Movies
+  expect(yield* movies.list()).toEqual([])
+})
+```
+
+`makeHarness` runs inside the worker Layer and any `around` wrapper, then the
+generator receives that value as its first argument.
+
+```ts
+const { effectApp } = makeEffectIt({
+  layer: DatabaseLive,
+  around: (effect) => withTestTransaction(Database, effect),
+  makeHarness: () => Database,
+})
+```
+
+`effectApp` supports `skip`, `skipIf`, `runIf`, `only`, `each`, and `fails`.
+
+## Clock
+
+Tests install TestClock and TestConsole. Pass `clock: "live"` on the factory or
+on a single test when the program must use wall-clock time:
+
+```ts
+effectApp("talks to a real timer", function* () {
+  yield* Effect.sleep("10 millis")
+}, { clock: "live" })
+```
+
+## `eventually`
+
+Retries until the effect succeeds. Under TestClock it advances time with
+`TestClock.adjust`. Under `clock: "live"` it uses `Schedule.spaced`.
+
+```ts
+import { eventually } from "@shivaedev/effect-test"
+
+effectApp("sees a delayed write", function* ({ db }) {
+  const row = yield* eventually(db.Job.where({ id }).first(), {
+    interval: "10 millis",
+    times: 50,
+  })
+  expect(row.status).toBe("ready")
+})
+```

package/dist/eventually.d.ts

@@ -0,0 +1,7 @@
+import { type Duration, Effect } from "effect";
+export interface EventuallyOptions {
+    readonly interval?: Duration.Input;
+    readonly times?: number;
+}
+export declare const eventually: <A, E, R>(effect: Effect.Effect<A, E, R>, options?: EventuallyOptions) => Effect.Effect<A, E, R>;
+//# sourceMappingURL=eventually.d.ts.map

package/dist/eventually.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventually.d.ts","sourceRoot":"","sources":["../src/eventually.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAGtE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAOD,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EACjC,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,UAAU,iBAAiB,KACzB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CA4BrB,CAAC"}

package/dist/eventually.js

@@ -0,0 +1,31 @@
+import { Clock, Effect, Exit, Schedule } from "effect";
+import * as TestClock from "effect/testing/TestClock";
+const defaultInterval = "10 millis";
+const isTestClock = (clock) => "adjust" in clock;
+export const eventually = (effect, options) => Effect.gen(function* () {
+    const interval = options?.interval ?? defaultInterval;
+    const clock = yield* Clock.Clock;
+    if (!isTestClock(clock)) {
+        return yield* options?.times === undefined
+            ? Effect.retry(effect, Schedule.spaced(interval))
+            : Effect.retry(effect, {
+                schedule: Schedule.spaced(interval),
+                times: options.times,
+            });
+    }
+    let retriesLeft = options?.times;
+    for (;;) {
+        const exit = yield* Effect.exit(effect);
+        if (Exit.isSuccess(exit)) {
+            return exit.value;
+        }
+        if (retriesLeft === 0) {
+            return yield* exit;
+        }
+        if (retriesLeft !== undefined) {
+            retriesLeft -= 1;
+        }
+        yield* TestClock.adjust(interval);
+    }
+});
+//# sourceMappingURL=eventually.js.map

package/dist/eventually.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventually.js","sourceRoot":"","sources":["../src/eventually.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAiB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AAOtD,MAAM,eAAe,GAAG,WAAW,CAAC;AAEpC,MAAM,WAAW,GAAG,CAAC,KAAkB,EAAgC,EAAE,CACxE,QAAQ,IAAI,KAAK,CAAC;AAEnB,MAAM,CAAC,MAAM,UAAU,GAAG,CACzB,MAA8B,EAC9B,OAA2B,EACF,EAAE,CAC3B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACnB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,eAAe,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAEjC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS;YACzC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;gBACrB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACnC,KAAK,EAAE,OAAO,CAAC,KAAK;aACpB,CAAC,CAAC;IACN,CAAC;IAED,IAAI,WAAW,GAAG,OAAO,EAAE,KAAK,CAAC;IACjC,SAAS,CAAC;QACT,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC;QACnB,CAAC;QACD,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC/B,WAAW,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;AACF,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type EventuallyOptions, eventually } from "./eventually.js";
+export type { EffectClock, EffectTest, EffectTester, EffectTestOptions, MakeEffectItOptions, MakeEffectItResult, } from "./types.js";
+export { makeEffectIt } from "./vitest.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,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { eventually } from "./eventually.js";
+export { makeEffectIt } from "./vitest.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,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AASrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+import type { TestContext, TestOptions } from "@effect/vitest";
+import type { Effect, Layer } from "effect";
+export type EffectClock = "test" | "live";
+export type EffectTestOptions = TestOptions & {
+    readonly clock?: EffectClock;
+};
+export type EffectTest<Harness, Provided> = <A, Eff extends Effect.Effect<unknown, unknown, Provided>>(name: string, body: (harness: Harness, context: TestContext) => Generator<Eff, A, never>, options?: number | EffectTestOptions) => void;
+export interface EffectTester<Harness, Provided> extends EffectTest<Harness, Provided> {
+    readonly skip: EffectTest<Harness, Provided>;
+    readonly skipIf: (condition: unknown) => EffectTest<Harness, Provided>;
+    readonly runIf: (condition: unknown) => EffectTest<Harness, Provided>;
+    readonly only: EffectTest<Harness, Provided>;
+    readonly each: <Item>(cases: ReadonlyArray<Item>) => <A, Eff extends Effect.Effect<unknown, unknown, Provided>>(name: string, body: (item: Item, harness: Harness, context: TestContext) => Generator<Eff, A, never>, options?: number | EffectTestOptions) => void;
+    readonly fails: EffectTest<Harness, Provided>;
+}
+export interface MakeEffectItOptions<Harness, TestLayer extends Layer.Layer<any, any, never>> {
+    readonly layer: TestLayer;
+    readonly around?: <A, E>(effect: Effect.Effect<A, E, Layer.Success<TestLayer>>) => Effect.Effect<A, unknown, Layer.Success<TestLayer>>;
+    readonly makeHarness: (context: TestContext) => Effect.Effect<Harness, unknown, Layer.Success<TestLayer>>;
+    readonly clock?: EffectClock;
+}
+export interface MakeEffectItResult<Harness, Provided> {
+    readonly effectApp: EffectTester<Harness, Provided>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,IAAI,CAC3C,CAAC,EACD,GAAG,SAAS,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAErD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,EAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,KAChC,IAAI,CAAC;AAEV,MAAM,WAAW,YAAY,CAAC,OAAO,EAAE,QAAQ,CAC9C,SAAQ,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EACnB,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,KACtB,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAC7D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CACL,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,KAChB,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,KAChC,IAAI,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB,CACnC,OAAO,EAEP,SAAS,SAAS,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC;IAE9C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KACjD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,CACrB,OAAO,EAAE,WAAW,KAChB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,EAAE,QAAQ;IACpD,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CACpD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/vitest.d.ts

@@ -0,0 +1,4 @@
+import { Layer } from "effect";
+import type { MakeEffectItOptions, MakeEffectItResult } from "./types.js";
+export declare const makeEffectIt: <Harness, TestLayer extends Layer.Layer<any, any, never>>(options: MakeEffectItOptions<Harness, TestLayer>) => MakeEffectItResult<Harness, Layer.Success<TestLayer>>;
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqC,KAAK,EAAS,MAAM,QAAQ,CAAC;AAGzE,OAAO,KAAK,EAKX,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAyGpB,eAAO,MAAM,YAAY,GACxB,OAAO,EAEP,SAAS,SAAS,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAE9C,SAAS,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,KAC9C,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAuHtD,CAAC"}

package/dist/vitest.js

@@ -0,0 +1,103 @@
+import { it as effectIt, } from "@effect/vitest";
+import { Cause, Effect, Exit, Layer, Scope } from "effect";
+import * as TestClock from "effect/testing/TestClock";
+import * as TestConsole from "effect/testing/TestConsole";
+const fixtureName = "__effectTestContext";
+const TestClockEnvironment = Layer.mergeAll(TestConsole.layer, TestClock.layer());
+const LiveClockEnvironment = TestConsole.layer;
+const environmentFor = (clock) => clock === "live" ? LiveClockEnvironment : TestClockEnvironment;
+const restoreContext = (fixture, context) => ({
+    ...context,
+    [fixtureName]: fixture,
+});
+const contextFrom = (context) => context[fixtureName];
+const runEffectTest = (effect, context, clock) => Effect.runPromise(Effect.gen(function* () {
+    const exit = yield* Effect.exit(effect);
+    if (Exit.isFailure(exit)) {
+        for (const error of Cause.prettyErrors(exit.cause)) {
+            yield* Effect.logError(error);
+        }
+    }
+    return yield* exit;
+}).pipe(Effect.scoped, Effect.provide(environmentFor(clock))), { signal: context.signal });
+const splitOptions = (options) => {
+    if (typeof options === "number") {
+        return { clock: undefined, vitest: { timeout: options } };
+    }
+    if (options === undefined) {
+        return { clock: undefined, vitest: {} };
+    }
+    const { clock, ...vitest } = options;
+    return { clock, vitest };
+};
+const makeFixtureIt = (layer) => effectIt.extend(fixtureName, { scope: "worker" }, 
+// biome-ignore lint/correctness/noEmptyPattern: Vitest fixtures require a destructured context parameter.
+async ({}, { onCleanup }) => {
+    const scope = Effect.runSync(Scope.make());
+    onCleanup(() => Effect.runPromise(Scope.close(scope, Exit.void)));
+    try {
+        return await Effect.runPromise(Layer.buildWithScope(layer, scope));
+    }
+    catch (error) {
+        await Effect.runPromise(Scope.close(scope, Exit.void));
+        throw error;
+    }
+});
+export const makeEffectIt = (options) => {
+    const fixtureIt = makeFixtureIt(options.layer);
+    const defaultClock = options.clock ?? "test";
+    const run = (body, context) => {
+        const program = Effect.gen(function* () {
+            const harness = yield* options.makeHarness(context);
+            return yield* Effect.gen(() => body(harness, context));
+        });
+        // The body constraint proves every yielded service is part of Provided.
+        // TypeScript cannot reduce that generic generator requirement here.
+        const ready = program;
+        const wrapped = options.around?.(ready) ?? ready;
+        return wrapped.pipe(Effect.provide(contextFrom(context)));
+    };
+    const register = (current) => (name, body, testOptions) => {
+        const split = splitOptions(testOptions);
+        const clock = split.clock ?? defaultClock;
+        current(name, split.vitest, ({ __effectTestContext, task, signal, onTestFailed, onTestFinished, skip, annotate, expect, _local, }) => {
+            const context = restoreContext(__effectTestContext, {
+                annotate,
+                expect,
+                onTestFailed,
+                onTestFinished,
+                signal,
+                skip,
+                task,
+                _local,
+            });
+            return runEffectTest(run(body, context), context, clock);
+        });
+    };
+    const effectApp = Object.assign(register(fixtureIt), {
+        skip: register(fixtureIt.skip),
+        skipIf: (condition) => register(fixtureIt.skipIf(condition)),
+        runIf: (condition) => register(fixtureIt.runIf(condition)),
+        only: register(fixtureIt.only),
+        each: (cases) => (name, body, testOptions) => {
+            const split = splitOptions(testOptions);
+            const clock = split.clock ?? defaultClock;
+            fixtureIt.for(cases)(name, split.vitest, (item, { __effectTestContext, task, signal, onTestFailed, onTestFinished, skip, annotate, expect, _local, }) => {
+                const context = restoreContext(__effectTestContext, {
+                    annotate,
+                    expect,
+                    onTestFailed,
+                    onTestFinished,
+                    signal,
+                    skip,
+                    task,
+                    _local,
+                });
+                return runEffectTest(run((harness, testContext) => body(item, harness, testContext), context), context, clock);
+            });
+        },
+        fails: register(fixtureIt.fails),
+    });
+    return { effectApp };
+};
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@shivaedev/effect-test",
+  "version": "0.0.0-bootstrap.0",
+  "description": "Generic Effect Vitest runner with worker-scoped Layers and TestClock",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ShivaeDev/platform.git",
+    "directory": "packages/effect-test"
+  },
+  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/effect-test#readme",
+  "bugs": {
+    "url": "https://github.com/ShivaeDev/platform/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@effect/vitest": "4.0.0-rc.108",
+    "effect": "4.0.0-rc.108"
+  },
+  "peerDependenciesMeta": {
+    "@effect/vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.0.0-rc.108",
+    "@types/node": "24.10.1",
+    "@typescript/native": "npm:typescript@7.0.2",
+    "effect": "4.0.0-rc.108",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "4.1.9"
+  },
+  "scripts": {
+    "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc6 --project tsconfig.build.json",
+    "check": "biome check .",
+    "test": "vitest run",
+    "test:package": "node scripts/test-package.mjs",
+    "typecheck": "tsc --noEmit",
+    "typecheck:compat": "tsc6 --noEmit",
+    "ready": "pnpm check && pnpm typecheck && pnpm typecheck:compat && pnpm test && pnpm build && pnpm test:package"
+  }
+}

package/src/eventually.ts

@@ -0,0 +1,45 @@
+import { Clock, type Duration, Effect, Exit, Schedule } from "effect";
+import * as TestClock from "effect/testing/TestClock";
+
+export interface EventuallyOptions {
+	readonly interval?: Duration.Input;
+	readonly times?: number;
+}
+
+const defaultInterval = "10 millis";
+
+const isTestClock = (clock: Clock.Clock): clock is TestClock.TestClock =>
+	"adjust" in clock;
+
+export const eventually = <A, E, R>(
+	effect: Effect.Effect<A, E, R>,
+	options?: EventuallyOptions,
+): Effect.Effect<A, E, R> =>
+	Effect.gen(function* () {
+		const interval = options?.interval ?? defaultInterval;
+		const clock = yield* Clock.Clock;
+
+		if (!isTestClock(clock)) {
+			return yield* options?.times === undefined
+				? Effect.retry(effect, Schedule.spaced(interval))
+				: Effect.retry(effect, {
+						schedule: Schedule.spaced(interval),
+						times: options.times,
+					});
+		}
+
+		let retriesLeft = options?.times;
+		for (;;) {
+			const exit = yield* Effect.exit(effect);
+			if (Exit.isSuccess(exit)) {
+				return exit.value;
+			}
+			if (retriesLeft === 0) {
+				return yield* exit;
+			}
+			if (retriesLeft !== undefined) {
+				retriesLeft -= 1;
+			}
+			yield* TestClock.adjust(interval);
+		}
+	});

package/src/index.ts

@@ -0,0 +1,10 @@
+export { type EventuallyOptions, eventually } from "./eventually.js";
+export type {
+	EffectClock,
+	EffectTest,
+	EffectTester,
+	EffectTestOptions,
+	MakeEffectItOptions,
+	MakeEffectItResult,
+} from "./types.js";
+export { makeEffectIt } from "./vitest.js";

package/src/types.ts

@@ -0,0 +1,56 @@
+import type { TestContext, TestOptions } from "@effect/vitest";
+import type { Effect, Layer } from "effect";
+
+export type EffectClock = "test" | "live";
+
+export type EffectTestOptions = TestOptions & {
+	readonly clock?: EffectClock;
+};
+
+export type EffectTest<Harness, Provided> = <
+	A,
+	Eff extends Effect.Effect<unknown, unknown, Provided>,
+>(
+	name: string,
+	body: (harness: Harness, context: TestContext) => Generator<Eff, A, never>,
+	options?: number | EffectTestOptions,
+) => void;
+
+export interface EffectTester<Harness, Provided>
+	extends EffectTest<Harness, Provided> {
+	readonly skip: EffectTest<Harness, Provided>;
+	readonly skipIf: (condition: unknown) => EffectTest<Harness, Provided>;
+	readonly runIf: (condition: unknown) => EffectTest<Harness, Provided>;
+	readonly only: EffectTest<Harness, Provided>;
+	readonly each: <Item>(
+		cases: ReadonlyArray<Item>,
+	) => <A, Eff extends Effect.Effect<unknown, unknown, Provided>>(
+		name: string,
+		body: (
+			item: Item,
+			harness: Harness,
+			context: TestContext,
+		) => Generator<Eff, A, never>,
+		options?: number | EffectTestOptions,
+	) => void;
+	readonly fails: EffectTest<Harness, Provided>;
+}
+
+export interface MakeEffectItOptions<
+	Harness,
+	// biome-ignore lint/suspicious/noExplicitAny: Layer output and error are recovered with Layer utility types
+	TestLayer extends Layer.Layer<any, any, never>,
+> {
+	readonly layer: TestLayer;
+	readonly around?: <A, E>(
+		effect: Effect.Effect<A, E, Layer.Success<TestLayer>>,
+	) => Effect.Effect<A, unknown, Layer.Success<TestLayer>>;
+	readonly makeHarness: (
+		context: TestContext,
+	) => Effect.Effect<Harness, unknown, Layer.Success<TestLayer>>;
+	readonly clock?: EffectClock;
+}
+
+export interface MakeEffectItResult<Harness, Provided> {
+	readonly effectApp: EffectTester<Harness, Provided>;
+}

package/src/vitest.ts

@@ -0,0 +1,246 @@
+import {
+	it as effectIt,
+	type TestContext,
+	type TestOptions,
+} from "@effect/vitest";
+import { Cause, type Context, Effect, Exit, Layer, Scope } from "effect";
+import * as TestClock from "effect/testing/TestClock";
+import * as TestConsole from "effect/testing/TestConsole";
+import type {
+	EffectClock,
+	EffectTest,
+	EffectTester,
+	EffectTestOptions,
+	MakeEffectItOptions,
+	MakeEffectItResult,
+} from "./types.js";
+
+const fixtureName = "__effectTestContext";
+
+type EffectFixture<Provided> = TestContext & {
+	readonly [fixtureName]: Context.Context<Provided>;
+};
+
+interface FixtureTestApi<Provided> {
+	(
+		name: string,
+		options: TestOptions,
+		body: (context: EffectFixture<Provided>) => Promise<unknown>,
+	): void;
+	readonly skip: FixtureTestApi<Provided>;
+	readonly skipIf: (condition: unknown) => FixtureTestApi<Provided>;
+	readonly runIf: (condition: unknown) => FixtureTestApi<Provided>;
+	readonly only: FixtureTestApi<Provided>;
+	readonly fails: FixtureTestApi<Provided>;
+	readonly for: <Item>(
+		cases: ReadonlyArray<Item>,
+	) => (
+		name: string,
+		options: TestOptions,
+		body: (item: Item, context: EffectFixture<Provided>) => Promise<unknown>,
+	) => void;
+}
+
+const TestClockEnvironment = Layer.mergeAll(
+	TestConsole.layer,
+	TestClock.layer(),
+);
+const LiveClockEnvironment = TestConsole.layer;
+
+const environmentFor = (clock: EffectClock) =>
+	clock === "live" ? LiveClockEnvironment : TestClockEnvironment;
+
+const restoreContext = <Provided>(
+	fixture: Context.Context<Provided>,
+	context: Omit<EffectFixture<Provided>, typeof fixtureName>,
+): EffectFixture<Provided> =>
+	({
+		...context,
+		[fixtureName]: fixture,
+	}) as EffectFixture<Provided>;
+
+const contextFrom = <Provided>(
+	context: TestContext,
+): Context.Context<Provided> =>
+	(context as EffectFixture<Provided>)[fixtureName];
+
+const runEffectTest = <A, E>(
+	effect: Effect.Effect<A, E, Scope.Scope>,
+	context: TestContext,
+	clock: EffectClock,
+): Promise<A> =>
+	Effect.runPromise(
+		Effect.gen(function* () {
+			const exit = yield* Effect.exit(effect);
+			if (Exit.isFailure(exit)) {
+				for (const error of Cause.prettyErrors(exit.cause)) {
+					yield* Effect.logError(error);
+				}
+			}
+			return yield* exit;
+		}).pipe(Effect.scoped, Effect.provide(environmentFor(clock))),
+		{ signal: context.signal },
+	);
+
+const splitOptions = (
+	options: number | EffectTestOptions | undefined,
+): {
+	readonly vitest: TestOptions;
+	readonly clock: EffectClock | undefined;
+} => {
+	if (typeof options === "number") {
+		return { clock: undefined, vitest: { timeout: options } };
+	}
+	if (options === undefined) {
+		return { clock: undefined, vitest: {} };
+	}
+	const { clock, ...vitest } = options;
+	return { clock, vitest };
+};
+
+const makeFixtureIt = <Provided, LayerError>(
+	layer: Layer.Layer<Provided, LayerError>,
+): FixtureTestApi<Provided> =>
+	effectIt.extend(
+		fixtureName,
+		{ scope: "worker" },
+		// biome-ignore lint/correctness/noEmptyPattern: Vitest fixtures require a destructured context parameter.
+		async ({}, { onCleanup }) => {
+			const scope = Effect.runSync(Scope.make());
+			onCleanup(() => Effect.runPromise(Scope.close(scope, Exit.void)));
+
+			try {
+				return await Effect.runPromise(Layer.buildWithScope(layer, scope));
+			} catch (error) {
+				await Effect.runPromise(Scope.close(scope, Exit.void));
+				throw error;
+			}
+		},
+	) as unknown as FixtureTestApi<Provided>;
+
+export const makeEffectIt = <
+	Harness,
+	// biome-ignore lint/suspicious/noExplicitAny: Layer output and error are recovered with Layer utility types
+	TestLayer extends Layer.Layer<any, any, never>,
+>(
+	options: MakeEffectItOptions<Harness, TestLayer>,
+): MakeEffectItResult<Harness, Layer.Success<TestLayer>> => {
+	type Provided = Layer.Success<TestLayer>;
+	const fixtureIt = makeFixtureIt(options.layer);
+	const defaultClock = options.clock ?? "test";
+
+	const run = <A, Eff extends Effect.Effect<unknown, unknown, Provided>>(
+		body: (harness: Harness, context: TestContext) => Generator<Eff, A, never>,
+		context: TestContext,
+	): Effect.Effect<A, unknown, Scope.Scope> => {
+		const program = Effect.gen(function* () {
+			const harness = yield* options.makeHarness(context);
+			return yield* Effect.gen(() => body(harness, context));
+		});
+		// The body constraint proves every yielded service is part of Provided.
+		// TypeScript cannot reduce that generic generator requirement here.
+		const ready = program as Effect.Effect<A, unknown, Provided>;
+		const wrapped = options.around?.(ready) ?? ready;
+		return wrapped.pipe(
+			Effect.provide(contextFrom<Provided>(context)),
+		) as Effect.Effect<A, unknown, Scope.Scope>;
+	};
+
+	const register =
+		(current: FixtureTestApi<Provided>): EffectTest<Harness, Provided> =>
+		(name, body, testOptions) => {
+			const split = splitOptions(testOptions);
+			const clock = split.clock ?? defaultClock;
+			current(
+				name,
+				split.vitest,
+				({
+					__effectTestContext,
+					task,
+					signal,
+					onTestFailed,
+					onTestFinished,
+					skip,
+					annotate,
+					expect,
+					_local,
+				}) => {
+					const context = restoreContext(__effectTestContext, {
+						annotate,
+						expect,
+						onTestFailed,
+						onTestFinished,
+						signal,
+						skip,
+						task,
+						_local,
+					});
+					return runEffectTest(run(body, context), context, clock);
+				},
+			);
+		};
+
+	const effectApp: EffectTester<Harness, Provided> = Object.assign(
+		register(fixtureIt),
+		{
+			skip: register(fixtureIt.skip),
+			skipIf: (condition: unknown) => register(fixtureIt.skipIf(condition)),
+			runIf: (condition: unknown) => register(fixtureIt.runIf(condition)),
+			only: register(fixtureIt.only),
+			each:
+				<Item>(cases: ReadonlyArray<Item>) =>
+				<A, Eff extends Effect.Effect<unknown, unknown, Provided>>(
+					name: string,
+					body: (
+						item: Item,
+						harness: Harness,
+						context: TestContext,
+					) => Generator<Eff, A, never>,
+					testOptions?: number | EffectTestOptions,
+				) => {
+					const split = splitOptions(testOptions);
+					const clock = split.clock ?? defaultClock;
+					fixtureIt.for(cases)(
+						name,
+						split.vitest,
+						(
+							item,
+							{
+								__effectTestContext,
+								task,
+								signal,
+								onTestFailed,
+								onTestFinished,
+								skip,
+								annotate,
+								expect,
+								_local,
+							},
+						) => {
+							const context = restoreContext(__effectTestContext, {
+								annotate,
+								expect,
+								onTestFailed,
+								onTestFinished,
+								signal,
+								skip,
+								task,
+								_local,
+							});
+							return runEffectTest(
+								run(
+									(harness, testContext) => body(item, harness, testContext),
+									context,
+								),
+								context,
+								clock,
+							);
+						},
+					);
+				},
+			fails: register(fixtureIt.fails),
+		},
+	);
+
+	return { effectApp };
+};