statewire 0.0.0-0 → 0.0.1

package/dist/client/core.js

@@ -0,0 +1,269 @@
+import { createChanges } from "./changes.js";
+import { recordMutations } from "./optimistic.js";
+import { StatewireSendError } from "../types.js";
+import { getCommandsHost, getEmitHost, getStateHost } from "../host/host.js";
+//#region src/client/core.ts
+const LIVE_CONNECTION = {
+	status: "live",
+	reconnect: () => {}
+};
+const failureOf = (error) => error instanceof StatewireSendError ? error.failure : {
+	fate: "rejected",
+	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) => {
+	let value = null;
+	let source = null;
+	let overlays = [];
+	let updates = [];
+	let events = [];
+	let pendingChanged = [];
+	let canonical;
+	let published;
+	let overlayPaths = [];
+	let notifiedPublished;
+	let notifiedOverlayPaths = [];
+	let notifiedConnection = null;
+	let stale = false;
+	let overlaysDirty = false;
+	let flushing = false;
+	let disposed = false;
+	const listeners = /* @__PURE__ */ new Set();
+	const post = createMacrotaskPoster(() => {
+		scheduled = false;
+		flush();
+	});
+	let scheduled = false;
+	const schedule = () => {
+		if (scheduled || disposed) return;
+		scheduled = true;
+		post();
+	};
+	const markStale = () => {
+		stale = true;
+		schedule();
+	};
+	const drainCanonical = () => {
+		if (source) {
+			pendingChanged.push(...source.takeChanged());
+			canonical = source.root();
+		} else if (value && value.state !== canonical) {
+			pendingChanged.push([]);
+			canonical = value.state;
+		}
+	};
+	const recompute = () => {
+		if (!stale || !value) return;
+		stale = false;
+		const prevCanonical = canonical;
+		drainCanonical();
+		if (canonical === prevCanonical && !overlaysDirty) return;
+		overlaysDirty = false;
+		const { optimistic } = getOptions();
+		let next = canonical;
+		let paths = [];
+		if (optimistic && canonical !== void 0) for (const overlay of overlays) {
+			if (overlay.dropped) continue;
+			const { inv } = overlay;
+			const ctx = {
+				ts: inv.ts,
+				seq: inv.seq,
+				...inv.clientId !== void 0 && { clientId: inv.clientId }
+			};
+			try {
+				const recorded = recordMutations(next, (draft) => optimistic(draft, {
+					method: inv.method,
+					params: inv.params
+				}, ctx));
+				next = recorded.state;
+				paths = [...paths, ...recorded.changedPaths];
+			} catch (error) {
+				overlay.dropped = true;
+				console.error(`statewire: optimistic reducer threw for "${inv.method}"; dropping its optimistic update`, error);
+			}
+		}
+		published = next;
+		overlayPaths = paths;
+	};
+	const getConnection = () => value?.connection ?? LIVE_CONNECTION;
+	const flush = () => {
+		if (disposed || !value) return;
+		if (flushing) {
+			schedule();
+			return;
+		}
+		flushing = true;
+		try {
+			recompute();
+			const options = getOptions();
+			const stateChanged = published !== notifiedPublished;
+			if (stateChanged) {
+				const prev = notifiedPublished;
+				const changed = [
+					...pendingChanged,
+					...notifiedOverlayPaths,
+					...overlayPaths
+				];
+				pendingChanged = [];
+				notifiedPublished = published;
+				notifiedOverlayPaths = overlayPaths;
+				options.onStateChange?.(published, { changes: createChanges(prev, published, changed) });
+			}
+			if (updates.length > 0 && published !== void 0) {
+				const batch = updates;
+				updates = [];
+				for (const update of batch) options.onCommandChange?.(update, { state: published });
+			}
+			if (events.length > 0) {
+				const batch = events;
+				events = [];
+				for (const event of batch) options.onEvent?.(event, { state: published });
+			}
+			const connection = getConnection();
+			const connectionChanged = connection !== notifiedConnection;
+			notifiedConnection = connection;
+			if (stateChanged || connectionChanged) for (const listener of [...listeners]) listener();
+		} finally {
+			flushing = false;
+		}
+	};
+	const note = (inv, status, extra) => {
+		if (!getOptions().onCommandChange) return;
+		updates.push({
+			method: inv.method,
+			params: inv.params,
+			seq: inv.seq,
+			status,
+			...extra
+		});
+		schedule();
+	};
+	const commandsListener = {
+		onStart: (inv) => {
+			overlays.push({
+				inv,
+				dropped: false
+			});
+			overlaysDirty = true;
+			markStale();
+			note(inv, "queued");
+		},
+		onPosted: (inv) => note(inv, "posted"),
+		onAck: (inv) => note(inv, "acked"),
+		onCovered: (inv) => {
+			if (!overlays.some((o) => o.inv === inv)) return;
+			overlays = overlays.filter((o) => o.inv !== inv);
+			overlaysDirty = true;
+			markStale();
+		},
+		onSettle: (inv, outcome) => {
+			note(inv, "settled", outcome.type === "accepted" ? { result: outcome.payload } : { failure: failureOf(outcome.error) });
+			flush();
+		}
+	};
+	const eventSink = (event) => {
+		if (!getOptions().onEvent) return;
+		events.push(event);
+		schedule();
+	};
+	const attach = (next) => {
+		if (disposed || 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;
+		if (nextSource !== source) {
+			source?.setOnChange(null);
+			source = nextSource;
+			source?.setOnChange(markStale);
+			markStale();
+		}
+		if (next.commands !== prev?.commands) {
+			if (prev) getCommandsHost(prev.commands)?.setListener(null);
+			getCommandsHost(next.commands)?.setListener(commandsListener);
+			if (overlays.length > 0) {
+				overlays = [];
+				overlaysDirty = true;
+			}
+			markStale();
+		}
+		if (next.emit !== prev?.emit) {
+			if (prev) getEmitHost(prev.emit)?.setSink(null);
+			getEmitHost(next.emit)?.setSink(eventSink);
+		}
+		if (!source) markStale();
+		schedule();
+	};
+	const detach = () => {
+		source?.setOnChange(null);
+		source = null;
+		if (value) {
+			getCommandsHost(value.commands)?.setListener(null);
+			getEmitHost(value.emit)?.setSink(null);
+			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,
+		subscribe: (listener) => {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+};
+//#endregion
+export { LIVE_CONNECTION, createStatewireCore };
+
+//# sourceMappingURL=core.js.map

package/dist/client/core.js.map

@@ -0,0 +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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"}

package/dist/client/optimistic.d.ts

@@ -0,0 +1,10 @@
+//#region src/client/optimistic.d.ts
+type PathKey = string | number;
+type Path = readonly PathKey[];
+declare const recordMutations: <T>(base: T, mutate: (draft: T) => void) => {
+  state: T;
+  changedPaths: Path[];
+};
+//#endregion
+export { recordMutations };
+//# sourceMappingURL=optimistic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.d.ts","names":[],"sources":["../../src/client/optimistic.ts"],"mappings":";KAAK;KACA,gBAAgB;cAuER,kBAAmB,GAC9B,MAAM,GACN,SAAS,OAAO;EACb,OAAO;EAAG,cAAc"}

package/dist/client/optimistic.js

@@ -0,0 +1,128 @@
+//#region src/client/optimistic.ts
+const DRAFT = Symbol("statewire.draft");
+const isDraftable = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	if (Array.isArray(value)) return true;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+};
+const nodeOf = (value) => typeof value === "object" && value !== null ? value[DRAFT] : void 0;
+const latest = (node) => node.copy ?? node.base;
+const prepareCopy = (node) => {
+	node.copy ??= node.isArray ? node.base.slice() : { ...node.base };
+};
+const markModified = (node) => {
+	for (let n = node; n && !n.modified; n = n.parent) n.modified = true;
+};
+const resolveAssigned = (container) => {
+	for (const key of Object.keys(container)) {
+		const value = container[key];
+		const child = nodeOf(value);
+		if (child) container[key] = finalize(child);
+		else if (isDraftable(value)) resolveAssigned(value);
+	}
+};
+const finalize = (node) => {
+	if (!node.modified) return node.base;
+	const result = node.copy;
+	for (const key of Object.keys(result)) {
+		const value = result[key];
+		const child = nodeOf(value);
+		if (child) result[key] = finalize(child);
+		else if (node.assigned?.has(key) && isDraftable(value)) resolveAssigned(value);
+	}
+	return result;
+};
+const recordMutations = (base, mutate) => {
+	if (!isDraftable(base)) return {
+		state: base,
+		changedPaths: []
+	};
+	const changedPaths = [];
+	const seen = /* @__PURE__ */ new Set();
+	const record = (path) => {
+		const key = path.join("\0");
+		if (seen.has(key)) return;
+		seen.add(key);
+		changedPaths.push(path);
+	};
+	const createNode = (value, parent, path) => {
+		const node = {
+			base: value,
+			copy: null,
+			modified: false,
+			isArray: Array.isArray(value),
+			parent,
+			path,
+			proxy: null,
+			assigned: null
+		};
+		const touched = (prop) => {
+			if (typeof prop !== "string") return;
+			record(node.isArray ? node.path : [...node.path, prop]);
+		};
+		node.proxy = new Proxy(value, {
+			get: (_target, prop) => {
+				if (prop === DRAFT) return node;
+				const current = latest(node)[prop];
+				if (typeof prop === "symbol") return current;
+				if (nodeOf(current)) return current;
+				if (isDraftable(current) && current === node.base[prop]) {
+					prepareCopy(node);
+					const child = createNode(current, node, [...path, node.isArray ? Number(prop) : prop]);
+					node.copy[prop] = child.proxy;
+					return child.proxy;
+				}
+				return current;
+			},
+			set: (_target, prop, next) => {
+				const source = latest(node);
+				if (Object.hasOwn(source, prop) && source[prop] === next) return true;
+				prepareCopy(node);
+				markModified(node);
+				touched(prop);
+				node.copy[prop] = next;
+				(node.assigned ??= /* @__PURE__ */ new Set()).add(prop);
+				return true;
+			},
+			deleteProperty: (_target, prop) => {
+				if (!Object.hasOwn(latest(node), prop)) return true;
+				prepareCopy(node);
+				markModified(node);
+				touched(prop);
+				delete node.copy[prop];
+				return true;
+			},
+			defineProperty: () => {
+				throw new Error("statewire: defineProperty is not supported inside a mutator");
+			},
+			setPrototypeOf: () => {
+				throw new Error("statewire: setPrototypeOf is not supported inside a mutator");
+			},
+			preventExtensions: () => {
+				throw new Error("statewire: preventExtensions is not supported inside a mutator");
+			},
+			has: (_target, prop) => prop === DRAFT || Reflect.has(latest(node), prop),
+			ownKeys: () => Reflect.ownKeys(latest(node)),
+			getOwnPropertyDescriptor: (_target, prop) => {
+				const desc = Reflect.getOwnPropertyDescriptor(latest(node), prop);
+				if (!desc) return void 0;
+				return {
+					...desc,
+					configurable: !node.isArray || prop !== "length"
+				};
+			}
+		});
+		return node;
+	};
+	const root = createNode(base, null, []);
+	mutate(root.proxy);
+	return {
+		state: finalize(root),
+		changedPaths
+	};
+};
+//#endregion
+export { recordMutations };
+
+//# sourceMappingURL=optimistic.js.map

package/dist/client/optimistic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.js","names":["PathKey","Path","DRAFT","Symbol","Node","base","Record","PropertyKey","copy","modified","isArray","parent","path","proxy","assigned","Set","isDraftable","value","Array","proto","Object","getPrototypeOf","prototype","nodeOf","undefined","latest","node","prepareCopy","slice","markModified","n","resolveAssigned","container","key","keys","child","finalize","result","has","recordMutations","T","mutate","draft","state","changedPaths","seen","record","join","add","push","createNode","touched","prop","Proxy","get","_target","current","Number","set","next","source","hasOwn","deleteProperty","defineProperty","Error","setPrototypeOf","preventExtensions","Reflect","ownKeys","getOwnPropertyDescriptor","desc","configurable","root"],"sources":["../../src/client/optimistic.ts"],"sourcesContent":["type PathKey = string | number;\ntype Path = readonly PathKey[];\n\nconst DRAFT = Symbol(\"statewire.draft\");\n\ntype Node = {\n  base: Record<PropertyKey, unknown>;\n  copy: Record<PropertyKey, unknown> | null;\n  modified: boolean;\n  isArray: boolean;\n  parent: Node | null;\n  path: Path;\n  proxy: unknown;\n  assigned: Set<PropertyKey> | null;\n};\n\nconst isDraftable = (value: unknown): value is object => {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (Array.isArray(value)) return true;\n  const proto: unknown = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nconst nodeOf = (value: unknown): Node | undefined =>\n  typeof value === \"object\" && value !== null\n    ? (value as { [DRAFT]?: Node })[DRAFT]\n    : undefined;\n\nconst latest = (node: Node) => node.copy ?? node.base;\n\nconst prepareCopy = (node: Node) => {\n  node.copy ??= node.isArray\n    ? ((node.base as unknown as unknown[]).slice() as unknown as Record<\n        PropertyKey,\n        unknown\n      >)\n    : { ...node.base };\n};\n\nconst markModified = (node: Node) => {\n  for (let n: Node | null = node; n && !n.modified; n = n.parent) {\n    n.modified = true;\n  }\n};\n\nconst resolveAssigned = (container: object) => {\n  for (const key of Object.keys(container)) {\n    const value = (container as Record<string, unknown>)[key];\n    const child = nodeOf(value);\n    if (child) {\n      (container as Record<string, unknown>)[key] = finalize(child);\n    } else if (isDraftable(value)) {\n      resolveAssigned(value);\n    }\n  }\n};\n\nconst finalize = (node: Node): unknown => {\n  if (!node.modified) return node.base;\n  const result = node.copy!;\n  for (const key of Object.keys(result)) {\n    const value = result[key];\n    const child = nodeOf(value);\n    if (child) {\n      result[key] = finalize(child);\n    } else if (node.assigned?.has(key) && isDraftable(value)) {\n      resolveAssigned(value);\n    }\n  }\n  return result;\n};\n\nexport const recordMutations = <T>(\n  base: T,\n  mutate: (draft: T) => void,\n): { state: T; changedPaths: Path[] } => {\n  if (!isDraftable(base)) return { state: base, changedPaths: [] };\n\n  const changedPaths: Path[] = [];\n  const seen = new Set<string>();\n  const record = (path: Path) => {\n    const key = path.join(\"\u0000\");\n    if (seen.has(key)) return;\n    seen.add(key);\n    changedPaths.push(path);\n  };\n\n  const createNode = (value: object, parent: Node | null, path: Path): Node => {\n    const node: Node = {\n      base: value as Record<PropertyKey, unknown>,\n      copy: null,\n      modified: false,\n      isArray: Array.isArray(value),\n      parent,\n      path,\n      proxy: null,\n      assigned: null,\n    };\n    const touched = (prop: PropertyKey) => {\n      if (typeof prop !== \"string\") return;\n      record(node.isArray ? node.path : [...node.path, prop]);\n    };\n    node.proxy = new Proxy(value, {\n      get: (_target, prop) => {\n        if (prop === DRAFT) return node;\n        const current = latest(node)[prop];\n        if (typeof prop === \"symbol\") return current;\n        if (nodeOf(current)) return current;\n        if (isDraftable(current) && current === node.base[prop]) {\n          prepareCopy(node);\n          const child = createNode(current, node, [\n            ...path,\n            node.isArray ? Number(prop) : prop,\n          ]);\n          node.copy![prop] = child.proxy;\n          return child.proxy;\n        }\n        return current;\n      },\n      set: (_target, prop, next) => {\n        const source = latest(node);\n        if (Object.hasOwn(source, prop) && source[prop] === next) return true;\n        prepareCopy(node);\n        markModified(node);\n        touched(prop);\n        node.copy![prop] = next;\n        (node.assigned ??= new Set()).add(prop);\n        return true;\n      },\n      deleteProperty: (_target, prop) => {\n        if (!Object.hasOwn(latest(node), prop)) return true;\n        prepareCopy(node);\n        markModified(node);\n        touched(prop);\n        delete node.copy![prop];\n        return true;\n      },\n      defineProperty: () => {\n        throw new Error(\n          \"statewire: defineProperty is not supported inside a mutator\",\n        );\n      },\n      setPrototypeOf: () => {\n        throw new Error(\n          \"statewire: setPrototypeOf is not supported inside a mutator\",\n        );\n      },\n      preventExtensions: () => {\n        throw new Error(\n          \"statewire: preventExtensions is not supported inside a mutator\",\n        );\n      },\n      has: (_target, prop) => prop === DRAFT || Reflect.has(latest(node), prop),\n      ownKeys: () => Reflect.ownKeys(latest(node)),\n      getOwnPropertyDescriptor: (_target, prop) => {\n        const desc = Reflect.getOwnPropertyDescriptor(latest(node), prop);\n        if (!desc) return undefined;\n        return {\n          ...desc,\n          configurable: !node.isArray || prop !== \"length\",\n        };\n      },\n    });\n    return node;\n  };\n\n  const root = createNode(base as unknown as object, null, []);\n  mutate(root.proxy as T);\n  return { state: finalize(root) as T, changedPaths };\n};\n"],"mappings":"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"}

package/dist/client/session.d.ts

@@ -0,0 +1,88 @@
+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";
+//#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.
+ * settled-live: result settled but the overlay stays until the covering ack.
+ * done: removed from the queue.
+ */
+type PendingState = {
+  at: "queued";
+  pendingMarked: boolean;
+} | {
+  at: "trying";
+  pendingMarked: boolean;
+  failedAttempts: number;
+} | {
+  at: "posted";
+  pendingMarked: boolean;
+  failedAttempts: number;
+} | {
+  at: "awaiting-result";
+  posted: boolean;
+  failedAttempts: number;
+} | {
+  at: "settled-live";
+  posted: boolean;
+  failedAttempts: number;
+} | {
+  at: "done";
+};
+type Pending = {
+  readonly seq: number;
+  readonly command: StatewireWireCommand;
+  readonly inv: CommandsInvocation;
+  state: PendingState;
+  resolve: (payload: unknown) => void;
+  reject: (error: StatewireSendError) => void;
+};
+type AttachState = "detached" | "attached" | "finished";
+type Session = {
+  record: StatewireSessionRecord;
+  recordPersisted: boolean;
+  store: StatewireSessionStore;
+  lastAck: number;
+  pending: Pending[];
+  canonical: unknown;
+  lastPublished: unknown;
+  changed: StatewirePath[];
+  source: StatewireStateSource;
+  attach: AttachState;
+  attachEpoch: number;
+  running: boolean;
+  pumping: boolean;
+  transport: RemoteLink | null;
+  waiters: (() => void)[];
+  lifecycle: CommandsListener | null;
+  notify: () => void;
+  emitEvent: (event: unknown) => void;
+  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;
+//#endregion
+export { SessionOptions, createSession, handleFinish, handleOps, handleSnapshot, setTransport, start, stop };
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +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"}