posipaki 0.27.0 → 0.27.2

package/README.md

@@ -16,7 +16,7 @@ JavaScript has three ways to model async work:
 
 What's missing is a primitive for something that **receives messages, updates its
 own state, and sends messages back** — a thing with its own lifecycle, can be started
-and aborted before it resolves. 
+and aborted before it resolves.
 
 A **process**.
 
@@ -42,11 +42,10 @@ await proc.ready();
 proc.send({ type: "POKE" });
 ```
 
-
 A process can do everything a promise, a stream, or a store can do —
 but it can also fork children, pause/resume, and exit on its own terms.
 And every handler receives the sender's identity in the `[msg, sender]` tuple,
-so you always know *who* sent what.
+so you always know _who_ sent what.
 Of course processes are composable into trees.
 
 ## Quick start
@@ -64,8 +63,8 @@ const counter = defineActor({
 });
 
 const proc = counter.spawn(null);
-await proc.ready();           // state is available
-proc.send({ type: "POKE" });  // delivers [msg, sender] to the generator
+await proc.ready(); // state is available
+proc.send({ type: "POKE" }); // delivers [msg, sender] to the generator
 // proc.state.count === 1
 ```
 
@@ -90,7 +89,6 @@ proc.send({ type: "POKE" });
 await proc.wait();
 ```
 
-
 ## Okay, but what do I use it for?
 
 To call the `/chat_complete` endpoint and emit effects (tool calls)
@@ -112,7 +110,6 @@ This means when you send three messages to a process -- they will be processed s
 and their results will not produce a race. You can also ask the process to exit
 and it will not produce any messages once it does. This also cascades to their children.
 
-
 ## Features
 
 - **Processes** — sync or async, same API

package/dist/{hooks-DL2s94eM.d.ts → hooks-BSYYoG5e.d.ts}

@@ -40,7 +40,7 @@ interface ActorDefinition<Args, InternalState, InMsg extends Message, OutMsg ext
   inMessages: ActorMessages<InMsg> | undefined;
   outMessages: ActorMessages<OutMsg> | undefined;
 }
-type ActorConfig<Args, InternalState, InMsg extends Message, OutMsg extends Message, Methods extends MethodOptions, Handlers extends HandlerOptions<InMsg>, ReflectionMethods extends ReflectionOptions> = ThisType<ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>> & {
+type ActorConfig<Args, InternalState, InMsg extends Message, OutMsg extends Message, Methods extends MethodOptions, Handlers extends HandlerOptions<InMsg>, ReflectionMethods extends ReflectionOptions> = {
   /** Preferred process name.  Used by ctx.fork() when no explicit name is given. */
   name?: string;
   plugins?: ActorPlugin[] | PluginTransform;
@@ -58,21 +58,21 @@ type ActorConfig<Args, InternalState, InMsg extends Message, OutMsg extends Mess
    *  any child is forked in `setup`. */
   beforeStart?: (this: ActorContext<Args, never, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>) => void | Promise<void>;
   setup?: (this: ActorContext<Args, never, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, args: Args) => Promise<InternalState> | InternalState;
-  afterStart?: () => void | Promise<void>;
-  onStopRequested?: () => HookResult | Promise<HookResult>;
-  beforeEnd?: (reason?: unknown) => HookResult | Promise<HookResult>;
-  afterEnd?: (reason?: unknown) => HookResult | Promise<HookResult>;
-  onError?: (error?: unknown) => HookResult | Promise<HookResult>;
-  onEmit?: (msg: OutMsg, sender: SenderInfo) => HookResult | Promise<HookResult>;
-  onMessage?: (msg: InMsg, sender: SenderInfo) => HookResult | Promise<HookResult>;
-  onUnhandled?: (msg: Message, sender: SenderInfo) => void | Promise<void>;
-  onChildExit?: (name: string, reason: ExitMessage) => HookResult | Promise<HookResult>;
+  afterStart?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>) => void | Promise<void>;
+  onStopRequested?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>) => HookResult | Promise<HookResult>;
+  beforeEnd?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, reason?: unknown) => HookResult | Promise<HookResult>;
+  afterEnd?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, reason?: unknown) => HookResult | Promise<HookResult>;
+  onError?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, error?: unknown) => HookResult | Promise<HookResult>;
+  onEmit?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, msg: OutMsg, sender: SenderInfo) => HookResult | Promise<HookResult>;
+  onMessage?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, msg: InMsg, sender: SenderInfo) => HookResult | Promise<HookResult>;
+  onUnhandled?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, msg: Message, sender: SenderInfo) => void | Promise<void>;
+  onChildExit?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, name: string, reason: ExitMessage) => HookResult | Promise<HookResult>;
   /** Fires for each orphan a child leaves behind (in its EXIT).  Return the
    *  policy: `'adopt'` (promote to a child, draining its buffer), `'force-stop'`
    *  (hard-kill), `'unparent'` (drop its buffer, keep it running in `orphans`),
    *  or `'leave'` (keep buffering, propagate up on my exit).  When no `onOrphan`
    *  is defined, the default is `'force-stop'`. */
-  onOrphan?: (orphan: AnyProcess) => OrphanDecision | void | Promise<OrphanDecision | void>;
+  onOrphan?: (this: ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, orphan: AnyProcess) => OrphanDecision | void | Promise<OrphanDecision | void>;
   handlers: Handlers & ThisType<ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>>;
   methods?: Methods & ThisType<ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>>;
   $reflectionMethods?: ReflectionMethods & ThisType<ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ActorReflection & ActorReflection>>;
@@ -86,7 +86,7 @@ declare const stopPropagation: () => typeof STOP_SENTINEL;
 /** Return type of onMessage hooks: void (continue) or sentinel (stop). */
 type HookResult = void | typeof STOP_SENTINEL;
 /** Decision returned by `onOrphan` for how to handle an inherited orphan. */
-type OrphanDecision = 'adopt' | 'force-stop' | 'unparent' | 'leave';
+type OrphanDecision = "adopt" | "force-stop" | "unparent" | "leave";
 /** A reusable unit of actor behaviour. */
 type ActorPlugin<C = AnyConfig> = (config: C) => C | Promise<C>;
 /** Transform parent plugins into child plugins. */
@@ -160,4 +160,4 @@ type Hook<T, I extends unknown[], O> = (this: T, ...args: I) => O;
 declare function callHook<T, I extends unknown[], O>(fn: Hook<T, I, O> | undefined, eh: ((e: unknown) => unknown) | undefined, thisArg: T, ...args: I): Promise<O | undefined>;
 //#endregion
 export { ReflectionOptions as _, chainHook as a, stopPropagation as b, ActorContext as c, ActorPlugin as d, HandlerFn as f, PluginTransform as g, MethodOptions as h, callHook as i, ActorDefinition as l, HookResult as m, ActorReflection as n, mergeConfigs as o, HandlerOptions as p, Hook as r, ActorConfig as s, ActorDecorated as t, ActorMessages as u, STOP_SENTINEL as v, SpawnedFrom as y };
-//# sourceMappingURL=hooks-DL2s94eM.d.ts.map
+//# sourceMappingURL=hooks-BSYYoG5e.d.ts.map

package/dist/hooks-BSYYoG5e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-BSYYoG5e.d.ts","names":[],"sources":["../src/actor-types.ts","../src/hooks.ts"],"mappings":"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"}

package/dist/hooks-V-PEPJHv.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-V-PEPJHv.js","names":[],"sources":["../src/actor-types.ts","../src/hooks.ts"],"sourcesContent":["// ── defineActor types ────────────────────────────────────────────────────────\n//\n// Shared between define-actor.ts (implementation) and consumers that want\n// to reference the config/context/definition shapes without importing the\n// implementation module directly.\n\nimport type {\n  SenderInfo,\n  AsyncProcessFn,\n  Message,\n  ProcessCtx,\n  ExitMessage,\n} from \"./types.js\";\nimport type { ActorDecorated, ActorReflection } from \"./hooks.js\";\nimport type { AnyProcess, AsyncProcess } from \"./process.async.js\";\n\n// Internal marker do not use\nexport type ActorMessages<M extends Message> = {\n  __tag_messages: M;\n};\nexport interface MethodOptions {\n  [key: string]: Function;\n}\nexport type HandlerFn<InMsg extends Message> = (\n  msg: InMsg,\n  sender: SenderInfo,\n) => void | Promise<void>;\nexport type HandlerOptions<InMsg extends Message> = Omit<\n  {\n    [K in InMsg[\"type\"]]: HandlerFn<Extract<InMsg, { type: K }>>;\n  },\n  \"STOP\"\n>;\nexport type ReflectionMethod = (...args: unknown[]) => unknown;\nexport interface ReflectionOptions {}\nexport type Paired<Priv, Pub> = { public: Pub; private: Priv };\nexport type HidePrivate<T> =\n  T extends Paired<unknown, unknown> ? T[\"public\"] : T;\n\nexport type SpawnedFrom<T extends ActorDefinition<any, any, any, any, any>> =\n  T extends ActorDefinition<infer A, infer S, infer IM, infer OM, infer R>\n    ? AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>\n    : never;\n\nexport interface ActorDefinition<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  ReflectionMethods extends ReflectionOptions,\n> {\n  fn: AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg>;\n  /** Preferred process name (from config.name). */\n  name?: string;\n  /** Raw plugin config (array or transform). Resolved at fork time. @internal */\n  pvtPluginsRaw?: ActorPlugin[] | PluginTransform;\n  /** Spawn this actor as a standalone process. */\n  spawn(\n    args: Args,\n    opts?: {\n      name?: string;\n      toParent?: (msg: OutMsg, from: SenderInfo) => void;\n      addPlugins?: ActorPlugin[];\n    },\n  ): Promise<\n    AsyncProcess<\n      Args,\n      HidePrivate<InternalState>,\n      InMsg,\n      OutMsg,\n      ReflectionMethods & ActorReflection\n    >\n  >;\n  /** Spawn this actor as a child of the calling process.\n   *  `ctx` must be able to fork children that emit `OutMsg` — i.e. the\n   *  parent's in-message is a supertype of this actor's out-message. */\n  spawnAsChild<PMO extends Message>(\n    ctx: ProcessCtx<unknown, unknown, OutMsg, PMO>,\n    args: Args,\n    opts?: {\n      name?: string;\n      parentPlugins?: ActorPlugin[];\n      addPlugins?: ActorPlugin[];\n    },\n  ): Promise<\n    AsyncProcess<\n      Args,\n      HidePrivate<InternalState>,\n      InMsg,\n      OutMsg,\n      ReflectionMethods & ActorReflection\n    >\n  >;\n  inMessages: ActorMessages<InMsg> | undefined;\n  outMessages: ActorMessages<OutMsg> | undefined;\n}\nexport type ActorConfig<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n> = ThisType<\n  ActorContext<\n    Args,\n    InternalState,\n    InMsg,\n    OutMsg,\n    Methods,\n    Handlers,\n    ReflectionMethods & ActorReflection\n  >\n> & {\n  /** Preferred process name.  Used by ctx.fork() when no explicit name is given. */\n  name?: string;\n  plugins?: ActorPlugin[] | PluginTransform;\n  /** Non-overridable plugins added at spawn time (spawn/fork opts).\n   *  Set by the framework during assembly, not by user config. @internal */\n  addPlugins?: ActorPlugin[];\n  /** Resolved plugin chain (raw config transformed against parent plugins).\n   *  Set by the framework during assembly, replacing `plugins` (the raw form).\n   *  @internal */\n  resolvedPlugins?: ActorPlugin[];\n  outMessages?: ActorMessages<OutMsg>;\n  inMessages?: ActorMessages<InMsg>;\n\n  /** Fires once `self` is built, before `setup`.  State is not yet set\n   *  (`this.state` is `never`).  Use for registering the process/ctx before\n   *  any child is forked in `setup`. */\n  beforeStart?: (\n    this: ActorContext<\n      Args,\n      never,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n  ) => void | Promise<void>;\n  setup?: (\n    this: ActorContext<\n      Args,\n      never,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    args: Args,\n  ) => Promise<InternalState> | InternalState;\n  afterStart?: () => void | Promise<void>;\n  onStopRequested?: () => HookResult | Promise<HookResult>;\n  beforeEnd?: (reason?: unknown) => HookResult | Promise<HookResult>;\n  afterEnd?: (reason?: unknown) => HookResult | Promise<HookResult>;\n  onError?: (error?: unknown) => HookResult | Promise<HookResult>;\n  onEmit?: (\n    msg: OutMsg,\n    sender: SenderInfo,\n  ) => HookResult | Promise<HookResult>;\n\n  onMessage?: (\n    msg: InMsg,\n    sender: SenderInfo,\n  ) => HookResult | Promise<HookResult>;\n\n  onUnhandled?: (msg: Message, sender: SenderInfo) => void | Promise<void>;\n\n  onChildExit?: (\n    name: string,\n    reason: ExitMessage,\n  ) => HookResult | Promise<HookResult>;\n\n  /** Fires for each orphan a child leaves behind (in its EXIT).  Return the\n   *  policy: `'adopt'` (promote to a child, draining its buffer), `'force-stop'`\n   *  (hard-kill), `'unparent'` (drop its buffer, keep it running in `orphans`),\n   *  or `'leave'` (keep buffering, propagate up on my exit).  When no `onOrphan`\n   *  is defined, the default is `'force-stop'`. */\n  onOrphan?: (\n    orphan: AnyProcess,\n  ) => OrphanDecision | void | Promise<OrphanDecision | void>;\n\n  handlers: Handlers &\n    ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      >\n    >;\n\n  methods?: Methods &\n    ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      >\n    >;\n  $reflectionMethods?: ReflectionMethods &\n    ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ActorReflection & ActorReflection\n      >\n    >;\n  // for plugin use only\n  $decorate?: Partial<ActorDecorated>;\n};\nexport type AnyConfig = ActorConfig<\n  unknown,\n  unknown,\n  Message,\n  Message,\n  MethodOptions,\n  HandlerOptions<Message>,\n  ReflectionOptions\n>;\n\n// ── stop propagation sentinel ────────────────────────────────────────────\n\n/** Returned by onMessage hooks to prevent further dispatch. */\nexport const STOP_SENTINEL = Symbol(\"posipaki.stopPropagation\");\n\n/** Type-safe sentinel for short-circuiting onMessage hooks. */\nexport const stopPropagation = (): typeof STOP_SENTINEL => STOP_SENTINEL;\n\n// ── hook function types ──────────────────────────────────────────────────\n\n/** Return type of onMessage hooks: void (continue) or sentinel (stop). */\nexport type HookResult = void | typeof STOP_SENTINEL;\n\n/** Decision returned by `onOrphan` for how to handle an inherited orphan. */\nexport type OrphanDecision = 'adopt' | 'force-stop' | 'unparent' | 'leave';\n// ── plugin types ─────────────────────────────────────────────────────────\n\n/** A reusable unit of actor behaviour. */\nexport type ActorPlugin<C = AnyConfig> = (config: C) => C | Promise<C>;\n\n/** Transform parent plugins into child plugins. */\nexport type PluginTransform = (parentPlugins: ActorPlugin[]) => ActorPlugin[];\n\nexport type ActorContext<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n> = Methods &\n  ActorDecorated & {\n    state: InternalState;\n    name: string;\n    id: symbol;\n\n    emit: (msg: OutMsg) => void;\n    agreeToStop: () => void;\n\n    reflection: ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods\n      >\n    > &\n      ReflectionMethods;\n    exit: (reason?: unknown) => void;\n\n    $child: Record<string, AnyProcess>;\n\n    fork<\n      A,\n      S,\n      IM extends Message,\n      OM extends InMsg,\n      R extends ReflectionOptions,\n    >(\n      actor: ActorDefinition<A, S, IM, OM, R>,\n      args?: A,\n      opts?: {\n        name?: string;\n        addPlugins?: ActorPlugin[];\n      },\n    ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>>;\n\n    ctx: ProcessCtx<Args, HidePrivate<InternalState>, InMsg, OutMsg>;\n  };\n","// ── Lifecycle Hooks ──────────────────────────────────────────────────────\n//\n// Extends ProcessCtx and defineActor with observable lifecycle hooks.\n// Hooks are additive — multiple callbacks can register for the same hook\n// point, and they fire in registration order.\n\nimport { STOP_SENTINEL, stopPropagation } from \"./actor-types.js\";\nimport type {\n  HookResult,\n  ActorPlugin,\n  PluginTransform,\n  AnyConfig,\n} from \"./actor-types.js\";\n\n// ── stop propagation sentinel ────────────────────────────────────────────\n\n// Re-exports from actor-types.ts (backward compatibility)\nexport { STOP_SENTINEL, stopPropagation };\nexport type { HookResult, ActorPlugin, PluginTransform };\n\n// ── type augmentation (Fastify-style) ────────────────────────────────────\n\n/**\n * Interface that plugins can augment via declaration merging.\n * Plugins ship a .d.ts that adds properties to this interface,\n * making them available on `this` in handlers and methods.\n *\n * Example (in a plugin's .d.ts):\n *   declare module 'posipaki' {\n *     interface ActorDecorated {\n *       log: Logger;\n *     }\n *   }\n */\nexport interface ActorDecorated {}\nexport interface ActorReflection {}\n\n// ── chainHook ────────────────────────────────────────────────────────────\n\n/**\n * Compose two lifecycle hooks so that `plugin` fires first.\n *\n * If `plugin` returns the STOP_SENTINEL (via stopPropagation()),\n * `existing` is skipped entirely and the sentinel propagates.\n * Otherwise `existing` fires and its return value is used.\n *\n * Typical use in a plugin:\n *   (cfg) => ({ ...cfg, onStart: chainHook(cfg.onStart, myOnStart) })\n *\n * @param existing - the current hook on the config (may be undefined)\n * @param plugin   - the new hook to prepend\n * @returns a composed hook suitable for ActorConfig\n */\nexport function chainHook<TThis, TArgs extends unknown[]>(\n  existing:\n    | ((this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>)\n    | undefined,\n  plugin: (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>,\n): (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult> {\n  if (!existing) return plugin;\n  return async function (this: TThis, ...args: TArgs): Promise<HookResult> {\n    const result = await plugin.call(this, ...args);\n    if (result === STOP_SENTINEL) return result;\n    return await existing.call(this, ...args);\n  } as (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>;\n}\n\n// ── mergeConfigs ─────────────────────────────────────────────────────────\n\n/**\n * Merge an overlay config into a base config, auto-chaining every on* hook.\n *\n * Each key in `overlay` that starts with \"on\" followed by an uppercase\n * letter (onStart, onMessage, onEmit, etc.) is composed via chainHook()\n * so that the overlay hook fires before the base hook, and stopPropagation\n * is respected.\n *\n * Typical use in a plugin:\n *   return mergeConfigs(cfg, {\n *     onStart() { this.log.info('starting'); },\n *     beforeEnd() { this.log.info('stopping'); },\n *   });\n *\n * @param base    - the existing config (ActorConfig)\n * @param overlay - new hook implementations to prepend\n * @returns a new config with hooks chained\n */\nexport function mergeConfigs<C extends AnyConfig>(base: C, overlay: Partial<C>): C {\n  const result = { ...base } as Record<string, unknown>;\n  for (const key of Object.keys(overlay as Record<string, unknown>)) {\n    const val = (overlay as Record<string, unknown>)[key];\n    if (typeof val === \"function\" && /^(on|after|before)[A-Z]/.test(key)) {\n      result[key] = chainHook(\n        (base as Record<string, unknown>)[key] as (\n          this: unknown,\n          ...args: unknown[]\n        ) => HookResult | Promise<HookResult>,\n        val as (\n          this: unknown,\n          ...args: unknown[]\n        ) => HookResult | Promise<HookResult>,\n      );\n    } else {\n      result[key] = val;\n    }\n  }\n  result.$reflectionMethods = {};\n  Object.assign(\n    result.$reflectionMethods as object,\n    \"$reflectionMethods\" in base ? base.$reflectionMethods : {},\n    \"$reflectionMethods\" in overlay ? overlay.$reflectionMethods : {},\n  );\n\n  return result as unknown as C;\n}\n\nexport type Hook<T, I extends unknown[], O> = (this: T, ...args: I) => O;\n\nexport async function callHook<T, I extends unknown[], O>(\n  fn: Hook<T, I, O> | undefined,\n  eh: ((e: unknown) => unknown) | undefined,\n  thisArg: T,\n  ...args: I\n): Promise<O | undefined> {\n  if (fn) {\n    try {\n      return await fn.call(thisArg, ...args);\n    } catch (e) {\n      if (eh) {\n        try {\n          await eh(e);\n        } catch {}\n      } else {\n        throw e;\n      }\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;AA8OA,MAAa,gBAAgB,OAAO,0BAA0B;;AAG9D,MAAa,wBAA8C;;;;;;;;;;;;;;;;;AC5L3D,SAAgB,UACd,UAGA,QACmE;CACnE,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,eAA6B,GAAG,MAAkC;EACvE,MAAM,SAAS,MAAM,OAAO,KAAK,MAAM,GAAG,IAAI;EAC9C,IAAI,WAAW,eAAe,OAAO;EACrC,OAAO,MAAM,SAAS,KAAK,MAAM,GAAG,IAAI;CAC1C;AACF;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAkC,MAAS,SAAwB;CACjF,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,KAAK,MAAM,OAAO,OAAO,KAAK,OAAkC,GAAG;EACjE,MAAM,MAAO,QAAoC;EACjD,IAAI,OAAO,QAAQ,cAAc,0BAA0B,KAAK,GAAG,GACjE,OAAO,OAAO,UACX,KAAiC,MAIlC,GAIF;OAEA,OAAO,OAAO;CAElB;CACA,OAAO,qBAAqB,CAAC;CAC7B,OAAO,OACL,OAAO,oBACP,wBAAwB,OAAO,KAAK,qBAAqB,CAAC,GAC1D,wBAAwB,UAAU,QAAQ,qBAAqB,CAAC,CAClE;CAEA,OAAO;AACT;AAIA,eAAsB,SACpB,IACA,IACA,SACA,GAAG,MACqB;CACxB,IAAI,IACF,IAAI;EACF,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,IAAI;CACvC,SAAS,GAAG;EACV,IAAI,IACF,IAAI;GACF,MAAM,GAAG,CAAC;EACZ,QAAQ,CAAC;OAET,MAAM;CAEV;AAGJ"}
+{"version":3,"file":"hooks-V-PEPJHv.js","names":[],"sources":["../src/actor-types.ts","../src/hooks.ts"],"sourcesContent":["// ── defineActor types ────────────────────────────────────────────────────────\n//\n// Shared between define-actor.ts (implementation) and consumers that want\n// to reference the config/context/definition shapes without importing the\n// implementation module directly.\n\nimport type { SenderInfo, AsyncProcessFn, Message, ProcessCtx, ExitMessage } from \"./types.js\";\nimport type { ActorDecorated, ActorReflection } from \"./hooks.js\";\nimport type { AnyProcess, AsyncProcess } from \"./process.async.js\";\n\n// Internal marker do not use\nexport type ActorMessages<M extends Message> = {\n  __tag_messages: M;\n};\nexport interface MethodOptions {\n  [key: string]: Function;\n}\nexport type HandlerFn<InMsg extends Message> = (\n  msg: InMsg,\n  sender: SenderInfo,\n) => void | Promise<void>;\nexport type HandlerOptions<InMsg extends Message> = Omit<\n  {\n    [K in InMsg[\"type\"]]: HandlerFn<Extract<InMsg, { type: K }>>;\n  },\n  \"STOP\"\n>;\nexport type ReflectionMethod = (...args: unknown[]) => unknown;\nexport interface ReflectionOptions {}\nexport type Paired<Priv, Pub> = { public: Pub; private: Priv };\nexport type HidePrivate<T> = T extends Paired<unknown, unknown> ? T[\"public\"] : T;\n\nexport type SpawnedFrom<T extends ActorDefinition<any, any, any, any, any>> =\n  T extends ActorDefinition<infer A, infer S, infer IM, infer OM, infer R>\n    ? AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>\n    : never;\n\nexport interface ActorDefinition<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  ReflectionMethods extends ReflectionOptions,\n> {\n  fn: AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg>;\n  /** Preferred process name (from config.name). */\n  name?: string;\n  /** Raw plugin config (array or transform). Resolved at fork time. @internal */\n  pvtPluginsRaw?: ActorPlugin[] | PluginTransform;\n  /** Spawn this actor as a standalone process. */\n  spawn(\n    args: Args,\n    opts?: {\n      name?: string;\n      toParent?: (msg: OutMsg, from: SenderInfo) => void;\n      addPlugins?: ActorPlugin[];\n    },\n  ): Promise<\n    AsyncProcess<\n      Args,\n      HidePrivate<InternalState>,\n      InMsg,\n      OutMsg,\n      ReflectionMethods & ActorReflection\n    >\n  >;\n  /** Spawn this actor as a child of the calling process.\n   *  `ctx` must be able to fork children that emit `OutMsg` — i.e. the\n   *  parent's in-message is a supertype of this actor's out-message. */\n  spawnAsChild<PMO extends Message>(\n    ctx: ProcessCtx<unknown, unknown, OutMsg, PMO>,\n    args: Args,\n    opts?: {\n      name?: string;\n      parentPlugins?: ActorPlugin[];\n      addPlugins?: ActorPlugin[];\n    },\n  ): Promise<\n    AsyncProcess<\n      Args,\n      HidePrivate<InternalState>,\n      InMsg,\n      OutMsg,\n      ReflectionMethods & ActorReflection\n    >\n  >;\n  inMessages: ActorMessages<InMsg> | undefined;\n  outMessages: ActorMessages<OutMsg> | undefined;\n}\nexport type ActorConfig<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n> = {\n  /** Preferred process name.  Used by ctx.fork() when no explicit name is given. */\n  name?: string;\n  plugins?: ActorPlugin[] | PluginTransform;\n  /** Non-overridable plugins added at spawn time (spawn/fork opts).\n   *  Set by the framework during assembly, not by user config. @internal */\n  addPlugins?: ActorPlugin[];\n  /** Resolved plugin chain (raw config transformed against parent plugins).\n   *  Set by the framework during assembly, replacing `plugins` (the raw form).\n   *  @internal */\n  resolvedPlugins?: ActorPlugin[];\n  outMessages?: ActorMessages<OutMsg>;\n  inMessages?: ActorMessages<InMsg>;\n\n  /** Fires once `self` is built, before `setup`.  State is not yet set\n   *  (`this.state` is `never`).  Use for registering the process/ctx before\n   *  any child is forked in `setup`. */\n  beforeStart?: (\n    this: ActorContext<\n      Args,\n      never,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n  ) => void | Promise<void>;\n\n  setup?: (\n    this: ActorContext<\n      Args,\n      never,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    args: Args,\n  ) => Promise<InternalState> | InternalState;\n\n  afterStart?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n  ) => void | Promise<void>;\n\n  onStopRequested?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n  ) => HookResult | Promise<HookResult>;\n\n  beforeEnd?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    reason?: unknown,\n  ) => HookResult | Promise<HookResult>;\n\n  afterEnd?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    reason?: unknown,\n  ) => HookResult | Promise<HookResult>;\n\n  onError?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    error?: unknown,\n  ) => HookResult | Promise<HookResult>;\n\n  onEmit?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    msg: OutMsg,\n    sender: SenderInfo,\n  ) => HookResult | Promise<HookResult>;\n\n  onMessage?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    msg: InMsg,\n    sender: SenderInfo,\n  ) => HookResult | Promise<HookResult>;\n\n  onUnhandled?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    msg: Message,\n    sender: SenderInfo,\n  ) => void | Promise<void>;\n\n  onChildExit?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    name: string,\n    reason: ExitMessage,\n  ) => HookResult | Promise<HookResult>;\n\n  /** Fires for each orphan a child leaves behind (in its EXIT).  Return the\n   *  policy: `'adopt'` (promote to a child, draining its buffer), `'force-stop'`\n   *  (hard-kill), `'unparent'` (drop its buffer, keep it running in `orphans`),\n   *  or `'leave'` (keep buffering, propagate up on my exit).  When no `onOrphan`\n   *  is defined, the default is `'force-stop'`. */\n  onOrphan?: (\n    this: ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods & ActorReflection\n    >,\n    orphan: AnyProcess,\n  ) => OrphanDecision | void | Promise<OrphanDecision | void>;\n\n  handlers: Handlers &\n    ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      >\n    >;\n\n  methods?: Methods &\n    ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      >\n    >;\n  $reflectionMethods?: ReflectionMethods &\n    ThisType<\n      ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ActorReflection & ActorReflection\n      >\n    >;\n  // for plugin use only\n  $decorate?: Partial<ActorDecorated>;\n};\nexport type AnyConfig = ActorConfig<\n  unknown,\n  unknown,\n  Message,\n  Message,\n  MethodOptions,\n  HandlerOptions<Message>,\n  ReflectionOptions\n>;\n\n// ── stop propagation sentinel ────────────────────────────────────────────\n\n/** Returned by onMessage hooks to prevent further dispatch. */\nexport const STOP_SENTINEL = Symbol(\"posipaki.stopPropagation\");\n\n/** Type-safe sentinel for short-circuiting onMessage hooks. */\nexport const stopPropagation = (): typeof STOP_SENTINEL => STOP_SENTINEL;\n\n// ── hook function types ──────────────────────────────────────────────────\n\n/** Return type of onMessage hooks: void (continue) or sentinel (stop). */\nexport type HookResult = void | typeof STOP_SENTINEL;\n\n/** Decision returned by `onOrphan` for how to handle an inherited orphan. */\nexport type OrphanDecision = \"adopt\" | \"force-stop\" | \"unparent\" | \"leave\";\n// ── plugin types ─────────────────────────────────────────────────────────\n\n/** A reusable unit of actor behaviour. */\nexport type ActorPlugin<C = AnyConfig> = (config: C) => C | Promise<C>;\n\n/** Transform parent plugins into child plugins. */\nexport type PluginTransform = (parentPlugins: ActorPlugin[]) => ActorPlugin[];\n\nexport type ActorContext<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n> = Methods &\n  ActorDecorated & {\n    state: InternalState;\n    name: string;\n    id: symbol;\n\n    emit: (msg: OutMsg) => void;\n    agreeToStop: () => void;\n\n    reflection: ThisType<\n      ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>\n    > &\n      ReflectionMethods;\n    exit: (reason?: unknown) => void;\n\n    $child: Record<string, AnyProcess>;\n\n    fork<A, S, IM extends Message, OM extends InMsg, R extends ReflectionOptions>(\n      actor: ActorDefinition<A, S, IM, OM, R>,\n      args?: A,\n      opts?: {\n        name?: string;\n        addPlugins?: ActorPlugin[];\n      },\n    ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>>;\n\n    ctx: ProcessCtx<Args, HidePrivate<InternalState>, InMsg, OutMsg>;\n  };\n","// ── Lifecycle Hooks ──────────────────────────────────────────────────────\n//\n// Extends ProcessCtx and defineActor with observable lifecycle hooks.\n// Hooks are additive — multiple callbacks can register for the same hook\n// point, and they fire in registration order.\n\nimport { STOP_SENTINEL, stopPropagation } from \"./actor-types.js\";\nimport type { HookResult, ActorPlugin, PluginTransform, AnyConfig } from \"./actor-types.js\";\n\n// ── stop propagation sentinel ────────────────────────────────────────────\n\n// Re-exports from actor-types.ts (backward compatibility)\nexport { STOP_SENTINEL, stopPropagation };\nexport type { HookResult, ActorPlugin, PluginTransform };\n\n// ── type augmentation (Fastify-style) ────────────────────────────────────\n\n/**\n * Interface that plugins can augment via declaration merging.\n * Plugins ship a .d.ts that adds properties to this interface,\n * making them available on `this` in handlers and methods.\n *\n * Example (in a plugin's .d.ts):\n *   declare module 'posipaki' {\n *     interface ActorDecorated {\n *       log: Logger;\n *     }\n *   }\n */\nexport interface ActorDecorated {}\nexport interface ActorReflection {}\n\n// ── chainHook ────────────────────────────────────────────────────────────\n\n/**\n * Compose two lifecycle hooks so that `plugin` fires first.\n *\n * If `plugin` returns the STOP_SENTINEL (via stopPropagation()),\n * `existing` is skipped entirely and the sentinel propagates.\n * Otherwise `existing` fires and its return value is used.\n *\n * Typical use in a plugin:\n *   (cfg) => ({ ...cfg, onStart: chainHook(cfg.onStart, myOnStart) })\n *\n * @param existing - the current hook on the config (may be undefined)\n * @param plugin   - the new hook to prepend\n * @returns a composed hook suitable for ActorConfig\n */\nexport function chainHook<TThis, TArgs extends unknown[]>(\n  existing: ((this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>) | undefined,\n  plugin: (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>,\n): (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult> {\n  if (!existing) return plugin;\n  return async function (this: TThis, ...args: TArgs): Promise<HookResult> {\n    const result = await plugin.call(this, ...args);\n    if (result === STOP_SENTINEL) return result;\n    return await existing.call(this, ...args);\n  } as (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>;\n}\n\n// ── mergeConfigs ─────────────────────────────────────────────────────────\n\n/**\n * Merge an overlay config into a base config, auto-chaining every on* hook.\n *\n * Each key in `overlay` that starts with \"on\" followed by an uppercase\n * letter (onStart, onMessage, onEmit, etc.) is composed via chainHook()\n * so that the overlay hook fires before the base hook, and stopPropagation\n * is respected.\n *\n * Typical use in a plugin:\n *   return mergeConfigs(cfg, {\n *     onStart() { this.log.info('starting'); },\n *     beforeEnd() { this.log.info('stopping'); },\n *   });\n *\n * @param base    - the existing config (ActorConfig)\n * @param overlay - new hook implementations to prepend\n * @returns a new config with hooks chained\n */\nexport function mergeConfigs<C extends AnyConfig>(base: C, overlay: Partial<C>): C {\n  const result = { ...base } as Record<string, unknown>;\n  for (const key of Object.keys(overlay as Record<string, unknown>)) {\n    const val = (overlay as Record<string, unknown>)[key];\n    if (typeof val === \"function\" && /^(on|after|before)[A-Z]/.test(key)) {\n      result[key] = chainHook(\n        (base as Record<string, unknown>)[key] as (\n          this: unknown,\n          ...args: unknown[]\n        ) => HookResult | Promise<HookResult>,\n        val as (this: unknown, ...args: unknown[]) => HookResult | Promise<HookResult>,\n      );\n    } else {\n      result[key] = val;\n    }\n  }\n  result.$reflectionMethods = {};\n  Object.assign(\n    result.$reflectionMethods as object,\n    \"$reflectionMethods\" in base ? base.$reflectionMethods : {},\n    \"$reflectionMethods\" in overlay ? overlay.$reflectionMethods : {},\n  );\n\n  return result as unknown as C;\n}\n\nexport type Hook<T, I extends unknown[], O> = (this: T, ...args: I) => O;\n\nexport async function callHook<T, I extends unknown[], O>(\n  fn: Hook<T, I, O> | undefined,\n  eh: ((e: unknown) => unknown) | undefined,\n  thisArg: T,\n  ...args: I\n): Promise<O | undefined> {\n  if (fn) {\n    try {\n      return await fn.call(thisArg, ...args);\n    } catch (e) {\n      if (eh) {\n        try {\n          await eh(e);\n        } catch {}\n      } else {\n        throw e;\n      }\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;AAyUA,MAAa,gBAAgB,OAAO,0BAA0B;;AAG9D,MAAa,wBAA8C;;;;;;;;;;;;;;;;;AC5R3D,SAAgB,UACd,UACA,QACmE;CACnE,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,eAA6B,GAAG,MAAkC;EACvE,MAAM,SAAS,MAAM,OAAO,KAAK,MAAM,GAAG,IAAI;EAC9C,IAAI,WAAW,eAAe,OAAO;EACrC,OAAO,MAAM,SAAS,KAAK,MAAM,GAAG,IAAI;CAC1C;AACF;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAkC,MAAS,SAAwB;CACjF,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,KAAK,MAAM,OAAO,OAAO,KAAK,OAAkC,GAAG;EACjE,MAAM,MAAO,QAAoC;EACjD,IAAI,OAAO,QAAQ,cAAc,0BAA0B,KAAK,GAAG,GACjE,OAAO,OAAO,UACX,KAAiC,MAIlC,GACF;OAEA,OAAO,OAAO;CAElB;CACA,OAAO,qBAAqB,CAAC;CAC7B,OAAO,OACL,OAAO,oBACP,wBAAwB,OAAO,KAAK,qBAAqB,CAAC,GAC1D,wBAAwB,UAAU,QAAQ,qBAAqB,CAAC,CAClE;CAEA,OAAO;AACT;AAIA,eAAsB,SACpB,IACA,IACA,SACA,GAAG,MACqB;CACxB,IAAI,IACF,IAAI;EACF,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,IAAI;CACvC,SAAS,GAAG;EACV,IAAI,IACF,IAAI;GACF,MAAM,GAAG,CAAC;EACZ,QAAQ,CAAC;OAET,MAAM;CAEV;AAGJ"}

package/dist/hooks.d.ts

@@ -1,2 +1,2 @@
-import { a as chainHook, b as stopPropagation, d as ActorPlugin, g as PluginTransform, i as callHook, m as HookResult, n as ActorReflection, o as mergeConfigs, r as Hook, t as ActorDecorated, v as STOP_SENTINEL } from "./hooks-DL2s94eM.js";
+import { a as chainHook, b as stopPropagation, d as ActorPlugin, g as PluginTransform, i as callHook, m as HookResult, n as ActorReflection, o as mergeConfigs, r as Hook, t as ActorDecorated, v as STOP_SENTINEL } from "./hooks-BSYYoG5e.js";
 export { ActorDecorated, type ActorPlugin, ActorReflection, Hook, type HookResult, type PluginTransform, STOP_SENTINEL, callHook, chainHook, mergeConfigs, stopPropagation };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { a as ProcessCtx, c as SenderOrigin, d as WithSender, f as WithoutSender, g as spawnAsync, h as runDispatchAsync, i as PipeState, l as StopMessage, m as AsyncProcess, n as ExitMessage, o as ProcessFn, p as AnyProcess, r as Message, s as SenderInfo, t as AsyncProcessFn, u as SupervisorState } from "./types-B_bUAR9r.js";
-import { _ as ReflectionOptions, a as chainHook, b as stopPropagation, c as ActorContext, d as ActorPlugin, f as HandlerFn, g as PluginTransform, h as MethodOptions, i as callHook, l as ActorDefinition, m as HookResult, n as ActorReflection, o as mergeConfigs, p as HandlerOptions, s as ActorConfig, t as ActorDecorated, u as ActorMessages, y as SpawnedFrom } from "./hooks-DL2s94eM.js";
+import { _ as ReflectionOptions, a as chainHook, b as stopPropagation, c as ActorContext, d as ActorPlugin, f as HandlerFn, g as PluginTransform, h as MethodOptions, i as callHook, l as ActorDefinition, m as HookResult, n as ActorReflection, o as mergeConfigs, p as HandlerOptions, s as ActorConfig, t as ActorDecorated, u as ActorMessages, y as SpawnedFrom } from "./hooks-BSYYoG5e.js";
 import { n as spawn, t as Process } from "./process-B5ZijF-E.js";
 //#region src/util.d.ts
 type ReducerClosure<M> = (msg: M) => void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/util.ts","../src/adapters.ts","../src/define-actor.ts"],"mappings":";;;;KAOK,eAAe,MAAM,KAAK;KAC1B;;;;;;iBASK,YAAY,GACpB,cACA,IAAI,eAAe,IACnB,UAAS,SACT,uBACC,sBAAsB;;;iBCpBT,SAAS,GAAG,GAAG,WAAW,SAAS,WAAW,SAC5D,IAAI,UAAU,GAAG,GAAG,IAAI,MACvB,eAAe,GAAG,GAAG,IAAI;;;iBCmCZ,eACd,eAAe,UAAU,YACtB,cAAc;iBA4DH,YACd,MACA,eACA,cAAc,SACd,eAAe,SACf,gBAAgB,eAChB,iBAAiB,eAAe,QAChC,0BAA0B,mBAE1B,QAAQ,YACN,MACA,eACA,OACA,QACA,SACA,UACA,qBAED,gBAAgB,MAAM,eAAe,OAAO,QAAQ"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/util.ts","../src/adapters.ts","../src/define-actor.ts"],"mappings":";;;;KAOK,eAAe,MAAM,KAAK;KAC1B;;;;;;iBASK,YAAY,GACpB,cACA,IAAI,eAAe,IACnB,UAAS,SACT,uBACC,sBAAsB;;;iBCpBT,SAAS,GAAG,GAAG,WAAW,SAAS,WAAW,SAC5D,IAAI,UAAU,GAAG,GAAG,IAAI,MACvB,eAAe,GAAG,GAAG,IAAI;;;iBCyBZ,eAAe,eAAe,UAAU,YAAY,cAAc;iBA2DlE,YACd,MACA,eACA,cAAc,SACd,eAAe,SACf,gBAAgB,eAChB,iBAAiB,eAAe,QAChC,0BAA0B,mBAE1B,QAAQ,YAAY,MAAM,eAAe,OAAO,QAAQ,SAAS,UAAU,qBAC1E,gBAAgB,MAAM,eAAe,OAAO,QAAQ"}

package/dist/pipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.d.ts","names":[],"sources":["../src/pipe.ts"],"mappings":";;;;;;;UAWiB,UAAU,QAAQ;EACjC,QAAQ;EACR,QAAQ;EACR;;;;;;;iBAQO,KAAK,QAAQ,QACpB,KAAK;EAAqB;GAAkB,SAAS,aACpD,UACD,QACA,UAAU,QAAQ,SAClB,SACA,UAAU"}
+{"version":3,"file":"pipe.d.ts","names":[],"sources":["../src/pipe.ts"],"mappings":";;;;;;;UAWiB,UAAU,QAAQ;EACjC,QAAQ;EACR,QAAQ;EACR;;;;;;;iBAQO,KAAK,QAAQ,QACpB,KAAK;EAAqB;GAAkB,SAAS,aACpD,UAAU,QAAQ,UAAU,QAAQ,SAAS,SAAS,UAAU"}

package/dist/pipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.js","names":[],"sources":["../src/pipe.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { ExitMessage } from \"./util.js\";\nimport type { ProcessFn, ProcessCtx } from \"./process.js\";\nimport type { AsyncProcess } from \"./process.async.js\";\nimport type { Message, WithSender } from \"./types.js\";\n\n/**\n * State yielded by the pipe process. `params` starts as a copy of the\n * initial args and is updated after each child exits by merging the\n * child's `state.result` into it.\n */\nexport interface PipeState<Params, Result> {\n  params: Params | null;\n  result: Result | null;\n  running: boolean;\n}\n\n/**\n * Chain process functions so each runs after the previous one exits.\n * The `.state.result` of each completed child is spread into the params\n * of the next.\n */\nfunction pipe<Params, Result>(\n  fns: ProcessFn<unknown, { result: object }, Message, Message>[],\n): ProcessFn<\n  Params,\n  PipeState<Params, Result>,\n  Message,\n  Message | ExitMessage\n> {\n  return function* (\n    ctx: ProcessCtx<\n      Params,\n      PipeState<Params, Result>,\n      Message,\n      Message | ExitMessage\n    >,\n    params: Params,\n  ) {\n    const state: PipeState<Params, Result> = {\n      params: { ...params },\n      result: null,\n      running: false,\n    };\n    yield state;\n\n    const queue = [...fns];\n    let task: AsyncProcess<unknown, { result: object }, Message, Message, {}>;\n\n    function spawnNext(): void {\n      const fn = queue.shift()!;\n      task = ctx.forkSync(\n        fn,\n        `${ctx.pname} [${fn.name || \"<anonymous>\"}]`,\n      )(state.params as Params);\n    }\n\n    function hasNext(): boolean {\n      return queue.length > 0;\n    }\n\n    spawnNext();\n    state.running = hasNext();\n\n    yield* runDispatch<WithSender<Message | ExitMessage>>(\n      ctx.pname,\n      (maybe) => {\n        const [msg, _sender] = maybe;\n\n        if (msg.type === \"STOP\") {\n          state.params = null;\n          state.running = false;\n          return;\n        }\n\n        if (msg.type === \"EXIT\" && _sender.fromId === task.id) {\n          if (hasNext()) {\n            state.params = {\n              ...state.params!,\n              ...task.state?.result,\n            } as Params;\n            spawnNext();\n          } else {\n            state.running = false;\n            state.result = task.state?.result as Result;\n          }\n        }\n      },\n      () => !state.running,\n      true,\n    );\n  };\n}\n\nexport { pipe };\n"],"mappings":";;;;;;;AAsBA,SAAS,KACP,KAMA;CACA,OAAO,WACL,KAMA,QACA;EACA,MAAM,QAAmC;GACvC,QAAQ,EAAE,GAAG,OAAO;GACpB,QAAQ;GACR,SAAS;EACX;EACA,MAAM;EAEN,MAAM,QAAQ,CAAC,GAAG,GAAG;EACrB,IAAI;EAEJ,SAAS,YAAkB;GACzB,MAAM,KAAK,MAAM,MAAM;GACvB,OAAO,IAAI,SACT,IACA,GAAG,IAAI,MAAM,IAAI,GAAG,QAAQ,cAAc,EAC5C,CAAC,CAAC,MAAM,MAAgB;EAC1B;EAEA,SAAS,UAAmB;GAC1B,OAAO,MAAM,SAAS;EACxB;EAEA,UAAU;EACV,MAAM,UAAU,QAAQ;EAExB,OAAO,YACL,IAAI,QACH,UAAU;GACT,MAAM,CAAC,KAAK,WAAW;GAEvB,IAAI,IAAI,SAAS,QAAQ;IACvB,MAAM,SAAS;IACf,MAAM,UAAU;IAChB;GACF;GAEA,IAAI,IAAI,SAAS,UAAU,QAAQ,WAAW,KAAK,IAAI;IACrD,IAAI,QAAQ,GAAG;KACb,MAAM,SAAS;MACb,GAAG,MAAM;MACT,GAAG,KAAK,OAAO;KACjB;KACA,UAAU;IACZ,OAAO;KACL,MAAM,UAAU;KAChB,MAAM,SAAS,KAAK,OAAO;IAC7B;GACF;EACF,SACM,CAAC,MAAM,SACb,IACF;CACF;AACF"}
+{"version":3,"file":"pipe.js","names":[],"sources":["../src/pipe.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { ExitMessage } from \"./util.js\";\nimport type { ProcessFn, ProcessCtx } from \"./process.js\";\nimport type { AsyncProcess } from \"./process.async.js\";\nimport type { Message, WithSender } from \"./types.js\";\n\n/**\n * State yielded by the pipe process. `params` starts as a copy of the\n * initial args and is updated after each child exits by merging the\n * child's `state.result` into it.\n */\nexport interface PipeState<Params, Result> {\n  params: Params | null;\n  result: Result | null;\n  running: boolean;\n}\n\n/**\n * Chain process functions so each runs after the previous one exits.\n * The `.state.result` of each completed child is spread into the params\n * of the next.\n */\nfunction pipe<Params, Result>(\n  fns: ProcessFn<unknown, { result: object }, Message, Message>[],\n): ProcessFn<Params, PipeState<Params, Result>, Message, Message | ExitMessage> {\n  return function* (\n    ctx: ProcessCtx<Params, PipeState<Params, Result>, Message, Message | ExitMessage>,\n    params: Params,\n  ) {\n    const state: PipeState<Params, Result> = {\n      params: { ...params },\n      result: null,\n      running: false,\n    };\n    yield state;\n\n    const queue = [...fns];\n    let task: AsyncProcess<unknown, { result: object }, Message, Message, {}>;\n\n    function spawnNext(): void {\n      const fn = queue.shift()!;\n      task = ctx.forkSync(fn, `${ctx.pname} [${fn.name || \"<anonymous>\"}]`)(state.params as Params);\n    }\n\n    function hasNext(): boolean {\n      return queue.length > 0;\n    }\n\n    spawnNext();\n    state.running = hasNext();\n\n    yield* runDispatch<WithSender<Message | ExitMessage>>(\n      ctx.pname,\n      (maybe) => {\n        const [msg, _sender] = maybe;\n\n        if (msg.type === \"STOP\") {\n          state.params = null;\n          state.running = false;\n          return;\n        }\n\n        if (msg.type === \"EXIT\" && _sender.fromId === task.id) {\n          if (hasNext()) {\n            state.params = {\n              ...state.params!,\n              ...task.state?.result,\n            } as Params;\n            spawnNext();\n          } else {\n            state.running = false;\n            state.result = task.state?.result as Result;\n          }\n        }\n      },\n      () => !state.running,\n      true,\n    );\n  };\n}\n\nexport { pipe };\n"],"mappings":";;;;;;;AAsBA,SAAS,KACP,KAC8E;CAC9E,OAAO,WACL,KACA,QACA;EACA,MAAM,QAAmC;GACvC,QAAQ,EAAE,GAAG,OAAO;GACpB,QAAQ;GACR,SAAS;EACX;EACA,MAAM;EAEN,MAAM,QAAQ,CAAC,GAAG,GAAG;EACrB,IAAI;EAEJ,SAAS,YAAkB;GACzB,MAAM,KAAK,MAAM,MAAM;GACvB,OAAO,IAAI,SAAS,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,QAAQ,cAAc,EAAE,CAAC,CAAC,MAAM,MAAgB;EAC9F;EAEA,SAAS,UAAmB;GAC1B,OAAO,MAAM,SAAS;EACxB;EAEA,UAAU;EACV,MAAM,UAAU,QAAQ;EAExB,OAAO,YACL,IAAI,QACH,UAAU;GACT,MAAM,CAAC,KAAK,WAAW;GAEvB,IAAI,IAAI,SAAS,QAAQ;IACvB,MAAM,SAAS;IACf,MAAM,UAAU;IAChB;GACF;GAEA,IAAI,IAAI,SAAS,UAAU,QAAQ,WAAW,KAAK,IAAI;IACrD,IAAI,QAAQ,GAAG;KACb,MAAM,SAAS;MACb,GAAG,MAAM;MACT,GAAG,KAAK,OAAO;KACjB;KACA,UAAU;IACZ,OAAO;KACL,MAAM,UAAU;KAChB,MAAM,SAAS,KAAK,OAAO;IAC7B;GACF;EACF,SACM,CAAC,MAAM,SACb,IACF;CACF;AACF"}

package/dist/plugins/debug-logger.d.ts

@@ -1,5 +1,5 @@
 import { r as Message } from "../types-B_bUAR9r.js";
-import { d as ActorPlugin } from "../hooks-DL2s94eM.js";
+import { d as ActorPlugin } from "../hooks-BSYYoG5e.js";
 //#region src/plugins/debug-logger.d.ts
 declare module "../index" {
   interface ActorDecorated {

package/dist/plugins/tree-introspection.d.ts

@@ -1,5 +1,5 @@
 import { p as AnyProcess } from "../types-B_bUAR9r.js";
-import { d as ActorPlugin } from "../hooks-DL2s94eM.js";
+import { d as ActorPlugin } from "../hooks-BSYYoG5e.js";
 //#region src/plugins/tree-introspection.d.ts
 declare module "../index" {
   interface ActorReflection {

package/dist/process-B5ZijF-E.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-B5ZijF-E.d.ts","names":[],"sources":["../src/process.ts"],"mappings":";;;iBAQgB,MACd,GACA,GACA,WAAW,UAAU,SACrB,WAAW,UAAU,aAErB,IAAI,UAAU,GAAG,GAAG,IAAI,KACxB,eACA,MAAM,GAAG,IAAI,MAAM,uBACjB,GAAG,MAAM,QAAQ,GAAG,GAAG,IAAI;;;cAMzB,QACJ,GACA,GACA,WAAW,SACX,WAAW,iBACH,aAAa,GAAG,GAAG,IAAI;EAC/B,YACE,IAAI,UAAU,GAAG,GAAG,IAAI,KACxB,eACA,MAAM,GAAG,IAAI,MAAM;EAKrB,MAAM,GAAG;EAIT,QAAQ"}
+{"version":3,"file":"process-B5ZijF-E.d.ts","names":[],"sources":["../src/process.ts"],"mappings":";;;iBAQgB,MAAM,GAAG,GAAG,WAAW,UAAU,SAAS,WAAW,UAAU,aAC7E,IAAI,UAAU,GAAG,GAAG,IAAI,KACxB,eACA,MAAM,GAAG,IAAI,MAAM,uBACjB,GAAG,MAAM,QAAQ,GAAG,GAAG,IAAI;;;cAMzB,QAAQ,GAAG,GAAG,WAAW,SAAS,WAAW,iBAAiB,aAAa,GAAG,GAAG,IAAI;EACzF,YAAY,IAAI,UAAU,GAAG,GAAG,IAAI,KAAK,eAAe,MAAM,GAAG,IAAI,MAAM;EAI3E,MAAM,GAAG;EAIT,QAAQ"}

package/dist/remote/index.d.ts

@@ -1,5 +1,5 @@
 import { r as Message, t as AsyncProcessFn } from "../types-B_bUAR9r.js";
-import { _ as ReflectionOptions, h as MethodOptions, l as ActorDefinition, p as HandlerOptions } from "../hooks-DL2s94eM.js";
+import { _ as ReflectionOptions, h as MethodOptions, l as ActorDefinition, p as HandlerOptions } from "../hooks-BSYYoG5e.js";
 import { FileHandle } from "node:fs/promises";
 //#region src/remote/child.d.ts
 declare function makeSender(fromName: string, parentName: string | null, parentId: symbol | null): {
@@ -32,7 +32,7 @@ declare const bunConnector: (scriptPath: string) => Connector;
 /** Spawn via `node <script>`. */
 declare const nodeConnector: (scriptPath: string) => Connector;
 /**
- * Auto-detect: prefers `bun run` if the script is a .ts file and bun is
+ * Auto-detect: prefers `bun run` if bun is
  * the current runtime, otherwise falls back to `node`.
  */
 declare function defaultConnector(scriptPath: string): Connector;
@@ -65,6 +65,8 @@ declare class FifoUtf8NlineTransport {
   private constructor();
   private static openReader;
   private static openWriter;
+  static openReaderFd(readFd: FileHandle): FifoUtf8NlineTransport;
+  static openWriterFd(writeFd: FileHandle): FifoUtf8NlineTransport;
   static fromFds(readFd: FileHandle, writeFd: FileHandle): FifoUtf8NlineTransport;
   private attachWriter;
   /**
@@ -113,9 +115,8 @@ declare function isState(msg: Record<string, unknown>): msg is {
 };
 declare function isMsg(msg: Record<string, unknown>): msg is {
   $msg: {
-    type: string;
     fromName: string;
-    body: unknown;
+    body: Message;
   };
 };
 declare function isExit(msg: Record<string, unknown>): msg is {

package/dist/remote/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/remote/child.ts","../../src/remote/host.ts","../../src/remote/define.ts","../../src/remote/fifo.ts","../../src/remote/protocol.ts"],"mappings":";;;;iBAQgB,WACd,kBACA,2BACA;EACG;EAAkB;;iBASD,SAAS,MAAM,OAAO,cAAc,SAAS,eAAe,SAChF,IAAI,eAAe,MAAM,OAAO,OAAO,UACtC;;;UCNc,oBAAoB,OAAO;EAC1C;EACA,MAAM;EACN;;UAGe,YACf,iBACA,cAAc,UAAU,SACxB,eAAe,UAAU;WAEhB,OAAO;EAChB,SAAS;EACT,KAAK,KAAK;EACV,QAAQ;IAAU;IAAqB,OAAO;;EAC9C,UAAU,UAAU,KAAK;;;KAIf,UACV,iBACA,cAAc,UAAU,SACxB,eAAe,UAAU,YACtB,MAAM,wBAAwB,QAAQ,YAAY,OAAO,OAAO;iBAI/C,YACpB,iBACA,cAAc,UAAU,SACxB,eAAe,UAAU,SACzB,OAAO,yBACP,MAAM,oBAAoB,QAAQ,QAAQ,YAAY,OAAO,OAAO;;cA0HzD,eAAY,uBAZ+D;;cAe3E,gBAAa,uBAf8D;;;;;iBAqBxE,iBAAiB,qBAAqB;cAUzC,yBAAgB;;;UC1KZ;EACf;EACA,YAAY;;UAGG,kBACf,MACA,OACA,cAAc,SACd,eAAe,SACf,0BAA0B;EAE1B,OAAO,gBAAgB,MAAM,OAAO,OAAO,QAAQ;EACnD,iBAAiB;EACjB;;iBASc,kBACd,MACA,OACA,cAAc,SACd,eAAe,SACf,gBAAgB,eAChB,iBAAiB,eAAe,QAChC,mBAAmB,mBAEnB,OAAO,gBAAgB,MAAM,OAAO,OAAO,QAAQ,aACnD,aACA,OAAM,qBACL,kBAAkB,MAAM,OAAO,OAAO,QAAQ;;;cC9CpC;UACH;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UAED;iBA8Cc;iBAKA;SAKd,QAAQ,QAAQ,YAAY,SAAS,aAAa;UAMjD;;;;;;;;;SAYD,aACL,kBACA;IACG,WAAW,QAAQ;;;;;;;;;;;SAqBX,QAAQ,kBAAkB,oBAAoB,QAAQ;MAU/D;EAKJ,UAAU,UAAU;EASpB,mBAAmB;MAMf;MAIA,aAAa;EAIX,KAAK,eAAe;EAQpB,SAAS;UAMD;;;;cCrKH;iBAEG,OAAO,aAAa;iBAIpB,OAAO,eAAe;iBAMtB,QAAQ,KAAK,0BAA0B;EAAS;;iBAGhD,OAAO,KAAK,0BAA0B;EAAS,OAAO;;iBAGtD,QAAQ,KAAK,0BAA0B;EAAS,QAAQ;;iBAGxD,MAAM,KAAK,0BAA0B;EAAS;IAAQ;IAAc;IAAkB;;;iBAGtF,OAAO,KAAK,0BAA0B;EAAS;IAAS;IAAc"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/remote/child.ts","../../src/remote/host.ts","../../src/remote/define.ts","../../src/remote/fifo.ts","../../src/remote/protocol.ts"],"mappings":";;;;iBAQgB,WACd,kBACA,2BACA;EACG;EAAkB;;iBASD,SAAS,MAAM,OAAO,cAAc,SAAS,eAAe,SAChF,IAAI,eAAe,MAAM,OAAO,OAAO,UACtC;;;UCNc,oBAAoB,OAAO;EAC1C;EACA,MAAM;EACN;;UAGe,YACf,iBACA,cAAc,UAAU,SACxB,eAAe,UAAU;WAEhB,OAAO;EAChB,SAAS;EACT,KAAK,KAAK;EACV,QAAQ;IAAU;IAAqB,OAAO;;EAC9C,UAAU,UAAU,KAAK;;;KAIf,UACV,iBACA,cAAc,UAAU,SACxB,eAAe,UAAU,YACtB,MAAM,wBAAwB,QAAQ,YAAY,OAAO,OAAO;iBAI/C,YACpB,iBACA,cAAc,UAAU,SACxB,eAAe,UAAU,SACzB,OAAO,yBACP,MAAM,oBAAoB,QAAQ,QAAQ,YAAY,OAAO,OAAO;;cA0HzD,eAAY,uBAZ+D;;cAe3E,gBAAa,uBAf8D;;;;;iBAqBxE,iBAAiB,qBAAqB;cASzC,yBAAgB;;;UCzKZ;EACf;EACA,YAAY;;UAGG,kBACf,MACA,OACA,cAAc,SACd,eAAe,SACf,0BAA0B;EAE1B,OAAO,gBAAgB,MAAM,OAAO,OAAO,QAAQ;EACnD,iBAAiB;EACjB;;iBASc,kBACd,MACA,OACA,cAAc,SACd,eAAe,SACf,gBAAgB,eAChB,iBAAiB,eAAe,QAChC,mBAAmB,mBAEnB,OAAO,gBAAgB,MAAM,OAAO,OAAO,QAAQ,aACnD,aACA,OAAM,qBACL,kBAAkB,MAAM,OAAO,OAAO,QAAQ;;;cC9CpC;UACH;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UAED;iBA8Cc;iBAKA;SAKd,aAAa,QAAQ,aAAa;SAIlC,aAAa,SAAS,aAAa;SAInC,QAAQ,QAAQ,YAAY,SAAS,aAAa;UAMjD;;;;;;;;;SAYD,aACL,kBACA;IACG,WAAW,QAAQ;;;;;;;;;;;SAqBX,QAAQ,kBAAkB,oBAAoB,QAAQ;MAU/D;EAKJ,UAAU,UAAU;EASpB,mBAAmB;MAMf;MAIA,aAAa;EAIX,KAAK,eAAe;EAQpB,SAAS;UAMD;;;;cC5KH;iBAEG,OAAO,aAAa;iBAIpB,OAAO,eAAe;iBAMtB,QAAQ,KAAK,0BAA0B;EAAS;;iBAGhD,OAAO,KAAK,0BAA0B;EAAS,OAAO;;iBAGtD,QAAQ,KAAK,0BAA0B;EAAS,QAAQ;;iBAGxD,MACd,KAAK,0BACJ;EAAS;IAAQ;IAAkB,MAAM;;;iBAG5B,OACd,KAAK,0BACJ;EAAS;IAAS;IAAc"}

package/dist/remote/index.js

@@ -13,6 +13,7 @@ var FifoUtf8NlineTransport = class FifoUtf8NlineTransport {
 	constructor(opts) {
 		this.pvtOnMessage = null;
 		this.closed = false;
+		this.closingPromise = null;
 		this.pvtError = null;
 		this.pvtWriter = null;
 		this.readFd = opts.readFd ?? null;
@@ -42,7 +43,7 @@ var FifoUtf8NlineTransport = class FifoUtf8NlineTransport {
 			this.ws = createWriteStream("", {
 				fd: this.writeFd.fd,
 				encoding: "utf-8",
-				autoclose: false
+				autoClose: false
 			});
 			this.ws.on("error", (err) => {
 				this.pvtError = err;
@@ -58,6 +59,12 @@ var FifoUtf8NlineTransport = class FifoUtf8NlineTransport {
 		const writeFd = await open(path, "w");
 		return new FifoUtf8NlineTransport({ writeFd });
 	}
+	static openReaderFd(readFd) {
+		return new FifoUtf8NlineTransport({ readFd });
+	}
+	static openWriterFd(writeFd) {
+		return new FifoUtf8NlineTransport({ writeFd });
+	}
 	static fromFds(readFd, writeFd) {
 		return new FifoUtf8NlineTransport({
 			readFd,
@@ -124,7 +131,7 @@ var FifoUtf8NlineTransport = class FifoUtf8NlineTransport {
 		if (this.closed) throw new Error("FifoUtf8NlineTransport: closed");
 		if (this.writeFd === null) throw new Error("FifoUtf8NlineTransport: not a writer");
 		if (!line.endsWith("\n")) line += "\n";
-		await this.ws.write(line);
+		await this.ws?.write(line);
 	}
 	async close() {
 		this.closingPromise = this.closingPromise || this.pvtClose();
@@ -144,7 +151,7 @@ var FifoUtf8NlineTransport = class FifoUtf8NlineTransport {
 		if (this.ws) {
 			await new Promise(async (resolve) => {
 				try {
-					await this.ws.end("", resolve);
+					await this.ws?.end("", resolve);
 				} catch {
 					resolve();
 				}
@@ -389,17 +396,15 @@ function scriptConnector(runner, runnerArgs) {
 	};
 }
 /** Spawn via `bun run <script>`. */
-const bunConnector = scriptConnector("bun", ["run"]);
+const bunConnector = scriptConnector("bun", []);
 /** Spawn via `node <script>`. */
 const nodeConnector = scriptConnector("node", []);
 /**
-* Auto-detect: prefers `bun run` if the script is a .ts file and bun is
+* Auto-detect: prefers `bun run` if bun is
 * the current runtime, otherwise falls back to `node`.
 */
 function defaultConnector(scriptPath) {
-	const isBun = typeof globalThis.Bun !== "undefined";
-	const isTs = scriptPath.endsWith(".ts");
-	if (isBun && isTs) return bunConnector(scriptPath);
+	if (typeof globalThis.Bun !== "undefined") return bunConnector(scriptPath);
 	return nodeConnector(scriptPath);
 }
 const commandConnector = spawnRemote;

package/dist/remote/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/remote/fifo.ts","../../src/remote/protocol.ts","../../src/remote/child.ts","../../src/remote/host.ts","../../src/remote/define.ts"],"sourcesContent":["// ── FIFO transport ─────────────────────────────────────────────────────────\n//\n// Newline-delimited UTF-8 over named fifos.  Strict handler lifecycle:\n// onMessage() throws if a handler is already set; call removeHandler() first.\n\nimport { open, type FileHandle } from \"node:fs/promises\";\nimport { createReadStream, createWriteStream, type ReadStream, type WriteStream } from \"node:fs\";\nimport * as readline from \"node:readline\";\n\nexport class FifoUtf8NlineTransport {\n  private readFd: FileHandle | null;\n  private writeFd: FileHandle | null;\n  private rl: readline.Interface | null;\n  private rs: ReadStream | null;\n  private ws: WriteSteeam | null;\n  private pvtOnMessage: ((line: string) => void) | null = null;\n  private closed = false;\n  private closingPromise: Promise<void> | null;\n  private pvtError: Error | null = null;\n  private pvtWriter: FifoUtf8NlineTransport | null = null;\n\n  private constructor(opts: { readFd?: FileHandle; writeFd?: FileHandle }) {\n    this.readFd = opts.readFd ?? null;\n    this.writeFd = opts.writeFd ?? null;\n\n    if (this.readFd) {\n      this.rs = createReadStream(\"\", {\n        fd: this.readFd.fd,\n        encoding: \"utf-8\",\n        autoClose: false,\n      });\n      this.rl = readline.createInterface({ input: this.rs });\n\n      this.rl.on(\"line\", (line) => {\n        if (this.pvtOnMessage && !this.closed) this.pvtOnMessage(line);\n      });\n\n      this.rl.on(\"close\", () => {\n        this.close();\n      });\n\n      this.rs.on(\"error\", (err: Error) => {\n        this.pvtError = err;\n        this.close();\n      });\n    } else {\n      this.rs = null;\n      this.rl = null;\n    }\n\n    if (this.writeFd) {\n      this.ws = createWriteStream(\"\", {\n        fd: this.writeFd.fd,\n        encoding: \"utf-8\",\n        autoclose: false,\n      });\n      this.ws.on(\"error\", (err: Error) => {\n        this.pvtError = err;\n        this.close();\n      });\n    } else {\n      this.ws = null;\n    }\n  }\n\n  // ── factories ──────────────────────────────────────────────────────────\n\n  private static async openReader(path: string): Promise<FifoUtf8NlineTransport> {\n    const readFd = await open(path, \"r\");\n    return new FifoUtf8NlineTransport({ readFd });\n  }\n\n  private static async openWriter(path: string): Promise<FifoUtf8NlineTransport> {\n    const writeFd = await open(path, \"w\");\n    return new FifoUtf8NlineTransport({ writeFd });\n  }\n\n  static fromFds(readFd: FileHandle, writeFd: FileHandle): FifoUtf8NlineTransport {\n    return new FifoUtf8NlineTransport({ readFd, writeFd });\n  }\n\n  // ── bidirectional connection ───────────────────────────────────────────\n\n  private attachWriter(w: FifoUtf8NlineTransport): void {\n    this.pvtWriter = w;\n  }\n\n  /**\n   * Start opening a bidirectional connection.  Opens readPath for reading\n   * in the background, returns a promise.  The caller should do whatever\n   * setup is needed to unblock the read (e.g. spawn a process that opens\n   * readPath for writing), then await the returned transport.\n   *\n   * Once the read completes, writePath is opened for writing automatically.\n   */\n  static beginConnect(\n    readPath: string,\n    writePath: string,\n  ): { transport: Promise<FifoUtf8NlineTransport> } {\n    const readerPromise = FifoUtf8NlineTransport.openReader(readPath);\n\n    const transport = readerPromise.then(async (reader) => {\n      const writer = await FifoUtf8NlineTransport.openWriter(writePath);\n      reader.attachWriter(writer);\n      return reader;\n    });\n\n    return { transport };\n  }\n\n  /**\n   * Open a bidirectional connection.  Opens writePath for writing first\n   * (unblocking the peer's read), starts reading readPath in the\n   * background, then awaits both.\n   *\n   * Use this when you are the side that responds to the peer's beginConnect\n   * (i.e. you don't need to interleave any setup between the read and write\n   * opens).\n   */\n  static async connect(readPath: string, writePath: string): Promise<FifoUtf8NlineTransport> {\n    const readerPromise = FifoUtf8NlineTransport.openReader(readPath);\n    const writer = await FifoUtf8NlineTransport.openWriter(writePath);\n    const reader = await readerPromise;\n    reader.attachWriter(writer);\n    return reader;\n  }\n\n  // ── public API ─────────────────────────────────────────────────────────\n\n  get canSend(): boolean {\n    if (this.pvtWriter) return this.pvtWriter.canSend;\n    return this.writeFd !== null && !this.closed;\n  }\n\n  onMessage(handler: (line: string) => void): void {\n    if (this.closed) throw new Error(\"FifoUtf8NlineTransport: closed\");\n    if (this.readFd === null) throw new Error(\"FifoUtf8NlineTransport: not a reader\");\n    if (this.pvtOnMessage !== null) {\n      throw new Error(\"FifoUtf8NlineTransport: handler already set — call removeHandler() first\");\n    }\n    this.pvtOnMessage = handler;\n  }\n\n  removeHandler(): ((line: string) => void) | null {\n    const prev = this.pvtOnMessage;\n    this.pvtOnMessage = null;\n    return prev;\n  }\n\n  get hasHandler(): boolean {\n    return this.pvtOnMessage !== null;\n  }\n\n  get lastError(): Error | null {\n    return this.pvtError;\n  }\n\n  async send(line: string): Promise<void> {\n    if (this.pvtWriter) return this.pvtWriter.send(line);\n    if (this.closed) throw new Error(\"FifoUtf8NlineTransport: closed\");\n    if (this.writeFd === null) throw new Error(\"FifoUtf8NlineTransport: not a writer\");\n    if (!line.endsWith(\"\\n\")) line += \"\\n\";\n    await this.ws.write(line);\n  }\n\n  async close(): Promise<void> {\n    this.closingPromise = this.closingPromise || this.pvtClose();\n    await this.closingPromise;\n    this.closed = true;\n  }\n\n  private async pvtClose(): Promise<void> {\n    // tranfser control back to caller\n    // so they can capture the promise reference\n    // and prevent reentry\n    await Promise.resolve();\n\n    if (this.rl) {\n      this.rl.close();\n      this.rl = null;\n    }\n    if (this.rs) {\n      this.rs.destroy();\n      this.rs = null;\n    }\n    if (this.ws) {\n      await new Promise(async (resolve) => {\n        try {\n          await this.ws.end(\"\", resolve);\n        } catch {\n          resolve();\n        }\n      });\n      this.ws = null;\n    }\n\n    if (this.readFd) {\n      try {\n        await this.readFd.close();\n      } catch {}\n      this.readFd = null;\n    }\n    if (this.writeFd) {\n      try {\n        await this.writeFd.close();\n      } catch {}\n      this.writeFd = null;\n    }\n    if (this.pvtWriter) {\n      await this.pvtWriter.close();\n    }\n  }\n}\n","// ── Wire protocol ──────────────────────────────────────────────────────────\n//\n// NDJSON wire protocol: one JSON object per line.\n//   child → host:  $proto, $state, $msg, $exit\n//   host → child:  $init, $msg\n\nexport const PROTO_VERSION = \"ndjson.v1\";\n\nexport function encode(key: string, value: unknown): string {\n  return JSON.stringify({ [key]: value }) + \"\\n\";\n}\n\nexport function decode(line: string): Record<string, unknown> {\n  return JSON.parse(line);\n}\n\n// ── type guards ──────────────────────────────────────────────────────────\n\nexport function isProto(msg: Record<string, unknown>): msg is { $proto: string } {\n  return \"$proto\" in msg;\n}\nexport function isInit(msg: Record<string, unknown>): msg is { $init: Record<string, unknown> } {\n  return \"$init\" in msg;\n}\nexport function isState(msg: Record<string, unknown>): msg is { $state: Record<string, unknown> } {\n  return \"$state\" in msg;\n}\nexport function isMsg(msg: Record<string, unknown>): msg is { $msg: { type: string; fromName: string; body: unknown } } {\n  return \"$msg\" in msg;\n}\nexport function isExit(msg: Record<string, unknown>): msg is { $exit: { code: number; state: unknown } } {\n  return \"$exit\" in msg;\n}\n","// ── Child-side adapter ─────────────────────────────────────────────────────\n//\n// Wraps a posipaki actor in a CLI process that speaks the wire protocol over\n// two unidirectional named fifos.\n\nimport type { AsyncProcessFn, Message } from \"../types.js\";\nimport { FifoUtf8NlineTransport } from \"./fifo.js\";\n\nexport function makeSender(\n  fromName: string,\n  parentName: string | null,\n  parentId: symbol | null,\n): { fromName: string; fromId: symbol } {\n  if (parentId && fromName === parentName) {\n    return { fromName, fromId: parentId };\n  }\n  return { fromName, fromId: Symbol() };\n}\nimport { encode, decode, isInit, isMsg, PROTO_VERSION } from \"./protocol.js\";\nimport { spawnAsync } from \"../index.js\";\n\nexport async function runChild<Args, State, InMsg extends Message, OutMsg extends Message>(\n  fn: AsyncProcessFn<Args, State, InMsg, OutMsg>,\n): Promise<void> {\n  const fifoIn = process.argv.find((a) => a.startsWith(\"--fifo-in=\"))?.slice(\"--fifo-in=\".length);\n  const fifoOut = process.argv\n    .find((a) => a.startsWith(\"--fifo-out=\"))\n    ?.slice(\"--fifo-out=\".length);\n\n  if (!fifoIn || !fifoOut) {\n    console.error(\"child: --fifo-in=<path> and --fifo-out=<path> required\");\n    process.exit(1);\n  }\n\n  const transport = await FifoUtf8NlineTransport.connect(fifoOut, fifoIn);\n\n  // 1. Send protocol version\n  await transport.send(encode(\"$proto\", PROTO_VERSION));\n\n  // 2. Wait for $init\n  const initMsg = await new Promise<Record<string, unknown>>((resolve) => {\n    transport.onMessage((line) => {\n      const msg = decode(line);\n      if (isInit(msg)) resolve(msg.$init);\n    });\n  });\n  transport.removeHandler();\n\n  const parentName = (initMsg.parentName as string) ?? null;\n  const parentIdName = (initMsg.parentIdName as string) ?? null;\n  const parentId = parentIdName ? Symbol.for(parentIdName) : null;\n  const { parentName: _pn, parentIdName: _pid, ...initArgs } = initMsg;\n\n  const wrappedFn: typeof fn = async function* (ctx, args) {\n    (ctx as Record<string, unknown>).parentName = parentName;\n    (ctx as Record<string, unknown>).parentId = parentId;\n    return yield* fn(ctx, args);\n  };\n\n  const proc = spawnAsync(wrappedFn, \"remote\")(initArgs as unknown as Args);\n  proc.subscribe(\"message\", async (msg, sender) => {\n    try {\n      const encodedMsg = encode(\"$msg\", {\n        fromName: sender.fromName,\n        body: msg,\n      });\n      await transport.send(encodedMsg);\n    } catch (e) {\n      console.error(\"Error sending out the message\");\n    }\n  });\n\n  proc.subscribe(\"state\", async () => {\n    try {\n      const encodedState = encode(\"$state\", proc.state as Record<string, unknown>);\n      await transport.send(encodedState);\n    } catch (e) {\n      console.error(\"Error sending out the message\", e);\n    }\n  });\n\n  await proc.ready();\n\n  await transport.send(encode(\"$state\", proc.state as Record<string, unknown>));\n\n  // 6. Forward incoming messages to the actor\n  transport.onMessage((line) => {\n    const msg = decode(line);\n    if (isMsg(msg)) {\n      const { fromName, body } = msg.$msg;\n      proc.send(body as InMsg, { fromName, fromId: Symbol() });\n    }\n  });\n\n  // 7. On actor exit, send $exit\n  const shutdown = async (code: number) => {\n    await transport.send(encode(\"$exit\", { code, state: proc.state }));\n    await transport.close();\n    process.exit(code);\n  };\n  proc.wait().then(\n    () => shutdown(0),\n    (err: unknown) => {\n      console.error(\"child actor error:\", err);\n      shutdown(1);\n    },\n  );\n}\n","// ── Host-side adapter ──────────────────────────────────────────────────────\n//\n// commandConnector: spawns a child process and bridges the wire protocol.\n// Connector wrappers (bunConnector, nodeConnector, defaultConnector) produce\n// the command array from a script path.\n\nimport { spawn, execSync, type ChildProcess } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { unlink } from \"node:fs/promises\";\nimport { FifoUtf8NlineTransport } from \"./fifo.js\";\nimport { encode, decode, isProto, isState, isMsg, isExit, PROTO_VERSION } from \"./protocol.js\";\nimport type { Message } from \"../types.js\";\n\n// ── types ──────────────────────────────────────────────────────────────────\n\nexport interface CommandSpawnOptions<Args = Record<string, unknown>> {\n  command: string[];\n  args: Args;\n  parentName?: string;\n}\n\nexport interface RemoteProxy<\n  State = unknown,\n  InMsg extends Message = Message,\n  OutMsg extends Message = Message,\n> {\n  readonly state: State;\n  ready(): Promise<void>;\n  send(msg: InMsg): void;\n  wait(): Promise<{ code: number | null; state: State }>;\n  onMessage(handler: (msg: OutMsg) => void): void;\n}\n\n/** A connector takes a command and returns a RemoteProxy. */\nexport type Connector<\n  State = unknown,\n  InMsg extends Message = Message,\n  OutMsg extends Message = Message,\n> = (opts: CommandSpawnOptions) => Promise<RemoteProxy<State, InMsg, OutMsg>>;\n\n// ── commandConnector ───────────────────────────────────────────────────────\n\nexport async function spawnRemote<\n  State = unknown,\n  InMsg extends Message = Message,\n  OutMsg extends Message = Message,\n  Args = Record<string, unknown>,\n>(opts: CommandSpawnOptions<Args>): Promise<RemoteProxy<State, InMsg, OutMsg>> {\n  const basePath = join(tmpdir(), `posipaki-${randomUUID()}`);\n\n  execSync(`mkfifo \"${basePath}.in\"`);\n  execSync(`mkfifo \"${basePath}.out\"`);\n\n  const setup = FifoUtf8NlineTransport.beginConnect(basePath + \".in\", basePath + \".out\");\n\n  const childCmd = [\n    ...opts.command,\n    `--fifo-in=${basePath + \".in\"}`,\n    `--fifo-out=${basePath + \".out\"}`,\n  ];\n  const childProc: ChildProcess = spawn(childCmd[0], childCmd.slice(1), {\n    cwd: process.cwd(),\n    stdio: [\"inherit\", \"inherit\", \"inherit\"],\n  });\n\n  const transport = await setup.transport;\n\n  // ── handshake ───────────────────────────────────────────────────────\n  const protoLine = await new Promise<string>((resolve) => {\n    transport.onMessage((line) => resolve(line));\n  });\n  const protoMsg = decode(protoLine);\n  if (!isProto(protoMsg) || protoMsg.$proto !== PROTO_VERSION) {\n    throw new Error(`unsupported protocol: ${protoLine.slice(0, 50)}`);\n  }\n  transport.removeHandler();\n\n  await transport.send(\n    encode(\"$init\", {\n      ...(opts.args as Record<string, unknown>),\n      parentName: opts.parentName ?? \"host\",\n      parentIdName: opts.parentName ?? \"host\",\n    }),\n  );\n\n  let currentState: Record<string, unknown> = {};\n  await new Promise<void>((resolve) => {\n    transport.onMessage((line) => {\n      const msg = decode(line);\n      if (isState(msg)) {\n        Object.assign(currentState, msg.$state as Record<string, unknown>);\n        resolve();\n      }\n    });\n  });\n  transport.removeHandler();\n\n  // ── persistent handler ──────────────────────────────────────────────\n  let msgHandler: ((msg: OutMsg) => void) | null = null;\n  let exitResolver: ((value: { code: number | null; state: State }) => void) | null = null;\n  const exitPromise = new Promise<{ code: number | null; state: State }>((resolve) => {\n    exitResolver = resolve;\n  });\n\n  transport.onMessage((line) => {\n    const msg = decode(line);\n    if (isState(msg)) {\n      Object.assign(currentState, msg.$state as Record<string, unknown>);\n    } else if (isMsg(msg)) {\n      msgHandler?.(msg.$msg.body as OutMsg);\n    } else if (isExit(msg)) {\n      if (exitResolver) {\n        exitResolver({ code: msg.$exit.code, state: msg.$exit.state as State });\n        exitResolver = null;\n      }\n      cleanup();\n    }\n  });\n\n  // ── cleanup ─────────────────────────────────────────────────────────\n  let cleaned = false;\n  const cleanup = () => {\n    if (cleaned) return;\n    cleaned = true;\n    transport.close();\n    unlink(basePath + \".in\").catch(() => {});\n    unlink(basePath + \".out\").catch(() => {});\n  };\n\n  childProc.on(\"exit\", (code) => {\n    if (exitResolver) {\n      exitResolver({ code, state: currentState as State });\n      exitResolver = null;\n    }\n    cleanup();\n  });\n\n  return {\n    get state(): State {\n      return currentState as State;\n    },\n    async ready() {},\n    send(msg: InMsg) {\n      const from = opts.parentName ?? \"host\";\n      transport.send(encode(\"$msg\", { fromName: from, body: msg }));\n    },\n    async wait() {\n      return exitPromise;\n    },\n    onMessage(handler: (msg: OutMsg) => void) {\n      msgHandler = handler;\n    },\n  };\n}\n\n// ── connector wrappers ─────────────────────────────────────────────────────\n\nfunction scriptConnector(runner: string, runnerArgs: string[]): (scriptPath: string) => Connector {\n  return (scriptPath: string) => {\n    return ((opts: CommandSpawnOptions) => {\n      return commandConnector({\n        ...opts,\n        command: [runner, ...runnerArgs, scriptPath, ...opts.command],\n      });\n    }) as Connector;\n  };\n}\n\n/** Spawn via `bun run <script>`. */\nexport const bunConnector = scriptConnector(\"bun\", [\"run\"]);\n\n/** Spawn via `node <script>`. */\nexport const nodeConnector = scriptConnector(\"node\", []);\n\n/**\n * Auto-detect: prefers `bun run` if the script is a .ts file and bun is\n * the current runtime, otherwise falls back to `node`.\n */\nexport function defaultConnector(scriptPath: string): Connector {\n  // Check if we're running under bun\n  const isBun = typeof (globalThis as any).Bun !== \"undefined\";\n  const isTs = scriptPath.endsWith(\".ts\");\n  if (isBun && isTs) return bunConnector(scriptPath);\n  return nodeConnector(scriptPath);\n}\n\n// ── alias ───────────────────────────────────────────────────────────────────\n\nexport const commandConnector = spawnRemote;\n","// ── defineRemoteActor ──────────────────────────────────────────────────────\n//\n// Wraps an ActorDefinition so that when spawned, it runs in a child process\n// over two named fifos. Returns { actor, runRemoteRoot, isRemoteRoot }.\n//\n// Uses defineActor's setup hook to spawn the remote child before the first\n// yield, so proc.ready() shows the live remote state — same as local spawn.\n\nimport { fileURLToPath } from \"node:url\";\nimport { createHash } from \"node:crypto\";\nimport type { Message } from \"../types.js\";\nimport type { HandlerOptions, MethodOptions, ReflectionOptions } from \"../actor-types.js\";\nimport { defineActor } from \"../define-actor.js\";\nimport { stopPropagation } from \"../hooks.js\";\nimport type { HookResult } from \"../hooks.js\";\nimport { runChild } from \"./child.js\";\nimport { type Connector, defaultConnector } from \"./host.js\";\nimport type { RemoteProxy } from \"./host.js\";\nimport type { ActorDefinition } from \"../actor-types.js\";\n\nexport interface RemoteActorOptions {\n  manual?: boolean;\n  connector?: Connector;\n}\n\nexport interface RemoteActorBundle<\n  Args,\n  State,\n  InMsg extends Message,\n  OutMsg extends Message,\n  ReflectionMethods extends ReflectionOptions,\n> {\n  actor: ActorDefinition<Args, State, InMsg, OutMsg, ReflectionMethods>;\n  runRemoteRoot(): Promise<void>;\n  isRemoteRoot: boolean;\n}\n\nfunction pathHash(path: string): string {\n  return createHash(\"sha256\").update(path).digest(\"hex\").slice(0, 12);\n}\n\nconst MARKER_PREFIX = \"--remote=\";\n\nexport function defineRemoteActor<\n  Args,\n  State,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  Reflection extends ReflectionOptions,\n>(\n  actor: ActorDefinition<Args, State, InMsg, OutMsg, Reflection>,\n  url: string,\n  opts: RemoteActorOptions = {},\n): RemoteActorBundle<Args, State, InMsg, OutMsg, Reflection> {\n  const scriptPath = fileURLToPath(url);\n  const marker = `${MARKER_PREFIX}${pathHash(scriptPath)}`;\n  const isRemoteRoot = !opts.manual && process.argv.includes(marker);\n\n  if (isRemoteRoot) {\n    runChild(actor.fn);\n  }\n\n  const proxyDef = defineActor<\n    Args,\n    { public: State; private: { remote: RemoteProxy<State, InMsg, OutMsg> } },\n    InMsg,\n    OutMsg,\n    Methods,\n    Handlers,\n    Reflection\n  >({\n    name: actor.name ?? \"actor\",\n    inMessages: actor.inMessages,\n    outMessages: actor.outMessages,\n    handlers: {} as unknown as Handlers,\n    async setup(args: Args) {\n      const connect = opts.connector ?? defaultConnector(scriptPath);\n      const remote = (await connect({\n        command: [marker],\n        args: args as Record<string, unknown>,\n      })) as RemoteProxy<State, InMsg, OutMsg>;\n      remote.onMessage((msg: OutMsg) => {\n        this.emit(msg);\n      });\n      return {\n        public: remote.state,\n        private: { remote },\n      };\n    },\n    async onMessage(msg: InMsg): Promise<HookResult> {\n      this.state.private.remote?.send(msg);\n      return stopPropagation();\n    },\n    async onStopRequested() {\n      if (this.state.private.remote) {\n        this.state.private.remote.send({ type: \"STOP\" } as InMsg);\n        await this.state.private.remote.wait();\n      }\n      this.agreeToStop();\n    },\n  });\n\n  return {\n    actor: proxyDef as ActorDefinition<Args, State, InMsg, OutMsg, Reflection>,\n    runRemoteRoot() {\n      return runChild(actor.fn);\n    },\n    isRemoteRoot,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/remote/fifo.ts","../../src/remote/protocol.ts","../../src/remote/child.ts","../../src/remote/host.ts","../../src/remote/define.ts"],"sourcesContent":["// ── FIFO transport ─────────────────────────────────────────────────────────\n//\n// Newline-delimited UTF-8 over named fifos.  Strict handler lifecycle:\n// onMessage() throws if a handler is already set; call removeHandler() first.\n\nimport { open, type FileHandle } from \"node:fs/promises\";\nimport { createReadStream, createWriteStream, type ReadStream, type WriteStream } from \"node:fs\";\nimport * as readline from \"node:readline\";\n\nexport class FifoUtf8NlineTransport {\n  private readFd: FileHandle | null;\n  private writeFd: FileHandle | null;\n  private rl: readline.Interface | null;\n  private rs: ReadStream | null;\n  private ws: WriteStream | null;\n  private pvtOnMessage: ((line: string) => void) | null = null;\n  private closed = false;\n  private closingPromise: Promise<void> | null = null;\n  private pvtError: Error | null = null;\n  private pvtWriter: FifoUtf8NlineTransport | null = null;\n\n  private constructor(opts: { readFd?: FileHandle; writeFd?: FileHandle }) {\n    this.readFd = opts.readFd ?? null;\n    this.writeFd = opts.writeFd ?? null;\n\n    if (this.readFd) {\n      this.rs = createReadStream(\"\", {\n        fd: this.readFd.fd,\n        encoding: \"utf-8\",\n        autoClose: false,\n      });\n      this.rl = readline.createInterface({ input: this.rs });\n\n      this.rl.on(\"line\", (line) => {\n        if (this.pvtOnMessage && !this.closed) this.pvtOnMessage(line);\n      });\n\n      this.rl.on(\"close\", () => {\n        this.close();\n      });\n\n      this.rs.on(\"error\", (err: Error) => {\n        this.pvtError = err;\n        this.close();\n      });\n    } else {\n      this.rs = null;\n      this.rl = null;\n    }\n\n    if (this.writeFd) {\n      this.ws = createWriteStream(\"\", {\n        fd: this.writeFd.fd,\n        encoding: \"utf-8\",\n        autoClose: false,\n      });\n      this.ws.on(\"error\", (err: Error) => {\n        this.pvtError = err;\n        this.close();\n      });\n    } else {\n      this.ws = null;\n    }\n  }\n\n  // ── factories ──────────────────────────────────────────────────────────\n\n  private static async openReader(path: string): Promise<FifoUtf8NlineTransport> {\n    const readFd = await open(path, \"r\");\n    return new FifoUtf8NlineTransport({ readFd });\n  }\n\n  private static async openWriter(path: string): Promise<FifoUtf8NlineTransport> {\n    const writeFd = await open(path, \"w\");\n    return new FifoUtf8NlineTransport({ writeFd });\n  }\n\n  static openReaderFd(readFd: FileHandle): FifoUtf8NlineTransport {\n    return new FifoUtf8NlineTransport({ readFd });\n  }\n\n  static openWriterFd(writeFd: FileHandle): FifoUtf8NlineTransport {\n    return new FifoUtf8NlineTransport({ writeFd });\n  }\n\n  static fromFds(readFd: FileHandle, writeFd: FileHandle): FifoUtf8NlineTransport {\n    return new FifoUtf8NlineTransport({ readFd, writeFd });\n  }\n\n  // ── bidirectional connection ───────────────────────────────────────────\n\n  private attachWriter(w: FifoUtf8NlineTransport): void {\n    this.pvtWriter = w;\n  }\n\n  /**\n   * Start opening a bidirectional connection.  Opens readPath for reading\n   * in the background, returns a promise.  The caller should do whatever\n   * setup is needed to unblock the read (e.g. spawn a process that opens\n   * readPath for writing), then await the returned transport.\n   *\n   * Once the read completes, writePath is opened for writing automatically.\n   */\n  static beginConnect(\n    readPath: string,\n    writePath: string,\n  ): { transport: Promise<FifoUtf8NlineTransport> } {\n    const readerPromise = FifoUtf8NlineTransport.openReader(readPath);\n\n    const transport = readerPromise.then(async (reader) => {\n      const writer = await FifoUtf8NlineTransport.openWriter(writePath);\n      reader.attachWriter(writer);\n      return reader;\n    });\n\n    return { transport };\n  }\n\n  /**\n   * Open a bidirectional connection.  Opens writePath for writing first\n   * (unblocking the peer's read), starts reading readPath in the\n   * background, then awaits both.\n   *\n   * Use this when you are the side that responds to the peer's beginConnect\n   * (i.e. you don't need to interleave any setup between the read and write\n   * opens).\n   */\n  static async connect(readPath: string, writePath: string): Promise<FifoUtf8NlineTransport> {\n    const readerPromise = FifoUtf8NlineTransport.openReader(readPath);\n    const writer = await FifoUtf8NlineTransport.openWriter(writePath);\n    const reader = await readerPromise;\n    reader.attachWriter(writer);\n    return reader;\n  }\n\n  // ── public API ─────────────────────────────────────────────────────────\n\n  get canSend(): boolean {\n    if (this.pvtWriter) return this.pvtWriter.canSend;\n    return this.writeFd !== null && !this.closed;\n  }\n\n  onMessage(handler: (line: string) => void): void {\n    if (this.closed) throw new Error(\"FifoUtf8NlineTransport: closed\");\n    if (this.readFd === null) throw new Error(\"FifoUtf8NlineTransport: not a reader\");\n    if (this.pvtOnMessage !== null) {\n      throw new Error(\"FifoUtf8NlineTransport: handler already set — call removeHandler() first\");\n    }\n    this.pvtOnMessage = handler;\n  }\n\n  removeHandler(): ((line: string) => void) | null {\n    const prev = this.pvtOnMessage;\n    this.pvtOnMessage = null;\n    return prev;\n  }\n\n  get hasHandler(): boolean {\n    return this.pvtOnMessage !== null;\n  }\n\n  get lastError(): Error | null {\n    return this.pvtError;\n  }\n\n  async send(line: string): Promise<void> {\n    if (this.pvtWriter) return this.pvtWriter.send(line);\n    if (this.closed) throw new Error(\"FifoUtf8NlineTransport: closed\");\n    if (this.writeFd === null) throw new Error(\"FifoUtf8NlineTransport: not a writer\");\n    if (!line.endsWith(\"\\n\")) line += \"\\n\";\n    await this.ws?.write(line);\n  }\n\n  async close(): Promise<void> {\n    this.closingPromise = this.closingPromise || this.pvtClose();\n    await this.closingPromise;\n    this.closed = true;\n  }\n\n  private async pvtClose(): Promise<void> {\n    // tranfser control back to caller\n    // so they can capture the promise reference\n    // and prevent reentry\n    await Promise.resolve();\n\n    if (this.rl) {\n      this.rl.close();\n      this.rl = null;\n    }\n    if (this.rs) {\n      this.rs.destroy();\n      this.rs = null;\n    }\n    if (this.ws) {\n      await new Promise<void>(async (resolve) => {\n        try {\n          await this.ws?.end(\"\", resolve);\n        } catch {\n          resolve();\n        }\n      });\n      this.ws = null;\n    }\n\n    if (this.readFd) {\n      try {\n        await this.readFd.close();\n      } catch {}\n      this.readFd = null;\n    }\n    if (this.writeFd) {\n      try {\n        await this.writeFd.close();\n      } catch {}\n      this.writeFd = null;\n    }\n    if (this.pvtWriter) {\n      await this.pvtWriter.close();\n    }\n  }\n}\n","// ── Wire protocol ──────────────────────────────────────────────────────────\n//\n// NDJSON wire protocol: one JSON object per line.\n//   child → host:  $proto, $state, $msg, $exit\n//   host → child:  $init, $msg\nimport type { Message } from \"../types.js\";\n\nexport const PROTO_VERSION = \"ndjson.v1\";\n\nexport function encode(key: string, value: unknown): string {\n  return JSON.stringify({ [key]: value }) + \"\\n\";\n}\n\nexport function decode(line: string): Record<string, unknown> {\n  return JSON.parse(line);\n}\n\n// ── type guards ──────────────────────────────────────────────────────────\n\nexport function isProto(msg: Record<string, unknown>): msg is { $proto: string } {\n  return \"$proto\" in msg;\n}\nexport function isInit(msg: Record<string, unknown>): msg is { $init: Record<string, unknown> } {\n  return \"$init\" in msg;\n}\nexport function isState(msg: Record<string, unknown>): msg is { $state: Record<string, unknown> } {\n  return \"$state\" in msg;\n}\nexport function isMsg(\n  msg: Record<string, unknown>,\n): msg is { $msg: { fromName: string; body: Message } } {\n  return \"$msg\" in msg;\n}\nexport function isExit(\n  msg: Record<string, unknown>,\n): msg is { $exit: { code: number; state: unknown } } {\n  return \"$exit\" in msg;\n}\n","// ── Child-side adapter ─────────────────────────────────────────────────────\n//\n// Wraps a posipaki actor in a CLI process that speaks the wire protocol over\n// two unidirectional named fifos.\n\nimport type { AsyncProcessFn, Message } from \"../types.js\";\nimport { FifoUtf8NlineTransport } from \"./fifo.js\";\n\nexport function makeSender(\n  fromName: string,\n  parentName: string | null,\n  parentId: symbol | null,\n): { fromName: string; fromId: symbol } {\n  if (parentId && fromName === parentName) {\n    return { fromName, fromId: parentId };\n  }\n  return { fromName, fromId: Symbol() };\n}\nimport { encode, decode, isInit, isMsg, PROTO_VERSION } from \"./protocol.js\";\nimport { spawnAsync } from \"../index.js\";\n\nexport async function runChild<Args, State, InMsg extends Message, OutMsg extends Message>(\n  fn: AsyncProcessFn<Args, State, InMsg, OutMsg>,\n): Promise<void> {\n  const fifoIn = process.argv.find((a) => a.startsWith(\"--fifo-in=\"))?.slice(\"--fifo-in=\".length);\n  const fifoOut = process.argv\n    .find((a) => a.startsWith(\"--fifo-out=\"))\n    ?.slice(\"--fifo-out=\".length);\n\n  if (!fifoIn || !fifoOut) {\n    console.error(\"child: --fifo-in=<path> and --fifo-out=<path> required\");\n    process.exit(1);\n  }\n\n  const transport = await FifoUtf8NlineTransport.connect(fifoOut, fifoIn);\n\n  // 1. Send protocol version\n  await transport.send(encode(\"$proto\", PROTO_VERSION));\n\n  // 2. Wait for $init\n  const initMsg = await new Promise<Record<string, unknown>>((resolve) => {\n    transport.onMessage((line) => {\n      const msg = decode(line);\n      if (isInit(msg)) resolve(msg.$init);\n    });\n  });\n  transport.removeHandler();\n\n  const parentName = (initMsg.parentName as string) ?? null;\n  const parentIdName = (initMsg.parentIdName as string) ?? null;\n  const parentId = parentIdName ? Symbol.for(parentIdName) : null;\n  const { parentName: _pn, parentIdName: _pid, ...initArgs } = initMsg;\n\n  const wrappedFn: typeof fn = async function* (ctx, args) {\n    (ctx as Record<string, unknown>).parentName = parentName;\n    (ctx as Record<string, unknown>).parentId = parentId;\n    return yield* fn(ctx, args);\n  };\n\n  const proc = spawnAsync(wrappedFn, \"remote\")(initArgs as unknown as Args);\n  proc.subscribe(\"message\", async (msg, sender) => {\n    try {\n      const encodedMsg = encode(\"$msg\", {\n        fromName: sender.fromName,\n        body: msg,\n      });\n      await transport.send(encodedMsg);\n    } catch (e) {\n      console.error(\"Error sending out the message\");\n    }\n  });\n\n  proc.subscribe(\"state\", async () => {\n    try {\n      const encodedState = encode(\"$state\", proc.state as Record<string, unknown>);\n      await transport.send(encodedState);\n    } catch (e) {\n      console.error(\"Error sending out the message\", e);\n    }\n  });\n\n  await proc.ready();\n\n  await transport.send(encode(\"$state\", proc.state as Record<string, unknown>));\n\n  // 6. Forward incoming messages to the actor\n  transport.onMessage((line) => {\n    const msg = decode(line);\n    if (isMsg(msg)) {\n      const { fromName, body } = msg.$msg;\n      proc.send(body as InMsg, { fromName, fromId: Symbol() });\n    }\n  });\n\n  // 7. On actor exit, send $exit\n  const shutdown = async (code: number) => {\n    await transport.send(encode(\"$exit\", { code, state: proc.state }));\n    await transport.close();\n    process.exit(code);\n  };\n  proc.wait().then(\n    () => shutdown(0),\n    (err: unknown) => {\n      console.error(\"child actor error:\", err);\n      shutdown(1);\n    },\n  );\n}\n","// ── Host-side adapter ──────────────────────────────────────────────────────\n//\n// commandConnector: spawns a child process and bridges the wire protocol.\n// Connector wrappers (bunConnector, nodeConnector, defaultConnector) produce\n// the command array from a script path.\n\nimport { spawn, execSync, type ChildProcess } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { unlink } from \"node:fs/promises\";\nimport { FifoUtf8NlineTransport } from \"./fifo.js\";\nimport { encode, decode, isProto, isState, isMsg, isExit, PROTO_VERSION } from \"./protocol.js\";\nimport type { Message } from \"../types.js\";\n\n// ── types ──────────────────────────────────────────────────────────────────\n\nexport interface CommandSpawnOptions<Args = Record<string, unknown>> {\n  command: string[];\n  args: Args;\n  parentName?: string;\n}\n\nexport interface RemoteProxy<\n  State = unknown,\n  InMsg extends Message = Message,\n  OutMsg extends Message = Message,\n> {\n  readonly state: State;\n  ready(): Promise<void>;\n  send(msg: InMsg): void;\n  wait(): Promise<{ code: number | null; state: State }>;\n  onMessage(handler: (msg: OutMsg) => void): void;\n}\n\n/** A connector takes a command and returns a RemoteProxy. */\nexport type Connector<\n  State = unknown,\n  InMsg extends Message = Message,\n  OutMsg extends Message = Message,\n> = (opts: CommandSpawnOptions) => Promise<RemoteProxy<State, InMsg, OutMsg>>;\n\n// ── commandConnector ───────────────────────────────────────────────────────\n\nexport async function spawnRemote<\n  State = unknown,\n  InMsg extends Message = Message,\n  OutMsg extends Message = Message,\n  Args = Record<string, unknown>,\n>(opts: CommandSpawnOptions<Args>): Promise<RemoteProxy<State, InMsg, OutMsg>> {\n  const basePath = join(tmpdir(), `posipaki-${randomUUID()}`);\n\n  execSync(`mkfifo \"${basePath}.in\"`);\n  execSync(`mkfifo \"${basePath}.out\"`);\n\n  const setup = FifoUtf8NlineTransport.beginConnect(basePath + \".in\", basePath + \".out\");\n\n  const childCmd = [\n    ...opts.command,\n    `--fifo-in=${basePath + \".in\"}`,\n    `--fifo-out=${basePath + \".out\"}`,\n  ];\n  const childProc: ChildProcess = spawn(childCmd[0], childCmd.slice(1), {\n    cwd: process.cwd(),\n    stdio: [\"inherit\", \"inherit\", \"inherit\"],\n  });\n\n  const transport = await setup.transport;\n\n  // ── handshake ───────────────────────────────────────────────────────\n  const protoLine = await new Promise<string>((resolve) => {\n    transport.onMessage((line) => resolve(line));\n  });\n  const protoMsg = decode(protoLine);\n  if (!isProto(protoMsg) || protoMsg.$proto !== PROTO_VERSION) {\n    throw new Error(`unsupported protocol: ${protoLine.slice(0, 50)}`);\n  }\n  transport.removeHandler();\n\n  await transport.send(\n    encode(\"$init\", {\n      ...(opts.args as Record<string, unknown>),\n      parentName: opts.parentName ?? \"host\",\n      parentIdName: opts.parentName ?? \"host\",\n    }),\n  );\n\n  let currentState: Record<string, unknown> = {};\n  await new Promise<void>((resolve) => {\n    transport.onMessage((line) => {\n      const msg = decode(line);\n      if (isState(msg)) {\n        Object.assign(currentState, msg.$state as Record<string, unknown>);\n        resolve();\n      }\n    });\n  });\n  transport.removeHandler();\n\n  // ── persistent handler ──────────────────────────────────────────────\n  let msgHandler: ((msg: OutMsg) => void) | null = null;\n  let exitResolver: ((value: { code: number | null; state: State }) => void) | null = null;\n  const exitPromise = new Promise<{ code: number | null; state: State }>((resolve) => {\n    exitResolver = resolve;\n  });\n\n  transport.onMessage((line) => {\n    const msg = decode(line);\n    if (isState(msg)) {\n      Object.assign(currentState, msg.$state as Record<string, unknown>);\n    } else if (isMsg(msg)) {\n      msgHandler?.(msg.$msg.body as OutMsg);\n    } else if (isExit(msg)) {\n      if (exitResolver) {\n        exitResolver({ code: msg.$exit.code, state: msg.$exit.state as State });\n        exitResolver = null;\n      }\n      cleanup();\n    }\n  });\n\n  // ── cleanup ─────────────────────────────────────────────────────────\n  let cleaned = false;\n  const cleanup = () => {\n    if (cleaned) return;\n    cleaned = true;\n    transport.close();\n    unlink(basePath + \".in\").catch(() => {});\n    unlink(basePath + \".out\").catch(() => {});\n  };\n\n  childProc.on(\"exit\", (code) => {\n    if (exitResolver) {\n      exitResolver({ code, state: currentState as State });\n      exitResolver = null;\n    }\n    cleanup();\n  });\n\n  return {\n    get state(): State {\n      return currentState as State;\n    },\n    async ready() {},\n    send(msg: InMsg) {\n      const from = opts.parentName ?? \"host\";\n      transport.send(encode(\"$msg\", { fromName: from, body: msg }));\n    },\n    async wait() {\n      return exitPromise;\n    },\n    onMessage(handler: (msg: OutMsg) => void) {\n      msgHandler = handler;\n    },\n  };\n}\n\n// ── connector wrappers ─────────────────────────────────────────────────────\n\nfunction scriptConnector(runner: string, runnerArgs: string[]): (scriptPath: string) => Connector {\n  return (scriptPath: string) => {\n    return ((opts: CommandSpawnOptions) => {\n      return commandConnector({\n        ...opts,\n        command: [runner, ...runnerArgs, scriptPath, ...opts.command],\n      });\n    }) as Connector;\n  };\n}\n\n/** Spawn via `bun run <script>`. */\nexport const bunConnector = scriptConnector(\"bun\", []);\n\n/** Spawn via `node <script>`. */\nexport const nodeConnector = scriptConnector(\"node\", []);\n\n/**\n * Auto-detect: prefers `bun run` if bun is\n * the current runtime, otherwise falls back to `node`.\n */\nexport function defaultConnector(scriptPath: string): Connector {\n  // Check if we're running under bun\n  const isBun = typeof (globalThis as any).Bun !== \"undefined\";\n  if (isBun) return bunConnector(scriptPath);\n  return nodeConnector(scriptPath);\n}\n\n// ── alias ───────────────────────────────────────────────────────────────────\n\nexport const commandConnector = spawnRemote;\n","// ── defineRemoteActor ──────────────────────────────────────────────────────\n//\n// Wraps an ActorDefinition so that when spawned, it runs in a child process\n// over two named fifos. Returns { actor, runRemoteRoot, isRemoteRoot }.\n//\n// Uses defineActor's setup hook to spawn the remote child before the first\n// yield, so proc.ready() shows the live remote state — same as local spawn.\n\nimport { fileURLToPath } from \"node:url\";\nimport { createHash } from \"node:crypto\";\nimport type { Message } from \"../types.js\";\nimport type { HandlerOptions, MethodOptions, ReflectionOptions } from \"../actor-types.js\";\nimport { defineActor } from \"../define-actor.js\";\nimport { stopPropagation } from \"../hooks.js\";\nimport type { HookResult } from \"../hooks.js\";\nimport { runChild } from \"./child.js\";\nimport { type Connector, defaultConnector } from \"./host.js\";\nimport type { RemoteProxy } from \"./host.js\";\nimport type { ActorDefinition } from \"../actor-types.js\";\n\nexport interface RemoteActorOptions {\n  manual?: boolean;\n  connector?: Connector;\n}\n\nexport interface RemoteActorBundle<\n  Args,\n  State,\n  InMsg extends Message,\n  OutMsg extends Message,\n  ReflectionMethods extends ReflectionOptions,\n> {\n  actor: ActorDefinition<Args, State, InMsg, OutMsg, ReflectionMethods>;\n  runRemoteRoot(): Promise<void>;\n  isRemoteRoot: boolean;\n}\n\nfunction pathHash(path: string): string {\n  return createHash(\"sha256\").update(path).digest(\"hex\").slice(0, 12);\n}\n\nconst MARKER_PREFIX = \"--remote=\";\n\nexport function defineRemoteActor<\n  Args,\n  State,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  Reflection extends ReflectionOptions,\n>(\n  actor: ActorDefinition<Args, State, InMsg, OutMsg, Reflection>,\n  url: string,\n  opts: RemoteActorOptions = {},\n): RemoteActorBundle<Args, State, InMsg, OutMsg, Reflection> {\n  const scriptPath = fileURLToPath(url);\n  const marker = `${MARKER_PREFIX}${pathHash(scriptPath)}`;\n  const isRemoteRoot = !opts.manual && process.argv.includes(marker);\n\n  if (isRemoteRoot) {\n    runChild(actor.fn);\n  }\n\n  const proxyDef = defineActor<\n    Args,\n    { public: State; private: { remote: RemoteProxy<State, InMsg, OutMsg> } },\n    InMsg,\n    OutMsg,\n    Methods,\n    Handlers,\n    Reflection\n  >({\n    name: actor.name ?? \"actor\",\n    inMessages: actor.inMessages,\n    outMessages: actor.outMessages,\n    handlers: {} as unknown as Handlers,\n    async setup(args: Args) {\n      const connect = opts.connector ?? defaultConnector(scriptPath);\n      const remote = (await connect({\n        command: [marker],\n        args: args as Record<string, unknown>,\n      })) as RemoteProxy<State, InMsg, OutMsg>;\n      remote.onMessage((msg: OutMsg) => {\n        this.emit(msg);\n      });\n      return {\n        public: remote.state,\n        private: { remote },\n      };\n    },\n    async onMessage(msg: InMsg): Promise<HookResult> {\n      this.state.private.remote?.send(msg);\n      return stopPropagation();\n    },\n    async onStopRequested() {\n      if (this.state.private.remote) {\n        this.state.private.remote.send({ type: \"STOP\" } as InMsg);\n        await this.state.private.remote.wait();\n      }\n      this.agreeToStop();\n    },\n  });\n\n  return {\n    actor: proxyDef as ActorDefinition<Args, State, InMsg, OutMsg, Reflection>,\n    runRemoteRoot() {\n      return runChild(actor.fn);\n    },\n    isRemoteRoot,\n  };\n}\n"],"mappings":"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"}

package/dist/src-BLzdjrVl.js.map

@@ -1 +1 @@
-{"version":3,"file":"src-BLzdjrVl.js","names":[],"sources":["../src/adapters.ts","../src/process.async.ts","../src/process.ts","../src/define-actor.ts","../src/index.ts"],"sourcesContent":["import type { ProcessFn, AsyncProcessFn, Message } from \"./types.js\"\n\nexport function asyncify<A, S, IM extends Message, OM extends Message>(\n  fn: ProcessFn<A, S, IM, OM>,\n): AsyncProcessFn<A, S, IM, OM> {\n  return async function* (ctx, args) {\n    yield* fn(ctx, args) as any\n  }\n}\n","import { defer, makeWaiter, debugLog, withTimeout } from \"./util.js\";\nimport type { DeferredCall, Waiter } from \"./util.js\";\nimport type {\n  Message,\n  WithSender,\n  SenderInfo,\n  ExitMessage,\n  StopMessage,\n  ProcessCtx,\n  AsyncProcessFn,\n  ProcessFn,\n} from \"./types.js\";\nimport { asyncify } from \"./adapters.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** An async iterator over process state. Receives `WithSender<InMessage | StopMessage>`. */\ntype AsyncProcessGenerator<\n  ProcessState,\n  InMessage extends Message,\n> = AsyncGenerator<\n  ProcessState | null,\n  void,\n  WithSender<InMessage | StopMessage>\n>;\n\ntype NotifyFn = () => void;\n\n// ---- runDispatchAsync -------------------------------------------------------\n\ntype AsyncReducer<M> = (msg: M) => Promise<void>;\ntype ReadyFn = () => boolean;\n\n/**\n * Async equivalent of `runDispatch`. Loops, yielding `null` and feeding\n * each incoming message to an `async` reducer. Exits when `readyFn()`\n * returns true.\n */\nexport async function* runDispatchAsync<M>(\n  name: string,\n  fn: AsyncReducer<M>,\n  readyFn: ReadyFn = () => false,\n  debugLevel = false,\n): AsyncGenerator<null, void, M> {\n  let msg: M;\n  while (!readyFn()) {\n    msg = yield null;\n    debugLog(debugLevel, \"msg\", name, \" <- \", msg);\n    await fn(msg);\n  }\n}\n\n// ---- AsyncProcess -----------------------------------------------------------\n\n/** A subscriber to this process's message channel: receives the message and\n *  its sender separately (not a `WithSender` tuple). */\ntype MessageCallback<M extends Message> = (msg: M, from: SenderInfo) => void;\n\n\n/** How long a parent waits for a child to stop before continuing shutdown. */\nconst CHILD_STOP_TIMEOUT_MS = 1_000;\n\n/**\n * A process driven by an async generator. Functionally identical to\n * {@link Process} but supports `await` inside reducers.\n *\n * Messages are processed **one at a time** — if a tick is already\n * in-flight, new messages are buffered and processed when the current\n * tick completes.\n */\nexport class AsyncProcess<\n  Args,\n  State,\n  InMessage extends Message,\n  OutMessage extends Message,\n  ReflectionMethods extends object,\n> {\n  /** Reflection methods.  Empty by default — defineActor fills in configured methods. */\n  $reflection: ReflectionMethods = {} as ReflectionMethods;\n  pgenerator: AsyncProcessFn<Args, State, InMessage, OutMessage>;\n  pname: string;\n  /** Subscribers to this process's message channel (`ctx.toParent`). */\n  private messageSubscribers: Array<MessageCallback<OutMessage>> = [];\n  id: symbol;\n  state: State | null;\n\n  private current: AsyncProcessGenerator<State, InMessage> | null = null;\n  /** Every buffered message carries sender provenance. */\n  private buffer: Array<WithSender<InMessage | StopMessage>> = [];\n  private nextTick: DeferredCall | null = null;\n  /** Child processes forked from this one (any fork method). */\n  children: Array<\n    AsyncProcess<unknown, unknown, Message, Message, {}>\n  > = [];\n  /** Children inherited from a child that exited (see ctx-orphans proposal). */\n  orphans: Array<\n    AsyncProcess<unknown, unknown, Message, Message, {}>\n  > = [];\n  private stateSubscribers: Array<NotifyFn> = [];\n  /** Unsubscribe handles for outgoing message subscriptions (monitor only). */\n  private pvtOutgoingSubscriptions: Array<() => void> = [];\n  /** Unsubscribe handles for adopt (ownership) subscriptions, keyed by child id. */\n  private pvtAdoptUnsubs: Map<symbol, () => void> = new Map();\n  /** Live buffer while this process is an unowned orphan mid-handoff. */\n  private pvtPending: Array<WithSender<Message>> | null = null;\n  /** Unsubscribe for the collector currently buffering into pvtPending. */\n  private pvtCollectorUnsub: (() => void) | null = null;\n  private exitWaiter: Waiter;\n  private pvtIsPaused: boolean = false;\n  private pvtDead: boolean = false;\n  private pvtTickInProgress: boolean = false;\n  private pvtExitReject: ((e: unknown) => void) | null = null;\n  private pvtReady!: Waiter;\n  private pvtResolveReady!: () => void;\n\n  constructor(\n    fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n    pname: string,\n    toParent?: MessageCallback<OutMessage>,\n  ) {\n    this.pgenerator = fn;\n    this.pname = pname;\n    if (toParent) this.messageSubscribers.push(toParent);\n    this.id = Symbol(pname);\n    this.state = null;\n    this.exitWaiter = makeWaiter();\n    this.pvtReady = makeWaiter();\n    this.pvtResolveReady = this.pvtReady.resolve;\n  }\n\n  /** Compact handle for `util.inspect` — actor state often holds process\n   *  references, and dumping the internals would be unreadable. */\n  [Symbol.for(\"nodejs.util.inspect.custom\")](): string {\n    return `AsyncProcess<${this.pname}>`;\n  }\n\n  /** Promise that resolves once the initial state is available. */\n  ready(): Promise<void> {\n    return this.pvtReady.promise;\n  }\n\n  // ---- lifecycle ------------------------------------------------------------\n\n  /**\n   * Kick off the async generator. The first `yield` sets the initial\n   * state; for async generators this happens in a microtask.\n   */\n  start(arg0: Args, parentName?: string | null, parentId?: symbol | null) {\n    const selfCtx: SenderInfo = { fromName: this.pname, fromId: this.id };\n\n    const ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage> = {\n      pname: this.pname,\n      id: this.id,\n      parentName: parentName ?? null,\n      parentId: parentId ?? null,\n      fork: this.fork.bind(this),\n      forkSync: this.forkSync.bind(this),\n      children: this.children,\n      orphans: this.orphans,\n      adopt: this.adopt.bind(this),\n      monitor: this.monitor.bind(this),\n      sendSelf: (msg) => {\n        this.send([msg, selfCtx]);\n      },\n      toParent: (msg) => {\n        this.messageSubscribers.forEach((cb) => cb(msg as OutMessage, selfCtx));\n      },\n    };\n\n    this.current = this.pvtWatchExit(ctx, arg0);\n    void this.current.next().then((ret: IteratorResult<State | null, void>) => {\n      this.state = ret.value ?? null;\n      this.pvtResolveReady();\n      if (ret.done) {\n        this.exitWaiter.resolve();\n        return;\n      }\n      // Advance past the initial yield so the pvtWatchExit generator\n      // runs its finally block (EXIT/STOP) and the inner generator\n      // enters its dispatch loop.\n      const advance: WithSender<InMessage | StopMessage> = [\n        { type: \"__ADVANCE__\" } as InMessage,\n        {\n          fromName: \"__internal__\",\n          fromId: Symbol(\"__internal__\"),\n        } as SenderInfo,\n      ];\n      this.pvtEatResult(this.current!.next(advance));\n    });\n    return this;\n  }\n\n  /** Wrap the user's generator so EXIT/STOP logic fires on completion. */\n  private async *pvtWatchExit(\n    ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage>,\n    arg0: Args,\n  ): AsyncProcessGenerator<State, InMessage> {\n    try {\n      yield* this.pgenerator(ctx, arg0);\n    } finally {\n      // Cascade: stop every child (nice) and collect the refusers as orphans.\n      const orphans: Array<AnyProcess> = [...this.orphans];\n      const parentSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      const stopPromises = this.children.map(async (child) => {\n        const stopped = await child.stop({ from: parentSender });\n        if (!stopped) {\n          orphans.push(child);\n          console.warn(\n            `posipaki: child \"${child.pname}\" did not stop within ${CHILD_STOP_TIMEOUT_MS}ms; continuing shutdown`,\n          );\n        }\n      });\n\n      await Promise.all(stopPromises);\n      // Hand surviving children and inherited orphans up to the parent for adoption (see ctx-orphans proposal).\n      // In-process only.\n      this.pvtPrepareHandoff(orphans);\n      ctx.toParent({ type: \"EXIT\", orphans });\n      // Unsubscribe from children/monitored processes so a dead parent\n      // doesn't keep receiving their messages (handoff collectors stay on the orphans).\n      this.pvtUnsubscribeAll();\n      if (ctx.afterExit) await ctx.afterExit();\n    }\n  }\n\n  // ---- fork -----------------------------------------------------------------\n\n  fork<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    fn: AsyncProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (\n    args: ChildArgs,\n  ) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return (args: ChildArgs) => {\n      const child = new AsyncProcess<\n        ChildArgs,\n        ChildState,\n        ChildIM,\n        ChildOM,\n        {}\n      >(fn, pname);\n      this.adopt(child);\n      child.start(args, this.pname, this.id);\n      return child;\n    };\n  }\n\n  forkSync<\n    ChildArgs,\n    ChildState,\n    ChildIM extends Message,\n    ChildOM extends InMessage,\n  >(\n    fn: ProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (\n    args: ChildArgs,\n  ) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return this.fork(asyncify(fn), pname);\n  }\n\n  // ---- message processing ---------------------------------------------------\n\n  protected async pvtTick(): Promise<void> {\n    if (!this.current || this.pvtTickInProgress) return;\n\n    this.pvtTickInProgress = true;\n    try {\n      let msgAndSender: WithSender<InMessage | StopMessage> | undefined;\n      let ret: IteratorResult<State | null, void> | null = null;\n      while ((msgAndSender = this.buffer.shift()) !== undefined) {\n        ret = await this.pvtSafeNext(msgAndSender);\n        if (!ret || ret.done) break;\n      }\n      this.notify();\n      this.pvtEatResult(ret);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n    } finally {\n      this.pvtTickInProgress = false;\n    }\n  }\n\n  /** Call `.next()` and redirect unhandled rejections. */\n  private async pvtSafeNext(\n    msgAndSender: WithSender<InMessage | StopMessage>,\n  ): Promise<IteratorResult<State | null, void> | null> {\n    try {\n      return await this.current!.next(msgAndSender);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n      return { done: true, value: undefined };\n    }\n  }\n\n  private pvtEatResult(\n    ret:\n      | IteratorResult<State | null, void>\n      | Promise<IteratorResult<State | null, void>>\n      | null,\n  ): void {\n    if (!ret) return;\n    Promise.resolve(ret).then((r) => {\n      if (r.done) {\n        this.exitWaiter.resolve();\n      }\n    });\n  }\n\n  /** Broadcast a message to all children. */\n  toAllChildren(msg: Message): void {\n    const stamp: SenderInfo = { fromName: this.pname, fromId: this.id };\n    this.children.forEach((p) => p.send([msg, stamp] as WithSender<Message>));\n  }\n\n  /** Stamp and enqueue a message from a named sender (external API). */\n  send(msg: InMessage | StopMessage, from?: SenderInfo): void;\n  /** Enqueue a pre-stamped message (internal: fromChild, toAllChildren). */\n  send(msgAndSender: WithSender<InMessage | StopMessage>): void;\n  send(\n    msgOrTuple: InMessage | StopMessage | WithSender<InMessage | StopMessage>,\n    from?: SenderInfo,\n  ): void {\n    if (this.pvtDead) return;\n    if (\"type\" in msgOrTuple) {\n      this.buffer.push([\n        msgOrTuple as InMessage | StopMessage,\n        from as SenderInfo,\n      ]);\n    } else {\n      this.buffer.push(msgOrTuple as WithSender<InMessage | StopMessage>);\n    }\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Synchronously flush the buffer. For sync processes use {@link Process.tick};\n   * for async processes this is **not guaranteed** to process everything\n   * immediately if reducers contain `await`. Prefer `send()` + `await proc.wait()`.\n   */\n  tick(): void {\n    this.nextTick?.flush();\n    this.nextTick = null;\n  }\n\n  private pvtScheduleTick(): void {\n    if (this.pvtIsPaused || this.pvtDead) return;\n\n    this.nextTick?.cancel();\n    this.nextTick = defer(() => {\n      this.nextTick = null;\n      void this.pvtTick();\n    });\n  }\n\n  // ---- subscribers ----------------------------------------------------------\n\n  notify(): void {\n    this.stateSubscribers.forEach((f) => f());\n  }\n\n  get isListenedTo(): boolean {\n    return this.stateSubscribers.length > 0;\n  }\n\n  subscribe(channel: \"message\", cb: MessageCallback<OutMessage>): () => void;\n  subscribe(channel: \"state\", cb: NotifyFn): () => void;\n  /** @deprecated Use `subscribe(\"state\", cb)`. */\n  subscribe(cb: NotifyFn): () => void;\n  subscribe(\n    channelOrCb: \"message\" | \"state\" | NotifyFn,\n    cb?: MessageCallback<OutMessage> | NotifyFn,\n  ): () => void {\n    if (typeof channelOrCb === \"function\") {\n      return this.subscribe(\"state\", channelOrCb);\n    }\n    if (channelOrCb === \"message\") {\n      const fn = cb as MessageCallback<OutMessage>;\n      this.messageSubscribers.push(fn);\n      return () => this.pvtUnsubscribe(this.messageSubscribers, fn);\n    }\n    const fn = cb as NotifyFn;\n    this.stateSubscribers.push(fn);\n    return () => this.pvtUnsubscribe(this.stateSubscribers, fn);\n  }\n\n  private pvtUnsubscribe<T>(list: Array<T>, fn: T): void {\n    const idx = list.indexOf(fn);\n    if (idx >= 0) list.splice(idx, 1);\n  }\n\n  // ---- pause / resume -------------------------------------------------------\n\n  /**\n   * Freeze dispatch: no further ticks are scheduled, so the process stops\n   * *processing* incoming messages.  This is half-working as a \"quiesce\"\n   * primitive — it does not stop the process from *emitting* via async\n   * callbacks (timers, fetch) that bypass the dispatch loop.\n   */\n  pause(): void {\n    this.nextTick?.cancel();\n    this.nextTick = null;\n    this.pvtIsPaused = true;\n  }\n\n  resume(): void {\n    this.pvtIsPaused = false;\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Hard-kill this process: abandon the generator without running its\n   * `finally` (no EXIT, no STOP cascade), drop the inbox and observers,\n   * unsubscribe from children/monitors, and settle `wait()`/`ready()`.\n   *\n   * There is nothing to observe afterward — callers remove the process from\n   * their `children`/`orphans` lists imperatively.  Does not cascade to this\n   * process's own children; they are abandoned (force-stop them separately if\n   * owned).\n   *\n   * Best-effort: an idle generator (suspended at `yield`) is abandoned\n   * cleanly; a generator mid-`await` completes its `finally` when that await\n   * settles, because JS offers no way to cancel a pending promise.\n   */\n  forceStop(opts?: { cascade?: boolean }): void {\n    if (this.pvtDead) return;\n    this.pvtDead = true;\n\n    // Abandon the generator so its finally block never runs.\n    this.current = null;\n\n    // Drop the inbox and stop scheduling.\n    this.buffer.length = 0;\n    this.nextTick?.cancel();\n    this.nextTick = null;\n\n    // Release incoming observers and outgoing subscriptions.\n    this.messageSubscribers.length = 0;\n    this.stateSubscribers.length = 0;\n    this.pvtUnsubscribeAll();\n    // Drop any handoff state this process carried as an unowned orphan.\n    this.unparent();\n\n    // Settle waiters.\n    this.pvtResolveReady();\n    this.exitWaiter.resolve();\n    this.pvtExitReject = null;\n\n    if (opts?.cascade) {\n      // Stop the children too, starting with the nice stop (fire-and-forget:\n      // the hard kill itself does not block on their graceful exit).\n      const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      for (const child of this.children) {\n        void child.stop({ force: true, from: selfSender }).catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Stop this process.  Sends STOP (the nice way — the generator cooperates\n   * and its `finally` runs) and awaits on a best-effort basis.\n   *\n   * With `{ force: true }`, when the process refuses (does not exit within the\n   * timeout) it escalates: fires `generator.return()` *without awaiting* (throw\n   * the generator away for GC to find), cascades to children with the same\n   * ladder, then hard-kills itself.\n   *\n   * Resolves `true` if the process stopped (gracefully or forced), `false` if\n   * it refused and `force` was not requested.\n   */\n  async stop(opts?: { force?: boolean; from?: SenderInfo }): Promise<boolean> {\n    if (this.pvtDead) return true;\n\n    this.send({ type: \"STOP\" } as StopMessage, opts?.from);\n\n    try {\n      await withTimeout(this.wait(), CHILD_STOP_TIMEOUT_MS, 'stop');\n      return true;\n    } catch (e) {\n      if ((e as Error)?.message !== 'Timeout:stop') throw e;\n      // refused to stop within the timeout\n    }\n\n    if (!opts?.force) return false;\n\n    // Escalate: give the finally a chance to run (fire-and-forget), but do not\n    // block on it — the process may be stuck awaiting a dead promise.\n    void this.current?.return(undefined);\n\n    // Cascade to children with the same ladder, stamped from this process.\n    const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n    await Promise.all(\n      [...this.children].map((child) => child.stop({ force: true, from: selfSender })),\n    );\n\n    this.forceStop();\n    return true;\n  }\n\n  // ---- waiting --------------------------------------------------------------\n\n  /**\n   * Returns a promise that resolves when the generator completes, or\n   * rejects if an unhandled error occurs during message processing.\n   */\n  wait(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      this.pvtExitReject = reject;\n\n      this.exitWaiter.promise.then(\n        () => {\n          this.pvtExitReject = null;\n          resolve();\n        },\n        (e) => {\n          this.pvtExitReject = null;\n          reject(e);\n        },\n      );\n    });\n  }\n\n  // ---- child messages -------------------------------------------------------\n\n  /**\n   * Tap another process's message channel: every message it emits is fed\n   * into this process's incoming queue.  No ownership — the sender's EXIT\n   * does not touch `children`/`orphans`.\n   */\n  monitor<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.send([msg, from] as WithSender<InMessage | StopMessage>);\n    });\n    this.pvtOutgoingSubscriptions.push(unsub);\n    return unsub;\n  }\n\n  /**\n   * Claim another process as a child: its messages are routed here and its\n   * EXIT removes it from `children` (collecting its orphans).  Generalizes\n   * what `fork` does — used for both spawning and orphan adoption.\n   */\n  adopt<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    this.children.push(child as unknown as AnyProcess);\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.pvtChildMessage(msg, from);\n    });\n    this.pvtAdoptUnsubs.set(child.id, unsub);\n    // Lossless handoff: drain a pending buffer left by the previous parent.\n    this.pvtDrainPending(child as unknown as AnyProcess);\n    return unsub;\n  }\n\n  /** Handles a child's emitted message: EXIT cleanup + forward to the queue. */\n  private pvtChildMessage(msg: Message, sender: SenderInfo): void {\n    if (msg.type === \"EXIT\") {\n      // sender.fromId === child's id (stamped by the child's ctx.toParent)\n      // Mutate in place so ctx.children (a live reference) stays consistent.\n      const idx = this.children.findIndex((p) => p.id === sender.fromId);\n      if (idx >= 0) this.children.splice(idx, 1);\n      const orphans = (msg as ExitMessage).orphans;\n      if (orphans && orphans.length > 0) {\n        this.orphans.push(...orphans);\n      }\n    }\n    this.send([msg, sender] as WithSender<InMessage | StopMessage>);\n  }\n\n  // ---- orphan handoff -------------------------------------------------------\n\n  /** Unsubscribe from all outgoing subscriptions (monitors + adopt). */\n  private pvtUnsubscribeAll(): void {\n    for (const unsub of this.pvtOutgoingSubscriptions) unsub();\n    this.pvtOutgoingSubscriptions = [];\n    for (const unsub of this.pvtAdoptUnsubs.values()) unsub();\n    this.pvtAdoptUnsubs.clear();\n  }\n\n  /** Prepare surviving children and inherited orphans for a lossless handoff:\n   *  recover undrained messages and install a collector on each orphan. */\n  private pvtPrepareHandoff(orphans: Array<AnyProcess>): void {\n    for (const orphan of orphans) {\n      this.pvtBackFeed(orphan);\n      if (!orphan.pvtCollectorUnsub) {\n        this.pvtSwapToCollector(orphan);\n      }\n    }\n  }\n\n  /** Recover messages the orphan emitted into my inbox that I never drained. */\n  private pvtBackFeed(orphan: AnyProcess): void {\n    const fromOrphan: Array<WithSender<Message>> = [];\n    this.buffer = this.buffer.filter((entry) => {\n      if (entry[1].fromId === orphan.id) {\n        fromOrphan.push(entry);\n        return false;\n      }\n      return true;\n    });\n    if (fromOrphan.length === 0) return;\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    orphan.pvtPending.unshift(...fromOrphan);\n  }\n\n  /** Replace my ownership subscription to `orphan` with a handoff collector. */\n  private pvtSwapToCollector(orphan: AnyProcess): void {\n    const mine = this.pvtAdoptUnsubs.get(orphan.id);\n    if (mine) {\n      mine();\n      this.pvtAdoptUnsubs.delete(orphan.id);\n    }\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    const pending = orphan.pvtPending;\n    orphan.pvtCollectorUnsub = orphan.subscribe(\"message\", (msg, from) => {\n      pending.push([msg, from]);\n    });\n  }\n\n  /** Drain a handed-off orphan's pending buffer into my inbox (lossless adopt). */\n  private pvtDrainPending(orphan: AnyProcess): void {\n    if (orphan.pvtCollectorUnsub) {\n      orphan.pvtCollectorUnsub();\n      orphan.pvtCollectorUnsub = null;\n    }\n    const pending = orphan.pvtPending;\n    if (!pending) return;\n    orphan.pvtPending = null;\n    for (const [msg, from] of pending) {\n      this.pvtChildMessage(msg, from);\n    }\n  }\n\n  /**\n   * Drop this process's handoff state (collector + pending buffer) without\n   * stopping it.  Used by `onOrphan`'s \"unparent\" decision: the orphan keeps\n   * running and stays in the orphans list, but its in-flight buffer is gone.\n   */\n  unparent(): void {\n    if (this.pvtCollectorUnsub) {\n      this.pvtCollectorUnsub();\n      this.pvtCollectorUnsub = null;\n    }\n    this.pvtPending = null;\n  }\n}\nexport type AnyProcess = AsyncProcess<unknown, unknown, Message, Message, {}>;\n// ---- spawnAsync -------------------------------------------------------------\n\n/**\n * Spawn a new async process. Accepts both sync and async process\n * functions — sync ones are automatically wrapped with {@link asyncify}.\n */\nexport function spawnAsync<\n  Args,\n  State,\n  InMessage extends Message = Message,\n  OutMessage extends Message = ExitMessage,\n>(\n  fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n  pname: string,\n  toParent?: MessageCallback<OutMessage>,\n): (args: Args) => AsyncProcess<Args, State, InMessage, OutMessage, {}> {\n  return (args: Args) => {\n    const proc = new AsyncProcess<Args, State, InMessage, OutMessage, {}>(\n      fn,\n      pname,\n      toParent,\n    );\n    proc.start(args);\n    return proc;\n  };\n}\n","import { AsyncProcess } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\nimport type { Message, SenderInfo, ExitMessage, ProcessFn } from \"./types.js\";\n\nexport type { Message, ProcessFn, ProcessCtx } from \"./types.js\";\nexport { runDispatch } from \"./util.js\";\n\n/** @deprecated Use {@link spawnAsync} instead. */\nexport function spawn<\n  A,\n  S,\n  IM extends Message = Message,\n  OM extends Message = ExitMessage,\n>(\n  fn: ProcessFn<A, S, IM, OM>,\n  pname: string,\n  tp?: (m: OM, from: SenderInfo) => void,\n): (a: A) => Process<A, S, IM, OM> {\n  return (a: A) => new Process(fn, pname, tp).start(a);\n}\n\n/** @deprecated Use {@link AsyncProcess} instead. Sync processes are\n *  wrapped via asyncify internally; spawnAsync handles both. */\nclass Process<\n  A,\n  S,\n  IM extends Message,\n  OM extends Message,\n> extends AsyncProcess<A, S, IM, OM, {}> {\n  constructor(\n    fn: ProcessFn<A, S, IM, OM>,\n    pname: string,\n    tp?: (m: OM, from: SenderInfo) => void,\n  ) {\n    super(asyncify(fn), pname, tp);\n  }\n\n  start(a: A) {\n    super.start(a);\n    return this;\n  }\n  tick(): Promise<void> {\n    return super.pvtTick();\n  }\n}\n\nexport { Process };\n","// ── defineActor — high-level actor wrapper ───────────────────────────────────\n//\n// Compiles a declarative config into an AsyncProcessFn.  Built on top of\n// the existing runDispatchAsync / spawnAsync primitives.\n//\nimport {\n  type AsyncProcess,\n  runDispatchAsync,\n  spawnAsync,\n  AnyProcess,\n} from \"./process.async.js\";\nimport type {\n  WithSender,\n  SenderInfo,\n  AsyncProcessFn,\n  Message,\n  ExitMessage,\n  ProcessCtx,\n} from \"./types.js\";\nimport type {\n  ActorDefinition,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  ActorMessages,\n  HandlerOptions,\n  HandlerFn,\n  ReflectionOptions,\n  AnyConfig,\n  HidePrivate,\n} from \"./actor-types.js\";\nimport { STOP_SENTINEL } from \"./actor-types.js\";\nimport {\n  ActorDecorated,\n  type ActorPlugin,\n  ActorReflection,\n  callHook,\n} from \"./hooks.js\";\n\nexport function defineMessages<\n  OutMsg extends Message = Message,\n>(): ActorMessages<OutMsg> {\n  return undefined as unknown as ActorMessages<OutMsg>;\n}\n\nfunction hidePrivate<T>(value: T): HidePrivate<T> {\n  if (\n    value &&\n    typeof value === \"object\" &&\n    \"private\" in value &&\n    \"public\" in value\n  ) {\n    return value.public as HidePrivate<T>;\n  }\n  return value as HidePrivate<T>;\n}\n\nfunction resolvePlugins(\n  raw: ActorPlugin[] | ((parents: ActorPlugin[]) => ActorPlugin[]) | undefined,\n  parentPlugins?: ActorPlugin[],\n  addPlugins?: ActorPlugin[],\n): ActorPlugin[] {\n  const resolved =\n    !raw ? (parentPlugins ? [...parentPlugins] : [])\n    : Array.isArray(raw) ? [...raw]\n    : raw(parentPlugins ?? []);\n\n  const combined = addPlugins ? [...resolved, ...addPlugins] : resolved;\n\n  // Deduplicate by function name\n  const seen = new Set<string>();\n  return combined.filter((p) => {\n    const name = p.name;\n    if (!name) {\n      console.warn(\"posipaki: plugin has no name, dedup won't work\");\n      return true;\n    }\n    if (seen.has(name)) return false;\n    seen.add(name);\n    return true;\n  });\n}\n\nasync function assembleActor<C>(config: C, plugins: ActorPlugin[], addPlugins?: ActorPlugin[]): Promise<C> {\n  // Work with the default ActorPlugin type internally, cast back on return\n  let cur = config as AnyConfig;\n  for (const p of plugins) {\n    try {\n          cur = await p(cur);\n    } catch (e: unknown) {\n      console.error(\n        `[assembleActor] plugin \"${p.name || \"?\"}\" failed:`,\n        e,\n      );\n    }\n  }\n  cur.resolvedPlugins = plugins;\n  if (addPlugins) cur.addPlugins = addPlugins;\n  return cur as C;\n}\n\nexport function defineActor<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n>(\n  config: ActorConfig<\n    Args,\n    InternalState,\n    InMsg,\n    OutMsg,\n    Methods,\n    Handlers,\n    ReflectionMethods\n  >,\n): ActorDefinition<Args, InternalState, InMsg, OutMsg, ReflectionMethods> {\n  const actorCtxMap = new Map<\n    symbol,\n    ActorContext<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods\n    >\n  >();\n\n  function makeRuntime(\n    assembly: ActorConfig<\n      Args,\n      InternalState,\n      InMsg,\n      OutMsg,\n      Methods,\n      Handlers,\n      ReflectionMethods\n    >,\n  ): AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg> {\n    return async function* (\n      ctx,\n      args,\n    ): AsyncGenerator<\n      HidePrivate<InternalState | null>,\n      void,\n      WithSender<InMsg>\n    > {\n      let done = false;\n      let exitReason: unknown;\n      let rawState: InternalState = undefined as unknown as InternalState;\n\n      const decorated = new Map();\n      const self: ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      > = {\n        ctx,\n        ...((assembly.methods || {}) as Methods),\n        ...((assembly.$decorate || {}) as ActorDecorated),\n        reflection: {} as ReflectionMethods & ActorReflection,\n        state: rawState,\n        name: ctx.pname,\n        id: ctx.id,\n        async emit(msg: OutMsg) {\n          await callHook(assembly.onEmit, undefined, self, msg, {\n            fromName: ctx.pname,\n            fromId: ctx.id,\n          });\n          ctx.toParent(msg);\n        },\n        agreeToStop() {\n          exitReason = \"stopped\";\n          done = true;\n        },\n        exit(reason: unknown) {\n          exitReason = reason;\n          done = true;\n        },\n        $child: {} as Record<string, AnyProcess>,\n        decorators: {},\n        fork: async <\n          A,\n          S,\n          IM extends Message,\n          OM extends InMsg,\n          R extends ReflectionOptions,\n        >(\n          childActor: ActorDefinition<A, S, IM, OM, R>,\n          childArgs?: A,\n          forkOpts?: { name?: string; addPlugins?: ActorPlugin[] },\n        ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>> => {\n          let child: AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>;\n          const childName =\n            forkOpts?.name ??\n            childActor?.name ??\n            `child-${Object.keys(self.$child).length}`;\n          const treeName = `${ctx.pname}:${childName}`;\n          const childAddPlugins = [\n            ...(assembly.addPlugins || []),\n            ...(forkOpts?.addPlugins || []),\n          ];\n          child = await childActor.spawnAsChild(\n            ctx,\n            childArgs!,\n            {\n              name: treeName,\n              parentPlugins: assembly.resolvedPlugins || [],\n              ...(childAddPlugins.length ? { addPlugins: childAddPlugins } : {}),\n            },\n          );\n          self.$child[child.pname] = child as unknown as AnyProcess;\n          return child;\n        },\n      };\n      actorCtxMap.set(ctx.id, self);\n      ctx.afterExit = async () => {\n        await callHook(assembly.afterEnd, assembly.onError, self, exitReason);\n      };\n\n      for (const [k, v] of decorated) {\n        (self as Record<string, unknown>)[k] = v;\n      }\n\n      await callHook(\n        assembly.beforeStart,\n        assembly.onError,\n        self as ActorContext<\n          Args,\n          never, // state not set yet\n          InMsg,\n          OutMsg,\n          Methods,\n          Handlers,\n          ReflectionMethods & ActorReflection\n        >,\n      );\n\n      if (assembly.setup) {\n        rawState = await assembly.setup.call(\n          self as ActorContext<\n            Args,\n            never, // break inference cycle here\n            InMsg,\n            OutMsg,\n            Methods,\n            Handlers,\n            ReflectionMethods & ActorReflection\n          >,\n          args,\n        );\n      } else {\n        rawState = null as InternalState;\n      }\n      self.state = rawState;\n      yield hidePrivate(rawState);\n      await callHook(assembly.afterStart, assembly.onError, self);\n\n      yield* runDispatchAsync<WithSender<InMsg | ExitMessage>>(\n        ctx.pname,\n        async (stamped) => {\n          const [msg, sender] = stamped;\n          if (msg.type === \"STOP\") {\n            if (assembly.onStopRequested) {\n              await callHook(assembly.onStopRequested, assembly.onError, self);\n              // Hook may call agreeToStop(). If not, actor keeps running.\n            } else {\n              exitReason = \"stopped\";\n              done = true;\n            }\n            return;\n          }\n          if (msg.type === \"EXIT\") {\n            // FIXME: process name are user-specified\n            // and should not be used for indexing so\n            // we don't get into name conflicts\n            const childName = sender.fromName;\n            if (childName && self.$child[childName]) {\n              delete self.$child[childName];\n            }\n            await callHook(\n              assembly.onChildExit,\n              assembly.onError,\n              self,\n              childName,\n              msg as ExitMessage,\n            );\n            // Orphan policy: a child that exits may leave still-running\n            // grandchildren behind (see ctx-orphans / orphan-policy).\n            const orphans = (msg as ExitMessage).orphans;\n            if (orphans && orphans.length > 0) {\n              for (const orphan of orphans) {\n                // Default when no hook is defined: hard-kill the orphan.\n                const decision = assembly.onOrphan\n                  ? await callHook(\n                      assembly.onOrphan,\n                      assembly.onError,\n                      self,\n                      orphan,\n                    )\n                  : \"force-stop\";\n                if (decision === \"adopt\") {\n                  ctx.adopt(orphan);\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                  self.$child[orphan.pname] = orphan;\n                } else if (decision === \"force-stop\") {\n                  orphan.forceStop({ cascade: true });\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                } else if (decision === \"unparent\") {\n                  orphan.unparent();\n                }\n                // 'leave' (or undefined) → do nothing; it propagates on exit.\n              }\n            }\n          }\n          let hookStopped = false;\n          if (\n            msg.type !== \"STOP\" &&\n            msg.type !== \"EXIT\" &&\n            assembly.onMessage\n          ) {\n            const result = await callHook(\n              assembly.onMessage,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n            if (result === STOP_SENTINEL) hookStopped = true;\n          }\n          if (msg.type !== \"STOP\" && !hookStopped) {\n            const handler =\n              ((assembly.handlers || ({} as Handlers))[\n                msg.type as keyof Handlers\n              ] as HandlerFn<InMsg>) || assembly.onUnhandled;\n\n            await callHook(\n              handler,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n          }\n        },\n        () => done,\n      );\n\n      await callHook(assembly.beforeEnd, assembly.onError, self, exitReason);\n    };\n  }\n\n  type ReflectableProcess = {\n    id: symbol;\n    $reflection: Record<string, Function>;\n  };\n  function attachReflection(\n    proc: ReflectableProcess,\n    reflectionMethods: ReflectionMethods | undefined,\n  ): void {\n    if (!reflectionMethods) return;\n    const self = actorCtxMap.get(proc.id);\n    const refl = proc.$reflection as Record<string, Function>;\n    for (const [k, m] of Object.entries(reflectionMethods)) {\n      refl[k] = m.bind(self);\n    }\n  }\n\n  return {\n    fn: makeRuntime(config),\n    name: config.name,\n    pvtPluginsRaw: config.plugins,\n    inMessages: config.inMessages,\n    outMessages: config.outMessages,\n    async spawn(\n      args: Args,\n      opts?: {\n        name?: string;\n        toParent?: (msg: OutMsg, from: SenderInfo) => void;\n        addPlugins?: ActorPlugin[];\n      },\n    ): Promise<\n      AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >\n    > {\n      const plugs = resolvePlugins(config.plugins, undefined, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = spawnAsync(runtime, opts?.name ?? assembly.name ?? \"actor\", opts?.toParent)(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n    async spawnAsChild(\n      ctx: ProcessCtx<unknown, unknown, OutMsg, Message>,\n      args: Args,\n      opts?: {\n        name?: string;\n        parentPlugins?: ActorPlugin[];\n        addPlugins?: ActorPlugin[];\n      },\n    ) {\n      const plugs = resolvePlugins(config.plugins, opts?.parentPlugins, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = ctx.fork(runtime, opts?.name ?? assembly.name ?? \"child\")(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n  };\n}\n","/**\n * Posipaki — Erlang-inspired lightweight actor processes built on\n * generator functions. Processes communicate via message-passing,\n * can fork children, and expose their state reactively.\n *\n * @module\n */\n\nimport { Process, spawn } from \"./process.js\";\nimport { runDispatch } from \"./util.js\";\nimport { AsyncProcess, spawnAsync, runDispatchAsync } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\n\nexport { Process, spawn, runDispatch };\nexport { AsyncProcess, spawnAsync, runDispatchAsync, asyncify };\nexport type { AnyProcess } from \"./process.async.js\";\n\nexport type {\n  Message,\n  WithSender,\n  WithoutSender,\n  ExitMessage,\n  StopMessage,\n  ProcessFn,\n  ProcessCtx,\n  AsyncProcessFn,\n  PipeState,\n  SupervisorState,\n  SenderOrigin,\n  SenderInfo,\n} from \"./types.js\";\n\nexport { defineActor, defineMessages } from \"./define-actor.js\";\nexport type {\n  ActorDefinition,\n  SpawnedFrom,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  HandlerOptions,\n  HandlerFn,\n} from \"./actor-types.js\";\n\n// ── hooks ─────────────────────────────────────────────────────────────────\n\nexport { stopPropagation, mergeConfigs, chainHook, callHook } from \"./hooks.js\";\nexport type {\n  HookResult,\n  ActorPlugin,\n  ActorDecorated,\n  ActorReflection,\n  PluginTransform,\n} from \"./hooks.js\";\n"],"mappings":"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"}
+{"version":3,"file":"src-BLzdjrVl.js","names":[],"sources":["../src/adapters.ts","../src/process.async.ts","../src/process.ts","../src/define-actor.ts","../src/index.ts"],"sourcesContent":["import type { ProcessFn, AsyncProcessFn, Message } from \"./types.js\";\n\nexport function asyncify<A, S, IM extends Message, OM extends Message>(\n  fn: ProcessFn<A, S, IM, OM>,\n): AsyncProcessFn<A, S, IM, OM> {\n  return async function* (ctx, args) {\n    yield* fn(ctx, args) as any;\n  };\n}\n","import { defer, makeWaiter, debugLog, withTimeout } from \"./util.js\";\nimport type { DeferredCall, Waiter } from \"./util.js\";\nimport type {\n  Message,\n  WithSender,\n  SenderInfo,\n  ExitMessage,\n  StopMessage,\n  ProcessCtx,\n  AsyncProcessFn,\n  ProcessFn,\n} from \"./types.js\";\nimport { asyncify } from \"./adapters.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** An async iterator over process state. Receives `WithSender<InMessage | StopMessage>`. */\ntype AsyncProcessGenerator<ProcessState, InMessage extends Message> = AsyncGenerator<\n  ProcessState | null,\n  void,\n  WithSender<InMessage | StopMessage>\n>;\n\ntype NotifyFn = () => void;\n\n// ---- runDispatchAsync -------------------------------------------------------\n\ntype AsyncReducer<M> = (msg: M) => Promise<void>;\ntype ReadyFn = () => boolean;\n\n/**\n * Async equivalent of `runDispatch`. Loops, yielding `null` and feeding\n * each incoming message to an `async` reducer. Exits when `readyFn()`\n * returns true.\n */\nexport async function* runDispatchAsync<M>(\n  name: string,\n  fn: AsyncReducer<M>,\n  readyFn: ReadyFn = () => false,\n  debugLevel = false,\n): AsyncGenerator<null, void, M> {\n  let msg: M;\n  while (!readyFn()) {\n    msg = yield null;\n    debugLog(debugLevel, \"msg\", name, \" <- \", msg);\n    await fn(msg);\n  }\n}\n\n// ---- AsyncProcess -----------------------------------------------------------\n\n/** A subscriber to this process's message channel: receives the message and\n *  its sender separately (not a `WithSender` tuple). */\ntype MessageCallback<M extends Message> = (msg: M, from: SenderInfo) => void;\n\n/** How long a parent waits for a child to stop before continuing shutdown. */\nconst CHILD_STOP_TIMEOUT_MS = 1_000;\n\n/**\n * A process driven by an async generator. Functionally identical to\n * {@link Process} but supports `await` inside reducers.\n *\n * Messages are processed **one at a time** — if a tick is already\n * in-flight, new messages are buffered and processed when the current\n * tick completes.\n */\nexport class AsyncProcess<\n  Args,\n  State,\n  InMessage extends Message,\n  OutMessage extends Message,\n  ReflectionMethods extends object,\n> {\n  /** Reflection methods.  Empty by default — defineActor fills in configured methods. */\n  $reflection: ReflectionMethods = {} as ReflectionMethods;\n  pgenerator: AsyncProcessFn<Args, State, InMessage, OutMessage>;\n  pname: string;\n  /** Subscribers to this process's message channel (`ctx.toParent`). */\n  private messageSubscribers: Array<MessageCallback<OutMessage>> = [];\n  id: symbol;\n  state: State | null;\n\n  private current: AsyncProcessGenerator<State, InMessage> | null = null;\n  /** Every buffered message carries sender provenance. */\n  private buffer: Array<WithSender<InMessage | StopMessage>> = [];\n  private nextTick: DeferredCall | null = null;\n  /** Child processes forked from this one (any fork method). */\n  children: Array<AsyncProcess<unknown, unknown, Message, Message, {}>> = [];\n  /** Children inherited from a child that exited (see ctx-orphans proposal). */\n  orphans: Array<AsyncProcess<unknown, unknown, Message, Message, {}>> = [];\n  private stateSubscribers: Array<NotifyFn> = [];\n  /** Unsubscribe handles for outgoing message subscriptions (monitor only). */\n  private pvtOutgoingSubscriptions: Array<() => void> = [];\n  /** Unsubscribe handles for adopt (ownership) subscriptions, keyed by child id. */\n  private pvtAdoptUnsubs: Map<symbol, () => void> = new Map();\n  /** Live buffer while this process is an unowned orphan mid-handoff. */\n  private pvtPending: Array<WithSender<Message>> | null = null;\n  /** Unsubscribe for the collector currently buffering into pvtPending. */\n  private pvtCollectorUnsub: (() => void) | null = null;\n  private exitWaiter: Waiter;\n  private pvtIsPaused: boolean = false;\n  private pvtDead: boolean = false;\n  private pvtTickInProgress: boolean = false;\n  private pvtExitReject: ((e: unknown) => void) | null = null;\n  private pvtReady!: Waiter;\n  private pvtResolveReady!: () => void;\n\n  constructor(\n    fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n    pname: string,\n    toParent?: MessageCallback<OutMessage>,\n  ) {\n    this.pgenerator = fn;\n    this.pname = pname;\n    if (toParent) this.messageSubscribers.push(toParent);\n    this.id = Symbol(pname);\n    this.state = null;\n    this.exitWaiter = makeWaiter();\n    this.pvtReady = makeWaiter();\n    this.pvtResolveReady = this.pvtReady.resolve;\n  }\n\n  /** Compact handle for `util.inspect` — actor state often holds process\n   *  references, and dumping the internals would be unreadable. */\n  [Symbol.for(\"nodejs.util.inspect.custom\")](): string {\n    return `AsyncProcess<${this.pname}>`;\n  }\n\n  /** Promise that resolves once the initial state is available. */\n  ready(): Promise<void> {\n    return this.pvtReady.promise;\n  }\n\n  // ---- lifecycle ------------------------------------------------------------\n\n  /**\n   * Kick off the async generator. The first `yield` sets the initial\n   * state; for async generators this happens in a microtask.\n   */\n  start(arg0: Args, parentName?: string | null, parentId?: symbol | null) {\n    const selfCtx: SenderInfo = { fromName: this.pname, fromId: this.id };\n\n    const ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage> = {\n      pname: this.pname,\n      id: this.id,\n      parentName: parentName ?? null,\n      parentId: parentId ?? null,\n      fork: this.fork.bind(this),\n      forkSync: this.forkSync.bind(this),\n      children: this.children,\n      orphans: this.orphans,\n      adopt: this.adopt.bind(this),\n      monitor: this.monitor.bind(this),\n      sendSelf: (msg) => {\n        this.send([msg, selfCtx]);\n      },\n      toParent: (msg) => {\n        this.messageSubscribers.forEach((cb) => cb(msg as OutMessage, selfCtx));\n      },\n    };\n\n    this.current = this.pvtWatchExit(ctx, arg0);\n    void this.current.next().then((ret: IteratorResult<State | null, void>) => {\n      this.state = ret.value ?? null;\n      this.pvtResolveReady();\n      if (ret.done) {\n        this.exitWaiter.resolve();\n        return;\n      }\n      // Advance past the initial yield so the pvtWatchExit generator\n      // runs its finally block (EXIT/STOP) and the inner generator\n      // enters its dispatch loop.\n      const advance: WithSender<InMessage | StopMessage> = [\n        { type: \"__ADVANCE__\" } as InMessage,\n        {\n          fromName: \"__internal__\",\n          fromId: Symbol(\"__internal__\"),\n        } as SenderInfo,\n      ];\n      this.pvtEatResult(this.current!.next(advance));\n    });\n    return this;\n  }\n\n  /** Wrap the user's generator so EXIT/STOP logic fires on completion. */\n  private async *pvtWatchExit(\n    ctx: ProcessCtx<Args, State, InMessage, OutMessage | ExitMessage>,\n    arg0: Args,\n  ): AsyncProcessGenerator<State, InMessage> {\n    try {\n      yield* this.pgenerator(ctx, arg0);\n    } finally {\n      // Cascade: stop every child (nice) and collect the refusers as orphans.\n      const orphans: Array<AnyProcess> = [...this.orphans];\n      const parentSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      const stopPromises = this.children.map(async (child) => {\n        const stopped = await child.stop({ from: parentSender });\n        if (!stopped) {\n          orphans.push(child);\n          console.warn(\n            `posipaki: child \"${child.pname}\" did not stop within ${CHILD_STOP_TIMEOUT_MS}ms; continuing shutdown`,\n          );\n        }\n      });\n\n      await Promise.all(stopPromises);\n      // Hand surviving children and inherited orphans up to the parent for adoption (see ctx-orphans proposal).\n      // In-process only.\n      this.pvtPrepareHandoff(orphans);\n      ctx.toParent({ type: \"EXIT\", orphans });\n      // Unsubscribe from children/monitored processes so a dead parent\n      // doesn't keep receiving their messages (handoff collectors stay on the orphans).\n      this.pvtUnsubscribeAll();\n      if (ctx.afterExit) await ctx.afterExit();\n    }\n  }\n\n  // ---- fork -----------------------------------------------------------------\n\n  fork<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    fn: AsyncProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (args: ChildArgs) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return (args: ChildArgs) => {\n      const child = new AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>(fn, pname);\n      this.adopt(child);\n      child.start(args, this.pname, this.id);\n      return child;\n    };\n  }\n\n  forkSync<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends InMessage>(\n    fn: ProcessFn<ChildArgs, ChildState, ChildIM, ChildOM>,\n    pname: string,\n  ): (args: ChildArgs) => AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}> {\n    return this.fork(asyncify(fn), pname);\n  }\n\n  // ---- message processing ---------------------------------------------------\n\n  protected async pvtTick(): Promise<void> {\n    if (!this.current || this.pvtTickInProgress) return;\n\n    this.pvtTickInProgress = true;\n    try {\n      let msgAndSender: WithSender<InMessage | StopMessage> | undefined;\n      let ret: IteratorResult<State | null, void> | null = null;\n      while ((msgAndSender = this.buffer.shift()) !== undefined) {\n        ret = await this.pvtSafeNext(msgAndSender);\n        if (!ret || ret.done) break;\n      }\n      this.notify();\n      this.pvtEatResult(ret);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n    } finally {\n      this.pvtTickInProgress = false;\n    }\n  }\n\n  /** Call `.next()` and redirect unhandled rejections. */\n  private async pvtSafeNext(\n    msgAndSender: WithSender<InMessage | StopMessage>,\n  ): Promise<IteratorResult<State | null, void> | null> {\n    try {\n      return await this.current!.next(msgAndSender);\n    } catch (e) {\n      this.pvtExitReject?.(e);\n      this.pvtExitReject = null;\n      return { done: true, value: undefined };\n    }\n  }\n\n  private pvtEatResult(\n    ret: IteratorResult<State | null, void> | Promise<IteratorResult<State | null, void>> | null,\n  ): void {\n    if (!ret) return;\n    Promise.resolve(ret).then((r) => {\n      if (r.done) {\n        this.exitWaiter.resolve();\n      }\n    });\n  }\n\n  /** Broadcast a message to all children. */\n  toAllChildren(msg: Message): void {\n    const stamp: SenderInfo = { fromName: this.pname, fromId: this.id };\n    this.children.forEach((p) => p.send([msg, stamp] as WithSender<Message>));\n  }\n\n  /** Stamp and enqueue a message from a named sender (external API). */\n  send(msg: InMessage | StopMessage, from?: SenderInfo): void;\n  /** Enqueue a pre-stamped message (internal: fromChild, toAllChildren). */\n  send(msgAndSender: WithSender<InMessage | StopMessage>): void;\n  send(\n    msgOrTuple: InMessage | StopMessage | WithSender<InMessage | StopMessage>,\n    from?: SenderInfo,\n  ): void {\n    if (this.pvtDead) return;\n    if (\"type\" in msgOrTuple) {\n      this.buffer.push([msgOrTuple as InMessage | StopMessage, from as SenderInfo]);\n    } else {\n      this.buffer.push(msgOrTuple as WithSender<InMessage | StopMessage>);\n    }\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Synchronously flush the buffer. For sync processes use {@link Process.tick};\n   * for async processes this is **not guaranteed** to process everything\n   * immediately if reducers contain `await`. Prefer `send()` + `await proc.wait()`.\n   */\n  tick(): void {\n    this.nextTick?.flush();\n    this.nextTick = null;\n  }\n\n  private pvtScheduleTick(): void {\n    if (this.pvtIsPaused || this.pvtDead) return;\n\n    this.nextTick?.cancel();\n    this.nextTick = defer(() => {\n      this.nextTick = null;\n      void this.pvtTick();\n    });\n  }\n\n  // ---- subscribers ----------------------------------------------------------\n\n  notify(): void {\n    this.stateSubscribers.forEach((f) => f());\n  }\n\n  get isListenedTo(): boolean {\n    return this.stateSubscribers.length > 0;\n  }\n\n  subscribe(channel: \"message\", cb: MessageCallback<OutMessage>): () => void;\n  subscribe(channel: \"state\", cb: NotifyFn): () => void;\n  /** @deprecated Use `subscribe(\"state\", cb)`. */\n  subscribe(cb: NotifyFn): () => void;\n  subscribe(\n    channelOrCb: \"message\" | \"state\" | NotifyFn,\n    cb?: MessageCallback<OutMessage> | NotifyFn,\n  ): () => void {\n    if (typeof channelOrCb === \"function\") {\n      return this.subscribe(\"state\", channelOrCb);\n    }\n    if (channelOrCb === \"message\") {\n      const fn = cb as MessageCallback<OutMessage>;\n      this.messageSubscribers.push(fn);\n      return () => this.pvtUnsubscribe(this.messageSubscribers, fn);\n    }\n    const fn = cb as NotifyFn;\n    this.stateSubscribers.push(fn);\n    return () => this.pvtUnsubscribe(this.stateSubscribers, fn);\n  }\n\n  private pvtUnsubscribe<T>(list: Array<T>, fn: T): void {\n    const idx = list.indexOf(fn);\n    if (idx >= 0) list.splice(idx, 1);\n  }\n\n  // ---- pause / resume -------------------------------------------------------\n\n  /**\n   * Freeze dispatch: no further ticks are scheduled, so the process stops\n   * *processing* incoming messages.  This is half-working as a \"quiesce\"\n   * primitive — it does not stop the process from *emitting* via async\n   * callbacks (timers, fetch) that bypass the dispatch loop.\n   */\n  pause(): void {\n    this.nextTick?.cancel();\n    this.nextTick = null;\n    this.pvtIsPaused = true;\n  }\n\n  resume(): void {\n    this.pvtIsPaused = false;\n    this.pvtScheduleTick();\n  }\n\n  /**\n   * Hard-kill this process: abandon the generator without running its\n   * `finally` (no EXIT, no STOP cascade), drop the inbox and observers,\n   * unsubscribe from children/monitors, and settle `wait()`/`ready()`.\n   *\n   * There is nothing to observe afterward — callers remove the process from\n   * their `children`/`orphans` lists imperatively.  Does not cascade to this\n   * process's own children; they are abandoned (force-stop them separately if\n   * owned).\n   *\n   * Best-effort: an idle generator (suspended at `yield`) is abandoned\n   * cleanly; a generator mid-`await` completes its `finally` when that await\n   * settles, because JS offers no way to cancel a pending promise.\n   */\n  forceStop(opts?: { cascade?: boolean }): void {\n    if (this.pvtDead) return;\n    this.pvtDead = true;\n\n    // Abandon the generator so its finally block never runs.\n    this.current = null;\n\n    // Drop the inbox and stop scheduling.\n    this.buffer.length = 0;\n    this.nextTick?.cancel();\n    this.nextTick = null;\n\n    // Release incoming observers and outgoing subscriptions.\n    this.messageSubscribers.length = 0;\n    this.stateSubscribers.length = 0;\n    this.pvtUnsubscribeAll();\n    // Drop any handoff state this process carried as an unowned orphan.\n    this.unparent();\n\n    // Settle waiters.\n    this.pvtResolveReady();\n    this.exitWaiter.resolve();\n    this.pvtExitReject = null;\n\n    if (opts?.cascade) {\n      // Stop the children too, starting with the nice stop (fire-and-forget:\n      // the hard kill itself does not block on their graceful exit).\n      const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n      for (const child of this.children) {\n        void child.stop({ force: true, from: selfSender }).catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Stop this process.  Sends STOP (the nice way — the generator cooperates\n   * and its `finally` runs) and awaits on a best-effort basis.\n   *\n   * With `{ force: true }`, when the process refuses (does not exit within the\n   * timeout) it escalates: fires `generator.return()` *without awaiting* (throw\n   * the generator away for GC to find), cascades to children with the same\n   * ladder, then hard-kills itself.\n   *\n   * Resolves `true` if the process stopped (gracefully or forced), `false` if\n   * it refused and `force` was not requested.\n   */\n  async stop(opts?: { force?: boolean; from?: SenderInfo }): Promise<boolean> {\n    if (this.pvtDead) return true;\n\n    this.send({ type: \"STOP\" } as StopMessage, opts?.from);\n\n    try {\n      await withTimeout(this.wait(), CHILD_STOP_TIMEOUT_MS, \"stop\");\n      return true;\n    } catch (e) {\n      if ((e as Error)?.message !== \"Timeout:stop\") throw e;\n      // refused to stop within the timeout\n    }\n\n    if (!opts?.force) return false;\n\n    // Escalate: give the finally a chance to run (fire-and-forget), but do not\n    // block on it — the process may be stuck awaiting a dead promise.\n    void this.current?.return(undefined);\n\n    // Cascade to children with the same ladder, stamped from this process.\n    const selfSender: SenderInfo = { fromName: this.pname, fromId: this.id };\n    await Promise.all(\n      [...this.children].map((child) => child.stop({ force: true, from: selfSender })),\n    );\n\n    this.forceStop();\n    return true;\n  }\n\n  // ---- waiting --------------------------------------------------------------\n\n  /**\n   * Returns a promise that resolves when the generator completes, or\n   * rejects if an unhandled error occurs during message processing.\n   */\n  wait(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      this.pvtExitReject = reject;\n\n      this.exitWaiter.promise.then(\n        () => {\n          this.pvtExitReject = null;\n          resolve();\n        },\n        (e) => {\n          this.pvtExitReject = null;\n          reject(e);\n        },\n      );\n    });\n  }\n\n  // ---- child messages -------------------------------------------------------\n\n  /**\n   * Tap another process's message channel: every message it emits is fed\n   * into this process's incoming queue.  No ownership — the sender's EXIT\n   * does not touch `children`/`orphans`.\n   */\n  monitor<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.send([msg, from] as WithSender<InMessage | StopMessage>);\n    });\n    this.pvtOutgoingSubscriptions.push(unsub);\n    return unsub;\n  }\n\n  /**\n   * Claim another process as a child: its messages are routed here and its\n   * EXIT removes it from `children` (collecting its orphans).  Generalizes\n   * what `fork` does — used for both spawning and orphan adoption.\n   */\n  adopt<ChildArgs, ChildState, ChildIM extends Message, ChildOM extends Message>(\n    child: AsyncProcess<ChildArgs, ChildState, ChildIM, ChildOM, {}>,\n  ): () => void {\n    this.children.push(child as unknown as AnyProcess);\n    const unsub = child.subscribe(\"message\", (msg, from) => {\n      this.pvtChildMessage(msg, from);\n    });\n    this.pvtAdoptUnsubs.set(child.id, unsub);\n    // Lossless handoff: drain a pending buffer left by the previous parent.\n    this.pvtDrainPending(child as unknown as AnyProcess);\n    return unsub;\n  }\n\n  /** Handles a child's emitted message: EXIT cleanup + forward to the queue. */\n  private pvtChildMessage(msg: Message, sender: SenderInfo): void {\n    if (msg.type === \"EXIT\") {\n      // sender.fromId === child's id (stamped by the child's ctx.toParent)\n      // Mutate in place so ctx.children (a live reference) stays consistent.\n      const idx = this.children.findIndex((p) => p.id === sender.fromId);\n      if (idx >= 0) this.children.splice(idx, 1);\n      const orphans = (msg as ExitMessage).orphans;\n      if (orphans && orphans.length > 0) {\n        this.orphans.push(...orphans);\n      }\n    }\n    this.send([msg, sender] as WithSender<InMessage | StopMessage>);\n  }\n\n  // ---- orphan handoff -------------------------------------------------------\n\n  /** Unsubscribe from all outgoing subscriptions (monitors + adopt). */\n  private pvtUnsubscribeAll(): void {\n    for (const unsub of this.pvtOutgoingSubscriptions) unsub();\n    this.pvtOutgoingSubscriptions = [];\n    for (const unsub of this.pvtAdoptUnsubs.values()) unsub();\n    this.pvtAdoptUnsubs.clear();\n  }\n\n  /** Prepare surviving children and inherited orphans for a lossless handoff:\n   *  recover undrained messages and install a collector on each orphan. */\n  private pvtPrepareHandoff(orphans: Array<AnyProcess>): void {\n    for (const orphan of orphans) {\n      this.pvtBackFeed(orphan);\n      if (!orphan.pvtCollectorUnsub) {\n        this.pvtSwapToCollector(orphan);\n      }\n    }\n  }\n\n  /** Recover messages the orphan emitted into my inbox that I never drained. */\n  private pvtBackFeed(orphan: AnyProcess): void {\n    const fromOrphan: Array<WithSender<Message>> = [];\n    this.buffer = this.buffer.filter((entry) => {\n      if (entry[1].fromId === orphan.id) {\n        fromOrphan.push(entry);\n        return false;\n      }\n      return true;\n    });\n    if (fromOrphan.length === 0) return;\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    orphan.pvtPending.unshift(...fromOrphan);\n  }\n\n  /** Replace my ownership subscription to `orphan` with a handoff collector. */\n  private pvtSwapToCollector(orphan: AnyProcess): void {\n    const mine = this.pvtAdoptUnsubs.get(orphan.id);\n    if (mine) {\n      mine();\n      this.pvtAdoptUnsubs.delete(orphan.id);\n    }\n    if (!orphan.pvtPending) orphan.pvtPending = [];\n    const pending = orphan.pvtPending;\n    orphan.pvtCollectorUnsub = orphan.subscribe(\"message\", (msg, from) => {\n      pending.push([msg, from]);\n    });\n  }\n\n  /** Drain a handed-off orphan's pending buffer into my inbox (lossless adopt). */\n  private pvtDrainPending(orphan: AnyProcess): void {\n    if (orphan.pvtCollectorUnsub) {\n      orphan.pvtCollectorUnsub();\n      orphan.pvtCollectorUnsub = null;\n    }\n    const pending = orphan.pvtPending;\n    if (!pending) return;\n    orphan.pvtPending = null;\n    for (const [msg, from] of pending) {\n      this.pvtChildMessage(msg, from);\n    }\n  }\n\n  /**\n   * Drop this process's handoff state (collector + pending buffer) without\n   * stopping it.  Used by `onOrphan`'s \"unparent\" decision: the orphan keeps\n   * running and stays in the orphans list, but its in-flight buffer is gone.\n   */\n  unparent(): void {\n    if (this.pvtCollectorUnsub) {\n      this.pvtCollectorUnsub();\n      this.pvtCollectorUnsub = null;\n    }\n    this.pvtPending = null;\n  }\n}\nexport type AnyProcess = AsyncProcess<unknown, unknown, Message, Message, {}>;\n// ---- spawnAsync -------------------------------------------------------------\n\n/**\n * Spawn a new async process. Accepts both sync and async process\n * functions — sync ones are automatically wrapped with {@link asyncify}.\n */\nexport function spawnAsync<\n  Args,\n  State,\n  InMessage extends Message = Message,\n  OutMessage extends Message = ExitMessage,\n>(\n  fn: AsyncProcessFn<Args, State, InMessage, OutMessage>,\n  pname: string,\n  toParent?: MessageCallback<OutMessage>,\n): (args: Args) => AsyncProcess<Args, State, InMessage, OutMessage, {}> {\n  return (args: Args) => {\n    const proc = new AsyncProcess<Args, State, InMessage, OutMessage, {}>(fn, pname, toParent);\n    proc.start(args);\n    return proc;\n  };\n}\n","import { AsyncProcess } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\nimport type { Message, SenderInfo, ExitMessage, ProcessFn } from \"./types.js\";\n\nexport type { Message, ProcessFn, ProcessCtx } from \"./types.js\";\nexport { runDispatch } from \"./util.js\";\n\n/** @deprecated Use {@link spawnAsync} instead. */\nexport function spawn<A, S, IM extends Message = Message, OM extends Message = ExitMessage>(\n  fn: ProcessFn<A, S, IM, OM>,\n  pname: string,\n  tp?: (m: OM, from: SenderInfo) => void,\n): (a: A) => Process<A, S, IM, OM> {\n  return (a: A) => new Process(fn, pname, tp).start(a);\n}\n\n/** @deprecated Use {@link AsyncProcess} instead. Sync processes are\n *  wrapped via asyncify internally; spawnAsync handles both. */\nclass Process<A, S, IM extends Message, OM extends Message> extends AsyncProcess<A, S, IM, OM, {}> {\n  constructor(fn: ProcessFn<A, S, IM, OM>, pname: string, tp?: (m: OM, from: SenderInfo) => void) {\n    super(asyncify(fn), pname, tp);\n  }\n\n  start(a: A) {\n    super.start(a);\n    return this;\n  }\n  tick(): Promise<void> {\n    return super.pvtTick();\n  }\n}\n\nexport { Process };\n","// ── defineActor — high-level actor wrapper ───────────────────────────────────\n//\n// Compiles a declarative config into an AsyncProcessFn.  Built on top of\n// the existing runDispatchAsync / spawnAsync primitives.\n//\nimport { type AsyncProcess, runDispatchAsync, spawnAsync, AnyProcess } from \"./process.async.js\";\nimport type {\n  WithSender,\n  SenderInfo,\n  AsyncProcessFn,\n  Message,\n  ExitMessage,\n  ProcessCtx,\n} from \"./types.js\";\nimport type {\n  ActorDefinition,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  ActorMessages,\n  HandlerOptions,\n  HandlerFn,\n  ReflectionOptions,\n  AnyConfig,\n  HidePrivate,\n} from \"./actor-types.js\";\nimport { STOP_SENTINEL } from \"./actor-types.js\";\nimport { ActorDecorated, type ActorPlugin, ActorReflection, callHook } from \"./hooks.js\";\n\nexport function defineMessages<OutMsg extends Message = Message>(): ActorMessages<OutMsg> {\n  return undefined as unknown as ActorMessages<OutMsg>;\n}\n\nfunction hidePrivate<T>(value: T): HidePrivate<T> {\n  if (value && typeof value === \"object\" && \"private\" in value && \"public\" in value) {\n    return value.public as HidePrivate<T>;\n  }\n  return value as HidePrivate<T>;\n}\n\nfunction resolvePlugins(\n  raw: ActorPlugin[] | ((parents: ActorPlugin[]) => ActorPlugin[]) | undefined,\n  parentPlugins?: ActorPlugin[],\n  addPlugins?: ActorPlugin[],\n): ActorPlugin[] {\n  const resolved = !raw\n    ? parentPlugins\n      ? [...parentPlugins]\n      : []\n    : Array.isArray(raw)\n      ? [...raw]\n      : raw(parentPlugins ?? []);\n\n  const combined = addPlugins ? [...resolved, ...addPlugins] : resolved;\n\n  // Deduplicate by function name\n  const seen = new Set<string>();\n  return combined.filter((p) => {\n    const name = p.name;\n    if (!name) {\n      console.warn(\"posipaki: plugin has no name, dedup won't work\");\n      return true;\n    }\n    if (seen.has(name)) return false;\n    seen.add(name);\n    return true;\n  });\n}\n\nasync function assembleActor<C>(\n  config: C,\n  plugins: ActorPlugin[],\n  addPlugins?: ActorPlugin[],\n): Promise<C> {\n  // Work with the default ActorPlugin type internally, cast back on return\n  let cur = config as AnyConfig;\n  for (const p of plugins) {\n    try {\n      cur = await p(cur);\n    } catch (e: unknown) {\n      console.error(`[assembleActor] plugin \"${p.name || \"?\"}\" failed:`, e);\n    }\n  }\n  cur.resolvedPlugins = plugins;\n  if (addPlugins) cur.addPlugins = addPlugins;\n  return cur as C;\n}\n\nexport function defineActor<\n  Args,\n  InternalState,\n  InMsg extends Message,\n  OutMsg extends Message,\n  Methods extends MethodOptions,\n  Handlers extends HandlerOptions<InMsg>,\n  ReflectionMethods extends ReflectionOptions,\n>(\n  config: ActorConfig<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>,\n): ActorDefinition<Args, InternalState, InMsg, OutMsg, ReflectionMethods> {\n  const actorCtxMap = new Map<\n    symbol,\n    ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>\n  >();\n\n  function makeRuntime(\n    assembly: ActorConfig<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>,\n  ): AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg> {\n    return async function* (\n      ctx,\n      args,\n    ): AsyncGenerator<HidePrivate<InternalState | null>, void, WithSender<InMsg>> {\n      let done = false;\n      let exitReason: unknown;\n      let rawState: InternalState = undefined as unknown as InternalState;\n\n      const decorated = new Map();\n      const self: ActorContext<\n        Args,\n        InternalState,\n        InMsg,\n        OutMsg,\n        Methods,\n        Handlers,\n        ReflectionMethods & ActorReflection\n      > = {\n        ctx,\n        ...((assembly.methods || {}) as Methods),\n        ...((assembly.$decorate || {}) as ActorDecorated),\n        reflection: {} as ReflectionMethods & ActorReflection,\n        state: rawState,\n        name: ctx.pname,\n        id: ctx.id,\n        async emit(msg: OutMsg) {\n          await callHook(assembly.onEmit, undefined, self, msg, {\n            fromName: ctx.pname,\n            fromId: ctx.id,\n          });\n          ctx.toParent(msg);\n        },\n        agreeToStop() {\n          exitReason = \"stopped\";\n          done = true;\n        },\n        exit(reason: unknown) {\n          exitReason = reason;\n          done = true;\n        },\n        $child: {} as Record<string, AnyProcess>,\n        decorators: {},\n        fork: async <A, S, IM extends Message, OM extends InMsg, R extends ReflectionOptions>(\n          childActor: ActorDefinition<A, S, IM, OM, R>,\n          childArgs?: A,\n          forkOpts?: { name?: string; addPlugins?: ActorPlugin[] },\n        ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>> => {\n          let child: AsyncProcess<A, HidePrivate<S>, IM, OM, R & ActorReflection>;\n          const childName =\n            forkOpts?.name ?? childActor?.name ?? `child-${Object.keys(self.$child).length}`;\n          const treeName = `${ctx.pname}:${childName}`;\n          const childAddPlugins = [...(assembly.addPlugins || []), ...(forkOpts?.addPlugins || [])];\n          child = await childActor.spawnAsChild(ctx, childArgs!, {\n            name: treeName,\n            parentPlugins: assembly.resolvedPlugins || [],\n            ...(childAddPlugins.length ? { addPlugins: childAddPlugins } : {}),\n          });\n          self.$child[child.pname] = child as unknown as AnyProcess;\n          return child;\n        },\n      };\n      actorCtxMap.set(ctx.id, self);\n      ctx.afterExit = async () => {\n        await callHook(assembly.afterEnd, assembly.onError, self, exitReason);\n      };\n\n      for (const [k, v] of decorated) {\n        (self as Record<string, unknown>)[k] = v;\n      }\n\n      await callHook(\n        assembly.beforeStart,\n        assembly.onError,\n        self as ActorContext<\n          Args,\n          never, // state not set yet\n          InMsg,\n          OutMsg,\n          Methods,\n          Handlers,\n          ReflectionMethods & ActorReflection\n        >,\n      );\n\n      if (assembly.setup) {\n        rawState = await assembly.setup.call(\n          self as ActorContext<\n            Args,\n            never, // break inference cycle here\n            InMsg,\n            OutMsg,\n            Methods,\n            Handlers,\n            ReflectionMethods & ActorReflection\n          >,\n          args,\n        );\n      } else {\n        rawState = null as InternalState;\n      }\n      self.state = rawState;\n      yield hidePrivate(rawState);\n      await callHook(assembly.afterStart, assembly.onError, self);\n\n      yield* runDispatchAsync<WithSender<InMsg | ExitMessage>>(\n        ctx.pname,\n        async (stamped) => {\n          const [msg, sender] = stamped;\n          if (msg.type === \"STOP\") {\n            if (assembly.onStopRequested) {\n              await callHook(assembly.onStopRequested, assembly.onError, self);\n              // Hook may call agreeToStop(). If not, actor keeps running.\n            } else {\n              exitReason = \"stopped\";\n              done = true;\n            }\n            return;\n          }\n          if (msg.type === \"EXIT\") {\n            // FIXME: process name are user-specified\n            // and should not be used for indexing so\n            // we don't get into name conflicts\n            const childName = sender.fromName;\n            if (childName && self.$child[childName]) {\n              delete self.$child[childName];\n            }\n            await callHook(\n              assembly.onChildExit,\n              assembly.onError,\n              self,\n              childName,\n              msg as ExitMessage,\n            );\n            // Orphan policy: a child that exits may leave still-running\n            // grandchildren behind (see ctx-orphans / orphan-policy).\n            const orphans = (msg as ExitMessage).orphans;\n            if (orphans && orphans.length > 0) {\n              for (const orphan of orphans) {\n                // Default when no hook is defined: hard-kill the orphan.\n                const decision = assembly.onOrphan\n                  ? await callHook(assembly.onOrphan, assembly.onError, self, orphan)\n                  : \"force-stop\";\n                if (decision === \"adopt\") {\n                  ctx.adopt(orphan);\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                  self.$child[orphan.pname] = orphan;\n                } else if (decision === \"force-stop\") {\n                  orphan.forceStop({ cascade: true });\n                  const idx = ctx.orphans.indexOf(orphan);\n                  if (idx >= 0) ctx.orphans.splice(idx, 1);\n                } else if (decision === \"unparent\") {\n                  orphan.unparent();\n                }\n                // 'leave' (or undefined) → do nothing; it propagates on exit.\n              }\n            }\n          }\n          let hookStopped = false;\n          if (msg.type !== \"STOP\" && msg.type !== \"EXIT\" && assembly.onMessage) {\n            const result = await callHook(\n              assembly.onMessage,\n              assembly.onError,\n              self,\n              msg as InMsg,\n              sender,\n            );\n            if (result === STOP_SENTINEL) hookStopped = true;\n          }\n          if (msg.type !== \"STOP\" && !hookStopped) {\n            const handler =\n              ((assembly.handlers || ({} as Handlers))[\n                msg.type as keyof Handlers\n              ] as HandlerFn<InMsg>) || assembly.onUnhandled;\n\n            await callHook(handler, assembly.onError, self, msg as InMsg, sender);\n          }\n        },\n        () => done,\n      );\n\n      await callHook(assembly.beforeEnd, assembly.onError, self, exitReason);\n    };\n  }\n\n  type ReflectableProcess = {\n    id: symbol;\n    $reflection: Record<string, Function>;\n  };\n  function attachReflection(\n    proc: ReflectableProcess,\n    reflectionMethods: ReflectionMethods | undefined,\n  ): void {\n    if (!reflectionMethods) return;\n    const self = actorCtxMap.get(proc.id);\n    const refl = proc.$reflection as Record<string, Function>;\n    for (const [k, m] of Object.entries(reflectionMethods)) {\n      refl[k] = m.bind(self);\n    }\n  }\n\n  return {\n    fn: makeRuntime(config),\n    name: config.name,\n    pvtPluginsRaw: config.plugins,\n    inMessages: config.inMessages,\n    outMessages: config.outMessages,\n    async spawn(\n      args: Args,\n      opts?: {\n        name?: string;\n        toParent?: (msg: OutMsg, from: SenderInfo) => void;\n        addPlugins?: ActorPlugin[];\n      },\n    ): Promise<\n      AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >\n    > {\n      const plugs = resolvePlugins(config.plugins, undefined, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = spawnAsync(\n        runtime,\n        opts?.name ?? assembly.name ?? \"actor\",\n        opts?.toParent,\n      )(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n    async spawnAsChild(\n      ctx: ProcessCtx<unknown, unknown, OutMsg, Message>,\n      args: Args,\n      opts?: {\n        name?: string;\n        parentPlugins?: ActorPlugin[];\n        addPlugins?: ActorPlugin[];\n      },\n    ) {\n      const plugs = resolvePlugins(config.plugins, opts?.parentPlugins, opts?.addPlugins);\n      const assembly = await assembleActor(config, plugs, opts?.addPlugins);\n      const runtime = makeRuntime(assembly);\n      const proc = ctx.fork(runtime, opts?.name ?? assembly.name ?? \"child\")(args);\n      attachReflection(proc, assembly.$reflectionMethods as ReflectionMethods);\n      return proc as AsyncProcess<\n        Args,\n        HidePrivate<InternalState>,\n        InMsg,\n        OutMsg,\n        ReflectionMethods & ActorReflection\n      >;\n    },\n  };\n}\n","/**\n * Posipaki — Erlang-inspired lightweight actor processes built on\n * generator functions. Processes communicate via message-passing,\n * can fork children, and expose their state reactively.\n *\n * @module\n */\n\nimport { Process, spawn } from \"./process.js\";\nimport { runDispatch } from \"./util.js\";\nimport { AsyncProcess, spawnAsync, runDispatchAsync } from \"./process.async.js\";\nimport { asyncify } from \"./adapters.js\";\n\nexport { Process, spawn, runDispatch };\nexport { AsyncProcess, spawnAsync, runDispatchAsync, asyncify };\nexport type { AnyProcess } from \"./process.async.js\";\n\nexport type {\n  Message,\n  WithSender,\n  WithoutSender,\n  ExitMessage,\n  StopMessage,\n  ProcessFn,\n  ProcessCtx,\n  AsyncProcessFn,\n  PipeState,\n  SupervisorState,\n  SenderOrigin,\n  SenderInfo,\n} from \"./types.js\";\n\nexport { defineActor, defineMessages } from \"./define-actor.js\";\nexport type {\n  ActorDefinition,\n  SpawnedFrom,\n  ActorConfig,\n  ActorContext,\n  MethodOptions,\n  HandlerOptions,\n  HandlerFn,\n} from \"./actor-types.js\";\n\n// ── hooks ─────────────────────────────────────────────────────────────────\n\nexport { stopPropagation, mergeConfigs, chainHook, callHook } from \"./hooks.js\";\nexport type {\n  HookResult,\n  ActorPlugin,\n  ActorDecorated,\n  ActorReflection,\n  PluginTransform,\n} from \"./hooks.js\";\n"],"mappings":"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"}

package/dist/supervisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.js","names":[],"sources":["../src/supervisor.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { Process, ProcessFn, ProcessCtx } from \"./process.js\";\nimport type { WithSender } from \"./types.js\";\nimport type { ExitMessage } from \"./util.js\";\n\n// ---- messages ---------------------------------------------------------------\n\ntype SupMsg = ExitMessage | RunMsg | StopMsg | ErrorMsg | OkMsg;\n\ninterface RunMsg {\n  type: \"RUN\";\n  fn: ProcessFn<any, any, any, any>;\n  args: any[];\n  pname: string;\n}\n\ninterface StopMsg {\n  type: \"STOP\";\n}\n\ninterface ErrorMsg {\n  type: \"ERROR\";\n}\n\ninterface OkMsg {\n  type: \"OK\";\n  [key: string]: unknown;\n}\n\n// ---- state ------------------------------------------------------------------\n\nexport interface SupervisorState {\n  processes: Process<any, any, any, any>[];\n  phase: \"wait\" | \"running\" | \"stopping\";\n}\n\n// ---- supervise --------------------------------------------------------------\n\n/**\n * A supervisor process. Call `attach` to send it `RUN` messages —\n * it will fork the given function as a child. The supervisor exits\n * when it enters `'stopping'` phase (triggered by `ERROR` or `STOP`).\n *\n * @param wrap  optional transformation applied to the state before\n *              each yield (e.g. `reactive` from Vue)\n */\nfunction* supervise(\n  { pname, toParent, fork }: ProcessCtx<null, SupervisorState, SupMsg, SupMsg>,\n  wrap: (s: SupervisorState) => SupervisorState = (a) => a,\n  debugLevel = false,\n): Generator<SupervisorState | null, void, WithSender<SupMsg>> {\n  const state = wrap({ processes: [], phase: \"wait\" });\n  yield state;\n\n  yield* runDispatch<WithSender<SupMsg>>(\n    pname,\n    (maybe) => {\n      const [msg, _sender] = maybe;\n      switch (msg.type) {\n        case \"RUN\":\n          (fork as (...a: any[]) => any)(msg.fn, msg.pname)(...msg.args);\n          state.phase = \"running\";\n          break;\n        case \"ERROR\":\n        case \"STOP\":\n          state.phase = \"stopping\";\n          break;\n        case \"EXIT\":\n          state.processes = state.processes.filter((p) => p.id !== _sender.fromId);\n          break;\n        case \"OK\":\n          toParent(msg);\n          break;\n      }\n    },\n    () => state.phase === \"stopping\",\n    debugLevel,\n  );\n}\n\n// ---- attach -----------------------------------------------------------------\n\n/**\n * Bind a process function to a supervisor. The returned function,\n * when called, sends a `RUN` message so the supervisor forks the child.\n */\nfunction attach<Args extends any[]>(\n  supervisor: Process<any, any, SupMsg, SupMsg>,\n  fn: ProcessFn<Args, any, any, any>,\n  pname: string,\n): (...args: Args) => void {\n  return (...args) => {\n    supervisor.send({ type: \"RUN\", fn, args, pname } as SupMsg, { fromName: \"external\", fromId: Symbol(\"external\") });\n  };\n}\n\nexport { attach, supervise };\n"],"mappings":";;;;;;;;;;AA8CA,UAAU,UACR,EAAE,OAAO,UAAU,QACnB,QAAiD,MAAM,GACvD,aAAa,OACgD;CAC7D,MAAM,QAAQ,KAAK;EAAE,WAAW,CAAC;EAAG,OAAO;CAAO,CAAC;CACnD,MAAM;CAEN,OAAO,YACL,QACC,UAAU;EACT,MAAM,CAAC,KAAK,WAAW;EACvB,QAAQ,IAAI,MAAZ;GACE,KAAK;IACH,KAA+B,IAAI,IAAI,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,IAAI;IAC7D,MAAM,QAAQ;IACd;GACF,KAAK;GACL,KAAK;IACH,MAAM,QAAQ;IACd;GACF,KAAK;IACH,MAAM,YAAY,MAAM,UAAU,QAAQ,MAAM,EAAE,OAAO,QAAQ,MAAM;IACvE;GACF,KAAK,MACH,SAAS,GAAG;EAEhB;CACF,SACM,MAAM,UAAU,YACtB,UACF;AACF;;;;;AAQA,SAAS,OACP,YACA,IACA,OACyB;CACzB,QAAQ,GAAG,SAAS;EAClB,WAAW,KAAK;GAAE,MAAM;GAAO;GAAI;GAAM;EAAM,GAAa;GAAE,UAAU;GAAY,QAAQ,OAAO,UAAU;EAAE,CAAC;CAClH;AACF"}
+{"version":3,"file":"supervisor.js","names":[],"sources":["../src/supervisor.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { Process, ProcessFn, ProcessCtx } from \"./process.js\";\nimport type { WithSender } from \"./types.js\";\nimport type { ExitMessage } from \"./util.js\";\n\n// ---- messages ---------------------------------------------------------------\n\ntype SupMsg = ExitMessage | RunMsg | StopMsg | ErrorMsg | OkMsg;\n\ninterface RunMsg {\n  type: \"RUN\";\n  fn: ProcessFn<any, any, any, any>;\n  args: any[];\n  pname: string;\n}\n\ninterface StopMsg {\n  type: \"STOP\";\n}\n\ninterface ErrorMsg {\n  type: \"ERROR\";\n}\n\ninterface OkMsg {\n  type: \"OK\";\n  [key: string]: unknown;\n}\n\n// ---- state ------------------------------------------------------------------\n\nexport interface SupervisorState {\n  processes: Process<any, any, any, any>[];\n  phase: \"wait\" | \"running\" | \"stopping\";\n}\n\n// ---- supervise --------------------------------------------------------------\n\n/**\n * A supervisor process. Call `attach` to send it `RUN` messages —\n * it will fork the given function as a child. The supervisor exits\n * when it enters `'stopping'` phase (triggered by `ERROR` or `STOP`).\n *\n * @param wrap  optional transformation applied to the state before\n *              each yield (e.g. `reactive` from Vue)\n */\nfunction* supervise(\n  { pname, toParent, fork }: ProcessCtx<null, SupervisorState, SupMsg, SupMsg>,\n  wrap: (s: SupervisorState) => SupervisorState = (a) => a,\n  debugLevel = false,\n): Generator<SupervisorState | null, void, WithSender<SupMsg>> {\n  const state = wrap({ processes: [], phase: \"wait\" });\n  yield state;\n\n  yield* runDispatch<WithSender<SupMsg>>(\n    pname,\n    (maybe) => {\n      const [msg, _sender] = maybe;\n      switch (msg.type) {\n        case \"RUN\":\n          (fork as (...a: any[]) => any)(msg.fn, msg.pname)(...msg.args);\n          state.phase = \"running\";\n          break;\n        case \"ERROR\":\n        case \"STOP\":\n          state.phase = \"stopping\";\n          break;\n        case \"EXIT\":\n          state.processes = state.processes.filter((p) => p.id !== _sender.fromId);\n          break;\n        case \"OK\":\n          toParent(msg);\n          break;\n      }\n    },\n    () => state.phase === \"stopping\",\n    debugLevel,\n  );\n}\n\n// ---- attach -----------------------------------------------------------------\n\n/**\n * Bind a process function to a supervisor. The returned function,\n * when called, sends a `RUN` message so the supervisor forks the child.\n */\nfunction attach<Args extends any[]>(\n  supervisor: Process<any, any, SupMsg, SupMsg>,\n  fn: ProcessFn<Args, any, any, any>,\n  pname: string,\n): (...args: Args) => void {\n  return (...args) => {\n    supervisor.send({ type: \"RUN\", fn, args, pname } as SupMsg, {\n      fromName: \"external\",\n      fromId: Symbol(\"external\"),\n    });\n  };\n}\n\nexport { attach, supervise };\n"],"mappings":";;;;;;;;;;AA8CA,UAAU,UACR,EAAE,OAAO,UAAU,QACnB,QAAiD,MAAM,GACvD,aAAa,OACgD;CAC7D,MAAM,QAAQ,KAAK;EAAE,WAAW,CAAC;EAAG,OAAO;CAAO,CAAC;CACnD,MAAM;CAEN,OAAO,YACL,QACC,UAAU;EACT,MAAM,CAAC,KAAK,WAAW;EACvB,QAAQ,IAAI,MAAZ;GACE,KAAK;IACH,KAA+B,IAAI,IAAI,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,IAAI;IAC7D,MAAM,QAAQ;IACd;GACF,KAAK;GACL,KAAK;IACH,MAAM,QAAQ;IACd;GACF,KAAK;IACH,MAAM,YAAY,MAAM,UAAU,QAAQ,MAAM,EAAE,OAAO,QAAQ,MAAM;IACvE;GACF,KAAK,MACH,SAAS,GAAG;EAEhB;CACF,SACM,MAAM,UAAU,YACtB,UACF;AACF;;;;;AAQA,SAAS,OACP,YACA,IACA,OACyB;CACzB,QAAQ,GAAG,SAAS;EAClB,WAAW,KAAK;GAAE,MAAM;GAAO;GAAI;GAAM;EAAM,GAAa;GAC1D,UAAU;GACV,QAAQ,OAAO,UAAU;EAC3B,CAAC;CACH;AACF"}

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
-import { r as Message } from "../types-B_bUAR9r.js";
-import { d as ActorPlugin } from "../hooks-DL2s94eM.js";
+import { m as AsyncProcess, r as Message } from "../types-B_bUAR9r.js";
+import { d as ActorPlugin } from "../hooks-BSYYoG5e.js";
 //#region src/testing/msg-matcher.d.ts
 type Matcher<M extends Message> = (msg: M, history: M[]) => boolean;
 type MatchSpec<M extends Message> = Matcher<M> | Partial<M> | Array<Partial<M>>;
@@ -52,8 +52,8 @@ declare function createRootTracker(): RootTracker;
 declare function pnameMatch(name: string, patterns: string[]): boolean;
 //#endregion
 //#region src/testing/tick-utils.d.ts
-declare function nextState(proc: any): Promise<unknown>;
-declare function nextMessage(proc: any): Promise<unknown>;
+declare function nextState<A, S, IM extends Message, OM extends Message, R extends object>(proc: AsyncProcess<A, S, IM, OM, R>): Promise<unknown>;
+declare function nextMessage<A, S, IM extends Message, OM extends Message, R extends object>(proc: AsyncProcess<A, S, IM, OM, R>): Promise<unknown>;
 //#endregion
 export { type Collector, type MatchResult, type MatchSpec, type Matcher, type RootTracker, createCollector, createRootTracker, nextMessage, nextState, pnameMatch, times, toMatcher };
 //# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/test-plugin.ts","../../src/testing/pname-match.ts","../../src/testing/tick-utils.ts"],"mappings":";;;KAaY,QAAQ,UAAU,YAAY,KAAK,GAAG,SAAS;KAE/C,UAAU,UAAU,WAC5B,QAAQ,KACR,QAAQ,KACR,MAAM,QAAQ;;iBAUF,UAAU,UAAU,SAAS,MAAM,UAAU,KAAK,QAAQ;;;;;;;;;;;;iBA2B1D,MAAM,UAAU,SAC9B,MAAM,QAAQ,KAAK,QAAQ,IAC3B,YACC,QAAQ;;;UCrCM;EACf;;EAEA;;UAGe,UAAU,UAAU;EACnC,QAAQ;EACR,UAAU;;;;;;;;EAQV,SAAS,qBAAqB,QAAQ;EACtC,KAAK,QAAQ,UAAU,IAAI,qBAAqB,QAAQ;EACxD,MAAM,SAAS,UAAU;;UAGV;EACf,QAAQ;EACR,WAAW;;iBAoBG,gBAAgB,UAAU,SACxC,QAAQ,UAAU,IAClB;EAAS;IACR,UAAU;iBA6FG,qBAAqB;;;;iBCtJrB,WAAW,cAAc;;;iBCRzB,UAAU,YAAI;iBASd,YAAY,YAAI"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/test-plugin.ts","../../src/testing/pname-match.ts","../../src/testing/tick-utils.ts"],"mappings":";;;KAaY,QAAQ,UAAU,YAAY,KAAK,GAAG,SAAS;KAE/C,UAAU,UAAU,WAAW,QAAQ,KAAK,QAAQ,KAAK,MAAM,QAAQ;;iBAUnE,UAAU,UAAU,SAAS,MAAM,UAAU,KAAK,QAAQ;;;;;;;;;;;;iBA2B1D,MAAM,UAAU,SAAS,MAAM,QAAQ,KAAK,QAAQ,IAAI,YAAY,QAAQ;;;UC7B3E;EACf;;EAEA;;UAGe,UAAU,UAAU;EACnC,QAAQ;EACR,UAAU;;;;;;;;EAQV,SAAS,qBAAqB,QAAQ;EACtC,KAAK,QAAQ,UAAU,IAAI,qBAAqB,QAAQ;EACxD,MAAM,SAAS,UAAU;;UAGV;EACf,QAAQ;EACR,WAAW;;iBAmBG,gBAAgB,UAAU,SACxC,QAAQ,UAAU,IAClB;EAAS;IACR,UAAU;iBA6FG,qBAAqB;;;;iBCvJrB,WAAW,cAAc;;;iBCPzB,UAAU,GAAG,GAAG,WAAW,SAAS,WAAW,SAAS,kBACtE,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,KAAE;iBAUrB,YAAY,GAAG,GAAG,WAAW,SAAS,WAAW,SAAS,kBACxE,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,KAAE"}

package/dist/testing/index.js

@@ -135,7 +135,7 @@ function createRootTracker() {
 			roots.add(this);
 		},
 		afterEnd() {
-			roots.delete(this.ctx);
+			roots.delete(this);
 		}
 	});
 	Object.defineProperty(rootTrackerPlugin, "name", { value: "rootTracker" });

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/pname-match.ts","../../src/testing/test-plugin.ts","../../src/testing/tick-utils.ts"],"sourcesContent":["// ── Message Matcher ──────────────────────────────────────────────────────\n//\n// Canonical form: `fn(msg, history) => boolean`.  `msg` is the just-arrived\n// message (also the last element of `history`); `history` is the full\n// accumulated list *including* `msg`.\n//\n// Two shortcuts:\n//   - a message literal `{ type: \"X\" }`  → matches the latest message\n//   - a list `[{...}, {...}]`            → matches the tail of history,\n//                                           in order, from oldest to newest\n\nimport type { Message } from \"../types.js\";\n\nexport type Matcher<M extends Message> = (msg: M, history: M[]) => boolean;\n\nexport type MatchSpec<M extends Message> =\n  | Matcher<M>\n  | Partial<M>\n  | Array<Partial<M>>;\n\nfunction shallowMatch<M extends Message>(msg: M, spec: Partial<M>): boolean {\n  for (const key of Object.keys(spec) as Array<keyof M>) {\n    if (msg[key] !== spec[key]) return false;\n  }\n  return true;\n}\n\n/** Convert a matcher spec to a canonical matcher function. */\nexport function toMatcher<M extends Message>(spec: MatchSpec<M>): Matcher<M> {\n  if (typeof spec === \"function\") return spec as Matcher<M>;\n\n  if (Array.isArray(spec)) {\n    // Sequence: the tail of history must equal `spec`, in order.\n    return (_msg, history) => {\n      if (history.length < spec.length) return false;\n      const tail = history.slice(-spec.length);\n      return spec.every((s, i) => shallowMatch(tail[i], s));\n    };\n  }\n\n  // Single literal: the latest message must shallow-match.\n  return (msg) => shallowMatch(msg, spec);\n}\n\n/**\n * Occurrence matcher: matches when at least `n` messages in the history\n * satisfy `spec`.  This is the canonical form for \"Nth occurrence\" waits:\n *\n *   const c = createCollector<PongMsg>({ type: \"PONG\" });\n *   await c.next(times({ type: \"PONG\" }, 3));  // wait for the 3rd PONG\n *\n * Note: `history` accumulates, so this counts occurrences over the whole\n * collected history, not since the previous `next()`.  Use `reset()` with a\n * fresh collector for windowed counts.\n */\nexport function times<M extends Message>(\n  spec: Partial<M> | Matcher<M>,\n  n: number,\n): Matcher<M> {\n  const single: Matcher<M> =\n    typeof spec === \"function\" ? spec : (m) => shallowMatch(m, spec);\n  return (_msg, history) => history.filter((m) => single(m, history)).length >= n;\n}\n","// ── Process Name Match ───────────────────────────────────────────────────\n//\n// Tree-prefix matching for posipaki process names (`parent:child:...`).\n//\n// Pattern language (same as debug-logger's DEBUG env filtering):\n//   - \"*\"            matches any name\n//   - \"name\"         matches exactly\n//   - \"prefix:*\"     matches `prefix` and `prefix:` + anything below it\n\n/** True if `name` matches any of `patterns`. */\nexport function pnameMatch(name: string, patterns: string[]): boolean {\n  for (const p of patterns) {\n    if (p === \"*\") return true;\n    if (p.endsWith(\":*\")) {\n      const prefix = p.slice(0, -2);\n      if (name === prefix || name.startsWith(prefix + \":\")) return true;\n    } else if (p === name) {\n      return true;\n    }\n  }\n  return false;\n}\n","// ── Test Plugins ─────────────────────────────────────────────────────────\n//\n// createCollector: per-actor message collector plugin.\n// createRootTracker: global process tracker for cleanup.\n//\n// Observation model: the collector is a plugin installed on the root.  It\n// sees every message that flows through the process's onEmit, filtered by\n// a pname scope (default: the root and everything below it).  Waiting is\n// event-driven — `resolved()` settles when a matching message arrives, the\n// actor exits, or an explicit timeout fires.  No polling.\n\nimport { mergeConfigs, type ActorPlugin } from \"../hooks.js\";\nimport type { Message, StopMessage, SenderInfo, ProcessCtx } from \"../types.js\";\nimport { toMatcher, type MatchSpec } from \"./msg-matcher.js\";\nimport { pnameMatch } from \"./pname-match.js\";\nimport { withTimeout, makeWaiter, type Waiter } from \"../util.js\";\n\nconst DEFAULT_TIMEOUT = 4500;\n\n// ── types ────────────────────────────────────────────────────────────────\n\nexport interface MatchResult {\n  ok: boolean;\n  /** Human-readable diagnosis on failure (timeout / exit-before-match). */\n  detail?: string;\n}\n\nexport interface Collector<M extends Message> {\n  plugin: ActorPlugin;\n  messages: M[];\n  /**\n   * Wait until the collected history matches the current filter,\n   * the actor exits or timeout deadline hits.\n   *\n   * @param timeoutMs - deadline, defaults to 4.5 seconds\n   *\n   */\n  resolved(timeoutMs?: number): Promise<MatchResult>;\n  next(filter: MatchSpec<M>, timeoutMs?: number): Promise<MatchResult>;\n  reset(filter?: MatchSpec<M>): void;\n}\n\nexport interface RootTracker {\n  plugin: ActorPlugin;\n  stopAll(): Promise<void>;\n}\n\n// ── diagnostics helpers ──────────────────────────────────────────────────\n\nfunction describeSpec<M extends Message>(spec: MatchSpec<M>): string {\n  if (typeof spec === \"function\") return \"predicate\";\n  if (Array.isArray(spec))\n    return `sequence [${spec.map((s) => JSON.stringify(s)).join(\" → \")}]`;\n  return JSON.stringify(spec);\n}\n\nfunction lastSummary<M extends Message>(messages: M[]): string {\n  const last = messages[messages.length - 1];\n  if (last === undefined) return \"none\";\n  return JSON.stringify(last).slice(0, 120);\n}\n\n// ── createCollector ──────────────────────────────────────────────────────\n\nexport function createCollector<M extends Message>(\n  filter: MatchSpec<M>,\n  opts?: { scope?: string | string[] },\n): Collector<M> {\n  const messages: M[] = [];\n  let matcher = toMatcher(filter);\n  // The spec currently active — kept in sync with `matcher` so timeout\n  // diagnostics can say what was expected.\n  let currentSpec: MatchSpec<M> = filter;\n  // Captured from the root's beforeStart; used as the default scope.\n  let defaultScope: string[] = [];\n  // The plugin is installed on the root first (spawn assembles before any\n  // child is forked), so the first install's beforeStart is the root.\n  let installed = false;\n  let waiters: Waiter<MatchResult> = [];\n\n  function setSpec(spec: MatchSpec<M>) {\n    currentSpec = spec;\n    matcher = toMatcher(spec);\n  }\n\n  function scopePatterns(): string[] {\n    if (opts?.scope === undefined) return defaultScope;\n    return Array.isArray(opts.scope) ? opts.scope : [opts.scope];\n  }\n\n  function checkAndNotify() {\n    const last = messages[messages.length - 1];\n    if (last !== undefined && matcher(last, messages)) {\n      const ws = waiters.splice(0);\n      for (const w of ws) w.resolve({ ok: true });\n    }\n  }\n\n  async function resolved(timeoutMs: number = DEFAULT_TIMEOUT): Promise<MatchResult> {\n    const last = messages[messages.length - 1];\n    if (last !== undefined && matcher(last, messages)) {\n      return { ok: true };\n    }\n    const matchWaiter = makeWaiter<MatchResult>();\n    waiters.push(matchWaiter);\n\n    try {\n      return await withTimeout(matchWaiter.promise, timeoutMs, 'test-match');\n    } catch (e) {\n      if ((e as Error)?.message !== 'Timeout:test-match') {\n        throw e;\n      }\n\n      return {\n          ok: false,\n          detail:\n            `timeout after ${timeoutMs}ms — expected: ${describeSpec(currentSpec)} ` +\n            `— received ${messages.length} message(s), last: ${lastSummary(messages)}`,\n      };\n    }\n  }\n\n  const collectorPlugin: ActorPlugin = (config) => {\n    const isRoot = !installed;\n    installed = true;\n    return mergeConfigs(config, {\n      beforeStart() {\n        if (isRoot) defaultScope = [this.name];\n      },\n      onEmit(msg: Message, sender: SenderInfo) {\n        if (!pnameMatch(sender.fromName, scopePatterns())) return;\n        messages.push(msg as M);\n        checkAndNotify();\n      },\n      beforeEnd() {\n        const ws = waiters.splice(0);\n        for (const w of ws) w.resolve({ ok: false, detail: \"actor exited before match\" });\n      },\n    });\n  };\n\n  // Named function so framework deduplication works.\n  Object.defineProperty(collectorPlugin, \"name\", { value: \"messageCollector\" });\n\n  return {\n    plugin: collectorPlugin,\n    messages,\n    resolved,\n    next(nextFilter, timeoutMs = DEFAULT_TIMEOUT) {\n      setSpec(nextFilter);\n      return resolved(timeoutMs);\n    },\n    reset(newFilter) {\n      if (newFilter) setSpec(newFilter);\n    },\n  };\n}\n\n// ── createRootTracker ────────────────────────────────────────────────────\n\nexport function createRootTracker(): RootTracker {\n  const roots = new Set<{ sendSelf: (msg: StopMessage) => void }>();\n\n  const rootTrackerPlugin: ActorPlugin = (config) =>\n    mergeConfigs(config, {\n      beforeStart(this: { ctx: ProcessCtx<unknown, unknown, Message, Message> }) {\n        roots.add(this);\n      },\n      afterEnd(this: { ctx: ProcessCtx<unknown, unknown, Message, Message> }) {\n        roots.delete(this.ctx);\n      },\n    });\n\n  Object.defineProperty(rootTrackerPlugin, \"name\", { value: \"rootTracker\" });\n\n  return {\n    plugin: rootTrackerPlugin,\n    async stopAll() {\n      for (const root of roots) {\n        try {\n          root.exit();\n        } catch {}\n      }\n      roots.clear();\n    },\n  };\n}\n","\n\nexport function nextState(proc) {\n  return new Promise((resolve) => {\n    const unsub = proc.subscribe('state', () => {\n      unsub();\n      resolve(proc.state);\n    });\n  });\n}\n\nexport function nextMessage(proc) {\n  return new Promise((resolve) => {\n    const unsub = proc.subscribe('message', (msg) => {\n      unsub();\n      resolve(msg);\n    });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/msg-matcher.ts","../../src/testing/pname-match.ts","../../src/testing/test-plugin.ts","../../src/testing/tick-utils.ts"],"sourcesContent":["// ── Message Matcher ──────────────────────────────────────────────────────\n//\n// Canonical form: `fn(msg, history) => boolean`.  `msg` is the just-arrived\n// message (also the last element of `history`); `history` is the full\n// accumulated list *including* `msg`.\n//\n// Two shortcuts:\n//   - a message literal `{ type: \"X\" }`  → matches the latest message\n//   - a list `[{...}, {...}]`            → matches the tail of history,\n//                                           in order, from oldest to newest\n\nimport type { Message } from \"../types.js\";\n\nexport type Matcher<M extends Message> = (msg: M, history: M[]) => boolean;\n\nexport type MatchSpec<M extends Message> = Matcher<M> | Partial<M> | Array<Partial<M>>;\n\nfunction shallowMatch<M extends Message>(msg: M, spec: Partial<M>): boolean {\n  for (const key of Object.keys(spec) as Array<keyof M>) {\n    if (msg[key] !== spec[key]) return false;\n  }\n  return true;\n}\n\n/** Convert a matcher spec to a canonical matcher function. */\nexport function toMatcher<M extends Message>(spec: MatchSpec<M>): Matcher<M> {\n  if (typeof spec === \"function\") return spec as Matcher<M>;\n\n  if (Array.isArray(spec)) {\n    // Sequence: the tail of history must equal `spec`, in order.\n    return (_msg, history) => {\n      if (history.length < spec.length) return false;\n      const tail = history.slice(-spec.length);\n      return spec.every((s, i) => shallowMatch(tail[i], s));\n    };\n  }\n\n  // Single literal: the latest message must shallow-match.\n  return (msg) => shallowMatch(msg, spec);\n}\n\n/**\n * Occurrence matcher: matches when at least `n` messages in the history\n * satisfy `spec`.  This is the canonical form for \"Nth occurrence\" waits:\n *\n *   const c = createCollector<PongMsg>({ type: \"PONG\" });\n *   await c.next(times({ type: \"PONG\" }, 3));  // wait for the 3rd PONG\n *\n * Note: `history` accumulates, so this counts occurrences over the whole\n * collected history, not since the previous `next()`.  Use `reset()` with a\n * fresh collector for windowed counts.\n */\nexport function times<M extends Message>(spec: Partial<M> | Matcher<M>, n: number): Matcher<M> {\n  const single: Matcher<M> = typeof spec === \"function\" ? spec : (m) => shallowMatch(m, spec);\n  return (_msg, history) => history.filter((m) => single(m, history)).length >= n;\n}\n","// ── Process Name Match ───────────────────────────────────────────────────\n//\n// Tree-prefix matching for posipaki process names (`parent:child:...`).\n//\n// Pattern language (same as debug-logger's DEBUG env filtering):\n//   - \"*\"            matches any name\n//   - \"name\"         matches exactly\n//   - \"prefix:*\"     matches `prefix` and `prefix:` + anything below it\n\n/** True if `name` matches any of `patterns`. */\nexport function pnameMatch(name: string, patterns: string[]): boolean {\n  for (const p of patterns) {\n    if (p === \"*\") return true;\n    if (p.endsWith(\":*\")) {\n      const prefix = p.slice(0, -2);\n      if (name === prefix || name.startsWith(prefix + \":\")) return true;\n    } else if (p === name) {\n      return true;\n    }\n  }\n  return false;\n}\n","// ── Test Plugins ─────────────────────────────────────────────────────────\n//\n// createCollector: per-actor message collector plugin.\n// createRootTracker: global process tracker for cleanup.\n//\n// Observation model: the collector is a plugin installed on the root.  It\n// sees every message that flows through the process's onEmit, filtered by\n// a pname scope (default: the root and everything below it).  Waiting is\n// event-driven — `resolved()` settles when a matching message arrives, the\n// actor exits, or an explicit timeout fires.  No polling.\n\nimport { mergeConfigs, type ActorPlugin, type ActorReflection } from \"../hooks.js\";\nimport type { ActorContext, ReflectionOptions } from \"../actor-types.js\";\n\nimport type { Message, StopMessage, SenderInfo, ProcessCtx } from \"../types.js\";\nimport { toMatcher, type MatchSpec } from \"./msg-matcher.js\";\nimport { pnameMatch } from \"./pname-match.js\";\nimport { withTimeout, makeWaiter, type Waiter } from \"../util.js\";\n\nconst DEFAULT_TIMEOUT = 4500;\n\n// ── types ────────────────────────────────────────────────────────────────\n\nexport interface MatchResult {\n  ok: boolean;\n  /** Human-readable diagnosis on failure (timeout / exit-before-match). */\n  detail?: string;\n}\n\nexport interface Collector<M extends Message> {\n  plugin: ActorPlugin;\n  messages: M[];\n  /**\n   * Wait until the collected history matches the current filter,\n   * the actor exits or timeout deadline hits.\n   *\n   * @param timeoutMs - deadline, defaults to 4.5 seconds\n   *\n   */\n  resolved(timeoutMs?: number): Promise<MatchResult>;\n  next(filter: MatchSpec<M>, timeoutMs?: number): Promise<MatchResult>;\n  reset(filter?: MatchSpec<M>): void;\n}\n\nexport interface RootTracker {\n  plugin: ActorPlugin;\n  stopAll(): Promise<void>;\n}\n\n// ── diagnostics helpers ──────────────────────────────────────────────────\n\nfunction describeSpec<M extends Message>(spec: MatchSpec<M>): string {\n  if (typeof spec === \"function\") return \"predicate\";\n  if (Array.isArray(spec)) return `sequence [${spec.map((s) => JSON.stringify(s)).join(\" → \")}]`;\n  return JSON.stringify(spec);\n}\n\nfunction lastSummary<M extends Message>(messages: M[]): string {\n  const last = messages[messages.length - 1];\n  if (last === undefined) return \"none\";\n  return JSON.stringify(last).slice(0, 120);\n}\n\n// ── createCollector ──────────────────────────────────────────────────────\n\nexport function createCollector<M extends Message>(\n  filter: MatchSpec<M>,\n  opts?: { scope?: string | string[] },\n): Collector<M> {\n  const messages: M[] = [];\n  let matcher = toMatcher(filter);\n  // The spec currently active — kept in sync with `matcher` so timeout\n  // diagnostics can say what was expected.\n  let currentSpec: MatchSpec<M> = filter;\n  // Captured from the root's beforeStart; used as the default scope.\n  let defaultScope: string[] = [];\n  // The plugin is installed on the root first (spawn assembles before any\n  // child is forked), so the first install's beforeStart is the root.\n  let installed = false;\n  let waiters: Waiter<MatchResult>[] = [];\n\n  function setSpec(spec: MatchSpec<M>) {\n    currentSpec = spec;\n    matcher = toMatcher(spec);\n  }\n\n  function scopePatterns(): string[] {\n    if (opts?.scope === undefined) return defaultScope;\n    return Array.isArray(opts.scope) ? opts.scope : [opts.scope];\n  }\n\n  function checkAndNotify() {\n    const last = messages[messages.length - 1];\n    if (last !== undefined && matcher(last, messages)) {\n      const ws = waiters.splice(0);\n      for (const w of ws) w.resolve({ ok: true });\n    }\n  }\n\n  async function resolved(timeoutMs: number = DEFAULT_TIMEOUT): Promise<MatchResult> {\n    const last = messages[messages.length - 1];\n    if (last !== undefined && matcher(last, messages)) {\n      return { ok: true };\n    }\n    const matchWaiter = makeWaiter<MatchResult>();\n    waiters.push(matchWaiter);\n\n    try {\n      return await withTimeout(matchWaiter.promise, timeoutMs, \"test-match\");\n    } catch (e) {\n      if ((e as Error)?.message !== \"Timeout:test-match\") {\n        throw e;\n      }\n\n      return {\n        ok: false,\n        detail:\n          `timeout after ${timeoutMs}ms — expected: ${describeSpec(currentSpec)} ` +\n          `— received ${messages.length} message(s), last: ${lastSummary(messages)}`,\n      };\n    }\n  }\n\n  const collectorPlugin: ActorPlugin = (config) => {\n    const isRoot = !installed;\n    installed = true;\n    return mergeConfigs(config, {\n      beforeStart() {\n        if (isRoot) defaultScope = [this.name];\n      },\n      onEmit(msg: Message, sender: SenderInfo) {\n        if (!pnameMatch(sender.fromName, scopePatterns())) return;\n        messages.push(msg as M);\n        checkAndNotify();\n      },\n      beforeEnd() {\n        const ws = waiters.splice(0);\n        for (const w of ws) w.resolve({ ok: false, detail: \"actor exited before match\" });\n      },\n    });\n  };\n\n  // Named function so framework deduplication works.\n  Object.defineProperty(collectorPlugin, \"name\", { value: \"messageCollector\" });\n\n  return {\n    plugin: collectorPlugin,\n    messages,\n    resolved,\n    next(nextFilter, timeoutMs = DEFAULT_TIMEOUT) {\n      setSpec(nextFilter);\n      return resolved(timeoutMs);\n    },\n    reset(newFilter) {\n      if (newFilter) setSpec(newFilter);\n    },\n  };\n}\n\n// ── createRootTracker ────────────────────────────────────────────────────\n\nexport function createRootTracker(): RootTracker {\n  const roots = new Set<\n    ActorContext<unknown, unknown, Message, Message, {}, {}, ReflectionOptions & ActorReflection>\n  >();\n\n  const rootTrackerPlugin: ActorPlugin = (config) =>\n    mergeConfigs(config, {\n      beforeStart() {\n        roots.add(this);\n      },\n      afterEnd() {\n        roots.delete(this);\n      },\n    });\n\n  Object.defineProperty(rootTrackerPlugin, \"name\", { value: \"rootTracker\" });\n\n  return {\n    plugin: rootTrackerPlugin,\n    async stopAll() {\n      for (const root of roots) {\n        try {\n          root.exit();\n        } catch {}\n      }\n      roots.clear();\n    },\n  };\n}\n","import type { AsyncProcess } from \"../process.async.js\";\nimport type { Message } from \"../types.js\";\n\nexport function nextState<A, S, IM extends Message, OM extends Message, R extends object>(\n  proc: AsyncProcess<A, S, IM, OM, R>,\n) {\n  return new Promise((resolve) => {\n    const unsub = proc.subscribe(\"state\", () => {\n      unsub();\n      resolve(proc.state);\n    });\n  });\n}\n\nexport function nextMessage<A, S, IM extends Message, OM extends Message, R extends object>(\n  proc: AsyncProcess<A, S, IM, OM, R>,\n) {\n  return new Promise((resolve) => {\n    const unsub = proc.subscribe(\"message\", (msg) => {\n      unsub();\n      resolve(msg);\n    });\n  });\n}\n"],"mappings":"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"}

package/dist/types-B_bUAR9r.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types-B_bUAR9r.d.ts","names":[],"sources":["../src/process.async.ts","../src/types.ts"],"mappings":"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"}
+{"version":3,"file":"types-B_bUAR9r.d.ts","names":[],"sources":["../src/process.async.ts","../src/types.ts"],"mappings":"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"}

package/dist/util-Brtfgv68.js.map

@@ -1 +1 @@
-{"version":3,"file":"util-Brtfgv68.js","names":[],"sources":["../src/util.ts"],"sourcesContent":["import type { ExitMessage } from \"./types.js\";\nexport function debugLog(level: boolean, ...args: Array<unknown>) {\n  if (level) {\n    console.log(...args);\n  }\n}\n\ntype ReducerClosure<M> = (msg: M) => void;\ntype ReadyFn = () => boolean;\ntype NotifyFn<T = void> = (v: T) => void;\ntype ErrorFn = (e: Error | null) => void;\n\n/**\n * Generator helper that loops, yielding `null` and feeding incoming\n * messages to `fn` until `readyFn()` returns true. Used inside\n * process generators to build the main message loop.\n */\nfunction* runDispatch<M>(\n  name: string,\n  fn: ReducerClosure<M>,\n  readyFn: ReadyFn = () => false,\n  debugLevel = false,\n): Generator<null, void, M> {\n  let msg: M;\n  while (!readyFn()) {\n    msg = yield null;\n    debugLog(debugLevel, \"msg\", name, \" <- \", msg);\n    fn(msg);\n  }\n}\n\ntype DeferCb = () => void;\ntype Defer = (fn: DeferCb) => unknown;\ntype Cancel = (taskId: any) => void;\ntype WindowGlobal = {\n  setImmediate?: Defer;\n  clearImmediate?: Cancel;\n  requestIdleCallback?: Defer;\n  cancelIdleCallback?: Cancel;\n  setTimeout: Defer;\n  clearTimeout: Cancel;\n};\n\n/** Handle to a scheduled (but not yet executed) callback. */\nexport type DeferredCall = {\n  cancel: () => void;\n  flush: () => void;\n};\n/** Schedule a function to run on the next microtask. Returns an\n * object with `cancel()` and `flush()` methods. */\nfunction defer(fn: DeferCb): DeferredCall {\n  const g = globalThis as WindowGlobal;\n  function schedule(deferFn: Defer, cancelFn: Cancel) {\n    const taskId = deferFn(fn);\n    return () => cancelFn(taskId);\n  }\n  let cancel: () => void;\n  if (g.setImmediate && g.clearImmediate) {\n    cancel = schedule(g.setImmediate, g.clearImmediate);\n  } else if (g.requestIdleCallback && g.cancelIdleCallback) {\n    cancel = schedule(g.requestIdleCallback, g.cancelIdleCallback);\n  } else {\n    cancel = schedule((f) => setTimeout(f, 0), clearTimeout);\n  }\n\n  function flush() {\n    cancel();\n    fn();\n  }\n\n  return { flush, cancel };\n}\n/** A promise paired with its resolve function — used to signal\n * process completion. */\nexport type Waiter<T = void> = {\n  promise: Promise<T>;\n  resolve: NotifyFn<T>;\n  reject: ErrorFn;\n};\n/** Create a new {@link Waiter}. */\nfunction makeWaiter(): Waiter {\n  let resolve: NotifyFn;\n  let reject: ErrorFn;\n  let promise = new Promise<void>((_resolve, _reject) => {\n    resolve = _resolve;\n    reject = _reject;\n  });\n  return { promise, resolve, reject };\n}\n\n/** Resolve after `ms` milliseconds. */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nconst TIMEOUT_SENTINEL = Symbol.for('__timeout__posipaki_internal');\nexport async function timeout(ms: number) {\n  await sleep(ms);\n  return TIMEOUT_SENTINEL;\n}\n\nexport async function withTimeout<O>(promise: Promise<O>, ms: number, kind: string) : Promise<O> {\n  const result = await Promise.race([promise, timeout(ms)]);\n  if (result === TIMEOUT_SENTINEL) {\n    throw Error('Timeout:'+ kind);\n  }\n  return result as O;\n}\n\nexport { runDispatch, defer, makeWaiter };\nexport type { ExitMessage };\n"],"mappings":";AACA,SAAgB,SAAS,OAAgB,GAAG,MAAsB;CAChE,IAAI,OACF,QAAQ,IAAI,GAAG,IAAI;AAEvB;;;;;;AAYA,UAAU,YACR,MACA,IACA,gBAAyB,OACzB,aAAa,OACa;CAC1B,IAAI;CACJ,OAAO,CAAC,QAAQ,GAAG;EACjB,MAAM,MAAM;EACZ,SAAS,YAAY,OAAO,MAAM,QAAQ,GAAG;EAC7C,GAAG,GAAG;CACR;AACF;;;AAqBA,SAAS,MAAM,IAA2B;CACxC,MAAM,IAAI;CACV,SAAS,SAAS,SAAgB,UAAkB;EAClD,MAAM,SAAS,QAAQ,EAAE;EACzB,aAAa,SAAS,MAAM;CAC9B;CACA,IAAI;CACJ,IAAI,EAAE,gBAAgB,EAAE,gBACtB,SAAS,SAAS,EAAE,cAAc,EAAE,cAAc;MAC7C,IAAI,EAAE,uBAAuB,EAAE,oBACpC,SAAS,SAAS,EAAE,qBAAqB,EAAE,kBAAkB;MAE7D,SAAS,UAAU,MAAM,WAAW,GAAG,CAAC,GAAG,YAAY;CAGzD,SAAS,QAAQ;EACf,OAAO;EACP,GAAG;CACL;CAEA,OAAO;EAAE;EAAO;CAAO;AACzB;;AASA,SAAS,aAAqB;CAC5B,IAAI;CACJ,IAAI;CAKJ,OAAO;EAAE,SAAA,IAJS,SAAe,UAAU,YAAY;GACrD,UAAU;GACV,SAAS;EACX,CACe;EAAG;EAAS;CAAO;AACpC;;AAGA,SAAgB,MAAM,IAA2B;CAC/C,OAAO,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;AAEA,MAAM,mBAAmB,OAAO,IAAI,8BAA8B;AAClE,eAAsB,QAAQ,IAAY;CACxC,MAAM,MAAM,EAAE;CACd,OAAO;AACT;AAEA,eAAsB,YAAe,SAAqB,IAAY,MAA2B;CAC/F,MAAM,SAAS,MAAM,QAAQ,KAAK,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;CACxD,IAAI,WAAW,kBACb,MAAM,MAAM,aAAY,IAAI;CAE9B,OAAO;AACT"}
+{"version":3,"file":"util-Brtfgv68.js","names":[],"sources":["../src/util.ts"],"sourcesContent":["import type { ExitMessage } from \"./types.js\";\nexport function debugLog(level: boolean, ...args: Array<unknown>) {\n  if (level) {\n    console.log(...args);\n  }\n}\n\ntype ReducerClosure<M> = (msg: M) => void;\ntype ReadyFn = () => boolean;\ntype NotifyFn<T = void> = (v: T) => void;\ntype ErrorFn = (e: Error | null) => void;\n\n/**\n * Generator helper that loops, yielding `null` and feeding incoming\n * messages to `fn` until `readyFn()` returns true. Used inside\n * process generators to build the main message loop.\n */\nfunction* runDispatch<M>(\n  name: string,\n  fn: ReducerClosure<M>,\n  readyFn: ReadyFn = () => false,\n  debugLevel = false,\n): Generator<null, void, M> {\n  let msg: M;\n  while (!readyFn()) {\n    msg = yield null;\n    debugLog(debugLevel, \"msg\", name, \" <- \", msg);\n    fn(msg);\n  }\n}\n\ntype DeferCb = () => void;\ntype Defer = (fn: DeferCb) => unknown;\ntype Cancel = (taskId: any) => void;\ntype WindowGlobal = {\n  setImmediate?: Defer;\n  clearImmediate?: Cancel;\n  requestIdleCallback?: Defer;\n  cancelIdleCallback?: Cancel;\n  setTimeout: Defer;\n  clearTimeout: Cancel;\n};\n\n/** Handle to a scheduled (but not yet executed) callback. */\nexport type DeferredCall = {\n  cancel: () => void;\n  flush: () => void;\n};\n/** Schedule a function to run on the next microtask. Returns an\n * object with `cancel()` and `flush()` methods. */\nfunction defer(fn: DeferCb): DeferredCall {\n  const g = globalThis as WindowGlobal;\n  function schedule(deferFn: Defer, cancelFn: Cancel) {\n    const taskId = deferFn(fn);\n    return () => cancelFn(taskId);\n  }\n  let cancel: () => void;\n  if (g.setImmediate && g.clearImmediate) {\n    cancel = schedule(g.setImmediate, g.clearImmediate);\n  } else if (g.requestIdleCallback && g.cancelIdleCallback) {\n    cancel = schedule(g.requestIdleCallback, g.cancelIdleCallback);\n  } else {\n    cancel = schedule((f) => setTimeout(f, 0), clearTimeout);\n  }\n\n  function flush() {\n    cancel();\n    fn();\n  }\n\n  return { flush, cancel };\n}\n/** A promise paired with its resolve function — used to signal\n * process completion. */\nexport type Waiter<T = void> = {\n  promise: Promise<T>;\n  resolve: NotifyFn<T>;\n  reject: ErrorFn;\n};\n/** Create a new {@link Waiter}. */\nfunction makeWaiter<T = void>(): Waiter<T> {\n  let resolve: NotifyFn<T>;\n  let reject: ErrorFn;\n  let promise = new Promise<T>((_resolve, _reject) => {\n    resolve = _resolve;\n    reject = _reject;\n  });\n  return { promise, resolve: resolve!, reject: reject! };\n}\n\n/** Resolve after `ms` milliseconds. */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nconst TIMEOUT_SENTINEL = Symbol.for(\"__timeout__posipaki_internal\");\nexport async function timeout(ms: number) {\n  await sleep(ms);\n  return TIMEOUT_SENTINEL;\n}\n\nexport async function withTimeout<O>(promise: Promise<O>, ms: number, kind: string): Promise<O> {\n  const result = await Promise.race([promise, timeout(ms)]);\n  if (result === TIMEOUT_SENTINEL) {\n    throw Error(\"Timeout:\" + kind);\n  }\n  return result as O;\n}\n\nexport { runDispatch, defer, makeWaiter };\nexport type { ExitMessage };\n"],"mappings":";AACA,SAAgB,SAAS,OAAgB,GAAG,MAAsB;CAChE,IAAI,OACF,QAAQ,IAAI,GAAG,IAAI;AAEvB;;;;;;AAYA,UAAU,YACR,MACA,IACA,gBAAyB,OACzB,aAAa,OACa;CAC1B,IAAI;CACJ,OAAO,CAAC,QAAQ,GAAG;EACjB,MAAM,MAAM;EACZ,SAAS,YAAY,OAAO,MAAM,QAAQ,GAAG;EAC7C,GAAG,GAAG;CACR;AACF;;;AAqBA,SAAS,MAAM,IAA2B;CACxC,MAAM,IAAI;CACV,SAAS,SAAS,SAAgB,UAAkB;EAClD,MAAM,SAAS,QAAQ,EAAE;EACzB,aAAa,SAAS,MAAM;CAC9B;CACA,IAAI;CACJ,IAAI,EAAE,gBAAgB,EAAE,gBACtB,SAAS,SAAS,EAAE,cAAc,EAAE,cAAc;MAC7C,IAAI,EAAE,uBAAuB,EAAE,oBACpC,SAAS,SAAS,EAAE,qBAAqB,EAAE,kBAAkB;MAE7D,SAAS,UAAU,MAAM,WAAW,GAAG,CAAC,GAAG,YAAY;CAGzD,SAAS,QAAQ;EACf,OAAO;EACP,GAAG;CACL;CAEA,OAAO;EAAE;EAAO;CAAO;AACzB;;AASA,SAAS,aAAkC;CACzC,IAAI;CACJ,IAAI;CAKJ,OAAO;EAAE,SAAA,IAJS,SAAY,UAAU,YAAY;GAClD,UAAU;GACV,SAAS;EACX,CACe;EAAY;EAAkB;CAAQ;AACvD;;AAGA,SAAgB,MAAM,IAA2B;CAC/C,OAAO,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;AAEA,MAAM,mBAAmB,OAAO,IAAI,8BAA8B;AAClE,eAAsB,QAAQ,IAAY;CACxC,MAAM,MAAM,EAAE;CACd,OAAO;AACT;AAEA,eAAsB,YAAe,SAAqB,IAAY,MAA0B;CAC9F,MAAM,SAAS,MAAM,QAAQ,KAAK,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;CACxD,IAAI,WAAW,kBACb,MAAM,MAAM,aAAa,IAAI;CAE/B,OAAO;AACT"}

package/dist/xfetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xfetch.d.ts","names":[],"sources":["../src/xfetch.ts"],"mappings":";;;;KAOY,WAAW;EACrB;EACA,MAAM;EACN;EACA;EACA,iBAAiB;;;KAIP,UAAU;EAEhB,KAAK;EACL;EACA;EACA,UAAU;;EAGV,KAAK;EACL;EACA,MAAM;EACN,UAAU;;;KAIJ,aAAa;EAEnB;EACA,OAAO;EACP;EACA;EACA,iBAAiB;;EAEjB;IACF;;KAGQ,aAAa,KAAK,QAC5B,UAAU,IACV,WAAW,IACX,aAAa,IACb,aAAa;;;;;;iBA0BL,OAAO,QAEb,OACA,UACA,YACC,WACD,UAAU,OACV,WAAW,OACX,aAAa,OACb,aAAa,UAEb,QAAgB,KAAK,MAAM,SAAS,iBAAiB,UAAU,QAChE,UAAU,WAAW,oBAAoB,WAAW,aAAa"}
+{"version":3,"file":"xfetch.d.ts","names":[],"sources":["../src/xfetch.ts"],"mappings":";;;;KAOY,WAAW;EACrB;EACA,MAAM;EACN;EACA;EACA,iBAAiB;;;KAIP,UAAU;EAEhB,KAAK;EACL;EACA;EACA,UAAU;;EAGV,KAAK;EACL;EACA,MAAM;EACN,UAAU;;;KAIJ,aAAa;EAEnB;EACA,OAAO;EACP;EACA;EACA,iBAAiB;;EAEjB;IACF;;KAGQ,aAAa,KAAK,QAC5B,UAAU,IACV,WAAW,IACX,aAAa,IACb,aAAa;;;;;;iBA0BL,OAAO,QAEb,OACA,UACA,YACC,WAAW,UAAU,OAAO,WAAW,OAAO,aAAa,OAAO,aAAa,UAChF,QAAgB,KAAK,MAAM,SAAS,iBAAiB,UAAU,QAChE,UAAU,WAAW,oBAAoB,WAAW,aAAa"}

package/dist/xfetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"xfetch.js","names":[],"sources":["../src/xfetch.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { ExitMessage, WithSender, ProcessCtx } from \"./types.js\";\nimport type { Process } from \"./process.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** State of an in-flight or completed fetch. */\nexport type FetchState<T> = {\n  code: \"pending\" | \"loading\" | \"aborted\" | \"failed\" | \"ok\";\n  data: T | null;\n  text: string | null;\n  status: number;\n  responseHeaders: Record<string, string>;\n};\n\n/** Arguments for a fetch process. */\nexport type FetchArgs<T> =\n  | {\n      url: URL;\n      method?: \"GET\";\n      body?: undefined;\n      headers?: Record<string, string>;\n    }\n  | {\n      url: URL;\n      method?: \"POST\" | \"PUT\" | \"PATCH\";\n      body: T;\n      headers?: Record<string, string>;\n    };\n\n/** Messages emitted by a fetch process during its lifecycle. */\nexport type FetchMessage<T> =\n  | {\n      type: \"OK\";\n      data?: T | null;\n      text?: string | null;\n      status: number;\n      responseHeaders: Record<string, string>;\n    }\n  | { type: \"ERROR\" | \"LOADING\" | \"ABORTED\" | \"STOP\" }\n  | ExitMessage;\n\n/** A process that performs an HTTP fetch. */\nexport type FetchProcess<D> = Process<\n  FetchArgs<D>,\n  FetchState<D>,\n  FetchMessage<D>,\n  FetchMessage<D>\n>;\n\n// ---- helpers ----------------------------------------------------------------\n\nfunction isJsonHelper(res: Response): boolean {\n  const ct = res.headers.get(\"content-type\");\n  return ct === \"application/json\";\n}\n\n/** Convert a Headers object to a plain Record. */\nfunction headersToRecord(h: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  h.forEach((v, k) => {\n    out[k] = v;\n  });\n  return out;\n}\n\n// ---- xfetch -----------------------------------------------------------------\n\n/**\n * A fetch wrapper implemented as a process. Supports GET/POST/PUT/PATCH,\n * JSON detection, abort via AbortController, and yields a\n * {@link FetchState} with the current status.\n */\nfunction* xfetch<Type>(\n  {\n    pname,\n    toParent,\n    sendSelf,\n  }: ProcessCtx<\n    FetchArgs<Type>,\n    FetchState<Type>,\n    FetchMessage<Type>,\n    FetchMessage<Type>\n  >,\n  { method = \"GET\", url, body, headers: callerHeaders }: FetchArgs<Type>,\n): Generator<FetchState<Type> | null, void, WithSender<FetchMessage<Type>>> {\n  const state: FetchState<Type> = {\n    code: \"pending\",\n    data: null,\n    text: null,\n    status: 0,\n    responseHeaders: {},\n  };\n  yield state;\n\n  const controller = new AbortController();\n  const signal = controller.signal;\n  const toSelf = sendSelf;\n\n  (async function doRequest() {\n    try {\n      toSelf({ type: \"LOADING\" });\n      const serializedBody =\n        method === \"GET\" ? undefined : JSON.stringify(body);\n      const headers = new Headers(callerHeaders ?? {});\n      if (serializedBody && !headers.get('content-type')) {\n        headers.set(\"content-type\", \"application/json\");\n      }\n      const res: Response = await fetch(url.href, {\n        method,\n        signal,\n        body: serializedBody,\n        headers,\n      });\n      const status = res.status;\n      const responseHeaders = headersToRecord(res.headers);\n      if (isJsonHelper(res)) {\n        const data = await res.json() as Type;\n        toSelf({ type: \"OK\", data, status, responseHeaders });\n      } else {\n        const text = await res.text();\n        toSelf({ type: \"OK\", text, status, responseHeaders });\n      }\n    } catch (e) {\n      const isAborted = e instanceof DOMException && e.name === \"AbortError\";\n      if (isAborted) {\n        toSelf({ type: \"ABORTED\" });\n      } else {\n        toSelf({ type: \"ERROR\" });\n      }\n    }\n  })();\n\n  const isDone = (): boolean =>\n    !(state.code === \"pending\" || state.code === \"loading\");\n\n  yield* runDispatch<WithSender<FetchMessage<Type>>>(\n    pname,\n    (maybe: WithSender<FetchMessage<Type>>) => {\n      const [msg, _sender] = maybe;\n      if (msg.type === \"STOP\") {\n        controller.abort();\n      }\n      if (msg.type === \"ABORTED\") {\n        toParent(msg);\n        state.code = \"aborted\";\n      }\n      if (msg.type === \"ERROR\") {\n        toParent(msg);\n        state.code = \"failed\";\n      }\n      if (msg.type === \"LOADING\") {\n        state.code = \"loading\";\n      }\n      if (msg.type === \"OK\") {\n        toParent(msg);\n        state.code = \"ok\";\n        state.data = msg.data || null;\n        state.text = msg.text || null;\n        state.status = msg.status;\n        state.responseHeaders = msg.responseHeaders;\n      }\n    },\n    isDone,\n    false,\n  );\n}\n\nexport { xfetch };\n"],"mappings":";;AAoDA,SAAS,aAAa,KAAwB;CAE5C,OADW,IAAI,QAAQ,IAAI,cACnB,MAAM;AAChB;;AAGA,SAAS,gBAAgB,GAAoC;CAC3D,MAAM,MAA8B,CAAC;CACrC,EAAE,SAAS,GAAG,MAAM;EAClB,IAAI,KAAK;CACX,CAAC;CACD,OAAO;AACT;;;;;;AASA,UAAU,OACR,EACE,OACA,UACA,YAOF,EAAE,SAAS,OAAO,KAAK,MAAM,SAAS,iBACoC;CAC1E,MAAM,QAA0B;EAC9B,MAAM;EACN,MAAM;EACN,MAAM;EACN,QAAQ;EACR,iBAAiB,CAAC;CACpB;CACA,MAAM;CAEN,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,SAAS,WAAW;CAC1B,MAAM,SAAS;CAEf,CAAC,eAAe,YAAY;EAC1B,IAAI;GACF,OAAO,EAAE,MAAM,UAAU,CAAC;GAC1B,MAAM,iBACJ,WAAW,QAAQ,KAAA,IAAY,KAAK,UAAU,IAAI;GACpD,MAAM,UAAU,IAAI,QAAQ,iBAAiB,CAAC,CAAC;GAC/C,IAAI,kBAAkB,CAAC,QAAQ,IAAI,cAAc,GAC/C,QAAQ,IAAI,gBAAgB,kBAAkB;GAEhD,MAAM,MAAgB,MAAM,MAAM,IAAI,MAAM;IAC1C;IACA;IACA,MAAM;IACN;GACF,CAAC;GACD,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,gBAAgB,IAAI,OAAO;GACnD,IAAI,aAAa,GAAG,GAAG;IACrB,MAAM,OAAO,MAAM,IAAI,KAAK;IAC5B,OAAO;KAAE,MAAM;KAAM;KAAM;KAAQ;IAAgB,CAAC;GACtD,OAAO;IACL,MAAM,OAAO,MAAM,IAAI,KAAK;IAC5B,OAAO;KAAE,MAAM;KAAM;KAAM;KAAQ;IAAgB,CAAC;GACtD;EACF,SAAS,GAAG;GAEV,IADkB,aAAa,gBAAgB,EAAE,SAAS,cAExD,OAAO,EAAE,MAAM,UAAU,CAAC;QAE1B,OAAO,EAAE,MAAM,QAAQ,CAAC;EAE5B;CACF,EAAA,CAAG;CAEH,MAAM,eACJ,EAAE,MAAM,SAAS,aAAa,MAAM,SAAS;CAE/C,OAAO,YACL,QACC,UAA0C;EACzC,MAAM,CAAC,KAAK,WAAW;EACvB,IAAI,IAAI,SAAS,QACf,WAAW,MAAM;EAEnB,IAAI,IAAI,SAAS,WAAW;GAC1B,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,SAAS;GACxB,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,WACf,MAAM,OAAO;EAEf,IAAI,IAAI,SAAS,MAAM;GACrB,SAAS,GAAG;GACZ,MAAM,OAAO;GACb,MAAM,OAAO,IAAI,QAAQ;GACzB,MAAM,OAAO,IAAI,QAAQ;GACzB,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,IAAI;EAC9B;CACF,GACA,QACA,KACF;AACF"}
+{"version":3,"file":"xfetch.js","names":[],"sources":["../src/xfetch.ts"],"sourcesContent":["import { runDispatch } from \"./util.js\";\nimport type { ExitMessage, WithSender, ProcessCtx } from \"./types.js\";\nimport type { Process } from \"./process.js\";\n\n// ---- types ------------------------------------------------------------------\n\n/** State of an in-flight or completed fetch. */\nexport type FetchState<T> = {\n  code: \"pending\" | \"loading\" | \"aborted\" | \"failed\" | \"ok\";\n  data: T | null;\n  text: string | null;\n  status: number;\n  responseHeaders: Record<string, string>;\n};\n\n/** Arguments for a fetch process. */\nexport type FetchArgs<T> =\n  | {\n      url: URL;\n      method?: \"GET\";\n      body?: undefined;\n      headers?: Record<string, string>;\n    }\n  | {\n      url: URL;\n      method?: \"POST\" | \"PUT\" | \"PATCH\";\n      body: T;\n      headers?: Record<string, string>;\n    };\n\n/** Messages emitted by a fetch process during its lifecycle. */\nexport type FetchMessage<T> =\n  | {\n      type: \"OK\";\n      data?: T | null;\n      text?: string | null;\n      status: number;\n      responseHeaders: Record<string, string>;\n    }\n  | { type: \"ERROR\" | \"LOADING\" | \"ABORTED\" | \"STOP\" }\n  | ExitMessage;\n\n/** A process that performs an HTTP fetch. */\nexport type FetchProcess<D> = Process<\n  FetchArgs<D>,\n  FetchState<D>,\n  FetchMessage<D>,\n  FetchMessage<D>\n>;\n\n// ---- helpers ----------------------------------------------------------------\n\nfunction isJsonHelper(res: Response): boolean {\n  const ct = res.headers.get(\"content-type\");\n  return ct === \"application/json\";\n}\n\n/** Convert a Headers object to a plain Record. */\nfunction headersToRecord(h: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  h.forEach((v, k) => {\n    out[k] = v;\n  });\n  return out;\n}\n\n// ---- xfetch -----------------------------------------------------------------\n\n/**\n * A fetch wrapper implemented as a process. Supports GET/POST/PUT/PATCH,\n * JSON detection, abort via AbortController, and yields a\n * {@link FetchState} with the current status.\n */\nfunction* xfetch<Type>(\n  {\n    pname,\n    toParent,\n    sendSelf,\n  }: ProcessCtx<FetchArgs<Type>, FetchState<Type>, FetchMessage<Type>, FetchMessage<Type>>,\n  { method = \"GET\", url, body, headers: callerHeaders }: FetchArgs<Type>,\n): Generator<FetchState<Type> | null, void, WithSender<FetchMessage<Type>>> {\n  const state: FetchState<Type> = {\n    code: \"pending\",\n    data: null,\n    text: null,\n    status: 0,\n    responseHeaders: {},\n  };\n  yield state;\n\n  const controller = new AbortController();\n  const signal = controller.signal;\n  const toSelf = sendSelf;\n\n  (async function doRequest() {\n    try {\n      toSelf({ type: \"LOADING\" });\n      const serializedBody = method === \"GET\" ? undefined : JSON.stringify(body);\n      const headers = new Headers(callerHeaders ?? {});\n      if (serializedBody && !headers.get(\"content-type\")) {\n        headers.set(\"content-type\", \"application/json\");\n      }\n      const res: Response = await fetch(url.href, {\n        method,\n        signal,\n        body: serializedBody,\n        headers,\n      });\n      const status = res.status;\n      const responseHeaders = headersToRecord(res.headers);\n      if (isJsonHelper(res)) {\n        const data = (await res.json()) as Type;\n        toSelf({ type: \"OK\", data, status, responseHeaders });\n      } else {\n        const text = await res.text();\n        toSelf({ type: \"OK\", text, status, responseHeaders });\n      }\n    } catch (e) {\n      const isAborted = e instanceof DOMException && e.name === \"AbortError\";\n      if (isAborted) {\n        toSelf({ type: \"ABORTED\" });\n      } else {\n        toSelf({ type: \"ERROR\" });\n      }\n    }\n  })();\n\n  const isDone = (): boolean => !(state.code === \"pending\" || state.code === \"loading\");\n\n  yield* runDispatch<WithSender<FetchMessage<Type>>>(\n    pname,\n    (maybe: WithSender<FetchMessage<Type>>) => {\n      const [msg, _sender] = maybe;\n      if (msg.type === \"STOP\") {\n        controller.abort();\n      }\n      if (msg.type === \"ABORTED\") {\n        toParent(msg);\n        state.code = \"aborted\";\n      }\n      if (msg.type === \"ERROR\") {\n        toParent(msg);\n        state.code = \"failed\";\n      }\n      if (msg.type === \"LOADING\") {\n        state.code = \"loading\";\n      }\n      if (msg.type === \"OK\") {\n        toParent(msg);\n        state.code = \"ok\";\n        state.data = msg.data || null;\n        state.text = msg.text || null;\n        state.status = msg.status;\n        state.responseHeaders = msg.responseHeaders;\n      }\n    },\n    isDone,\n    false,\n  );\n}\n\nexport { xfetch };\n"],"mappings":";;AAoDA,SAAS,aAAa,KAAwB;CAE5C,OADW,IAAI,QAAQ,IAAI,cACnB,MAAM;AAChB;;AAGA,SAAS,gBAAgB,GAAoC;CAC3D,MAAM,MAA8B,CAAC;CACrC,EAAE,SAAS,GAAG,MAAM;EAClB,IAAI,KAAK;CACX,CAAC;CACD,OAAO;AACT;;;;;;AASA,UAAU,OACR,EACE,OACA,UACA,YAEF,EAAE,SAAS,OAAO,KAAK,MAAM,SAAS,iBACoC;CAC1E,MAAM,QAA0B;EAC9B,MAAM;EACN,MAAM;EACN,MAAM;EACN,QAAQ;EACR,iBAAiB,CAAC;CACpB;CACA,MAAM;CAEN,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,SAAS,WAAW;CAC1B,MAAM,SAAS;CAEf,CAAC,eAAe,YAAY;EAC1B,IAAI;GACF,OAAO,EAAE,MAAM,UAAU,CAAC;GAC1B,MAAM,iBAAiB,WAAW,QAAQ,KAAA,IAAY,KAAK,UAAU,IAAI;GACzE,MAAM,UAAU,IAAI,QAAQ,iBAAiB,CAAC,CAAC;GAC/C,IAAI,kBAAkB,CAAC,QAAQ,IAAI,cAAc,GAC/C,QAAQ,IAAI,gBAAgB,kBAAkB;GAEhD,MAAM,MAAgB,MAAM,MAAM,IAAI,MAAM;IAC1C;IACA;IACA,MAAM;IACN;GACF,CAAC;GACD,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,gBAAgB,IAAI,OAAO;GACnD,IAAI,aAAa,GAAG,GAAG;IACrB,MAAM,OAAQ,MAAM,IAAI,KAAK;IAC7B,OAAO;KAAE,MAAM;KAAM;KAAM;KAAQ;IAAgB,CAAC;GACtD,OAAO;IACL,MAAM,OAAO,MAAM,IAAI,KAAK;IAC5B,OAAO;KAAE,MAAM;KAAM;KAAM;KAAQ;IAAgB,CAAC;GACtD;EACF,SAAS,GAAG;GAEV,IADkB,aAAa,gBAAgB,EAAE,SAAS,cAExD,OAAO,EAAE,MAAM,UAAU,CAAC;QAE1B,OAAO,EAAE,MAAM,QAAQ,CAAC;EAE5B;CACF,EAAA,CAAG;CAEH,MAAM,eAAwB,EAAE,MAAM,SAAS,aAAa,MAAM,SAAS;CAE3E,OAAO,YACL,QACC,UAA0C;EACzC,MAAM,CAAC,KAAK,WAAW;EACvB,IAAI,IAAI,SAAS,QACf,WAAW,MAAM;EAEnB,IAAI,IAAI,SAAS,WAAW;GAC1B,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,SAAS;GACxB,SAAS,GAAG;GACZ,MAAM,OAAO;EACf;EACA,IAAI,IAAI,SAAS,WACf,MAAM,OAAO;EAEf,IAAI,IAAI,SAAS,MAAM;GACrB,SAAS,GAAG;GACZ,MAAM,OAAO;GACb,MAAM,OAAO,IAAI,QAAQ;GACzB,MAAM,OAAO,IAAI,QAAQ;GACzB,MAAM,SAAS,IAAI;GACnB,MAAM,kBAAkB,IAAI;EAC9B;CACF,GACA,QACA,KACF;AACF"}

package/package.json

@@ -1,25 +1,12 @@
 {
-  "type": "module",
   "name": "posipaki",
-  "version": "0.27.0",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "version": "0.27.2",
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "oxlint"
-  },
-  "devDependencies": {
-    "@types/node": "^25.9.1",
-    "oxlint": "^1.79.0",
-    "tsdown": "^0.22.14",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
-  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -45,5 +32,18 @@
       "types": "./dist/testing/index.d.ts",
       "default": "./dist/testing/index.js"
     }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "oxlint"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "oxlint": "^1.79.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
   }
 }

package/dist/hooks-DL2s94eM.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks-DL2s94eM.d.ts","names":[],"sources":["../src/actor-types.ts","../src/hooks.ts"],"mappings":"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"}