statewire 0.0.0-0 → 0.0.1

package/dist/index.js

@@ -0,0 +1,6 @@
+import { applyOps } from "./wire/ops.js";
+import { StatewireSendError } from "./types.js";
+import { Statewire, StatewireResource, useStatewire } from "./statewire.js";
+import { StatewireSSE } from "./transports/sse.js";
+import { StatewireWS } from "./transports/ws.js";
+export { Statewire, StatewireResource, StatewireSSE, StatewireSendError, StatewireWS, applyOps, useStatewire };

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+import { StatewireCommands, StatewireStateSource, StatewireTransport } from "./types.js";
+import { CommandExecution, CommandExecutionResolvers, StatewireHandledCommands, StatewireStateCtl, useStatewireCommands, useStatewireEmit, useStatewireState } from "./host/host.js";
+import { StatewireReject } from "./host/engine.js";
+//#region src/server.d.ts
+declare namespace StatewireServer {
+  type StateCtl = StatewireStateCtl;
+  type StateSource = StatewireStateSource;
+  type Execution<T = void> = CommandExecution<T>;
+  type ExecutionResolvers<T = void> = CommandExecutionResolvers<T>;
+  type HandledCommands<THandlers extends StatewireCommands> = StatewireHandledCommands<THandlers>;
+  type Transport<TState = any, TCommands extends StatewireCommands = StatewireCommands, TEvent = any> = StatewireTransport<TState, TCommands, TEvent>;
+}
+//#endregion
+export { CommandExecution, StatewireReject, StatewireServer, useStatewireCommands, useStatewireEmit, useStatewireState };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":[],"sources":["../src/server.ts"],"mappings":";;;;kBAmBiB;OACH,WAAW;OACX,cAAc;OACd,UAAU,YAAY,iBAAiB;OACvC,mBAAmB,YAAY,0BAA0B;OACzD,gBAAgB,kBAAkB,qBAC5C,yBAAyB;OACf,UACV,cACA,kBAAkB,oBAAoB,mBACtC,gBACE,mBAAmB,QAAQ,WAAW"}

package/dist/server.js

@@ -0,0 +1,3 @@
+import { StatewireReject } from "./host/engine.js";
+import { CommandExecution, useStatewireCommands, useStatewireEmit, useStatewireState } from "./host/host.js";
+export { CommandExecution, StatewireReject, useStatewireCommands, useStatewireEmit, useStatewireState };

package/dist/statewire.d.ts

@@ -0,0 +1,20 @@
+import { StatewireConnection } from "./transports/sse.js";
+import { StatewireCommands, StatewireCommandsProxy, StatewireHelpers, StatewireOptions } from "./types.js";
+import { ResourceElement } from "@assistant-ui/tap";
+//#region src/statewire.d.ts
+declare const useStatewire: <TState, TCommands extends StatewireCommands = StatewireCommands, TEvent = any>(options: StatewireOptions<TState, TCommands, TEvent>) => StatewireHelpers<TState, TCommands>;
+declare const StatewireResource: <TState, TCommands extends StatewireCommands = StatewireCommands, TEvent = any>(options: StatewireOptions<TState, TCommands, TEvent>) => ResourceElement<StatewireHelpers<TState, TCommands>>;
+declare class Statewire<TState, TCommands extends StatewireCommands = StatewireCommands, TEvent = any> {
+  private readonly core;
+  private readonly root;
+  private disposed;
+  constructor(options: StatewireOptions<TState, TCommands, TEvent>);
+  get state(): TState;
+  get connection(): StatewireConnection;
+  get commands(): StatewireCommandsProxy<TCommands>;
+  subscribe(listener: () => void): () => void;
+  dispose(): void;
+}
+//#endregion
+export { Statewire, StatewireResource, useStatewire };
+//# sourceMappingURL=statewire.d.ts.map

package/dist/statewire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire.d.ts","names":[],"sources":["../src/statewire.ts"],"mappings":";;;;cAkBa,eACX,QACA,kBAAkB,oBAAoB,mBACtC,cAEA,SAAS,iBAAiB,QAAQ,WAAW,YAC5C,iBAAiB,QAAQ;cA6Bf,oBACX,QACA,kBAAkB,oBAAoB,mBACtC,cAEA,SAAS,iBAAiB,QAAQ,WAAW,YAC5C,gBAAgB,iBAAiB,QAAQ;cAG/B,UACX,QACA,kBAAkB,oBAAoB,mBACtC;mBAEiB;mBACA;UACT;EAEI,YAAA,SAAS,iBAAiB,QAAQ,WAAW;MAarD,SAAS;MAIT,cAAc;MAId,YAAY,uBAAuB;EAIvC,UAAU;EAIV"}

package/dist/statewire.js

@@ -0,0 +1,65 @@
+import { LIVE_CONNECTION, createStatewireCore } from "./client/core.js";
+import { useEffect, useRef, useState } from "@assistant-ui/tap/react-shim";
+import { createTapRoot, flushTapSync, resource, useResource } from "@assistant-ui/tap";
+//#region src/statewire.ts
+const useStatewire = (options) => {
+	const latest = useRef(options);
+	latest.current = options;
+	const [, setVersion] = useState(0);
+	const [core] = useState(() => createStatewireCore(() => latest.current));
+	const value = useResource(options.transport);
+	core.attach(value);
+	useEffect(() => {
+		core.attach(value);
+	});
+	useEffect(() => {
+		const unsubscribe = core.subscribe(() => flushTapSync(() => setVersion((v) => v + 1)));
+		return () => {
+			unsubscribe();
+			core.detach();
+		};
+	}, [core]);
+	return {
+		state: core.getState(),
+		connection: value.connection ?? LIVE_CONNECTION,
+		commands: core.commands
+	};
+};
+const StatewireResource = (options) => resource(useStatewire)(options);
+var Statewire = class {
+	core;
+	root;
+	disposed = false;
+	constructor(options) {
+		this.core = createStatewireCore(() => options);
+		const core = this.core;
+		this.root = createTapRoot(() => {
+			const value = useResource(options.transport);
+			core.attach(value);
+			return value;
+		});
+		flushTapSync(() => {});
+	}
+	get state() {
+		return this.core.getState();
+	}
+	get connection() {
+		return this.root.getValue().connection ?? LIVE_CONNECTION;
+	}
+	get commands() {
+		return this.core.commands;
+	}
+	subscribe(listener) {
+		return this.core.subscribe(listener);
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		this.root.unmount();
+		this.core.dispose();
+	}
+};
+//#endregion
+export { Statewire, StatewireResource, useStatewire };
+
+//# sourceMappingURL=statewire.js.map

package/dist/statewire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire.js","names":["useEffect","useRef","useState","createTapRoot","flushTapSync","resource","useResource","ResourceElement","createStatewireCore","LIVE_CONNECTION","StatewireTransport","StatewireCommands","StatewireCommandsProxy","StatewireHelpers","StatewireOptions","StatewireConnection","useStatewire","options","TState","TCommands","TEvent","latest","current","setVersion","core","value","transport","attach","unsubscribe","subscribe","v","detach","state","getState","connection","commands","StatewireResource","Statewire","root","disposed","constructor","getValue","listener","dispose","unmount"],"sources":["../src/statewire.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n  createTapRoot,\n  flushTapSync,\n  resource,\n  useResource,\n} from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { createStatewireCore, LIVE_CONNECTION } from \"./client/core\";\nimport type { StatewireTransport } from \"./types\";\nimport type {\n  StatewireCommands,\n  StatewireCommandsProxy,\n  StatewireHelpers,\n  StatewireOptions,\n} from \"./types\";\nimport type { StatewireConnection } from \"./transports/sse\";\n\nexport const useStatewire = <\n  TState,\n  TCommands extends StatewireCommands = StatewireCommands,\n  TEvent = any,\n>(\n  options: StatewireOptions<TState, TCommands, TEvent>,\n): StatewireHelpers<TState, TCommands> => {\n  const latest = useRef(options);\n  latest.current = options;\n  const [, setVersion] = useState(0);\n  const [core] = useState(() => createStatewireCore(() => latest.current));\n\n  const value = useResource(options.transport) as StatewireTransport<unknown>;\n  core.attach(value);\n\n  useEffect(() => {\n    core.attach(value);\n  });\n  useEffect(() => {\n    const unsubscribe = core.subscribe(() =>\n      flushTapSync(() => setVersion((v) => v + 1)),\n    );\n    return () => {\n      unsubscribe();\n      core.detach();\n    };\n  }, [core]);\n\n  return {\n    state: core.getState() as TState,\n    connection: value.connection ?? LIVE_CONNECTION,\n    commands: core.commands as StatewireCommandsProxy<TCommands>,\n  };\n};\n\nexport const StatewireResource = <\n  TState,\n  TCommands extends StatewireCommands = StatewireCommands,\n  TEvent = any,\n>(\n  options: StatewireOptions<TState, TCommands, TEvent>,\n): ResourceElement<StatewireHelpers<TState, TCommands>> =>\n  resource(useStatewire<TState, TCommands, TEvent>)(options);\n\nexport class Statewire<\n  TState,\n  TCommands extends StatewireCommands = StatewireCommands,\n  TEvent = any,\n> {\n  private readonly core;\n  private readonly root;\n  private disposed = false;\n\n  constructor(options: StatewireOptions<TState, TCommands, TEvent>) {\n    this.core = createStatewireCore(() => options);\n    const core = this.core;\n    this.root = createTapRoot(() => {\n      const value = useResource(\n        options.transport,\n      ) as StatewireTransport<unknown>;\n      core.attach(value);\n      return value;\n    });\n    flushTapSync(() => {});\n  }\n\n  get state(): TState {\n    return this.core.getState() as TState;\n  }\n\n  get connection(): StatewireConnection {\n    return this.root.getValue().connection ?? LIVE_CONNECTION;\n  }\n\n  get commands(): StatewireCommandsProxy<TCommands> {\n    return this.core.commands as StatewireCommandsProxy<TCommands>;\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.core.subscribe(listener);\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.root.unmount();\n    this.core.dispose();\n  }\n}\n"],"mappings":";;;;AAkBA,MAAagB,gBAKXC,YACwC;CACxC,MAAMI,SAASpB,OAAOgB,OAAO;CAC7BI,OAAOC,UAAUL;CACjB,MAAM,GAAGM,cAAcrB,SAAS,CAAC;CACjC,MAAM,CAACsB,QAAQtB,eAAeM,0BAA0Ba,OAAOC,OAAO,CAAC;CAEvE,MAAMG,QAAQnB,YAAYW,QAAQS,SAAS;CAC3CF,KAAKG,OAAOF,KAAK;CAEjBzB,gBAAgB;EACdwB,KAAKG,OAAOF,KAAK;CACnB,CAAC;CACDzB,gBAAgB;EACd,MAAM4B,cAAcJ,KAAKK,gBACvBzB,mBAAmBmB,YAAYO,MAAMA,IAAI,CAAC,CAAC,CAC7C;EACA,aAAa;GACXF,YAAY;GACZJ,KAAKO,OAAO;EACd;CACF,GAAG,CAACP,IAAI,CAAC;CAET,OAAO;EACLQ,OAAOR,KAAKS,SAAS;EACrBC,YAAYT,MAAMS,cAAczB;EAChC0B,UAAUX,KAAKW;CACjB;AACF;AAEA,MAAaC,qBAKXnB,YAEAZ,SAASW,YAAuC,CAAC,CAACC,OAAO;AAE3D,IAAaoB,YAAb,MAIE;CACA;CACA;CACA,WAAmB;CAEnBG,YAAYvB,SAAsD;EAChE,KAAKO,OAAOhB,0BAA0BS,OAAO;EAC7C,MAAMO,OAAO,KAAKA;EAClB,KAAKc,OAAOnC,oBAAoB;GAC9B,MAAMsB,QAAQnB,YACZW,QAAQS,SACV;GACAF,KAAKG,OAAOF,KAAK;GACjB,OAAOA;EACT,CAAC;EACDrB,mBAAmB,CAAC,CAAC;CACvB;CAEA,IAAI4B,QAAgB;EAClB,OAAO,KAAKR,KAAKS,SAAS;CAC5B;CAEA,IAAIC,aAAkC;EACpC,OAAO,KAAKI,KAAKG,SAAS,CAAC,CAACP,cAAczB;CAC5C;CAEA,IAAI0B,WAA8C;EAChD,OAAO,KAAKX,KAAKW;CACnB;CAEAN,UAAUa,UAAkC;EAC1C,OAAO,KAAKlB,KAAKK,UAAUa,QAAQ;CACrC;CAEAC,UAAgB;EACd,IAAI,KAAKJ,UAAU;EACnB,KAAKA,WAAW;EAChB,KAAKD,KAAKM,QAAQ;EAClB,KAAKpB,KAAKmB,QAAQ;CACpB;AACF"}

package/dist/transports/remote.d.ts

@@ -0,0 +1,19 @@
+import { ConnBase } from "../client/connection.js";
+import { RemoteLink, StatewireConnection, StatewireTransportProps } from "./sse.js";
+import { StatewireTransport } from "../types.js";
+import { SessionOptions } from "../client/session.js";
+//#region src/transports/remote.d.ts
+declare const useStatewireRemote: <TOptions extends {
+  url: string;
+  onChange?: (connection: StatewireConnection) => void;
+} & SessionOptions>(options: TOptions, create: (latest: {
+  readonly current: {
+    options: TOptions;
+    ctx: StatewireTransportProps;
+  };
+}, notify: (connection: StatewireConnection) => void) => ConnBase & {
+  send: RemoteLink["send"];
+}) => StatewireTransport<any, any, any>;
+//#endregion
+export { useStatewireRemote };
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","names":[],"sources":["../../src/transports/remote.ts"],"mappings":";;;;;cAqBa,qBACX;EACE;EACA,YAAY,YAAY;IACtB,gBAEJ,SAAS,UACT,SACE;WACW;IAAW,SAAS;IAAU,KAAK;;GAE9C,SAAS,YAAY,iCAClB;EAAa,MAAM;MACvB"}

package/dist/transports/remote.js

@@ -0,0 +1,40 @@
+import { useStatewireEmit } from "../host/host.js";
+import { useStatewireConn } from "../client/connection.js";
+import { createSession, handleFinish, handleOps, handleSnapshot, setTransport, start, stop } from "../client/session.js";
+import { useEffect, useState } from "@assistant-ui/tap/react-shim";
+//#region src/transports/remote.ts
+const useStatewireRemote = (options, create) => {
+	const emit = useStatewireEmit();
+	const [s] = useState(() => createSession({ sessionStore: options.sessionStore }));
+	useEffect(() => {
+		s.emitEvent = emit;
+		return () => {
+			s.emitEvent = () => {};
+		};
+	}, [s, emit]);
+	useEffect(() => {
+		start(s);
+		return () => stop(s);
+	}, [s]);
+	const [ctx] = useState(() => ({
+		get clientId() {
+			return s.record.clientId;
+		},
+		onSnapshot: (args) => handleSnapshot(s, args),
+		onOps: (args_0) => handleOps(s, args_0),
+		onFinish: (args_1) => handleFinish(s, args_1)
+	}));
+	const conn = useStatewireConn(options, ctx, create);
+	useEffect(() => setTransport(s, conn), [s, conn]);
+	return {
+		state: s.canonical,
+		commands: s.commands,
+		emit,
+		connection: conn.connection,
+		source: s.source
+	};
+};
+//#endregion
+export { useStatewireRemote };
+
+//# sourceMappingURL=remote.js.map

package/dist/transports/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","names":["useEffect","useState","useStatewireConn","ConnBase","useStatewireEmit","StatewireTransport","createSession","handleFinish","handleOps","handleSnapshot","setTransport","start","stop","SessionOptions","RemoteLink","StatewireConnection","StatewireTransportProps","useStatewireRemote","url","onChange","connection","options","TOptions","create","latest","current","ctx","notify","send","emit","s","sessionStore","emitEvent","clientId","record","onSnapshot","args","onOps","onFinish","conn","state","canonical","commands","source"],"sources":["../../src/transports/remote.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { useStatewireConn } from \"../client/connection\";\nimport type { ConnBase } from \"../client/connection\";\nimport { useStatewireEmit } from \"../host/host\";\nimport type { StatewireTransport } from \"../types\";\nimport {\n  createSession,\n  handleFinish,\n  handleOps,\n  handleSnapshot,\n  setTransport,\n  start,\n  stop,\n} from \"../client/session\";\nimport type { SessionOptions } from \"../client/session\";\nimport type {\n  RemoteLink,\n  StatewireConnection,\n  StatewireTransportProps,\n} from \"./sse\";\n\nexport const useStatewireRemote = <\n  TOptions extends {\n    url: string;\n    onChange?: (connection: StatewireConnection) => void;\n  } & SessionOptions,\n>(\n  options: TOptions,\n  create: (\n    latest: {\n      readonly current: { options: TOptions; ctx: StatewireTransportProps };\n    },\n    notify: (connection: StatewireConnection) => void,\n  ) => ConnBase & { send: RemoteLink[\"send\"] },\n): StatewireTransport<any, any, any> => {\n  const emit = useStatewireEmit<any>();\n  const [s] = useState(() =>\n    createSession({ sessionStore: options.sessionStore }),\n  );\n\n  useEffect(() => {\n    s.emitEvent = emit;\n    return () => {\n      s.emitEvent = () => {};\n    };\n  }, [s, emit]);\n  useEffect(() => {\n    start(s);\n    return () => stop(s);\n  }, [s]);\n\n  const [ctx] = useState(\n    (): StatewireTransportProps => ({\n      get clientId() {\n        return s.record.clientId;\n      },\n      onSnapshot: (args) => handleSnapshot(s, args),\n      onOps: (args) => handleOps(s, args),\n      onFinish: (args) => handleFinish(s, args),\n    }),\n  );\n  const conn = useStatewireConn(options, ctx, create);\n  useEffect(() => setTransport(s, conn), [s, conn]);\n\n  return {\n    state: s.canonical,\n    commands: s.commands,\n    emit,\n    connection: conn.connection,\n    source: s.source,\n  };\n};\n"],"mappings":";;;;;AAqBA,MAAaiB,sBAMXI,SACAE,WAMsC;CACtC,MAAMM,OAAOzB,iBAAsB;CACnC,MAAM,CAAC0B,KAAK7B,eACVK,cAAc,EAAEyB,cAAcV,QAAQU,aAAa,CAAC,CACtD;CAEA/B,gBAAgB;EACd8B,EAAEE,YAAYH;EACd,aAAa;GACXC,EAAEE,kBAAkB,CAAC;EACvB;CACF,GAAG,CAACF,GAAGD,IAAI,CAAC;CACZ7B,gBAAgB;EACdW,MAAMmB,CAAC;EACP,aAAalB,KAAKkB,CAAC;CACrB,GAAG,CAACA,CAAC,CAAC;CAEN,MAAM,CAACJ,OAAOzB,gBACoB;EAC9B,IAAIgC,WAAW;GACb,OAAOH,EAAEI,OAAOD;EAClB;EACAE,aAAaC,SAAS3B,eAAeqB,GAAGM,IAAI;EAC5CC,QAAQD,WAAS5B,UAAUsB,GAAGM,MAAI;EAClCE,WAAWF,WAAS7B,aAAauB,GAAGM,MAAI;CAC1C,EACF;CACA,MAAMG,OAAOrC,iBAAiBmB,SAASK,KAAKH,MAAM;CAClDvB,gBAAgBU,aAAaoB,GAAGS,IAAI,GAAG,CAACT,GAAGS,IAAI,CAAC;CAEhD,OAAO;EACLC,OAAOV,EAAEW;EACTC,UAAUZ,EAAEY;EACZb;EACAT,YAAYmB,KAAKnB;EACjBuB,QAAQb,EAAEa;CACZ;AACF"}

package/dist/transports/sse-parser.d.ts

@@ -0,0 +1,5 @@
+//#region src/transports/sse-parser.d.ts
+declare const createSseParser: () => ((chunk: string) => string[]);
+//#endregion
+export { createSseParser };
+//# sourceMappingURL=sse-parser.d.ts.map

package/dist/transports/sse-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-parser.d.ts","names":[],"sources":["../../src/transports/sse-parser.ts"],"mappings":";cAAa,yBAAwB"}

package/dist/transports/sse-parser.js

@@ -0,0 +1,26 @@
+//#region src/transports/sse-parser.ts
+const createSseParser = () => {
+	let buffer = "";
+	let dataLines = [];
+	return (chunk) => {
+		const events = [];
+		buffer += chunk;
+		const held = buffer.endsWith("\r") ? "\r" : "";
+		const lines = buffer.slice(0, buffer.length - held.length).split(/\r\n|\r|\n/);
+		buffer = lines.pop() + held;
+		for (const line of lines) {
+			if (line === "") {
+				if (dataLines.length > 0) events.push(dataLines.join("\n"));
+				dataLines = [];
+				continue;
+			}
+			const match = /^data(?:: ?(.*))?$/.exec(line);
+			if (match) dataLines.push(match[1] ?? "");
+		}
+		return events;
+	};
+};
+//#endregion
+export { createSseParser };
+
+//# sourceMappingURL=sse-parser.js.map

package/dist/transports/sse-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-parser.js","names":["createSseParser","chunk","buffer","dataLines","events","held","endsWith","lines","slice","length","split","pop","line","push","join","match","exec"],"sources":["../../src/transports/sse-parser.ts"],"sourcesContent":["export const createSseParser = (): ((chunk: string) => string[]) => {\n  let buffer = \"\";\n  let dataLines: string[] = [];\n\n  return (chunk: string) => {\n    const events: string[] = [];\n    buffer += chunk;\n    const held = buffer.endsWith(\"\\r\") ? \"\\r\" : \"\";\n    const lines = buffer\n      .slice(0, buffer.length - held.length)\n      .split(/\\r\\n|\\r|\\n/);\n    buffer = lines.pop()! + held;\n    for (const line of lines) {\n      if (line === \"\") {\n        if (dataLines.length > 0) events.push(dataLines.join(\"\\n\"));\n        dataLines = [];\n        continue;\n      }\n      const match = /^data(?:: ?(.*))?$/.exec(line);\n      if (match) dataLines.push(match[1] ?? \"\");\n    }\n    return events;\n  };\n};\n"],"mappings":";AAAA,MAAaA,wBAAuD;CAClE,IAAIE,SAAS;CACb,IAAIC,YAAsB,CAAA;CAE1B,QAAQF,UAAkB;EACxB,MAAMG,SAAmB,CAAA;EACzBF,UAAUD;EACV,MAAMI,OAAOH,OAAOI,SAAS,IAAI,IAAI,OAAO;EAC5C,MAAMC,QAAQL,OACXM,MAAM,GAAGN,OAAOO,SAASJ,KAAKI,MAAM,CAAC,CACrCC,MAAM,YAAY;EACrBR,SAASK,MAAMI,IAAI,IAAKN;EACxB,KAAK,MAAMO,QAAQL,OAAO;GACxB,IAAIK,SAAS,IAAI;IACf,IAAIT,UAAUM,SAAS,GAAGL,OAAOS,KAAKV,UAAUW,KAAK,IAAI,CAAC;IAC1DX,YAAY,CAAA;IACZ;GACF;GACA,MAAMY,QAAQ,qBAAqBC,KAAKJ,IAAI;GAC5C,IAAIG,OAAOZ,UAAUU,KAAKE,MAAM,MAAM,EAAE;EAC1C;EACA,OAAOX;CACT;AACF"}

package/dist/transports/sse.d.ts

@@ -0,0 +1,74 @@
+import { StatewireFinish, StatewireResponse } from "../client/connection.js";
+import { StatewireSessionStore } from "../client/sessionStore.js";
+import { StatewireCommands, StatewireTransport } from "../types.js";
+import { ResourceElement } from "@assistant-ui/tap";
+//#region src/transports/sse.d.ts
+type StatewireTransportProps = {
+  clientId: string;
+  onSnapshot: (args: {
+    ops: unknown[];
+    lastSeq: number;
+  }) => void;
+  onOps: (args: {
+    ops: unknown[];
+    res?: StatewireResponse[];
+    ack?: number;
+  }) => void;
+  onFinish: (args: StatewireFinish) => void;
+};
+type StatewireWireCommand = {
+  method: string;
+  params: readonly unknown[];
+};
+type StatewireSubmitResult = {
+  type: "receipt";
+  response?: StatewireResponse;
+} | {
+  type: "rejected";
+  message: string;
+  payload?: unknown;
+} | {
+  type: "seq-gap";
+} | {
+  type: "unknown-client";
+} | {
+  type: "stale-lease";
+};
+type ConnectionState = {
+  status: "connecting";
+} | {
+  status: "live";
+} | {
+  status: "reconnecting";
+  cause: "dropped" | "ended" | "error";
+  attempt: number;
+  nextRetryAt: number;
+  lastError?: string;
+  message?: string;
+} | {
+  status: "gone";
+  message?: string;
+  payload?: unknown;
+};
+type StatewireConnection = ConnectionState & {
+  reconnect: () => void;
+};
+/** The live wire a remote session drives: connection status plus command POST. */
+type RemoteLink = {
+  connection: StatewireConnection;
+  send: (args: {
+    seq: number;
+    command: StatewireWireCommand;
+  }) => Promise<StatewireSubmitResult>;
+};
+type StatewireSSEOptions = {
+  url: string;
+  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+  fetch?: typeof globalThis.fetch;
+  onChange?: (connection: StatewireConnection) => void;
+  sessionStore?: StatewireSessionStore;
+};
+declare const StatewireSSE: <TState = any, TCommands extends StatewireCommands = StatewireCommands, TEvent = any>(options: StatewireSSEOptions) => ResourceElement<StatewireTransport<TState | undefined, TCommands, TEvent>>;
+//#endregion
+export { ConnectionState, RemoteLink, StatewireConnection, StatewireSSE, StatewireSSEOptions, StatewireSubmitResult, StatewireTransportProps, StatewireWireCommand };
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","names":[],"sources":["../../src/transports/sse.ts"],"mappings":";;;;;KAwBY;EACV;EACA,aAAa;IAAQ;IAAgB;;EACrC,QAAQ;IACN;IACA,MAAM;IACN;;EAEF,WAAW,MAAM;;KAGP;EACV;EACA;;KAGU;EACN;EAAiB,WAAW;;EAC5B;EAAkB;EAAiB;;EACnC;;EACA;;EACA;;KAEM;EACN;;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;EAEA;EAAgB;EAAkB;;KAE5B,sBAAsB;EAAoB;;;KAG1C;EACV,YAAY;EACZ,OAAO;IACL;IACA,SAAS;QACL,QAAQ;;KAGJ;EACV;EACA,UAAU,qBAAqB,cAAc,QAAQ;EACrD,eAAe,WAAW;EAC1B,YAAY,YAAY;EACxB,eAAe;;cAqMJ,eACX,cACA,kBAAkB,oBAAoB,mBACtC,cAEA,SAAS,wBACN,gBAAgB,mBAAmB,oBAAoB,WAAW"}

package/dist/transports/sse.js

@@ -0,0 +1,136 @@
+import { encodeParams, reviveResponse } from "../wire/meta.js";
+import { createSseParser } from "./sse-parser.js";
+import { timing } from "../client/timing.js";
+import { classify, createGate, handleEnvelope, overloadedError, parseRetryAfter, reconnectConn } from "../client/connection.js";
+import { useStatewireRemote } from "./remote.js";
+import { flushTapSync, resource } from "@assistant-ui/tap";
+//#region src/transports/sse.ts
+const createConn = (latest, notify) => {
+	const c = {
+		hasSnapshot: false,
+		lease: null,
+		attempt: 0,
+		episode: null,
+		abort: null,
+		gate: createGate(),
+		lifetime: null,
+		latest,
+		notify,
+		reconnect: () => reconnectConn(c),
+		attemptOnce: (abort) => attemptStream(c, abort),
+		send: (args) => sendCommand(c, args),
+		connection: {
+			status: "connecting",
+			reconnect: () => c.reconnect()
+		}
+	};
+	return c;
+};
+const baseUrl = (c) => c.latest.current.options.url.replace(/\/$/, "");
+const requestHeaders = async (c, extra) => {
+	const { headers } = c.latest.current.options;
+	const merged = new Headers(typeof headers === "function" ? await headers() : headers);
+	for (const [name, value] of Object.entries(extra)) merged.set(name, value);
+	return merged;
+};
+const timedFetch = async (c, input, init, timeout) => {
+	try {
+		return await (c.latest.current.options.fetch ?? globalThis.fetch)(input, init);
+	} catch {
+		throw classify(timeout);
+	}
+};
+const consume = async (c, reader, heartbeat, dead) => {
+	const decoder = new TextDecoder();
+	const parse = createSseParser();
+	let attached = false;
+	for (;;) {
+		const timer = setTimeout(() => heartbeat.abort(), timing.heartbeatTimeoutMs);
+		let result;
+		try {
+			result = await reader.read();
+		} catch {
+			throw classify(heartbeat.signal);
+		} finally {
+			clearTimeout(timer);
+		}
+		if (result.done) return "ended";
+		for (const data of parse(decoder.decode(result.value, { stream: true }))) {
+			if (dead()) return "ended";
+			const env = JSON.parse(data);
+			const done = flushTapSync(() => handleEnvelope(c, env, attached));
+			attached = true;
+			if (done) return done;
+		}
+	}
+};
+const attemptStream = async (c, abort) => {
+	const headers = await requestHeaders(c, {
+		"Statewire-Client-Id": c.latest.current.ctx.clientId,
+		accept: "text/event-stream"
+	});
+	const heartbeat = new AbortController();
+	const headerTimer = setTimeout(() => heartbeat.abort(), timing.heartbeatTimeoutMs);
+	let res;
+	try {
+		res = await timedFetch(c, `${baseUrl(c)}/stream`, {
+			headers,
+			cache: "no-store",
+			signal: AbortSignal.any([abort.signal, heartbeat.signal])
+		}, heartbeat.signal);
+	} finally {
+		clearTimeout(headerTimer);
+	}
+	if (res.status === 429 || res.status === 503) throw overloaded(res);
+	if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);
+	const reader = res.body.getReader();
+	try {
+		return await consume(c, reader, heartbeat, () => abort.signal.aborted);
+	} finally {
+		reader.cancel().catch(() => {});
+	}
+};
+const overloaded = (res) => overloadedError(parseRetryAfter(res.headers.get("Retry-After")));
+const sendCommand = async (c, { seq, command }) => {
+	const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);
+	const res = await timedFetch(c, `${baseUrl(c)}/commands`, {
+		method: "POST",
+		headers: await requestHeaders(c, {
+			"content-type": "application/json",
+			"Statewire-Client-Id": c.latest.current.ctx.clientId,
+			"Statewire-Command-Seq": String(seq),
+			...c.lease !== null && { "Statewire-Lease": c.lease }
+		}),
+		body: JSON.stringify({
+			method: command.method,
+			...encodeParams(command.params)
+		}),
+		signal: AbortSignal.any([c.lifetime?.signal ?? AbortSignal.abort(), timeout])
+	}, timeout);
+	if (res.ok) {
+		const body = await res.json().catch(() => null);
+		return body?.res !== void 0 ? {
+			type: "receipt",
+			response: reviveResponse(body.res)
+		} : { type: "receipt" };
+	}
+	if (res.status === 409 || res.status === 412 || res.status === 423) {
+		const verdict = res.status === 409 ? "seq-gap" : res.status === 412 ? "unknown-client" : "stale-lease";
+		if ((await res.json().catch(() => null))?.error === verdict) return { type: verdict };
+		throw new Error(`HTTP ${res.status}`);
+	}
+	if (res.status === 429 || res.status === 503) throw overloaded(res);
+	if (res.status >= 400 && res.status < 500) return {
+		type: "rejected",
+		message: `HTTP ${res.status}`
+	};
+	throw new Error(`HTTP ${res.status}`);
+};
+const useStatewireSSE = (options) => {
+	return useStatewireRemote(options, createConn);
+};
+const StatewireSSE = resource(useStatewireSSE);
+//#endregion
+export { StatewireSSE };
+
+//# sourceMappingURL=sse.js.map

package/dist/transports/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","names":["flushTapSync","resource","ResourceElement","encodeParams","reviveResponse","createSseParser","timing","classify","createGate","handleEnvelope","overloadedError","parseRetryAfter","reconnectConn","ConnBase","StatewireEnvelope","StatewireFinish","StatewireResponse","StatewireTransport","useStatewireRemote","StatewireSessionStore","StatewireCommands","StatewireTransportProps","clientId","onSnapshot","args","ops","lastSeq","onOps","res","ack","onFinish","StatewireWireCommand","method","params","StatewireSubmitResult","type","response","message","payload","ConnectionState","status","cause","attempt","nextRetryAt","lastError","StatewireConnection","reconnect","RemoteLink","connection","send","seq","command","Promise","StatewireSSEOptions","url","headers","HeadersInit","fetch","globalThis","onChange","sessionStore","Latest","options","ctx","Conn","latest","current","createConn","notify","c","hasSnapshot","lease","episode","abort","gate","lifetime","attemptOnce","attemptStream","sendCommand","baseUrl","replace","requestHeaders","extra","Record","merged","Headers","name","value","Object","entries","set","timedFetch","input","init","RequestInit","signal","AbortSignal","timeout","Response","consume","reader","ReadableStreamDefaultReader","Uint8Array","heartbeat","AbortController","dead","decoder","TextDecoder","parse","attached","timer","setTimeout","heartbeatTimeoutMs","result","ReadableStreamReadResult","read","clearTimeout","done","data","decode","stream","env","JSON","accept","headerTimer","cache","any","overloaded","ok","body","Error","getReader","aborted","cancel","catch","get","String","stringify","json","undefined","verdict","const","error","useStatewireSSE","StatewireSSE","TState","TCommands","TEvent"],"sources":["../../src/transports/sse.ts"],"sourcesContent":["import { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { encodeParams, reviveResponse } from \"../wire/meta\";\nimport { createSseParser } from \"./sse-parser\";\nimport { timing } from \"../client/timing\";\nimport {\n  classify,\n  createGate,\n  handleEnvelope,\n  overloadedError,\n  parseRetryAfter,\n  reconnectConn,\n} from \"../client/connection\";\nimport type {\n  ConnBase,\n  StatewireEnvelope,\n  StatewireFinish,\n  StatewireResponse,\n} from \"../client/connection\";\nimport type { StatewireTransport } from \"../types\";\nimport { useStatewireRemote } from \"./remote\";\nimport type { StatewireSessionStore } from \"../client/sessionStore\";\nimport type { StatewireCommands } from \"../types\";\n\nexport type StatewireTransportProps = {\n  clientId: string;\n  onSnapshot: (args: { ops: unknown[]; lastSeq: number }) => void;\n  onOps: (args: {\n    ops: unknown[];\n    res?: StatewireResponse[];\n    ack?: number;\n  }) => void;\n  onFinish: (args: StatewireFinish) => void;\n};\n\nexport type StatewireWireCommand = {\n  method: string;\n  params: readonly unknown[];\n};\n\nexport type StatewireSubmitResult =\n  | { type: \"receipt\"; response?: StatewireResponse }\n  | { type: \"rejected\"; message: string; payload?: unknown }\n  | { type: \"seq-gap\" }\n  | { type: \"unknown-client\" }\n  | { type: \"stale-lease\" };\n\nexport type ConnectionState =\n  | { status: \"connecting\" }\n  | { status: \"live\" }\n  | {\n      status: \"reconnecting\";\n      cause: \"dropped\" | \"ended\" | \"error\";\n      attempt: number;\n      nextRetryAt: number;\n      lastError?: string;\n      message?: string;\n    }\n  | { status: \"gone\"; message?: string; payload?: unknown };\n\nexport type StatewireConnection = ConnectionState & { reconnect: () => void };\n\n/** The live wire a remote session drives: connection status plus command POST. */\nexport type RemoteLink = {\n  connection: StatewireConnection;\n  send: (args: {\n    seq: number;\n    command: StatewireWireCommand;\n  }) => Promise<StatewireSubmitResult>;\n};\n\nexport type StatewireSSEOptions = {\n  url: string;\n  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);\n  fetch?: typeof globalThis.fetch;\n  onChange?: (connection: StatewireConnection) => void;\n  sessionStore?: StatewireSessionStore;\n};\n\ntype Latest = {\n  options: StatewireSSEOptions;\n  ctx: StatewireTransportProps;\n};\n\ntype Conn = ConnBase & {\n  latest: { readonly current: Latest };\n  send: RemoteLink[\"send\"];\n};\n\nconst createConn = (\n  latest: { readonly current: Latest },\n  notify: (connection: StatewireConnection) => void,\n): Conn => {\n  const c: Conn = {\n    hasSnapshot: false,\n    lease: null,\n    attempt: 0,\n    episode: null,\n    abort: null,\n    gate: createGate(),\n    lifetime: null,\n    latest,\n    notify,\n    reconnect: () => reconnectConn(c),\n    attemptOnce: (abort) => attemptStream(c, abort),\n    send: (args) => sendCommand(c, args),\n    connection: { status: \"connecting\", reconnect: () => c.reconnect() },\n  };\n  return c;\n};\n\nconst baseUrl = (c: Conn) => c.latest.current.options.url.replace(/\\/$/, \"\");\n\nconst requestHeaders = async (c: Conn, extra: Record<string, string>) => {\n  const { headers } = c.latest.current.options;\n  const merged = new Headers(\n    typeof headers === \"function\" ? await headers() : headers,\n  );\n  for (const [name, value] of Object.entries(extra)) merged.set(name, value);\n  return merged;\n};\n\nconst timedFetch = async (\n  c: Conn,\n  input: string,\n  init: RequestInit & { signal: AbortSignal },\n  timeout: AbortSignal,\n): Promise<Response> => {\n  try {\n    return await (c.latest.current.options.fetch ?? globalThis.fetch)(\n      input,\n      init,\n    );\n  } catch {\n    throw classify(timeout);\n  }\n};\n\nconst consume = async (\n  c: Conn,\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  heartbeat: AbortController,\n  dead: () => boolean,\n): Promise<\"stop\" | \"reattach\" | \"ended\"> => {\n  const decoder = new TextDecoder();\n  const parse = createSseParser();\n  let attached = false;\n  for (;;) {\n    const timer = setTimeout(\n      () => heartbeat.abort(),\n      timing.heartbeatTimeoutMs,\n    );\n    let result: ReadableStreamReadResult<Uint8Array>;\n    try {\n      result = await reader.read();\n    } catch {\n      throw classify(heartbeat.signal);\n    } finally {\n      clearTimeout(timer);\n    }\n    if (result.done) return \"ended\";\n    for (const data of parse(decoder.decode(result.value, { stream: true }))) {\n      if (dead()) return \"ended\";\n      const env = JSON.parse(data) as StatewireEnvelope;\n      const done = flushTapSync(() => handleEnvelope(c, env, attached));\n      attached = true;\n      if (done) return done;\n    }\n  }\n};\n\nconst attemptStream = async (\n  c: Conn,\n  abort: AbortController,\n): Promise<\"stop\" | \"reattach\" | \"ended\"> => {\n  const headers = await requestHeaders(c, {\n    \"Statewire-Client-Id\": c.latest.current.ctx.clientId,\n    accept: \"text/event-stream\",\n  });\n  const heartbeat = new AbortController();\n  const headerTimer = setTimeout(\n    () => heartbeat.abort(),\n    timing.heartbeatTimeoutMs,\n  );\n  let res: Response;\n  try {\n    res = await timedFetch(\n      c,\n      `${baseUrl(c)}/stream`,\n      {\n        headers,\n        cache: \"no-store\",\n        signal: AbortSignal.any([abort.signal, heartbeat.signal]),\n      },\n      heartbeat.signal,\n    );\n  } finally {\n    clearTimeout(headerTimer);\n  }\n  if (res.status === 429 || res.status === 503) throw overloaded(res);\n  if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);\n  const reader = res.body.getReader();\n  try {\n    return await consume(c, reader, heartbeat, () => abort.signal.aborted);\n  } finally {\n    reader.cancel().catch(() => {});\n  }\n};\n\nconst overloaded = (res: Response) =>\n  overloadedError(parseRetryAfter(res.headers.get(\"Retry-After\")));\n\nconst sendCommand = async (\n  c: Conn,\n  { seq, command }: { seq: number; command: StatewireWireCommand },\n): Promise<StatewireSubmitResult> => {\n  const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);\n  const res = await timedFetch(\n    c,\n    `${baseUrl(c)}/commands`,\n    {\n      method: \"POST\",\n      headers: await requestHeaders(c, {\n        \"content-type\": \"application/json\",\n        \"Statewire-Client-Id\": c.latest.current.ctx.clientId,\n        \"Statewire-Command-Seq\": String(seq),\n        ...(c.lease !== null && { \"Statewire-Lease\": c.lease }),\n      }),\n      body: JSON.stringify({\n        method: command.method,\n        ...encodeParams(command.params),\n      }),\n      signal: AbortSignal.any([\n        c.lifetime?.signal ?? AbortSignal.abort(),\n        timeout,\n      ]),\n    },\n    timeout,\n  );\n  if (res.ok) {\n    const body = (await res.json().catch(() => null)) as {\n      res?: StatewireResponse;\n    } | null;\n    return body?.res !== undefined\n      ? { type: \"receipt\", response: reviveResponse(body.res) }\n      : { type: \"receipt\" };\n  }\n  if (res.status === 409 || res.status === 412 || res.status === 423) {\n    // Only a body naming the same verdict as the status is statewire's own;\n    // a bare status is middleware noise — a transport fault, retried.\n    const verdict =\n      res.status === 409\n        ? (\"seq-gap\" as const)\n        : res.status === 412\n          ? (\"unknown-client\" as const)\n          : (\"stale-lease\" as const);\n    const body = (await res.json().catch(() => null)) as {\n      error?: string;\n    } | null;\n    if (body?.error === verdict) return { type: verdict };\n    throw new Error(`HTTP ${res.status}`);\n  }\n  if (res.status === 429 || res.status === 503) throw overloaded(res);\n  if (res.status >= 400 && res.status < 500) {\n    return { type: \"rejected\", message: `HTTP ${res.status}` };\n  }\n  throw new Error(`HTTP ${res.status}`);\n};\n\nconst useStatewireSSE = (\n  options: StatewireSSEOptions,\n): StatewireTransport<any, any, any> => useStatewireRemote(options, createConn);\n\nexport const StatewireSSE = resource(useStatewireSSE) as <\n  TState = any,\n  TCommands extends StatewireCommands = StatewireCommands,\n  TEvent = any,\n>(\n  options: StatewireSSEOptions,\n) => ResourceElement<StatewireTransport<TState | undefined, TCommands, TEvent>>;\n"],"mappings":"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"}

package/dist/transports/testing.d.ts

@@ -0,0 +1,31 @@
+import { StatewireEnvelope } from "../client/connection.js";
+import { StatewireTransport } from "../types.js";
+import { ResourceElement } from "@assistant-ui/tap";
+//#region src/transports/testing.d.ts
+/** Let queued microtasks and op batches drain through the statewire client. */
+declare const tick: () => Promise<void>;
+/** Run a mutator against a recording draft, as the client does for `optimistic`. */
+declare const applyOptimistic: <TState>(state: TState, mutate: (draft: TState) => void) => TState;
+type MockTransport<TState> = {
+  /** Pass as the `transport:` option of useStatewire / Harness. */
+  transport: ResourceElement<StatewireTransport<TState | undefined, any, any>>;
+  /** Captured `{ method, params }` command bodies, in POST order. */
+  commands: {
+    method: string;
+    params: unknown[];
+  }[];
+  /** Replace the replicated state and broadcast it as a root snapshot op. */
+  setState: (state: TState) => Promise<void>;
+  /** Deliver an ack watermark on the stream. */
+  ack: (seq: number) => Promise<void>;
+  /** Deliver an arbitrary envelope on the stream. */
+  sendEnvelope: (envelope: StatewireEnvelope) => Promise<void>;
+  /** End the stream with a fin; further attaches fail like a dead server. */
+  finish: (reason: string, message?: string) => Promise<void>;
+  readonly clientId: string;
+  readonly attached: boolean;
+};
+declare const createMockTransport: <TState>(initialState: TState) => MockTransport<TState>;
+//#endregion
+export { MockTransport, applyOptimistic, createMockTransport, tick };
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../../src/transports/testing.ts"],"mappings":";;;;;cAOa,YAAI;;cAGJ,kBAAmB,QAC9B,OAAO,QACP,SAAS,OAAO,oBACf;KAQS,cAAc;;EAExB,WAAW,gBAAgB,mBAAmB;;EAE9C;IAAY;IAAgB;;;EAE5B,WAAW,OAAO,WAAW;;EAE7B,MAAM,gBAAgB;;EAEtB,eAAe,UAAU,sBAAsB;;EAE/C,SAAS,gBAAgB,qBAAqB;WACrC;WACA;;cAUE,sBAAuB,QAClC,cAAc,WACb,cAAc"}