nanoeffects 0.4.0 → 0.6.0

package/README.md

@@ -15,6 +15,8 @@ npm install nanoeffects
 
 ESM only, no dependencies, types included.
 
+Want to try it first? [Open the playground](https://stackblitz.com/github/nanoeffects/nanoeffects/tree/main/examples/playground): a search box with `debounce` and `latest`, running in your browser, no install. More playgrounds (React) and recipes: [Examples](examples/README.md).
+
 ## Create a bus
 
 Subscribe with `on`, send with `emit`. `on` returns a function that unsubscribes.
@@ -48,6 +50,7 @@ const bus = createBus();
 bus.on(
   "search",
   latest(async (query, ctx) => {
+    // signal — lets latest cancel this request, not only drop its result
     const items = await api.search(query, { signal: ctx.signal });
     ctx.emit("results", items);
   }),
@@ -85,7 +88,7 @@ Start with the [Guide](docs/guide.md) (bus → policies → effects → modules)
 | Domain logic off the UI | [Actions, commands, modules](docs/actions.md) |
 | Redux / Zustand / MobX | [Stores](docs/stores.md) |
 
-[Full index, package entries, tracing](docs/README.md) · [Examples](examples)
+[Full index, package entries, tracing](docs/README.md) · [Examples](examples/README.md)
 
 - **Tiny.** `createBus` is about 1.3 kB gzip; other entries load only when imported.
 - **Cancellation first.** Aborting a task aborts its children and drops its result.

package/dist/{action-creator-D48fp13T.d.ts → action-creator-c292nK7v.d.ts}

@@ -1,3 +1,29 @@
+//#region src/core/types.d.ts
+type PayloadOf<P> = undefined extends P ? [payload?: P] : [payload: P];
+type EventMap = Record<string, unknown>;
+type Keys<E> = keyof E & string;
+type Task<P, E extends EventMap, R = unknown> = (payload: P, ctx: Context<E>) => R;
+type EffectName = "every" | "latest" | "leading" | "debounce" | "throttle" | "run" | "all" | "race" | "retry" | "timeout" | "poll" | "take" | "queue" | "allSettled" | "command";
+type Phase = "start" | "done" | "error" | "cancel" | "drop";
+type TraceEvent<E = Record<string, unknown>> = { [K in Keys<E>]: {
+  id: number;
+  parent?: number;
+  type: K;
+  effect: EffectName;
+  phase: Phase;
+  payload: E[K];
+  error?: unknown;
+}; }[Keys<E>];
+/**
+ * The contract of every trace logger: receives each task phase of a bus.
+ * Adapters in `nanoeffects/trace` are factories that return one; pass it
+ * through `createTracer` to `createBus({ trace })`.
+ */
+type TraceLogger<E = Record<string, unknown>> = (event: TraceEvent<E>) => void;
+/** One logger or several; a throwing logger never breaks the task or the others. */
+type Trace<E = Record<string, unknown>> = TraceLogger<E> | readonly TraceLogger<E>[];
+type UnsubscribeCallback = () => void;
+//#endregion
 //#region src/core/store.d.ts
 declare const anyEventType = "*";
 //#endregion
@@ -83,14 +109,21 @@ type Emit<E extends EventMap> = {
   <K extends EventKey<E>>(event: K, ...payload: PayloadOf<E[K]>): void;
   /** Before Handler: a command is callable too, and must return its result type. */
   <P, R>(command: Command<P, R>, ...payload: PayloadOf<P>): R;
-  <P, R>(call: CommandCall<P, R>): R;
+  /** A scope as the second argument replaces context fields for the tasks of this emit; see `scopePlugin`. */
+  <P, R, F>(call: CommandCall<P, R> & WithScope<F>, scope?: EmitScope<E, F>): R;
+  <P, R>(call: CommandCall<P, R>, scope?: EmitScope<E>): R;
   <K extends EventKey<E>, R>(event: Handler<E, R, K>, ...payload: PayloadOf<E[K]>): R;
-  (event: EventLike<E>): void;
+  <F>(event: EventLike<E> & WithScope<F>, scope?: EmitScope<E, F>): void;
+  (event: EventLike<E>, scope?: EmitScope<E>): void;
 };
 type On<E extends EventMap> = {
   (event: AnyEvent, fn: Task<EventPayload<E>, E>): UnsubscribeCallback;
   <K extends EventKey<E>>(event: K, fn: Task<E[K], E>): UnsubscribeCallback;
   /** An action creator without a payload type: the payload comes from the event map. */
+  /** The creators and commands that carry a scope come first: the handler sees their fields. */
+  <K extends EventKey<E>, F>(creator: FreeActionCreator<K, F> & WithScope<F>, fn: Task<E[K], WithFields<E, F>>): UnsubscribeCallback;
+  <P, F>(creator: ActionCreator<P, string, PayloadOf<P>, F> & WithScope<F>, fn: Task<P, WithFields<E, F>>): UnsubscribeCallback;
+  <P, F>(command: Command<P, unknown> & WithScope<F>, fn: Task<P, WithFields<E, F>>): UnsubscribeCallback;
   <K extends EventKey<E>>(creator: FreeActionCreator<K>, fn: Task<E[K], E>): UnsubscribeCallback;
   /** An action creator: the payload comes from it, so an event map is not needed. */
   <P>(creator: ActionCreator<P>, fn: Task<P, E>): UnsubscribeCallback;
@@ -157,6 +190,18 @@ type Context<E extends EventMap> = EventLike<E> & ContextOf<E> & {
   /** Child task: aborted with the parent; errors propagate to the parent. */
   run<P, R>(fn: Task<P, E, R>, ...args: PayloadOf<P>): Promise<Awaited<R>>;
 };
+/**
+ * The event map of a bus, with the context fields that plugins added. Use it to
+ * name the types of a bus in other files: `type AppEvents = EventsOf<typeof bus>`.
+ *
+ * @example
+ * ```ts
+ * const bus = createBus<Events>().use(effectsPlugin({ race }));
+ * type AppEvents = EventsOf<typeof bus>;
+ * type AppContext = Context<AppEvents>; // has `race`
+ * ```
+ */
+type EventsOf<B> = B extends Bus<infer E extends EventMap> ? E : never;
 interface Bus<E extends EventMap> {
   on: On<E>;
   /**
@@ -173,10 +218,16 @@ interface Bus<E extends EventMap> {
    */
   use<R>(plugin: (bus: Bus<E>) => R): R;
   /** `BusOptions.context` and `.trace`, and `commands`, for what makes tasks of its own, like `modulePlugin`. */
-  readonly context?: ContextOption<E> | undefined;
+  readonly ctx?: ContextOption<E> | undefined;
   /** What runs the commands; `commandsPlugin` and `modulePlugin` set it. Without one a command runs its own handler. */
   commands?: Commands | undefined;
   readonly trace?: Tracer | undefined;
+  /** Called with every new task context to add fields to it, for what needs the task, like `effectsPlugin`. Chain to the previous one. */
+  addContext?: ((ctx: object) => void) | undefined;
+  /** Puts the fields of a module's scope on the context of one of its tasks; `scopePlugin` sets it. Without it a module's scope is ignored. */
+  applyScope?: ((ctx: object, scope: Scope) => void) | undefined;
+  /** Wraps a handler so it runs with the fields of a module's scope; `scopePlugin` sets it. */
+  fitScope?: ((scope: Scope, fn: (payload: never, ctx: never) => unknown) => unknown) | undefined;
 }
 type BusOptions<E extends EventMap> = {
   /** Tracing of every task phase; make it with `createTracer` from `nanoeffects/trace`. */
@@ -214,31 +265,76 @@ type BusOptions<E extends EventMap> = {
 };
 declare const createBus: <Events extends EventMap>(options?: BusOptions<Events>) => Bus<Events>;
 //#endregion
-//#region src/core/types.d.ts
-type PayloadOf<P> = undefined extends P ? [payload?: P] : [payload: P];
-type EventMap = Record<string, unknown>;
-type Keys<E> = keyof E & string;
-type Task<P, E extends EventMap, R = unknown> = (payload: P, ctx: Context<E>) => R;
-type EffectName = "every" | "latest" | "leading" | "debounce" | "throttle" | "run" | "all" | "race" | "retry" | "timeout" | "poll" | "take" | "queue" | "allSettled" | "command";
-type Phase = "start" | "done" | "error" | "cancel" | "drop";
-type TraceEvent<E = Record<string, unknown>> = { [K in Keys<E>]: {
-  id: number;
-  parent?: number;
-  type: K;
-  effect: EffectName;
-  phase: Phase;
-  payload: E[K];
-  error?: unknown;
-}; }[Keys<E>];
+//#region src/core/effect-types.d.ts
+/** What an effect needs of the task it runs for: its signal. A task context fits, and so does `{ signal }`. */
+type Signaled = {
+  signal: AbortSignal;
+};
+/** An effect: a function whose first parameter takes `{ signal }`, like `retry(ctx, fn)`. */
+type SignalFirst = (ctx: Signaled, ...args: never[]) => unknown;
+/** The effects of a scope or of `effectsPlugin`, by the name they get on the context. */
+type Effects = Record<string, SignalFirst>;
+declare const bound: unique symbol;
 /**
- * The contract of every trace logger: receives each task phase of a bus.
- * Adapters in `nanoeffects/trace` are factories that return one; pass it
- * through `createTracer` to `createBus({ trace })`.
+ * An effect that says what it looks like once it is bound to a task (without
+ * the `ctx` parameter). A plain effect has its first parameter removed, which
+ * erases its generics; this type keeps them, because `F` is carried as it is.
+ * It changes the checker only: the function is the same at run time.
+ *
+ * @example
+ * ```ts
+ * type First = <T>(items: T[]) => T; // how a handler calls it
+ * const first: Effect<First> = (ctx, items) => items[0];
+ * ```
  */
-type TraceLogger<E = Record<string, unknown>> = (event: TraceEvent<E>) => void;
-/** One logger or several; a throwing logger never breaks the task or the others. */
-type Trace<E = Record<string, unknown>> = TraceLogger<E> | readonly TraceLogger<E>[];
-type UnsubscribeCallback = () => void;
+type Effect<F extends (...args: never[]) => unknown> = ((ctx: Signaled, ...args: Parameters<F>) => ReturnType<F>) & {
+  readonly [bound]?: F;
+};
+/** The bound form of a plain effect: the first parameter is gone, and so are its generics. */
+type Strip<F> = F extends ((ctx: never, ...args: infer A) => infer R) ? (...args: A) => R : never;
+/** The bound type an `Effect<F>` carries, or `Strip` of a plain function. */
+type BoundForm<F> = typeof bound extends keyof F ? NonNullable<F[typeof bound & keyof F]> : Strip<F>;
+//#endregion
+//#region src/core/scope-types.d.ts
+declare const scopeFields: unique symbol;
+/** What an action creator, a command or a call knows of the scope it was made with: its fields, for the checker. */
+type WithScope<F> = {
+  readonly [scopeFields]: F;
+};
+/** `X`, marked with the scope fields `F` it carries; `X` itself when there are none, so unscoped types stay as they were. */
+type Carrying<X, F> = X & ([unknown] extends [F] ? unknown : WithScope<F>);
+/**
+ * What a task gets on top of the context of its bus, for one place: every key
+ * is a context value and goes on `ctx` as it is, except `effects`, whose
+ * functions (each takes `{ signal }` first) are bound to the task. Made work by
+ * `scopePlugin` from `nanoeffects/scope`; without it a scope is ignored.
+ *
+ * @example
+ * ```ts
+ * const scope = { cache, effects: { race } }; // ctx.cache, and ctx.race bound to the task
+ * ```
+ */
+type Scope = {
+  readonly effects?: Effects;
+  readonly [field: string]: unknown;
+};
+/**
+ * What a call may replace of what it already has: the fields of the bus and
+ * those of its own scope, and its effects. The types must match the ones they
+ * replace; a field that neither declares has no type to check against, so it is
+ * an error.
+ */
+type EmitScope<E extends EventMap, F = unknown> = ([unknown] extends [ContextOf<E> & F] ? unknown : Partial<ContextOf<E> & F>) & {
+  effects?: Partial<Effects>;
+};
+/** `A` with the fields of `B` replacing those of the same name, not intersected with them. */
+type Merge<A, B> = Omit<A, keyof B> & B;
+/**
+ * The event map `E` with the fields `F` of a scope on top of its context
+ * fields; `E` itself when there are none. A field of the scope replaces the
+ * one of the bus in the type too.
+ */
+type WithFields<E extends EventMap, F> = [unknown] extends [F] ? E : Omit<E, keyof WithContext<object>> & WithContext<Merge<ContextOf<E>, F>>;
 //#endregion
 //#region src/core/action-creator.d.ts
 type WithPayload<E extends EventMap, K extends Keys<E>> = undefined extends E[K] ? {
@@ -257,15 +353,15 @@ type Free = typeof free;
  * it is given, and the bus checks it against its event map, so
  * `createAction("user/loaded")` needs no generics and keeps its literal type.
  */
-interface FreeActionCreator<T extends string> {
-  (): {
+interface FreeActionCreator<T extends string, F = unknown> {
+  (): Carrying<{
     type: T;
     payload: undefined;
-  };
-  <P>(payload: P): {
+  }, F>;
+  <P>(payload: P): Carrying<{
     type: T;
     payload: P;
-  };
+  }, F>;
   readonly type: T;
   /** Tells whether an action is one of this creator. */
   match(action: {
@@ -281,8 +377,8 @@ interface FreeActionCreator<T extends string> {
  * Makes actions of one type. It also works as the event of that type:
  * `bus.on(creator, fn)` and `bus.emit(creator(payload))`.
  */
-interface ActionCreator<P = void, T extends string = string, A extends unknown[] = PayloadOf<P>> {
-  (...args: A): Made<P, T>;
+interface ActionCreator<P = void, T extends string = string, A extends unknown[] = PayloadOf<P>, F = unknown> {
+  (...args: A): Carrying<Made<P, T>, F>;
   readonly type: T;
   /** Tells whether an action is one of this creator, and narrows its type. */
   match(action: {
@@ -292,4 +388,4 @@ interface ActionCreator<P = void, T extends string = string, A extends unknown[]
   toString(): T;
 }
 //#endregion
-export { Handler as A, ContextOf as C, EventKey as D, Emittable as E, WithType as F, commandCall as I, createBus as L, Off as M, On as N, EventLike as O, WithContext as P, Tracer as R, Context as S, Emit as T, Bus as _, EffectName as a, CommandCall as b, PayloadOf as c, Trace as d, TraceEvent as f, AnyEvent as g, Action as h, WithPayload as i, HandlerRef as j, EventPayload as k, Phase as l, UnsubscribeCallback as m, Free as n, EventMap as o, TraceLogger as p, FreeActionCreator as r, Keys as s, ActionCreator as t, Task as u, BusOptions as v, ContextOption as w, Commands as x, Command as y, anyEventType as z };
+export { HandlerRef as A, EventMap as B, Emit as C, EventPayload as D, EventLike as E, commandCall as F, Trace as G, PayloadOf as H, createBus as I, UnsubscribeCallback as J, TraceEvent as K, Tracer as L, On as M, WithContext as N, EventsOf as O, WithType as P, anyEventType as R, ContextOption as S, EventKey as T, Phase as U, Keys as V, Task as W, Command as _, EmitScope as a, Context as b, WithScope as c, Effects as d, Signaled as f, BusOptions as g, Bus as h, WithPayload as i, Off as j, Handler as k, BoundForm as l, AnyEvent as m, Free as n, Scope as o, Action as p, TraceLogger as q, FreeActionCreator as r, WithFields as s, ActionCreator as t, Effect as u, CommandCall as v, Emittable as w, ContextOf as x, Commands as y, EffectName as z };

package/dist/actions.d.ts

@@ -1,6 +1,8 @@
-import { n as Free, o as EventMap, r as FreeActionCreator, t as ActionCreator, u as Task } from "./action-creator-D48fp13T.js";
-import { a as modulePlugin, c as bindHandler, i as createModule, l as commandsPlugin, n as ModuleApi, o as Binding, r as ModuleContext, s as MadeCommand, t as Module, u as createCommand } from "./module-DVX8aYlq.js";
+import { B as EventMap, H as PayloadOf, T as EventKey, W as Task, c as WithScope, h as Bus, n as Free, o as Scope, r as FreeActionCreator, t as ActionCreator } from "./action-creator-c292nK7v.js";
+import { n as Scoped, t as FieldsOfScope } from "./types-mLaAx-EZ.js";
+import { a as modulePlugin, c as MadeCommand, d as createCommand, i as createModule, l as bindHandler, n as ModuleApi, o as Binding, r as ModuleContext, s as CarryingCalls, t as Module, u as commandsPlugin } from "./module-BlF2KSgy.js";
 //#region src/actions/action.d.ts
+type ScopedCreator<P, T extends string, F> = [P] extends [Free] ? FreeActionCreator<T, F> & WithScope<F> : ActionCreator<P, T, PayloadOf<P>, F> & WithScope<F>;
 /**
  * Creates an action creator, as in Redux Toolkit.
  *
@@ -13,6 +15,9 @@ import { a as modulePlugin, c as bindHandler, i as createModule, l as commandsPl
  *   generic: `createAction<User, "user/loaded">("user/loaded")`.
  * - With `prepare` the arguments of the creator can differ from the payload,
  *   and both types are inferred.
+ * - A scope as the last argument, `{ cache, effects: { race } }`, gives the
+ *   listeners of its calls those context fields; it works on a bus that uses `scopePlugin`
+ *   from `nanoeffects/scope` and is ignored on any other.
  *
  * @example
  * ```ts
@@ -33,6 +38,45 @@ export declare function createAction<P = Free, T extends string = string>(type:
 export declare function createAction<A extends unknown[], P, T extends string = string>(type: T, prepare: (...args: A) => {
   payload: P;
 }): ActionCreator<P, T, A>;
+export declare function createAction<P = Free, T extends string = string, S extends Scope = Record<never, never>>(type: T, scope: S): ScopedCreator<P, T, FieldsOfScope<EventMap, S>>;
+export declare function createAction<A extends unknown[], P, T extends string, S extends Scope>(type: T, prepare: (...args: A) => {
+  payload: P;
+}, scope: S): ActionCreator<P, T, A, FieldsOfScope<EventMap, S>> & WithScope<FieldsOfScope<EventMap, S>>;
+//#endregion
+//#region src/actions/emitter.d.ts
+/** What `emitterPlugin` adds to the bus. */
+type EmitterApi<E extends EventMap> = {
+  /**
+   * Turns an action creator into a function that emits its action on this
+   * bus, to pass as a callback. The function takes what the creator takes.
+   */
+  emitter: {
+    /** A creator without a payload type: the payload comes from the event map. */
+    <K extends EventKey<E>>(creator: FreeActionCreator<K>): (...payload: PayloadOf<E[K]>) => void;
+    <P, T extends string, A extends unknown[]>(creator: ActionCreator<P, T, A>): (...args: A) => void;
+  };
+};
+/**
+ * Adds `bus.emitter(creator)`: a function that emits the action of `creator`
+ * on this bus. Use it where something wants a callback, such as the
+ * subscription of a state manager, instead of `(value) => bus.emit(creator(value))`.
+ * The creator stays a plain `createAction`, so `bus.emit(creator(value))` and
+ * `bus.on(creator, …)` work as before. Returns the same bus.
+ *
+ * @example
+ * ```ts
+ * import { createBus } from "nanoeffects";
+ * import { createAction, emitterPlugin } from "nanoeffects/actions";
+ *
+ * const bus = createBus().use(emitterPlugin());
+ * const nameChanged = createAction<string>("name/changed");
+ * const emitNameChanged = bus.emitter(nameChanged);
+ *
+ * // nanostores: the store calls it with the new value
+ * $name.listen(emitNameChanged);
+ * ```
+ */
+export declare const emitterPlugin: () => <E extends EventMap>(bus: Bus<E>) => Bus<E> & EmitterApi<E>;
 //#endregion
 //#region src/actions/job.d.ts
 type Creator = {
@@ -58,6 +102,9 @@ type Job<P, R, T extends string, S extends Outcome, F extends Outcome> = MadeCom
  * effect. It returns the command, with the two actions on it: `job.success` and
  * `job.fail`.
  *
+ * A scope as the last argument, `{ cache, effects: { race } }`, gives the handler
+ * and the listeners of the outcome those context fields; see `scopePlugin`.
+ *
  * `success` and `fail` are a type string, from which the job makes an action
  * creator with `createAction`, or an action creator that exists already, which
  * is used and returned as it is. A missing one is made with the type
@@ -82,11 +129,13 @@ type Job<P, R, T extends string, S extends Outcome, F extends Outcome> = MadeCom
  * bus.emit(loadUser("1")); // loadUser.success(user) or loadUser.fail(error) comes later
  * ```
  */
-export declare const createJob: <P = void, R = void, T extends string = string, E extends EventMap = EventMap, S extends Outcome = `${T}/success`, F extends Outcome = `${T}/fail`>(type: T, handler?: Task<P, E, R>, outcomes?: {
+export declare const createJob: <P = void, R = void, T extends string = string, E extends EventMap = EventMap, S extends Outcome = `${T}/success`, F extends Outcome = `${T}/fail`, X extends Scope = Record<never, never>>(type: T, handler?: Task<P, Scoped<E, X>, R>, outcomes?: {
   /** Gets the result when the handler succeeds: a type to make an action creator of, or an action creator. */
   success?: S;
   /** Gets the error when the handler fails: a type to make an action creator of, or an action creator. */
   fail?: F;
-}) => Job<P, R, T, S, F>;
+},
+/** Context values and `effects` for the handler and for the listeners of the outcome; see `scopePlugin`. */
+scope?: X) => CarryingCalls<Job<P, R, T, S, F>, P, Promise<Awaited<R> | undefined>, FieldsOfScope<E, X>>;
 //#endregion
-export { type ActionCreator, type Binding, type FreeActionCreator, type Job, type Module, type ModuleApi, type ModuleContext, bindHandler, commandsPlugin, createCommand, createModule, modulePlugin };
+export { type ActionCreator, type Binding, type EmitterApi, type FreeActionCreator, type Job, type Module, type ModuleApi, type ModuleContext, bindHandler, commandsPlugin, createCommand, createModule, modulePlugin };

package/dist/actions.js

@@ -1 +1 @@
-import{t as e}from"./onAbort-BgMfspK4.js";import{i as t,n}from"./context-DlA80GOA.js";import{t as r}from"./event-0RIBGYqS.js";import{r as i}from"./bus-Cho463Sq.js";function a(e,t){return Object.assign((...n)=>({type:e,payload:t?t(...n).payload:n[0]}),{type:e,match:t=>t.type===e,toString:()=>e})}var o=class extends Error{};const s=(e,t)=>{let n=t=>t.type===e;function r(n,r){if(typeof r==`object`){if(!t)throw new o(`No handler for command "${e}"`);return t(n,r)}return i(a,e,n)}let a=Object.assign(r,{type:e,match:n});return a},c=(e,t)=>[e,t],l=(e=[])=>t=>{let n=/* @__PURE__ */ new Map,i=(e,t)=>{let r={fn:t};return n.set(e,[...n.get(e)??[],r]),()=>{let t=(n.get(e)??[]).filter(e=>e!==r);t.length>0?n.set(e,t):n.delete(e)}};function a(e,t){if(t)return i(r(e),t);let n=e.map(([e,t])=>i(r(e),t));return()=>{for(let e of n)e()}}a(e);let o={run:(e,t,r)=>{let i=(n.get(e.type)??[]).at(-1)?.fn,a=i&&e.wrap?e.wrap(i):i??e;return Reflect.apply(a,null,[t,r])},handle:a};return t.commands=o,o},u=e=>typeof e==`string`?a(e):e,d=(e,t,n)=>{let r=e.emit;r(Reflect.apply(t,null,[n]))},f=e=>{try{return Promise.resolve(e())}catch(e){if(e instanceof o)throw e;return Promise.reject(e)}},p=(e,t,n={})=>{let r=s(e,t),a=u(n.success??`${e}/success`),o=u(n.fail??`${e}/fail`),c=(e,t,n)=>{let r=n;return f(()=>Reflect.apply(e,null,[t,n])).then(e=>(d(r,a,e),e),e=>{d(r,o,e)})},l=e=>(t,n)=>c(e,t,n);function p(t,n){return typeof n==`object`?c(r,t,n):i(m,e,t)}let m=Object.assign(p,{type:e,match:r.match,wrap:l,success:a,fail:o});return m},m=(e,t)=>({name:e,setup:t}),h=(r=[])=>i=>{let a=i.commands??l()(i),o={handle:(...e)=>{if(!a.handle)throw Error("modulePlugin: the `commands` of the bus is not a registry from `commandsPlugin()`");return Reflect.apply(a.handle,null,e)}},s=n({event:{type:`app`,payload:void 0},bus:i,tracer:i.trace}),c=n=>{let r=/* @__PURE__ */ new Map,i=/* @__PURE__ */ new Map;return{mount:a=>{let s=r.get(a);if(s)return s;let l=i.get(a.name);l&&r.get(l)?.();let u=t(n,a.name),d=u.ctx,f=c(d),p=()=>{r.delete(a),i.get(a.name)===a&&i.delete(a.name),d.abort(),u.unlink()};r.set(a,p),i.set(a.name,a);let m=(t,n)=>{let r=Reflect.apply(o.handle,null,[t,n]);return e(d,r),r},h=(...e)=>{let t=e.map(e=>typeof e==`function`?m(e,e):f.mount(e));return()=>{for(let e of t)e()}},g=(e,...t)=>{d.run(e,...t).catch(e=>{if(!d.signal.aborted)throw e})};try{a.setup(Object.assign(d,{handle:m,use:h,spawn:g}))}catch(e){throw p(),e}return p},unmount:e=>r.get(e)?.(),isMounted:e=>r.has(e)}},u=c(s.ctx);for(let e of r)u.mount(e);return{commands:a,mount:e=>(s.ctx.signal.throwIfAborted(),u.mount(e)),unmount:u.unmount,isMounted:u.isMounted,dispose:()=>s.ctx.abort()}};export{c as bindHandler,l as commandsPlugin,a as createAction,s as createCommand,p as createJob,m as createModule,h as modulePlugin};
+import{t as e}from"./onAbort-BgMfspK4.js";import{i as t,n}from"./context-CK0ZomWt.js";import{t as r}from"./event-0RIBGYqS.js";import{r as i}from"./bus-BAs9x7IQ.js";import{t as a}from"./scope-key-B7l7mUS5.js";const o=(e,t)=>(t&&Object.defineProperty(e,a,{value:t}),e);function s(e,t,n){let r=typeof t==`function`?t:void 0,i=typeof t==`function`?n:t;return Object.assign(o((...t)=>o({type:e,payload:r?r(...t).payload:t[0]},i),i),{type:e,match:t=>t.type===e,toString:()=>e})}var c=class extends Error{};function l(e,t,n){let r=t=>t.type===e;function a(r,a){if(typeof a==`object`){if(!t)throw new c(`No handler for command "${e}"`);return t(r,a)}return o(i(l,e,r),n)}let s=Object.assign(a,{type:e,match:r}),l=o(s,n);return l}const u=(e,t)=>[e,t],d=(e=[])=>t=>{let n=/* @__PURE__ */ new Map,i=(e,t)=>{let r={fn:t};return n.set(e,[...n.get(e)??[],r]),()=>{let t=(n.get(e)??[]).filter(e=>e!==r);t.length>0?n.set(e,t):n.delete(e)}};function a(e,t){if(t)return i(r(e),t);let n=e.map(([e,t])=>i(r(e),t));return()=>{for(let e of n)e()}}a(e);let o={run:(e,t,r)=>{let i=(n.get(e.type)??[]).at(-1)?.fn,a=i&&e.wrap?e.wrap(i):i??e;return Reflect.apply(a,null,[t,r])},handle:a};return t.commands=o,o},f=()=>e=>{function t(t){return(...n)=>{let r=t(...n);e.emit(r)}}return Object.assign(e,{emitter:t})},p=e=>typeof e==`string`?s(e):e,m=(e,t,n,r)=>{let i=e.emit;i(Reflect.apply(t,null,[n]),r)},h=e=>{try{return Promise.resolve(e())}catch(e){if(e instanceof c)throw e;return Promise.reject(e)}},g=(e,t,n={},r)=>{let a=l(e,t),s=p(n.success??`${e}/success`),c=p(n.fail??`${e}/fail`),u=(e,t,n)=>{let i=n;return h(()=>Reflect.apply(e,null,[t,n])).then(e=>(m(i,s,e,r),e),e=>{m(i,c,e,r)})},d=e=>(t,n)=>u(e,t,n);function f(t,n){return typeof n==`object`?u(a,t,n):o(i(_,e,t),r)}let g=Object.assign(f,{type:e,match:a.match,wrap:d,success:s,fail:c}),_=o(g,r);return _};function _(e,t,n){return n?{name:e,setup:t,scope:n}:{name:e,setup:t}}const v=(e,t)=>n=>t&&typeof n==`function`?e.fitScope?.(t,n)??n:n,y=(e,t,n)=>{n&&e.applyScope?.(t,n)},b=(e,t,n)=>Array.isArray(t)?[t.map(([t,n])=>[t,e(n)]),n]:[t,e(n)],x=(e,t)=>{let n=e.on;return(...e)=>{let[r,i]=e;return Reflect.apply(n,null,[r,t(i)])}},S=e=>(t,...n)=>{e.run(t,...n).catch(t=>{if(!e.signal.aborted)throw t})},C=(r=[])=>i=>{let a=i.commands??d()(i),o={handle:(...e)=>{if(!a.handle)throw Error("modulePlugin: the `commands` of the bus is not a registry from `commandsPlugin()`");return Reflect.apply(a.handle,null,e)}},s=n({event:{type:`app`,payload:void 0},bus:i,tracer:i.trace}),c=n=>{let r=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Map;return{mount:s=>{let l=r.get(s);if(l)return l;let u=a.get(s.name);u&&r.get(u)?.();let d=t(n,s.name),f=d.ctx,p=c(f),m=()=>{r.delete(s),a.get(s.name)===s&&a.delete(s.name),f.abort(),d.unlink()};r.set(s,m),a.set(s.name,s);let h=s.scope,g=v(i,h),_=(t,n)=>{let r=Reflect.apply(o.handle,null,b(g,t,n));return e(f,r),r},C=(...e)=>{let t=e.map(e=>typeof e==`function`?_(e,e):p.mount(e));return()=>{for(let e of t)e()}},w=S(f),T=x(f,g);try{y(i,f,h),s.setup(Object.assign(f,{handle:_,use:C,spawn:w,on:T}))}catch(e){throw m(),e}return m},unmount:e=>r.get(e)?.(),isMounted:e=>r.has(e)}},l=c(s.ctx);for(let e of r)l.mount(e);return{commands:a,mount:e=>(s.ctx.signal.throwIfAborted(),l.mount(e)),unmount:l.unmount,isMounted:l.isMounted,dispose:()=>s.ctx.abort(),createModule:_}};export{u as bindHandler,d as commandsPlugin,s as createAction,l as createCommand,g as createJob,_ as createModule,f as emitterPlugin,C as modulePlugin};

package/dist/{bus-Cho463Sq.js → bus-BAs9x7IQ.js}

@@ -1 +1 @@
-import{n as e}from"./onAbort-BgMfspK4.js";import{a as t,n,r}from"./context-DlA80GOA.js";import{n as i}from"./promise-CSLpzwSR.js";import{n as a,t as o}from"./event-0RIBGYqS.js";const s=`*`,c=()=>{let e={},t={},n=n=>(t[n]=void 0,e[n]??=/* @__PURE__ */ new Map,e[n]),r=(e,t)=>{let r=n(e),i=r.get(t)??0;i>1?r.set(t,i-1):t?r.delete(t):r.clear()};return{get:n=>(t[n]??=[...e[n]??[]].flatMap(([e,t])=>Array(t).fill(e)),t[n]),add:(e,t)=>{let i=n(e);return i.set(t,(i.get(t)??0)+1),()=>{r(e,t)}},remove:r,clear:()=>{for(let t of Reflect.ownKeys(e))delete e[t];for(let e of Reflect.ownKeys(t))delete t[e]}}},l=Symbol(`nanoeffects.commandCall`),u=(e,t,n)=>{let r={type:t,payload:n};return Object.defineProperty(r,l,{value:e,enumerable:!1}),r},d=e=>{if(typeof e==`function`)return e;if(typeof e==`object`&&e&&l in e)return e[l]},f=(e,t,n)=>Reflect.apply(e,null,[t,n]),p=(s={})=>{let l=c(),u=(e,t)=>l.add(o(e),t),p=(e,t)=>{let n=u(e,(e,r)=>(n(),t(e,r)));return n},m=(e,t)=>{e===void 0?l.clear():l.remove(o(e),t)},h=(t,a)=>{let{onError:o}=s,{ctx:c}=n({event:a,bus:g,tracer:s.trace,parent:{ref:r()}});if(!o){t(a.payload,c);return}let l=t=>{try{o(t,a)}catch(t){e(`onError failed`,t)}};try{let e=t(a.payload,c);i(e)&&Promise.resolve(e).catch(l)}catch(e){l(e)}},g={on:u,once:p,off:m,emit:(e,i)=>{let c=o(e),u=a(e,i),p={type:c,payload:u},m=d(e),_=[...l.get(c),...l.get(`*`)];_.length===0&&!m&&s.onUnhandled?.(p);for(let e of _)h(e,p);if(m){let{ctx:e}=n({event:p,bus:g,tracer:s.trace,parent:{ref:r()}}),i=g.commands?.run??f;return t(e,`command`,()=>i(m,u,e))}},use:e=>e(g),context:s.context,trace:s.trace};return g};export{s as i,p as n,u as r,l as t};
+import{n as e}from"./onAbort-BgMfspK4.js";import{a as t,n,r}from"./context-CK0ZomWt.js";import{n as i}from"./promise-CSLpzwSR.js";import{n as a,t as o}from"./event-0RIBGYqS.js";const s=`*`,c=()=>{let e={},t={},n=n=>(t[n]=void 0,e[n]??=/* @__PURE__ */ new Map,e[n]),r=(e,t)=>{let r=n(e),i=r.get(t)??0;i>1?r.set(t,i-1):t?r.delete(t):r.clear()};return{get:n=>(t[n]??=[...e[n]??[]].flatMap(([e,t])=>Array(t).fill(e)),t[n]),add:(e,t)=>{let i=n(e);return i.set(t,(i.get(t)??0)+1),()=>{r(e,t)}},remove:r,clear:()=>{for(let t of Reflect.ownKeys(e))delete e[t];for(let e of Reflect.ownKeys(t))delete t[e]}}},l=Symbol(`nanoeffects.commandCall`),u=(e,t,n)=>{let r={type:t,payload:n};return Object.defineProperty(r,l,{value:e,enumerable:!1}),r},d=e=>{if(typeof e==`function`)return e;if(typeof e==`object`&&e&&l in e)return e[l]},f=(e,t,n)=>Reflect.apply(e,null,[t,n]),p=(s={})=>{let l=c(),u=(e,t)=>l.add(o(e),t),p=(e,t)=>{let n=u(e,(e,r)=>(n(),t(e,r)));return n},m=(e,t)=>{e===void 0?l.clear():l.remove(o(e),t)},h=(t,a)=>{let{onError:o}=s,{ctx:c}=n({event:a,bus:g,tracer:s.trace,parent:{ref:r()}});if(!o){t(a.payload,c);return}let l=t=>{try{o(t,a)}catch(t){e(`onError failed`,t)}};try{let e=t(a.payload,c);i(e)&&Promise.resolve(e).catch(l)}catch(e){l(e)}},g={on:u,once:p,off:m,emit:(e,i)=>{let c=o(e),u=a(e,i),p={type:c,payload:u},m=d(e),_=[...l.get(c),...l.get(`*`)];_.length===0&&!m&&s.onUnhandled?.(p);for(let e of _)h(e,p);if(m){let{ctx:e}=n({event:p,bus:g,tracer:s.trace,parent:{ref:r()}}),i=g.commands?.run??f;return t(e,`command`,()=>i(m,u,e))}},use:e=>e(g),ctx:s.context,trace:s.trace};return g};export{s as i,p as n,u as r,l as t};

package/dist/{context-DlA80GOA.js → context-CK0ZomWt.js}

@@ -1 +1 @@
-import{t as e}from"./onAbort-BgMfspK4.js";const t=t=>{let n=new AbortController;return{controller:n,unlink:e({signal:t},e=>n.abort(e))}},n=typeof __NANOEFFECTS_TRACE__>`u`||__NANOEFFECTS_TRACE__,r=/* @__PURE__ */ new WeakMap;let i;const a=()=>i,o=()=>{},s=(e,t,i,a)=>{let o=n&&r.get(e);o&&o.tracer.report(o.ref,t,i,a)},c=(e,t)=>{let i=n&&r.get(e);return i?i.tracer.settler(i.ref,t):o},l=(e,t,i)=>{let a=n&&r.get(e);return a?a.tracer.run(a.ref,t,e.signal,i):i()},u=(e,t)=>typeof e==`function`?e(t):e,d=e=>e,f=({event:a,bus:s,tracer:c,parent:p})=>{let{controller:m,unlink:h}=t(p?.signal),{signal:g}=m,_=n&&c?{tracer:c,ref:c.task(a,p?.ref)}:void 0,v=(...e)=>{if(g.aborted)return;let t=s?.emit,n=i;i=_?.ref;try{return t?.(...e)}finally{i=n}},y=(...t)=>{if(g.aborted)return o;let n=s?.on,r=n?.(...t);if(!r)return o;let i=e({signal:g},r);return()=>{i(),r()}},b=async(e,...t)=>{g.throwIfAborted();let n=t[0],r=f({event:{type:a.type,payload:n},bus:s,tracer:c,parent:{signal:g,ref:_?.ref}});try{return await l(r.ctx,`run`,()=>e(n,r.ctx))}finally{r.unlink()}},x=d({...u(s?.context,a),type:a.type,payload:a.payload,signal:g,abort:e=>m.abort(e),emit:v,on:y,off:s?.off??o,run:b});return _&&r.set(x,_),{ctx:x,unlink:h}},p=(e,t)=>{let i=n?r.get(e):void 0;return f({event:{type:t??e.type??``,payload:e.payload},bus:{emit:e.emit,on:e.on,off:e.off,context:e},tracer:i?.tracer,parent:{signal:e.signal,ref:i?.ref}})};export{l as a,p as i,f as n,s as o,a as r,c as t};
+import{t as e}from"./onAbort-BgMfspK4.js";const t=t=>{let n=new AbortController;return{controller:n,unlink:e({signal:t},e=>n.abort(e))}},n=typeof __NANOEFFECTS_TRACE__>`u`||__NANOEFFECTS_TRACE__,r=/* @__PURE__ */ new WeakMap;let i;const a=()=>i,o=()=>{},s=(e,t,i,a)=>{let o=n&&r.get(e);o&&o.tracer.report(o.ref,t,i,a)},c=(e,t)=>{let i=n&&r.get(e);return i?i.tracer.settler(i.ref,t):o},l=(e,t,i)=>{let a=n&&r.get(e);return a?a.tracer.run(a.ref,t,e.signal,i):i()},u=(e,t)=>typeof e==`function`?e(t):e,d=e=>e,f=({event:a,bus:s,tracer:c,parent:p})=>{let{controller:m,unlink:h}=t(p?.signal),{signal:g}=m,_=n&&c?{tracer:c,ref:c.task(a,p?.ref)}:void 0,v=(...e)=>{if(g.aborted)return;let t=s?.emit,n=i;i=_?.ref;try{return t?.(...e)}finally{i=n}},y=(...t)=>{if(g.aborted)return o;let n=s?.on,r=n?.(...t);if(!r)return o;let i=e({signal:g},r);return()=>{i(),r()}},b=async(e,...t)=>{g.throwIfAborted();let n=t[0],r=f({event:{type:a.type,payload:n},bus:s,tracer:c,parent:{signal:g,ref:_?.ref}});try{return await l(r.ctx,`run`,()=>e(n,r.ctx))}finally{r.unlink()}},x=d({...u(s?.ctx,a),type:a.type,payload:a.payload,signal:g,abort:e=>m.abort(e),emit:v,on:y,off:s?.off??o,run:b});return s?.addContext?.(x),_&&r.set(x,_),{ctx:x,unlink:h}},p=(e,t)=>{let i=n?r.get(e):void 0;return f({event:{type:t??e.type??``,payload:e.payload},bus:{emit:e.emit,on:e.on,off:e.off,ctx:e},tracer:i?.tracer,parent:{signal:e.signal,ref:i?.ref}})};export{l as a,p as i,f as n,s as o,a as r,c as t};

package/dist/context-plugin-1pYmSQEG.d.ts

@@ -0,0 +1,34 @@
+import { B as EventMap, N as WithContext, h as Bus, x as ContextOf } from "./action-creator-c292nK7v.js";
+//#region src/core/context-plugin.d.ts
+/** What a function that makes the fields of a task gets to see. */
+type ContextTask = {
+  type: string;
+  payload?: unknown;
+};
+/**
+ * `unknown` when none of the `fields` is already a context field of the bus,
+ * else `never`: the call does not compile. Used as `bus: Bus<E> & NoClash<…>`.
+ */
+type NoClash<Fields extends object, E extends EventMap> = [keyof Fields & keyof ContextOf<E>] extends [never] ? unknown : never;
+/**
+ * Puts `fields` on the context of every task of the bus: a store, a client, a
+ * logger. The types come from the value, so the event map needs no
+ * `WithContext`. Returns the same bus, typed with the fields. A function gets
+ * `{ type, payload }` of the task and returns its fields.
+ *
+ * Several uses merge with each other, with the `context` option of `createBus`
+ * and with `effectsPlugin`. A name that the bus already has is a type error. The
+ * fields of the library (`signal`, `emit`, `run`, …) win, and a field that the
+ * context already has is not replaced.
+ *
+ * @example
+ * ```ts
+ * type Events = { "user/loaded": User };
+ *
+ * const bus = createBus<Events>().use(contextPlugin({ store }));
+ * bus.on("user/loaded", (user, { store }) => store.put(user)); // ctx.store: Store
+ * ```
+ */
+declare const contextPlugin: <Fields extends object>(fields: Fields | ((task: ContextTask) => Fields)) => <E extends EventMap>(bus: Bus<E> & NoClash<Fields, E>) => Bus<E & WithContext<Fields>>;
+//#endregion
+export { NoClash as n, contextPlugin as r, ContextTask as t };

package/dist/dev.d.ts

@@ -1,5 +1,5 @@
-import { _ as Bus, m as UnsubscribeCallback, o as EventMap } from "./action-creator-D48fp13T.js";
-import { n as ModuleApi } from "./module-DVX8aYlq.js";
+import { B as EventMap, J as UnsubscribeCallback, h as Bus } from "./action-creator-c292nK7v.js";
+import { n as ModuleApi } from "./module-BlF2KSgy.js";
 //#region src/dev/types.d.ts
 /** The parts of what `modulePlugin` returned that the diagnostics report. */
 type ReportedApp<E extends EventMap> = Pick<ModuleApi<E>, "mount" | "unmount" | "isMounted">;

package/dist/effects.d.ts

@@ -1,89 +1,41 @@
-import { S as Context, o as EventMap, s as Keys, u as Task } from "./action-creator-D48fp13T.js";
-//#region src/utils/delay.d.ts
-/**
- * Resolves after `ms`, or rejects early if `ctx.signal` aborts. `ms` can be a
- * function that returns the number of ms, called once when the delay starts:
- * handy for a random pause (jitter).
- *
- * @example
- * ```ts
- * await delay({}, 500);
- *
- * // 200 to 400 ms
- * await delay({}, () => 200 + Math.random() * 200);
- *
- * // inside a task: stops waiting when the task is aborted
- * bus.on("retry", async (_, ctx) => {
- *   await delay(ctx, 1000);
- *   await load();
- * });
- * ```
- */
-export declare const delay: (ctx: {
-  signal?: AbortSignal | undefined;
-}, ms: number | (() => number)) => Promise<void>;
-//#endregion
+import { B as EventMap, W as Task, u as Effect } from "./action-creator-c292nK7v.js";
+import { a as RaceStarter, c as all, d as delay, i as take, l as EffectContext, n as effectsPlugin, o as race, r as TakeOptions, s as allSettled, u as Starter } from "./plugin-CCYlC0XS.js";
 //#region src/utils/onAbort.d.ts
 export declare const onAbort: (ctx: {
   signal?: AbortSignal | undefined;
 }, fn: (reason: unknown) => void) => (() => void);
 //#endregion
-//#region src/effects/run.d.ts
-/** Context passed into `race` / `all` effect starters. */
-type EffectContext = {
-  signal: AbortSignal;
-  abort: (reason?: unknown) => void;
+//#region src/effects/backoff.d.ts
+type BackoffOptions = {
+  /** Pause before the second attempt, in ms. Default 100. */
+  base?: number;
+  /** How many times each pause is longer than the one before. Default 2. */
+  factor?: number;
+  /** Longest pause, in ms. Default `Infinity`. */
+  max?: number;
+  /**
+   * Use a random pause from 0 up to the computed one ("full jitter"), so
+   * clients that failed together do not retry together. Default `false`.
+   */
+  jitter?: boolean;
 };
-type Starter<T> = (ctx: EffectContext) => T | PromiseLike<T>;
-//#endregion
-//#region src/effects/all.d.ts
 /**
- * Runs all starters; waits for every result. On failure or parent abort, cancels the rest.
+ * Builds the `delay` of `retry`: the pause grows as `base * factor ** (attempt - 1)`
+ * and never passes `max`. `retry` counts attempts from 1; `poll` counts calls from
+ * 0, so there the first pause is `base / factor`.
  *
  * @example
  * ```ts
- * bus.on("load", async (id, ctx) => {
- *   const { user, posts } = await all(ctx, {
- *     user: ({ signal }) => fetchUser(id, { signal }),
- *     posts: ({ signal }) => fetchPosts(id, { signal }),
- *   });
- *
- *   // arrays work too: const [user, posts] = await all(ctx, [getUser, getPosts]);
- * });
- * ```
- */
-export declare function all<T extends Record<string, Starter<unknown>>>(ctx: {
-  signal?: AbortSignal;
-}, effects: T): Promise<{ [K in keyof T]: Awaited<ReturnType<T[K]>>; }>;
-export declare function all<const T extends readonly Starter<unknown>[]>(ctx: {
-  signal?: AbortSignal;
-}, effects: T): Promise<{ -readonly [K in keyof T]: Awaited<ReturnType<T[K]>>; }>;
-//#endregion
-//#region src/effects/allSettled.d.ts
-/**
- * Runs all starters and waits for every one to settle, whether it succeeds or
- * fails: nothing is cancelled when a starter fails. The result has, for each
- * starter, `{ status: "fulfilled", value }` or `{ status: "rejected", reason }`.
- * Only an abort of `ctx` rejects it, with the abort reason.
- *
- * @example
- * ```ts
- * bus.on("load", async (id, ctx) => {
- *   const { user, posts } = await allSettled(ctx, {
- *     user: ({ signal }) => fetchUser(id, { signal }),
- *     posts: ({ signal }) => fetchPosts(id, { signal }),
- *   });
- *
- *   if (user.status === "fulfilled") render(user.value);
- * });
+ * bus.on(
+ *   "load",
+ *   retry(loadUser, {
+ *     times: 5,
+ *     delay: backoff({ base: 200, max: 5000, jitter: true }), // 200, 400, 800, ... up to 5 s, randomised
+ *   }),
+ * );
  * ```
  */
-export declare function allSettled<T extends Record<string, Starter<unknown>>>(ctx: {
-  signal?: AbortSignal;
-}, effects: T): Promise<{ [K in keyof T]: PromiseSettledResult<Awaited<ReturnType<T[K]>>>; }>;
-export declare function allSettled<const T extends readonly Starter<unknown>[]>(ctx: {
-  signal?: AbortSignal;
-}, effects: T): Promise<{ -readonly [K in keyof T]: PromiseSettledResult<Awaited<ReturnType<T[K]>>>; }>;
+export declare const backoff: (options?: BackoffOptions) => (attempt: number) => number;
 //#endregion
 //#region src/effects/cancellable.d.ts
 type CancellableHandle<T> = {
@@ -160,32 +112,6 @@ export declare function poll(ctx: {
   signal: AbortSignal;
 }, fn: (tick: number) => unknown, ms: PollMs, options?: PollOptions): Promise<void>;
 //#endregion
-//#region src/effects/race.d.ts
-type RaceStarter<T> = Starter<T>;
-/**
- * Runs all starters; first to settle wins, losers are cancelled via `ctx.abort`.
- * The result holds only the winner's value, under its key or index.
- *
- * @example
- * ```ts
- * bus.on("load", async (id, ctx) => {
- *   const result = await race(ctx, {
- *     data: ({ signal }) => fetchData(id, { signal }),
- *     timeout: ({ signal }) => delay({ signal }, 5000),
- *   });
- *
- *   if ("timeout" in result) throw new Error("timed out");
- *   render(result.data);
- * });
- * ```
- */
-export declare function race<T extends Record<string, RaceStarter<unknown>>>(ctx: {
-  signal?: AbortSignal;
-}, effects: T): Promise<{ [K in keyof T]?: Awaited<ReturnType<T[K]>>; }>;
-export declare function race<const T extends readonly RaceStarter<unknown>[]>(ctx: {
-  signal?: AbortSignal;
-}, effects: T): Promise<{ -readonly [K in keyof T]?: Awaited<ReturnType<T[K]>>; }>;
-//#endregion
 //#region src/effects/retry.d.ts
 type RetryOptions = {
   /** Total number of attempts, the first one included. Default 3. */
@@ -226,34 +152,6 @@ export declare function retry<T>(ctx: {
   signal?: AbortSignal;
 }, fn: RetryFn<T>, options?: RetryOptions): Promise<T>;
 //#endregion
-//#region src/effects/take.d.ts
-type TakeOptions<P> = {
-  /** Wait for the first payload this accepts; others are skipped. */
-  predicate?: (payload: P) => boolean;
-  /** Stop waiting when this aborts, e.g. the signal of a `race` starter. */
-  signal?: AbortSignal | undefined;
-};
-/**
- * Waits for the next `event` on the bus and resolves with its payload. It sees
- * only events emitted after the call, takes only one, and unsubscribes when it
- * is done. If `ctx` (or `options.signal`) aborts first, it unsubscribes and
- * rejects with the abort reason.
- *
- * @example
- * ```ts
- * bus.on("login", async (user, ctx) => {
- *   const reason = await take(ctx, "logout");
- *   cleanup(user, reason);
- * });
- *
- * // wait for a matching event, but not longer than 5 s
- * const done = await timeout(ctx, 5000, ({ signal }) =>
- *   take(ctx, "saved", { signal, predicate: (id) => id === draftId }),
- * );
- * ```
- */
-export declare const take: <E extends EventMap, K extends Keys<E>>(ctx: Context<E>, event: K, options?: TakeOptions<E[K]>) => Promise<E[K]>;
-//#endregion
 //#region src/effects/timeout.d.ts
 /**
  * Runs a function; if it takes longer than `ms`, aborts its signal and rejects
@@ -281,4 +179,4 @@ export declare function timeout<T>(ctx: {
   signal?: AbortSignal;
 }, ms: number, starter: Starter<T>): Promise<T>;
 //#endregion
-export type { CancellableExecutor, CancellableHandle, EffectContext, PollOptions, RaceStarter, RetryOptions, TakeOptions };
+export { type BackoffOptions, type CancellableExecutor, type CancellableHandle, type Effect, type EffectContext, type PollOptions, type RaceStarter, type RetryOptions, type TakeOptions, all, allSettled, delay, effectsPlugin, race, take };