posipaki 0.16.2 → 0.17.0

package/dist/hooks-DCXE8xgc.d.ts

@@ -0,0 +1,129 @@
+import { c as SenderInfo, h as AsyncProcess, i as Message, m as AnyProcess, n as AsyncProcessFn, o as ProcessCtx, r as ExitMessage, t as AnyProcessCtx } from "./types-BUPRp3t_.js";
+
+//#region src/actor-types.d.ts
+type ActorMessages<M extends Message> = {
+  __tag_messages: M;
+};
+interface MethodOptions {
+  [key: string]: Function;
+}
+type HandlerFn<InMsg extends Message> = (msg: InMsg, sender: SenderInfo) => void | Promise<void>;
+type HandlerOptions<InMsg extends Message> = Omit<{ [K in InMsg["type"]]: HandlerFn<Extract<InMsg, {
+  type: K;
+}>> }, "STOP">;
+interface ReflectionOptions {}
+type Paired<Priv, Pub> = {
+  public: Pub;
+  private: Priv;
+};
+type HidePrivate<T> = T extends Paired<unknown, unknown> ? T["public"] : T;
+interface ActorDefinition<Args, InternalState, InMsg extends Message, OutMsg extends Message, ReflectionMethods extends ReflectionOptions> {
+  fn: AsyncProcessFn<Args, HidePrivate<InternalState>, InMsg, OutMsg>;
+  /** Preferred process name (from config.name). */
+  name?: string;
+  /** Raw plugin config (array or transform). Resolved at fork time. @internal */
+  pvtPluginsRaw?: ActorPlugin[] | PluginTransform;
+  /** Spawn this actor as a standalone process. */
+  spawn(args: Args): Promise<AsyncProcess<Args, HidePrivate<InternalState>, InMsg, OutMsg, ReflectionMethods & ActorReflection>>;
+  /** Spawn this actor as a child of the calling process. */
+  spawnAsChild(ctx: AnyProcessCtx, args: Args, name?: string, parentPlugins?: ActorPlugin[]): Promise<AsyncProcess<Args, HidePrivate<InternalState>, InMsg, OutMsg, ReflectionMethods & ActorReflection>>;
+  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>> & {
+  /** Preferred process name.  Used by ctx.fork() when no explicit name is given. */name?: string;
+  plugins?: ActorPlugin[] | PluginTransform;
+  outMessages?: ActorMessages<OutMsg>;
+  inMessages?: ActorMessages<InMsg>;
+  setup?: (this: ActorContext<Args, never, InMsg, OutMsg, Methods, Handlers, ReflectionMethods & ActorReflection>, args: Args) => Promise<InternalState> | InternalState;
+  afterStart?: () => void | Promise<void>;
+  onStopRequested?: () => HookResult | Promise<HookResult>;
+  onEnd?: (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>;
+  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>>;
+  $decorate?: Partial<ActorDecorated>;
+};
+type AnyConfig = ActorConfig<unknown, unknown, Message, Message, MethodOptions, HandlerOptions<Message>, ReflectionOptions>;
+/** Returned by onMessage hooks to prevent further dispatch. */
+declare const STOP_SENTINEL: unique symbol;
+/** Type-safe sentinel for short-circuiting onMessage hooks. */
+declare const stopPropagation: () => typeof STOP_SENTINEL;
+/** Return type of onMessage hooks: void (continue) or sentinel (stop). */
+type HookResult = void | typeof STOP_SENTINEL;
+/** A reusable unit of actor behaviour. */
+type ActorPlugin<C = AnyConfig> = (config: C) => C | Promise<C>;
+/** Transform parent plugins into child plugins. */
+type PluginTransform = (parentPlugins: ActorPlugin[]) => ActorPlugin[];
+type ActorContext<Args, InternalState, InMsg extends Message, OutMsg extends Message, Methods extends MethodOptions, Handlers extends HandlerOptions<InMsg>, ReflectionMethods extends ReflectionOptions> = Methods & ActorDecorated & {
+  state: InternalState;
+  name: string;
+  id: symbol;
+  emit: (msg: OutMsg) => void;
+  agreeToStop: () => void;
+  reflection: ThisType<ActorContext<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>> & ReflectionMethods;
+  exit: (reason?: unknown) => void;
+  $child: Record<string, AnyProcess>;
+  fork<A, S, IM extends Message, OM extends Message, R extends ReflectionOptions>(fn: ActorDefinition<A, S, IM, OM, R>, name?: string, args?: A): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R>>;
+  ctx: ProcessCtx<Args, HidePrivate<InternalState>, InMsg, OutMsg>;
+};
+//#endregion
+//#region src/hooks.d.ts
+/**
+ * Interface that plugins can augment via declaration merging.
+ * Plugins ship a .d.ts that adds properties to this interface,
+ * making them available on `this` in handlers and methods.
+ *
+ * Example (in a plugin's .d.ts):
+ *   declare module 'posipaki' {
+ *     interface ActorDecorated {
+ *       log: Logger;
+ *     }
+ *   }
+ */
+interface ActorDecorated {}
+interface ActorReflection {}
+/**
+ * Compose two lifecycle hooks so that `plugin` fires first.
+ *
+ * If `plugin` returns the STOP_SENTINEL (via stopPropagation()),
+ * `existing` is skipped entirely and the sentinel propagates.
+ * Otherwise `existing` fires and its return value is used.
+ *
+ * Typical use in a plugin:
+ *   (cfg) => ({ ...cfg, onStart: chainHook(cfg.onStart, myOnStart) })
+ *
+ * @param existing - the current hook on the config (may be undefined)
+ * @param plugin   - the new hook to prepend
+ * @returns a composed hook suitable for ActorConfig
+ */
+declare function chainHook<TThis, TArgs extends unknown[]>(existing: ((this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>) | undefined, plugin: (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>): (this: TThis, ...args: TArgs) => HookResult | Promise<HookResult>;
+/**
+ * Merge an overlay config into a base config, auto-chaining every on* hook.
+ *
+ * Each key in `overlay` that starts with "on" followed by an uppercase
+ * letter (onStart, onMessage, onEmit, etc.) is composed via chainHook()
+ * so that the overlay hook fires before the base hook, and stopPropagation
+ * is respected.
+ *
+ * Typical use in a plugin:
+ *   return mergeConfigs(cfg, {
+ *     onStart() { this.log.info('starting'); },
+ *     onEnd()   { this.log.info('stopping'); },
+ *   });
+ *
+ * @param base    - the existing config (ActorConfig)
+ * @param overlay - new hook implementations to prepend
+ * @returns a new config with hooks chained
+ */
+declare function mergeConfigs<T extends {}>(base: T, overlay: Partial<T>): T;
+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, 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, stopPropagation as y };
+//# sourceMappingURL=hooks-DCXE8xgc.d.ts.map

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

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

package/dist/hooks-OcDWhAZK.js

@@ -0,0 +1,72 @@
+//#region src/actor-types.ts
+/** Returned by onMessage hooks to prevent further dispatch. */
+const STOP_SENTINEL = Symbol("posipaki.stopPropagation");
+/** Type-safe sentinel for short-circuiting onMessage hooks. */
+const stopPropagation = () => STOP_SENTINEL;
+//#endregion
+//#region src/hooks.ts
+/**
+* Compose two lifecycle hooks so that `plugin` fires first.
+*
+* If `plugin` returns the STOP_SENTINEL (via stopPropagation()),
+* `existing` is skipped entirely and the sentinel propagates.
+* Otherwise `existing` fires and its return value is used.
+*
+* Typical use in a plugin:
+*   (cfg) => ({ ...cfg, onStart: chainHook(cfg.onStart, myOnStart) })
+*
+* @param existing - the current hook on the config (may be undefined)
+* @param plugin   - the new hook to prepend
+* @returns a composed hook suitable for ActorConfig
+*/
+function chainHook(existing, plugin) {
+	if (!existing) return plugin;
+	return async function(...args) {
+		const result = await plugin.call(this, ...args);
+		if (result === STOP_SENTINEL) return result;
+		return await existing.call(this, ...args);
+	};
+}
+/**
+* Merge an overlay config into a base config, auto-chaining every on* hook.
+*
+* Each key in `overlay` that starts with "on" followed by an uppercase
+* letter (onStart, onMessage, onEmit, etc.) is composed via chainHook()
+* so that the overlay hook fires before the base hook, and stopPropagation
+* is respected.
+*
+* Typical use in a plugin:
+*   return mergeConfigs(cfg, {
+*     onStart() { this.log.info('starting'); },
+*     onEnd()   { this.log.info('stopping'); },
+*   });
+*
+* @param base    - the existing config (ActorConfig)
+* @param overlay - new hook implementations to prepend
+* @returns a new config with hooks chained
+*/
+function mergeConfigs(base, overlay) {
+	const result = { ...base };
+	for (const key of Object.keys(overlay)) {
+		const val = overlay[key];
+		if (typeof val === "function" && /^(on|after)[A-Z]/.test(key)) result[key] = chainHook(base[key], val);
+		else result[key] = val;
+	}
+	result.$reflectionMethods = {};
+	Object.assign(result.$reflectionMethods, "$reflectionMethods" in base ? base.$reflectionMethods : {}, "$reflectionMethods" in overlay ? overlay.$reflectionMethods : {});
+	return result;
+}
+async function callHook(fn, eh, thisArg, ...args) {
+	if (fn) try {
+		return await fn.call(thisArg, ...args);
+	} catch (e) {
+		if (eh) try {
+			await eh(e);
+		} catch {}
+		else throw e;
+	}
+}
+//#endregion
+export { stopPropagation as a, STOP_SENTINEL as i, chainHook as n, mergeConfigs as r, callHook as t };
+
+//# sourceMappingURL=hooks-OcDWhAZK.js.map

package/dist/hooks-OcDWhAZK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-OcDWhAZK.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  AnyProcessCtx,\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 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  ): 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  spawnAsChild(\n    ctx: AnyProcessCtx,\n    args: Args,\n    name?: string,\n    parentPlugins?: ActorPlugin[],\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  outMessages?: ActorMessages<OutMsg>;\n  inMessages?: ActorMessages<InMsg>;\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  afterStart?: () => void | Promise<void>;\n  onStopRequested?: () => HookResult | Promise<HookResult>;\n  onEnd?: (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  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// ── 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 Message,\n      R extends ReflectionOptions,\n    >(\n      fn: ActorDefinition<A, S, IM, OM, R>,\n      name?: string,\n      args?: A,\n    ): Promise<AsyncProcess<A, HidePrivate<S>, IM, OM, R>>;\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} 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 *     onEnd()   { 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<T extends {}>(base: T, overlay: Partial<T>): T {\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)[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 T;\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":";;AAiMA,MAAa,gBAAgB,OAAO,0BAA0B;;AAG9D,MAAa,wBAA8C;;;;;;;;;;;;;;;;;AChJ3D,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,aAA2B,MAAS,SAAwB;CAC1E,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,KAAK,MAAM,OAAO,OAAO,KAAK,OAAkC,GAAG;EACjE,MAAM,MAAO,QAAoC;EACjD,IAAI,OAAO,QAAQ,cAAc,mBAAmB,KAAK,GAAG,GAC1D,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"}

package/dist/hooks.d.ts

@@ -1,2 +1,2 @@
-import { _ as OnStartHook, b as STOP_SENTINEL, f as OnChildExitHook, g as OnMessageHook, h as OnErrorHook, m as OnEndHook, n as HookRegistry, p as OnEmitHook, s as ActorPlugin, t as ActorDecorated, u as HookResult, v as OnStopRequestedHook, x as stopPropagation, y as PluginTransform } from "./hooks-Czj67zNB.js";
-export { ActorDecorated, type ActorPlugin, HookRegistry, type HookResult, type OnChildExitHook, type OnEmitHook, type OnEndHook, type OnErrorHook, type OnMessageHook, type OnStartHook, type OnStopRequestedHook, type PluginTransform, STOP_SENTINEL, stopPropagation };
+import { a as chainHook, 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, y as stopPropagation } from "./hooks-DCXE8xgc.js";
+export { ActorDecorated, type ActorPlugin, ActorReflection, Hook, type HookResult, type PluginTransform, STOP_SENTINEL, callHook, chainHook, mergeConfigs, stopPropagation };

package/dist/hooks.js

@@ -1,2 +1,2 @@
-import { n as STOP_SENTINEL, r as stopPropagation, t as HookRegistry } from "./hooks-D5DhD9gu.js";
-export { HookRegistry, STOP_SENTINEL, stopPropagation };
+import { a as stopPropagation, i as STOP_SENTINEL, n as chainHook, r as mergeConfigs, t as callHook } from "./hooks-OcDWhAZK.js";
+export { STOP_SENTINEL, callHook, chainHook, mergeConfigs, stopPropagation };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { a as ProcessCtx, c as SenderOrigin, d as WithSender, f as WithoutSender, h as spawnAsync, i as PipeState, l as StopMessage, m as runDispatchAsync, n as ExitMessage, o as ProcessFn, p as AsyncProcess, r as Message, s as SenderInfo, t as AsyncProcessFn, u as SupervisorState } from "./types-BLIFntvm.js";
-import { _ as OnStartHook, a as ActorDefinition, c as HandlerFn, d as MethodOptions, f as OnChildExitHook, g as OnMessageHook, h as OnErrorHook, i as ActorContext, l as HandlerOptions, m as OnEndHook, n as HookRegistry, o as ActorMessages, p as OnEmitHook, r as ActorConfig, s as ActorPlugin, t as ActorDecorated, u as HookResult, v as OnStopRequestedHook, x as stopPropagation, y as PluginTransform } from "./hooks-Czj67zNB.js";
-import { n as spawn, r as runDispatch, t as Process } from "./process-Bf9HTr0m.js";
+import { _ as spawnAsync, a as PipeState, c as SenderInfo, d as SupervisorState, f as WithSender, g as runDispatchAsync, h as AsyncProcess, i as Message, l as SenderOrigin, n as AsyncProcessFn, o as ProcessCtx, p as WithoutSender, r as ExitMessage, s as ProcessFn, u as StopMessage } from "./types-BUPRp3t_.js";
+import { _ as ReflectionOptions, a as chainHook, 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 stopPropagation } from "./hooks-DCXE8xgc.js";
+import { n as spawn, r as runDispatch, t as Process } from "./process-B7rh_NBl.js";
 
 //#region src/adapters.d.ts
 declare function asyncify<A, S, IM extends Message, OM extends Message>(fn: ProcessFn<A, S, IM, OM>): AsyncProcessFn<A, S, IM, OM>;
 //#endregion
 //#region src/define-actor.d.ts
 declare function defineMessages<OutMsg extends Message = Message>(): ActorMessages<OutMsg>;
-declare function defineActor<Args, InternalState, ExposedState, InMsg extends Message, OutMsg extends Message, Methods extends MethodOptions, Handlers extends HandlerOptions<InMsg>, ReflectionMethods = {}>(config: ActorConfig<Args, InternalState, ExposedState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>): ActorDefinition<Args, ExposedState, InMsg, OutMsg, Handlers, ReflectionMethods>;
+declare function defineActor<Args, InternalState, InMsg extends Message, OutMsg extends Message, Methods extends MethodOptions, Handlers extends HandlerOptions<InMsg>, ReflectionMethods extends ReflectionOptions>(config: ActorConfig<Args, InternalState, InMsg, OutMsg, Methods, Handlers, ReflectionMethods>): ActorDefinition<Args, InternalState, InMsg, OutMsg, ReflectionMethods>;
 //#endregion
-export { type ActorConfig, type ActorContext, type ActorDecorated, type ActorDefinition, type ActorPlugin, AsyncProcess, type AsyncProcessFn, type ExitMessage, type HandlerFn, type HandlerOptions, HookRegistry, type HookResult, type Message, type MethodOptions, type OnChildExitHook, type OnEmitHook, type OnEndHook, type OnErrorHook, type OnMessageHook, type OnStartHook, type OnStopRequestedHook, type PipeState, type PluginTransform, Process, type ProcessCtx, type ProcessFn, type SenderInfo, type SenderOrigin, type StopMessage, type SupervisorState, type WithSender, type WithoutSender, asyncify, defineActor, defineMessages, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };
+export { type ActorConfig, type ActorContext, type ActorDecorated, type ActorDefinition, type ActorPlugin, type ActorReflection, AsyncProcess, type AsyncProcessFn, type ExitMessage, type HandlerFn, type HandlerOptions, type HookResult, type Message, type MethodOptions, type PipeState, type PluginTransform, Process, type ProcessCtx, type ProcessFn, type SenderInfo, type SenderOrigin, type StopMessage, type SupervisorState, type WithSender, type WithoutSender, asyncify, callHook, chainHook, defineActor, defineMessages, mergeConfigs, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/adapters.ts","../src/define-actor.ts"],"mappings":";;;;;iBAEgB,QAAA,kBAA0B,OAAA,aAAoB,OAAA,EAC5D,EAAA,EAAI,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA,IACvB,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA;;;iBC6BZ,cAAA,gBACC,OAAA,GAAU,OAAA,KACtB,aAAA,CAAc,MAAA;AAAA,iBAIH,WAAA,kDAIA,OAAA,iBACC,OAAA,kBACC,aAAA,mBACC,cAAA,CAAe,KAAA,2BAGhC,MAAA,EAAQ,WAAA,CACN,IAAA,EACA,aAAA,EACA,YAAA,EACA,KAAA,EACA,MAAA,EACA,OAAA,EACA,QAAA,EACA,iBAAA,IAED,eAAA,CAAgB,IAAA,EAAM,YAAA,EAAc,KAAA,EAAO,MAAA,EAAQ,QAAA,EAAU,iBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/adapters.ts","../src/define-actor.ts"],"mappings":";;;;;iBAEgB,QAAA,kBAA0B,OAAA,aAAoB,OAAA,EAC5D,EAAA,EAAI,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA,IACvB,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA;;;iBCmCZ,cAAA,gBACC,OAAA,GAAU,OAAA,KACtB,aAAA,CAAc,MAAA;AAAA,iBA0CH,WAAA,oCAGA,OAAA,iBACC,OAAA,kBACC,aAAA,mBACC,cAAA,CAAe,KAAA,6BACN,iBAAA,EAE1B,MAAA,EAAQ,WAAA,CACN,IAAA,EACA,aAAA,EACA,KAAA,EACA,MAAA,EACA,OAAA,EACA,QAAA,EACA,iBAAA,IAED,eAAA,CAAgB,IAAA,EAAM,aAAA,EAAe,KAAA,EAAO,MAAA,EAAQ,iBAAA"}

package/dist/index.js

@@ -1,4 +1,4 @@
 import { i as runDispatch } from "./util-DsfVKxTT.js";
-import { a as AsyncProcess, c as asyncify, i as spawn, n as defineMessages, o as runDispatchAsync, r as Process, s as spawnAsync, t as defineActor } from "./src-B2jOTwzs.js";
-import { r as stopPropagation, t as HookRegistry } from "./hooks-D5DhD9gu.js";
-export { AsyncProcess, HookRegistry, Process, asyncify, defineActor, defineMessages, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };
+import { a as AsyncProcess, c as asyncify, i as spawn, n as defineMessages, o as runDispatchAsync, r as Process, s as spawnAsync, t as defineActor } from "./src-gcahpgho.js";
+import { a as stopPropagation, n as chainHook, r as mergeConfigs, t as callHook } from "./hooks-OcDWhAZK.js";
+export { AsyncProcess, Process, asyncify, callHook, chainHook, defineActor, defineMessages, mergeConfigs, runDispatch, runDispatchAsync, spawn, spawnAsync, stopPropagation };

package/dist/pipe.d.ts

@@ -1,4 +1,4 @@
-import { n as ExitMessage, o as ProcessFn, r as Message } from "./types-BLIFntvm.js";
+import { i as Message, r as ExitMessage, s as ProcessFn } from "./types-BUPRp3t_.js";
 
 //#region src/pipe.d.ts
 /**
@@ -16,7 +16,9 @@ interface PipeState<Params, Result> {
  * The `.state.result` of each completed child is spread into the params
  * of the next.
  */
-declare function pipe<Params, Result>(fns: ProcessFn<unknown, unknown, Message, Message>[]): ProcessFn<Params, PipeState<Params, Result>, Message, Message | ExitMessage>;
+declare function pipe<Params, Result>(fns: ProcessFn<unknown, {
+  result: object;
+}, Message, Message>[]): ProcessFn<Params, PipeState<Params, Result>, Message, Message | ExitMessage>;
 //#endregion
 export { PipeState, pipe };
 //# sourceMappingURL=pipe.d.ts.map

package/dist/pipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.d.ts","names":[],"sources":["../src/pipe.ts"],"mappings":";;;AAWA;;;;;AAAA,UAAiB,SAAA;EACf,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,MAAM;EACd,OAAA;AAAA;;;AAAO;AACR;;iBAOQ,IAAA,iBACP,GAAA,EAAK,SAAA,mBAA4B,OAAA,EAAS,OAAA,MACzC,SAAA,CACD,MAAA,EACA,SAAA,CAAU,MAAA,EAAQ,MAAA,GAClB,OAAA,EACA,OAAA,GAAU,WAAA"}
+{"version":3,"file":"pipe.d.ts","names":[],"sources":["../src/pipe.ts"],"mappings":";;;AAWA;;;;;AAAA,UAAiB,SAAA;EACf,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,MAAM;EACd,OAAA;AAAA;;;AAAO;AACR;;iBAOQ,IAAA,iBACP,GAAA,EAAK,SAAA;EAAqB,MAAA;AAAA,GAAkB,OAAA,EAAS,OAAA,MACpD,SAAA,CACD,MAAA,EACA,SAAA,CAAU,MAAA,EAAQ,MAAA,GAClB,OAAA,EACA,OAAA,GAAU,WAAA"}

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, unknown, 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<any, any, any, any>;\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,EAAE,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,IACjD,IAAI,QAAQ,GAAG;IACb,MAAM,SAAS;KACb,GAAG,MAAM;KACT,GAAG,KAAK,OAAO;IACjB;IACA,UAAU;GACZ,OAAO;IACL,MAAM,UAAU;IAChB,MAAM,SAAS,KAAK,OAAO;GAC7B;EAEJ,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<\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,EAAE,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,IACjD,IAAI,QAAQ,GAAG;IACb,MAAM,SAAS;KACb,GAAG,MAAM;KACT,GAAG,KAAK,OAAO;IACjB;IACA,UAAU;GACZ,OAAO;IACL,MAAM,UAAU;IAChB,MAAM,SAAS,KAAK,OAAO;GAC7B;EAEJ,SACM,CAAC,MAAM,SACb,IACF;CACF;AACF"}

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

@@ -1,6 +1,11 @@
-import { s as ActorPlugin } from "../hooks-Czj67zNB.js";
+import { d as ActorPlugin } from "../hooks-DCXE8xgc.js";
 
 //#region src/plugins/debug-logger.d.ts
+declare module "../hooks" {
+  interface ActorDecorated {
+    log: Logger;
+  }
+}
 interface DebugLogFn {
   (message: string, ...args: unknown[]): void;
 }
@@ -10,12 +15,9 @@ interface Logger {
   warn: DebugLogFn;
   error: DebugLogFn;
 }
-/** Factory: receives an actor name, returns a Logger. */
 type LoggerFactory = (name: string) => Logger;
 interface DebugLoggerOpts {
-  /** Message types to silence (e.g. ['HEARTBEAT', 'TICK']).  Default: none. */
   ignore?: string[];
-  /** Logger factory.  Default: console-based logger. */
   factory?: LoggerFactory;
 }
 declare function debugLogger(opts?: DebugLoggerOpts): ActorPlugin;

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

@@ -1 +1 @@
-{"version":3,"file":"debug-logger.d.ts","names":[],"sources":["../../src/plugins/debug-logger.ts"],"mappings":";;;UAmCiB,UAAA;EAAA,CACd,OAAA,aAAoB,IAAI;AAAA;AAAA,UAGV,MAAA;EACf,KAAA,EAAO,UAAA;EACP,IAAA,EAAM,UAAA;EACN,IAAA,EAAM,UAAA;EACN,KAAA,EAAO,UAAA;AAAA;;KAIG,aAAA,IAAiB,IAAA,aAAiB,MAAM;AAAA,UAInC,eAAA;EATT;EAWN,MAAA;EAViB;EAYjB,OAAA,GAAU,aAAa;AAAA;AAAA,iBAyCT,WAAA,CAAY,IAAA,GAAO,eAAA,GAAkB,WAAW"}
+{"version":3,"file":"debug-logger.d.ts","names":[],"sources":["../../src/plugins/debug-logger.ts"],"mappings":";;;;YAKY,cAAA;IACR,GAAA,EAAK,MAAM;EAAA;AAAA;AAAA,UAIE,UAAA;EAAA,CACd,OAAA,aAAoB,IAAI;AAAA;AAAA,UAEV,MAAA;EACf,KAAA,EAAO,UAAA;EACP,IAAA,EAAM,UAAA;EACN,IAAA,EAAM,UAAA;EACN,KAAA,EAAO,UAAA;AAAA;AAAA,KAEG,aAAA,IAAiB,IAAA,aAAiB,MAAM;AAAA,UACnC,eAAA;EACf,MAAA;EACA,OAAA,GAAU,aAAa;AAAA;AAAA,iBA+BT,WAAA,CAAY,IAAA,GAAO,eAAA,GAAkB,WAAW"}

package/dist/plugins/debug-logger.js

@@ -1,3 +1,4 @@
+import { r as mergeConfigs } from "../hooks-OcDWhAZK.js";
 //#region src/plugins/debug-logger.ts
 function patterns() {
 	const raw = (process.env.DEBUG ?? "").trim();
@@ -9,48 +10,45 @@ function matches(name, pats) {
 	for (const p of pats) {
 		if (p === "*") return true;
 		if (p.endsWith(":*")) {
-			const prefix = p.slice(0, -2);
-			if (name === prefix || name.startsWith(prefix + ":")) return true;
-			continue;
-		}
-		if (p === name) return true;
+			if (name === p.slice(0, -2) || name.startsWith(p.slice(0, -2) + ":")) return true;
+		} else if (p === name) return true;
 	}
 	return false;
 }
 function defaultFactory(name) {
 	return {
-		debug: (...args) => console.debug(`[${name}]`, ...args),
-		info: (...args) => console.info(`[${name}]`, ...args),
-		warn: (...args) => console.warn(`[${name}]`, ...args),
-		error: (...args) => console.error(`[${name}]`, ...args)
+		debug: (...a) => console.debug(`[${name}]`, ...a),
+		info: (...a) => console.info(`[${name}]`, ...a),
+		warn: (...a) => console.warn(`[${name}]`, ...a),
+		error: (...a) => console.error(`[${name}]`, ...a)
 	};
 }
 function debugLogger(opts) {
 	const ignoreSet = new Set(opts?.ignore ?? []);
 	const factory = opts?.factory ?? defaultFactory;
-	return {
-		name: "debugLogger",
-		install(self) {
-			const name = self.name;
-			const pats = patterns();
-			const log = factory(name);
-			self.decorate("log", log);
-			if (!matches(name, pats)) return;
-			self.hooks.onMessage((msg, sender) => {
-				if (ignoreSet.has(msg.type)) return;
-				const via = sender?.fromName ? ` from ${sender.fromName}` : "";
-				log.debug(`${name} ← ${msg.type}${via}`, msg);
-			});
-			self.hooks.onEmit((msg) => {
+	return async (config) => {
+		const name = config.name ?? "actor";
+		const pats = patterns();
+		const log = factory(name);
+		let result = mergeConfigs(config, {
+			methods: { ...config.methods },
+			$decorate: { log }
+		});
+		if (matches(name, pats)) result = mergeConfigs(result, {
+			onMessage(msg) {
+				if (!ignoreSet.has(msg.type)) log.debug(`${name} ← ${msg.type}`, msg);
+			},
+			onEmit(msg) {
 				log.debug(`${name} → ${msg.type}`, msg);
-			});
-			self.hooks.onChildExit((childName) => {
+			},
+			onChildExit(childName) {
 				log.debug(`child ${childName} exited`);
-			});
-			self.hooks.onError((err) => {
+			},
+			onError(err) {
 				log.error(`${err.message ?? err}`);
-			});
-		}
+			}
+		});
+		return result;
 	};
 }
 //#endregion

package/dist/plugins/debug-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"debug-logger.js","names":[],"sources":["../../src/plugins/debug-logger.ts"],"sourcesContent":["// ── debugLogger Plugin ───────────────────────────────────────────────────\n//\n// Controlled via the DEBUG environment variable.\n//\n// DEBUG format: comma-separated patterns with glob-like subtree matching.\n//\n//   DEBUG=*                           enable all debug logging\n//   DEBUG=openai:connector            log only the connector actor\n//   DEBUG=openai:*                    log the openai actor and its subtree\n//   DEBUG=openai:connector,openai:tools  log connector and tools\n//\n// Usage:\n//\n//   import { debugLogger } from 'posipaki/plugins/debug-logger';\n//   const MyActor = defineActor({\n//     plugins: [debugLogger()],\n//     ...\n//   });\n//\n// The plugin decorates every actor with `this.log` — a logger instance\n// available in handlers, hooks, and lifecycle methods.  By default it\n// writes to `console`, but you can supply a custom factory:\n//\n//   import { debugLogger } from 'posipaki/plugins/debug-logger';\n//   plugins: [debugLogger({ factory: (name) => myCustomLogger(name) })],\n//\n// Message filtering: pass `ignore` to suppress noisy message types.\n//\n//   plugins: [debugLogger({ ignore: ['HEARTBEAT', 'TICK'] })],\n//\n\nimport type { ActorPlugin } from '../hooks.js';\n\n// ── Logger interface ────────────────────────────────────────────────────\n\nexport interface DebugLogFn {\n  (message: string, ...args: unknown[]): void;\n}\n\nexport interface Logger {\n  debug: DebugLogFn;\n  info: DebugLogFn;\n  warn: DebugLogFn;\n  error: DebugLogFn;\n}\n\n/** Factory: receives an actor name, returns a Logger. */\nexport type LoggerFactory = (name: string) => Logger;\n\n// ── options ─────────────────────────────────────────────────────────────\n\nexport interface DebugLoggerOpts {\n  /** Message types to silence (e.g. ['HEARTBEAT', 'TICK']).  Default: none. */\n  ignore?: string[];\n  /** Logger factory.  Default: console-based logger. */\n  factory?: LoggerFactory;\n}\n\n// ── pattern matching ─────────────────────────────────────────────────────\n\nfunction patterns(): string[] {\n  const raw = (process.env.DEBUG ?? '').trim();\n  if (!raw) return [];\n  return raw\n    .split(',')\n    .map((p) => p.trim())\n    .filter(Boolean);\n}\n\nfunction matches(name: string, pats: string[]): boolean {\n  if (pats.length === 0) return false;\n  for (const p of pats) {\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      continue;\n    }\n    if (p === name) return true;\n  }\n  return false;\n}\n\n// ── default logger ──────────────────────────────────────────────────────\n\nfunction defaultFactory(name: string): Logger {\n  return {\n    debug: (...args: unknown[]) => console.debug(`[${name}]`, ...args),\n    info: (...args: unknown[]) => console.info(`[${name}]`, ...args),\n    warn: (...args: unknown[]) => console.warn(`[${name}]`, ...args),\n    error: (...args: unknown[]) => console.error(`[${name}]`, ...args),\n  };\n}\n\n// ── plugin ───────────────────────────────────────────────────────────────\n\nexport function debugLogger(opts?: DebugLoggerOpts): ActorPlugin {\n  const ignoreSet = new Set(opts?.ignore ?? []);\n  const factory = opts?.factory ?? defaultFactory;\n\n  return {\n    name: 'debugLogger',\n    install(self) {\n      const name: string = self.name;\n      const pats = patterns();\n      const log = factory(name);\n\n      // Always decorate so handlers can use this.log.\n      self.decorate('log', log);\n\n      // Only register hooks if DEBUG patterns match.\n      if (!matches(name, pats)) return;\n\n      self.hooks.onMessage((msg: any, sender: any) => {\n        if (ignoreSet.has(msg.type)) return;\n        const via = sender?.fromName ? ` from ${sender.fromName}` : '';\n        log.debug(`${name} ← ${msg.type}${via}`, msg);\n      });\n\n      self.hooks.onEmit((msg: any) => {\n        log.debug(`${name} → ${msg.type}`, msg);\n      });\n\n      self.hooks.onChildExit((childName: string) => {\n        log.debug(`child ${childName} exited`);\n      });\n\n      self.hooks.onError((err: unknown) => {\n        log.error(`${(err as Error).message ?? err}`);\n      });\n    },\n  };\n}\n"],"mappings":";AA4DA,SAAS,WAAqB;CAC5B,MAAM,OAAO,QAAQ,IAAI,SAAS,IAAI,KAAK;CAC3C,IAAI,CAAC,KAAK,OAAO,CAAC;CAClB,OAAO,IACJ,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACnB;AAEA,SAAS,QAAQ,MAAc,MAAyB;CACtD,IAAI,KAAK,WAAW,GAAG,OAAO;CAC9B,KAAK,MAAM,KAAK,MAAM;EACpB,IAAI,MAAM,KAAK,OAAO;EACtB,IAAI,EAAE,SAAS,IAAI,GAAG;GACpB,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;GAC5B,IAAI,SAAS,UAAU,KAAK,WAAW,SAAS,GAAG,GAAG,OAAO;GAC7D;EACF;EACA,IAAI,MAAM,MAAM,OAAO;CACzB;CACA,OAAO;AACT;AAIA,SAAS,eAAe,MAAsB;CAC5C,OAAO;EACL,QAAQ,GAAG,SAAoB,QAAQ,MAAM,IAAI,KAAK,IAAI,GAAG,IAAI;EACjE,OAAO,GAAG,SAAoB,QAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,IAAI;EAC/D,OAAO,GAAG,SAAoB,QAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,IAAI;EAC/D,QAAQ,GAAG,SAAoB,QAAQ,MAAM,IAAI,KAAK,IAAI,GAAG,IAAI;CACnE;AACF;AAIA,SAAgB,YAAY,MAAqC;CAC/D,MAAM,YAAY,IAAI,IAAI,MAAM,UAAU,CAAC,CAAC;CAC5C,MAAM,UAAU,MAAM,WAAW;CAEjC,OAAO;EACL,MAAM;EACN,QAAQ,MAAM;GACZ,MAAM,OAAe,KAAK;GAC1B,MAAM,OAAO,SAAS;GACtB,MAAM,MAAM,QAAQ,IAAI;GAGxB,KAAK,SAAS,OAAO,GAAG;GAGxB,IAAI,CAAC,QAAQ,MAAM,IAAI,GAAG;GAE1B,KAAK,MAAM,WAAW,KAAU,WAAgB;IAC9C,IAAI,UAAU,IAAI,IAAI,IAAI,GAAG;IAC7B,MAAM,MAAM,QAAQ,WAAW,SAAS,OAAO,aAAa;IAC5D,IAAI,MAAM,GAAG,KAAK,KAAK,IAAI,OAAO,OAAO,GAAG;GAC9C,CAAC;GAED,KAAK,MAAM,QAAQ,QAAa;IAC9B,IAAI,MAAM,GAAG,KAAK,KAAK,IAAI,QAAQ,GAAG;GACxC,CAAC;GAED,KAAK,MAAM,aAAa,cAAsB;IAC5C,IAAI,MAAM,SAAS,UAAU,QAAQ;GACvC,CAAC;GAED,KAAK,MAAM,SAAS,QAAiB;IACnC,IAAI,MAAM,GAAI,IAAc,WAAW,KAAK;GAC9C,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"debug-logger.js","names":[],"sources":["../../src/plugins/debug-logger.ts"],"sourcesContent":["import type { ActorPlugin } from \"../hooks\";\nimport { mergeConfigs } from \"../hooks\";\nimport type { Message } from \"../types\";\n\ndeclare module \"../hooks\" {\n  interface ActorDecorated {\n    log: Logger;\n  }\n}\n\nexport interface DebugLogFn {\n  (message: string, ...args: unknown[]): void;\n}\nexport interface Logger {\n  debug: DebugLogFn;\n  info: DebugLogFn;\n  warn: DebugLogFn;\n  error: DebugLogFn;\n}\nexport type LoggerFactory = (name: string) => Logger;\nexport interface DebugLoggerOpts {\n  ignore?: string[];\n  factory?: LoggerFactory;\n}\n\nfunction patterns(): string[] {\n  const raw = (process.env.DEBUG ?? \"\").trim();\n  if (!raw) return [];\n  return raw\n    .split(\",\")\n    .map((p) => p.trim())\n    .filter(Boolean);\n}\nfunction matches(name: string, pats: string[]): boolean {\n  if (pats.length === 0) return false;\n  for (const p of pats) {\n    if (p === \"*\") return true;\n    if (p.endsWith(\":*\")) {\n      if (name === p.slice(0, -2) || name.startsWith(p.slice(0, -2) + \":\"))\n        return true;\n    } else if (p === name) return true;\n  }\n  return false;\n}\nfunction defaultFactory(name: string): Logger {\n  return {\n    debug: (...a: unknown[]) => console.debug(`[${name}]`, ...a),\n    info: (...a: unknown[]) => console.info(`[${name}]`, ...a),\n    warn: (...a: unknown[]) => console.warn(`[${name}]`, ...a),\n    error: (...a: unknown[]) => console.error(`[${name}]`, ...a),\n  };\n}\n\nexport function debugLogger(opts?: DebugLoggerOpts): ActorPlugin {\n  const ignoreSet = new Set(opts?.ignore ?? []);\n  const factory = opts?.factory ?? defaultFactory;\n  return async (config) => {\n    const name: string = config.name ?? \"actor\";\n    const pats = patterns();\n    const log = factory(name);\n\n    // Always decorate this.log — even when DEBUG is empty\n    let result = mergeConfigs(config, {\n      methods: { ...config.methods },\n      $decorate: { log },\n    });\n\n    if (matches(name, pats)) {\n      result = mergeConfigs(result, {\n        onMessage(msg: Message) {\n          if (!ignoreSet.has(msg.type)) log.debug(`${name} ← ${msg.type}`, msg);\n        },\n        onEmit(msg: Message) {\n          log.debug(`${name} → ${msg.type}`, msg);\n        },\n        onChildExit(childName: string) {\n          log.debug(`child ${childName} exited`);\n        },\n        onError(err: unknown) {\n          log.error(`${(err as Error).message ?? err}`);\n        },\n      });\n    }\n\n    return result;\n  };\n}\n"],"mappings":";;AAyBA,SAAS,WAAqB;CAC5B,MAAM,OAAO,QAAQ,IAAI,SAAS,IAAI,KAAK;CAC3C,IAAI,CAAC,KAAK,OAAO,CAAC;CAClB,OAAO,IACJ,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACnB;AACA,SAAS,QAAQ,MAAc,MAAyB;CACtD,IAAI,KAAK,WAAW,GAAG,OAAO;CAC9B,KAAK,MAAM,KAAK,MAAM;EACpB,IAAI,MAAM,KAAK,OAAO;EACtB,IAAI,EAAE,SAAS,IAAI;OACb,SAAS,EAAE,MAAM,GAAG,EAAE,KAAK,KAAK,WAAW,EAAE,MAAM,GAAG,EAAE,IAAI,GAAG,GACjE,OAAO;EAAA,OACJ,IAAI,MAAM,MAAM,OAAO;CAChC;CACA,OAAO;AACT;AACA,SAAS,eAAe,MAAsB;CAC5C,OAAO;EACL,QAAQ,GAAG,MAAiB,QAAQ,MAAM,IAAI,KAAK,IAAI,GAAG,CAAC;EAC3D,OAAO,GAAG,MAAiB,QAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC;EACzD,OAAO,GAAG,MAAiB,QAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC;EACzD,QAAQ,GAAG,MAAiB,QAAQ,MAAM,IAAI,KAAK,IAAI,GAAG,CAAC;CAC7D;AACF;AAEA,SAAgB,YAAY,MAAqC;CAC/D,MAAM,YAAY,IAAI,IAAI,MAAM,UAAU,CAAC,CAAC;CAC5C,MAAM,UAAU,MAAM,WAAW;CACjC,OAAO,OAAO,WAAW;EACvB,MAAM,OAAe,OAAO,QAAQ;EACpC,MAAM,OAAO,SAAS;EACtB,MAAM,MAAM,QAAQ,IAAI;EAGxB,IAAI,SAAS,aAAa,QAAQ;GAChC,SAAS,EAAE,GAAG,OAAO,QAAQ;GAC7B,WAAW,EAAE,IAAI;EACnB,CAAC;EAED,IAAI,QAAQ,MAAM,IAAI,GACpB,SAAS,aAAa,QAAQ;GAC5B,UAAU,KAAc;IACtB,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,GAAG,IAAI,MAAM,GAAG,KAAK,KAAK,IAAI,QAAQ,GAAG;GACtE;GACA,OAAO,KAAc;IACnB,IAAI,MAAM,GAAG,KAAK,KAAK,IAAI,QAAQ,GAAG;GACxC;GACA,YAAY,WAAmB;IAC7B,IAAI,MAAM,SAAS,UAAU,QAAQ;GACvC;GACA,QAAQ,KAAc;IACpB,IAAI,MAAM,GAAI,IAAc,WAAW,KAAK;GAC9C;EACF,CAAC;EAGH,OAAO;CACT;AACF"}

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

@@ -0,0 +1,25 @@
+import { d as ActorPlugin } from "../hooks-DCXE8xgc.js";
+
+//#region src/plugins/tree-introspection.d.ts
+declare module "../hooks" {
+  interface ActorReflection {
+    "inspect.getTree": TreeReflectionMethods["inspect.getTree"];
+    "inspect.getState": TreeReflectionMethods["inspect.getState"];
+    "inspect.stop": TreeReflectionMethods["inspect.stop"];
+  }
+}
+interface TreeReflectionMethods {
+  "inspect.getTree": (prefix?: string) => TreeNode;
+  "inspect.getState": () => unknown;
+  "inspect.stop": () => void;
+}
+interface TreeNode {
+  pname: string;
+  parentName: string | null;
+  children: TreeNode[];
+  status: "running" | "no introspection";
+}
+declare function inspect(): ActorPlugin;
+//#endregion
+export { TreeNode, inspect };
+//# sourceMappingURL=tree-introspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-introspection.d.ts","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"mappings":";;;;YAKY,eAAA;IACR,iBAAA,EAAmB,qBAAA;IACnB,kBAAA,EAAoB,qBAAA;IACpB,cAAA,EAAgB,qBAAA;EAAA;AAAA;AAAA,UAIV,qBAAA;EACR,iBAAA,GAAoB,MAAA,cAAoB,QAAQ;EAChD,kBAAA;EACA,cAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA;EACA,UAAA;EACA,QAAA,EAAU,QAAQ;EAClB,MAAA;AAAA;AAAA,iBAGc,OAAA,IAAW,WAAW"}

package/dist/plugins/tree-introspection.js

@@ -0,0 +1,44 @@
+import { r as mergeConfigs } from "../hooks-OcDWhAZK.js";
+//#region src/plugins/tree-introspection.ts
+function inspect() {
+	return async (config) => {
+		return mergeConfigs(config, { $reflectionMethods: {
+			...config.$reflectionMethods,
+			"inspect.getTree": function(prefix) {
+				const children = [];
+				for (const child of Object.values(this.$child)) {
+					const cr = child.$reflection;
+					if (typeof cr["inspect.getTree"] === "function") {
+						const sub = cr["inspect.getTree"](prefix);
+						if (!prefix || sub.pname.startsWith(prefix)) children.push(sub);
+					} else {
+						const n = child.pname;
+						if (!prefix || n.startsWith(prefix)) children.push({
+							pname: n,
+							parentName: this.name,
+							children: [],
+							status: "no introspection"
+						});
+					}
+				}
+				const selfCtx = this.ctx;
+				return {
+					pname: selfCtx.pname,
+					parentName: selfCtx.parentName,
+					children,
+					status: "running"
+				};
+			},
+			"inspect.getState": function() {
+				return this.state;
+			},
+			"inspect.stop": function() {
+				this.exit("inspector");
+			}
+		} });
+	};
+}
+//#endregion
+export { inspect };
+
+//# sourceMappingURL=tree-introspection.js.map

package/dist/plugins/tree-introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-introspection.js","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"sourcesContent":["import { mergeConfigs } from \"../hooks.js\";\nimport type { ActorPlugin, ActorReflection as AR } from \"../hooks.js\";\nimport { AnyProcessCtx } from \"../types.js\";\n\ndeclare module \"../hooks\" {\n  interface ActorReflection {\n    \"inspect.getTree\": TreeReflectionMethods[\"inspect.getTree\"];\n    \"inspect.getState\": TreeReflectionMethods[\"inspect.getState\"];\n    \"inspect.stop\": TreeReflectionMethods[\"inspect.stop\"];\n  }\n}\n\ninterface TreeReflectionMethods {\n  \"inspect.getTree\": (prefix?: string) => TreeNode;\n  \"inspect.getState\": () => unknown;\n  \"inspect.stop\": () => void;\n}\n\nexport interface TreeNode {\n  pname: string;\n  parentName: string | null;\n  children: TreeNode[];\n  status: \"running\" | \"no introspection\";\n}\n\nexport function inspect(): ActorPlugin {\n  return async (config) => {\n    return mergeConfigs(config, {\n      $reflectionMethods: {\n        ...config.$reflectionMethods,\n        \"inspect.getTree\": function (prefix?: string) {\n          const children: TreeNode[] = [];\n          for (const child of Object.values(this.$child)) {\n            const cr = child.$reflection as AR;\n            if (typeof cr[\"inspect.getTree\"] === \"function\") {\n              const sub = cr[\"inspect.getTree\"](prefix) as TreeNode;\n              if (!prefix || sub.pname.startsWith(prefix)) children.push(sub);\n            } else {\n              const n = child.pname;\n              if (!prefix || n.startsWith(prefix))\n                children.push({\n                  pname: n,\n                  parentName: this.name,\n                  children: [],\n                  status: \"no introspection\",\n                });\n            }\n          }\n          const selfCtx = this.ctx as AnyProcessCtx;\n          return {\n            pname: selfCtx.pname,\n            parentName: selfCtx.parentName,\n            children,\n            status: \"running\" as const,\n          } satisfies TreeNode;\n        },\n        \"inspect.getState\": function () {\n          const state = this.state as unknown;\n          return state;\n        },\n        \"inspect.stop\": function () {\n          this.exit(\"inspector\");\n        },\n      },\n    });\n  };\n}\n"],"mappings":";;AAyBA,SAAgB,UAAuB;CACrC,OAAO,OAAO,WAAW;EACvB,OAAO,aAAa,QAAQ,EAC1B,oBAAoB;GAClB,GAAG,OAAO;GACV,mBAAmB,SAAU,QAAiB;IAC5C,MAAM,WAAuB,CAAC;IAC9B,KAAK,MAAM,SAAS,OAAO,OAAO,KAAK,MAAM,GAAG;KAC9C,MAAM,KAAK,MAAM;KACjB,IAAI,OAAO,GAAG,uBAAuB,YAAY;MAC/C,MAAM,MAAM,GAAG,mBAAmB,MAAM;MACxC,IAAI,CAAC,UAAU,IAAI,MAAM,WAAW,MAAM,GAAG,SAAS,KAAK,GAAG;KAChE,OAAO;MACL,MAAM,IAAI,MAAM;MAChB,IAAI,CAAC,UAAU,EAAE,WAAW,MAAM,GAChC,SAAS,KAAK;OACZ,OAAO;OACP,YAAY,KAAK;OACjB,UAAU,CAAC;OACX,QAAQ;MACV,CAAC;KACL;IACF;IACA,MAAM,UAAU,KAAK;IACrB,OAAO;KACL,OAAO,QAAQ;KACf,YAAY,QAAQ;KACpB;KACA,QAAQ;IACV;GACF;GACA,oBAAoB,WAAY;IAE9B,OADc,KAAK;GAErB;GACA,gBAAgB,WAAY;IAC1B,KAAK,KAAK,WAAW;GACvB;EACF,EACF,CAAC;CACH;AACF"}

package/dist/{process-Bf9HTr0m.d.ts → process-B7rh_NBl.d.ts}

@@ -1,4 +1,4 @@
-import { d as WithSender, n as ExitMessage, o as ProcessFn, p as AsyncProcess, r as Message } from "./types-BLIFntvm.js";
+import { f as WithSender, h as AsyncProcess, i as Message, r as ExitMessage, s as ProcessFn } from "./types-BUPRp3t_.js";
 
 //#region src/util.d.ts
 type ReducerClosure<M> = (msg: M) => void;
@@ -23,11 +23,11 @@ declare function runDispatch<M>(name: string, fn: ReducerClosure<M>, readyFn?: R
 declare function spawn<A, S, IM extends Message = Message, OM extends Message = ExitMessage>(fn: ProcessFn<A, S, IM, OM>, pname: string, tp?: (m: WithSender<OM>) => void): (a: A) => Process<A, S, IM, OM>;
 /** @deprecated Use {@link AsyncProcess} instead. Sync processes are
  *  wrapped via asyncify internally; spawnAsync handles both. */
-declare class Process<A, S, IM extends Message, OM extends Message> extends AsyncProcess<A, S, IM, OM> {
+declare class Process<A, S, IM extends Message, OM extends Message> extends AsyncProcess<A, S, IM, OM, {}> {
   constructor(fn: ProcessFn<A, S, IM, OM>, pname: string, tp?: (m: WithSender<OM>) => void);
   start(a: A): this;
   tick(): Promise<void>;
 }
 //#endregion
 export { spawn as n, runDispatch as r, Process as t };
-//# sourceMappingURL=process-Bf9HTr0m.d.ts.map
+//# sourceMappingURL=process-B7rh_NBl.d.ts.map

package/dist/{process-Bf9HTr0m.d.ts.map → process-B7rh_NBl.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"process-Bf9HTr0m.d.ts","names":["level","args","Array","M","msg","name","ReducerClosure","fn","ReadyFn","readyFn","debugLevel","Generator","A","S","IM","type","OM","ExitMessage","toAllChildren","m","toParent","id","pname","proc","ctx","gen","cancel","flush","DeferCb","DeferredCall","promise","Promise","resolve","NotifyFn","Waiter"],"sources":["../src/util.d.ts","../src/process.ts"],"mappings":";;;KAEK,cAAA,OAAqBI,GAAAA,EAAK,CAAC;AAAA,KAC3B,OAAA;;;;;;iBAOY,WAAA,IAAeC,IAAAA,UAAcE,EAAAA,EAAI,cAAA,CAAe,CAAA,GAAIE,OAAAA,GAAU,OAAA,EAASC,UAAAA,aAAuB,SAAA,aAAsB,CAAA;AARrG;AAAA;;;;AACpB;AACC;;;;;iBCIG,KAAA,kBAGH,OAAA,GAAU,OAAA,aACV,OAAA,GAAU,WAAA,EAErB,EAAA,EAAI,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA,GACxB,KAAA,UACA,EAAA,IAAM,CAAA,EAAG,UAAA,CAAW,EAAA,cAClB,CAAA,EAAG,CAAA,KAAM,OAAA,CAAQ,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA;;;cAMzB,OAAA,kBAGO,OAAA,aACA,OAAA,UACH,YAAA,CAAa,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA;cAE7B,EAAA,EAAI,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA,GACxB,KAAA,UACA,EAAA,IAAM,CAAA,EAAG,UAAA,CAAW,EAAA;EAKtB,KAAA,CAAM,CAAA,EAAG,CAAA;EAIT,IAAA,IAAQ,OAAA;AAAA"}
+{"version":3,"file":"process-B7rh_NBl.d.ts","names":["level","args","Array","M","msg","name","ReducerClosure","fn","ReadyFn","readyFn","debugLevel","Generator","A","S","IM","type","OM","ExitMessage","toAllChildren","m","toParent","id","pname","proc","ctx","gen","cancel","flush","DeferCb","DeferredCall","promise","Promise","resolve","NotifyFn","Waiter"],"sources":["../src/util.d.ts","../src/process.ts"],"mappings":";;;KAEK,cAAA,OAAqBI,GAAAA,EAAK,CAAC;AAAA,KAC3B,OAAA;;;;;;iBAOY,WAAA,IAAeC,IAAAA,UAAcE,EAAAA,EAAI,cAAA,CAAe,CAAA,GAAIE,OAAAA,GAAU,OAAA,EAASC,UAAAA,aAAuB,SAAA,aAAsB,CAAA;AARrG;AAAA;;;;AACpB;AACC;;;;;iBCIG,KAAA,kBAGH,OAAA,GAAU,OAAA,aACV,OAAA,GAAU,WAAA,EAErB,EAAA,EAAI,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA,GACxB,KAAA,UACA,EAAA,IAAM,CAAA,EAAG,UAAA,CAAW,EAAA,cAClB,CAAA,EAAG,CAAA,KAAM,OAAA,CAAQ,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA;;;cAMzB,OAAA,kBAGO,OAAA,aACA,OAAA,UACH,YAAA,CAAa,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA;cAE7B,EAAA,EAAI,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,EAAA,GACxB,KAAA,UACA,EAAA,IAAM,CAAA,EAAG,UAAA,CAAW,EAAA;EAKtB,KAAA,CAAM,CAAA,EAAG,CAAA;EAIT,IAAA,IAAQ,OAAA;AAAA"}