statewire 0.20.0 → 0.22.0

package/dist/client/core.js

@@ -1,11 +1,11 @@
+import { createChanges } from "./changes.js";
 import { recordMutations } from "../util/recordMutations.js";
 import { createMethodProxy } from "../util/methodProxy.js";
 import { StatewireSendError } from "../types.js";
 import { getCommandsHost, getStateHost } from "../host/host.js";
 import { createMacrotaskPoster } from "../util/macrotask.js";
-import { createChanges } from "./changes.js";
 import { useEffect, useState } from "@assistant-ui/tap/react-shim";
-//#region src/client/core.ts
+// src/client/core.ts
 const CONNECTED_CONNECTION = {
 	status: "connected",
 	degraded: false,
@@ -281,7 +281,6 @@ const useStatewireCore = (getOptions, value) => {
 	useEffect(() => () => detach(core), [core]);
 	return core;
 };
-//#endregion
 export { CONNECTED_CONNECTION, useStatewireCore };
 
 //# sourceMappingURL=core.js.map

package/dist/client/session.d.ts

@@ -1,106 +1,106 @@
-import { StatewireDocuments } from "../wire/documents.js";
-import { CommandsInvocation, CommandsListener } from "../host/host.js";
-import { StatewireProtocol } from "../wire/protocol.js";
-import { RemoteLink, StatewireRemoteProps } from "../transports/sse.js";
-import { StatewireClient } from "../statewire.js";
-import { Statewire } from "../types.js";
-import { StatewirePath } from "../wire/ops.js";
 import { encodeContext } from "../wire/context.js";
-//#region src/client/session.d.ts
+import type { StatewireProtocol } from "../wire/protocol.js";
+import type { StatewireDocuments } from "../wire/documents.js";
+import type { StatewirePath } from "../wire/ops.js";
+import type { CommandsInvocation, CommandsListener } from "../host/host.js";
+import type { Statewire } from "../types.js";
+import type { StatewireClient } from "../statewire.js";
+import type { RemoteLink, StatewireRemoteProps } from "../transports/sse.js";
 type WireCommand = {
-  protocol: string;
-  produced?: NonNullable<StatewireClient.SessionCommand["produced"]>;
-  method: string;
-  params: unknown[];
-  meta?: unknown;
+    protocol: string;
+    produced?: NonNullable<StatewireClient.SessionCommand["produced"]>;
+    method: string;
+    params: unknown[];
+    meta?: unknown;
 };
 type Pending = {
-  readonly seq: number;
-  readonly command: WireCommand;
-  readonly inv: CommandsInvocation;
-  /** A send carrying this statement may have reached the server. */
-  attempted: boolean;
-  /** In the resend queue when false. */
-  posted: boolean;
-  /** The server acknowledged admission; the terminal verdict is still due. */
-  applied: boolean;
-  resolve: (payload: unknown) => void;
-  reject: (error: unknown) => void;
+    readonly seq: number;
+    readonly command: WireCommand;
+    readonly inv: CommandsInvocation;
+    /** A send carrying this statement may have reached the server. */
+    attempted: boolean;
+    /** In the resend queue when false. */
+    posted: boolean;
+    /** The server acknowledged admission; the terminal verdict is still due. */
+    applied: boolean;
+    resolve: (payload: unknown) => void;
+    reject: (error: unknown) => void;
 };
 type AttachState = "detached" | "attached" | "finished";
-type StatewireSessionOptions = StatewireProtocol.Options & {
-  context?: Readonly<Record<string, Statewire.Context>>;
-  sessionStore?: StatewireClient.SessionStorage | undefined;
-  onSessionLost?: StatewireClient.OnSessionLost | undefined;
-  onDone?: (() => void) | undefined;
+export type StatewireSessionOptions = StatewireProtocol.Options & {
+    context?: Readonly<Record<string, Statewire.Context>>;
+    sessionStore?: StatewireClient.SessionStorage | undefined;
+    onSessionLost?: StatewireClient.OnSessionLost | undefined;
+    onDone?: (() => void) | undefined;
 };
 type Shared = {
-  txq: Promise<void>;
-  parked: {
-    protocol: string;
-    verdict: StatewireClient.SessionVerdict;
-  }[];
-  unsubscribe: (() => void) | null;
+    txq: Promise<void>;
+    syncQueued: boolean;
+    parked: {
+        protocol: string;
+        verdict: StatewireClient.SessionVerdict;
+    }[];
+    unsubscribe: (() => void) | null;
 };
 type Session = {
-  options: StatewireSessionOptions;
-  configuredContext: StatewireSessionOptions["context"];
-  contexts: Map<string, ReturnType<typeof encodeContext>>;
-  dirtyContexts: Set<string>;
-  attachContexts: Map<string, ReturnType<typeof encodeContext>>;
-  selection: StatewireProtocol.Selection | undefined;
-  record: StatewireClient.SessionRecord;
-  ctx: StatewireRemoteProps;
-  recordPersisted: boolean;
-  hydrated: boolean;
-  ready: Promise<void> | undefined;
-  storageError: unknown;
-  persistedRecord: StatewireClient.SessionRecord | null;
-  store: StatewireClient.SessionStorage;
-  documentStore: StatewireDocuments.Storage | undefined;
-  shared: Shared | false;
-  /** Every selected lane is ephemeral: the record dies with the attach. */
-  ephemeral: boolean;
-  /** An ephemeral record died with its attach: the storage is off for good. */
-  deactivated: boolean;
-  sessionKnown: boolean;
-  durableSeq: Record<string, number>;
-  /** Ephemeral lane clocks: restart at 1 on every attach. */
-  ephemeralSeqs: Record<string, number>;
-  resumeAt: number;
-  idle: boolean;
-  onSessionLost: StatewireClient.OnSessionLost | undefined;
-  onDone: (() => void) | undefined;
-  lanesOnAttach: boolean;
-  attachEntries: ReadonlySet<Pending>;
-  frameFailures: number;
-  pending: Pending[];
-  failedList: readonly StatewireClient.FailedCommand[];
-  failedParts: readonly (readonly StatewireClient.FailedCommand[])[];
-  canonical: unknown;
-  documentListeners: Set<() => void>;
-  documents: StatewireDocuments.State;
-  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;
-  commands: Record<string, (...params: unknown[]) => Promise<unknown>>;
+    options: StatewireSessionOptions;
+    configuredContext: StatewireSessionOptions["context"];
+    contexts: Map<string, ReturnType<typeof encodeContext>>;
+    dirtyContexts: Set<string>;
+    attachContexts: Map<string, ReturnType<typeof encodeContext>>;
+    selection: StatewireProtocol.Selection | undefined;
+    record: StatewireClient.SessionRecord;
+    ctx: StatewireRemoteProps;
+    recordPersisted: boolean;
+    hydrated: boolean;
+    ready: Promise<void> | undefined;
+    storageError: unknown;
+    persistedRecord: StatewireClient.SessionRecord | null;
+    store: StatewireClient.SessionStorage;
+    documentStore: StatewireDocuments.Storage | undefined;
+    shared: Shared | false;
+    /** Every selected lane is ephemeral: the record dies with the attach. */
+    ephemeral: boolean;
+    /** An ephemeral record died with its attach: the storage is off for good. */
+    deactivated: boolean;
+    sessionKnown: boolean;
+    durableSeq: Record<string, number>;
+    /** Ephemeral lane clocks: restart at 1 on every attach. */
+    ephemeralSeqs: Record<string, number>;
+    resumeAt: number;
+    idle: boolean;
+    onSessionLost: StatewireClient.OnSessionLost | undefined;
+    onDone: (() => void) | undefined;
+    lanesOnAttach: boolean;
+    attachEntries: ReadonlySet<Pending>;
+    frameFailures: number;
+    pending: Pending[];
+    failedList: readonly StatewireClient.FailedCommand[];
+    failedParts: readonly (readonly StatewireClient.FailedCommand[])[];
+    canonical: unknown;
+    documentListeners: Set<() => void>;
+    documents: StatewireDocuments.State;
+    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;
+    commands: Record<string, (...params: unknown[]) => Promise<unknown>>;
 };
-declare const failedCommands: (s: Session) => readonly StatewireClient.FailedCommand[];
+export declare const failedCommands: (s: Session) => readonly StatewireClient.FailedCommand[];
+export declare const MAX_FAILED_RETAINED = 256;
 declare const setTransport: (s: Session, transport: RemoteLink) => void;
-declare const discardFailed: (s: Session, entry: StatewireClient.FailedCommand) => void;
-declare const retryFailed: (s: Session, entry: StatewireClient.FailedCommand) => Promise<unknown>;
-declare const documentSource: (s: Session) => StatewireDocuments.Source;
-declare const invokeProtocol: (s: Session, protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
-declare const setContext: (s: Session, protocol: string, value: Statewire.Context) => void;
-declare const useStatewireSession: (options: StatewireSessionOptions) => Session;
-//#endregion
-export { StatewireSessionOptions, discardFailed, documentSource, failedCommands, invokeProtocol, retryFailed, setContext, setTransport, useStatewireSession };
+export declare const discardFailed: (s: Session, entry: StatewireClient.FailedCommand) => void;
+export declare const retryFailed: (s: Session, entry: StatewireClient.FailedCommand) => Promise<unknown>;
+export declare const documentSource: (s: Session) => StatewireDocuments.Source;
+export declare const invokeProtocol: (s: Session, protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
+export declare const setContext: (s: Session, protocol: string, value: Statewire.Context) => void;
+export declare const useStatewireSession: (options: StatewireSessionOptions) => Session;
+export { setTransport };
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","names":[],"sources":["../../src/client/session.ts"],"mappings":";;;;;;;;;KA0CK;EACH;EACA,WAAW,YAAY,gBAAgB;EACvC;EACA;EACA;;KAGG;WACM;WACA,SAAS;WACT,KAAK;;EAEd;;EAEA;;EAEA;EACA,UAAU;EACV,SAAS;;KAeN;KAEO,0BAA0B,kBAAkB;EACtD,UAAU,SAAS,eAAe,UAAU;EAC5C,eAAe,gBAAgB;EAC/B,gBAAgB,gBAAgB;EAChC;;KAGG;EACH,KAAK;EACL;IAAU;IAAkB,SAAS,gBAAgB;;EACrD;;KAGG;EACH,SAAS;EACT,mBAAmB;EACnB,UAAU,YAAY,kBAAkB;EACxC,eAAe;EACf,gBAAgB,YAAY,kBAAkB;EAC9C,WAAW,kBAAkB;EAC7B,QAAQ,gBAAgB;EACxB,KAAK;EACL;EACA;EACA,OAAO;EACP;EACA,iBAAiB,gBAAgB;EACjC,OAAO,gBAAgB;EACvB,eAAe,mBAAmB;EAClC,QAAQ;;EAER;;EAEA;EACA;EACA,YAAY;;EAEZ,eAAe;EACf;EACA;EACA,eAAe,gBAAgB;EAC/B;EACA;EACA,eAAe,YAAY;EAC3B;EACA,SAAS;EACT,qBAAqB,gBAAgB;EACrC,gCAAgC,gBAAgB;EAChD;EACA,mBAAmB;EACnB,WAAW,mBAAmB;EAC9B;EACA,SAAS;EACT,QAAQ,UAAU;EAClB,QAAQ;EACR;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;EACX;EACA,UAAU,mBAAmB,sBAAsB;;cA2MxC,iBACX,GAAG,qBACO,gBAAgB;cA+wBtB,eAAgB,GAAG,SAAS,WAAW;cAiNhC,gBACX,GAAG,SACH,OAAO,gBAAgB;cAYZ,cACX,GAAG,SACH,OAAO,gBAAgB,kBACtB;cA4DU,iBAAkB,GAAG,YAAU,mBAAmB;cA+BlD,iBACX,GAAG,SACH,kBACA,gBACA,+BAA0B;cAoEf,aACX,GAAG,SACH,kBACA,OAAO,UAAU;cAcN,sBACX,SAAS,4BACR"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/client/session.ts"],"names":[],"mappings":"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"}

package/dist/client/session.js

@@ -1,19 +1,19 @@
+import { inRange, protocolOffers } from "../wire/protocol.js";
 import { reviveDocumentValue } from "../document.js";
+import { encodeParams, reviveResponse } from "../wire/meta.js";
+import { backoff, retryHint } from "./timing.js";
+import { wrapStorageError } from "./storageError.js";
+import { TERMINAL } from "./connection.js";
 import "../wire/limits.js";
-import { inRange, protocolOffers } from "../wire/protocol.js";
 import { encodeContext } from "../wire/context.js";
 import { createMethodProxy } from "../util/methodProxy.js";
 import { StatewireSendError } from "../types.js";
 import { bindCommandsHost } from "../host/host.js";
-import { encodeParams, reviveResponse } from "../wire/meta.js";
 import { applyDocumentOps, findDocument, mainDocument, resolveDocumentKey } from "../wire/documents.js";
 import { DocumentStorageContext, SessionStorageContext, createMemorySessionStore } from "./sessionStore.js";
-import { backoff, retryHint } from "./timing.js";
-import { wrapStorageError } from "./storageError.js";
-import { TERMINAL } from "./connection.js";
 import { randomId } from "../util/randomId.js";
 import { useContext, useEffect, useState } from "@assistant-ui/tap/react-shim";
-//#region src/client/session.ts
+// src/client/session.ts
 const protocolError = (message) => {
 	throw new Error(`statewire: protocol error: ${message}`);
 };
@@ -66,13 +66,13 @@ const storageFailed = (s, cause) => {
 	s.transport?.storageFailed(error);
 };
 const setRecord = (s, record) => {
-	s.record = record;
 	if (!s.deactivated) try {
 		s.store.save(record);
 	} catch (cause) {
 		storageFailed(s, cause);
 		throw s.storageError;
 	}
+	s.record = record;
 };
 const toStored = (p) => {
 	const { protocol: _protocol, ...command } = p.command;
@@ -114,8 +114,16 @@ const syncBacklogInner = (s) => {
 	});
 };
 const syncBacklog = (s) => {
-	if (!s.shared) return syncBacklogInner(s);
-	transactBackground(s, () => syncBacklogInner(s));
+	const shared = s.shared;
+	if (!shared) return syncBacklogInner(s);
+	if (shared.syncQueued) return;
+	shared.syncQueued = true;
+	transact(s, () => {
+		shared.syncQueued = false;
+		syncBacklogInner(s);
+	}).catch(() => {
+		shared.syncQueued = false;
+	});
 };
 const transact = (s, fn) => {
 	if (!s.shared || s.deactivated) {
@@ -126,7 +134,7 @@ const transact = (s, fn) => {
 	const result = shared.txq.then(() => s.store.lock(async () => {
 		const stored = s.store.load();
 		if (stored !== null && stored.clientId !== s.record.clientId) adoptReset(s, stored);
-		else if (stored !== null) s.record = stored;
+		else if (stored !== null) s.record = boundRecord(stored);
 		fn();
 		const persistence = s.store.flush?.();
 		if (persistence) await persistence;
@@ -160,11 +168,27 @@ const failedCommands = (s) => {
 	}
 	return s.failedList;
 };
+const MAX_FAILED_RETAINED = 256;
+const boundFailed = (failed) => failed.length > 256 ? [...failed].sort((a, b) => a.ts - b.ts).slice(-256) : failed;
+const boundRecord = (record) => {
+	let lanes = record.lanes;
+	for (const [protocol, lane] of Object.entries(lanes)) if (lane.failed !== void 0 && lane.failed.length > 256) lanes = {
+		...lanes,
+		[protocol]: {
+			...lane,
+			failed: boundFailed(lane.failed)
+		}
+	};
+	return lanes === record.lanes ? record : {
+		...record,
+		lanes
+	};
+};
 const retainFailedInner = (s, entry, failure) => {
 	const lane = laneOf(s.record, entry.command.protocol);
 	setRecord(s, withLane(s.record, entry.command.protocol, {
 		...lane,
-		failed: [...lane.failed ?? [], {
+		failed: boundFailed([...lane.failed ?? [], {
 			protocol: entry.command.protocol,
 			...entry.command.produced !== void 0 && { produced: entry.command.produced },
 			command: entry.command.method,
@@ -173,7 +197,7 @@ const retainFailedInner = (s, entry, failure) => {
 			failure,
 			ts: entry.inv.ts,
 			seq: entry.seq
-		}]
+		}])
 	}));
 	s.notify();
 };
@@ -264,7 +288,7 @@ const rebaseRecord = (s, adopt) => {
 			...lanes,
 			[protocol]: {
 				...current,
-				failed: [...current.failed ?? [], ...failed]
+				failed: boundFailed([...current.failed ?? [], ...failed])
 			}
 		};
 	}
@@ -283,7 +307,7 @@ const resetRecord = (s, clientId) => rebaseRecord(s, () => setRecord(s, {
 }));
 const adoptReset = (s, stored) => {
 	rebaseRecord(s, () => {
-		s.record = stored;
+		s.record = boundRecord(stored);
 	});
 	if (s.attach === "attached") s.transport?.connection.reconnect();
 };
@@ -520,7 +544,7 @@ const handleHello = (s, { ops, syn }) => {
 const handleOps = (s, { ops, cmds }) => {
 	ingestOps(s, ops);
 	for (const cmd of cmds) handleCmd(s, cmd);
-	syncBacklog(s);
+	if (cmds.length > 0) syncBacklog(s);
 	publishIngested(s);
 };
 const handleRefusal = (s, syn) => {
@@ -656,7 +680,7 @@ const pump = async (s) => {
 			let result;
 			try {
 				const send = () => transport.send(lanes.frame);
-				result = await (s.shared && !s.deactivated ? s.store.lock(send) : send());
+				result = await (s.shared && !s.deactivated && lanes.entries.length > 0 ? s.store.lock(send) : send());
 			} catch {
 				if (!s.running || isFinished(s)) return;
 				if (lanes.frame.ctx?.length) {
@@ -807,7 +831,7 @@ const adoptStored = (s) => {
 		const known = new Set(laneEntries(s, protocol).map((p) => p.seq));
 		for (const { seq, ...command } of lane.commands) {
 			if (known.has(seq)) continue;
-			const params = command.meta === void 0 ? command.params : reviveDocumentValue([...command.params], command.meta);
+			const params = command.meta === void 0 ? command.params : reviveDocumentValue(structuredClone(command.params), command.meta);
 			const entry = {
 				seq,
 				command: {
@@ -905,7 +929,7 @@ const retryFailed = (s, entry) => {
 	});
 	const found = findFailed(s, entry);
 	if (found === void 0) throw unknownFailed(entry);
-	const params = found.meta === void 0 ? found.params : reviveDocumentValue([...found.params], found.meta);
+	const params = found.meta === void 0 ? found.params : reviveDocumentValue(structuredClone(found.params), found.meta);
 	const result = new Promise((resolve, reject) => {
 		const retry = () => {
 			if (!s.running) {
@@ -1005,11 +1029,11 @@ const loadSessionRecord = (store, options) => {
 			store.save(stored);
 		}
 	}
-	const record = stored ?? {
+	const record = stored === null ? {
 		clientId: randomId(),
 		lanes: {}
-	};
-	if (stored === null) store.save(record);
+	} : boundRecord(stored);
+	if (record !== stored) store.save(record);
 	return record;
 };
 const setContext = (s, protocol, value) => {
@@ -1062,6 +1086,7 @@ const useStatewireSession = (options) => {
 			documentStore,
 			shared: store.lock !== void 0 ? {
 				txq: Promise.resolve(),
+				syncQueued: false,
 				parked: [],
 				unsubscribe: null
 			} : false,
@@ -1157,7 +1182,6 @@ const useStatewireSession = (options) => {
 	}, [s]);
 	return s;
 };
-//#endregion
-export { discardFailed, documentSource, failedCommands, invokeProtocol, retryFailed, setContext, setTransport, useStatewireSession };
+export { MAX_FAILED_RETAINED, discardFailed, documentSource, failedCommands, invokeProtocol, retryFailed, setContext, setTransport, useStatewireSession };
 
 //# sourceMappingURL=session.js.map