statewire 0.20.0 → 0.22.0

package/dist/transports/sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.js","names":["StatewireDocument","flushTapSync","resource","ResourceElement","createSseParser","timing","settleFin","classify","handleEnvelope","resolveHeaders","useLink","validateRefusalSyn","AttemptOutcome","Conn","StatewireCmd","StatewireEnvelope","StatewireSyn","Statewire","StatewireClient","StatewireHost","useStatewireRemote","negotiationHeaders","parseNegotiation","StatewireFrame","ctx","protocol","Encoded","cmd","method","params","meta","seq","StatewireRemoteProps","beforeAttach","Promise","clientId","takeAttachLanes","onHello","args","ops","syn","onOps","cmds","onCmds","onRefusal","onIdle","level","onDetach","onFinish","Fin","StatewireSubmitResult","type","ConnectionState","RemoteLink","storageFailed","error","Error","connection","Connection","parked","send","frame","LEASE_HEADER","baseUrl","options","HttpOptions","url","replace","withExtra","headers","Headers","extra","Record","merged","name","value","Object","entries","set","timedFetch","input","init","RequestInit","signal","AbortSignal","timeout","Response","fetch","globalThis","consume","c","reader","ReadableStreamDefaultReader","Uint8Array","heartbeat","AbortController","dead","decoder","TextDecoder","parse","timer","setTimeout","abort","heartbeatTimeoutMs","result","ReadableStreamReadResult","read","clearTimeout","done","data","decode","stream","env","JSON","attemptStream","persistence","aborted","lease","authStale","has","negotiation","lanes","body","undefined","stringify","headerTimer","res","accept","cache","any","ok","clone","json","catch","fin","httpFin","get","getReader","cancel","addEventListener","once","removeEventListener","postFrame","lifetime","retryAfterMs","header","trim","test","retry","Number","isSafeInteger","reason","status","message","code","refusalSyn","sendFrame","headerRetry","useSseLink","attemptOnce","SyntaxError","startsWith","useStatewireHttp","StatewireHttp","Commands","TState","TCommands"],"sources":["../../src/transports/sse.ts"],"sourcesContent":["import type { StatewireDocument } from \"../document\";\nimport { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { createSseParser } from \"./sse-parser\";\nimport { timing } from \"../client/timing\";\nimport {\n  settleFin,\n  classify,\n  handleEnvelope,\n  resolveHeaders,\n  useLink,\n  validateRefusalSyn,\n} from \"../client/connection\";\nimport type {\n  AttemptOutcome,\n  Conn,\n  StatewireCmd,\n  StatewireEnvelope,\n  StatewireSyn,\n} from \"../client/connection\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { StatewireHost } from \"../host\";\nimport { useStatewireRemote } from \"./remote\";\nimport { negotiationHeaders, parseNegotiation } from \"../wire/protocol\";\n\n/** A client frame's lanes: stamped statements, strictly consecutive per lane. */\nexport type StatewireFrame = {\n  ctx?: ({ protocol: string } & StatewireDocument.Encoded)[];\n  cmd?: {\n    protocol: string;\n    method: string;\n    params: unknown[];\n    meta?: unknown;\n    seq: number;\n  }[];\n};\n\nexport type StatewireRemoteProps = {\n  beforeAttach?: () => void | Promise<void>;\n  clientId: string;\n  /** Lanes to ride the attach frame: ephemeral-lane statements, plus durable cmds on no-lease supersession; records the included entries. */\n  takeAttachLanes: () => StatewireFrame | null;\n  onHello: (args: { ops: unknown[]; syn: StatewireSyn }) => void;\n  onOps: (args: { ops: unknown[]; cmds: StatewireCmd[] }) => void;\n  onCmds: (cmds: StatewireCmd[]) => void;\n  onRefusal: (syn: StatewireSyn) => void;\n  onIdle: (level: boolean) => void;\n  onDetach: () => void;\n  onFinish: (args: StatewireHost.Fin) => void;\n};\n\nexport type StatewireSubmitResult =\n  | { type: \"ok\" }\n  | { type: \"refusal\"; syn: StatewireSyn }\n  | { type: \"stale-lease\" }\n  | { type: \"no-lease\" };\n\nexport type ConnectionState = StatewireClient.ConnectionState;\n\n/** The live wire a remote session drives: connection status plus frame submission. */\nexport type RemoteLink = {\n  storageFailed: (error: Error) => void;\n  connection: StatewireClient.Connection;\n  /** A deferred first attach still waiting; `reconnect()` releases it. */\n  parked: boolean;\n  send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;\n};\n\nconst LEASE_HEADER = \"Statewire-Lease\";\n\nconst baseUrl = (options: StatewireClient.HttpOptions) =>\n  options.url.replace(/\\/$/, \"\");\n\nconst withExtra = (headers: Headers, extra: Record<string, string>) => {\n  const merged = new Headers(headers);\n  for (const [name, value] of Object.entries(extra)) merged.set(name, value);\n  return merged;\n};\n\nconst timedFetch = async (\n  options: StatewireClient.HttpOptions,\n  input: string,\n  init: RequestInit & { signal: AbortSignal },\n  timeout: AbortSignal,\n): Promise<Response> => {\n  try {\n    return await (options.fetch ?? globalThis.fetch)(input, init);\n  } catch {\n    throw classify(timeout);\n  }\n};\n\nconst consume = async (\n  c: Conn,\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  heartbeat: AbortController,\n  dead: () => boolean,\n): Promise<AttemptOutcome> => {\n  const decoder = new TextDecoder();\n  const parse = createSseParser();\n  for (;;) {\n    const timer = setTimeout(\n      () => heartbeat.abort(),\n      timing.heartbeatTimeoutMs,\n    );\n    let result: ReadableStreamReadResult<Uint8Array>;\n    try {\n      result = await reader.read();\n    } catch {\n      throw classify(heartbeat.signal);\n    } finally {\n      clearTimeout(timer);\n    }\n    if (result.done) return \"ended\";\n    for (const data of parse(decoder.decode(result.value, { stream: true }))) {\n      if (dead()) return \"ended\";\n      const env = JSON.parse(data) as StatewireEnvelope;\n      const done = flushTapSync(() => handleEnvelope(c, env));\n      if (done) return done;\n    }\n  }\n};\n\nconst attemptStream = async (\n  c: Conn,\n  options: StatewireClient.HttpOptions,\n  abort: AbortController,\n): Promise<AttemptOutcome> => {\n  const persistence = c.ctx.beforeAttach?.();\n  if (persistence) await persistence;\n  if (abort.signal.aborted) return \"ended\";\n  c.lease = null;\n  const headers = await resolveHeaders(options.headers, c.authStale);\n  for (const [name, value] of Object.entries(negotiationHeaders(options))) {\n    if (!headers.has(name)) headers.set(name, value);\n  }\n  c.negotiation = parseNegotiation(headers);\n  c.authStale = false;\n  const lanes = flushTapSync(() => c.ctx.takeAttachLanes());\n  const body = lanes === null ? undefined : JSON.stringify(lanes);\n  const heartbeat = new AbortController();\n  const headerTimer = setTimeout(\n    () => heartbeat.abort(),\n    timing.heartbeatTimeoutMs,\n  );\n  let res: Response;\n  try {\n    res = await timedFetch(\n      options,\n      `${baseUrl(options)}/stream`,\n      {\n        method: body === undefined ? \"GET\" : \"POST\",\n        headers: withExtra(headers, {\n          \"content-type\": \"application/json\",\n          \"Statewire-Client-Id\": c.ctx.clientId,\n          accept: \"text/event-stream\",\n        }),\n        ...(body === undefined ? {} : { body }),\n        cache: \"no-store\",\n        signal: AbortSignal.any([abort.signal, heartbeat.signal]),\n      },\n      heartbeat.signal,\n    );\n  } finally {\n    clearTimeout(headerTimer);\n  }\n  if (!res.ok) {\n    const body = await res\n      .clone()\n      .json()\n      .catch(() => null);\n    return (\n      flushTapSync(() =>\n        body?.fin === undefined\n          ? settleFin(c, httpFin(res))\n          : handleEnvelope(c, body),\n      ) ?? \"stop\"\n    );\n  }\n  if (!res.body)\n    throw new Error(\"statewire: protocol error: stream response has no body\");\n  c.lease = res.headers.get(LEASE_HEADER);\n  const reader = res.body.getReader();\n  const cancel = () => {\n    void reader.cancel().catch(() => {});\n  };\n  abort.signal.addEventListener(\"abort\", cancel, { once: true });\n  try {\n    return await consume(c, reader, heartbeat, () => abort.signal.aborted);\n  } finally {\n    abort.signal.removeEventListener(\"abort\", cancel);\n    reader.cancel().catch(() => {});\n  }\n};\n\nconst postFrame = async (\n  c: Conn,\n  options: StatewireClient.HttpOptions,\n  lease: string,\n  frame: StatewireFrame,\n  timeout: AbortSignal,\n): Promise<Response> =>\n  timedFetch(\n    options,\n    `${baseUrl(options)}/frames`,\n    {\n      method: \"POST\",\n      headers: withExtra(new Headers(), {\n        \"content-type\": \"application/json\",\n        [LEASE_HEADER]: lease,\n      }),\n      body: JSON.stringify(frame),\n      signal: AbortSignal.any([\n        c.lifetime?.signal ?? AbortSignal.abort(),\n        timeout,\n      ]),\n    },\n    timeout,\n  );\n\n// Delta-seconds only; anything else reads as absent.\nconst retryAfterMs = (res: Response): number | null => {\n  const header = res.headers.get(\"retry-after\")?.trim();\n  if (header === undefined || !/^\\d+$/.test(header)) return null;\n  const retry = Number(header) * 1000;\n  return Number.isSafeInteger(retry) ? retry : null;\n};\n\nconst httpFin = (res: Response): StatewireHost.Fin => ({\n  reason:\n    res.status === 401\n      ? \"unauthorized\"\n      : res.status === 403\n        ? \"forbidden\"\n        : res.status === 429 || res.status === 503\n          ? \"reconnect\"\n          : res.status >= 400 && res.status < 500\n            ? \"protocol-error\"\n            : \"error\",\n  status: res.status,\n  message: `HTTP ${res.status}`,\n  ...(res.status === 429 || res.status === 503 ? { code: \"overloaded\" } : {}),\n  ...(retryAfterMs(res) !== null ? { retry: retryAfterMs(res)! } : {}),\n});\n\nconst refusalSyn = async (res: Response): Promise<StatewireSyn> => {\n  const body = (await res.json().catch(() => null)) as {\n    syn?: StatewireSyn;\n  } | null;\n  const syn = body?.syn;\n  if (typeof syn !== \"object\" || syn === null) {\n    throw new Error(`HTTP ${res.status}`);\n  }\n  return validateRefusalSyn(syn);\n};\n\nconst sendFrame = async (\n  c: Conn,\n  options: StatewireClient.HttpOptions,\n  frame: StatewireFrame,\n): Promise<StatewireSubmitResult> => {\n  const lease = c.lease;\n  if (lease === null) return { type: \"no-lease\" };\n  const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);\n  const res = await postFrame(c, options, lease, frame, timeout);\n  if (res.ok) return { type: \"ok\" };\n  if (res.status === 429 || res.status === 409) {\n    // The syn body retry wins; Retry-After covers 429s minted below the host.\n    const headerRetry = res.status === 429 ? retryAfterMs(res) : null;\n    const syn: StatewireSyn = await refusalSyn(res).catch((error: unknown) => {\n      if (headerRetry === null) throw error;\n      return { retry: headerRetry };\n    });\n    if (syn.retry === undefined && headerRetry !== null)\n      syn.retry = headerRetry;\n    return { type: \"refusal\", syn };\n  }\n  if (res.status === 423) return { type: \"stale-lease\" };\n  flushTapSync(() => settleFin(c, httpFin(res)));\n  c.abort?.abort();\n  throw new Error(`HTTP ${res.status}`);\n};\n\nconst useSseLink = (\n  options: StatewireClient.HttpOptions,\n  ctx: StatewireRemoteProps,\n): RemoteLink =>\n  useLink({\n    ...options,\n    ctx,\n    attemptOnce: (c, abort) => attemptStream(c, options, abort),\n    send: async (c, frame) => {\n      try {\n        return await sendFrame(c, options, frame);\n      } catch (error) {\n        if (\n          error instanceof SyntaxError ||\n          (error instanceof Error &&\n            error.message.startsWith(\"statewire: protocol error:\"))\n        ) {\n          flushTapSync(() =>\n            settleFin(c, { reason: \"protocol-error\", message: error.message }),\n          );\n          c.abort?.abort();\n        }\n        throw error;\n      }\n    },\n  });\n\nconst useStatewireHttp = (\n  options: StatewireClient.HttpOptions,\n): Statewire<any, any> => useStatewireRemote(options, useSseLink);\n\nexport const StatewireHttp = resource(useStatewireHttp) as <\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.HttpOptions,\n) => ResourceElement<Statewire<TState | undefined, TCommands>>;\n"],"mappings":"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"}
+{"version":3,"file":"sse.js","names":["StatewireDocument","flushTapSync","resource","ResourceElement","createSseParser","timing","settleFin","classify","handleEnvelope","resolveHeaders","useLink","validateRefusalSyn","AttemptOutcome","Conn","StatewireCmd","StatewireEnvelope","StatewireSyn","Statewire","StatewireClient","StatewireHost","useStatewireRemote","negotiationHeaders","parseNegotiation","StatewireFrame","ctx","protocol","Encoded","cmd","method","params","meta","seq","StatewireRemoteProps","beforeAttach","Promise","clientId","takeAttachLanes","onHello","args","ops","syn","onOps","cmds","onCmds","onRefusal","onIdle","level","onDetach","onFinish","Fin","StatewireSubmitResult","type","ConnectionState","RemoteLink","storageFailed","error","Error","protocolFailed","connection","Connection","parked","send","frame","LEASE_HEADER","warnedNoLease","warnNoLease","console","warn","baseUrl","options","HttpOptions","url","replace","withExtra","headers","Headers","extra","Record","merged","name","value","Object","entries","set","timedFetch","input","init","RequestInit","signal","AbortSignal","timeout","Response","fetch","globalThis","consume","c","reader","ReadableStreamDefaultReader","Uint8Array","heartbeat","AbortController","dead","decoder","TextDecoder","parse","timer","setTimeout","abort","heartbeatTimeoutMs","result","ReadableStreamReadResult","read","clearTimeout","done","data","decode","stream","env","JSON","attemptStream","persistence","aborted","lease","authStale","has","negotiation","lanes","body","undefined","stringify","headerTimer","res","accept","cache","any","ok","clone","json","catch","fin","httpFin","get","getReader","cancel","addEventListener","once","removeEventListener","postFrame","lifetime","retryAfterMs","header","trim","test","retry","Number","isSafeInteger","reason","status","message","code","refusalSyn","sendFrame","headerRetry","useSseLink","attemptOnce","SyntaxError","startsWith","useStatewireHttp","StatewireHttp","Commands","TState","TCommands"],"sources":["../../src/transports/sse.ts"],"sourcesContent":["import type { StatewireDocument } from \"../document\";\nimport { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { createSseParser } from \"./sse-parser\";\nimport { timing } from \"../client/timing\";\nimport {\n  settleFin,\n  classify,\n  handleEnvelope,\n  resolveHeaders,\n  useLink,\n  validateRefusalSyn,\n} from \"../client/connection\";\nimport type {\n  AttemptOutcome,\n  Conn,\n  StatewireCmd,\n  StatewireEnvelope,\n  StatewireSyn,\n} from \"../client/connection\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { StatewireHost } from \"../host\";\nimport { useStatewireRemote } from \"./remote\";\nimport { negotiationHeaders, parseNegotiation } from \"../wire/protocol\";\n\n/** A client frame's lanes: stamped statements, strictly consecutive per lane. */\nexport type StatewireFrame = {\n  ctx?: ({ protocol: string } & StatewireDocument.Encoded)[];\n  cmd?: {\n    protocol: string;\n    method: string;\n    params: unknown[];\n    meta?: unknown;\n    seq: number;\n  }[];\n};\n\nexport type StatewireRemoteProps = {\n  beforeAttach?: () => void | Promise<void>;\n  clientId: string;\n  /** Lanes to ride the attach frame: ephemeral-lane statements, plus durable cmds on no-lease supersession; records the included entries. */\n  takeAttachLanes: () => StatewireFrame | null;\n  onHello: (args: { ops: unknown[]; syn: StatewireSyn }) => void;\n  onOps: (args: { ops: unknown[]; cmds: StatewireCmd[] }) => void;\n  onCmds: (cmds: StatewireCmd[]) => void;\n  onRefusal: (syn: StatewireSyn) => void;\n  onIdle: (level: boolean) => void;\n  onDetach: () => void;\n  onFinish: (args: StatewireHost.Fin) => void;\n};\n\nexport type StatewireSubmitResult =\n  | { type: \"ok\" }\n  | { type: \"refusal\"; syn: StatewireSyn }\n  | { type: \"stale-lease\" }\n  | { type: \"no-lease\" };\n\nexport type ConnectionState = StatewireClient.ConnectionState;\n\n/** The live wire a remote session drives: connection status plus frame submission. */\nexport type RemoteLink = {\n  storageFailed: (error: Error) => void;\n  protocolFailed: (error: Error) => void;\n  connection: StatewireClient.Connection;\n  /** A deferred first attach still waiting; `reconnect()` releases it. */\n  parked: boolean;\n  send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;\n};\n\nconst LEASE_HEADER = \"Statewire-Lease\";\n\nlet warnedNoLease = false;\n\nconst warnNoLease = () => {\n  if (warnedNoLease) return;\n  warnedNoLease = true;\n  console.warn(\n    \"statewire: SSE attach returned no readable Statewire-Lease header; commands will re-attach the stream. Cross-origin hosts must expose it (Access-Control-Expose-Headers: Statewire-Lease).\",\n  );\n};\n\nconst baseUrl = (options: StatewireClient.HttpOptions) =>\n  options.url.replace(/\\/$/, \"\");\n\nconst withExtra = (headers: Headers, extra: Record<string, string>) => {\n  const merged = new Headers(headers);\n  for (const [name, value] of Object.entries(extra)) merged.set(name, value);\n  return merged;\n};\n\nconst timedFetch = async (\n  options: StatewireClient.HttpOptions,\n  input: string,\n  init: RequestInit & { signal: AbortSignal },\n  timeout: AbortSignal,\n): Promise<Response> => {\n  try {\n    return await (options.fetch ?? globalThis.fetch)(input, init);\n  } catch {\n    throw classify(timeout);\n  }\n};\n\nconst consume = async (\n  c: Conn,\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  heartbeat: AbortController,\n  dead: () => boolean,\n): Promise<AttemptOutcome> => {\n  const decoder = new TextDecoder();\n  const parse = createSseParser();\n  for (;;) {\n    const timer = setTimeout(\n      () => heartbeat.abort(),\n      timing.heartbeatTimeoutMs,\n    );\n    let result: ReadableStreamReadResult<Uint8Array>;\n    try {\n      result = await reader.read();\n    } catch {\n      throw classify(heartbeat.signal);\n    } finally {\n      clearTimeout(timer);\n    }\n    if (result.done) return \"ended\";\n    for (const data of parse(decoder.decode(result.value, { stream: true }))) {\n      if (dead()) return \"ended\";\n      const env = JSON.parse(data) as StatewireEnvelope;\n      const done = flushTapSync(() => handleEnvelope(c, env));\n      if (done) return done;\n    }\n  }\n};\n\nconst attemptStream = async (\n  c: Conn,\n  options: StatewireClient.HttpOptions,\n  abort: AbortController,\n): Promise<AttemptOutcome> => {\n  const persistence = c.ctx.beforeAttach?.();\n  if (persistence) await persistence;\n  if (abort.signal.aborted) return \"ended\";\n  c.lease = null;\n  const headers = await resolveHeaders(options.headers, c.authStale);\n  for (const [name, value] of Object.entries(negotiationHeaders(options))) {\n    if (!headers.has(name)) headers.set(name, value);\n  }\n  c.negotiation = parseNegotiation(headers);\n  c.authStale = false;\n  const lanes = flushTapSync(() => c.ctx.takeAttachLanes());\n  const body = lanes === null ? undefined : JSON.stringify(lanes);\n  const heartbeat = new AbortController();\n  const headerTimer = setTimeout(\n    () => heartbeat.abort(),\n    timing.heartbeatTimeoutMs,\n  );\n  let res: Response;\n  try {\n    res = await timedFetch(\n      options,\n      `${baseUrl(options)}/stream`,\n      {\n        method: body === undefined ? \"GET\" : \"POST\",\n        headers: withExtra(headers, {\n          \"content-type\": \"application/json\",\n          \"Statewire-Client-Id\": c.ctx.clientId,\n          accept: \"text/event-stream\",\n        }),\n        ...(body === undefined ? {} : { body }),\n        cache: \"no-store\",\n        signal: AbortSignal.any([abort.signal, heartbeat.signal]),\n      },\n      heartbeat.signal,\n    );\n  } finally {\n    clearTimeout(headerTimer);\n  }\n  if (!res.ok) {\n    const body = await res\n      .clone()\n      .json()\n      .catch(() => null);\n    return (\n      flushTapSync(() =>\n        body?.fin === undefined\n          ? settleFin(c, httpFin(res))\n          : handleEnvelope(c, body),\n      ) ?? \"stop\"\n    );\n  }\n  if (!res.body)\n    throw new Error(\"statewire: protocol error: stream response has no body\");\n  c.lease = res.headers.get(LEASE_HEADER);\n  if (c.lease === null) warnNoLease();\n  const reader = res.body.getReader();\n  const cancel = () => {\n    void reader.cancel().catch(() => {});\n  };\n  abort.signal.addEventListener(\"abort\", cancel, { once: true });\n  try {\n    return await consume(c, reader, heartbeat, () => abort.signal.aborted);\n  } finally {\n    abort.signal.removeEventListener(\"abort\", cancel);\n    reader.cancel().catch(() => {});\n  }\n};\n\nconst postFrame = async (\n  c: Conn,\n  options: StatewireClient.HttpOptions,\n  lease: string,\n  frame: StatewireFrame,\n  timeout: AbortSignal,\n): Promise<Response> =>\n  timedFetch(\n    options,\n    `${baseUrl(options)}/frames`,\n    {\n      method: \"POST\",\n      headers: withExtra(new Headers(), {\n        \"content-type\": \"application/json\",\n        [LEASE_HEADER]: lease,\n      }),\n      body: JSON.stringify(frame),\n      signal: AbortSignal.any([\n        c.lifetime?.signal ?? AbortSignal.abort(),\n        timeout,\n      ]),\n    },\n    timeout,\n  );\n\n// Delta-seconds only; anything else reads as absent.\nconst retryAfterMs = (res: Response): number | null => {\n  const header = res.headers.get(\"retry-after\")?.trim();\n  if (header === undefined || !/^\\d+$/.test(header)) return null;\n  const retry = Number(header) * 1000;\n  return Number.isSafeInteger(retry) ? retry : null;\n};\n\nconst httpFin = (res: Response): StatewireHost.Fin => ({\n  reason:\n    res.status === 401\n      ? \"unauthorized\"\n      : res.status === 403\n        ? \"forbidden\"\n        : res.status === 429 || res.status === 503\n          ? \"reconnect\"\n          : res.status >= 400 && res.status < 500\n            ? \"protocol-error\"\n            : \"error\",\n  status: res.status,\n  message: `HTTP ${res.status}`,\n  ...(res.status === 429 || res.status === 503 ? { code: \"overloaded\" } : {}),\n  ...(retryAfterMs(res) !== null ? { retry: retryAfterMs(res)! } : {}),\n});\n\nconst refusalSyn = async (res: Response): Promise<StatewireSyn> => {\n  const body = (await res.json().catch(() => null)) as {\n    syn?: StatewireSyn;\n  } | null;\n  const syn = body?.syn;\n  if (typeof syn !== \"object\" || syn === null) {\n    throw new Error(`HTTP ${res.status}`);\n  }\n  return validateRefusalSyn(syn);\n};\n\nconst sendFrame = async (\n  c: Conn,\n  options: StatewireClient.HttpOptions,\n  frame: StatewireFrame,\n): Promise<StatewireSubmitResult> => {\n  const lease = c.lease;\n  if (lease === null) return { type: \"no-lease\" };\n  const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);\n  const res = await postFrame(c, options, lease, frame, timeout);\n  if (res.ok) return { type: \"ok\" };\n  if (res.status === 429 || res.status === 409) {\n    // The syn body retry wins; Retry-After covers 429s minted below the host.\n    const headerRetry = res.status === 429 ? retryAfterMs(res) : null;\n    const syn: StatewireSyn = await refusalSyn(res).catch((error: unknown) => {\n      if (headerRetry === null) throw error;\n      return { retry: headerRetry };\n    });\n    if (syn.retry === undefined && headerRetry !== null)\n      syn.retry = headerRetry;\n    return { type: \"refusal\", syn };\n  }\n  if (res.status === 423) return { type: \"stale-lease\" };\n  flushTapSync(() => settleFin(c, httpFin(res)));\n  c.abort?.abort();\n  throw new Error(`HTTP ${res.status}`);\n};\n\nconst useSseLink = (\n  options: StatewireClient.HttpOptions,\n  ctx: StatewireRemoteProps,\n): RemoteLink =>\n  useLink({\n    ...options,\n    ctx,\n    attemptOnce: (c, abort) => attemptStream(c, options, abort),\n    send: async (c, frame) => {\n      try {\n        return await sendFrame(c, options, frame);\n      } catch (error) {\n        if (\n          error instanceof SyntaxError ||\n          (error instanceof Error &&\n            error.message.startsWith(\"statewire: protocol error:\"))\n        ) {\n          flushTapSync(() =>\n            settleFin(c, { reason: \"protocol-error\", message: error.message }),\n          );\n          c.abort?.abort();\n        }\n        throw error;\n      }\n    },\n  });\n\nconst useStatewireHttp = (\n  options: StatewireClient.HttpOptions,\n): Statewire<any, any> => useStatewireRemote(options, useSseLink);\n\nexport const StatewireHttp = resource(useStatewireHttp) as <\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.HttpOptions,\n) => ResourceElement<Statewire<TState | undefined, TCommands>>;\n"],"mappings":"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"}

package/dist/transports/testing.d.ts

@@ -1,38 +1,35 @@
-import { StatewireFrame } from "./sse.js";
-import { StatewireEnvelope } from "../client/connection.js";
-import { Statewire } from "../types.js";
-import { SocketRecorder, commandFrame, createCounterElement, createSocketRecorder, settle } from "./fixtures.js";
-import { applyOptimistic } from "../util/recordMutations.js";
-import { ResourceElement } from "@assistant-ui/tap";
-//#region src/transports/testing.d.ts
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { StatewireEnvelope } from "../client/connection.js";
+import type { StatewireFrame } from "./sse.js";
+import type { Statewire } from "../types.js";
+export * from "./fixtures.js";
 /** Let queued microtasks and op batches drain through the statewire client. */
-declare const tick: () => Promise<void>;
-type MockTransport<TState> = {
-  /** Pass as the `transport:` option of useStatewire / Harness. */
-  transport: ResourceElement<Statewire<TState | undefined, any>>;
-  /** Captured statements in arrival order. */
-  commands: {
-    protocol: string;
-    method: string;
-    params: unknown[];
-  }[];
-  contexts: NonNullable<StatewireFrame["ctx"]>;
-  /** Replace the replicated state and broadcast it as a root snapshot op. */
-  setState: (state: TState) => Promise<void>;
-  /** Deliver a bare ack cmd packet on the stream. */
-  applied: (seq: number) => Promise<void>;
-  /** Deliver a terminal result cmd packet on the stream. */
-  settle: (seq: number, payload?: unknown) => Promise<void>;
-  /** Deliver an arbitrary envelope on the stream. */
-  sendEnvelope: (envelope: StatewireEnvelope) => Promise<void>;
-  /** End the stream with a fin; further attaches fail like a dead server. */
-  finish: (reason: string, message?: string) => Promise<void>;
-  readonly clientId: string;
-  readonly attached: boolean;
+export declare const tick: () => Promise<void>;
+export { applyOptimistic } from "../util/recordMutations.js";
+export type MockTransport<TState> = {
+    /** Pass as the `transport:` option of useStatewire / Harness. */
+    transport: ResourceElement<Statewire<TState | undefined, any>>;
+    /** Captured statements in arrival order. */
+    commands: {
+        protocol: string;
+        method: string;
+        params: unknown[];
+    }[];
+    contexts: NonNullable<StatewireFrame["ctx"]>;
+    /** Replace the replicated state and broadcast it as a root snapshot op. */
+    setState: (state: TState) => Promise<void>;
+    /** Deliver a bare ack cmd packet on the stream. */
+    applied: (seq: number) => Promise<void>;
+    /** Deliver a terminal result cmd packet on the stream. */
+    settle: (seq: number, payload?: unknown) => Promise<void>;
+    /** Deliver an arbitrary envelope on the stream. */
+    sendEnvelope: (envelope: StatewireEnvelope) => Promise<void>;
+    /** End the stream with a fin; further attaches fail like a dead server. */
+    finish: (reason: string, message?: string) => Promise<void>;
+    readonly clientId: string;
+    readonly attached: boolean;
 };
-declare const createMockTransport: <TState>(initialState: TState, protocol?: string, options?: {
-  ephemeral?: readonly string[];
+export declare const createMockTransport: <TState>(initialState: TState, protocol?: string, options?: {
+    ephemeral?: readonly string[];
 }) => MockTransport<TState>;
-//#endregion
-export { MockTransport, SocketRecorder, applyOptimistic, commandFrame, createCounterElement, createMockTransport, createSocketRecorder, settle, tick };
 //# sourceMappingURL=testing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","names":[],"sources":["../../src/transports/testing.ts"],"mappings":";;;;;;;;cAYa,YAAI;KAIL,cAAc;;EAExB,WAAW,gBAAgB,UAAU;;EAErC;IAAY;IAAkB;IAAgB;;EAC9C,UAAU,YAAY;;EAEtB,WAAW,OAAO,WAAW;;EAE7B,UAAU,gBAAgB;;EAE1B,SAAS,aAAa,sBAAsB;;EAE5C,eAAe,UAAU,sBAAsB;;EAE/C,SAAS,gBAAgB,qBAAqB;WACrC;WACA;;cAUE,sBAAuB,QAClC,cAAc,QACd,mBACA;EAAW;MACV,cAAc"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/transports/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA6B;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAc;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAiB;AAK1C,8BAA2B;AAE3B,+EAA+E;AAC/E,eAAO,MAAM,IAAI,qBAAmD,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,mCAAgC;AAE1D,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI;IAClC,iEAAiE;IACjE,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/D,4CAA4C;IAC5C,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,CAAC;IACpE,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,mDAAmD;IACnD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,0DAA0D;IAC1D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mDAAmD;IACnD,YAAY,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,2EAA2E;IAC3E,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AASF,eAAO,MAAM,mBAAmB,GAAI,MAAM,EACxC,cAAc,MAAM,EACpB,iBAAoB,EACpB,UAAS;IAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,KAC9C,aAAa,CAAC,MAAM,CAmItB,CAAC"}

package/dist/transports/testing.js

@@ -3,7 +3,7 @@ import { applyOptimistic } from "../util/recordMutations.js";
 import { StatewireHttp } from "./sse.js";
 import { openSSEStream, sseFrame } from "./fake-sse.js";
 import { commandFrame, createCounterElement, createSocketRecorder, settle } from "./fixtures.js";
-//#region src/transports/testing.ts
+// src/transports/testing.ts
 /** Let queued microtasks and op batches drain through the statewire client. */
 const tick = () => new Promise((r) => setTimeout(r, 0));
 /**
@@ -128,7 +128,6 @@ const createMockTransport = (initialState, protocol = "default", options = {}) =
 		}
 	};
 };
-//#endregion
 export { applyOptimistic, commandFrame, createCounterElement, createMockTransport, createSocketRecorder, settle, tick };
 
 //# sourceMappingURL=testing.js.map

package/dist/transports/ws.d.ts

@@ -1,9 +1,7 @@
-import { StatewireClient } from "../statewire.js";
-import { Statewire } from "../types.js";
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { Statewire } from "../types.js";
+import type { StatewireClient } from "../statewire.js";
 import { WS_SUBPROTOCOL } from "../wire/version.js";
-import { ResourceElement } from "@assistant-ui/tap";
-//#region src/transports/ws.d.ts
-declare const StatewireWebsocket: <TState = any, TCommands extends Statewire.Commands = Statewire.Commands>(options: StatewireClient.WebsocketOptions) => ResourceElement<Statewire<TState | undefined, TCommands>>;
-//#endregion
-export { StatewireWebsocket, WS_SUBPROTOCOL };
+export { WS_SUBPROTOCOL };
+export declare const StatewireWebsocket: <TState = any, TCommands extends Statewire.Commands = Statewire.Commands>(options: StatewireClient.WebsocketOptions) => ResourceElement<Statewire<TState | undefined, TCommands>>;
 //# sourceMappingURL=ws.d.ts.map

package/dist/transports/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","names":[],"sources":["../../src/transports/ws.ts"],"mappings":";;;;;cA8La,qBACX,cACA,kBAAkB,UAAU,WAAW,UAAU,UAEjD,SAAS,gBAAgB,qBACtB,gBAAgB,UAAU,oBAAoB"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/transports/ws.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAazD,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAiB;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAqB;AAGpD,OAAO,EAAE,cAAc,EAAE,2BAAwB;AAcjD,OAAO,EAAE,cAAc,EAAE,CAAC;AA6J1B,eAAO,MAAM,kBAAkB,EAAsC,CACnE,MAAM,GAAG,GAAG,EACZ,SAAS,SAAS,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAEzD,OAAO,EAAE,eAAe,CAAC,gBAAgB,KACtC,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/dist/transports/ws.js

@@ -1,12 +1,12 @@
-import { CLIENT_QUERY_PARAM } from "../host/adapter.js";
-import { WS_SUBPROTOCOL } from "../wire/version.js";
 import { timing } from "../client/timing.js";
 import { attachFrame, handleEnvelope, unsupportedVersion, useLink } from "../client/connection.js";
+import { CLIENT_QUERY_PARAM } from "../host/adapter.js";
+import { WS_SUBPROTOCOL } from "../wire/version.js";
 import { useStatewireRemote } from "./remote.js";
 import { useState } from "@assistant-ui/tap/react-shim";
 import { flushTapSync, resource } from "@assistant-ui/tap";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
-//#region src/transports/ws.ts
+// src/transports/ws.ts
 const OPEN = 1;
 const socketUrl = async (options, clientId) => {
 	const { url, query } = options;
@@ -143,7 +143,6 @@ const StatewireWebsocket = resource(useStatewireWebsocket);
 function _temp() {
 	return { socket: null };
 }
-//#endregion
 export { StatewireWebsocket, WS_SUBPROTOCOL };
 
 //# sourceMappingURL=ws.js.map

package/dist/transports/ws.js.map

@@ -1 +1 @@
-{"version":3,"file":"ws.js","names":["useState","flushTapSync","resource","ResourceElement","timing","attachFrame","handleEnvelope","unsupportedVersion","useLink","AttemptOutcome","Conn","StatewireEnvelope","Statewire","StatewireClient","useStatewireRemote","CLIENT_QUERY_PARAM","WS_SUBPROTOCOL","RemoteLink","StatewireFrame","StatewireSubmitResult","StatewireRemoteProps","WsChannel","socket","WebSocket","OPEN","socketUrl","options","WebsocketOptions","clientId","url","query","params","URLSearchParams","set","resolved","URL","globalThis","location","href","protocol","replace","pathname","search","toString","runSocket","c","ws","frame","abort","AbortController","Promise","resolve","reject","timer","ReturnType","setTimeout","ping","setInterval","timedOut","outcome","closed","arm","clearTimeout","close","heartbeatTimeoutMs","signal","addEventListener","onerror","onopen","negotiated","trim","send","pingIntervalMs","stale","Boolean","aborted","fail","error","clearInterval","Error","onmessage","event","env","JSON","parse","String","data","SyntaxError","Object","keys","length","done","onclose","attemptSocket","w","ctx","body","headers","throwIfAborted","protocols","webSocket","WS","extra","undefined","sendFrame","readyState","stringify","type","useWsLink","$","_c","_temp","t0","t1","_","t2","attemptOnce","useStatewireWebsocket","StatewireWebsocket","Commands","TState","TCommands"],"sources":["../../src/transports/ws.ts"],"sourcesContent":["import { useState } from \"react\";\nimport { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { timing } from \"../client/timing\";\nimport {\n  attachFrame,\n  handleEnvelope,\n  unsupportedVersion,\n  useLink,\n} from \"../client/connection\";\nimport type {\n  AttemptOutcome,\n  Conn,\n  StatewireEnvelope,\n} from \"../client/connection\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\nimport { useStatewireRemote } from \"./remote\";\nimport { CLIENT_QUERY_PARAM } from \"../host/adapter\";\nimport { WS_SUBPROTOCOL } from \"../wire/version\";\nimport type {\n  RemoteLink,\n  StatewireFrame,\n  StatewireSubmitResult,\n  StatewireRemoteProps,\n} from \"./sse\";\n\ntype WsChannel = {\n  socket: WebSocket | null;\n};\n\nconst OPEN = 1;\n\nexport { WS_SUBPROTOCOL };\n\nconst socketUrl = async (\n  options: StatewireClient.WebsocketOptions,\n  clientId: string,\n) => {\n  const { url, query } = options;\n  const params = new URLSearchParams(\n    typeof query === \"function\" ? await query() : query,\n  );\n  params.set(CLIENT_QUERY_PARAM, clientId);\n  const resolved = new URL(url, globalThis.location?.href);\n  resolved.protocol = resolved.protocol.replace(/^http/, \"ws\");\n  resolved.pathname = `${resolved.pathname.replace(/\\/$/, \"\")}/ws`;\n  resolved.search = params.toString();\n  return resolved.href;\n};\n\nconst runSocket = (\n  c: Conn,\n  ws: WebSocket,\n  frame: string,\n  abort: AbortController,\n): Promise<AttemptOutcome> =>\n  new Promise((resolve, reject) => {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let ping: ReturnType<typeof setInterval> | undefined;\n    let timedOut = false;\n    let outcome: AttemptOutcome | null = null;\n    let closed = false;\n    const arm = () => {\n      clearTimeout(timer);\n      timer = setTimeout(() => {\n        timedOut = true;\n        ws.close();\n      }, timing.heartbeatTimeoutMs);\n    };\n    arm();\n    abort.signal.addEventListener(\"abort\", () => ws.close());\n    ws.onerror = () => {};\n    ws.onopen = () => {\n      const negotiated = ws.protocol.trim();\n      if (negotiated !== WS_SUBPROTOCOL) {\n        outcome = unsupportedVersion(c, negotiated);\n        ws.close();\n        return;\n      }\n      ws.send(frame);\n      // A ping keeps a host that cannot run timers (a hibernating durable\n      // object answers it without waking) talking before the silence timeout.\n      ping = setInterval(() => ws.send(\"{}\"), timing.pingIntervalMs);\n    };\n    const stale = () => Boolean(outcome) || closed || abort.signal.aborted;\n    const fail = (error: unknown) => {\n      clearTimeout(timer);\n      clearInterval(ping);\n      reject(error instanceof Error ? error : new Error(\"protocol\"));\n      ws.close();\n    };\n    ws.onmessage = (event) => {\n      if (stale()) return;\n      arm();\n      let env: StatewireEnvelope;\n      try {\n        env = JSON.parse(String(event.data)) as StatewireEnvelope;\n      } catch {\n        fail(new SyntaxError(\"invalid JSON packet\"));\n        return;\n      }\n      // {} heartbeats live below the packet layer: invisible to handlers.\n      if (\n        typeof env === \"object\" &&\n        env !== null &&\n        Object.keys(env).length === 0\n      ) {\n        return;\n      }\n      try {\n        const done = flushTapSync(() => handleEnvelope(c, env));\n        if (done) {\n          outcome = done;\n          ws.close();\n        }\n      } catch (error) {\n        fail(error);\n      }\n    };\n    ws.onclose = () => {\n      closed = true;\n      clearTimeout(timer);\n      clearInterval(ping);\n      if (outcome) resolve(outcome);\n      else reject(new Error(timedOut ? \"timeout\" : \"network\"));\n    };\n  });\n\nconst attemptSocket = async (\n  c: Conn,\n  w: WsChannel,\n  options: StatewireClient.WebsocketOptions,\n  abort: AbortController,\n): Promise<AttemptOutcome> => {\n  let ws: WebSocket | null = null;\n  try {\n    const url = await socketUrl(options, c.ctx.clientId);\n    const { body } = await attachFrame(c, options.headers);\n    abort.signal.throwIfAborted();\n    const { protocols, webSocket } = options;\n    const WS = webSocket ?? globalThis.WebSocket;\n    if (!WS) throw new Error(\"no WebSocket implementation\");\n    const extra =\n      protocols === undefined\n        ? []\n        : typeof protocols === \"string\"\n          ? [protocols]\n          : protocols;\n    ws = new WS(url, [WS_SUBPROTOCOL, ...extra]);\n    w.socket = ws;\n    return await runSocket(c, ws, body, abort);\n  } finally {\n    if (w.socket === ws) w.socket = null;\n  }\n};\n\nconst sendFrame = (\n  w: WsChannel,\n  frame: StatewireFrame,\n): Promise<StatewireSubmitResult> => {\n  const ws = w.socket;\n  if (!ws || ws.readyState !== OPEN) {\n    return Promise.reject(new Error(\"network\"));\n  }\n  try {\n    ws.send(JSON.stringify(frame));\n  } catch {\n    return Promise.reject(new Error(\"network\"));\n  }\n  return Promise.resolve({ type: \"ok\" });\n};\n\nconst useWsLink = (\n  options: StatewireClient.WebsocketOptions,\n  ctx: StatewireRemoteProps,\n): RemoteLink => {\n  const [w] = useState((): WsChannel => ({ socket: null }));\n  return useLink({\n    ...options,\n    ctx,\n    attemptOnce: (c, abort) => attemptSocket(c, w, options, abort),\n    send: (_, frame) => sendFrame(w, frame),\n  });\n};\n\nconst useStatewireWebsocket = (\n  options: StatewireClient.WebsocketOptions,\n): Statewire<any, any> => useStatewireRemote(options, useWsLink);\n\nexport const StatewireWebsocket = resource(useStatewireWebsocket) as <\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.WebsocketOptions,\n) => ResourceElement<Statewire<TState | undefined, TCommands>>;\n"],"mappings":"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"}
+{"version":3,"file":"ws.js","names":["useState","flushTapSync","resource","ResourceElement","timing","attachFrame","handleEnvelope","unsupportedVersion","useLink","AttemptOutcome","Conn","StatewireEnvelope","Statewire","StatewireClient","useStatewireRemote","CLIENT_QUERY_PARAM","WS_SUBPROTOCOL","RemoteLink","StatewireFrame","StatewireSubmitResult","StatewireRemoteProps","WsChannel","socket","WebSocket","OPEN","socketUrl","options","WebsocketOptions","clientId","url","query","params","URLSearchParams","set","resolved","URL","globalThis","location","href","protocol","replace","pathname","search","toString","runSocket","c","ws","frame","abort","AbortController","Promise","resolve","reject","timer","ReturnType","setTimeout","ping","setInterval","timedOut","outcome","closed","arm","clearTimeout","close","heartbeatTimeoutMs","signal","addEventListener","onerror","onopen","negotiated","trim","send","pingIntervalMs","stale","Boolean","aborted","fail","error","clearInterval","Error","onmessage","event","env","JSON","parse","String","data","SyntaxError","Object","keys","length","done","onclose","attemptSocket","w","ctx","body","headers","throwIfAborted","protocols","webSocket","WS","extra","undefined","sendFrame","readyState","stringify","type","useWsLink","$","_c","_temp","t0","t1","_","t2","attemptOnce","useStatewireWebsocket","StatewireWebsocket","Commands","TState","TCommands","_c"],"sources":["../../src/transports/ws.ts"],"sourcesContent":["import { useState } from \"react\";\nimport { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { timing } from \"../client/timing\";\nimport {\n  attachFrame,\n  handleEnvelope,\n  unsupportedVersion,\n  useLink,\n} from \"../client/connection\";\nimport type {\n  AttemptOutcome,\n  Conn,\n  StatewireEnvelope,\n} from \"../client/connection\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\nimport { useStatewireRemote } from \"./remote\";\nimport { CLIENT_QUERY_PARAM } from \"../host/adapter\";\nimport { WS_SUBPROTOCOL } from \"../wire/version\";\nimport type {\n  RemoteLink,\n  StatewireFrame,\n  StatewireSubmitResult,\n  StatewireRemoteProps,\n} from \"./sse\";\n\ntype WsChannel = {\n  socket: WebSocket | null;\n};\n\nconst OPEN = 1;\n\nexport { WS_SUBPROTOCOL };\n\nconst socketUrl = async (\n  options: StatewireClient.WebsocketOptions,\n  clientId: string,\n) => {\n  const { url, query } = options;\n  const params = new URLSearchParams(\n    typeof query === \"function\" ? await query() : query,\n  );\n  params.set(CLIENT_QUERY_PARAM, clientId);\n  const resolved = new URL(url, globalThis.location?.href);\n  resolved.protocol = resolved.protocol.replace(/^http/, \"ws\");\n  resolved.pathname = `${resolved.pathname.replace(/\\/$/, \"\")}/ws`;\n  resolved.search = params.toString();\n  return resolved.href;\n};\n\nconst runSocket = (\n  c: Conn,\n  ws: WebSocket,\n  frame: string,\n  abort: AbortController,\n): Promise<AttemptOutcome> =>\n  new Promise((resolve, reject) => {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let ping: ReturnType<typeof setInterval> | undefined;\n    let timedOut = false;\n    let outcome: AttemptOutcome | null = null;\n    let closed = false;\n    const arm = () => {\n      clearTimeout(timer);\n      timer = setTimeout(() => {\n        timedOut = true;\n        ws.close();\n      }, timing.heartbeatTimeoutMs);\n    };\n    arm();\n    abort.signal.addEventListener(\"abort\", () => ws.close());\n    ws.onerror = () => {};\n    ws.onopen = () => {\n      const negotiated = ws.protocol.trim();\n      if (negotiated !== WS_SUBPROTOCOL) {\n        outcome = unsupportedVersion(c, negotiated);\n        ws.close();\n        return;\n      }\n      ws.send(frame);\n      // A ping keeps a host that cannot run timers (a hibernating durable\n      // object answers it without waking) talking before the silence timeout.\n      ping = setInterval(() => ws.send(\"{}\"), timing.pingIntervalMs);\n    };\n    const stale = () => Boolean(outcome) || closed || abort.signal.aborted;\n    const fail = (error: unknown) => {\n      clearTimeout(timer);\n      clearInterval(ping);\n      reject(error instanceof Error ? error : new Error(\"protocol\"));\n      ws.close();\n    };\n    ws.onmessage = (event) => {\n      if (stale()) return;\n      arm();\n      let env: StatewireEnvelope;\n      try {\n        env = JSON.parse(String(event.data)) as StatewireEnvelope;\n      } catch {\n        fail(new SyntaxError(\"invalid JSON packet\"));\n        return;\n      }\n      // {} heartbeats live below the packet layer: invisible to handlers.\n      if (\n        typeof env === \"object\" &&\n        env !== null &&\n        Object.keys(env).length === 0\n      ) {\n        return;\n      }\n      try {\n        const done = flushTapSync(() => handleEnvelope(c, env));\n        if (done) {\n          outcome = done;\n          ws.close();\n        }\n      } catch (error) {\n        fail(error);\n      }\n    };\n    ws.onclose = () => {\n      closed = true;\n      clearTimeout(timer);\n      clearInterval(ping);\n      if (outcome) resolve(outcome);\n      else reject(new Error(timedOut ? \"timeout\" : \"network\"));\n    };\n  });\n\nconst attemptSocket = async (\n  c: Conn,\n  w: WsChannel,\n  options: StatewireClient.WebsocketOptions,\n  abort: AbortController,\n): Promise<AttemptOutcome> => {\n  let ws: WebSocket | null = null;\n  try {\n    const url = await socketUrl(options, c.ctx.clientId);\n    const { body } = await attachFrame(c, options.headers);\n    abort.signal.throwIfAborted();\n    const { protocols, webSocket } = options;\n    const WS = webSocket ?? globalThis.WebSocket;\n    if (!WS) throw new Error(\"no WebSocket implementation\");\n    const extra =\n      protocols === undefined\n        ? []\n        : typeof protocols === \"string\"\n          ? [protocols]\n          : protocols;\n    ws = new WS(url, [WS_SUBPROTOCOL, ...extra]);\n    w.socket = ws;\n    return await runSocket(c, ws, body, abort);\n  } finally {\n    if (w.socket === ws) w.socket = null;\n  }\n};\n\nconst sendFrame = (\n  w: WsChannel,\n  frame: StatewireFrame,\n): Promise<StatewireSubmitResult> => {\n  const ws = w.socket;\n  if (!ws || ws.readyState !== OPEN) {\n    return Promise.reject(new Error(\"network\"));\n  }\n  try {\n    ws.send(JSON.stringify(frame));\n  } catch {\n    return Promise.reject(new Error(\"network\"));\n  }\n  return Promise.resolve({ type: \"ok\" });\n};\n\nconst useWsLink = (\n  options: StatewireClient.WebsocketOptions,\n  ctx: StatewireRemoteProps,\n): RemoteLink => {\n  const [w] = useState((): WsChannel => ({ socket: null }));\n  return useLink({\n    ...options,\n    ctx,\n    attemptOnce: (c, abort) => attemptSocket(c, w, options, abort),\n    send: (_, frame) => sendFrame(w, frame),\n  });\n};\n\nconst useStatewireWebsocket = (\n  options: StatewireClient.WebsocketOptions,\n): Statewire<any, any> => useStatewireRemote(options, useWsLink);\n\nexport const StatewireWebsocket = resource(useStatewireWebsocket) as <\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.WebsocketOptions,\n) => ResourceElement<Statewire<TState | undefined, TCommands>>;\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,82 +1,85 @@
-import { StatewireDocuments } from "./wire/documents.js";
-import { StatewireHost } from "./host.js";
-import { StatewireProtocol } from "./wire/protocol.js";
-import { StatewireClient } from "./statewire.js";
-import { StatewirePath } from "./wire/ops.js";
-//#region src/types.d.ts
-declare namespace Statewire {
-  type Context = Readonly<Record<string, unknown>>;
-  type Commands = Record<string, (...args: never[]) => unknown>;
-  type Command<TCommands extends Commands = Commands> = { [K in keyof TCommands]: {
-    method: K;
-    params: Parameters<TCommands[K]>;
-  }; }[keyof TCommands];
-  type CommandsProxy<TCommands extends Commands> = { [K in keyof TCommands]: (...args: Parameters<TCommands[K]>) => Promise<Awaited<ReturnType<TCommands[K]>>>; };
-  type CommandUpdate<TCommands extends Commands = Commands> = { [K in keyof TCommands]: {
-    readonly protocol?: string;
-    method: K;
-    params: Parameters<TCommands[K]>;
-    seq: number;
-    status: "queued" | "posted" | "applied" | "settled";
-    result?: unknown;
-    failure?: StatewireClient.SendFailure;
-  }; }[keyof TCommands];
-  /** Push-based canonical state feed a statewire hands to the client core. */
-  type StateSource = {
-    snapshot: () => unknown;
-    /** Drain the paths changed since the last take (`[]` entry = whole state). */
-    takeChanged: () => StatewirePath[];
-    /** Synchronous, per change; the consumer owns coalescing. */
-    setOnChange: (listener: (() => void) | null) => void;
-  };
-  type Op = {
-    op: "replace";
-    path: StatewirePath;
-    value: unknown;
-  } | {
-    op: "add";
-    path: StatewirePath;
-    value: unknown;
-  } | {
-    op: "remove";
-    path: StatewirePath;
-  };
-  type Changes = {
-    isChangedAt(path: readonly (string | number)[]): boolean;
-    getChangedKeys(path: readonly (string | number)[]): string[];
-  };
+import type { StatewireDocuments } from "./wire/documents.js";
+import type { StatewireHost } from "./host.js";
+import type { StatewireProtocol } from "./wire/protocol.js";
+import type { StatewireClient } from "./statewire.js";
+import type { StatewirePath } from "./wire/ops.js";
+export declare namespace Statewire {
+    type Context = Readonly<Record<string, unknown>>;
+    type Commands = Record<string, (...args: never[]) => unknown>;
+    type Command<TCommands extends Commands = Commands> = {
+        [K in keyof TCommands]: {
+            method: K;
+            params: Parameters<TCommands[K]>;
+        };
+    }[keyof TCommands];
+    type CommandsProxy<TCommands extends Commands> = {
+        [K in keyof TCommands]: (...args: Parameters<TCommands[K]>) => Promise<Awaited<ReturnType<TCommands[K]>>>;
+    };
+    type CommandUpdate<TCommands extends Commands = Commands> = {
+        [K in keyof TCommands]: {
+            readonly protocol?: string;
+            method: K;
+            params: Parameters<TCommands[K]>;
+            seq: number;
+            status: "queued" | "posted" | "applied" | "settled";
+            result?: unknown;
+            failure?: StatewireClient.SendFailure;
+        };
+    }[keyof TCommands];
+    /** Push-based canonical state feed a statewire hands to the client core. */
+    type StateSource = {
+        snapshot: () => unknown;
+        /** Drain the paths changed since the last take (`[]` entry = whole state). */
+        takeChanged: () => StatewirePath[];
+        /** Synchronous, per change; the consumer owns coalescing. */
+        setOnChange: (listener: (() => void) | null) => void;
+    };
+    type Op = {
+        op: "replace";
+        path: StatewirePath;
+        value: unknown;
+    } | {
+        op: "add";
+        path: StatewirePath;
+        value: unknown;
+    } | {
+        op: "remove";
+        path: StatewirePath;
+    };
+    type Changes = {
+        isChangedAt(path: readonly (string | number)[]): boolean;
+        getChangedKeys(path: readonly (string | number)[]): string[];
+    };
 }
-interface Statewire<TState = any, TCommands extends Statewire.Commands = Statewire.Commands> {
-  state: TState;
-  documents?: StatewireDocuments.Source;
-  selection?: StatewireProtocol.Selection | undefined;
-  setContext?: (protocol: string, value: Statewire.Context) => void;
-  validateContext?: (protocol: string, value: Statewire.Context, attach: StatewireHost.Attach) => void;
-  contextChanged?: (protocol: string, value: Statewire.Context, attach: StatewireHost.Attach) => void;
-  invoke?: (protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
-  commands: Statewire.CommandsProxy<TCommands>;
-  connection?: StatewireClient.Connection;
-  source?: Statewire.StateSource;
-  /** Negation of the server's broadcast idle level; absent means always busy. */
-  isBusy?: boolean;
-  work?: {
-    readonly isIdle: boolean;
-  };
-  /** Called by the serving host once an attach is registered, before its hello: documents mounted here ride the hello. */
-  attaching?: (attach: StatewireHost.Attach) => void;
-  /** Called by the serving host when an attach ends; its ephemeral documents and includes are gone. */
-  detached?: (attach: StatewireHost.Attach) => void;
-  /** The retained failed-send lane; present on transports with a durable session. */
-  failures?: {
-    list: () => readonly StatewireClient.FailedCommand[];
-    retry: (entry: StatewireClient.FailedCommand) => Promise<unknown>;
-    discard: (entry: StatewireClient.FailedCommand) => void;
-  };
+export interface Statewire<TState = any, TCommands extends Statewire.Commands = Statewire.Commands> {
+    state: TState;
+    documents?: StatewireDocuments.Source;
+    selection?: StatewireProtocol.Selection | undefined;
+    setContext?: (protocol: string, value: Statewire.Context) => void;
+    validateContext?: (protocol: string, value: Statewire.Context, attach: StatewireHost.Attach) => void;
+    contextChanged?: (protocol: string, value: Statewire.Context, attach: StatewireHost.Attach) => void;
+    invoke?: (protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
+    commands: Statewire.CommandsProxy<TCommands>;
+    connection?: StatewireClient.Connection;
+    source?: Statewire.StateSource;
+    /** Negation of the server's broadcast idle level; absent means always busy. */
+    isBusy?: boolean;
+    work?: {
+        readonly isIdle: boolean;
+    };
+    /** Called by the serving host once an attach is registered, before its hello: documents mounted here ride the hello. */
+    attaching?: (attach: StatewireHost.Attach) => void;
+    /** Called by the serving host when an attach ends; its ephemeral documents and includes are gone. */
+    detached?: (attach: StatewireHost.Attach) => void;
+    /** The retained failed-send lane; present on transports with a durable session. */
+    failures?: {
+        list: () => readonly StatewireClient.FailedCommand[];
+        retry: (entry: StatewireClient.FailedCommand) => Promise<unknown>;
+        discard: (entry: StatewireClient.FailedCommand) => void;
+    };
 }
-declare class StatewireSendError extends Error {
-  readonly failure: StatewireClient.SendFailure;
-  constructor(failure: StatewireClient.SendFailure);
+export declare class StatewireSendError extends Error {
+    readonly failure: StatewireClient.SendFailure;
+    constructor(failure: StatewireClient.SendFailure);
 }
-//#endregion
-export { Statewire, StatewireSendError };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;kBAMiB;OACH,UAAU,SAAS;OACnB,WAAW,mBAAmB;OAE9B,QAAQ,kBAAkB,WAAW,eAC9C,WAAW;IAAc,QAAQ;IAAG,QAAQ,WAAW,UAAU;aAC5D;OAEI,cAAc,kBAAkB,eACzC,WAAW,gBACP,MAAM,WAAW,UAAU,QAC3B,QAAQ,QAAQ,WAAW,UAAU;OAGhC,cAAc,kBAAkB,WAAW,eACpD,WAAW;aACD;IACT,QAAQ;IACR,QAAQ,WAAW,UAAU;IAC7B;IACA;IACA;IACA,UAAU,gBAAgB;aAEtB;;OAGI;IACV;;IAEA,mBAAmB;;IAEnB,cAAc;;OAGJ;IACN;IAAe,MAAM;IAAe;;IACpC;IAAW,MAAM;IAAe;;IAChC;IAAc,MAAM;;OAEd;IACV,YAAY;IACZ,eAAe;;;UAIF,UACf,cACA,kBAAkB,UAAU,WAAW,UAAU;EAEjD,OAAO;EACP,YAAY,mBAAmB;EAC/B,YAAY,kBAAkB;EAC9B,cAAc,kBAAkB,OAAO,UAAU;EACjD,mBACE,kBACA,OAAO,UAAU,SACjB,QAAQ,cAAc;EAExB,kBACE,kBACA,OAAO,UAAU,SACjB,QAAQ,cAAc;EAExB,UACE,kBACA,gBACA,+BACG;EACL,UAAU,UAAU,cAAc;EAClC,aAAa,gBAAgB;EAC7B,SAAS,UAAU;;EAEnB;EACA;aAAkB;;;EAElB,aAAa,QAAQ,cAAc;;EAEnC,YAAY,QAAQ,cAAc;;EAElC;IACE,qBAAqB,gBAAgB;IACrC,QAAQ,OAAO,gBAAgB,kBAAkB;IACjD,UAAU,OAAO,gBAAgB;;;cAuBxB,2BAA2B;WAC7B,SAAS,gBAAgB;EAEtB,YAAA,SAAS,gBAAgB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,4 +1,4 @@
-//#region src/types.ts
+// src/types.ts
 const describe = (failure) => {
 	switch (failure.fate) {
 		case "rejected": return `statewire: command rejected${failure.code ? ` (${failure.code})` : ""}${failure.message ? `: ${failure.message}` : ""}`;
@@ -17,7 +17,6 @@ var StatewireSendError = class extends Error {
 		this.failure = failure;
 	}
 };
-//#endregion
 export { StatewireSendError };
 
 //# sourceMappingURL=types.js.map

package/dist/util/draftTraps.d.ts

@@ -1,6 +1,4 @@
-//#region src/util/draftTraps.d.ts
 type SharedTraps = Pick<ProxyHandler<object>, "defineProperty" | "setPrototypeOf" | "preventExtensions" | "ownKeys" | "getOwnPropertyDescriptor">;
-declare const sharedDraftTraps: (current: () => object, context: string) => SharedTraps;
-//#endregion
-export { sharedDraftTraps };
+export declare const sharedDraftTraps: (current: () => object, context: string) => SharedTraps;
+export {};
 //# sourceMappingURL=draftTraps.d.ts.map

package/dist/util/draftTraps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draftTraps.d.ts","names":[],"sources":["../../src/util/draftTraps.ts"],"mappings":";KAAK,cAAc,KACjB;cAQW,mBACX,uBACA,oBACC"}
+{"version":3,"file":"draftTraps.d.ts","sourceRoot":"","sources":["../../src/util/draftTraps.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,IAAI,CACrB,YAAY,CAAC,MAAM,CAAC,EAClB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,SAAS,GACT,0BAA0B,CAC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,MAAM,EACrB,SAAS,MAAM,KACd,WAmBF,CAAC"}

package/dist/util/draftTraps.js

@@ -1,4 +1,4 @@
-//#region src/util/draftTraps.ts
+// src/util/draftTraps.ts
 const sharedDraftTraps = (current, context) => {
 	const unsupported = (op) => {
 		throw new Error(`statewire: ${op} is not supported ${context}`);
@@ -19,7 +19,6 @@ const sharedDraftTraps = (current, context) => {
 		}
 	};
 };
-//#endregion
 export { sharedDraftTraps };
 
 //# sourceMappingURL=draftTraps.js.map

package/dist/util/macrotask.d.ts

@@ -1,5 +1,2 @@
-//#region src/util/macrotask.d.ts
-declare const createMacrotaskPoster: (callback: () => void) => (() => void);
-//#endregion
-export { createMacrotaskPoster };
+export declare const createMacrotaskPoster: (callback: () => void) => (() => void);
 //# sourceMappingURL=macrotask.d.ts.map

package/dist/util/macrotask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"macrotask.d.ts","names":[],"sources":["../../src/util/macrotask.ts"],"mappings":";cAIa,wBAAyB"}
+{"version":3,"file":"macrotask.d.ts","sourceRoot":"","sources":["../../src/util/macrotask.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAoBvE,CAAC"}

package/dist/util/macrotask.js

@@ -1,4 +1,4 @@
-//#region src/util/macrotask.ts
+// src/util/macrotask.ts
 const createMacrotaskPoster = (callback) => {
 	if (typeof MessageChannel !== "undefined") {
 		let port1 = null;
@@ -19,7 +19,6 @@ const createMacrotaskPoster = (callback) => {
 	}
 	return () => setTimeout(callback, 0);
 };
-//#endregion
 export { createMacrotaskPoster };
 
 //# sourceMappingURL=macrotask.js.map

package/dist/util/methodProxy.d.ts

@@ -1,5 +1,2 @@
-//#region src/util/methodProxy.d.ts
-declare const createMethodProxy: <T extends object>(dispatch: (method: string, params: unknown[]) => Promise<unknown>) => T;
-//#endregion
-export { createMethodProxy };
+export declare const createMethodProxy: <T extends object>(dispatch: (method: string, params: unknown[]) => Promise<unknown>) => T;
 //# sourceMappingURL=methodProxy.d.ts.map

package/dist/util/methodProxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"methodProxy.d.ts","names":[],"sources":["../../src/util/methodProxy.ts"],"mappings":";cAAa,oBAAqB,kBAChC,WAAW,gBAAgB,sBAAsB,qBAChD"}
+{"version":3,"file":"methodProxy.d.ts","sourceRoot":"","sources":["../../src/util/methodProxy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAChD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,KAChE,CAaF,CAAC"}

package/dist/util/methodProxy.js

@@ -1,4 +1,4 @@
-//#region src/util/methodProxy.ts
+// src/util/methodProxy.ts
 const createMethodProxy = (dispatch) => {
 	const memo = /* @__PURE__ */ new Map();
 	return new Proxy({}, { get: (_target, method) => {
@@ -11,7 +11,6 @@ const createMethodProxy = (dispatch) => {
 		return fn;
 	} });
 };
-//#endregion
 export { createMethodProxy };
 
 //# sourceMappingURL=methodProxy.js.map

package/dist/util/randomId.d.ts

@@ -1,5 +1,2 @@
-//#region src/util/randomId.d.ts
-declare const randomId: () => string;
-//#endregion
-export { randomId };
+export declare const randomId: () => string;
 //# sourceMappingURL=randomId.d.ts.map

package/dist/util/randomId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"randomId.d.ts","names":[],"sources":["../../src/util/randomId.ts"],"mappings":";cAAa"}
+{"version":3,"file":"randomId.d.ts","sourceRoot":"","sources":["../../src/util/randomId.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,QAAO,MAGhB,CAAC"}