statewire 0.8.1 → 0.9.0

package/dist/host/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","names":["useEffect","useState","applyOps","sanitizeValue","StatewirePath","StatewireReject","createStateDraft","createMethodProxy","ServerOp","StateDraft","StatewireSendError","Statewire","StatewireHost","isDev","process","env","stateHosts","WeakMap","StateHost","getStateHost","state","get","StateCell","current","draft","changed","onOp","op","onChange","ctl","StateCtl","host","bump","useStatewireState","init","TState","setVersion","cell","commit","c","flush","v","apply","ops","result","events","length","Error","invalidate","push","changedPaths","snapshot","setOnOp","listener","setOnChange","takeChanged","value","record","changedPath","set","proxy","const","Settled","type","error","CommandsInvocation","method","params","ts","seq","clientId","CommandsOutcome","payload","CommandsListener","onStart","inv","onPosted","onAck","onCovered","onSettle","outcome","CommandsSubmission","caller","Caller","CommandsHost","setListener","submit","call","Promise","commandsHosts","getCommandsHost","commands","bindCommandsHost","QueuedCall","resolve","reject","origin","ActiveInvocation","acked","CommandsCell","handlers","Record","args","queue","running","unmounted","stallTimer","ReturnType","setTimeout","STALL_WARN_MS","LOCAL_CALLER","Object","freeze","context","isConnected","toSendError","fate","cause","message","String","undefined","ackInvocation","settleInvocation","settled","isThenable","PromiseLike","then","dispatch","handler","ctx","Ctx","ack","this","resolved","pump","watchStall","shift","console","warn","useStatewireCommands","Commands","THandlers","ThisType","CommandsProxy","HandledCommands","built","Date","now","clearTimeout","queueMicrotask","queued","EmitHost","setSink","sink","event","emitHosts","getEmitHost","emit","useStatewireEmit","_temp"],"sources":["../../src/host/host.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { applyOps, sanitizeValue } from \"../wire/ops\";\nimport type { StatewirePath } from \"../wire/ops\";\nimport { StatewireReject } from \"./engine\";\nimport { createStateDraft } from \"./draft\";\nimport { createMethodProxy } from \"../util/methodProxy\";\nimport type { ServerOp, StateDraft } from \"./draft\";\nimport { StatewireSendError } from \"../types\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireHost } from \"../host\";\n\nconst isDev = () =>\n  typeof process === \"undefined\" || process.env[\"NODE_ENV\"] !== \"production\";\n\n// ─── state ──────────────────────────────────────────────\n\nconst stateHosts = new WeakMap<object, StatewireHost.StateHost>();\n\n/** Host-side accessor for a `useStatewireState` state object's source (`snapshot()` reads the committed state). */\nexport const getStateHost = (\n  state: object,\n): StatewireHost.StateHost | undefined => stateHosts.get(state);\n\ntype StateCell = {\n  current: unknown;\n  draft: StateDraft<object> | null;\n  changed: StatewirePath[];\n  onOp: ((op: ServerOp) => void) | null;\n  onChange: (() => void) | null;\n  ctl: StatewireHost.StateCtl;\n  host: StatewireHost.StateHost;\n  bump: () => void;\n};\n\nexport const useStatewireState = <TState>(\n  init: () => TState,\n): readonly [TState, StatewireHost.StateCtl<TState>] => {\n  const [, setVersion] = useState(0);\n  const [cell] = useState((): StateCell => {\n    const commit = () => {\n      if (c.draft) c.current = c.draft.flush();\n      return c.current;\n    };\n    const c: StateCell = {\n      current: sanitizeValue(init()),\n      draft: null,\n      changed: [[]],\n      onOp: null,\n      onChange: null,\n      bump: () => setVersion((v) => v + 1),\n      ctl: {\n        apply: (ops) => {\n          const result = applyOps(commit(), ops);\n          if (result.events.length > 0) {\n            throw new Error(\n              \"statewire: event ops do not apply to state — route them to emit\",\n            );\n          }\n          c.current = result.state;\n          c.draft?.invalidate();\n          c.changed.push(...result.changedPaths);\n          if (c.onOp) for (const op of ops) c.onOp(op as ServerOp);\n          c.bump();\n          c.onChange?.();\n        },\n        snapshot: commit,\n      },\n      host: {\n        snapshot: commit,\n        setOnOp: (listener) => {\n          c.onOp = listener;\n        },\n        setOnChange: (listener) => {\n          c.onChange = listener;\n        },\n        takeChanged: () => {\n          const changed = c.changed;\n          c.changed = [];\n          return changed;\n        },\n      },\n    };\n    return c;\n  });\n\n  let value = cell.ctl.snapshot();\n  if (typeof value === \"object\" && value !== null) {\n    cell.draft ??= createStateDraft<object>({\n      snapshot: () => cell.current,\n      record: (op, changedPath) => {\n        cell.changed.push(changedPath);\n        cell.onOp?.(op);\n        cell.bump();\n        cell.onChange?.();\n      },\n    });\n    stateHosts.set(cell.draft.proxy, cell.host);\n    value = cell.draft.proxy;\n  }\n  return [value as TState, cell.ctl as StatewireHost.StateCtl<TState>] as const;\n};\n\n// ─── commands ───────────────────────────────────────────\n\ntype Settled =\n  | { type: \"resolved\"; value: unknown }\n  | { type: \"rejected\"; error: unknown };\n\nexport type CommandsInvocation = {\n  readonly method: string;\n  readonly params: readonly unknown[];\n  readonly ts: number;\n  readonly seq: number;\n  readonly clientId?: string;\n};\n\nexport type CommandsOutcome =\n  | { type: \"accepted\"; payload?: unknown }\n  | { type: \"rejected\"; error: unknown };\n\nexport type CommandsListener = {\n  onStart: (inv: CommandsInvocation) => void;\n  onPosted?: (inv: CommandsInvocation) => void;\n  onAck: (inv: CommandsInvocation) => void;\n  /** Canonical state now covers the invocation's effect — drop any overlay. */\n  onCovered?: (inv: CommandsInvocation) => void;\n  onSettle: (inv: CommandsInvocation, outcome: CommandsOutcome) => void;\n};\n\nexport type CommandsSubmission = {\n  method: string;\n  params: readonly unknown[];\n  clientId?: string;\n  caller?: StatewireHost.Caller;\n  onAck?: () => void;\n  onSettle?: (outcome: CommandsOutcome) => void;\n};\n\nexport type CommandsHost = {\n  setListener: (listener: CommandsListener | null) => void;\n  submit?: (call: CommandsSubmission) => Promise<unknown>;\n};\n\nconst commandsHosts = new WeakMap<object, CommandsHost>();\n\nexport const getCommandsHost = (commands: object): CommandsHost | undefined =>\n  commandsHosts.get(commands);\n\nexport const bindCommandsHost = (commands: object, host: CommandsHost) => {\n  commandsHosts.set(commands, host);\n};\n\ntype QueuedCall = {\n  method: string;\n  params: readonly unknown[];\n  ts: number;\n  resolve: (value: unknown) => void;\n  reject: (error: unknown) => void;\n  origin?: CommandsSubmission;\n};\n\ntype ActiveInvocation = CommandsInvocation & {\n  acked: boolean;\n  origin?: CommandsSubmission;\n};\n\ntype CommandsCell = {\n  handlers: Record<string, (...args: never[]) => unknown> | null;\n  queue: QueuedCall[];\n  running: boolean;\n  listener: CommandsListener | null;\n  seq: number;\n  unmounted: boolean;\n  stallTimer: ReturnType<typeof setTimeout> | null;\n};\n\nconst STALL_WARN_MS = 5000;\n\n// In-process dispatch has no wire client: never any ambient context, trivially attached.\nconst LOCAL_CALLER: StatewireHost.Caller = Object.freeze({\n  get clientId(): string {\n    throw new Error(\"statewire: in-process dispatch has no client id\");\n  },\n  context: null,\n  isConnected: true,\n});\n\nconst toSendError = (error: unknown): StatewireSendError =>\n  error instanceof StatewireSendError\n    ? error\n    : new StatewireSendError({\n        fate: \"rejected\",\n        cause: \"server\",\n        message: error instanceof Error ? error.message : String(error),\n        ...(error instanceof StatewireReject &&\n          error.payload !== undefined && { payload: error.payload }),\n      });\n\nconst ackInvocation = (cell: CommandsCell, inv: ActiveInvocation) => {\n  if (inv.acked) return;\n  inv.acked = true;\n  cell.listener?.onAck(inv);\n  inv.origin?.onAck?.();\n};\n\nconst settleInvocation = (\n  cell: CommandsCell,\n  inv: ActiveInvocation,\n  call: QueuedCall,\n  settled: Settled,\n) => {\n  ackInvocation(cell, inv);\n  if (settled.type === \"resolved\") {\n    const outcome: CommandsOutcome =\n      settled.value === undefined\n        ? { type: \"accepted\" }\n        : { type: \"accepted\", payload: sanitizeValue(settled.value) };\n    cell.listener?.onSettle(inv, outcome);\n    inv.origin?.onSettle?.(outcome);\n    call.resolve(outcome.payload);\n  } else {\n    const error = toSendError(settled.error);\n    const outcome: CommandsOutcome = { type: \"rejected\", error };\n    cell.listener?.onSettle(inv, outcome);\n    inv.origin?.onSettle?.(outcome);\n    call.reject(error);\n  }\n};\n\nconst isThenable = (value: unknown): value is PromiseLike<unknown> =>\n  typeof value === \"object\" &&\n  value !== null &&\n  typeof (value as { then?: unknown }).then === \"function\";\n\nconst dispatch = (cell: CommandsCell, call: QueuedCall) => {\n  const handler = cell.handlers![call.method];\n  if (handler === undefined) {\n    const error = new StatewireSendError({\n      fate: \"unknown-command\",\n      cause: \"server\",\n    });\n    call.origin?.onSettle?.({ type: \"rejected\", error });\n    call.reject(error);\n    return;\n  }\n  const inv: ActiveInvocation = {\n    method: call.method,\n    params: call.params,\n    ts: call.ts,\n    seq: ++cell.seq,\n    acked: false,\n    ...(call.origin !== undefined && { origin: call.origin }),\n    ...(call.origin?.clientId !== undefined && {\n      clientId: call.origin.clientId,\n    }),\n  };\n  cell.listener?.onStart(inv);\n  cell.listener?.onPosted?.(inv);\n  cell.listener?.onCovered?.(inv);\n  const ctx: StatewireHost.Ctx = {\n    caller: call.origin?.caller ?? LOCAL_CALLER,\n    ack: () => ackInvocation(cell, inv),\n  };\n  try {\n    const value = (\n      handler as (\n        this: StatewireHost.Ctx,\n        ...args: readonly unknown[]\n      ) => unknown\n    ).call(ctx, ...call.params);\n    if (isThenable(value)) {\n      value.then(\n        (resolved) =>\n          settleInvocation(cell, inv, call, {\n            type: \"resolved\",\n            value: resolved,\n          }),\n        (error: unknown) =>\n          settleInvocation(cell, inv, call, { type: \"rejected\", error }),\n      );\n    } else {\n      settleInvocation(cell, inv, call, { type: \"resolved\", value });\n    }\n  } catch (error) {\n    settleInvocation(cell, inv, call, { type: \"rejected\", error });\n  }\n};\n\n// Prefix-only advancement: each handler runs synchronously to its first\n// await, then the pump moves on; settlement rides the returned promise.\nconst pump = (cell: CommandsCell) => {\n  if (cell.running || !cell.handlers) {\n    watchStall(cell);\n    return;\n  }\n  cell.running = true;\n  try {\n    while (cell.handlers) {\n      const call = cell.queue.shift();\n      if (!call) break;\n      dispatch(cell, call);\n    }\n  } finally {\n    cell.running = false;\n  }\n};\n\nconst watchStall = (cell: CommandsCell) => {\n  if (!isDev() || cell.stallTimer !== null || cell.queue.length === 0) return;\n  if (cell.handlers) return;\n  cell.stallTimer = setTimeout(() => {\n    cell.stallTimer = null;\n    if (cell.handlers === null && cell.queue.length > 0 && !cell.unmounted) {\n      console.warn(\n        `statewire: ${cell.queue.length} buffered command(s) waiting over ${STALL_WARN_MS}ms — did the host forget to arm useStatewireCommands?`,\n      );\n    }\n  }, STALL_WARN_MS);\n};\n\nexport const useStatewireCommands = <THandlers extends Statewire.Commands>(\n  commands:\n    | (THandlers & ThisType<StatewireHost.Ctx>)\n    | undefined\n    | null\n    | false,\n): Statewire.CommandsProxy<StatewireHost.HandledCommands<THandlers>> => {\n  const [built] = useState(() => {\n    const cell: CommandsCell = {\n      handlers: null,\n      queue: [],\n      running: false,\n      listener: null,\n      seq: 0,\n      unmounted: false,\n      stallTimer: null,\n    };\n    const proxy = createMethodProxy<\n      Statewire.CommandsProxy<StatewireHost.HandledCommands<THandlers>>\n    >(\n      (method, params) =>\n        new Promise((resolve, reject) => {\n          if (cell.unmounted) {\n            reject(new Error(\"statewire: commands called after unmount\"));\n            return;\n          }\n          cell.queue.push({\n            method,\n            params,\n            ts: Date.now(),\n            resolve,\n            reject,\n          });\n          pump(cell);\n        }),\n    );\n    commandsHosts.set(proxy, {\n      setListener: (listener) => {\n        cell.listener = listener;\n      },\n      submit: (origin) =>\n        new Promise((resolve, reject) => {\n          if (cell.unmounted) {\n            reject(new Error(\"statewire: commands called after unmount\"));\n            return;\n          }\n          cell.queue.push({\n            method: origin.method,\n            params: origin.params,\n            ts: Date.now(),\n            resolve,\n            reject,\n            origin,\n          });\n          pump(cell);\n        }),\n    });\n    return { cell, proxy };\n  });\n\n  useEffect(() => {\n    const { cell } = built;\n    cell.unmounted = false;\n    return () => {\n      cell.unmounted = true;\n      cell.handlers = null;\n      if (cell.stallTimer !== null) {\n        clearTimeout(cell.stallTimer);\n        cell.stallTimer = null;\n      }\n      queueMicrotask(() => {\n        if (!cell.unmounted) return;\n        const queued = cell.queue;\n        cell.queue = [];\n        for (const call of queued) {\n          call.reject(new Error(\"statewire: unmounted\"));\n        }\n      });\n    };\n  }, [built]);\n\n  useEffect(() => {\n    built.cell.handlers = commands || null;\n    pump(built.cell);\n  });\n\n  return built.proxy;\n};\n\n// ─── emit ───────────────────────────────────────────────\n\nexport type EmitHost = {\n  setSink: (sink: ((event: unknown) => void) | null) => void;\n};\n\nconst emitHosts = new WeakMap<object, EmitHost>();\n\nexport const getEmitHost = (emit: object | undefined): EmitHost | undefined =>\n  emit && emitHosts.get(emit);\n\nexport const useStatewireEmit = <TEvent>(): ((event: TEvent) => void) => {\n  const [built] = useState(() => {\n    const cell = { sink: null as ((event: unknown) => void) | null };\n    const emit = (event: TEvent) => {\n      if (!cell.sink) {\n        throw new Error(\"statewire: emit before a host bound the event sink\");\n      }\n      cell.sink(sanitizeValue(event));\n    };\n    emitHosts.set(emit, {\n      setSink: (sink) => {\n        cell.sink = sink;\n      },\n    });\n    return emit;\n  });\n  return built;\n};\n"],"mappings":"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"}
+{"version":3,"file":"host.js","names":["useEffect","useState","applyOps","sanitizeValue","StatewirePath","StatewireReject","createStateDraft","createMethodProxy","StateDraft","StatewireSendError","Statewire","StatewireHost","isDev","process","env","stateHosts","WeakMap","StateHost","getStateHost","state","get","StateCell","current","draft","changed","onOp","op","Op","onChange","ctl","StateCtl","host","bump","useStatewireState","init","TState","setVersion","cell","commit","c","flush","v","apply","ops","result","invalidate","push","changedPaths","snapshot","setOnOp","listener","setOnChange","takeChanged","value","record","changedPath","set","proxy","const","Settled","type","error","CommandsInvocation","method","params","ts","seq","clientId","CommandsOutcome","payload","CommandsListener","onStart","inv","onPosted","onApplied","onCovered","onSettle","outcome","CommandsSubmission","caller","Caller","CommandsHost","setListener","submit","call","Promise","methods","commandsHosts","getCommandsHost","commands","bindCommandsHost","QueuedCall","resolve","reject","origin","ActiveInvocation","applied","CommandsCell","handlers","Record","args","queue","running","unmounted","stallTimer","ReturnType","setTimeout","STALL_WARN_MS","LOCAL_CALLER","Object","freeze","Error","context","isConnected","toSendError","fate","cause","message","undefined","String","applyInvocation","settleInvocation","settled","isThenable","PromiseLike","then","dispatch","handler","code","ctx","Ctx","this","resolved","pump","watchStall","shift","length","console","warn","useStatewireCommands","Commands","THandlers","ThisType","CommandsProxy","HandledCommands","built","Date","now","keys","clearTimeout","queueMicrotask","queued","startsWith"],"sources":["../../src/host/host.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { applyOps, sanitizeValue } from \"../wire/ops\";\nimport type { StatewirePath } from \"../wire/ops\";\nimport { StatewireReject } from \"./engine\";\nimport { createStateDraft } from \"./draft\";\nimport { createMethodProxy } from \"../util/methodProxy\";\nimport type { StateDraft } from \"./draft\";\nimport { StatewireSendError } from \"../types\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireHost } from \"../host\";\n\nconst isDev = () =>\n  typeof process === \"undefined\" || process.env[\"NODE_ENV\"] !== \"production\";\n\n// ─── state ──────────────────────────────────────────────\n\nconst stateHosts = new WeakMap<object, StatewireHost.StateHost>();\n\n/** Host-side accessor for a `useStatewireState` state object's source (`snapshot()` reads the committed state). */\nexport const getStateHost = (\n  state: object,\n): StatewireHost.StateHost | undefined => stateHosts.get(state);\n\ntype StateCell = {\n  current: unknown;\n  draft: StateDraft<object> | null;\n  changed: StatewirePath[];\n  onOp: ((op: Statewire.Op) => void) | null;\n  onChange: (() => void) | null;\n  ctl: StatewireHost.StateCtl;\n  host: StatewireHost.StateHost;\n  bump: () => void;\n};\n\nexport const useStatewireState = <TState>(\n  init: () => TState,\n): readonly [TState, StatewireHost.StateCtl<TState>] => {\n  const [, setVersion] = useState(0);\n  const [cell] = useState((): StateCell => {\n    const commit = () => {\n      if (c.draft) c.current = c.draft.flush();\n      return c.current;\n    };\n    const c: StateCell = {\n      current: sanitizeValue(init()),\n      draft: null,\n      changed: [[]],\n      onOp: null,\n      onChange: null,\n      bump: () => setVersion((v) => v + 1),\n      ctl: {\n        apply: (ops) => {\n          const result = applyOps(commit(), ops);\n          c.current = result.state;\n          c.draft?.invalidate();\n          c.changed.push(...result.changedPaths);\n          if (c.onOp) for (const op of ops) c.onOp(op);\n          c.bump();\n          c.onChange?.();\n        },\n        snapshot: commit,\n      },\n      host: {\n        snapshot: commit,\n        setOnOp: (listener) => {\n          c.onOp = listener;\n        },\n        setOnChange: (listener) => {\n          c.onChange = listener;\n        },\n        takeChanged: () => {\n          const changed = c.changed;\n          c.changed = [];\n          return changed;\n        },\n      },\n    };\n    return c;\n  });\n\n  let value = cell.ctl.snapshot();\n  if (typeof value === \"object\" && value !== null) {\n    cell.draft ??= createStateDraft<object>({\n      snapshot: () => cell.current,\n      record: (op, changedPath) => {\n        cell.changed.push(changedPath);\n        cell.onOp?.(op);\n        cell.bump();\n        cell.onChange?.();\n      },\n    });\n    stateHosts.set(cell.draft.proxy, cell.host);\n    value = cell.draft.proxy;\n  }\n  return [value as TState, cell.ctl as StatewireHost.StateCtl<TState>] as const;\n};\n\n// ─── commands ───────────────────────────────────────────\n\ntype Settled =\n  | { type: \"resolved\"; value: unknown }\n  | { type: \"rejected\"; error: unknown };\n\nexport type CommandsInvocation = {\n  readonly method: string;\n  readonly params: readonly unknown[];\n  readonly ts: number;\n  readonly seq: number;\n  readonly clientId?: string;\n};\n\nexport type CommandsOutcome =\n  | { type: \"accepted\"; payload?: unknown }\n  | { type: \"rejected\"; error: unknown };\n\nexport type CommandsListener = {\n  onStart: (inv: CommandsInvocation) => void;\n  onPosted?: (inv: CommandsInvocation) => void;\n  onApplied: (inv: CommandsInvocation) => void;\n  /** Canonical state now covers the invocation's effect — drop any overlay. */\n  onCovered?: (inv: CommandsInvocation) => void;\n  onSettle: (inv: CommandsInvocation, outcome: CommandsOutcome) => void;\n};\n\nexport type CommandsSubmission = {\n  method: string;\n  params: readonly unknown[];\n  clientId?: string;\n  caller?: StatewireHost.Caller;\n  onApplied?: () => void;\n  onSettle?: (outcome: CommandsOutcome) => void;\n};\n\nexport type CommandsHost = {\n  setListener: (listener: CommandsListener | null) => void;\n  submit?: (call: CommandsSubmission) => Promise<unknown>;\n  /** Registered command names, read live. */\n  methods?: () => string[];\n};\n\nconst commandsHosts = new WeakMap<object, CommandsHost>();\n\nexport const getCommandsHost = (commands: object): CommandsHost | undefined =>\n  commandsHosts.get(commands);\n\nexport const bindCommandsHost = (commands: object, host: CommandsHost) => {\n  commandsHosts.set(commands, host);\n};\n\ntype QueuedCall = {\n  method: string;\n  params: readonly unknown[];\n  ts: number;\n  resolve: (value: unknown) => void;\n  reject: (error: unknown) => void;\n  origin?: CommandsSubmission;\n};\n\ntype ActiveInvocation = CommandsInvocation & {\n  applied: boolean;\n  origin?: CommandsSubmission;\n};\n\ntype CommandsCell = {\n  handlers: Record<string, (...args: never[]) => unknown> | null;\n  queue: QueuedCall[];\n  running: boolean;\n  listener: CommandsListener | null;\n  seq: number;\n  unmounted: boolean;\n  stallTimer: ReturnType<typeof setTimeout> | null;\n};\n\nconst STALL_WARN_MS = 5000;\n\n// In-process dispatch has no wire client: never any ambient context, trivially attached.\nconst LOCAL_CALLER: StatewireHost.Caller = Object.freeze({\n  get clientId(): string {\n    throw new Error(\"statewire: in-process dispatch has no client id\");\n  },\n  context: null,\n  isConnected: true,\n});\n\nconst toSendError = (error: unknown): StatewireSendError =>\n  error instanceof StatewireSendError\n    ? error\n    : error instanceof StatewireReject\n      ? new StatewireSendError({\n          fate: \"rejected\",\n          cause: \"server\",\n          message: error.message,\n          ...(error.payload !== undefined && { payload: error.payload }),\n        })\n      : new StatewireSendError({\n          fate: \"failed\",\n          cause: \"server\",\n          message: error instanceof Error ? error.message : String(error),\n        });\n\nconst applyInvocation = (cell: CommandsCell, inv: ActiveInvocation) => {\n  if (inv.applied) return;\n  inv.applied = true;\n  cell.listener?.onApplied(inv);\n  inv.origin?.onApplied?.();\n};\n\nconst settleInvocation = (\n  cell: CommandsCell,\n  inv: ActiveInvocation,\n  call: QueuedCall,\n  settled: Settled,\n) => {\n  applyInvocation(cell, inv);\n  if (settled.type === \"resolved\") {\n    const outcome: CommandsOutcome =\n      settled.value === undefined\n        ? { type: \"accepted\" }\n        : { type: \"accepted\", payload: sanitizeValue(settled.value) };\n    cell.listener?.onSettle(inv, outcome);\n    inv.origin?.onSettle?.(outcome);\n    call.resolve(outcome.payload);\n  } else {\n    const error = toSendError(settled.error);\n    const outcome: CommandsOutcome = { type: \"rejected\", error };\n    cell.listener?.onSettle(inv, outcome);\n    inv.origin?.onSettle?.(outcome);\n    call.reject(error);\n  }\n};\n\nconst isThenable = (value: unknown): value is PromiseLike<unknown> =>\n  typeof value === \"object\" &&\n  value !== null &&\n  typeof (value as { then?: unknown }).then === \"function\";\n\nconst dispatch = (cell: CommandsCell, call: QueuedCall) => {\n  const handler = cell.handlers![call.method];\n  if (handler === undefined) {\n    const error = new StatewireSendError({\n      fate: \"rejected\",\n      cause: \"server\",\n      code: \"unknown-command\",\n    });\n    call.origin?.onSettle?.({ type: \"rejected\", error });\n    call.reject(error);\n    return;\n  }\n  const inv: ActiveInvocation = {\n    method: call.method,\n    params: call.params,\n    ts: call.ts,\n    seq: ++cell.seq,\n    applied: false,\n    ...(call.origin !== undefined && { origin: call.origin }),\n    ...(call.origin?.clientId !== undefined && {\n      clientId: call.origin.clientId,\n    }),\n  };\n  cell.listener?.onStart(inv);\n  cell.listener?.onPosted?.(inv);\n  cell.listener?.onCovered?.(inv);\n  const ctx: StatewireHost.Ctx = {\n    caller: call.origin?.caller ?? LOCAL_CALLER,\n    applied: () => applyInvocation(cell, inv),\n  };\n  try {\n    const value = (\n      handler as (\n        this: StatewireHost.Ctx,\n        ...args: readonly unknown[]\n      ) => unknown\n    ).call(ctx, ...call.params);\n    if (isThenable(value)) {\n      value.then(\n        (resolved) =>\n          settleInvocation(cell, inv, call, {\n            type: \"resolved\",\n            value: resolved,\n          }),\n        (error: unknown) =>\n          settleInvocation(cell, inv, call, { type: \"rejected\", error }),\n      );\n    } else {\n      settleInvocation(cell, inv, call, { type: \"resolved\", value });\n    }\n  } catch (error) {\n    settleInvocation(cell, inv, call, { type: \"rejected\", error });\n  }\n};\n\n// Prefix-only advancement: each handler runs synchronously to its first\n// await, then the pump moves on; settlement rides the returned promise.\nconst pump = (cell: CommandsCell) => {\n  if (cell.running || !cell.handlers) {\n    watchStall(cell);\n    return;\n  }\n  cell.running = true;\n  try {\n    while (cell.handlers) {\n      const call = cell.queue.shift();\n      if (!call) break;\n      dispatch(cell, call);\n    }\n  } finally {\n    cell.running = false;\n  }\n};\n\nconst watchStall = (cell: CommandsCell) => {\n  if (!isDev() || cell.stallTimer !== null || cell.queue.length === 0) return;\n  if (cell.handlers) return;\n  cell.stallTimer = setTimeout(() => {\n    cell.stallTimer = null;\n    if (cell.handlers === null && cell.queue.length > 0 && !cell.unmounted) {\n      console.warn(\n        `statewire: ${cell.queue.length} buffered command(s) waiting over ${STALL_WARN_MS}ms — did the host forget to arm useStatewireCommands?`,\n      );\n    }\n  }, STALL_WARN_MS);\n};\n\nexport const useStatewireCommands = <THandlers extends Statewire.Commands>(\n  commands:\n    | (THandlers & ThisType<StatewireHost.Ctx>)\n    | undefined\n    | null\n    | false,\n): Statewire.CommandsProxy<StatewireHost.HandledCommands<THandlers>> => {\n  const [built] = useState(() => {\n    const cell: CommandsCell = {\n      handlers: null,\n      queue: [],\n      running: false,\n      listener: null,\n      seq: 0,\n      unmounted: false,\n      stallTimer: null,\n    };\n    const proxy = createMethodProxy<\n      Statewire.CommandsProxy<StatewireHost.HandledCommands<THandlers>>\n    >(\n      (method, params) =>\n        new Promise((resolve, reject) => {\n          if (cell.unmounted) {\n            reject(new Error(\"statewire: commands called after unmount\"));\n            return;\n          }\n          cell.queue.push({\n            method,\n            params,\n            ts: Date.now(),\n            resolve,\n            reject,\n          });\n          pump(cell);\n        }),\n    );\n    commandsHosts.set(proxy, {\n      setListener: (listener) => {\n        cell.listener = listener;\n      },\n      methods: () => (cell.handlers ? Object.keys(cell.handlers) : []),\n      submit: (origin) =>\n        new Promise((resolve, reject) => {\n          if (cell.unmounted) {\n            reject(new Error(\"statewire: commands called after unmount\"));\n            return;\n          }\n          cell.queue.push({\n            method: origin.method,\n            params: origin.params,\n            ts: Date.now(),\n            resolve,\n            reject,\n            origin,\n          });\n          pump(cell);\n        }),\n    });\n    return { cell, proxy };\n  });\n\n  useEffect(() => {\n    const { cell } = built;\n    cell.unmounted = false;\n    return () => {\n      cell.unmounted = true;\n      cell.handlers = null;\n      if (cell.stallTimer !== null) {\n        clearTimeout(cell.stallTimer);\n        cell.stallTimer = null;\n      }\n      queueMicrotask(() => {\n        if (!cell.unmounted) return;\n        const queued = cell.queue;\n        cell.queue = [];\n        for (const call of queued) {\n          call.reject(new Error(\"statewire: unmounted\"));\n        }\n      });\n    };\n  }, [built]);\n\n  useEffect(() => {\n    if (commands) {\n      for (const method of Object.keys(commands)) {\n        if (method.startsWith(\"statewire/\")) {\n          throw new Error(\n            `statewire: cannot register \"${method}\": the \"statewire/\" method namespace is reserved`,\n          );\n        }\n      }\n    }\n    built.cell.handlers = commands || null;\n    pump(built.cell);\n  });\n\n  return built.proxy;\n};\n"],"mappings":"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"}

package/dist/host/socket.d.ts

@@ -5,8 +5,9 @@ import { ResourceElement } from "@assistant-ui/tap";
 /**
  * Transport-agnostic WS binding over a statewire/host transport:
  * feed it sockets (anything with `send`/`close`) and raw text frames, and it
- * speaks the Statewire envelope protocol — snapshot-first attach with `syn`,
- * delta/ack/res envelopes, per-client-id supersede, and `fin` on finish.
+ * speaks the Statewire packet protocol — snapshot-first hello with `syn`,
+ * statement-lane client frames under one admission law, `{cmd}` answer
+ * arrays, per-client-id supersede, idle edges, and `fin` on finish.
  */
 declare const StatewireSocketHost: (transport: ResourceElement<Statewire>, options?: StatewireHostInternal.SocketHostOptions) => StatewireHostInternal.SocketHost;
 //#endregion

package/dist/host/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","names":[],"sources":["../../src/host/socket.ts"],"mappings":";;;;;;;;;;cAwlBa,sBACX,WAAW,gBAAgB,YAC3B,UAAU,sBAAsB,sBAC/B,sBAAsB"}
+{"version":3,"file":"socket.d.ts","names":[],"sources":["../../src/host/socket.ts"],"mappings":";;;;;;;;;;;cAqyBa,sBACX,WAAW,gBAAgB,YAC3B,UAAU,sBAAsB,sBAC/B,sBAAsB"}