statewire 0.0.1 → 0.0.3

package/dist/client/core.js

@@ -1,7 +1,11 @@
-import { createChanges } from "./changes.js";
-import { recordMutations } from "./optimistic.js";
+import { recordMutations } from "../util/recordMutations.js";
+import { createMethodProxy } from "../util/methodProxy.js";
 import { StatewireSendError } from "../types.js";
 import { getCommandsHost, getEmitHost, getStateHost } from "../host/host.js";
+import { createMacrotaskPoster } from "../util/macrotask.js";
+import { createChanges } from "./changes.js";
+import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
+import { useEffect, useState } from "@assistant-ui/tap/react-shim";
 //#region src/client/core.ts
 const LIVE_CONNECTION = {
 	status: "live",
@@ -12,27 +16,7 @@ const failureOf = (error) => error instanceof StatewireSendError ? error.failure
 	cause: "server",
 	message: error instanceof Error ? error.message : String(error)
 };
-const createMacrotaskPoster = (callback) => {
-	if (typeof MessageChannel !== "undefined") {
-		let port1 = null;
-		let port2;
-		return () => {
-			if (!port1) {
-				const channel = new MessageChannel();
-				channel.port1.onmessage = () => {
-					port1?.unref?.();
-					callback();
-				};
-				port1 = channel.port1;
-				port2 = channel.port2;
-			}
-			port1.ref?.();
-			port2.postMessage(null);
-		};
-	}
-	return () => setTimeout(callback, 0);
-};
-const createStatewireCore = (getOptions) => {
+const createCore = (getOptions) => {
 	let value = null;
 	let source = null;
 	let overlays = [];
@@ -48,7 +32,6 @@ const createStatewireCore = (getOptions) => {
 	let stale = false;
 	let overlaysDirty = false;
 	let flushing = false;
-	let disposed = false;
 	const listeners = /* @__PURE__ */ new Set();
 	const post = createMacrotaskPoster(() => {
 		scheduled = false;
@@ -56,7 +39,7 @@ const createStatewireCore = (getOptions) => {
 	});
 	let scheduled = false;
 	const schedule = () => {
-		if (scheduled || disposed) return;
+		if (scheduled) return;
 		scheduled = true;
 		post();
 	};
@@ -67,7 +50,7 @@ const createStatewireCore = (getOptions) => {
 	const drainCanonical = () => {
 		if (source) {
 			pendingChanged.push(...source.takeChanged());
-			canonical = source.root();
+			canonical = source.snapshot();
 		} else if (value && value.state !== canonical) {
 			pendingChanged.push([]);
 			canonical = value.state;
@@ -108,7 +91,7 @@ const createStatewireCore = (getOptions) => {
 	};
 	const getConnection = () => value?.connection ?? LIVE_CONNECTION;
 	const flush = () => {
-		if (disposed || !value) return;
+		if (!value) return;
 		if (flushing) {
 			schedule();
 			return;
@@ -135,7 +118,7 @@ const createStatewireCore = (getOptions) => {
 				updates = [];
 				for (const update of batch) options.onCommandChange?.(update, { state: published });
 			}
-			if (events.length > 0) {
+			if (events.length > 0 && published !== void 0) {
 				const batch = events;
 				events = [];
 				for (const event of batch) options.onEvent?.(event, { state: published });
@@ -188,7 +171,7 @@ const createStatewireCore = (getOptions) => {
 		schedule();
 	};
 	const attach = (next) => {
-		if (disposed || next === value) return;
+		if (next === value) return;
 		const prev = value;
 		value = next;
 		const nextSource = next.source ?? (typeof next.state === "object" && next.state !== null ? getStateHost(next.state) : void 0) ?? null;
@@ -223,38 +206,23 @@ const createStatewireCore = (getOptions) => {
 			value = null;
 		}
 	};
-	const memo = /* @__PURE__ */ new Map();
 	return {
 		attach,
 		detach,
-		dispose: () => {
-			detach();
-			disposed = true;
-		},
 		getState: () => {
 			recompute();
 			return published;
 		},
-		getConnection,
-		commands: new Proxy({}, { get: (_target, method) => {
-			if (typeof method !== "string") return void 0;
-			let fn = memo.get(method);
-			if (fn === void 0) {
-				fn = (...params) => {
-					if (!value) return Promise.reject(new StatewireSendError({
-						fate: "aborted",
-						cause: "unmount"
-					}));
-					const send = value.commands[method];
-					const promise = send(...params);
-					flush();
-					return promise;
-				};
-				memo.set(method, fn);
-			}
-			return fn;
-		} }),
-		flush,
+		commands: createMethodProxy((method, params) => {
+			if (!value) return Promise.reject(new StatewireSendError({
+				fate: "aborted",
+				cause: "unmount"
+			}));
+			const send = value.commands[method];
+			const promise = send(...params);
+			flush();
+			return promise;
+		}),
 		subscribe: (listener) => {
 			listeners.add(listener);
 			return () => {
@@ -263,7 +231,42 @@ const createStatewireCore = (getOptions) => {
 		}
 	};
 };
+const useStatewireCore = (getOptions, value) => {
+	const $ = c(8);
+	let t0;
+	if ($[0] !== getOptions) {
+		t0 = () => createCore(getOptions);
+		$[0] = getOptions;
+		$[1] = t0;
+	} else t0 = $[1];
+	const [core] = useState(t0);
+	core.attach(value);
+	let t1;
+	if ($[2] !== core || $[3] !== value) {
+		t1 = () => {
+			core.attach(value);
+		};
+		$[2] = core;
+		$[3] = value;
+		$[4] = t1;
+	} else t1 = $[4];
+	useEffect(t1);
+	let t2;
+	let t3;
+	if ($[5] !== core) {
+		t2 = () => () => core.detach();
+		t3 = [core];
+		$[5] = core;
+		$[6] = t2;
+		$[7] = t3;
+	} else {
+		t2 = $[6];
+		t3 = $[7];
+	}
+	useEffect(t2, t3);
+	return core;
+};
 //#endregion
-export { LIVE_CONNECTION, createStatewireCore };
+export { LIVE_CONNECTION, useStatewireCore };
 
 //# sourceMappingURL=core.js.map

package/dist/client/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","names":["createChanges","getCommandsHost","getEmitHost","getStateHost","CommandsInvocation","CommandsListener","recordMutations","StatewirePath","StatewireSendError","SendFailure","StatewireSendFailure","StatewireStateSource","StatewireTransport","StatewireCommand","StatewireCommandsProxy","StatewireCommandUpdate","StatewireOptimisticContext","StatewireOptions","StatewireConnection","LIVE_CONNECTION","status","reconnect","failureOf","error","failure","fate","cause","message","Error","String","createMacrotaskPoster","callback","MessageChannel","port1","MessagePort","ref","unref","port2","channel","onmessage","postMessage","setTimeout","Overlay","inv","dropped","StatewireCore","ReturnType","createStatewireCore","getOptions","value","source","overlays","updates","events","pendingChanged","canonical","published","overlayPaths","notifiedPublished","notifiedOverlayPaths","notifiedConnection","stale","overlaysDirty","flushing","disposed","listeners","Set","post","scheduled","flush","schedule","markStale","drainCanonical","push","takeChanged","root","state","recompute","prevCanonical","optimistic","next","paths","undefined","overlay","ctx","ts","seq","clientId","recorded","draft","method","params","changedPaths","console","getConnection","connection","options","stateChanged","prev","changed","onStateChange","changes","length","batch","update","onCommandChange","event","onEvent","connectionChanged","listener","note","extra","result","commandsListener","onStart","onPosted","onAck","onCovered","some","o","filter","onSettle","outcome","type","payload","eventSink","attach","nextSource","setOnChange","commands","setListener","emit","setSink","detach","memo","Map","Promise","Proxy","get","_target","fn","reject","send","Record","args","promise","set","dispose","getState","subscribe","add","delete"],"sources":["../../src/client/core.ts"],"sourcesContent":["import { createChanges } from \"./changes\";\nimport { getCommandsHost, getEmitHost, getStateHost } from \"../host/host\";\nimport type { CommandsInvocation, CommandsListener } from \"../host/host\";\nimport { recordMutations } from \"./optimistic\";\nimport type { StatewirePath } from \"../wire/ops\";\nimport { StatewireSendError } from \"../types\";\nimport type {\n  SendFailure as StatewireSendFailure,\n  StatewireStateSource,\n  StatewireTransport,\n  StatewireCommand,\n  StatewireCommandsProxy,\n  StatewireCommandUpdate,\n  StatewireOptimisticContext,\n  StatewireOptions,\n} from \"../types\";\nimport type { StatewireConnection } from \"../transports/sse\";\n\nexport const LIVE_CONNECTION: StatewireConnection = {\n  status: \"live\",\n  reconnect: () => {},\n};\n\nconst failureOf = (error: unknown): StatewireSendFailure =>\n  error instanceof StatewireSendError\n    ? error.failure\n    : {\n        fate: \"rejected\",\n        cause: \"server\",\n        message: error instanceof Error ? error.message : String(error),\n      };\n\n// MessageChannel schedules the flush as a macrotask (tap's pattern): it runs\n// after the whole microtask drain, so every producer in the current turn\n// coalesces. The port is ref'd only while a flush is pending — an active\n// MessagePort holds the Node event loop open. ref/unref are Node-only.\nconst createMacrotaskPoster = (callback: () => void): (() => void) => {\n  if (typeof MessageChannel !== \"undefined\") {\n    let port1: (MessagePort & { ref?: () => void; unref?: () => void }) | null =\n      null;\n    let port2: MessagePort;\n    return () => {\n      if (!port1) {\n        const channel = new MessageChannel();\n        channel.port1.onmessage = () => {\n          port1?.unref?.();\n          callback();\n        };\n        port1 = channel.port1;\n        port2 = channel.port2;\n      }\n      port1.ref?.();\n      port2!.postMessage(null);\n    };\n  }\n  return () => setTimeout(callback, 0);\n};\n\ntype Overlay = { inv: CommandsInvocation; dropped: boolean };\n\nexport type StatewireCore = ReturnType<typeof createStatewireCore>;\n\nexport const createStatewireCore = (\n  getOptions: () => StatewireOptions<any, any, any>,\n) => {\n  let value: StatewireTransport<unknown> | null = null;\n  let source: StatewireStateSource | null = null;\n  let overlays: Overlay[] = [];\n  let updates: StatewireCommandUpdate[] = [];\n  let events: unknown[] = [];\n  let pendingChanged: StatewirePath[] = [];\n  let canonical: unknown;\n  let published: unknown;\n  let overlayPaths: readonly StatewirePath[] = [];\n  let notifiedPublished: unknown;\n  let notifiedOverlayPaths: readonly StatewirePath[] = [];\n  let notifiedConnection: StatewireConnection | null = null;\n  let stale = false;\n  let overlaysDirty = false;\n  let flushing = false;\n  let disposed = false;\n  const listeners = new Set<() => void>();\n\n  const post = createMacrotaskPoster(() => {\n    scheduled = false;\n    flush();\n  });\n  let scheduled = false;\n  const schedule = () => {\n    if (scheduled || disposed) return;\n    scheduled = true;\n    post();\n  };\n\n  const markStale = () => {\n    stale = true;\n    schedule();\n  };\n\n  const drainCanonical = () => {\n    if (source) {\n      pendingChanged.push(...source.takeChanged());\n      canonical = source.root();\n    } else if (value && value.state !== canonical) {\n      pendingChanged.push([]);\n      canonical = value.state;\n    }\n  };\n\n  const recompute = () => {\n    if (!stale || !value) return;\n    stale = false;\n    const prevCanonical = canonical;\n    drainCanonical();\n    if (canonical === prevCanonical && !overlaysDirty) return;\n    overlaysDirty = false;\n    const { optimistic } = getOptions();\n    let next = canonical;\n    let paths: readonly StatewirePath[] = [];\n    if (optimistic && canonical !== undefined) {\n      for (const overlay of overlays) {\n        if (overlay.dropped) continue;\n        const { inv } = overlay;\n        const ctx: StatewireOptimisticContext = {\n          ts: inv.ts,\n          seq: inv.seq,\n          ...(inv.clientId !== undefined && { clientId: inv.clientId }),\n        };\n        try {\n          const recorded = recordMutations(next, (draft) =>\n            optimistic(\n              draft as never,\n              { method: inv.method, params: inv.params } as StatewireCommand,\n              ctx,\n            ),\n          );\n          next = recorded.state;\n          paths = [...paths, ...recorded.changedPaths];\n        } catch (error) {\n          overlay.dropped = true;\n          console.error(\n            `statewire: optimistic reducer threw for \"${inv.method}\"; dropping its optimistic update`,\n            error,\n          );\n        }\n      }\n    }\n    published = next;\n    overlayPaths = paths;\n  };\n\n  const getConnection = (): StatewireConnection =>\n    value?.connection ?? LIVE_CONNECTION;\n\n  const flush = () => {\n    if (disposed || !value) return;\n    if (flushing) {\n      schedule();\n      return;\n    }\n    flushing = true;\n    try {\n      recompute();\n      const options = getOptions();\n      const stateChanged = published !== notifiedPublished;\n      if (stateChanged) {\n        const prev = notifiedPublished;\n        const changed = [\n          ...pendingChanged,\n          ...notifiedOverlayPaths,\n          ...overlayPaths,\n        ];\n        pendingChanged = [];\n        notifiedPublished = published;\n        notifiedOverlayPaths = overlayPaths;\n        options.onStateChange?.(published as never, {\n          changes: createChanges(prev, published, changed),\n        });\n      }\n      if (updates.length > 0 && published !== undefined) {\n        const batch = updates;\n        updates = [];\n        for (const update of batch) {\n          options.onCommandChange?.(update, { state: published as never });\n        }\n      }\n      if (events.length > 0) {\n        const batch = events;\n        events = [];\n        for (const event of batch) {\n          options.onEvent?.(event, { state: published as never });\n        }\n      }\n      const connection = getConnection();\n      const connectionChanged = connection !== notifiedConnection;\n      notifiedConnection = connection;\n      if (stateChanged || connectionChanged) {\n        for (const listener of [...listeners]) listener();\n      }\n    } finally {\n      flushing = false;\n    }\n  };\n\n  const note = (\n    inv: CommandsInvocation,\n    status: StatewireCommandUpdate[\"status\"],\n    extra?: { result?: unknown; failure?: StatewireSendFailure },\n  ) => {\n    if (!getOptions().onCommandChange) return;\n    updates.push({\n      method: inv.method,\n      params: inv.params as never[],\n      seq: inv.seq,\n      status,\n      ...extra,\n    });\n    schedule();\n  };\n\n  const commandsListener: CommandsListener = {\n    onStart: (inv) => {\n      overlays.push({ inv, dropped: false });\n      overlaysDirty = true;\n      markStale();\n      note(inv, \"queued\");\n    },\n    onPosted: (inv) => note(inv, \"posted\"),\n    onAck: (inv) => note(inv, \"acked\"),\n    onCovered: (inv) => {\n      if (!overlays.some((o) => o.inv === inv)) return;\n      overlays = overlays.filter((o) => o.inv !== inv);\n      overlaysDirty = true;\n      markStale();\n    },\n    onSettle: (inv, outcome) => {\n      note(\n        inv,\n        \"settled\",\n        outcome.type === \"accepted\"\n          ? { result: outcome.payload }\n          : { failure: failureOf(outcome.error) },\n      );\n      flush();\n    },\n  };\n\n  const eventSink = (event: unknown) => {\n    if (!getOptions().onEvent) return;\n    events.push(event);\n    schedule();\n  };\n\n  const attach = (next: StatewireTransport<unknown>) => {\n    if (disposed || next === value) return;\n    const prev = value;\n    value = next;\n    const nextSource =\n      next.source ??\n      (typeof next.state === \"object\" && next.state !== null\n        ? getStateHost(next.state)\n        : undefined) ??\n      null;\n    if (nextSource !== source) {\n      source?.setOnChange(null);\n      source = nextSource;\n      source?.setOnChange(markStale);\n      markStale();\n    }\n    if (next.commands !== prev?.commands) {\n      if (prev) getCommandsHost(prev.commands)?.setListener(null);\n      getCommandsHost(next.commands)?.setListener(commandsListener);\n      if (overlays.length > 0) {\n        overlays = [];\n        overlaysDirty = true;\n      }\n      markStale();\n    }\n    if (next.emit !== prev?.emit) {\n      if (prev) getEmitHost(prev.emit)?.setSink(null);\n      getEmitHost(next.emit)?.setSink(eventSink);\n    }\n    if (!source) markStale();\n    schedule();\n  };\n\n  const detach = () => {\n    source?.setOnChange(null);\n    source = null;\n    if (value) {\n      getCommandsHost(value.commands)?.setListener(null);\n      getEmitHost(value.emit)?.setSink(null);\n      value = null;\n    }\n  };\n\n  const memo = new Map<string, (...params: unknown[]) => Promise<unknown>>();\n  const commands = new Proxy({} as StatewireCommandsProxy<any>, {\n    get: (_target, method) => {\n      if (typeof method !== \"string\") return undefined;\n      let fn = memo.get(method);\n      if (fn === undefined) {\n        fn = (...params: unknown[]) => {\n          if (!value) {\n            return Promise.reject(\n              new StatewireSendError({ fate: \"aborted\", cause: \"unmount\" }),\n            );\n          }\n          const send = (\n            value.commands as Record<\n              string,\n              (...args: unknown[]) => Promise<unknown>\n            >\n          )[method]!;\n          const promise = send(...params);\n          flush();\n          return promise;\n        };\n        memo.set(method, fn);\n      }\n      return fn;\n    },\n  });\n\n  return {\n    attach,\n    detach,\n    dispose: () => {\n      detach();\n      disposed = true;\n    },\n    getState: () => {\n      recompute();\n      return published;\n    },\n    getConnection,\n    commands,\n    flush,\n    subscribe: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"core.js","names":["useEffect","useState","createChanges","getCommandsHost","getEmitHost","getStateHost","CommandsInvocation","CommandsListener","recordMutations","createMacrotaskPoster","createMethodProxy","StatewirePath","StatewireSendError","Statewire","StatewireClient","LIVE_CONNECTION","Connection","status","reconnect","failureOf","error","SendFailure","failure","fate","cause","message","Error","String","Overlay","inv","dropped","createCore","getOptions","Options","value","source","StateSource","overlays","updates","CommandUpdate","events","pendingChanged","canonical","published","overlayPaths","notifiedPublished","notifiedOverlayPaths","notifiedConnection","stale","overlaysDirty","flushing","listeners","Set","post","scheduled","flush","schedule","markStale","drainCanonical","push","takeChanged","snapshot","state","recompute","prevCanonical","optimistic","next","paths","undefined","overlay","ctx","OptimisticContext","ts","seq","clientId","recorded","draft","method","params","Command","changedPaths","console","getConnection","connection","options","stateChanged","prev","changed","onStateChange","changes","length","batch","update","onCommandChange","event","onEvent","connectionChanged","listener","note","extra","result","commandsListener","onStart","onPosted","onAck","onCovered","some","o","filter","onSettle","outcome","type","payload","eventSink","attach","nextSource","setOnChange","commands","setListener","emit","setSink","detach","CommandsProxy","Promise","reject","send","Record","args","promise","getState","subscribe","add","delete","useStatewireCore","$","_c","t0","core","t1","t2","t3"],"sources":["../../src/client/core.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { createChanges } from \"./changes\";\nimport { getCommandsHost, getEmitHost, getStateHost } from \"../host/host\";\nimport type { CommandsInvocation, CommandsListener } from \"../host/host\";\nimport { recordMutations } from \"../util/recordMutations\";\nimport { createMacrotaskPoster } from \"../util/macrotask\";\nimport { createMethodProxy } from \"../util/methodProxy\";\nimport type { StatewirePath } from \"../wire/ops\";\nimport { StatewireSendError } from \"../types\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\n\nexport const LIVE_CONNECTION: StatewireClient.Connection = {\n  status: \"live\",\n  reconnect: () => {},\n};\n\nconst failureOf = (error: unknown): StatewireClient.SendFailure =>\n  error instanceof StatewireSendError\n    ? error.failure\n    : {\n        fate: \"rejected\",\n        cause: \"server\",\n        message: error instanceof Error ? error.message : String(error),\n      };\n\ntype Overlay = { inv: CommandsInvocation; dropped: boolean };\n\nconst createCore = (\n  getOptions: () => StatewireClient.Options<any, any, any>,\n) => {\n  let value: Statewire<unknown> | null = null;\n  let source: Statewire.StateSource | null = null;\n  let overlays: Overlay[] = [];\n  let updates: Statewire.CommandUpdate[] = [];\n  let events: unknown[] = [];\n  let pendingChanged: StatewirePath[] = [];\n  let canonical: unknown;\n  let published: unknown;\n  let overlayPaths: readonly StatewirePath[] = [];\n  let notifiedPublished: unknown;\n  let notifiedOverlayPaths: readonly StatewirePath[] = [];\n  let notifiedConnection: StatewireClient.Connection | null = null;\n  let stale = false;\n  let overlaysDirty = false;\n  let flushing = false;\n  const listeners = new Set<() => void>();\n\n  const post = createMacrotaskPoster(() => {\n    scheduled = false;\n    flush();\n  });\n  let scheduled = false;\n  const schedule = () => {\n    if (scheduled) return;\n    scheduled = true;\n    post();\n  };\n\n  const markStale = () => {\n    stale = true;\n    schedule();\n  };\n\n  const drainCanonical = () => {\n    if (source) {\n      pendingChanged.push(...source.takeChanged());\n      canonical = source.snapshot();\n    } else if (value && value.state !== canonical) {\n      pendingChanged.push([]);\n      canonical = value.state;\n    }\n  };\n\n  const recompute = () => {\n    if (!stale || !value) return;\n    stale = false;\n    const prevCanonical = canonical;\n    drainCanonical();\n    if (canonical === prevCanonical && !overlaysDirty) return;\n    overlaysDirty = false;\n    const { optimistic } = getOptions();\n    let next = canonical;\n    let paths: readonly StatewirePath[] = [];\n    if (optimistic && canonical !== undefined) {\n      for (const overlay of overlays) {\n        if (overlay.dropped) continue;\n        const { inv } = overlay;\n        const ctx: StatewireClient.OptimisticContext = {\n          ts: inv.ts,\n          seq: inv.seq,\n          ...(inv.clientId !== undefined && { clientId: inv.clientId }),\n        };\n        try {\n          const recorded = recordMutations(next, (draft) =>\n            optimistic(\n              draft as never,\n              { method: inv.method, params: inv.params } as Statewire.Command,\n              ctx,\n            ),\n          );\n          next = recorded.state;\n          paths = [...paths, ...recorded.changedPaths];\n        } catch (error) {\n          overlay.dropped = true;\n          console.error(\n            `statewire: optimistic reducer threw for \"${inv.method}\"; dropping its optimistic update`,\n            error,\n          );\n        }\n      }\n    }\n    published = next;\n    overlayPaths = paths;\n  };\n\n  const getConnection = (): StatewireClient.Connection =>\n    value?.connection ?? LIVE_CONNECTION;\n\n  const flush = () => {\n    if (!value) return;\n    if (flushing) {\n      schedule();\n      return;\n    }\n    flushing = true;\n    try {\n      recompute();\n      const options = getOptions();\n      const stateChanged = published !== notifiedPublished;\n      if (stateChanged) {\n        const prev = notifiedPublished;\n        const changed = [\n          ...pendingChanged,\n          ...notifiedOverlayPaths,\n          ...overlayPaths,\n        ];\n        pendingChanged = [];\n        notifiedPublished = published;\n        notifiedOverlayPaths = overlayPaths;\n        options.onStateChange?.(published as never, {\n          changes: createChanges(prev, published, changed),\n        });\n      }\n      if (updates.length > 0 && published !== undefined) {\n        const batch = updates;\n        updates = [];\n        for (const update of batch) {\n          options.onCommandChange?.(update, { state: published as never });\n        }\n      }\n      if (events.length > 0 && published !== undefined) {\n        const batch = events;\n        events = [];\n        for (const event of batch) {\n          options.onEvent?.(event, { state: published as never });\n        }\n      }\n      const connection = getConnection();\n      const connectionChanged = connection !== notifiedConnection;\n      notifiedConnection = connection;\n      if (stateChanged || connectionChanged) {\n        for (const listener of [...listeners]) listener();\n      }\n    } finally {\n      flushing = false;\n    }\n  };\n\n  const note = (\n    inv: CommandsInvocation,\n    status: Statewire.CommandUpdate[\"status\"],\n    extra?: { result?: unknown; failure?: StatewireClient.SendFailure },\n  ) => {\n    if (!getOptions().onCommandChange) return;\n    updates.push({\n      method: inv.method,\n      params: inv.params as never[],\n      seq: inv.seq,\n      status,\n      ...extra,\n    });\n    schedule();\n  };\n\n  const commandsListener: CommandsListener = {\n    onStart: (inv) => {\n      overlays.push({ inv, dropped: false });\n      overlaysDirty = true;\n      markStale();\n      note(inv, \"queued\");\n    },\n    onPosted: (inv) => note(inv, \"posted\"),\n    onAck: (inv) => note(inv, \"acked\"),\n    onCovered: (inv) => {\n      if (!overlays.some((o) => o.inv === inv)) return;\n      overlays = overlays.filter((o) => o.inv !== inv);\n      overlaysDirty = true;\n      markStale();\n    },\n    onSettle: (inv, outcome) => {\n      note(\n        inv,\n        \"settled\",\n        outcome.type === \"accepted\"\n          ? { result: outcome.payload }\n          : { failure: failureOf(outcome.error) },\n      );\n      flush();\n    },\n  };\n\n  const eventSink = (event: unknown) => {\n    if (!getOptions().onEvent) return;\n    events.push(event);\n    schedule();\n  };\n\n  const attach = (next: Statewire<unknown>) => {\n    if (next === value) return;\n    const prev = value;\n    value = next;\n    const nextSource =\n      next.source ??\n      (typeof next.state === \"object\" && next.state !== null\n        ? getStateHost(next.state)\n        : undefined) ??\n      null;\n    if (nextSource !== source) {\n      source?.setOnChange(null);\n      source = nextSource;\n      source?.setOnChange(markStale);\n      markStale();\n    }\n    if (next.commands !== prev?.commands) {\n      if (prev) getCommandsHost(prev.commands)?.setListener(null);\n      getCommandsHost(next.commands)?.setListener(commandsListener);\n      if (overlays.length > 0) {\n        overlays = [];\n        overlaysDirty = true;\n      }\n      markStale();\n    }\n    if (next.emit !== prev?.emit) {\n      if (prev) getEmitHost(prev.emit)?.setSink(null);\n      getEmitHost(next.emit)?.setSink(eventSink);\n    }\n    if (!source) markStale();\n    schedule();\n  };\n\n  const detach = () => {\n    source?.setOnChange(null);\n    source = null;\n    if (value) {\n      getCommandsHost(value.commands)?.setListener(null);\n      getEmitHost(value.emit)?.setSink(null);\n      value = null;\n    }\n  };\n\n  const commands = createMethodProxy<Statewire.CommandsProxy<any>>(\n    (method, params) => {\n      if (!value) {\n        return Promise.reject(\n          new StatewireSendError({ fate: \"aborted\", cause: \"unmount\" }),\n        );\n      }\n      const send = (\n        value.commands as Record<\n          string,\n          (...args: unknown[]) => Promise<unknown>\n        >\n      )[method]!;\n      const promise = send(...params);\n      flush();\n      return promise;\n    },\n  );\n\n  return {\n    attach,\n    detach,\n    getState: () => {\n      recompute();\n      return published;\n    },\n    commands,\n    subscribe: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n};\n\nexport const useStatewireCore = (\n  getOptions: () => StatewireClient.Options<any, any, any>,\n  value: Statewire<unknown>,\n) => {\n  const [core] = useState(() => createCore(getOptions));\n  // Attach during render so the first snapshot reads the transport's state;\n  // re-attaching the same transport is a no-op and the single-slot host\n  // listeners make a swap land on the last writer.\n  core.attach(value);\n  useEffect(() => {\n    core.attach(value);\n  });\n  useEffect(() => () => core.detach(), [core]);\n  return core;\n};\n"],"mappings":"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"}

package/dist/client/session.d.ts

@@ -1,13 +1,9 @@
-import { StatewirePath } from "../wire/ops.js";
-import { StatewireResponse } from "./connection.js";
-import { StatewireSessionRecord, StatewireSessionStore } from "./sessionStore.js";
-import { RemoteLink, StatewireWireCommand } from "../transports/sse.js";
-import { StatewireSendError, StatewireStateSource } from "../types.js";
 import { CommandsInvocation, CommandsListener } from "../host/host.js";
+import { RemoteLink, StatewireRemoteProps, StatewireWireCommand } from "../transports/sse.js";
+import { StatewireSessionRecord, StatewireSessionStore, StatewireSessionStoreOptions } from "./sessionStore.js";
+import { Statewire, StatewireSendError } from "../types.js";
+import { StatewirePath } from "../wire/ops.js";
 //#region src/client/session.d.ts
-type SessionOptions = {
-  sessionStore?: StatewireSessionStore | undefined;
-};
 /**
  * queued/trying/posted: overlay live, result pending. awaiting-result: acked
  * (overlay gone) but the result rides a late res; `posted: false` re-sends.
@@ -39,7 +35,8 @@ type PendingState = {
 type Pending = {
   readonly seq: number;
   readonly command: StatewireWireCommand;
-  readonly inv: CommandsInvocation;
+  /** null for context submissions — they carry no command lifecycle. */
+  readonly inv: CommandsInvocation | null;
   state: PendingState;
   resolve: (payload: unknown) => void;
   reject: (error: StatewireSendError) => void;
@@ -47,14 +44,16 @@ type Pending = {
 type AttachState = "detached" | "attached" | "finished";
 type Session = {
   record: StatewireSessionRecord;
+  ctx: StatewireRemoteProps;
   recordPersisted: boolean;
   store: StatewireSessionStore;
   lastAck: number;
+  context: Record<string, unknown> | undefined;
   pending: Pending[];
   canonical: unknown;
   lastPublished: unknown;
   changed: StatewirePath[];
-  source: StatewireStateSource;
+  source: Statewire.StateSource;
   attach: AttachState;
   attachEpoch: number;
   running: boolean;
@@ -67,22 +66,9 @@ type Session = {
   send: (command: StatewireWireCommand) => Promise<unknown>;
   commands: Record<string, (...params: unknown[]) => Promise<unknown>>;
 };
-declare const createSession: (options: SessionOptions) => Session;
-declare const handleSnapshot: (s: Session, { ops, lastSeq }: {
-  ops: unknown[];
-  lastSeq: number;
-}) => void;
-declare const handleOps: (s: Session, { ops, res, ack }: {
-  ops: unknown[];
-  res?: StatewireResponse[];
-  ack?: number;
-}) => void;
-declare const handleFinish: (s: Session, { reason }: {
-  reason: string;
-}) => void;
-declare const start: (s: Session) => void;
-declare const stop: (s: Session) => void;
 declare const setTransport: (s: Session, transport: RemoteLink) => void;
+declare const setContext: (s: Session, value: Record<string, unknown>) => Promise<unknown>;
+declare const useStatewireSession: (options: StatewireSessionStoreOptions, emit: (event: unknown) => void) => Session;
 //#endregion
-export { SessionOptions, createSession, handleFinish, handleOps, handleSnapshot, setTransport, start, stop };
+export { setContext, setTransport, useStatewireSession };
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","names":[],"sources":["../../src/client/session.ts"],"mappings":";;;;;;;KAoBY;EACV,eAAe;;;;;;;;KASZ;EACC;EAAc;;EACd;EAAc;EAAwB;;EACtC;EAAc;EAAwB;;EACtC;EAAuB;EAAiB;;EACxC;EAAoB;EAAiB;;EACrC;;KAED;WACM;WACA,SAAS;WACT,KAAK;EACd,OAAO;EACP,UAAU;EACV,SAAS,OAAO;;KAyFb;KAEA;EACH,QAAQ;EACR;EACA,OAAO;EACP;EACA,SAAS;EACT;EACA;EACA,SAAS;EACT,QAAQ;EACR,QAAQ;EACR;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;EACX;EACA,YAAY;EACZ,OAAO,SAAS,yBAAyB;EACzC,UAAU,mBAAmB,sBAAsB;;cAoB/C,gBAAiB,SAAS,mBAAiB;cA0N3C,iBACJ,GAAG,WACH,KAAA;EAAoB;EAAgB;;cAuChC,YACJ,GAAG,WACH,KAAA,KAAA;EAIK;EAAgB,MAAM;EAAqB;;cAoB5C,eAAgB,GAAG,WAAS;EAAc;;cAuJ1C,QAAS,GAAG;cASZ,OAAQ,GAAG;cAMX,eAAgB,GAAG,SAAS,WAAW"}
+{"version":3,"file":"session.d.ts","names":[],"sources":["../../src/client/session.ts"],"mappings":";;;;;;;;;;;;KA+BK;EACC;EAAc;;EACd;EAAc;EAAwB;;EACtC;EAAc;EAAwB;;EACtC;EAAuB;EAAiB;;EACxC;EAAoB;EAAiB;;EACrC;;KAED;WACM;WACA,SAAS;;WAET,KAAK;EACd,OAAO;EACP,UAAU;EACV,SAAS,OAAO;;KAqGb;KAEA;EACH,QAAQ;EACR,KAAK;EACL;EACA,OAAO;EACP;EACA,SAAS;EACT,SAAS;EACT;EACA;EACA,SAAS;EACT,QAAQ,UAAU;EAClB,QAAQ;EACR;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;EACX;EACA,YAAY;EACZ,OAAO,SAAS,yBAAyB;EACzC,UAAU,mBAAmB,sBAAsB;;cAsd/C,eAAgB,GAAG,SAAS,WAAW;cA+CvC,aACJ,GAAG,SACH,OAAO,4BACN;cAQU,sBACX,SAAS,8BACT,OAAO,4BACN"}

package/dist/client/session.js

@@ -1,11 +1,18 @@
 import { applyOps } from "../wire/ops.js";
+import { createMethodProxy } from "../util/methodProxy.js";
 import { StatewireSendError } from "../types.js";
 import { bindCommandsHost } from "../host/host.js";
-import { backoff } from "./timing.js";
+import { randomId } from "../util/randomId.js";
+import { retryDelay } from "./timing.js";
 import { createMemorySessionStore } from "./sessionStore.js";
+import { useEffect, useState } from "@assistant-ui/tap/react-shim";
 //#region src/client/session.ts
 const isResolved = (state) => state.at === "settled-live" || state.at === "done";
 const isStateSettled = (state) => state.at === "awaiting-result" || state.at === "done";
+const inFlight = (state) => {
+	if (state.at === "queued" || state.at === "done") throw new Error(`statewire: ${state.at} entry observed after a send`);
+	return state;
+};
 const legalTransitions = {
 	queued: [
 		"queued",
@@ -40,16 +47,16 @@ const transition = (s, entry, next, outcome) => {
 	if (settles && outcome === void 0) throw new Error(`statewire: settling transition ${prev.at} -> ${next.at} without an outcome`);
 	const covers = !isStateSettled(prev) && isStateSettled(next);
 	entry.state = next;
-	if (covers) s.lifecycle?.onCovered?.(entry.inv);
+	if (covers && entry.inv) s.lifecycle?.onCovered?.(entry.inv);
 	if (settles && outcome !== void 0) if (outcome.ok) {
 		entry.resolve(outcome.payload);
-		s.lifecycle?.onSettle(entry.inv, {
+		if (entry.inv) s.lifecycle?.onSettle(entry.inv, {
 			type: "accepted",
 			payload: outcome.payload
 		});
 	} else {
 		entry.reject(new StatewireSendError(outcome.failure));
-		s.lifecycle?.onSettle(entry.inv, {
+		if (entry.inv) s.lifecycle?.onSettle(entry.inv, {
 			type: "rejected",
 			error: new StatewireSendError(outcome.failure)
 		});
@@ -66,27 +73,12 @@ const carried = (state) => state.at === "queued" ? {
 	posted: state.posted,
 	failedAttempts: state.failedAttempts
 };
-const newClientId = () => `c-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+const newClientId = () => `c-${randomId()}`;
 const rejectedSend = (failure) => {
 	const result = Promise.reject(new StatewireSendError(failure));
 	result.catch(() => {});
 	return result;
 };
-const createCommandsProxy = (send) => {
-	const memo = /* @__PURE__ */ new Map();
-	return new Proxy({}, { get: (_target, method) => {
-		if (typeof method !== "string") return void 0;
-		let fn = memo.get(method);
-		if (fn === void 0) {
-			fn = (...params) => send({
-				method,
-				params
-			});
-			memo.set(method, fn);
-		}
-		return fn;
-	} });
-};
 const createSession = (options) => {
 	const store = options.sessionStore ?? createMemorySessionStore();
 	const stored = store.load();
@@ -95,15 +87,24 @@ const createSession = (options) => {
 			clientId: newClientId(),
 			nextSeq: 1
 		},
+		ctx: {
+			get clientId() {
+				return s.record.clientId;
+			},
+			onSnapshot: (args) => handleSnapshot(s, args),
+			onOps: (args) => handleOps(s, args),
+			onFinish: (args) => handleFinish(s, args)
+		},
 		recordPersisted: stored !== null,
 		store,
 		lastAck: -1,
+		context: void 0,
 		pending: [],
 		canonical: void 0,
 		lastPublished: void 0,
 		changed: [],
 		source: {
-			root: () => s.canonical,
+			snapshot: () => s.canonical,
 			takeChanged: () => {
 				const changed = s.changed;
 				s.changed = [];
@@ -123,7 +124,10 @@ const createSession = (options) => {
 		notify: () => {},
 		emitEvent: () => {},
 		send: (command) => sendCommand(s, command),
-		commands: createCommandsProxy((command) => s.send(command))
+		commands: createMethodProxy((method, params) => s.send({
+			method,
+			params
+		}))
 	};
 	bindCommandsHost(s.commands, { setListener: (listener) => {
 		s.lifecycle = listener;
@@ -141,6 +145,17 @@ const wake = (s) => {
 	for (const waiter of waiters) waiter();
 };
 const waitForWake = (s) => new Promise((r) => s.waiters.push(r));
+const sleepUntilWake = (s, delayMs) => new Promise((resolve) => {
+	const waiter = () => {
+		clearTimeout(timer);
+		resolve();
+	};
+	const timer = setTimeout(() => {
+		s.waiters = s.waiters.filter((w) => w !== waiter);
+		resolve();
+	}, delayMs);
+	s.waiters.push(waiter);
+});
 const settleAll = (s, detach, verdict) => {
 	const cause = {
 		evicted: "session-lost",
@@ -180,13 +195,14 @@ const evict = (s, verdict) => {
 	};
 	s.store.save(s.record);
 	s.attach = "detached";
+	if (s.context !== void 0) s.send({ context: s.context });
 	publish(s);
 	wake(s);
 };
 const noteAcked = (s, seq) => {
 	for (const entry of s.pending) {
 		if (entry.seq > seq || isStateSettled(entry.state)) continue;
-		s.lifecycle?.onAck(entry.inv);
+		if (entry.inv) s.lifecycle?.onAck(entry.inv);
 	}
 };
 const spliceAcked = (s, seq, settleVoid) => {
@@ -238,11 +254,11 @@ const applyResponse = (s, response) => {
 				} : response.code === "invalid-params" ? {
 					fate: "invalid-params",
 					cause: "server",
-					message: response.message ?? ""
+					message: response.message ?? protocolError("rejected response missing message")
 				} : {
 					fate: "rejected",
 					cause: "server",
-					message: response.message ?? "",
+					message: response.message ?? protocolError("rejected response missing message"),
 					...response.payload !== void 0 && { payload: response.payload }
 				}
 			});
@@ -271,7 +287,7 @@ const ingestOps = (s, ops) => {
 };
 const publishIngested = (s, events) => {
 	publish(s);
-	for (const { event } of events) s.emitEvent(event);
+	for (const event of events) s.emitEvent(event);
 	wake(s);
 };
 const handleSnapshot = (s, { ops, lastSeq }) => {
@@ -327,7 +343,7 @@ const handleOps = (s, { ops, res, ack }) => {
 	publishIngested(s, events);
 };
 const handleFinish = (s, { reason }) => {
-	if (reason === "ended" || reason === "error") return;
+	if (reason === "evicted" || reason === "error") return;
 	s.attach = "finished";
 	settleAll(s, reason === "superseded" ? "superseded" : "gone");
 	publish(s);
@@ -363,15 +379,12 @@ const pump = async (s) => {
 			} catch (error) {
 				if (!s.running || isFinished(s)) return;
 				if (!s.pending.includes(entry)) continue;
-				const state = entry.state;
-				if (state.at === "queued" || state.at === "done") continue;
+				const state = inFlight(entry.state);
 				transition(s, entry, {
 					...state,
 					failedAttempts: state.failedAttempts + 1
 				});
-				const { retryAfterMs } = error;
-				const delay = typeof retryAfterMs === "number" ? retryAfterMs : backoff(state.failedAttempts + 1);
-				await new Promise((r) => setTimeout(r, delay));
+				await sleepUntilWake(s, retryDelay(error, state.failedAttempts + 1));
 				continue;
 			}
 			if (!s.running) return;
@@ -388,20 +401,18 @@ const pump = async (s) => {
 					...state,
 					posted: true
 				});
-				s.lifecycle?.onPosted?.(entry.inv);
+				if (entry.inv) s.lifecycle?.onPosted?.(entry.inv);
 				if (response !== void 0) {
 					applyResponse(s, response);
 					publish(s);
 				}
 			} else if (result.type === "rejected") {
-				const { message, payload } = result;
 				transition(s, entry, { at: "done" }, {
 					ok: false,
 					failure: {
 						fate: "rejected",
 						cause: "server",
-						message,
-						...payload !== void 0 && { payload }
+						message: result.message
 					}
 				});
 				publish(s);
@@ -420,13 +431,10 @@ const pump = async (s) => {
 			} else if (result.type === "seq-gap") {
 				if (clientId === s.record.clientId) {
 					console.error(`statewire: server reports a seq gap for seq ${entry.seq}; treating the session as corrupt and rotating the client id`);
-					const state = entry.state;
+					const state = inFlight(entry.state);
 					const failure = state.at === "awaiting-result" ? {
 						fate: "result-unavailable",
 						cause: "session-lost"
-					} : state.at === "queued" || state.at === "done" ? {
-						fate: "aborted",
-						cause: "session-lost"
 					} : {
 						fate: state.failedAttempts > 0 ? "lost" : "aborted",
 						cause: "session-lost"
@@ -479,7 +487,7 @@ const sendCommand = (s, command) => {
 	const entry = {
 		seq,
 		command,
-		inv: {
+		inv: command.method === void 0 ? null : {
 			method: command.method,
 			params: command.params,
 			ts: Date.now(),
@@ -499,11 +507,30 @@ const sendCommand = (s, command) => {
 	});
 	result.catch(() => {});
 	s.pending.push(entry);
-	s.lifecycle?.onStart(entry.inv);
+	if (entry.inv) s.lifecycle?.onStart(entry.inv);
 	pump(s);
 	return result;
 };
+const setContext = (s, value) => {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("statewire: context must be a plain object");
+	s.context = value;
+	return s.send({ context: value });
+};
+const useStatewireSession = (options, emit) => {
+	const [s] = useState(() => createSession(options));
+	useEffect(() => {
+		s.emitEvent = emit;
+		return () => {
+			s.emitEvent = () => {};
+		};
+	}, [s, emit]);
+	useEffect(() => {
+		start(s);
+		return () => stop(s);
+	}, [s]);
+	return s;
+};
 //#endregion
-export { createSession, handleFinish, handleOps, handleSnapshot, setTransport, start, stop };
+export { setContext, setTransport, useStatewireSession };
 
 //# sourceMappingURL=session.js.map