statewire 0.0.0-0 → 0.0.2

package/dist/client/core.js

@@ -0,0 +1,272 @@
+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",
+	reconnect: () => {}
+};
+const failureOf = (error) => error instanceof StatewireSendError ? error.failure : {
+	fate: "rejected",
+	cause: "server",
+	message: error instanceof Error ? error.message : String(error)
+};
+const createCore = (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;
+	const listeners = /* @__PURE__ */ new Set();
+	const post = createMacrotaskPoster(() => {
+		scheduled = false;
+		flush();
+	});
+	let scheduled = false;
+	const schedule = () => {
+		if (scheduled) return;
+		scheduled = true;
+		post();
+	};
+	const markStale = () => {
+		stale = true;
+		schedule();
+	};
+	const drainCanonical = () => {
+		if (source) {
+			pendingChanged.push(...source.takeChanged());
+			canonical = source.snapshot();
+		} 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 (!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 && published !== void 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 (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;
+		}
+	};
+	return {
+		attach,
+		detach,
+		getState: () => {
+			recompute();
+			return published;
+		},
+		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 () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+};
+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, useStatewireCore };
+
+//# sourceMappingURL=core.js.map

package/dist/client/core.js.map

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

@@ -0,0 +1,71 @@
+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
+/**
+ * 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;
+  ctx: StatewireRemoteProps;
+  recordPersisted: boolean;
+  store: StatewireSessionStore;
+  lastAck: number;
+  pending: Pending[];
+  canonical: unknown;
+  lastPublished: unknown;
+  changed: StatewirePath[];
+  source: Statewire.StateSource;
+  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 setTransport: (s: Session, transport: RemoteLink) => void;
+declare const useStatewireSession: (options: StatewireSessionStoreOptions, emit: (event: unknown) => void) => Session;
+//#endregion
+export { setTransport, useStatewireSession };
+//# 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":";;;;;;;;;;;;KA+BK;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;;KAmGb;KAEA;EACH,QAAQ;EACR,KAAK;EACL;EACA,OAAO;EACP;EACA,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;;cAkd/C,eAAgB,GAAG,SAAS,WAAW;cA4ChC,sBACX,SAAS,8BACT,OAAO,4BACN"}