statewire 0.8.1 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 # statewire
 
-React/TypeScript client for the **Statewire** protocol: a server owns a JSON state object and streams it to clients over SSE (`GET /stream`, snapshot first); clients change it by POSTing method calls (`POST /commands`, body `{"method", "params"}`). The client keeps your UI on the canonical state with optimistic updates rebased on top, survives disconnects, evictions, and reloads of the server, and tells you exactly what happened to every command you sent.
+React/TypeScript client for the **Statewire** protocol: a server owns a JSON state object and streams it to clients as packets (`POST /stream` attach, hello-snapshot first); clients change it by submitting stamped statement frames (`POST /frames`, `{"cmd": [{"method", "params", "seq"}]}`). The client keeps your UI on the canonical state with optimistic updates rebased on top, survives disconnects, evictions, and reloads of the server, and tells you exactly what happened to every command you sent.
 
 ```tsx
 import { useStatewire, StatewireSSE } from "statewire";
@@ -9,7 +9,7 @@ type Commands = {
   increment(): void;
 };
 
-const { state, connection, commands } = useStatewire<State, Commands, Event>({
+const { state, connection, commands } = useStatewire<State, Commands>({
   transport: StatewireSSE({ url: "/api/threads/demo" }),
   optimistic: (draft, command) => {
     if (command.method === "increment") draft.count += 1;

package/dist/client/connection.d.ts

@@ -6,58 +6,62 @@ type Episode = {
   cause: "dropped" | "evicted" | "error" | "unauthorized";
   message?: string;
 };
-type StatewireResponse = {
+type StatewireCmd = {
   seq: number;
-  type: "accepted" | "rejected" | "pending" | "crashed" | "result-unavailable";
+  type?: "applied" | "result" | "rejected" | "failed" | "crashed" | "expired";
   code?: string;
   message?: string;
   payload?: unknown;
   meta?: unknown;
+  /** Cumulative: resending through this seq will never be needed. */
+  dur?: boolean;
 };
 type StatewireSyn = {
-  lastSeq: number;
-  lease?: string;
+  seq?: number;
+  ctxSeq?: number;
+  record?: "fresh" | "resumed" | "ephemeral";
+  id?: string;
+  idle?: boolean;
+  retry?: number;
 };
 type StatewireEnvelope = {
   ops?: unknown[];
-  res?: StatewireResponse[];
-  ack?: number;
+  cmd?: StatewireCmd[];
+  next?: true;
+  idle?: boolean;
   syn?: StatewireSyn;
   fin?: StatewireHost.Fin;
 };
-declare const createGate: () => {
-  take: () => boolean;
-  wait: (timeoutMs?: number) => Promise<void>;
-  open: () => void;
+type Gate = {
+  latched: boolean;
+  wake: (() => void) | undefined;
 };
-type Gate = ReturnType<typeof createGate>;
+type AttemptOutcome = "stop" | "reattach" | "ended" | "idle";
 type Conn = {
   connection: StatewireClient.Connection;
   hasSnapshot: boolean;
   lease: string | null;
   attempt: number;
   episode: Episode | null;
+  awaitingHello: boolean;
+  held: StatewireCmd[];
   gate: Gate;
   abort: AbortController | null;
   lifetime: AbortController | null;
   ctx: StatewireRemoteProps;
   onChange: (connection: StatewireClient.Connection) => void;
-  attemptOnce: (abort: AbortController) => Promise<"stop" | "reattach" | "ended">;
+  attemptOnce: (abort: AbortController) => Promise<AttemptOutcome>;
   notify: (connection: StatewireClient.Connection) => void;
   reconnect: () => void;
 };
-declare const handleEnvelope: (c: Conn, env: StatewireEnvelope) => "stop" | "reattach" | null;
+declare const handleEnvelope: (c: Conn, env: StatewireEnvelope) => AttemptOutcome | null;
 declare const useStatewireConn: (props: {
   url: string;
   onChange?: ((connection: StatewireClient.Connection) => void) | undefined;
   ctx: StatewireRemoteProps;
-  attemptOnce: (c: Conn, abort: AbortController) => Promise<"stop" | "reattach" | "ended">;
+  attemptOnce: (c: Conn, abort: AbortController) => Promise<AttemptOutcome>;
 }) => Conn;
 declare const classify: (timeout: AbortSignal) => Error;
-declare const parseRetryAfter: (header: string | null) => number | undefined;
-declare const overloadedError: (retryAfterMs?: number) => Error & {
-  retryAfterMs: number | undefined;
-};
 //#endregion
-export { Conn, Episode, Gate, StatewireEnvelope, StatewireResponse, StatewireSyn, classify, handleEnvelope, overloadedError, parseRetryAfter, useStatewireConn };
+export { AttemptOutcome, Conn, Episode, Gate, StatewireCmd, StatewireEnvelope, StatewireSyn, classify, handleEnvelope, useStatewireConn };
 //# sourceMappingURL=connection.d.ts.map

package/dist/client/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","names":[],"sources":["../../src/client/connection.ts"],"mappings":";;;;KAQY;EACV;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;;KAGU;EACV;EACA,MAAM;EACN;EACA,MAAM;EACN,MAAM,cAAc;;cAGhB;;EASiB,OAAA,uBAAM;;;KA2BjB,OAAO,kBAAkB;KAEzB;EACV,YAAY,gBAAgB;EAC5B;EACA;EACA;EACA,SAAS;EACT,MAAM;EACN,OAAO;EACP,UAAU;EACV,KAAK;EACL,WAAW,YAAY,gBAAgB;EACvC,cACE,OAAO,oBACJ;EACL,SAAS,YAAY,gBAAgB;EACrC;;cAuEW,iBACX,GAAG,MACH,KAAK;cAyEM,mBAAoB;EAC/B;EACA,aAAa,YAAY,gBAAgB;EACzC,KAAK;EACL,cACE,GAAG,MACH,OAAO,oBACJ;MACH;cA8CS,WAAY,SAAS,gBAAW;cAGhC,kBAAmB;cAQnB,kBAAmB,0BAAqB"}
+{"version":3,"file":"connection.d.ts","names":[],"sources":["../../src/client/connection.ts"],"mappings":";;;;KAQY;EACV;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA;;EAEA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA,MAAM;EACN;EACA;EACA,MAAM;EACN,MAAM,cAAc;;KAGV;EAAS;EAAkB;;KAoC3B;KAEA;EACV,YAAY,gBAAgB;EAC5B;EACA;EACA;EACA,SAAS;EACT;EACA,MAAM;EACN,MAAM;EACN,OAAO;EACP,UAAU;EACV,KAAK;EACL,WAAW,YAAY,gBAAgB;EACvC,cAAc,OAAO,oBAAoB,QAAQ;EACjD,SAAS,YAAY,gBAAgB;EACrC;;cAyGW,iBACX,GAAG,MACH,KAAK,sBACJ;cAwFU,mBAAoB;EAC/B;EACA,aAAa,YAAY,gBAAgB;EACzC,KAAK;EACL,cAAc,GAAG,MAAM,OAAO,oBAAoB,QAAQ;MACxD;cAkDS,WAAY,SAAS,gBAAW"}

package/dist/client/connection.js

@@ -1,39 +1,37 @@
-import { reviveOps, reviveResponse, reviveValue } from "../wire/meta.js";
-import { retryDelay } from "./timing.js";
+import { reviveOps, reviveValue } from "../wire/meta.js";
+import { backoff } from "./timing.js";
 import { useEffect, useRef, useState } from "@assistant-ui/tap/react-shim";
 import { flushTapSync } from "@assistant-ui/tap";
 //#region src/client/connection.ts
-const createGate = () => {
-	let latched = false;
-	let wake;
-	return {
-		take: () => {
-			const was = latched;
-			latched = false;
-			return was;
-		},
-		wait: (timeoutMs) => {
-			if (latched) {
-				latched = false;
-				return Promise.resolve();
-			}
-			return new Promise((resolve) => {
-				const timer = timeoutMs === void 0 ? void 0 : setTimeout(() => {
-					wake = void 0;
-					resolve();
-				}, timeoutMs);
-				wake = () => {
-					clearTimeout(timer);
-					wake = void 0;
-					resolve();
-				};
-			});
-		},
-		open: () => {
-			if (wake) wake();
-			else latched = true;
-		}
-	};
+const newGate = () => ({
+	latched: false,
+	wake: void 0
+});
+const takeGate = (g) => {
+	const was = g.latched;
+	g.latched = false;
+	return was;
+};
+const waitGate = (g, timeoutMs) => {
+	if (g.latched) {
+		g.latched = false;
+		return Promise.resolve();
+	}
+	return new Promise((resolve) => {
+		const timer = timeoutMs === void 0 ? void 0 : setTimeout(() => {
+			g.wake = void 0;
+			resolve();
+		}, timeoutMs);
+		g.wake = () => {
+			clearTimeout(timer);
+			g.wake = void 0;
+			resolve();
+		};
+	});
+};
+const openGate = (g) => {
+	if (g.wake) g.wake();
+	else g.latched = true;
 };
 const setStatus = (c, next) => {
 	const changed = next.status !== c.connection.status;
@@ -44,64 +42,107 @@ const setStatus = (c, next) => {
 	c.notify(c.connection);
 	if (changed) c.onChange(c.connection);
 };
+const protocolError = (message) => {
+	throw new Error(`statewire: protocol error: ${message}`);
+};
+const releaseHeld = (c) => {
+	if (c.held.length === 0) return;
+	const held = c.held;
+	c.held = [];
+	c.ctx.onCmds(held);
+};
+const cmdsOf = (env) => {
+	if (env.cmd === void 0) return [];
+	if (!Array.isArray(env.cmd)) return protocolError("cmd must be an array");
+	return env.cmd;
+};
+const handleHello = (c, env) => {
+	const syn = env.syn;
+	if (syn === void 0) return protocolError("expected hello");
+	c.awaitingHello = false;
+	c.hasSnapshot = true;
+	c.ctx.onHello({
+		ops: env.ops === void 0 ? [] : reviveOps(env.ops),
+		syn
+	});
+	c.ctx.onIdle(syn.idle ?? false);
+	c.attempt = 0;
+	c.episode = null;
+	setStatus(c, { status: "live" });
+};
 const deliverEnvelope = (c, env) => {
-	if (env.syn?.lease !== void 0) c.lease = env.syn.lease;
-	const ctx = c.ctx;
-	const ops = env.ops === void 0 ? [] : reviveOps(env.ops);
-	const res = env.res?.map(reviveResponse);
 	if (env.syn !== void 0) {
-		ctx.onSnapshot({
-			ops,
-			lastSeq: env.syn.lastSeq
+		const syn = env.syn;
+		if (syn.seq !== void 0 || syn.ctxSeq !== void 0 || syn.retry !== void 0) c.ctx.onRefusal(syn);
+		else if (syn.id === void 0) protocolError("invalid mid-stream syn");
+	}
+	if (env.ops !== void 0) {
+		const held = c.held;
+		c.held = [];
+		c.ctx.onOps({
+			ops: reviveOps(env.ops),
+			cmds: [...held, ...cmdsOf(env)]
 		});
-		c.hasSnapshot = true;
-	} else if (env.ops !== void 0 || env.res !== void 0 || env.ack !== void 0) ctx.onOps({
-		ops,
-		...res !== void 0 && { res },
-		...env.ack !== void 0 && { ack: env.ack }
-	});
+	} else if (env.cmd !== void 0) {
+		const cmds = cmdsOf(env);
+		if (env.next === true) c.held.push(...cmds);
+		else c.ctx.onCmds(cmds);
+	}
+	if (typeof env.idle === "boolean") c.ctx.onIdle(env.idle);
 };
 const isTransientFinish = (reason) => reason === "evicted" || reason === "error";
-const settleEnvelope = (c, env) => {
-	let finish = env.fin;
-	if (finish) {
-		if (finish.meta !== void 0) {
-			const { meta, ...rest } = finish;
-			finish = {
-				...rest,
-				payload: reviveValue(rest.payload, meta)
-			};
-		}
-		c.ctx.onFinish(finish);
-		if (isTransientFinish(finish.reason)) {
-			c.episode = {
-				cause: finish.reason,
-				...finish.message !== void 0 && { message: finish.message }
-			};
-			return "reattach";
-		}
-		setStatus(c, {
-			status: "gone",
-			...finish.message !== void 0 && { message: finish.message },
-			...finish.payload !== void 0 && { payload: finish.payload }
-		});
-		return "stop";
+const settleFin = (c, fin) => {
+	let finish = fin;
+	if (finish.meta !== void 0) {
+		const { meta, ...rest } = finish;
+		finish = {
+			...rest,
+			payload: reviveValue(rest.payload, meta)
+		};
 	}
-	if (c.connection.status !== "live") {
+	releaseHeld(c);
+	if (finish.reason === "idle") {
+		c.ctx.onIdle(true);
 		c.attempt = 0;
 		c.episode = null;
-		setStatus(c, { status: "live" });
+		setStatus(c, { status: "idle" });
+		return "idle";
 	}
-	return null;
+	c.ctx.onFinish(finish);
+	if (isTransientFinish(finish.reason)) {
+		c.episode = {
+			cause: finish.reason,
+			...finish.message !== void 0 && { message: finish.message }
+		};
+		return "reattach";
+	}
+	setStatus(c, {
+		status: "gone",
+		...finish.message !== void 0 && { message: finish.message },
+		...finish.payload !== void 0 && { payload: finish.payload }
+	});
+	return "stop";
 };
 const handleEnvelope = (c, env) => {
+	if (typeof env !== "object" || env === null) return protocolError("packet must be an object");
+	if (c.awaitingHello) {
+		if (env.fin !== void 0) return settleFin(c, env.fin);
+		handleHello(c, env);
+		return null;
+	}
 	deliverEnvelope(c, env);
-	return settleEnvelope(c, env);
+	if (env.fin !== void 0) return settleFin(c, env.fin);
+	if (c.connection.status !== "live") {
+		c.attempt = 0;
+		c.episode = null;
+		setStatus(c, { status: "live" });
+	}
+	return null;
 };
-const scheduleRetry = (c, failure, immediate, cause) => {
+const scheduleRetry = (c, failure, immediate) => {
 	c.attempt += 1;
 	c.episode ??= { cause: "dropped" };
-	const delay = immediate ? 0 : retryDelay(cause, c.attempt);
+	const delay = immediate ? 0 : backoff(c.attempt);
 	if (c.hasSnapshot) setStatus(c, {
 		status: "reconnecting",
 		...c.episode,
@@ -113,7 +154,7 @@ const scheduleRetry = (c, failure, immediate, cause) => {
 };
 const reconnectConn = (c) => {
 	if (!c.lifetime) return;
-	if (c.connection.status === "gone") {
+	if (c.connection.status === "gone" || c.connection.status === "idle") {
 		c.attempt = 0;
 		c.episode = { cause: "dropped" };
 		flushTapSync(() => {
@@ -121,7 +162,7 @@ const reconnectConn = (c) => {
 			else setStatus(c, { status: "connecting" });
 		});
 	}
-	c.gate.open();
+	openGate(c.gate);
 	c.abort?.abort();
 };
 const run = async (c, lifetime, gate) => {
@@ -129,27 +170,30 @@ const run = async (c, lifetime, gate) => {
 	while (alive()) {
 		const abort = new AbortController();
 		c.abort = abort;
+		c.awaitingHello = true;
+		c.held = [];
+		let outcome;
 		let failure;
-		let cause;
-		let gone = false;
 		try {
-			gone = await c.attemptOnce(abort) === "stop";
+			outcome = await c.attemptOnce(abort);
 		} catch (error) {
-			if (!abort.signal.aborted) {
-				failure = error instanceof Error && error.message ? error.message : "network";
-				cause = error;
-			}
+			if (!abort.signal.aborted) failure = error instanceof Error && error.message ? error.message : "network";
 		}
 		abort.abort();
 		if (!alive()) return;
-		if (gone) {
-			await gate.wait();
+		flushTapSync(() => {
+			releaseHeld(c);
+			c.ctx.onDetach();
+		});
+		if (!alive()) return;
+		if (outcome === "stop" || outcome === "idle") {
+			await waitGate(gate);
 			continue;
 		}
-		const immediate = gate.take();
-		const delay = flushTapSync(() => scheduleRetry(c, failure, immediate, cause));
+		const immediate = takeGate(gate);
+		const delay = flushTapSync(() => scheduleRetry(c, failure, immediate));
 		if (delay === 0) continue;
-		await gate.wait(delay);
+		await waitGate(gate, delay);
 	}
 };
 const useStatewireConn = (props) => {
@@ -162,10 +206,14 @@ const useStatewireConn = (props) => {
 			lease: null,
 			attempt: 0,
 			episode: null,
+			awaitingHello: true,
+			held: [],
 			abort: null,
-			gate: createGate(),
+			gate: newGate(),
 			lifetime: null,
-			ctx: props.ctx,
+			get ctx() {
+				return latest.current.ctx;
+			},
 			onChange: (connection) => latest.current.onChange?.(connection),
 			attemptOnce: (abort) => latest.current.attemptOnce(conn, abort),
 			notify: setConnection,
@@ -185,27 +233,19 @@ const useStatewireConn = (props) => {
 		if (c.connection.status !== "connecting") setStatus(c, { status: "connecting" });
 		const lifetime = new AbortController();
 		c.lifetime = lifetime;
-		c.gate = createGate();
+		c.gate = newGate();
 		run(c, lifetime, c.gate);
 		return () => {
 			c.abort?.abort();
 			lifetime.abort();
 			if (c.lifetime === lifetime) c.lifetime = null;
-			c.gate.open();
+			openGate(c.gate);
 		};
 	}, [c, props.url]);
 	return c;
 };
 const classify = (timeout) => /* @__PURE__ */ new Error(timeout.aborted ? "timeout" : "network");
-const parseRetryAfter = (header) => {
-	if (!header) return void 0;
-	const value = header.trim();
-	if (/^\d+$/.test(value)) return Number(value) * 1e3;
-	const date = Date.parse(value);
-	return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
-};
-const overloadedError = (retryAfterMs) => Object.assign(/* @__PURE__ */ new Error("overloaded"), { retryAfterMs });
 //#endregion
-export { classify, handleEnvelope, overloadedError, parseRetryAfter, useStatewireConn };
+export { classify, handleEnvelope, useStatewireConn };
 
 //# sourceMappingURL=connection.js.map

package/dist/client/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","names":["useEffect","useRef","useState","flushTapSync","reviveOps","reviveResponse","reviveValue","retryDelay","ConnectionState","StatewireRemoteProps","StatewireClient","StatewireHost","Episode","cause","message","StatewireResponse","seq","type","code","payload","meta","StatewireSyn","lastSeq","lease","StatewireEnvelope","ops","res","ack","syn","fin","Fin","createGate","latched","wake","take","was","wait","timeoutMs","Promise","resolve","timer","undefined","setTimeout","clearTimeout","open","Gate","ReturnType","Conn","connection","Connection","hasSnapshot","attempt","episode","gate","abort","AbortController","lifetime","ctx","onChange","attemptOnce","notify","reconnect","setStatus","c","next","changed","status","deliverEnvelope","env","Pick","map","onSnapshot","onOps","isTransientFinish","reason","settleEnvelope","finish","rest","onFinish","handleEnvelope","scheduleRetry","failure","immediate","delay","nextRetryAt","Date","now","lastError","reconnectConn","run","alive","gone","error","signal","aborted","Error","useStatewireConn","props","url","latest","current","setConnection","conn","classify","timeout","AbortSignal","parseRetryAfter","header","value","trim","test","Number","date","parse","isNaN","Math","max","overloadedError","retryAfterMs","Object","assign"],"sources":["../../src/client/connection.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { flushTapSync } from \"@assistant-ui/tap\";\nimport { reviveOps, reviveResponse, reviveValue } from \"../wire/meta\";\nimport { retryDelay } from \"./timing\";\nimport type { ConnectionState, StatewireRemoteProps } from \"../transports/sse\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { StatewireHost } from \"../host\";\n\nexport type Episode = {\n  cause: \"dropped\" | \"evicted\" | \"error\" | \"unauthorized\";\n  message?: string;\n};\n\nexport type StatewireResponse = {\n  seq: number;\n  type: \"accepted\" | \"rejected\" | \"pending\" | \"crashed\" | \"result-unavailable\";\n  code?: string;\n  message?: string;\n  payload?: unknown;\n  meta?: unknown;\n};\n\nexport type StatewireSyn = {\n  lastSeq: number;\n  lease?: string;\n};\n\nexport type StatewireEnvelope = {\n  ops?: unknown[];\n  res?: StatewireResponse[];\n  ack?: number;\n  syn?: StatewireSyn;\n  fin?: StatewireHost.Fin;\n};\n\nconst createGate = () => {\n  let latched = false;\n  let wake: (() => void) | undefined;\n  return {\n    take: () => {\n      const was = latched;\n      latched = false;\n      return was;\n    },\n    wait: (timeoutMs?: number) => {\n      if (latched) {\n        latched = false;\n        return Promise.resolve();\n      }\n      return new Promise<void>((resolve) => {\n        const timer =\n          timeoutMs === undefined\n            ? undefined\n            : setTimeout(() => {\n                wake = undefined;\n                resolve();\n              }, timeoutMs);\n        wake = () => {\n          clearTimeout(timer);\n          wake = undefined;\n          resolve();\n        };\n      });\n    },\n    open: () => {\n      if (wake) wake();\n      else latched = true;\n    },\n  };\n};\n\nexport type Gate = ReturnType<typeof createGate>;\n\nexport type Conn = {\n  connection: StatewireClient.Connection;\n  hasSnapshot: boolean;\n  lease: string | null;\n  attempt: number;\n  episode: Episode | null;\n  gate: Gate;\n  abort: AbortController | null;\n  lifetime: AbortController | null;\n  ctx: StatewireRemoteProps;\n  onChange: (connection: StatewireClient.Connection) => void;\n  attemptOnce: (\n    abort: AbortController,\n  ) => Promise<\"stop\" | \"reattach\" | \"ended\">;\n  notify: (connection: StatewireClient.Connection) => void;\n  reconnect: () => void;\n};\n\nconst setStatus = (c: Conn, next: ConnectionState) => {\n  const changed = next.status !== c.connection.status;\n  c.connection = { ...next, reconnect: c.reconnect };\n  c.notify(c.connection);\n  if (changed) c.onChange(c.connection);\n};\n\nconst deliverEnvelope = (\n  c: Conn,\n  env: Pick<StatewireEnvelope, \"ops\" | \"res\" | \"ack\" | \"syn\">,\n) => {\n  if (env.syn?.lease !== undefined) c.lease = env.syn.lease;\n  const ctx = c.ctx;\n  const ops = env.ops === undefined ? [] : reviveOps(env.ops);\n  const res = env.res?.map(reviveResponse);\n  if (env.syn !== undefined) {\n    ctx.onSnapshot({ ops, lastSeq: env.syn.lastSeq });\n    c.hasSnapshot = true;\n  } else if (\n    env.ops !== undefined ||\n    env.res !== undefined ||\n    env.ack !== undefined\n  ) {\n    ctx.onOps({\n      ops,\n      ...(res !== undefined && { res }),\n      ...(env.ack !== undefined && { ack: env.ack }),\n    });\n  }\n};\n\nconst isTransientFinish = (\n  reason: StatewireHost.Fin[\"reason\"],\n): reason is \"evicted\" | \"error\" => reason === \"evicted\" || reason === \"error\";\n\nconst settleEnvelope = (\n  c: Conn,\n  env: StatewireEnvelope,\n): \"stop\" | \"reattach\" | null => {\n  let finish = env.fin;\n  if (finish) {\n    if (finish.meta !== undefined) {\n      const { meta, ...rest } = finish;\n      finish = { ...rest, payload: reviveValue(rest.payload, meta) };\n    }\n    c.ctx.onFinish(finish);\n    if (isTransientFinish(finish.reason)) {\n      c.episode = {\n        cause: finish.reason,\n        ...(finish.message !== undefined && { message: finish.message }),\n      };\n      return \"reattach\";\n    }\n    setStatus(c, {\n      status: \"gone\",\n      ...(finish.message !== undefined && { message: finish.message }),\n      ...(finish.payload !== undefined && { payload: finish.payload }),\n    });\n    return \"stop\";\n  }\n  if (c.connection.status !== \"live\") {\n    c.attempt = 0;\n    c.episode = null;\n    setStatus(c, { status: \"live\" });\n  }\n  return null;\n};\n\nexport const handleEnvelope = (\n  c: Conn,\n  env: StatewireEnvelope,\n): \"stop\" | \"reattach\" | null => {\n  deliverEnvelope(c, env);\n  return settleEnvelope(c, env);\n};\n\nconst scheduleRetry = (\n  c: Conn,\n  failure: string | undefined,\n  immediate: boolean,\n  cause?: unknown,\n) => {\n  c.attempt += 1;\n  c.episode ??= { cause: \"dropped\" };\n  const delay = immediate ? 0 : retryDelay(cause, c.attempt);\n  if (c.hasSnapshot) {\n    setStatus(c, {\n      status: \"reconnecting\",\n      ...c.episode,\n      attempt: c.attempt,\n      nextRetryAt: Date.now() + delay,\n      ...(failure !== undefined && { lastError: failure }),\n    });\n  }\n  return delay;\n};\n\nconst reconnectConn = (c: Conn) => {\n  if (!c.lifetime) return;\n  if (c.connection.status === \"gone\") {\n    c.attempt = 0;\n    c.episode = { cause: \"dropped\" };\n    flushTapSync(() => {\n      if (c.hasSnapshot) scheduleRetry(c, undefined, true);\n      else setStatus(c, { status: \"connecting\" });\n    });\n  }\n  c.gate.open();\n  c.abort?.abort();\n};\n\nconst run = async (c: Conn, lifetime: AbortController, gate: Gate) => {\n  const alive = () => c.lifetime === lifetime;\n  while (alive()) {\n    const abort = new AbortController();\n    c.abort = abort;\n    let failure: string | undefined;\n    let cause: unknown;\n    let gone = false;\n    try {\n      gone = (await c.attemptOnce(abort)) === \"stop\";\n    } catch (error) {\n      if (!abort.signal.aborted) {\n        failure =\n          error instanceof Error && error.message ? error.message : \"network\";\n        cause = error;\n      }\n    }\n    abort.abort();\n    if (!alive()) return;\n    if (gone) {\n      await gate.wait();\n      continue;\n    }\n    const immediate = gate.take();\n    const delay = flushTapSync(() =>\n      scheduleRetry(c, failure, immediate, cause),\n    );\n    if (delay === 0) continue;\n    await gate.wait(delay);\n  }\n};\n\nexport const useStatewireConn = (props: {\n  url: string;\n  onChange?: ((connection: StatewireClient.Connection) => void) | undefined;\n  ctx: StatewireRemoteProps;\n  attemptOnce: (\n    c: Conn,\n    abort: AbortController,\n  ) => Promise<\"stop\" | \"reattach\" | \"ended\">;\n}): Conn => {\n  const latest = useRef(props);\n  latest.current = props;\n  const [, setConnection] = useState<StatewireClient.Connection | null>(null);\n  const [c] = useState((): Conn => {\n    const conn: Conn = {\n      hasSnapshot: false,\n      lease: null,\n      attempt: 0,\n      episode: null,\n      abort: null,\n      gate: createGate(),\n      lifetime: null,\n      ctx: props.ctx,\n      onChange: (connection) => latest.current.onChange?.(connection),\n      attemptOnce: (abort) => latest.current.attemptOnce(conn, abort),\n      notify: setConnection,\n      reconnect: () => reconnectConn(conn),\n      connection: { status: \"connecting\", reconnect: () => conn.reconnect() },\n    };\n    return conn;\n  });\n\n  useEffect(() => {\n    c.hasSnapshot = false;\n    c.lease = null;\n    c.attempt = 0;\n    c.episode = null;\n    if (c.connection.status !== \"connecting\") {\n      setStatus(c, { status: \"connecting\" });\n    }\n    const lifetime = new AbortController();\n    c.lifetime = lifetime;\n    c.gate = createGate();\n    void run(c, lifetime, c.gate);\n    return () => {\n      c.abort?.abort();\n      lifetime.abort();\n      if (c.lifetime === lifetime) c.lifetime = null;\n      c.gate.open();\n    };\n  }, [c, props.url]);\n\n  return c;\n};\n\nexport const classify = (timeout: AbortSignal) =>\n  new Error(timeout.aborted ? \"timeout\" : \"network\");\n\nexport const parseRetryAfter = (header: string | null): number | undefined => {\n  if (!header) return undefined;\n  const value = header.trim();\n  if (/^\\d+$/.test(value)) return Number(value) * 1000;\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n};\n\nexport const overloadedError = (retryAfterMs?: number) =>\n  Object.assign(new Error(\"overloaded\"), { retryAfterMs });\n"],"mappings":"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"}
+{"version":3,"file":"connection.js","names":["useEffect","useRef","useState","flushTapSync","reviveOps","reviveValue","backoff","ConnectionState","StatewireRemoteProps","StatewireClient","StatewireHost","Episode","cause","message","StatewireCmd","seq","type","code","payload","meta","dur","StatewireSyn","ctxSeq","record","id","idle","retry","StatewireEnvelope","ops","cmd","next","syn","fin","Fin","Gate","latched","wake","newGate","undefined","takeGate","g","was","waitGate","timeoutMs","Promise","resolve","timer","setTimeout","clearTimeout","openGate","AttemptOutcome","Conn","connection","Connection","hasSnapshot","lease","attempt","episode","awaitingHello","held","gate","abort","AbortController","lifetime","ctx","onChange","attemptOnce","notify","reconnect","setStatus","c","changed","status","protocolError","Error","releaseHeld","length","onCmds","cmdsOf","env","Array","isArray","handleHello","onHello","onIdle","deliverEnvelope","onRefusal","onOps","cmds","push","isTransientFinish","reason","settleFin","finish","rest","onFinish","handleEnvelope","scheduleRetry","failure","immediate","delay","nextRetryAt","Date","now","lastError","reconnectConn","run","alive","outcome","error","signal","aborted","onDetach","useStatewireConn","props","url","latest","current","setConnection","conn","classify","timeout","AbortSignal"],"sources":["../../src/client/connection.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { flushTapSync } from \"@assistant-ui/tap\";\nimport { reviveOps, reviveValue } from \"../wire/meta\";\nimport { backoff } from \"./timing\";\nimport type { ConnectionState, StatewireRemoteProps } from \"../transports/sse\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { StatewireHost } from \"../host\";\n\nexport type Episode = {\n  cause: \"dropped\" | \"evicted\" | \"error\" | \"unauthorized\";\n  message?: string;\n};\n\nexport type StatewireCmd = {\n  seq: number;\n  type?: \"applied\" | \"result\" | \"rejected\" | \"failed\" | \"crashed\" | \"expired\";\n  code?: string;\n  message?: string;\n  payload?: unknown;\n  meta?: unknown;\n  /** Cumulative: resending through this seq will never be needed. */\n  dur?: boolean;\n};\n\nexport type StatewireSyn = {\n  seq?: number;\n  ctxSeq?: number;\n  record?: \"fresh\" | \"resumed\" | \"ephemeral\";\n  id?: string;\n  idle?: boolean;\n  retry?: number;\n};\n\nexport type StatewireEnvelope = {\n  ops?: unknown[];\n  cmd?: StatewireCmd[];\n  next?: true;\n  idle?: boolean;\n  syn?: StatewireSyn;\n  fin?: StatewireHost.Fin;\n};\n\nexport type Gate = { latched: boolean; wake: (() => void) | undefined };\n\nconst newGate = (): Gate => ({ latched: false, wake: undefined });\n\nconst takeGate = (g: Gate) => {\n  const was = g.latched;\n  g.latched = false;\n  return was;\n};\n\nconst waitGate = (g: Gate, timeoutMs?: number) => {\n  if (g.latched) {\n    g.latched = false;\n    return Promise.resolve();\n  }\n  return new Promise<void>((resolve) => {\n    const timer =\n      timeoutMs === undefined\n        ? undefined\n        : setTimeout(() => {\n            g.wake = undefined;\n            resolve();\n          }, timeoutMs);\n    g.wake = () => {\n      clearTimeout(timer);\n      g.wake = undefined;\n      resolve();\n    };\n  });\n};\n\nconst openGate = (g: Gate) => {\n  if (g.wake) g.wake();\n  else g.latched = true;\n};\n\nexport type AttemptOutcome = \"stop\" | \"reattach\" | \"ended\" | \"idle\";\n\nexport type Conn = {\n  connection: StatewireClient.Connection;\n  hasSnapshot: boolean;\n  lease: string | null;\n  attempt: number;\n  episode: Episode | null;\n  awaitingHello: boolean;\n  held: StatewireCmd[];\n  gate: Gate;\n  abort: AbortController | null;\n  lifetime: AbortController | null;\n  ctx: StatewireRemoteProps;\n  onChange: (connection: StatewireClient.Connection) => void;\n  attemptOnce: (abort: AbortController) => Promise<AttemptOutcome>;\n  notify: (connection: StatewireClient.Connection) => void;\n  reconnect: () => void;\n};\n\nconst setStatus = (c: Conn, next: ConnectionState) => {\n  const changed = next.status !== c.connection.status;\n  c.connection = { ...next, reconnect: c.reconnect };\n  c.notify(c.connection);\n  if (changed) c.onChange(c.connection);\n};\n\nconst protocolError = (message: string): never => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\n// A hold's release delivers, never settles: fin and bare close both drain it.\nconst releaseHeld = (c: Conn) => {\n  if (c.held.length === 0) return;\n  const held = c.held;\n  c.held = [];\n  c.ctx.onCmds(held);\n};\n\nconst cmdsOf = (env: StatewireEnvelope): StatewireCmd[] => {\n  if (env.cmd === undefined) return [];\n  if (!Array.isArray(env.cmd)) return protocolError(\"cmd must be an array\");\n  return env.cmd;\n};\n\nconst handleHello = (c: Conn, env: StatewireEnvelope) => {\n  const syn = env.syn;\n  if (syn === undefined) return protocolError(\"expected hello\");\n  c.awaitingHello = false;\n  c.hasSnapshot = true;\n  c.ctx.onHello({\n    ops: env.ops === undefined ? [] : reviveOps(env.ops),\n    syn,\n  });\n  c.ctx.onIdle(syn.idle ?? false);\n  c.attempt = 0;\n  c.episode = null;\n  setStatus(c, { status: \"live\" });\n};\n\nconst deliverEnvelope = (c: Conn, env: StatewireEnvelope) => {\n  if (env.syn !== undefined) {\n    const syn = env.syn;\n    if (\n      syn.seq !== undefined ||\n      syn.ctxSeq !== undefined ||\n      syn.retry !== undefined\n    ) {\n      c.ctx.onRefusal(syn);\n    } else if (syn.id === undefined) {\n      protocolError(\"invalid mid-stream syn\");\n    }\n  }\n  if (env.ops !== undefined) {\n    const held = c.held;\n    c.held = [];\n    c.ctx.onOps({\n      ops: reviveOps(env.ops),\n      cmds: [...held, ...cmdsOf(env)],\n    });\n  } else if (env.cmd !== undefined) {\n    const cmds = cmdsOf(env);\n    if (env.next === true) c.held.push(...cmds);\n    else c.ctx.onCmds(cmds);\n  }\n  if (typeof env.idle === \"boolean\") c.ctx.onIdle(env.idle);\n};\n\nconst isTransientFinish = (\n  reason: StatewireHost.Fin[\"reason\"],\n): reason is \"evicted\" | \"error\" => reason === \"evicted\" || reason === \"error\";\n\nconst settleFin = (c: Conn, fin: StatewireHost.Fin): AttemptOutcome => {\n  let finish = fin;\n  if (finish.meta !== undefined) {\n    const { meta, ...rest } = finish;\n    finish = { ...rest, payload: reviveValue(rest.payload, meta) };\n  }\n  releaseHeld(c);\n  if (finish.reason === \"idle\") {\n    c.ctx.onIdle(true);\n    c.attempt = 0;\n    c.episode = null;\n    setStatus(c, { status: \"idle\" });\n    return \"idle\";\n  }\n  c.ctx.onFinish(finish);\n  if (isTransientFinish(finish.reason)) {\n    c.episode = {\n      cause: finish.reason,\n      ...(finish.message !== undefined && { message: finish.message }),\n    };\n    return \"reattach\";\n  }\n  setStatus(c, {\n    status: \"gone\",\n    ...(finish.message !== undefined && { message: finish.message }),\n    ...(finish.payload !== undefined && { payload: finish.payload }),\n  });\n  return \"stop\";\n};\n\nexport const handleEnvelope = (\n  c: Conn,\n  env: StatewireEnvelope,\n): AttemptOutcome | null => {\n  if (typeof env !== \"object\" || env === null) {\n    return protocolError(\"packet must be an object\");\n  }\n  if (c.awaitingHello) {\n    if (env.fin !== undefined) return settleFin(c, env.fin);\n    handleHello(c, env);\n    return null;\n  }\n  deliverEnvelope(c, env);\n  if (env.fin !== undefined) return settleFin(c, env.fin);\n  if (c.connection.status !== \"live\") {\n    c.attempt = 0;\n    c.episode = null;\n    setStatus(c, { status: \"live\" });\n  }\n  return null;\n};\n\nconst scheduleRetry = (\n  c: Conn,\n  failure: string | undefined,\n  immediate: boolean,\n) => {\n  c.attempt += 1;\n  c.episode ??= { cause: \"dropped\" };\n  const delay = immediate ? 0 : backoff(c.attempt);\n  if (c.hasSnapshot) {\n    setStatus(c, {\n      status: \"reconnecting\",\n      ...c.episode,\n      attempt: c.attempt,\n      nextRetryAt: Date.now() + delay,\n      ...(failure !== undefined && { lastError: failure }),\n    });\n  }\n  return delay;\n};\n\nconst reconnectConn = (c: Conn) => {\n  if (!c.lifetime) return;\n  if (c.connection.status === \"gone\" || c.connection.status === \"idle\") {\n    c.attempt = 0;\n    c.episode = { cause: \"dropped\" };\n    flushTapSync(() => {\n      if (c.hasSnapshot) scheduleRetry(c, undefined, true);\n      else setStatus(c, { status: \"connecting\" });\n    });\n  }\n  openGate(c.gate);\n  c.abort?.abort();\n};\n\nconst run = async (c: Conn, lifetime: AbortController, gate: Gate) => {\n  const alive = () => c.lifetime === lifetime;\n  while (alive()) {\n    const abort = new AbortController();\n    c.abort = abort;\n    c.awaitingHello = true;\n    c.held = [];\n    let outcome: AttemptOutcome | undefined;\n    let failure: string | undefined;\n    try {\n      outcome = await c.attemptOnce(abort);\n    } catch (error) {\n      if (!abort.signal.aborted) {\n        failure =\n          error instanceof Error && error.message ? error.message : \"network\";\n      }\n    }\n    abort.abort();\n    if (!alive()) return;\n    flushTapSync(() => {\n      releaseHeld(c);\n      c.ctx.onDetach();\n    });\n    if (!alive()) return;\n    if (outcome === \"stop\" || outcome === \"idle\") {\n      await waitGate(gate);\n      continue;\n    }\n    const immediate = takeGate(gate);\n    const delay = flushTapSync(() => scheduleRetry(c, failure, immediate));\n    if (delay === 0) continue;\n    await waitGate(gate, delay);\n  }\n};\n\nexport const useStatewireConn = (props: {\n  url: string;\n  onChange?: ((connection: StatewireClient.Connection) => void) | undefined;\n  ctx: StatewireRemoteProps;\n  attemptOnce: (c: Conn, abort: AbortController) => Promise<AttemptOutcome>;\n}): Conn => {\n  const latest = useRef(props);\n  latest.current = props;\n  const [, setConnection] = useState<StatewireClient.Connection | null>(null);\n  const [c] = useState((): Conn => {\n    const conn: Conn = {\n      hasSnapshot: false,\n      lease: null,\n      attempt: 0,\n      episode: null,\n      awaitingHello: true,\n      held: [],\n      abort: null,\n      gate: newGate(),\n      lifetime: null,\n      get ctx() {\n        return latest.current.ctx;\n      },\n      onChange: (connection) => latest.current.onChange?.(connection),\n      attemptOnce: (abort) => latest.current.attemptOnce(conn, abort),\n      notify: setConnection,\n      reconnect: () => reconnectConn(conn),\n      connection: { status: \"connecting\", reconnect: () => conn.reconnect() },\n    };\n    return conn;\n  });\n\n  useEffect(() => {\n    c.hasSnapshot = false;\n    c.lease = null;\n    c.attempt = 0;\n    c.episode = null;\n    if (c.connection.status !== \"connecting\") {\n      setStatus(c, { status: \"connecting\" });\n    }\n    const lifetime = new AbortController();\n    c.lifetime = lifetime;\n    c.gate = newGate();\n    void run(c, lifetime, c.gate);\n    return () => {\n      c.abort?.abort();\n      lifetime.abort();\n      if (c.lifetime === lifetime) c.lifetime = null;\n      openGate(c.gate);\n    };\n  }, [c, props.url]);\n\n  return c;\n};\n\nexport const classify = (timeout: AbortSignal) =>\n  new Error(timeout.aborted ? \"timeout\" : \"network\");\n"],"mappings":";;;;;AA4CA,MAAMqC,iBAAuB;CAAEF,SAAS;CAAOC,MAAME,KAAAA;AAAU;AAE/D,MAAMC,YAAYC,MAAY;CAC5B,MAAMC,MAAMD,EAAEL;CACdK,EAAEL,UAAU;CACZ,OAAOM;AACT;AAEA,MAAMC,YAAYF,GAASG,cAAuB;CAChD,IAAIH,EAAEL,SAAS;EACbK,EAAEL,UAAU;EACZ,OAAOS,QAAQC,QAAQ;CACzB;CACA,OAAO,IAAID,SAAeC,YAAY;EACpC,MAAMC,QACJH,cAAcL,KAAAA,IACVA,KAAAA,IACAS,iBAAiB;GACfP,EAAEJ,OAAOE,KAAAA;GACTO,QAAQ;EACV,GAAGF,SAAS;EAClBH,EAAEJ,aAAa;GACbY,aAAaF,KAAK;GAClBN,EAAEJ,OAAOE,KAAAA;GACTO,QAAQ;EACV;CACF,CAAC;AACH;AAEA,MAAMI,YAAYT,MAAY;CAC5B,IAAIA,EAAEJ,MAAMI,EAAEJ,KAAK;MACdI,EAAEL,UAAU;AACnB;AAsBA,MAAMkC,aAAaC,GAASxC,SAA0B;CACpD,MAAMyC,UAAUzC,KAAK0C,WAAWF,EAAElB,WAAWoB;CAC7CF,EAAElB,aAAa;EAAE,GAAGtB;EAAMsC,WAAWE,EAAEF;CAAU;CACjDE,EAAEH,OAAOG,EAAElB,UAAU;CACrB,IAAImB,SAASD,EAAEL,SAASK,EAAElB,UAAU;AACtC;AAEA,MAAMqB,iBAAiB5D,YAA2B;CAChD,MAAM,IAAI6D,MAAM,8BAA8B7D,SAAS;AACzD;AAGA,MAAM8D,eAAeL,MAAY;CAC/B,IAAIA,EAAEX,KAAKiB,WAAW,GAAG;CACzB,MAAMjB,OAAOW,EAAEX;CACfW,EAAEX,OAAO,CAAA;CACTW,EAAEN,IAAIa,OAAOlB,IAAI;AACnB;AAEA,MAAMmB,UAAUC,QAA2C;CACzD,IAAIA,IAAIlD,QAAQS,KAAAA,GAAW,OAAO,CAAA;CAClC,IAAI,CAAC0C,MAAMC,QAAQF,IAAIlD,GAAG,GAAG,OAAO4C,cAAc,sBAAsB;CACxE,OAAOM,IAAIlD;AACb;AAEA,MAAMqD,eAAeZ,GAASS,QAA2B;CACvD,MAAMhD,MAAMgD,IAAIhD;CAChB,IAAIA,QAAQO,KAAAA,GAAW,OAAOmC,cAAc,gBAAgB;CAC5DH,EAAEZ,gBAAgB;CAClBY,EAAEhB,cAAc;CAChBgB,EAAEN,IAAImB,QAAQ;EACZvD,KAAKmD,IAAInD,QAAQU,KAAAA,IAAY,CAAA,IAAKlC,UAAU2E,IAAInD,GAAG;EACnDG;CACF,CAAC;CACDuC,EAAEN,IAAIoB,OAAOrD,IAAIN,QAAQ,KAAK;CAC9B6C,EAAEd,UAAU;CACZc,EAAEb,UAAU;CACZY,UAAUC,GAAG,EAAEE,QAAQ,OAAO,CAAC;AACjC;AAEA,MAAMa,mBAAmBf,GAASS,QAA2B;CAC3D,IAAIA,IAAIhD,QAAQO,KAAAA,GAAW;EACzB,MAAMP,MAAMgD,IAAIhD;EAChB,IACEA,IAAIhB,QAAQuB,KAAAA,KACZP,IAAIT,WAAWgB,KAAAA,KACfP,IAAIL,UAAUY,KAAAA,GAEdgC,EAAEN,IAAIsB,UAAUvD,GAAG;OACd,IAAIA,IAAIP,OAAOc,KAAAA,GACpBmC,cAAc,wBAAwB;CAE1C;CACA,IAAIM,IAAInD,QAAQU,KAAAA,GAAW;EACzB,MAAMqB,OAAOW,EAAEX;EACfW,EAAEX,OAAO,CAAA;EACTW,EAAEN,IAAIuB,MAAM;GACV3D,KAAKxB,UAAU2E,IAAInD,GAAG;GACtB4D,MAAM,CAAC,GAAG7B,MAAM,GAAGmB,OAAOC,GAAG,CAAC;EAChC,CAAC;CACH,OAAO,IAAIA,IAAIlD,QAAQS,KAAAA,GAAW;EAChC,MAAMkD,OAAOV,OAAOC,GAAG;EACvB,IAAIA,IAAIjD,SAAS,MAAMwC,EAAEX,KAAK8B,KAAK,GAAGD,IAAI;OACrClB,EAAEN,IAAIa,OAAOW,IAAI;CACxB;CACA,IAAI,OAAOT,IAAItD,SAAS,WAAW6C,EAAEN,IAAIoB,OAAOL,IAAItD,IAAI;AAC1D;AAEA,MAAMiE,qBACJC,WACkCA,WAAW,aAAaA,WAAW;AAEvE,MAAMC,aAAatB,GAAStC,QAA2C;CACrE,IAAI6D,SAAS7D;CACb,IAAI6D,OAAO1E,SAASmB,KAAAA,GAAW;EAC7B,MAAM,EAAEnB,MAAM,GAAG2E,SAASD;EAC1BA,SAAS;GAAE,GAAGC;GAAM5E,SAASb,YAAYyF,KAAK5E,SAASC,IAAI;EAAE;CAC/D;CACAwD,YAAYL,CAAC;CACb,IAAIuB,OAAOF,WAAW,QAAQ;EAC5BrB,EAAEN,IAAIoB,OAAO,IAAI;EACjBd,EAAEd,UAAU;EACZc,EAAEb,UAAU;EACZY,UAAUC,GAAG,EAAEE,QAAQ,OAAO,CAAC;EAC/B,OAAO;CACT;CACAF,EAAEN,IAAI+B,SAASF,MAAM;CACrB,IAAIH,kBAAkBG,OAAOF,MAAM,GAAG;EACpCrB,EAAEb,UAAU;GACV7C,OAAOiF,OAAOF;GACd,GAAIE,OAAOhF,YAAYyB,KAAAA,KAAa,EAAEzB,SAASgF,OAAOhF,QAAQ;EAChE;EACA,OAAO;CACT;CACAwD,UAAUC,GAAG;EACXE,QAAQ;EACR,GAAIqB,OAAOhF,YAAYyB,KAAAA,KAAa,EAAEzB,SAASgF,OAAOhF,QAAQ;EAC9D,GAAIgF,OAAO3E,YAAYoB,KAAAA,KAAa,EAAEpB,SAAS2E,OAAO3E,QAAQ;CAChE,CAAC;CACD,OAAO;AACT;AAEA,MAAa8E,kBACX1B,GACAS,QAC0B;CAC1B,IAAI,OAAOA,QAAQ,YAAYA,QAAQ,MACrC,OAAON,cAAc,0BAA0B;CAEjD,IAAIH,EAAEZ,eAAe;EACnB,IAAIqB,IAAI/C,QAAQM,KAAAA,GAAW,OAAOsD,UAAUtB,GAAGS,IAAI/C,GAAG;EACtDkD,YAAYZ,GAAGS,GAAG;EAClB,OAAO;CACT;CACAM,gBAAgBf,GAAGS,GAAG;CACtB,IAAIA,IAAI/C,QAAQM,KAAAA,GAAW,OAAOsD,UAAUtB,GAAGS,IAAI/C,GAAG;CACtD,IAAIsC,EAAElB,WAAWoB,WAAW,QAAQ;EAClCF,EAAEd,UAAU;EACZc,EAAEb,UAAU;EACZY,UAAUC,GAAG,EAAEE,QAAQ,OAAO,CAAC;CACjC;CACA,OAAO;AACT;AAEA,MAAMyB,iBACJ3B,GACA4B,SACAC,cACG;CACH7B,EAAEd,WAAW;CACbc,EAAEb,YAAY,EAAE7C,OAAO,UAAU;CACjC,MAAMwF,QAAQD,YAAY,IAAI7F,QAAQgE,EAAEd,OAAO;CAC/C,IAAIc,EAAEhB,aACJe,UAAUC,GAAG;EACXE,QAAQ;EACR,GAAGF,EAAEb;EACLD,SAASc,EAAEd;EACX6C,aAAaC,KAAKC,IAAI,IAAIH;EAC1B,GAAIF,YAAY5D,KAAAA,KAAa,EAAEkE,WAAWN,QAAQ;CACpD,CAAC;CAEH,OAAOE;AACT;AAEA,MAAMK,iBAAiBnC,MAAY;CACjC,IAAI,CAACA,EAAEP,UAAU;CACjB,IAAIO,EAAElB,WAAWoB,WAAW,UAAUF,EAAElB,WAAWoB,WAAW,QAAQ;EACpEF,EAAEd,UAAU;EACZc,EAAEb,UAAU,EAAE7C,OAAO,UAAU;EAC/BT,mBAAmB;GACjB,IAAImE,EAAEhB,aAAa2C,cAAc3B,GAAGhC,KAAAA,GAAW,IAAI;QAC9C+B,UAAUC,GAAG,EAAEE,QAAQ,aAAa,CAAC;EAC5C,CAAC;CACH;CACAvB,SAASqB,EAAEV,IAAI;CACfU,EAAET,OAAOA,MAAM;AACjB;AAEA,MAAM6C,MAAM,OAAOpC,GAASP,UAA2BH,SAAe;CACpE,MAAM+C,cAAcrC,EAAEP,aAAaA;CACnC,OAAO4C,MAAM,GAAG;EACd,MAAM9C,QAAQ,IAAIC,gBAAgB;EAClCQ,EAAET,QAAQA;EACVS,EAAEZ,gBAAgB;EAClBY,EAAEX,OAAO,CAAA;EACT,IAAIiD;EACJ,IAAIV;EACJ,IAAI;GACFU,UAAU,MAAMtC,EAAEJ,YAAYL,KAAK;EACrC,SAASgD,OAAO;GACd,IAAI,CAAChD,MAAMiD,OAAOC,SAChBb,UACEW,iBAAiBnC,SAASmC,MAAMhG,UAAUgG,MAAMhG,UAAU;EAEhE;EACAgD,MAAMA,MAAM;EACZ,IAAI,CAAC8C,MAAM,GAAG;EACdxG,mBAAmB;GACjBwE,YAAYL,CAAC;GACbA,EAAEN,IAAIgD,SAAS;EACjB,CAAC;EACD,IAAI,CAACL,MAAM,GAAG;EACd,IAAIC,YAAY,UAAUA,YAAY,QAAQ;GAC5C,MAAMlE,SAASkB,IAAI;GACnB;EACF;EACA,MAAMuC,YAAY5D,SAASqB,IAAI;EAC/B,MAAMwC,QAAQjG,mBAAmB8F,cAAc3B,GAAG4B,SAASC,SAAS,CAAC;EACrE,IAAIC,UAAU,GAAG;EACjB,MAAM1D,SAASkB,MAAMwC,KAAK;CAC5B;AACF;AAEA,MAAaa,oBAAoBC,UAKrB;CACV,MAAME,SAASnH,OAAOiH,KAAK;CAC3BE,OAAOC,UAAUH;CACjB,MAAM,GAAGI,iBAAiBpH,SAA4C,IAAI;CAC1E,MAAM,CAACoE,KAAKpE,eAAqB;EAC/B,MAAMqH,OAAa;GACjBjE,aAAa;GACbC,OAAO;GACPC,SAAS;GACTC,SAAS;GACTC,eAAe;GACfC,MAAM,CAAA;GACNE,OAAO;GACPD,MAAMvB,QAAQ;GACd0B,UAAU;GACV,IAAIC,MAAM;IACR,OAAOoD,OAAOC,QAAQrD;GACxB;GACAC,WAAWb,eAAegE,OAAOC,QAAQpD,WAAWb,UAAU;GAC9Dc,cAAcL,UAAUuD,OAAOC,QAAQnD,YAAYqD,MAAM1D,KAAK;GAC9DM,QAAQmD;GACRlD,iBAAiBqC,cAAcc,IAAI;GACnCnE,YAAY;IAAEoB,QAAQ;IAAcJ,iBAAiBmD,KAAKnD,UAAU;GAAE;EACxE;EACA,OAAOmD;CACT,CAAC;CAEDvH,gBAAgB;EACdsE,EAAEhB,cAAc;EAChBgB,EAAEf,QAAQ;EACVe,EAAEd,UAAU;EACZc,EAAEb,UAAU;EACZ,IAAIa,EAAElB,WAAWoB,WAAW,cAC1BH,UAAUC,GAAG,EAAEE,QAAQ,aAAa,CAAC;EAEvC,MAAMT,WAAW,IAAID,gBAAgB;EACrCQ,EAAEP,WAAWA;EACbO,EAAEV,OAAOvB,QAAQ;EACjB,IAASiC,GAAGP,UAAUO,EAAEV,IAAI;EAC5B,aAAa;GACXU,EAAET,OAAOA,MAAM;GACfE,SAASF,MAAM;GACf,IAAIS,EAAEP,aAAaA,UAAUO,EAAEP,WAAW;GAC1Cd,SAASqB,EAAEV,IAAI;EACjB;CACF,GAAG,CAACU,GAAG4C,MAAMC,GAAG,CAAC;CAEjB,OAAO7C;AACT;AAEA,MAAakD,YAAYC,4BACvB,IAAI/C,MAAM+C,QAAQV,UAAU,YAAY,SAAS"}

package/dist/client/core.d.ts

@@ -1,14 +1,41 @@
 import { StatewireClient } from "../statewire.js";
 import { Statewire } from "../types.js";
+import { StatewirePath } from "../wire/ops.js";
+import { CommandsInvocation, CommandsListener } from "../host/host.js";
 //#region src/client/core.d.ts
 declare const LIVE_CONNECTION: StatewireClient.Connection;
-declare const useStatewireCore: (getOptions: () => StatewireClient.Options<any, any, any>, value: Statewire<unknown>) => {
-  attach: (next: Statewire<unknown>) => void;
-  detach: () => void;
+type Overlay = {
+  inv: CommandsInvocation;
+  dropped: boolean;
+};
+type Core = {
+  getOptions: () => StatewireClient.Options<any, any>;
+  value: Statewire<unknown> | null;
+  source: Statewire.StateSource | null;
+  overlays: Overlay[];
+  updates: Statewire.CommandUpdate[];
+  pendingChanged: StatewirePath[];
+  canonical: unknown;
+  published: unknown;
+  overlayPaths: readonly StatewirePath[];
+  notifiedPublished: unknown;
+  notifiedOverlayPaths: readonly StatewirePath[];
+  notifiedConnection: StatewireClient.Connection | null;
+  notifiedBusy: boolean;
+  stale: boolean;
+  everAttached: boolean;
+  overlaysDirty: boolean;
+  flushing: boolean;
+  scheduled: boolean;
+  listeners: Set<() => void>;
+  post: () => void;
+  commandsListener: CommandsListener;
   getState: () => unknown;
+  getBusy: () => boolean;
   commands: Statewire.CommandsProxy<any>;
   subscribe: (listener: () => void) => () => void;
 };
+declare const useStatewireCore: (getOptions: () => StatewireClient.Options<any, any>, value: Statewire<unknown>) => Core;
 //#endregion
 export { LIVE_CONNECTION, useStatewireCore };
 //# sourceMappingURL=core.d.ts.map

package/dist/client/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","names":[],"sources":["../../src/client/core.ts"],"mappings":";;;cAYa,iBAAiB,gBAAgB;cA6TjC,mBACX,kBAAkB,gBAAgB,wBAClC,OAAO;EAnFe,SAAA,MAAA;;;;EAwEE,YAAA"}
+{"version":3,"file":"core.d.ts","names":[],"sources":["../../src/client/core.ts"],"mappings":";;;;;cAYa,iBAAiB,gBAAgB;KAczC;EAAY,KAAK;EAAoB;;KAErC;EACH,kBAAkB,gBAAgB;EAClC,OAAO;EACP,QAAQ,UAAU;EAClB,UAAU;EACV,SAAS,UAAU;EACnB,gBAAgB;EAChB;EACA;EACA,uBAAuB;EACvB;EACA,+BAA+B;EAC/B,oBAAoB,gBAAgB;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA,kBAAkB;EAClB;EACA;EACA,UAAU,UAAU;EACpB,YAAY;;cAyMD,mBACX,kBAAkB,gBAAgB,mBAClC,OAAO,uBAAkB"}