raf-effect-atom 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,19 +1,25 @@
 # Changelog
 
+## [0.2.3](https://github.com/KATT/raf-effect-atom/compare/raf-effect-atom%400.2.2...raf-effect-atom%400.2.3) (2026-10-23)
+
+### Features
+
+* **raf-effect-atom:** run Effect code on a loader's registry with Loader.Loader.run ([d26307d](https://github.com/KATT/raf-effect-atom/commit/d26307dc6279106ebd9d26078c88e4ad10a8cbc9))
+
 ## [0.2.2](https://github.com/KATT/raf-effect-atom/compare/raf-effect-atom%400.2.1...raf-effect-atom%400.2.2) (2026-10-23)
 
 ### Features
 
-* **raf-effect-atom:** stop a loader's wait when its request is aborted ([b1f2f16](https://github.com/KATT/raf-effect-atom/commit/b1f2f16fcce9cd5dd1ba18fa653b40c805eebd93)), references [#41](https://github.com/KATT/raf-effect-atom/issues/41) [#40](https://github.com/KATT/raf-effect-atom/issues/40) [#40](https://github.com/KATT/raf-effect-atom/issues/40) [#41](https://github.com/KATT/raf-effect-atom/issues/41)
+- **raf-effect-atom:** stop a loader's wait when its request is aborted ([b1f2f16](https://github.com/KATT/raf-effect-atom/commit/b1f2f16fcce9cd5dd1ba18fa653b40c805eebd93)), references [#41](https://github.com/KATT/raf-effect-atom/issues/41) [#40](https://github.com/KATT/raf-effect-atom/issues/40) [#40](https://github.com/KATT/raf-effect-atom/issues/40) [#41](https://github.com/KATT/raf-effect-atom/issues/41)
 
 ### Bug Fixes
 
-* **raf-effect-atom:** refuse to hydrate a shared registry during server rendering ([2f793a6](https://github.com/KATT/raf-effect-atom/commit/2f793a63627482bdf2f0e2891829f5191077cfc7))
+- **raf-effect-atom:** refuse to hydrate a shared registry during server rendering ([2f793a6](https://github.com/KATT/raf-effect-atom/commit/2f793a63627482bdf2f0e2891829f5191077cfc7))
 
 ### Documentation
 
-* **raf-effect-atom:** date clientAtomsMiddleware to 0.2.1, the release it shipped in ([c2a4288](https://github.com/KATT/raf-effect-atom/commit/c2a4288f4c5b63575e019712edc9fdc49a052bd2))
-* record that the packages' module state is keyed by what one request owns ([22b23f9](https://github.com/KATT/raf-effect-atom/commit/22b23f947544f8c4459ef172e8b21499403059c4))
+- **raf-effect-atom:** date clientAtomsMiddleware to 0.2.1, the release it shipped in ([c2a4288](https://github.com/KATT/raf-effect-atom/commit/c2a4288f4c5b63575e019712edc9fdc49a052bd2))
+- record that the packages' module state is keyed by what one request owns ([22b23f9](https://github.com/KATT/raf-effect-atom/commit/22b23f947544f8c4459ef172e8b21499403059c4))
 
 ## [0.2.1](https://github.com/KATT/raf-effect-atom/compare/raf-effect-atom%400.2.0...raf-effect-atom%400.2.1) (2026-10-23)
 

package/dist/Loader.d.mts

@@ -165,21 +165,30 @@ export interface Loader {
    * the seed resolves.
    */
   readonly prefetch: <S extends Source>(source: S, ...args: ArgsOf<S>) => Handle<S>;
+  /**
+   * Runs an Effect that needs the registry, such as the Effect verbs in an
+   * `Effect.gen`, as a Promise that rejects with its squashed cause.
+   * Aborting `signal`, or the one the verbs were made with, interrupts it,
+   * and the Promise rejects with the abort reason.
+   */
+  readonly run: <A, E>(effect: Effect.Effect<A, E, AtomRegistry.AtomRegistry>, options?: {
+    readonly signal?: AbortSignal | undefined;
+  }) => Promise<A>;
 }
 /**
  * Options for `make`.
  *
  * @stability unstable
  * @category models
- * @since 0.3.0
+ * @since 0.2.2
  */
 export interface MakeOptions {
   /** How long a lease lasts in the browser. See {@link LeaseTTL}. */
   readonly leaseTTL?: Duration.Input | undefined;
   /**
    * The request's or the navigation's abort signal. Aborting it interrupts
-   * the `ensure` and `fetch` calls still waiting, which reject with its
-   * reason. The atoms they started keep loading.
+   * the `ensure`, `fetch` and `run` calls still waiting, which reject with
+   * its reason. The atoms they started keep loading.
    */
   readonly signal?: AbortSignal | undefined;
 }
@@ -191,14 +200,14 @@ export interface MakeOptions {
  * Use in a framework integration, in loaders that are async functions, or
  * in an event handler that starts an atom before the state change that
  * renders its reader, for state that can't be in the URL, such as a
- * search-as-you-type query. In Effect code, use the verbs directly with the
- * `AtomRegistry` provided.
+ * search-as-you-type query. In Effect code, use the verbs directly, and run
+ * the Effect on the registry with `run`.
  *
  * **Details**
  *
- * With a `signal`, an aborted request or navigation stops waiting: `ensure`
- * and `fetch` reject with the signal's reason, and the atoms they started
- * keep loading. The React Router and Next.js integrations pass the
+ * With a `signal`, an aborted request or navigation stops waiting: `ensure`,
+ * `fetch` and `run` reject with the signal's reason, and the atoms they
+ * started keep loading. The React Router and Next.js integrations pass the
  * request's.
  *
  * **Example**

package/dist/Loader.mjs

@@ -253,6 +253,7 @@ const result = (handle) => {
 const runPromise = (effect, signal) => Effect.runPromise(effect, { signal }).catch((error) => {
 	throw signal?.aborted ? signal.reason : error;
 });
+const either = (first, second) => first === void 0 || second === void 0 ? first ?? second : AbortSignal.any([first, second]);
 /**
 * Creates the Promise verbs over one registry.
 *
@@ -261,14 +262,14 @@ const runPromise = (effect, signal) => Effect.runPromise(effect, { signal }).cat
 * Use in a framework integration, in loaders that are async functions, or
 * in an event handler that starts an atom before the state change that
 * renders its reader, for state that can't be in the URL, such as a
-* search-as-you-type query. In Effect code, use the verbs directly with the
-* `AtomRegistry` provided.
+* search-as-you-type query. In Effect code, use the verbs directly, and run
+* the Effect on the registry with `run`.
 *
 * **Details**
 *
-* With a `signal`, an aborted request or navigation stops waiting: `ensure`
-* and `fetch` reject with the signal's reason, and the atoms they started
-* keep loading. The React Router and Next.js integrations pass the
+* With a `signal`, an aborted request or navigation stops waiting: `ensure`,
+* `fetch` and `run` reject with the signal's reason, and the atoms they
+* started keep loading. The React Router and Next.js integrations pass the
 * request's.
 *
 * **Example**
@@ -301,7 +302,8 @@ const make = (registry, options) => {
 				Effect.runSync(provide(start(atom)));
 			});
 			return make$1(args, atom);
-		}
+		},
+		run: (effect, runOptions) => runPromise(provide(effect), either(signal, runOptions?.signal))
 	};
 };
 export { LeaseTTL, Loader_exports, ensure, fetch, make, prefetch, result };

package/dist/Next.d.mts

@@ -108,6 +108,26 @@ export declare const ensure: <S extends Source>(source: S, ...args: ArgsOf<S>) =
  * @since 0.1.0
  */
 export declare const fetch: <S extends Source>(source: S, ...args: ArgsOf<S>) => Promise<LoadedHandle<S>>;
+/**
+ * `Loader.Loader`'s `run` on the request's registry: runs an Effect that
+ * needs the registry, such as the Effect verbs in an `Effect.gen`.
+ *
+ * **Example**
+ *
+ * ```ts
+ * const handles = await run(
+ *   Effect.gen(function* () {
+ *     const issueHandle = yield* Loader.ensure(issue, id)
+ *     return { comments: yield* Loader.prefetch(commentPage, id, 0), issue: issueHandle }
+ *   })
+ * )
+ * ```
+ *
+ * @stability unstable
+ * @category verbs
+ * @since 0.2.3
+ */
+export declare const run: Loader["run"];
 /**
  * `Hydration.dehydrate` on the request's registry, for `HydrateAtoms`.
  *

package/dist/Next.mjs

@@ -90,6 +90,26 @@ const ensure = atoms.ensure;
 */
 const fetch = atoms.fetch;
 /**
+* `Loader.Loader`'s `run` on the request's registry: runs an Effect that
+* needs the registry, such as the Effect verbs in an `Effect.gen`.
+*
+* **Example**
+*
+* ```ts
+* const handles = await run(
+*   Effect.gen(function* () {
+*     const issueHandle = yield* Loader.ensure(issue, id)
+*     return { comments: yield* Loader.prefetch(commentPage, id, 0), issue: issueHandle }
+*   })
+* )
+* ```
+*
+* @stability unstable
+* @category verbs
+* @since 0.2.3
+*/
+const run = atoms.run;
+/**
 * `Hydration.dehydrate` on the request's registry, for `HydrateAtoms`.
 *
 * **Gotchas**
@@ -110,4 +130,4 @@ const fetch = atoms.fetch;
 * @since 0.1.0
 */
 const dehydrate = atoms.dehydrate;
-export { HydrateAtoms, RegistryProvider, dehydrate, ensure, fetch, getRegistry, makeRequestAtoms, prefetch };
+export { HydrateAtoms, RegistryProvider, dehydrate, ensure, fetch, getRegistry, makeRequestAtoms, prefetch, run };

package/dist/internal/next.mjs

@@ -22,7 +22,8 @@ const make = (options) => {
 		ensure: (source, ...args) => getLoader().ensure(source, ...args),
 		fetch: (source, ...args) => getLoader().fetch(source, ...args),
 		getRegistry,
-		prefetch: (source, ...args) => getLoader().prefetch(source, ...args)
+		prefetch: (source, ...args) => getLoader().prefetch(source, ...args),
+		run: (effect, runOptions) => getLoader().run(effect, runOptions)
 	};
 };
 export { make };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raf-effect-atom",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Render-as-you-fetch for Effect Atom: start atoms from route loaders and stream them into the browser, typed failures intact",
   "keywords": [
     "effect",