posipaki 0.44.0 → 0.45.0

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
-import { a as Message, m as AsyncProcess } from "../types-CuabnerI.js";
-import { d as ActorPlugin } from "../hooks-Dpbe39oa.js";
+import { a as Message, m as AsyncProcess } from "../types-U3NvKgpg.js";
+import { d as ActorPlugin } from "../hooks-DO-efRM_.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<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>;
+declare function nextState<A, S, IM extends Message, OM extends Message, R extends object>(proc: AsyncProcess<A, S, IM, OM, R>): Promise<AsyncProcess<A, S, IM, OM, R>["state"]>;
+declare function nextMessage<A, S, IM extends Message, OM extends Message, R extends object>(proc: AsyncProcess<A, S, IM, OM, R>): Promise<OM>;
 //#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,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"}
+{"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,KAChC,QAAQ,aAAa,GAAG,GAAG,IAAI,IAAI;iBAStB,YAAY,GAAG,GAAG,WAAW,SAAS,WAAW,SAAS,kBACxE,MAAM,aAAa,GAAG,GAAG,IAAI,IAAI,KAChC,QAAQ"}

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> = 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, SenderInfo } 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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"}
+{"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, SenderInfo } 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): Promise<AsyncProcess<A, S, IM, OM, R>[\"state\"]> {\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): Promise<OM> {\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-CuabnerI.d.ts → types-U3NvKgpg.d.ts}

@@ -260,6 +260,15 @@ type SenderOrigin = ProcessCtx<unknown, unknown, Message, Message> | "root";
 interface FrameChannel {
   send(frame: Record<string, unknown>): void | Promise<void>;
   onMessage(handler: (frame: Record<string, unknown>) => void): () => void;
+  /**
+   * A frame with raw octets after it, written as octets rather than inside JSON.
+   *
+   * A channel over whole objects has no octets to give and does not offer these two; a
+   * connection that carries them is the one a stream can cross.
+   */
+  sendSegment?(frame: Record<string, unknown>, bytes: Uint8Array): void | Promise<void>;
+  /** Those octets, whole, in the order they were sent. */
+  onSegment?(handler: (frame: Record<string, unknown>, bytes: Uint8Array) => void): () => void;
   /** Fires when the peer disconnects (the connection closes from the other side). */
   onClose(handler: () => void): void;
   close(): Promise<void>;
@@ -327,4 +336,4 @@ type ProcessCtx<Args, State, IM extends Message, OM extends Message> = {
 type ForkSite = Pick<ProcessCtx<unknown, unknown, Message, Message>, "fork">;
 //#endregion
 export { Message as a, SenderInfo as c, WithSender as d, WithoutSender as f, spawnAsync as g, runDispatchAsync as h, FrameChannel as i, SenderOrigin as l, AsyncProcess as m, ExitMessage as n, ProcessCtx as o, AnyProcess as p, ForkSite as r, ProcessFn as s, AsyncProcessFn as t, StopMessage as u };
-//# sourceMappingURL=types-CuabnerI.d.ts.map
+//# sourceMappingURL=types-U3NvKgpg.d.ts.map

package/dist/{types-CuabnerI.d.ts.map → types-U3NvKgpg.d.ts.map}

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

package/dist/{version-B6eNJRZD.js → version-yonmO5bG.js}

@@ -1,7 +1,7 @@
 //#region src/version.ts
 /** posipaki's release version.  Must equal package.json's `version`. */
-const LIB_VERSION = "0.44.0";
+const LIB_VERSION = "0.45.0";
 //#endregion
 export { LIB_VERSION as t };
 
-//# sourceMappingURL=version-B6eNJRZD.js.map
+//# sourceMappingURL=version-yonmO5bG.js.map

package/dist/{version-B6eNJRZD.js.map → version-yonmO5bG.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-B6eNJRZD.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["// ── Library identity ───────────────────────────────────────────────────────\n//\n// posipaki's own release version, as a plain inlined string.  A consumer that\n// stages artifacts onto a host it knows nothing about has to name those\n// artifacts after which posipaki they speak, and the bundle that runs there has\n// no node_modules and no posipaki on disk — it can never read a file to find out.\n//\n// It is not the protocol version: that is `VERSION` in ./remote (`json.v1`), and\n// it does not move between releases.  The two answer different questions.\n//\n// version.test.ts pins this to package.json, so a release that forgets to bump it\n// fails the suite rather than shipping a lie.\n\n/** posipaki's release version.  Must equal package.json's `version`. */\nexport const LIB_VERSION = \"0.44.0\";\n"],"mappings":";;AAcA,MAAa,cAAc"}
+{"version":3,"file":"version-yonmO5bG.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["// ── Library identity ───────────────────────────────────────────────────────\n//\n// posipaki's own release version, as a plain inlined string.  A consumer that\n// stages artifacts onto a host it knows nothing about has to name those\n// artifacts after which posipaki they speak, and the bundle that runs there has\n// no node_modules and no posipaki on disk — it can never read a file to find out.\n//\n// It is not the protocol version: that is `VERSION` in ./remote (`json.v1`), and\n// it does not move between releases.  The two answer different questions.\n//\n// version.test.ts pins this to package.json, so a release that forgets to bump it\n// fails the suite rather than shipping a lie.\n\n/** posipaki's release version.  Must equal package.json's `version`. */\nexport const LIB_VERSION = \"0.45.0\";\n"],"mappings":";;AAcA,MAAa,cAAc"}