@playfast/reform-resource 1.0.2 → 1.2.0

package/README.md

@@ -32,10 +32,7 @@ class Config extends Resource.make('Config', {
 }) {}
 
 // Wire — `acquire` may be scoped (acquire/release tied to the scene scope).
-const ConfigLive = Resource.live(
-  Config,
-  Effect.acquireRelease(openConfig, closeConfig),
-)
+const ConfigLive = Resource.live(Config, Effect.acquireRelease(openConfig, closeConfig))
 
 // Read inside a composition.
 const view = Effect.gen(function* () {

package/dist/asyncResource.d.ts

@@ -0,0 +1,27 @@
+import { type Store } from '@playfast/reform/internal';
+export interface AsyncResourcePending {
+    readonly _tag: 'AsyncResource';
+    readonly isReady: false;
+    readonly failed: false;
+}
+export interface AsyncResourceReady<A> {
+    readonly _tag: 'AsyncResource';
+    readonly isReady: true;
+    readonly value: A;
+}
+export interface AsyncResourceFailed<E> {
+    readonly _tag: 'AsyncResource';
+    readonly isReady: false;
+    readonly failed: true;
+    readonly error: E;
+}
+export type AsyncResource<A, E = never> = AsyncResourcePending | AsyncResourceReady<A> | ([E] extends [never] ? never : AsyncResourceFailed<E>);
+export type AnyAsyncResource<A, E> = AsyncResourcePending | AsyncResourceReady<A> | AsyncResourceFailed<E>;
+export interface AsyncResourceConstructors {
+    readonly pending: AsyncResourcePending;
+    readonly ready: <A>(value: A) => AsyncResourceReady<A>;
+    readonly failed: <E>(error: E) => AsyncResourceFailed<E>;
+}
+export declare const AsyncResource: AsyncResourceConstructors;
+export declare const narrowStore: <A, E>(store: Store<AnyAsyncResource<A, E>>) => Store<AsyncResource<A, E>>;
+//# sourceMappingURL=asyncResource.d.ts.map

package/dist/asyncResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncResource.d.ts","sourceRoot":"","sources":["../src/asyncResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAA;AAEtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAClC,oBAAoB,GACpB,kBAAkB,CAAC,CAAC,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAA;AAE1D,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAC7B,oBAAoB,GACpB,kBAAkB,CAAC,CAAC,CAAC,GACrB,mBAAmB,CAAC,CAAC,CAAC,CAAA;AAe1B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAAA;IACtD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAAA;CACzD;AAED,eAAO,MAAM,aAAa,EAAE,yBAAsD,CAAA;AAElF,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,EAC9B,OAAO,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KACnC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAEoB,CAAA"}

package/dist/asyncResource.js

@@ -0,0 +1,18 @@
+import {} from '@playfast/reform/internal';
+const pending = { _tag: 'AsyncResource', isReady: false, failed: false };
+const ready = (acquired) => ({
+    _tag: 'AsyncResource',
+    isReady: true,
+    value: acquired,
+});
+const failed = (error) => ({
+    _tag: 'AsyncResource',
+    isReady: false,
+    failed: true,
+    error,
+});
+export const AsyncResource = { pending, ready, failed };
+export const narrowStore = (store) => 
+// oxlint-disable-next-line reform-rules/no-type-assertion -- sanctioned variance seam: the live store holds the full union; this is the one documented home for narrowing it to the definition-permitted arms (mirrors asyncData.narrowStore).
+store;
+//# sourceMappingURL=asyncResource.js.map

package/dist/asyncResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncResource.js","sourceRoot":"","sources":["../src/asyncResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,2BAA2B,CAAA;AA+BtD,MAAM,OAAO,GAAyB,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC9F,MAAM,KAAK,GAAG,CAAI,QAAW,EAAyB,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,QAAQ;CAChB,CAAC,CAAA;AACF,MAAM,MAAM,GAAG,CAAI,KAAQ,EAA0B,EAAE,CAAC,CAAC;IACvD,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,IAAI;IACZ,KAAK;CACN,CAAC,CAAA;AAQF,MAAM,CAAC,MAAM,aAAa,GAA8B,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAElF,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAAoC,EACR,EAAE;AAC9B,+OAA+O;AAC/O,KAA8C,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * as Resource from './resource.js';
+export type { ResourceClass, ResourceConfig, ResourceManifest } from './resource.js';
+export { type AnyAsyncResource, AsyncResource, type AsyncResourceConstructors, type AsyncResourceFailed, type AsyncResourcePending, type AsyncResourceReady, } from './asyncResource.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,KAAK,QAAQ,MAAM,YAAY,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EACL,KAAK,gBAAgB,EACrB,aAAa,EACb,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * as Resource from './resource.js';
+export { AsyncResource, } from './asyncResource.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,KAAK,QAAQ,MAAM,YAAY,CAAA;AAEtC,OAAO,EAEL,aAAa,GAKd,MAAM,iBAAiB,CAAA"}

package/dist/resource.d.ts

@@ -0,0 +1,24 @@
+import { type Manifest, type Store } from '@playfast/reform/internal';
+import { Context, Effect, Layer, Option, type Schema, Scope } from 'effect';
+import { AsyncResource } from './asyncResource.js';
+type AnySchema<A> = Schema.Schema<A, Schema.Schema.Encoded<Schema.Schema.AnyNoContext>>;
+export interface ResourceManifest<N extends string, A, E> extends Manifest {
+    readonly kind: 'Resource';
+    readonly name: N;
+    readonly output: AnySchema<A>;
+    readonly error: Option.Option<AnySchema<E>>;
+}
+export interface ResourceClass<out N extends string, in out A, in out E> extends Effect.Effect<AsyncResource<A, E>, never, Store<AsyncResource<A, E>>> {
+    new (): {};
+    readonly manifest: ResourceManifest<N, A, E>;
+    readonly store: Context.Tag<Store<AsyncResource<A, E>>, Store<AsyncResource<A, E>>>;
+    readonly name: N;
+}
+export interface ResourceConfig<A, E> {
+    readonly output: AnySchema<A>;
+    readonly error: Option.Option<AnySchema<E>>;
+}
+export declare const make: <const N extends string, A, E = never>(name: N, config: ResourceConfig<A, E>) => ResourceClass<N, A, E>;
+export declare const live: <N extends string, A, E, R>(resource: ResourceClass<N, A, E>, acquire: Effect.Effect<A, E, R | Scope.Scope>) => Layer.Layer<Store<AsyncResource<A, E>>, never, Exclude<R, Scope.Scope>>;
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAIb,KAAK,KAAK,EAEX,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAS,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAClF,OAAO,EAAyB,aAAa,EAAe,MAAM,iBAAiB,CAAA;AAEnF,KAAK,SAAS,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;AAEvF,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAE,SAAQ,QAAQ;IACxE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,aAAa,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,MAAM,CAC5F,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EACnB,KAAK,EACL,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC3B;IACC,QAAQ,EAAE,CAAA;IACV,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACnF,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CACjB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;CAC5C;AAED,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,EACvD,MAAM,CAAC,EACP,QAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KAC3B,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAUvB,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAC5C,UAAU,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAChC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAC5C,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CA4BtE,CAAA"}

package/dist/resource.js

@@ -0,0 +1,34 @@
+import { makeStore, readTracked, resolveScheduler, yieldableClass, } from '@playfast/reform/internal';
+import { Cause, Context, Effect, Layer, Option, Scope } from 'effect';
+import { AsyncResource, narrowStore } from './asyncResource.js';
+export const make = (name, config) => {
+    const store = Context.GenericTag(`reform/resource/${name}`);
+    const manifest = {
+        kind: 'Resource',
+        name,
+        output: config.output,
+        error: config.error,
+    };
+    const read = Effect.flatMap(store, readTracked);
+    return yieldableClass(read, { manifest, store, name });
+};
+export const live = (resource, acquire) => Layer.scoped(resource.store, Effect.gen(function* () {
+    const scheduler = yield* resolveScheduler;
+    const scope = yield* Effect.scope;
+    // Sync build seeds pending so layer mount never trips AsyncSceneLayer; store holds full union, tag sees narrowed arms.
+    const store = makeStore(AsyncResource.pending, scheduler);
+    yield* Effect.forkScoped(acquire.pipe(
+    // Finalizers attach to scene scope, not the load fiber — resource lives until unmount.
+    Scope.extend(scope), Effect.matchCauseEffect({
+        onSuccess: (acquired) => Effect.sync(() => store.set(AsyncResource.ready(acquired))),
+        onFailure: (cause) => Option.match(Cause.failureOption(cause), {
+            onSome: (error) => Effect.sync(() => store.set(AsyncResource.failed(error))),
+            onNone: () => Cause.isInterruptedOnly(cause)
+                ? Effect.void
+                : // oxlint-disable-next-line reform-rules/no-effect-log -- reform-resource has no @play/effect-utils dep (same as reform core); the package logs via Effect directly.
+                    Effect.logError(`reform-resource: load for '${resource.name}' failed`, cause),
+        }),
+    })));
+    return narrowStore(store);
+}));
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,WAAW,EACX,gBAAgB,EAEhB,cAAc,GACf,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAe,KAAK,EAAE,MAAM,QAAQ,CAAA;AAClF,OAAO,EAAyB,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AA2BnF,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,IAAO,EACP,MAA4B,EACJ,EAAE;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAA6B,mBAAmB,IAAI,EAAE,CAAC,CAAA;IACvF,MAAM,QAAQ,GAA8B;QAC1C,IAAI,EAAE,UAAU;QAChB,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAA;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IAC/C,OAAO,cAAc,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACxD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,QAAgC,EAChC,OAA6C,EAC4B,EAAE,CAC3E,KAAK,CAAC,MAAM,CACV,QAAQ,CAAC,KAAK,EACd,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAA;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;IACjC,uHAAuH;IACvH,MAAM,KAAK,GAAG,SAAS,CAAyB,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACjF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CACtB,OAAO,CAAC,IAAI;IACV,uFAAuF;IACvF,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EACnB,MAAM,CAAC,gBAAgB,CAAC;QACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACnB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;YACvC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5E,MAAM,EAAE,GAAG,EAAE,CACX,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC;gBAC5B,CAAC,CAAC,MAAM,CAAC,IAAI;gBACb,CAAC,CAAC,oKAAoK;oBACpK,MAAM,CAAC,QAAQ,CAAC,8BAA8B,QAAQ,CAAC,IAAI,UAAU,EAAE,KAAK,CAAC;SACpF,CAAC;KACL,CAAC,CACH,CACF,CAAA;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC,CAAC,CACH,CAAA"}

package/package.json

@@ -1,51 +1,63 @@
 {
   "name": "@playfast/reform-resource",
-  "playbook": "./playbook",
-  "version": "1.0.2",
-  "type": "module",
+  "version": "1.2.0",
   "description": "Async resources for Reform — a layer that builds synchronously, loads in the background, and flips a reactive store from pending to ready/failed. The sanctioned home for async work that would otherwise break reform's synchronous scene build.",
   "keywords": [
-    "reform",
-    "effect",
     "async",
-    "resource",
+    "effect",
+    "layer",
     "reactive",
-    "layer"
+    "reform",
+    "resource"
   ],
+  "bugs": {
+    "url": "https://github.com/playfast/reform/issues"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/playfast/reform.git",
     "directory": "packages/reform-resource"
   },
-  "bugs": {
-    "url": "https://github.com/playfast/reform/issues"
-  },
-  "sideEffects": false,
-  "exports": {
-    "./package.json": "./package.json",
-    ".": "./src/index.ts",
-    "./*": "./src/*.ts"
-  },
   "files": [
+    "dist",
     "src",
     "README.md"
   ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "playfast-src": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "playfast-src": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "clean": "rm -rf dist .tsbuildinfo",
     "check": "tsc --noEmit",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "rm -rf dist .tsbuildinfo && tsc -p tsconfig.build.json && bun ../../scripts/fix-esm-extensions.ts dist",
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
     "lint": "oxlint src",
-    "lint:fix": "oxlint --fix src"
+    "lint:fix": "oxlint --fix src",
+    "prepack": "bun run build"
   },
   "peerDependencies": {
-    "effect": "*",
-    "@playfast/reform": "*"
+    "@playfast/reform": "*",
+    "effect": "*"
   },
-  "publishConfig": {
-    "access": "public"
-  }
+  "playbook": "./playbook"
 }

package/src/asyncResource.ts

@@ -1,4 +1,4 @@
-import { type Store } from '@playfast/reform'
+import { type Store } from '@playfast/reform/internal'
 
 export interface AsyncResourcePending {
   readonly _tag: 'AsyncResource'
@@ -24,10 +24,17 @@ export type AsyncResource<A, E = never> =
   | AsyncResourceReady<A>
   | ([E] extends [never] ? never : AsyncResourceFailed<E>)
 
-export type AnyAsyncResource<A, E> = AsyncResourcePending | AsyncResourceReady<A> | AsyncResourceFailed<E>
+export type AnyAsyncResource<A, E> =
+  | AsyncResourcePending
+  | AsyncResourceReady<A>
+  | AsyncResourceFailed<E>
 
 const pending: AsyncResourcePending = { _tag: 'AsyncResource', isReady: false, failed: false }
-const ready = <A>(acquired: A): AsyncResourceReady<A> => ({ _tag: 'AsyncResource', isReady: true, value: acquired })
+const ready = <A>(acquired: A): AsyncResourceReady<A> => ({
+  _tag: 'AsyncResource',
+  isReady: true,
+  value: acquired,
+})
 const failed = <E>(error: E): AsyncResourceFailed<E> => ({
   _tag: 'AsyncResource',
   isReady: false,
@@ -43,6 +50,8 @@ export interface AsyncResourceConstructors {
 
 export const AsyncResource: AsyncResourceConstructors = { pending, ready, failed }
 
-export const narrowStore = <A, E>(store: Store<AnyAsyncResource<A, E>>): Store<AsyncResource<A, E>> =>
+export const narrowStore = <A, E>(
+  store: Store<AnyAsyncResource<A, E>>,
+): Store<AsyncResource<A, E>> =>
   // oxlint-disable-next-line reform-rules/no-type-assertion -- sanctioned variance seam: the live store holds the full union; this is the one documented home for narrowing it to the definition-permitted arms (mirrors asyncData.narrowStore).
   store as unknown as Store<AsyncResource<A, E>>

package/src/reform-resource.test.ts

@@ -1,33 +1,47 @@
 import { expect, it } from '@effect/vitest'
-import { Context, Data, Duration, Effect, Layer, Option, Ref, Schema as S } from 'effect'
+import { makeFlightGate, until } from '@playfast/reform/testkit/flight.testkit'
+import { Context, Data, Effect, Layer, Option, Ref, Schema as S } from 'effect'
 import { Resource } from './index'
 
-const tick = (ms = 30) => Effect.sleep(Duration.millis(ms))
-
 class Boom extends Data.TaggedError('Boom')<{ readonly message: string }> {}
 
 it.live('builds pending then resolves to ready', () => {
   class Num extends Resource.make('Num', { output: S.Number, error: Option.none() }) {}
-  const layer = Resource.live(Num, Effect.delay(Effect.succeed(7), Duration.millis(20)))
+  const gate = makeFlightGate()
+  const layer = Resource.live(Num, gate.through(Effect.succeed(7)))
 
-  return Effect.gen(function* () {
-    const store = yield* Num.store
-    expect(store.get().isReady).toBe(false)
-    yield* tick(60)
-    const value = store.get()
-    expect(value.isReady).toBe(true)
-    if (value.isReady) expect(value.value).toBe(7)
-  }).pipe(Effect.provide(layer))
+  return Effect.scoped(
+    Effect.gen(function* () {
+      yield* gate.hold
+      const context = yield* Layer.build(layer)
+      const store = Context.get(context, Num.store)
+      yield* gate.awaitEntry(1)
+      expect(store.get().isReady).toBe(false)
+
+      yield* gate.release
+      const value = yield* until(
+        () => store.get(),
+        (resource) => resource.isReady,
+      )
+      expect(value.isReady).toBe(true)
+      if (value.isReady) expect(value.value).toBe(7)
+    }),
+  )
 })
 
 it.live('a failing load resolves to the failed arm carrying the error', () => {
-  class Conn extends Resource.make('Conn', { output: S.Number, error: Option.some(S.instanceOf(Boom)) }) {}
+  class Conn extends Resource.make('Conn', {
+    output: S.Number,
+    error: Option.some(S.instanceOf(Boom)),
+  }) {}
   const layer = Resource.live(Conn, Effect.fail(new Boom({ message: 'nope' })))
 
   return Effect.gen(function* () {
     const store = yield* Conn.store
-    yield* tick()
-    const value = store.get()
+    const value = yield* until(
+      () => store.get(),
+      (resource) => !resource.isReady && resource.failed,
+    )
     expect(value.isReady).toBe(false)
     if (!value.isReady && value.failed) expect(value.error.message).toBe('nope')
   }).pipe(Effect.provide(layer))
@@ -43,7 +57,10 @@ it.live('notifies subscribers when it flips to ready', () => {
     const unsubscribe = store.subscribe(() => {
       seen.count += 1
     })
-    yield* tick()
+    yield* until(
+      () => seen.count,
+      (count) => count > 0,
+    )
     unsubscribe()
     expect(store.get().isReady).toBe(true)
     expect(seen.count).toBeGreaterThan(0)
@@ -63,10 +80,14 @@ it.live('ties acquire/release to the scene scope', () =>
       Effect.gen(function* () {
         const context = yield* Layer.build(layer)
         const store = Context.get(context, Conn.store)
-        yield* tick()
+        yield* until(
+          () => store.get(),
+          (resource) => resource.isReady,
+        )
         expect(store.get().isReady).toBe(true)
         expect(yield* Ref.get(released)).toBe(false)
       }),
     )
     expect(yield* Ref.get(released)).toBe(true)
-  }))
+  }),
+)

package/src/resource.ts

@@ -5,13 +5,9 @@ import {
   resolveScheduler,
   type Store,
   yieldableClass,
-} from '@playfast/reform'
+} from '@playfast/reform/internal'
 import { Cause, Context, Effect, Layer, Option, type Schema, Scope } from 'effect'
-import {
-  type AnyAsyncResource,
-  AsyncResource,
-  narrowStore,
-} from './asyncResource'
+import { type AnyAsyncResource, AsyncResource, narrowStore } from './asyncResource'
 
 type AnySchema<A> = Schema.Schema<A, Schema.Schema.Encoded<Schema.Schema.AnyNoContext>>
 
@@ -22,8 +18,11 @@ export interface ResourceManifest<N extends string, A, E> extends Manifest {
   readonly error: Option.Option<AnySchema<E>>
 }
 
-export interface ResourceClass<out N extends string, in out A, in out E>
-  extends Effect.Effect<AsyncResource<A, E>, never, Store<AsyncResource<A, E>>> {
+export interface ResourceClass<out N extends string, in out A, in out E> extends Effect.Effect<
+  AsyncResource<A, E>,
+  never,
+  Store<AsyncResource<A, E>>
+> {
   new (): {}
   readonly manifest: ResourceManifest<N, A, E>
   readonly store: Context.Tag<Store<AsyncResource<A, E>>, Store<AsyncResource<A, E>>>