@shivaedev/effect-test 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.0 - 2026-10-16
+
+### Added
+
+- `withLive(effect)` from `@shivaedev/effect-test/withLive.ts` runs sleeps and readiness polls in live time under either TestClock or the live clock, without advancing the surrounding TestClock.
+
 ## 0.4.0 - 2026-10-13
 
 ### Breaking

package/README.md

@@ -160,7 +160,7 @@ Worker acquisition is separate: a Layer that reads the default Clock while it is
 
 ### Waiting for a typed readiness condition
 
-`eventually(effect, options)` retries the Effect's typed failures until it succeeds or uses its retry budget. Under TestClock it advances time with `TestClock.adjust`; under live time it retries with `Schedule.spaced`.
+`eventually(effect, options)` retries the Effect's typed failures until it succeeds or uses its retry budget. It uses the active Clock: under TestClock it advances time with `TestClock.adjust`; under live time it retries with `Schedule.spaced`.
 
 ```ts
 import { eventually } from "@shivaedev/effect-test/eventually.ts";
@@ -200,6 +200,19 @@ effectApp("retries a readiness assertion", function* () {
 
 This distinction applies under both clocks. The helper preserves the Effect's success, error and service types.
 
+### Waiting in live time without advancing TestClock
+
+Use `withLive(effect)` from `@shivaedev/effect-test/withLive.ts` for a real-time sleep or readiness poll in a harness, hook or story step. Under TestClock it delegates to native `TestClock.withLive`; under a live clock it runs the Effect directly. The surrounding clock is restored afterward, so waiting for external work does not move virtual token expiry.
+
+```ts
+import { withLive } from "@shivaedev/effect-test/withLive.ts";
+
+yield* withLive(Effect.sleep("10 millis"));
+yield* withLive(eventually(queueIsEmpty, { interval: "10 millis", times: 100 }));
+```
+
+The entire wrapped Effect, including readiness checks and retry delays, uses live time. The same call works when a kit defaults to a live clock and one story opts into TestClock. Success, typed failure and service requirements are preserved.
+
 ### API
 
 Import the module that defines the name; the package has no root entry.
@@ -209,6 +222,7 @@ Import the module that defines the name; the package has no root entry.
 | `@shivaedev/effect-test/it.ts` | `it`, with generator-aware `effect` and `live` testers. |
 | `@shivaedev/effect-test/vitest.ts` | `makeEffectIt({ layer, makeHarness, around?, clock? })`, returning `{ effectApp }`. |
 | `@shivaedev/effect-test/eventually.ts` | `eventually(effect, options?)` and `EventuallyOptions`. |
+| `@shivaedev/effect-test/withLive.ts` | `withLive(effect)`, a live-time region under either clock. |
 | `@shivaedev/effect-test/any-test-layer.ts` | `AnyTestLayer` and `buildTestLayer(layer, scope)`, an Effect that builds the Layer's service Context in the supplied scope. |
 | `@shivaedev/effect-test/types.ts` | `EffectClock`, `EffectTestOptions`, `EffectTestBody`, `EffectTest`, `EffectTester`, `MakeEffectItOptions`, `MakeEffectItResult`, `EffectItTest`, `EffectItTester` and `EffectIt`. |
 

package/dist/withLive.d.ts

@@ -0,0 +1,3 @@
+import { type Effect } from "effect";
+export declare function withLive<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+//# sourceMappingURL=withLive.d.ts.map

package/dist/withLive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withLive.d.ts","sourceRoot":"","sources":["../src/withLive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG5C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAExF"}

package/dist/withLive.js

@@ -0,0 +1,6 @@
+import { Clock } from "effect";
+import * as TestClock from "effect/testing/TestClock";
+export function withLive(effect) {
+    return Clock.clockWith((clock) => ("withLive" in clock ? TestClock.withLive(effect) : effect));
+}
+//# sourceMappingURL=withLive.js.map

package/dist/withLive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withLive.js","sourceRoot":"","sources":["../src/withLive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AAEtD,MAAM,UAAU,QAAQ,CAAU,MAA8B;IAC/D,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/effect-test",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Generic Effect Vitest runner with worker-scoped Layers and TestClock",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/effect-test#readme",
   "bugs": {
@@ -43,7 +43,7 @@
   ],
   "devDependencies": {
     "@effect/vitest": "4.0.4",
-    "@shivaedev/quality": "0.20.0",
+    "@shivaedev/quality": "0.21.1",
     "@types/node": "24.19.1",
     "@typescript/native": "npm:typescript@7.0.2",
     "effect": "4.0.4",

package/src/withLive.ts

@@ -0,0 +1,6 @@
+import { Clock, type Effect } from "effect";
+import * as TestClock from "effect/testing/TestClock";
+
+export function withLive<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> {
+	return Clock.clockWith((clock) => ("withLive" in clock ? TestClock.withLive(effect) : effect));
+}