experimental-a2 0.13.0 → 0.14.0

package/dist/{client-P_NNNRM-.d.ts → client-BAEABRZB.d.ts}

@@ -1,4 +1,4 @@
-import { a as ContractEvent, c as PresenceDefs, l as PresenceMap, p as WithPresence, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-DJKWm3cp.js";
+import { a as ContractEvent, c as PresenceDefs, l as PresenceMap, p as WithPresence, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-BcS9VDKC.js";
 import { n as A2ErrorCode, t as A2Error } from "./errors-DvhSXnxk.js";
 //#region src/client-errors.d.ts
 type A2ClientErrorOptions = {
@@ -240,4 +240,4 @@ type CreateClientOptions<D extends EventDefs, S, P extends PresenceDefs = Record
 declare function createClient<D extends EventDefs, S, P extends PresenceDefs = Record<never, never>>(options: CreateClientOptions<D, S, P>): A2Client<D, S, P>;
 //#endregion
 export { createClient as _, Connection as a, HistoryState as c, ReconnectPolicy as d, SessionClient as f, SessionUrl as g, SessionSnapshot as h, ClientWebSocketConstructor as i, LoadHistoryOptions as l, SessionOptions as m, ClientApi as n, ConnectionStatus as o, SessionClientPresence as p, ClientWebSocket as r, CreateClientOptions as s, A2Client as t, PushResult as u, A2ClientError as v, A2ClientErrorOptions as y };
-//# sourceMappingURL=client-P_NNNRM-.d.ts.map
+//# sourceMappingURL=client-BAEABRZB.d.ts.map

package/dist/{client-P_NNNRM-.d.ts.map → client-BAEABRZB.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"client-P_NNNRM-.d.ts","names":[],"sources":["../src/client-errors.ts","../src/client.ts"],"mappings":";;;KAEY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;cAGW,sBAAsB;WACxB;WACA;WACA;WACA;WACA;EAET,YACE,MAAM,aACN,iBACA,UAAU;;;;KCkCF,mBAAmB;EAC7B;EACA,OAAO;EACP;;KAGU;;;;;;;KASA;EACN;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;EAAkB;EAAoB,OAAO;;EAC7C;EAAgB;;EAChB;;;;;;;;;;KAUM,WAAW,UAAU,aAAa,QAAQ,cAAc;WACzD,WAAW,QAAQ,cAAc;;KAGhC;;;;;;EAMV;;EAEA;;;KAIU;;EAEV;;EAEA;;EAEA;;;KAIU,gBACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aACF;;EAGE,UAAU,YAAY;;;EAIxB,OAAO;;;;;EAKP,QAAQ,cAAc;;;EAGtB;;EAEA,SAAS;EACT,YAAY;;;;;;;KAQF,sBAAsB,UAAU;;;;;;;;;;EAU1C,YAAY,QAAQ,cAAc;;KAGxB,cACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aAAa,GAAG,sBAAsB;WAC/B;EACT,UAAU;EACV,eAAe,gBAAgB,GAAG,GAAG;;;;;;;;;;EAUrC,QAAQ,QAAQ,YAAY,OAAO,WAAW;;;;;;;;;;;EAW9C,YAAY,UAAU,qBAAqB,QAAQ,cAAc;;;;;;;;;;EAUjE;;;EAGA;;;;;;EAMA;;KAGU,eAAe,UAAU,WAAW;EAC9C,eAAe;EACf;;EAEA,gBAAgB,cAAc;;;EAG9B;;KAGU,SACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,QACE,mBACA,UAAU,eAAe,GAAG,KAC3B,cAAc,GAAG,GAAG;;;;;;;;;KAUb,wBAAwB;KAExB,YACR;EACE;EAAc,MAAM;EAAY,QAAQ;;EAExC;EAAY,KAAK;EAAY;;EAE7B;EAAY;EAAa;;;;;;;KAOnB;WACD;EACT,KAAK;EACL,MAAM,eAAe;EACrB,iBAAiB,cAAc;EAC/B,iBACE,iBACA,WAAW;IAAS;;EAEtB,iBACE,eACA,WAAW;IAAS;IAAc;;EAEpC,iBAAiB,eAAe;;KAGtB,kCAAkC,gBAAgB;KAElD,oBACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,SAAS,QAAQ,GAAG,GAAG;;EAEvB,KAAK;;EAEL,YAAY;;EAEZ,eAAe,WAAW;;;EAG1B,YAAY;;;EAGZ;;;;;;;;EAQA;;iBAk9Bc,aACd,UAAU,WACV,GACA,UAAU,eAAe,sBACzB,SAAS,oBAAoB,GAAG,GAAG,KAAK,SAAS,GAAG,GAAG"}
+{"version":3,"file":"client-BAEABRZB.d.ts","names":[],"sources":["../src/client-errors.ts","../src/client.ts"],"mappings":";;;KAEY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;cAGW,sBAAsB;WACxB;WACA;WACA;WACA;WACA;EAET,YACE,MAAM,aACN,iBACA,UAAU;;;;KCkCF,mBAAmB;EAC7B;EACA,OAAO;EACP;;KAGU;;;;;;;KASA;EACN;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;EAAkB;EAAoB,OAAO;;EAC7C;EAAgB;;EAChB;;;;;;;;;;KAUM,WAAW,UAAU,aAAa,QAAQ,cAAc;WACzD,WAAW,QAAQ,cAAc;;KAGhC;;;;;;EAMV;;EAEA;;;KAIU;;EAEV;;EAEA;;EAEA;;;KAIU,gBACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aACF;;EAGE,UAAU,YAAY;;;EAIxB,OAAO;;;;;EAKP,QAAQ,cAAc;;;EAGtB;;EAEA,SAAS;EACT,YAAY;;;;;;;KAQF,sBAAsB,UAAU;;;;;;;;;;EAU1C,YAAY,QAAQ,cAAc;;KAGxB,cACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aAAa,GAAG,sBAAsB;WAC/B;EACT,UAAU;EACV,eAAe,gBAAgB,GAAG,GAAG;;;;;;;;;;EAUrC,QAAQ,QAAQ,YAAY,OAAO,WAAW;;;;;;;;;;;EAW9C,YAAY,UAAU,qBAAqB,QAAQ,cAAc;;;;;;;;;;EAUjE;;;EAGA;;;;;;EAMA;;KAGU,eAAe,UAAU,WAAW;EAC9C,eAAe;EACf;;EAEA,gBAAgB,cAAc;;;EAG9B;;KAGU,SACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,QACE,mBACA,UAAU,eAAe,GAAG,KAC3B,cAAc,GAAG,GAAG;;;;;;;;;KAUb,wBAAwB;KAExB,YACR;EACE;EAAc,MAAM;EAAY,QAAQ;;EAExC;EAAY,KAAK;EAAY;;EAE7B;EAAY;EAAa;;;;;;;KAOnB;WACD;EACT,KAAK;EACL,MAAM,eAAe;EACrB,iBAAiB,cAAc;EAC/B,iBACE,iBACA,WAAW;IAAS;;EAEtB,iBACE,eACA,WAAW;IAAS;IAAc;;EAEpC,iBAAiB,eAAe;;KAGtB,kCAAkC,gBAAgB;KAElD,oBACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,SAAS,QAAQ,GAAG,GAAG;;EAEvB,KAAK;;EAEL,YAAY;;EAEZ,eAAe,WAAW;;;EAG1B,YAAY;;;EAGZ;;;;;;;;EAQA;;iBAk9Bc,aACd,UAAU,WACV,GACA,UAAU,eAAe,sBACzB,SAAS,oBAAoB,GAAG,GAAG,KAAK,SAAS,GAAG,GAAG"}

package/dist/{client-Bf6uSEAk.js → client-BYzHjkwU.js}

@@ -1,4 +1,5 @@
 import { n as validateSync } from "./validate-XKT4FSNn.js";
+import { t as clientStateProjection } from "./reducer-DEMjEY_O.js";
 import { t as A2Error } from "./errors-DCk6ch5n.js";
 import { a as PRESENCE_TIMINGS, c as STREAM_TIMINGS, h as nullProtoRecord, o as RESERVED_PARTICIPANT_IDS } from "./internal-Dq2qYxou.js";
 import { c as isWireEvent, d as parseSocketFrame, f as presencePatchFromWire, l as isWirePresencePatch, m as presenceSnapshotFromWire, o as eventFromWire, r as errorFromWire, u as isWirePresenceSnapshot } from "./wire-BO5wWCb1.js";
@@ -749,7 +750,7 @@ function createClient(options) {
 		};
 		const overlayEvents = () => {
 			const acked = pending.filter((p) => p.acked).map((p) => p.acked).toSorted((a, b) => a.index - b.index);
-			const maxKnown = acked.at(-1)?.index ?? stateIndex;
+			const maxKnown = Math.max(stateIndex, acked.at(-1)?.index ?? stateIndex);
 			const unacked = pending.filter((p) => !p.acked).map((p, i) => ({
 				id: p.id,
 				type: p.type,
@@ -787,10 +788,23 @@ function createClient(options) {
 		const buildSnapshot = () => {
 			const overlay = overlayEvents();
 			let state = foldedState;
-			for (const event of overlay) state = reducer.fold(state, event);
+			for (const event of overlay) if (event.index > stateIndex) state = reducer.fold(state, event);
+			const displayedOverlay = overlay.filter((event) => {
+				if (event.index > stateIndex) return true;
+				let low = 0;
+				let high = serverEvents.length - 1;
+				while (low <= high) {
+					const middle = Math.floor((low + high) / 2);
+					const observed = serverEvents[middle];
+					if (observed.index === event.index) return observed.id !== event.id;
+					if (observed.index < event.index) low = middle + 1;
+					else high = middle - 1;
+				}
+				return true;
+			});
 			return {
-				state,
-				events: [...serverEvents, ...overlay],
+				state: reducer[clientStateProjection]?.(state) ?? state,
+				events: [...serverEvents, ...displayedOverlay],
 				index: stateIndex,
 				history: historyState(),
 				connection: connection(),
@@ -1029,6 +1043,7 @@ function createClient(options) {
 						const entry = pending.find((p) => p.id === event.id);
 						if (entry) entry.acked = event;
 					}
+					pending = pending.filter((entry) => entry.acked === void 0 || entry.acked.index > Math.min(stateIndex, streamIndex ?? stateIndex));
 					if ((acked.at(-1)?.index ?? 0) > (streamIndex ?? stateIndex)) refreshIdleStream();
 					notify();
 					return acked;
@@ -1309,7 +1324,7 @@ function createClient(options) {
 				stateIndex = nextIndex;
 				foldedState = next.initialState;
 				mergeServerEvents(next.initialEvents, stateIndex);
-				pending = pending.filter((entry) => !entry.acked || entry.acked.index > stateIndex);
+				pending = pending.filter((entry) => !entry.acked || entry.acked.index > Math.min(stateIndex, streamIndex ?? stateIndex));
 				if (confirmWatchers.some((watcher) => watcher.index <= stateIndex)) {
 					const due = confirmWatchers.filter((watcher) => watcher.index <= stateIndex);
 					confirmWatchers = confirmWatchers.filter((watcher) => watcher.index > stateIndex);
@@ -1339,4 +1354,4 @@ function createClient(options) {
 //#endregion
 export { A2ClientError as n, createClient as t };
 
-//# sourceMappingURL=client-Bf6uSEAk.js.map
+//# sourceMappingURL=client-BYzHjkwU.js.map

package/dist/client-BYzHjkwU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-BYzHjkwU.js","names":[],"sources":["../src/client-errors.ts","../src/client.ts"],"sourcesContent":["import { A2Error, type A2ErrorCode } from './errors.ts'\n\nexport type A2ClientErrorOptions = {\n  details?: unknown\n  cause?: unknown\n  status?: number\n  closeCode?: number\n  closeReason?: string\n  phase?: 'stream' | 'subscribe'\n  timeoutMs?: number\n}\n\nexport class A2ClientError extends A2Error {\n  readonly status: number | undefined\n  readonly closeCode: number | undefined\n  readonly closeReason: string | undefined\n  readonly phase: 'stream' | 'subscribe' | undefined\n  readonly timeoutMs: number | undefined\n\n  constructor(\n    code: A2ErrorCode,\n    message: string,\n    options?: A2ClientErrorOptions,\n  ) {\n    super(code, message, options)\n    this.name = 'A2ClientError'\n    this.status = options?.status\n    this.closeCode = options?.closeCode\n    this.closeReason = options?.closeReason\n    this.phase = options?.phase\n    this.timeoutMs = options?.timeoutMs\n  }\n}\n\nexport function asClientError(\n  error: unknown,\n  options?: { code?: A2ErrorCode },\n): A2ClientError {\n  if (error instanceof A2ClientError) return error\n  if (error instanceof A2Error) {\n    return new A2ClientError(error.code, error.message, {\n      details: error.details,\n      cause: error,\n    })\n  }\n  return new A2ClientError(\n    options?.code ?? 'UNKNOWN',\n    error instanceof Error ? error.message : 'client operation failed',\n    { cause: error },\n  )\n}\n","/**\n * experimental-a2/client — the framework-agnostic session client.\n *\n * Everything the browser needs to read a session live and push\n * optimistically, with no framework attached: the SSE subscription with\n * frontier resume and reconnection, the optimistic push queue with\n * ack/rollback, and the local fold through the same reducer the server\n * uses. `experimental-a2/react`'s `createReact` is a thin binding over it, and the\n * store contract (`subscribe`/`getSnapshot`) is exactly what\n * `useSyncExternalStore` wants.\n *\n * The client is a replica, never an access path — the routes it talks\n * to authorize every read and write.\n */\n\n// oxlint-disable no-await-in-loop -- retry/backoff/stream loops are sequential by nature\nimport { A2ClientError, asClientError } from './client-errors.ts'\nimport {\n  PRESENCE_TIMINGS,\n  RESERVED_PARTICIPANT_IDS,\n  STREAM_TIMINGS,\n  nullProtoRecord,\n} from './internal.ts'\nimport type {\n  AppendInput,\n  ContractEvent,\n  EventDefs,\n  PresenceDefs,\n  PresenceMap,\n  PresencePatch,\n  WithPresence,\n} from './contract.ts'\nimport { clientStateProjection, type Reducer } from './reducer.ts'\nimport { validateSync } from './validate.ts'\nimport {\n  errorFromWire,\n  eventFromWire,\n  isWireEvent,\n  isWirePresencePatch,\n  isWirePresenceSnapshot,\n  parseSocketFrame,\n  presencePatchFromWire,\n  presenceSnapshotFromWire,\n  type SocketDownFrame,\n  type SocketPresenceFrame,\n  type SocketPushFrame,\n  type SocketSubscribeFrame,\n  type SocketUnsubscribeFrame,\n  type WireEvent,\n  type WirePresencePatch,\n  type WirePresenceSnapshot,\n} from './wire.ts'\n\nexport { A2ClientError } from './client-errors.ts'\nexport type { A2ClientErrorOptions } from './client-errors.ts'\n\nexport type ReconnectPolicy = (failure: {\n  sessionId: string\n  error: A2ClientError | null\n  attempt: number\n}) => number | false\n\nexport type ConnectionStatus =\n  'idle' | 'connecting' | 'paused' | 'live' | 'closed'\n\n/**\n * The connection, as a discriminated union — impossible states are\n * unrepresentable: an error only exists while disconnected,\n * `reconnects` only once a connection has been attempted.\n * \"Reconnecting…\" is `status === 'connecting' && reconnects > 0`.\n */\nexport type Connection =\n  | { status: 'idle' }\n  | {\n      status: 'connecting'\n      /** Stream restarts so far. `0` = first connect. */\n      reconnects: number\n      /** Why the last connection ended; `null` on the first connect. */\n      error: A2ClientError | null\n    }\n  | { status: 'paused'; reconnects: number; error: A2ClientError | null }\n  | { status: 'live'; reconnects: number }\n  | { status: 'closed' }\n\n/**\n * What `push` returns: resolves at the server ack (exactly like a\n * plain promise — `await push(...)` gives the acked events), and\n * carries `confirmed` for the later moment when the live stream has\n * delivered the whole batch back and the optimistic overlay entry\n * retired — the view now shows server truth. `confirmed` is lazy:\n * never accessed, never created. A rejected push rejects both.\n */\nexport type PushResult<D extends EventDefs> = Promise<ContractEvent<D>[]> & {\n  readonly confirmed: Promise<ContractEvent<D>[]>\n}\n\nexport type LoadHistoryOptions = {\n  /**\n   * Exclusive upper bound for the fetch. Defaults to the oldest\n   * already-loaded index — successive calls page backward — or one\n   * past the hydration frontier while nothing is loaded yet.\n   */\n  before?: number\n  /** Page size; defaults to 50. */\n  limit?: number\n}\n\n/** Backscroll progress, derived from the raw event feed. */\nexport type HistoryState = {\n  /** A `loadHistory` fetch is in flight. */\n  loading: boolean\n  /** The feed reaches index 1 — nothing older remains to fetch. */\n  complete: boolean\n  /** The oldest loaded index; `null` while nothing is loaded. */\n  oldestLoaded: number | null\n}\n\n/** One immutable view of the session — stable identity between changes. */\nexport type SessionSnapshot<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs = Record<never, never>,\n> = WithPresence<\n  P,\n  {\n    /** The replicated presence map, this client included (local echo). */\n    presence: PresenceMap<P>\n  }\n> & {\n  /** The live view: server events folded, optimistic pushes applied. */\n  state: S\n  /** The raw event feed: server truth — observed, seeded, or\n   * backscrolled via `loadHistory` — plus pending optimistic events\n   * (provisional indexes past the frontier). `state` never folds\n   * backscrolled events; they are display data below the frontier. */\n  events: ContractEvent<D>[]\n  /** The latest server-confirmed state index. This is the\n   * `lastSeenIndex` cancellation wants. */\n  index: number\n  /** Backscroll progress — `loadHistory` moves it. */\n  history: HistoryState\n  connection: Connection\n}\n\n/**\n * The presence member of a client session — intersected in via\n * `WithPresence`, so it exists exactly when the contract declares\n * presence fields.\n */\nexport type SessionClientPresence<P extends PresenceDefs> = {\n  /**\n   * Fire-and-forget presence: validates locally against the reducer's\n   * presence schemas, merges into the local map immediately (the\n   * echo), and coalesces on the wire to a fixed cadence — a leading\n   * send immediately, then at most one merged send per interval,\n   * later values winning field-wise. `null` clears a field. No ack,\n   * no retry, no rollback: a lost patch is repainted by the next one.\n   * Requires the session's `participant`.\n   */\n  setPresence(values: PresencePatch<P>['values']): void\n}\n\nexport type SessionClient<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs = Record<never, never>,\n> = WithPresence<P, SessionClientPresence<P>> & {\n  readonly sessionId: string\n  subscribe(listener: () => void): () => void\n  getSnapshot(): SessionSnapshot<D, S, P>\n  /**\n   * Optimistic append: validates locally against the reducer's event\n   * schemas (instant `INVALID_PAYLOAD`, no flicker), applies to the\n   * local fold, POSTs, swaps in the ack, rolls back on rejection.\n   * Auto-retries `STORE_UNAVAILABLE` and transport failures. Resolves with the appended\n   * events as the server recorded them. Overlapping calls on this\n   * handle enter the transport in invocation order without delaying\n   * their optimistic folds.\n   */\n  push(...events: AppendInput<D>[]): PushResult<D>\n  /**\n   * Backscroll: fetch a bounded slice of events from below the\n   * frontier and merge it into `events` — deduped, ordered, shared by\n   * every handle of this session. Folded state and the optimistic\n   * overlay are never touched. Calls serialize per session and skip\n   * already-loaded ranges, so overlapping backscrolls never fetch the\n   * same range twice. Resolves with the events in the requested range.\n   * Requires an http api; the `ws` transport has no history lane and\n   * this throws a TypeError there.\n   */\n  loadHistory(options?: LoadHistoryOptions): Promise<ContractEvent<D>[]>\n  /**\n   * Take a lease on the live stream and return its release. Leases\n   * refcount per handle — the first connects, releasing the last\n   * closes — so independent consumers of one identity-mapped handle\n   * (two hooks, a hook plus vanilla code) never fight over the\n   * stream. Releasing twice is a no-op. While any lease is held the\n   * stream follows the client's reconnection policy and resumes after\n   * its last streamed event.\n   */\n  connect(): () => void\n  /** Restart a leased subscription immediately after its last streamed event.\n   * Preserves state, pending writes, and leases. No-op without a lease. */\n  reconnect(): void\n  /**\n   * The hard stop: drops every outstanding lease and closes the\n   * stream now. Not terminal — a later `connect()` starts fresh from\n   * the last streamed event.\n   */\n  close(): void\n}\n\nexport type SessionOptions<D extends EventDefs, S> = {\n  initialState?: S\n  initialIndex?: number\n  /** Server-rendered history through `initialIndex`. Seeds the event feed. */\n  initialEvents?: ContractEvent<D>[]\n  /** Overrides the client's `participant` for this session handle.\n   * Bound once per handle. */\n  participant?: string\n}\n\nexport type A2Client<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs = Record<never, never>,\n> = {\n  session(\n    sessionId: string,\n    options?: SessionOptions<D, S>,\n  ): SessionClient<D, S, P>\n}\n\n/**\n * The wire the client rides. The first form is one route serving GET\n * (SSE stream) + POST (push). `http` splits the verbs across two\n * routes, for when platform duration limits differ per verb. `ws`\n * rides everything over WebSocket, one socket per session by default.\n * Multiplexing every session of the client is an explicit opt-in.\n */\nexport type SessionUrl = string | ((sessionId: string) => string)\n\nexport type ClientApi =\n  | SessionUrl // one route: GET SSE stream + POST push\n  | { type: 'http'; push: SessionUrl; stream: SessionUrl } // split routes\n  /** One socket per session. */\n  | { type: 'ws'; url: SessionUrl; multiplex?: false }\n  /** One socket for every session of this client. */\n  | { type: 'ws'; url: string; multiplex: true }\n\n/**\n * The socket surface the `ws` transport drives — satisfied structurally\n * by the DOM `WebSocket` and Node's alike, and small enough to fake in\n * tests.\n */\nexport type ClientWebSocket = {\n  readonly readyState: number\n  send(data: string): void\n  close(code?: number, reason?: string): void\n  addEventListener(type: 'open', listener: () => void): void\n  addEventListener(\n    type: 'message',\n    listener: (event: { data: unknown }) => void,\n  ): void\n  addEventListener(\n    type: 'close',\n    listener: (event: { code: number; reason: string }) => void,\n  ): void\n  addEventListener(type: 'error', listener: () => void): void\n}\n\nexport type ClientWebSocketConstructor = new (url: string) => ClientWebSocket\n\nexport type CreateClientOptions<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs = Record<never, never>,\n> = {\n  reducer: Reducer<D, S, P>\n  /** The route (or routes) the client speaks — see `ClientApi`. */\n  api: ClientApi\n  /** Delay the next connection attempt in milliseconds, or pause with false. */\n  reconnect?: ReconnectPolicy\n  /** Injectable fetch — defaults to the global. */\n  fetch?: typeof globalThis.fetch\n  /** Injectable WebSocket constructor for the `ws` api — defaults to\n   * the global. The http transports never touch it. */\n  webSocket?: ClientWebSocketConstructor\n  /** How long an idle session keeps its in-memory identity, in\n   * milliseconds. Defaults to five minutes; `Infinity` disables GC. */\n  gcTime?: number\n  /**\n   * This client's presence identity — required to call `setPresence`.\n   * Caller-supplied (a user id, a tab nonce, a guest name): A2 does\n   * not invent an identity story; the app states it once here. The\n   * default for every session handle this client creates;\n   * `session(id, { participant })` overrides it per handle.\n   */\n  participant?: string\n}\n\nconst PUSH_ATTEMPTS = 3\nconst RETRYABLE_PUSH_CODES = new Set([\n  'STORE_UNAVAILABLE',\n  'TIMEOUT',\n  'HTTP_ERROR',\n  'CONNECTION_FAILED',\n  'UNKNOWN',\n])\nconst DEFAULT_GC_TIME_MS = 5 * 60 * 1_000\nconst DEFAULT_HISTORY_LIMIT = 50\n\n// ── the transport seam ───────────────────────────────────────────────\n// Everything above it — optimistic queue, retry loop, presence\n// throttle, reconnect/backoff, stall watchdog — is transport-agnostic.\n\n/** The parsed frame lanes every transport yields: the SSE frame\n * discrimination today, the ws `kind` discriminant tomorrow. `ping`\n * carries no data — it exists so the watchdog sees liveness. */\ntype TransportFrame =\n  | { kind: 'event'; event: WireEvent }\n  | { kind: 'presence'; patch: WirePresencePatch }\n  | { kind: 'presence-snapshot'; snapshot: WirePresenceSnapshot }\n  | { kind: 'activity'; idle: boolean }\n  | { kind: 'ping' }\n\ntype TransportPushBody = {\n  sessionId: string\n  events: Array<{ id: string; type: string; payload: unknown }>\n}\n\ntype TransportPresenceEnvelope = {\n  sessionId: string\n  presence: {\n    participant: string\n    values: Record<string, unknown>\n    seen: number\n    at: number\n  }\n}\n\ntype Transport = {\n  /**\n   * One live read: the first frame means the stream is established\n   * (any kind — a bare `ping` when no data is pending), the iterable\n   * ending or throwing is the disconnect. The caller owns\n   * reconnect/backoff and counts every frame as liveness.\n   */\n  connect(opts: {\n    sessionId: string\n    startAfter: number\n    signal: AbortSignal\n  }): AsyncIterable<TransportFrame>\n  /** One attempt (the retry loop lives above the seam): resolves with\n   * the acked wire events, throws A2ClientError. */\n  push(body: TransportPushBody): Promise<WireEvent[]>\n  /** One bounded cold read of the log, oldest first — the lane\n   * `loadHistory` rides. Absent on transports without a\n   * request/response wire (ws), where `loadHistory` fails fast. */\n  history?(opts: {\n    sessionId: string\n    gte: number\n    lte: number\n  }): Promise<WireEvent[]>\n  /** Fire-and-forget; failures are dropped (presence repaints). */\n  sendPresence(envelope: TransportPresenceEnvelope): void\n  /**\n   * Resolve when the session's wire can carry a push again, or after\n   * `maxWaitMs` — whichever comes first; never rejects. Transports\n   * whose pushes are connection-bound (ws) implement it so the retry\n   * loop waits for the wire instead of a fixed clock; HTTP pushes are\n   * stream-independent and omit it.\n   */\n  awaitReady?(sessionId: string, maxWaitMs: number): Promise<void>\n}\n\nconst sessionUrl = (url: SessionUrl, sessionId: string): string => {\n  const resolved = typeof url === 'function' ? url(sessionId) : url\n  if (typeof resolved !== 'string') {\n    throw new TypeError('a session URL function must return a string')\n  }\n  return resolved\n}\n\nconst httpError = async (response: Response): Promise<A2ClientError> => {\n  const error = errorFromWire(await response.json().catch(() => null))\n  return error === null\n    ? new A2ClientError(\n        'HTTP_ERROR',\n        `request failed with ${response.status}`,\n        {\n          status: response.status,\n        },\n      )\n    : new A2ClientError(error.code, error.message, {\n        details: error.details,\n        status: response.status,\n        cause: error,\n      })\n}\n\nconst httpTransport = (\n  routes: { push: SessionUrl; stream: SessionUrl },\n  fetchImpl: typeof globalThis.fetch,\n  // Contracts that declare no presence skip presence frames unparsed,\n  // exactly like unknown named frames.\n  presence: boolean,\n): Transport => ({\n  async *connect({ sessionId, startAfter, signal }) {\n    const streamUrl = sessionUrl(routes.stream, sessionId)\n    const sep = streamUrl.includes('?') ? '&' : '?'\n    const res = await fetchImpl(\n      `${streamUrl}${sep}sessionId=${encodeURIComponent(sessionId)}&index=${startAfter}`,\n      { headers: { accept: 'text/event-stream' }, signal },\n    )\n    if (!res.ok) throw await httpError(res)\n    if (!res.body) {\n      throw new A2ClientError('UNKNOWN', 'stream response has no body', {\n        status: res.status,\n      })\n    }\n    yield { kind: 'ping' } // connected — headers in hand, before any bytes\n    const decoder = new TextDecoder()\n    const reader = res.body.getReader()\n    let buffer = ''\n    try {\n      for (;;) {\n        // oxlint-disable-next-line no-await-in-loop -- stream read loop\n        const { done, value } = await reader.read()\n        if (done) return\n        // Any bytes count — heartbeat comments included. Liveness is\n        // about the connection, not about events.\n        yield { kind: 'ping' }\n        buffer += decoder.decode(value, { stream: true })\n        for (;;) {\n          const boundary = buffer.indexOf('\\n\\n')\n          if (boundary === -1) break\n          const frame = buffer.slice(0, boundary)\n          buffer = buffer.slice(boundary + 2)\n          let eventName: string | undefined\n          const dataLines: string[] = []\n          for (const line of frame.split('\\n')) {\n            if (line.startsWith('data:')) {\n              dataLines.push(line.slice(5).trimStart())\n            } else if (line.startsWith('event:')) {\n              eventName = line.slice(6).trim()\n            }\n          }\n          const data = dataLines.join('\\n')\n          if (!data) continue\n          if (eventName === undefined) {\n            const parsed: unknown = JSON.parse(data)\n            if (isWireEvent(parsed)) yield { kind: 'event', event: parsed }\n          } else if (presence && eventName === 'presence-snapshot') {\n            const parsed: unknown = JSON.parse(data)\n            if (isWirePresenceSnapshot(parsed)) {\n              yield { kind: 'presence-snapshot', snapshot: parsed }\n            }\n          } else if (presence && eventName === 'presence') {\n            const parsed: unknown = JSON.parse(data)\n            if (isWirePresencePatch(parsed)) {\n              yield { kind: 'presence', patch: parsed }\n            }\n          } else if (\n            eventName === 'a2-activity' &&\n            (data === 'idle' || data === 'active')\n          ) {\n            yield { kind: 'activity', idle: data === 'idle' }\n          }\n          // Other named frames: skipped — old clients stay compatible\n          // with future lanes the same way.\n        }\n      }\n    } finally {\n      reader.cancel().catch(() => {})\n    }\n  },\n\n  async push(body) {\n    const res = await fetchImpl(sessionUrl(routes.push, body.sessionId), {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify(body),\n    })\n    if (res.ok) {\n      const rows = (await res.json()) as unknown\n      if (!Array.isArray(rows) || !rows.every(isWireEvent)) {\n        throw new A2ClientError(\n          'STORE_UNAVAILABLE',\n          'push ack was not a list of events',\n        )\n      }\n      return rows\n    }\n    throw await httpError(res)\n  },\n\n  async history({ sessionId, gte, lte }) {\n    const streamUrl = sessionUrl(routes.stream, sessionId)\n    const sep = streamUrl.includes('?') ? '&' : '?'\n    const res = await fetchImpl(\n      `${streamUrl}${sep}sessionId=${encodeURIComponent(sessionId)}&gte=${gte}&lte=${lte}`,\n      { headers: { accept: 'application/json' } },\n    )\n    if (!res.ok) {\n      throw await httpError(res)\n    }\n    const rows = (await res.json()) as unknown\n    if (!Array.isArray(rows) || !rows.every(isWireEvent)) {\n      throw new A2ClientError(\n        'STORE_UNAVAILABLE',\n        'history response was not a list of events',\n      )\n    }\n    return rows\n  },\n\n  sendPresence(envelope) {\n    void (async () => {\n      try {\n        const res = await fetchImpl(\n          sessionUrl(routes.push, envelope.sessionId),\n          {\n            method: 'POST',\n            headers: { 'content-type': 'application/json' },\n            body: JSON.stringify(envelope),\n          },\n        )\n        await res.arrayBuffer()\n      } catch {\n        // Dropped by design — nothing was ever true.\n      }\n    })()\n  },\n})\n\n/** `WebSocket.OPEN` — fixed by the spec, identical in every runtime. */\nconst WS_OPEN = 1\n\ntype PendingAck = {\n  resolve: (events: WireEvent[]) => void\n  reject: (error: A2ClientError) => void\n}\n\nconst webSocketUrl = (value: string): URL => {\n  let resolved: URL\n  if (/^(https?|wss?):\\/\\//i.test(value)) {\n    resolved = new URL(value)\n  } else {\n    const base = (globalThis as { location?: { href: string } }).location?.href\n    if (base === undefined) {\n      throw new TypeError(\n        `cannot resolve the relative ws url '${value}' without a browser location — pass an absolute ws:// or wss:// url`,\n      )\n    }\n    resolved = new URL(value, base)\n  }\n  if (resolved.protocol === 'http:') resolved.protocol = 'ws:'\n  else if (resolved.protocol === 'https:') resolved.protocol = 'wss:'\n  return resolved\n}\n\nconst socketReadyWaiters = () => {\n  const sessions = new Map<string, Set<() => void>>()\n\n  const notify = (sessionId: string): void => {\n    const waiters = sessions.get(sessionId)\n    if (!waiters) return\n    sessions.delete(sessionId)\n    for (const waiter of waiters) waiter()\n  }\n\n  const wait = (sessionId: string, maxWaitMs: number): Promise<void> =>\n    new Promise((resolve) => {\n      let waiters = sessions.get(sessionId)\n      if (!waiters) {\n        waiters = new Set()\n        sessions.set(sessionId, waiters)\n      }\n      let settled = false\n      const done = (): void => {\n        if (settled) return\n        settled = true\n        clearTimeout(timer)\n        waiters.delete(done)\n        if (waiters.size === 0) sessions.delete(sessionId)\n        // oxlint-disable-next-line promise/no-multiple-resolved -- `settled` guards the timer and notification callers\n        resolve()\n      }\n      const timer = setTimeout(done, maxWaitMs)\n      ;(timer as { unref?: () => void }).unref?.()\n      waiters.add(done)\n    })\n\n  return { notify, wait }\n}\n\nconst rejectPendingAcks = (pending: Map<number, PendingAck>): void => {\n  if (pending.size === 0) return\n  const error = new A2ClientError(\n    'STORE_UNAVAILABLE',\n    'socket closed with the ack outstanding',\n  )\n  for (const waiter of pending.values()) waiter.reject(error)\n  pending.clear()\n}\n\nconst sessionWsTransport = (\n  url: SessionUrl,\n  webSocketImpl: ClientWebSocketConstructor | undefined,\n  presence: boolean,\n): Transport => {\n  type SocketConnection = {\n    socket: ClientWebSocket\n    pending: Map<number, PendingAck>\n  }\n\n  const connections = new Map<string, SocketConnection>()\n  const ready = socketReadyWaiters()\n  let nextReq = 1\n\n  const socketUrl = (sessionId: string, startAfter: number): string => {\n    const resolved = webSocketUrl(sessionUrl(url, sessionId))\n    resolved.searchParams.set('sessionId', sessionId)\n    resolved.searchParams.set('index', String(startAfter))\n    return resolved.href\n  }\n\n  return {\n    async *connect({ sessionId, startAfter, signal }) {\n      if (webSocketImpl === undefined) {\n        throw new TypeError(\n          'no WebSocket implementation available — pass one via createClient({ webSocket }) where the global is missing',\n        )\n      }\n      const socket = new webSocketImpl(socketUrl(sessionId, startAfter))\n      const connection: SocketConnection = { socket, pending: new Map() }\n      connections.set(sessionId, connection)\n\n      const queue: TransportFrame[] = []\n      let ended = false\n      let failure: Error | null = null\n      let wake: (() => void) | null = null\n      const notify = (): void => {\n        wake?.()\n        wake = null\n      }\n      const finish = (error: Error | null): void => {\n        if (ended) return\n        ended = true\n        failure = error\n        if (connections.get(sessionId) === connection) {\n          connections.delete(sessionId)\n        }\n        rejectPendingAcks(connection.pending)\n        notify()\n      }\n\n      socket.addEventListener('open', () => {\n        if (connections.get(sessionId) !== connection || ended) return\n        queue.push({ kind: 'ping' })\n        notify()\n        ready.notify(sessionId)\n      })\n      socket.addEventListener('message', (event) => {\n        if (connections.get(sessionId) !== connection || ended) return\n        if (typeof event.data !== 'string') return\n        const frame = parseSocketFrame(event.data)\n        if (frame === null) return\n        switch (frame.kind) {\n          case 'ack': {\n            const waiter = connection.pending.get(frame.req)\n            if (waiter === undefined) return\n            connection.pending.delete(frame.req)\n            if (\n              frame.sessionId !== undefined ||\n              ('events' in frame &&\n                frame.events.some((row) => row.sessionId !== sessionId))\n            ) {\n              waiter.reject(\n                new A2ClientError(\n                  'STORE_UNAVAILABLE',\n                  'ack does not belong to the socket session',\n                ),\n              )\n              return\n            }\n            if ('events' in frame) waiter.resolve(frame.events)\n            else waiter.reject(asClientError(frame.error))\n            return\n          }\n          case 'event':\n            if (frame.event.sessionId !== sessionId) return\n            queue.push({ kind: 'event', event: frame.event })\n            break\n          case 'presence':\n            if (presence && frame.sessionId === undefined) {\n              queue.push({ kind: 'presence', patch: frame.patch })\n            }\n            break\n          case 'presence-snapshot':\n            if (presence && frame.sessionId === undefined) {\n              queue.push({\n                kind: 'presence-snapshot',\n                snapshot: frame.snapshot,\n              })\n            }\n            break\n          case 'ping':\n            queue.push(frame)\n            break\n          case 'subscribed':\n          case 'unsubscribed':\n            return\n        }\n        notify()\n      })\n      socket.addEventListener('close', (event) => {\n        finish(\n          event.code === 1000\n            ? null\n            : new A2ClientError(\n                'CONNECTION_FAILED',\n                `socket closed (${event.code}${event.reason ? `: ${event.reason}` : ''})`,\n                { closeCode: event.code, closeReason: event.reason },\n              ),\n        )\n      })\n      socket.addEventListener('error', () => {\n        finish(new A2ClientError('CONNECTION_FAILED', 'socket error'))\n      })\n\n      const onAbort = (): void => {\n        finish(\n          signal.reason instanceof Error\n            ? signal.reason\n            : new Error('stream aborted'),\n        )\n        try {\n          socket.close(1000)\n        } catch {\n          // Already closed.\n        }\n      }\n      if (signal.aborted) onAbort()\n      else signal.addEventListener('abort', onAbort, { once: true })\n\n      try {\n        for (;;) {\n          while (queue.length > 0) yield queue.shift()!\n          if (ended) {\n            if (failure) throw failure\n            return\n          }\n          await new Promise<void>((resolve) => {\n            wake = resolve\n          })\n        }\n      } finally {\n        signal.removeEventListener('abort', onAbort)\n        finish(null)\n        try {\n          socket.close(1000)\n        } catch {\n          // Already closed.\n        }\n      }\n    },\n\n    async push(body) {\n      const connection = connections.get(body.sessionId)\n      if (\n        connection === undefined ||\n        connection.socket.readyState !== WS_OPEN\n      ) {\n        throw new A2ClientError(\n          'STORE_UNAVAILABLE',\n          'no open socket for the session',\n        )\n      }\n      const req = nextReq\n      nextReq += 1\n      return await new Promise<WireEvent[]>((resolve, reject) => {\n        connection.pending.set(req, { resolve, reject })\n        const frame: SocketPushFrame = {\n          kind: 'push',\n          req,\n          events: body.events,\n        }\n        try {\n          connection.socket.send(JSON.stringify(frame))\n        } catch (cause) {\n          connection.pending.delete(req)\n          reject(\n            new A2ClientError('STORE_UNAVAILABLE', 'socket send failed', {\n              cause,\n            }),\n          )\n        }\n      })\n    },\n\n    awaitReady(sessionId, maxWaitMs) {\n      const connection = connections.get(sessionId)\n      if (connection?.socket.readyState === WS_OPEN) return Promise.resolve()\n      return ready.wait(sessionId, maxWaitMs)\n    },\n\n    sendPresence(envelope) {\n      const connection = connections.get(envelope.sessionId)\n      if (\n        connection === undefined ||\n        connection.socket.readyState !== WS_OPEN\n      ) {\n        return\n      }\n      const frame: SocketPresenceFrame = {\n        kind: 'presence',\n        ...envelope.presence,\n      }\n      try {\n        connection.socket.send(JSON.stringify(frame))\n      } catch {\n        return\n      }\n    },\n  }\n}\n\n/** One session's lane on the shared ws socket — created per `connect`\n * attempt, so `startAfter` is that attempt's resume frontier. */\ntype WsChannel = {\n  sessionId: string\n  startAfter: number\n  queue: TransportFrame[]\n  /** The server confirmed the subscribe — pushes and presence ride. */\n  live: boolean\n  /** The server already dropped it — no unsubscribe frame owed. */\n  dropped: boolean\n  ended: boolean\n  failure: Error | null\n  wake: (() => void) | null\n}\n\nconst wakeChannel = (channel: WsChannel): void => {\n  channel.wake?.()\n  channel.wake = null\n}\n\nconst subscribeFrame = (\n  sessions: Array<{ id: string; index: number }>,\n): string => {\n  const frame: SocketSubscribeFrame = { kind: 'subscribe', sessions }\n  return JSON.stringify(frame)\n}\n\nconst multiplexedWsTransport = (\n  url: string,\n  webSocketImpl: ClientWebSocketConstructor | undefined,\n  presence: boolean,\n): Transport => {\n  // ONE socket serves every session of this client (specs §13's\n  // multiplexed superset): channels subscribe on it at their own\n  // frontiers, down frames route back by sessionId, acks by req.\n  const channels = new Map<string, WsChannel>()\n  const pending = new Map<number, PendingAck>()\n  /** Push retries parked in `awaitReady`, flushed per session on its\n   * subscribe confirmation. */\n  const ready = socketReadyWaiters()\n  let socket: ClientWebSocket | null = null\n  let socketOpen = false\n  let watchdog: ReturnType<typeof setTimeout> | undefined\n  let nextReq = 1\n\n  const trySend = (data: string): void => {\n    if (socket === null || !socketOpen) return\n    try {\n      socket.send(data)\n    } catch {\n      // Dropped — the socket is going down and its close event settles\n      // everything that depended on this frame.\n    }\n  }\n\n  const deliver = (channel: WsChannel, frame: TransportFrame): void => {\n    channel.queue.push(frame)\n    wakeChannel(channel)\n  }\n\n  const settleChannel = (channel: WsChannel, failure: Error | null): void => {\n    if (channel.ended) return\n    channel.ended = true\n    channel.failure = failure\n    wakeChannel(channel)\n  }\n\n  // Unhook the socket from the transport state and reject every\n  // outstanding ack — nothing was acked, and the client-generated ids\n  // make the retries idempotent (§13).\n  const releaseSocket = (): ClientWebSocket | null => {\n    const current = socket\n    socket = null\n    socketOpen = false\n    clearTimeout(watchdog)\n    watchdog = undefined\n    rejectPendingAcks(pending)\n    return current\n  }\n\n  // Idempotent from every direction (close event, error event, stall):\n  // every channel ends — each session's reconnect loop re-subscribes at\n  // its own current frontier.\n  const failSocket = (failure: Error | null): void => {\n    const current = releaseSocket()\n    for (const channel of channels.values()) settleChannel(channel, failure)\n    try {\n      current?.close(1000)\n    } catch {\n      // Already closed — it is down either way.\n    }\n  }\n\n  const detach = (channel: WsChannel): void => {\n    if (channels.get(channel.sessionId) !== channel) return\n    channels.delete(channel.sessionId)\n    if (!channel.dropped) {\n      const frame: SocketUnsubscribeFrame = {\n        kind: 'unsubscribe',\n        sessions: [channel.sessionId],\n      }\n      trySend(JSON.stringify(frame))\n    }\n    if (channels.size === 0) {\n      // The last session left — the shared socket has no reason to live.\n      const current = releaseSocket()\n      try {\n        current?.close(1000)\n      } catch {\n        // Already closed — it is down either way.\n      }\n    }\n  }\n\n  // One heartbeat watchdog per socket: any frame is liveness, and\n  // silence past the stall timeout means the connection is dead in a\n  // way the socket won't report.\n  const armWatchdog = (created: ClientWebSocket): void => {\n    clearTimeout(watchdog)\n    watchdog = setTimeout(() => {\n      if (socket !== created) return\n      failSocket(\n        new A2ClientError(\n          'TIMEOUT',\n          `socket stalled: no data for ${STREAM_TIMINGS.stallTimeoutMs}ms`,\n          { phase: 'stream', timeoutMs: STREAM_TIMINGS.stallTimeoutMs },\n        ),\n      )\n    }, STREAM_TIMINGS.stallTimeoutMs)\n    ;(watchdog as { unref?: () => void }).unref?.()\n  }\n\n  const route = (frame: SocketDownFrame): void => {\n    switch (frame.kind) {\n      case 'ping': {\n        // Global liveness — every live channel's stall watchdog feeds\n        // on it, the way each SSE stream feeds on its own heartbeat.\n        for (const channel of channels.values()) {\n          if (channel.live && !channel.ended) {\n            deliver(channel, { kind: 'ping' })\n          }\n        }\n        return\n      }\n      case 'subscribed': {\n        const channel = channels.get(frame.sessionId)\n        if (channel === undefined || channel.ended || channel.live) return\n        channel.live = true\n        deliver(channel, { kind: 'ping' }) // the connected signal\n        ready.notify(frame.sessionId)\n        return\n      }\n      case 'unsubscribed': {\n        const channel = channels.get(frame.sessionId)\n        if (channel === undefined) return\n        channel.dropped = true\n        settleChannel(\n          channel,\n          frame.error\n            ? asClientError(frame.error)\n            : frame.reason === undefined\n              ? null\n              : new A2ClientError('CONNECTION_FAILED', frame.reason),\n        )\n        return\n      }\n      case 'ack': {\n        const waiter = pending.get(frame.req)\n        if (waiter === undefined) return\n        pending.delete(frame.req)\n        if ('events' in frame) waiter.resolve(frame.events)\n        else waiter.reject(asClientError(frame.error))\n        return\n      }\n      case 'event': {\n        // Pre-confirmation frames are safe to drop: the subscription\n        // being confirmed replays from this channel's own frontier.\n        const channel = channels.get(frame.event.sessionId)\n        if (channel !== undefined && channel.live && !channel.ended) {\n          deliver(channel, { kind: 'event', event: frame.event })\n        }\n        return\n      }\n      case 'presence': {\n        // Contracts that declare no presence skip presence frames,\n        // exactly like the http transport.\n        if (!presence || frame.sessionId === undefined) return\n        const channel = channels.get(frame.sessionId)\n        if (channel !== undefined && channel.live && !channel.ended) {\n          deliver(channel, { kind: 'presence', patch: frame.patch })\n        }\n        return\n      }\n      case 'presence-snapshot': {\n        if (!presence || frame.sessionId === undefined) return\n        const channel = channels.get(frame.sessionId)\n        if (channel !== undefined && channel.live && !channel.ended) {\n          deliver(channel, {\n            kind: 'presence-snapshot',\n            snapshot: frame.snapshot,\n          })\n        }\n        return\n      }\n    }\n  }\n\n  const ensureSocket = (): void => {\n    if (socket !== null) return\n    if (webSocketImpl === undefined) {\n      throw new TypeError(\n        'no WebSocket implementation available — pass one via createClient({ webSocket }) where the global is missing',\n      )\n    }\n    const created = new webSocketImpl(webSocketUrl(url).href)\n    socket = created\n    socketOpen = false\n    armWatchdog(created)\n    created.addEventListener('open', () => {\n      if (socket !== created) return\n      socketOpen = true\n      armWatchdog(created)\n      const sessions = [...channels.values()]\n        .filter((channel) => !channel.ended)\n        .map((channel) => ({\n          id: channel.sessionId,\n          index: channel.startAfter,\n        }))\n      if (sessions.length > 0) trySend(subscribeFrame(sessions))\n    })\n    created.addEventListener('message', (event) => {\n      if (socket !== created) return\n      if (typeof event.data !== 'string') return\n      armWatchdog(created)\n      const frame = parseSocketFrame(event.data)\n      if (frame === null) return\n      route(frame)\n    })\n    created.addEventListener('close', (event) => {\n      if (socket !== created) return\n      failSocket(\n        event.code === 1000\n          ? null // deliberate server close — reconnect, but not an error\n          : new A2ClientError(\n              'CONNECTION_FAILED',\n              `socket closed (${event.code}${event.reason ? `: ${event.reason}` : ''})`,\n              { closeCode: event.code, closeReason: event.reason },\n            ),\n      )\n    })\n    created.addEventListener('error', () => {\n      if (socket !== created) return\n      failSocket(new A2ClientError('CONNECTION_FAILED', 'socket error'))\n    })\n  }\n\n  return {\n    async *connect({ sessionId, startAfter, signal }) {\n      const channel: WsChannel = {\n        sessionId,\n        startAfter,\n        queue: [],\n        live: false,\n        dropped: false,\n        ended: false,\n        failure: null,\n        wake: null,\n      }\n      channels.set(sessionId, channel)\n      try {\n        ensureSocket()\n        if (socketOpen) {\n          trySend(subscribeFrame([{ id: sessionId, index: startAfter }]))\n        }\n      } catch (error) {\n        if (channels.get(sessionId) === channel) channels.delete(sessionId)\n        throw error\n      }\n\n      const onAbort = (): void => {\n        settleChannel(\n          channel,\n          signal.reason instanceof Error\n            ? signal.reason\n            : new Error('stream aborted'),\n        )\n        // Synchronously, not from the pump's finally: the watchdog and\n        // close() must not leave a dead subscription behind.\n        detach(channel)\n      }\n      if (signal.aborted) onAbort()\n      else signal.addEventListener('abort', onAbort, { once: true })\n\n      // An unconfirmed subscribe receives no frames at all (global\n      // pings only feed live channels), so a server that never answers\n      // — a single-session route, say — would hang this session\n      // silently. Fail it loudly instead; the reconnect loop retries.\n      const pendingSubscribe = setTimeout(() => {\n        if (channel.live) return\n        settleChannel(\n          channel,\n          new A2ClientError(\n            'TIMEOUT',\n            'subscribe not confirmed: is the ws route calling server.fetch with upgradeWebSocket?',\n            { phase: 'subscribe', timeoutMs: STREAM_TIMINGS.stallTimeoutMs },\n          ),\n        )\n      }, STREAM_TIMINGS.stallTimeoutMs)\n      ;(pendingSubscribe as { unref?: () => void }).unref?.()\n\n      try {\n        for (;;) {\n          while (channel.queue.length > 0) yield channel.queue.shift()!\n          if (channel.ended) {\n            if (channel.failure) throw channel.failure\n            return\n          }\n          // oxlint-disable-next-line no-await-in-loop -- frame pump\n          await new Promise<void>((resolve) => {\n            channel.wake = resolve\n          })\n        }\n      } finally {\n        clearTimeout(pendingSubscribe)\n        signal.removeEventListener('abort', onAbort)\n        settleChannel(channel, null)\n        detach(channel)\n      }\n    },\n\n    async push(body) {\n      const channel = channels.get(body.sessionId)\n      const target = socket\n      if (\n        channel === undefined ||\n        !channel.live ||\n        channel.ended ||\n        target === null ||\n        !socketOpen ||\n        target.readyState !== WS_OPEN\n      ) {\n        // Retryable by contract: the reconnect loop restores the\n        // socket and the retry rides the same event ids.\n        throw new A2ClientError(\n          'STORE_UNAVAILABLE',\n          'no open socket for the session',\n        )\n      }\n      const req = nextReq\n      nextReq += 1\n      return await new Promise<WireEvent[]>((resolve, reject) => {\n        pending.set(req, { resolve, reject })\n        const frame: SocketPushFrame = {\n          kind: 'push',\n          req,\n          sessionId: body.sessionId,\n          events: body.events,\n        }\n        try {\n          target.send(JSON.stringify(frame))\n        } catch (cause) {\n          pending.delete(req)\n          reject(\n            new A2ClientError('STORE_UNAVAILABLE', 'socket send failed', {\n              cause,\n            }),\n          )\n        }\n      })\n    },\n\n    awaitReady(sessionId, maxWaitMs) {\n      const channel = channels.get(sessionId)\n      if (\n        channel !== undefined &&\n        channel.live &&\n        !channel.ended &&\n        socketOpen\n      ) {\n        return Promise.resolve()\n      }\n      return ready.wait(sessionId, maxWaitMs)\n    },\n    sendPresence(envelope) {\n      const channel = channels.get(envelope.sessionId)\n      if (channel === undefined || !channel.live || channel.ended) {\n        return // dropped by design — the reconnect re-send covers the gap\n      }\n      const frame: SocketPresenceFrame = {\n        kind: 'presence',\n        sessionId: envelope.sessionId,\n        ...envelope.presence,\n      }\n      trySend(JSON.stringify(frame))\n    },\n  }\n}\n\nconst transportFor = (\n  api: ClientApi,\n  fetchImpl: typeof globalThis.fetch,\n  webSocketImpl: ClientWebSocketConstructor | undefined,\n  presence: boolean,\n): Transport => {\n  if (typeof api === 'string' || typeof api === 'function') {\n    return httpTransport({ push: api, stream: api }, fetchImpl, presence)\n  }\n  if (api.type === 'http') {\n    return httpTransport(\n      { push: api.push, stream: api.stream },\n      fetchImpl,\n      presence,\n    )\n  }\n  if (api.multiplex === true) {\n    if (typeof api.url !== 'string') {\n      throw new TypeError('a multiplexed WebSocket URL must be a string')\n    }\n    return multiplexedWsTransport(api.url, webSocketImpl, presence)\n  }\n  return sessionWsTransport(api.url, webSocketImpl, presence)\n}\n\ntype Pending<D extends EventDefs> = {\n  id: string\n  type: string\n  payload: unknown\n  createdAt: Date\n  /** Set once the POST ack returns; the entry leaves the overlay when\n   * the stream delivers its index. */\n  acked?: ContractEvent<D>\n}\n\ntype SessionRuntime<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs,\n> = SessionClient<D, S, P> & {\n  hydrate(options?: SessionOptions<D, S>): void\n  canEvict(): boolean\n}\n\ntype CachedSession<D extends EventDefs, S, P extends PresenceDefs> = {\n  runtime: SessionRuntime<D, S, P>\n  timer?: ReturnType<typeof setTimeout>\n}\n\nexport function createClient<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs = Record<never, never>,\n>(options: CreateClientOptions<D, S, P>): A2Client<D, S, P> {\n  const { reducer, api } = options\n  const presenceDefs: Readonly<PresenceDefs> = reducer.presence\n  const declaresPresence = Object.keys(presenceDefs).length > 0\n  const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis)\n  const clientFetch: typeof globalThis.fetch = async (input, init) => {\n    try {\n      return await fetchImpl(input, init)\n    } catch (error) {\n      throw asClientError(error, { code: 'CONNECTION_FAILED' })\n    }\n  }\n  const webSocketImpl =\n    options.webSocket ??\n    (globalThis as { WebSocket?: ClientWebSocketConstructor }).WebSocket\n  const transport = transportFor(\n    api,\n    clientFetch,\n    webSocketImpl,\n    declaresPresence,\n  )\n  const gcTime = options.gcTime ?? DEFAULT_GC_TIME_MS\n  if (Number.isNaN(gcTime) || gcTime < 0) {\n    throw new RangeError('gcTime must be a non-negative number or Infinity')\n  }\n  const sessions = new Map<string, CachedSession<D, S, P>>()\n\n  const scheduleGc = (sessionId: string, delay = gcTime): void => {\n    const entry = sessions.get(sessionId)\n    if (!entry) return\n    clearTimeout(entry.timer)\n    if (gcTime === Infinity) return\n    entry.timer = setTimeout(() => {\n      const current = sessions.get(sessionId)\n      if (current !== entry) return\n      if (entry.runtime.canEvict()) {\n        sessions.delete(sessionId)\n        return\n      }\n      // `gcTime: 0` is useful for tests and explicit no-cache clients,\n      // but must not spin while a session is mounted or a push is in flight.\n      scheduleGc(sessionId, Math.max(gcTime, 1_000))\n    }, delay)\n    ;(entry.timer as { unref?: () => void }).unref?.()\n  }\n\n  const touch = (sessionId: string): void => {\n    scheduleGc(sessionId)\n  }\n\n  const makeSession = (\n    sessionId: string,\n    sessionOptions?: SessionOptions<D, S>,\n  ): SessionRuntime<D, S, P> => {\n    // ── server truth ─────────────────────────────────────────────\n    let stateIndex = sessionOptions?.initialIndex ?? 0\n    let streamIndex =\n      sessionOptions?.initialState === undefined\n        ? sessionOptions?.initialIndex\n        : stateIndex\n    let foldedState: S =\n      sessionOptions?.initialState !== undefined\n        ? sessionOptions.initialState\n        : reducer.initialState\n    const serverEvents: ContractEvent<D>[] = (\n      sessionOptions?.initialEvents ?? []\n    )\n      .filter((event) => event.index <= stateIndex)\n      .toSorted((a, b) => a.index - b.index)\n\n    // ── optimistic overlay ───────────────────────────────────────\n    let pending: Pending<D>[] = []\n\n    // ── the presence plane ───────────────────────────────────────\n    // Never cached, never folded. Foreign entries replicate from the\n    // stream; the own entry is the local echo — server copies of self\n    // are ignored (the echo is at least as new, and comparing it to\n    // server stamps would put two clocks in one order).\n    let participant = sessionOptions?.participant ?? options.participant\n    // Participant and field keys arrive off the wire, so the map and\n    // every entry are built null-prototype — see `nullProtoRecord`.\n    let presenceState: PresenceMap = nullProtoRecord()\n    let presenceLastSentAt = 0\n    /** The last LWW stamp issued — see `nextPresenceAt`. */\n    let presenceLastAt = 0\n    /** Values awaiting the trailing send — non-null exactly while\n     * `presenceTimer` is armed. */\n    let presenceBuffer: Record<string, unknown> | null = null\n    let presenceTimer: ReturnType<typeof setTimeout> | undefined\n    /** Own fields set while the stream was down — re-sent once on\n     * reconnect (their POSTs may have been lost with the network). */\n    let presenceResend: Record<string, unknown> | null = null\n\n    // ── store plumbing ───────────────────────────────────────────\n    const listeners = new Set<() => void>()\n    let snapshot: SessionSnapshot<D, S> | null = null\n    let status: ConnectionStatus = 'idle'\n    let reconnects = 0\n    let lastError: A2ClientError | null = null\n    let inFlightPushes = 0\n    let pushWireTail: Promise<void> = Promise.resolve()\n    let deferredHydration: SessionOptions<D, S> | undefined\n    let hydrationNotification: ReturnType<typeof setTimeout> | undefined\n\n    const emit = (): void => {\n      // copy: a listener may unsubscribe (or subscribe) mid-notify\n      // oxlint-disable-next-line no-useless-spread\n      for (const listener of [...listeners]) listener()\n    }\n\n    const notify = (): void => {\n      snapshot = null\n      emit()\n    }\n\n    const notifyHydrated = (): void => {\n      // `session(id, serverFold)` is also called while a destination\n      // provider renders. Its own snapshot must advance synchronously,\n      // but notifying an outgoing provider during that render would be a\n      // React setState-in-render violation.\n      snapshot = null\n      clearTimeout(hydrationNotification)\n      hydrationNotification = setTimeout(emit, 0)\n      ;(hydrationNotification as { unref?: () => void }).unref?.()\n    }\n\n    const mergeServerEvents = (\n      events: ContractEvent<D>[] | undefined,\n      throughIndex: number,\n    ): boolean => {\n      if (!events || events.length === 0) return false\n      const byIndex = new Map(serverEvents.map((event) => [event.index, event]))\n      let changed = false\n      for (const event of events) {\n        if (event.index > throughIndex) continue\n        const existing = byIndex.get(event.index)\n        if (existing?.id === event.id) continue\n        byIndex.set(event.index, event)\n        changed = true\n      }\n      if (!changed) return false\n      serverEvents.splice(\n        0,\n        serverEvents.length,\n        ...[...byIndex.values()].toSorted((a, b) => a.index - b.index),\n      )\n      return true\n    }\n\n    const overlayEvents = (): ContractEvent<D>[] => {\n      // Acked entries first (they have a server-assigned order), then\n      // unacked in push order with provisional indexes.\n      const acked = pending\n        .filter((p) => p.acked)\n        .map((p) => p.acked!)\n        .toSorted((a, b) => a.index - b.index)\n      const maxKnown = Math.max(stateIndex, acked.at(-1)?.index ?? stateIndex)\n      const unacked = pending\n        .filter((p) => !p.acked)\n        .map(\n          (p, i) =>\n            ({\n              id: p.id,\n              type: p.type,\n              payload: p.payload,\n              index: maxKnown + 1 + i, // provisional\n              sessionId,\n              createdAt: p.createdAt,\n            }) as ContractEvent<D>,\n        )\n      return [...acked, ...unacked]\n    }\n\n    const connection = (): Connection => {\n      switch (status) {\n        case 'idle':\n          return { status: 'idle' }\n        case 'closed':\n          return { status: 'closed' }\n        case 'live':\n          return { status: 'live', reconnects }\n        case 'connecting':\n        case 'paused':\n          return { status, reconnects, error: lastError }\n      }\n    }\n\n    const historyState = (): HistoryState => {\n      const oldestLoaded = serverEvents[0]?.index ?? null\n      return {\n        loading: historyLoads > 0,\n        // Index 1 loaded — or a state index of 0, an empty log as far as\n        // this client knows — means nothing older is left to fetch.\n        complete: oldestLoaded === 1 || stateIndex === 0,\n        oldestLoaded,\n      }\n    }\n\n    const buildSnapshot = (): SessionSnapshot<D, S, P> => {\n      const overlay = overlayEvents()\n      let state = foldedState\n      for (const event of overlay) {\n        if (event.index > stateIndex) state = reducer.fold(state, event)\n      }\n      const displayedOverlay = overlay.filter((event) => {\n        if (event.index > stateIndex) return true\n        let low = 0\n        let high = serverEvents.length - 1\n        while (low <= high) {\n          const middle = Math.floor((low + high) / 2)\n          const observed = serverEvents[middle]!\n          if (observed.index === event.index) return observed.id !== event.id\n          if (observed.index < event.index) low = middle + 1\n          else high = middle - 1\n        }\n        return true\n      })\n      return {\n        state: reducer[clientStateProjection]?.(state) ?? state,\n        events: [...serverEvents, ...displayedOverlay],\n        index: stateIndex,\n        history: historyState(),\n        connection: connection(),\n        ...(declaresPresence\n          ? { presence: presenceState as PresenceMap<P> }\n          : {}),\n      } as SessionSnapshot<D, S, P>\n    }\n\n    // ── presence ─────────────────────────────────────────────────\n    /**\n     * The per-session monotonic LWW stamp: wall-seeded, guarded\n     * `max(now, last + 1)`, so overlapping sends can never invert —\n     * the wall clock seeds it because it is the only monotonic state\n     * that survives a reload without A2 owning persistence.\n     */\n    const nextPresenceAt = (): number => {\n      presenceLastAt = Math.max(Date.now(), presenceLastAt + 1)\n      return presenceLastAt\n    }\n\n    // Copy-on-write throughout: snapshots alias `presenceState`, so\n    // every change replaces the map and the touched entry instead of\n    // mutating them.\n    const applyPresencePatch = (patch: PresencePatch): void => {\n      if (patch.participant === participant) return // the echo is self truth\n      const entry: PresenceMap[string] = Object.assign(\n        nullProtoRecord<PresenceMap[string]>(),\n        presenceState[patch.participant],\n      )\n      let changed = false\n      for (const [field, value] of Object.entries(patch.values)) {\n        if (value === undefined) continue\n        const existing = entry[field]\n        // Field-wise LWW: an older stamp loses, a tie goes to the wire.\n        if (existing && existing.at.getTime() > patch.at.getTime()) continue\n        if (value === null) {\n          if (existing) {\n            delete entry[field]\n            changed = true\n          }\n        } else {\n          entry[field] = { value, seen: patch.seen, at: patch.at }\n          changed = true\n        }\n      }\n      if (!changed) return\n      const next = Object.assign(nullProtoRecord<PresenceMap>(), presenceState)\n      if (Object.keys(entry).length === 0) delete next[patch.participant]\n      else next[patch.participant] = entry\n      presenceState = next\n      notify()\n    }\n\n    const applyPresenceSnapshot = (incoming: PresenceMap): void => {\n      const next: PresenceMap = nullProtoRecord()\n      for (const [id, fields] of Object.entries(incoming)) {\n        if (id === participant) continue\n        next[id] = fields\n      }\n      // Foreign entries replaced wholesale; the own echo survives.\n      const own =\n        participant === undefined ? undefined : presenceState[participant]\n      if (participant !== undefined && own !== undefined)\n        next[participant] = own\n      presenceState = next\n      notify()\n    }\n\n    const echoPresence = (\n      id: string,\n      values: Record<string, unknown>,\n      atMs: number,\n    ): void => {\n      const entry: PresenceMap[string] = Object.assign(\n        nullProtoRecord<PresenceMap[string]>(),\n        presenceState[id],\n      )\n      const at = new Date(atMs)\n      for (const [field, value] of Object.entries(values)) {\n        if (value === null) delete entry[field]\n        else entry[field] = { value, seen: stateIndex, at }\n      }\n      const next = Object.assign(nullProtoRecord<PresenceMap>(), presenceState)\n      if (Object.keys(entry).length === 0) delete next[id]\n      else next[id] = entry\n      presenceState = next\n      notify()\n    }\n\n    // One send, fire-and-forget: no retry, no rollback, failures\n    // dropped silently — the next send repaints. Sends are NOT\n    // serialized on the ack and may overlap in flight: safe, because\n    // merges are LWW by `at` per (participant, field) and one\n    // sender's stamps are monotonic. `seen` is the state index at send\n    // time, not at set time; `at` is the sender's monotonic stamp.\n    const sendPresence = (\n      values: Record<string, unknown>,\n      at: number,\n    ): void => {\n      presenceLastSentAt = Date.now()\n      transport.sendPresence({\n        sessionId,\n        // Every path here starts at setPresence, which requires the\n        // participant.\n        presence: { participant: participant!, values, seen: stateIndex, at },\n      })\n      touch(sessionId)\n    }\n\n    // The fixed-cadence throttle: a set outside the interval sends on\n    // the leading edge; within it, values merge field-wise into one\n    // trailing send at the boundary. The cadence never couples to RTT\n    // — waiting on the ack served no purpose on this plane and\n    // stretched remote motion on slow links.\n    const queuePresenceSend = (\n      values: Record<string, unknown>,\n      at?: number,\n    ): void => {\n      if (presenceTimer !== undefined) {\n        presenceBuffer = { ...presenceBuffer, ...values }\n        return\n      }\n      const wait =\n        presenceLastSentAt + PRESENCE_TIMINGS.sendIntervalMs - Date.now()\n      if (wait <= 0) {\n        sendPresence(values, at ?? nextPresenceAt())\n        return\n      }\n      presenceBuffer = { ...presenceBuffer, ...values }\n      presenceTimer = setTimeout(() => {\n        presenceTimer = undefined\n        const buffered = presenceBuffer\n        presenceBuffer = null\n        // The trailing send stamps at fire time — always past every\n        // stamp its merged values echoed with.\n        if (buffered) sendPresence(buffered, nextPresenceAt())\n      }, wait)\n      ;(presenceTimer as { unref?: () => void }).unref?.()\n    }\n\n    const setPresence = (values: PresencePatch<P>['values']): void => {\n      if (participant === undefined) {\n        throw new TypeError(\n          'setPresence requires a participant — pass one to createClient({ participant }) or in the session options (the SessionProvider/useSession participant prop)',\n        )\n      }\n      const validated: Record<string, unknown> = nullProtoRecord()\n      for (const [field, value] of Object.entries(values)) {\n        if (value === undefined) continue\n        // '*' is a catch-all vocabulary entry: any field name (bar\n        // object-plumbing names) validates against it. The actor\n        // module's follower reducer declares it — the browser cannot\n        // know a server-defined vocabulary, so the server stays the\n        // authority.\n        const schema = Object.hasOwn(presenceDefs, field)\n          ? presenceDefs[field]\n          : RESERVED_PARTICIPANT_IDS.has(field)\n            ? undefined\n            : presenceDefs['*']\n        if (!schema) {\n          throw new A2ClientError(\n            'UNKNOWN_PRESENCE_FIELD',\n            `no presence field '${field}' in the reducer's vocabulary`,\n          )\n        }\n        if (value === null) {\n          validated[field] = null\n          continue\n        }\n        const result = validateSync(schema, value, `presence field '${field}'`)\n        if (result.issues) {\n          throw new A2ClientError(\n            'INVALID_PAYLOAD',\n            `invalid value for presence field '${field}'`,\n            { details: result.issues },\n          )\n        }\n        validated[field] = result.value\n      }\n      if (Object.keys(validated).length === 0) return\n      // One stamp per set: the echo and a leading send share it, so\n      // the local map and the wire agree on this write's LWW position.\n      const at = nextPresenceAt()\n      echoPresence(participant, validated, at)\n      if (status !== 'live') {\n        presenceResend = { ...presenceResend, ...validated }\n      }\n      queuePresenceSend(validated, at)\n      touch(sessionId)\n    }\n\n    /** Pushes awaiting stream confirmation — resolved by `ingest` the\n     * moment the state index passes their batch. */\n    let confirmWatchers: Array<{ index: number; resolve: () => void }> = []\n\n    /** The single ingest point: every server-confirmed event, in log\n     * order, from the stream. */\n    const ingest = (event: ContractEvent<D>): void => {\n      if (event.index <= (streamIndex ?? 0)) return\n      streamIndex = event.index\n      if (event.index > stateIndex) {\n        stateIndex = event.index\n        serverEvents.push(event)\n        foldedState = reducer.fold(foldedState, event)\n      } else {\n        mergeServerEvents([event], stateIndex)\n      }\n      pending = pending.filter((p) => p.id !== event.id)\n      if (confirmWatchers.some((w) => w.index <= stateIndex)) {\n        const due = confirmWatchers.filter((w) => w.index <= stateIndex)\n        confirmWatchers = confirmWatchers.filter((w) => w.index > stateIndex)\n        for (const watcher of due) watcher.resolve()\n      }\n      notify()\n      touch(sessionId)\n    }\n\n    // ── push ─────────────────────────────────────────────────────\n    const validated = (\n      events: AppendInput<D>[],\n    ): Array<{ id: string; type: string; payload: unknown }> =>\n      events.map((event) => {\n        const schema = Object.hasOwn(reducer.events, event.type)\n          ? reducer.events[event.type]\n          : undefined\n        if (!schema) {\n          throw new A2ClientError(\n            'UNKNOWN_EVENT_TYPE',\n            `no event type '${String(event.type)}' in the reducer's vocabulary`,\n          )\n        }\n        const result = validateSync(\n          schema,\n          event.payload,\n          `event '${String(event.type)}'`,\n        )\n        if (result.issues) {\n          throw new A2ClientError(\n            'INVALID_PAYLOAD',\n            `invalid payload for event '${String(event.type)}'`,\n            { details: result.issues },\n          )\n        }\n        return {\n          id: event.id ?? crypto.randomUUID(),\n          type: event.type,\n          payload: result.value,\n        }\n      })\n\n    const post = async (\n      body: TransportPushBody,\n    ): Promise<ContractEvent<D>[]> => {\n      let lastPushError: A2ClientError = new A2ClientError(\n        'STORE_UNAVAILABLE',\n        'push failed',\n      )\n      for (let attempt = 1; attempt <= PUSH_ATTEMPTS; attempt += 1) {\n        try {\n          const rows = await transport.push(body)\n          return rows.map((row) => eventFromWire(row) as ContractEvent<D>)\n        } catch (err) {\n          lastPushError = asClientError(err)\n        }\n        if (!RETRYABLE_PUSH_CODES.has(lastPushError.code)) throw lastPushError\n        if (attempt < PUSH_ATTEMPTS) {\n          const sleepMs = 250 * attempt\n          // Wait for the clock AND, when the transport can tell us,\n          // the wire. The pacing sleep is a floor: a failure acked\n          // over a healthy socket (a shedding store) must not re-fire\n          // at wire speed. A push caught in a routine reconnect blip\n          // additionally parks until the subscription is confirmed;\n          // that cap scales with the reconnect backoff so an\n          // unreachable server still exhausts attempts promptly.\n          await Promise.all([\n            new Promise((resolve) => setTimeout(resolve, sleepMs)),\n            transport.awaitReady?.(\n              sessionId,\n              sleepMs + STREAM_TIMINGS.reconnectBaseMs * attempt,\n            ),\n          ])\n        }\n      }\n      throw lastPushError\n    }\n\n    /**\n     * Decorate the ack promise into a PushResult. `confirmed` is a\n     * lazy getter — materialized on first access, so callers that\n     * ignore it can't leak an unhandled rejection.\n     */\n    const withConfirmed = (ack: Promise<ContractEvent<D>[]>): PushResult<D> => {\n      let confirmed: Promise<ContractEvent<D>[]> | undefined\n      return Object.defineProperty(ack as PushResult<D>, 'confirmed', {\n        get(): Promise<ContractEvent<D>[]> {\n          confirmed ??= ack.then(\n            (acked) =>\n              new Promise<ContractEvent<D>[]>((resolve) => {\n                const last = acked.at(-1)?.index ?? 0\n                if (stateIndex >= last) {\n                  resolve(acked)\n                  return\n                }\n                confirmWatchers.push({\n                  index: last,\n                  resolve: () => resolve(acked),\n                })\n              }),\n          )\n          return confirmed\n        },\n      })\n    }\n\n    const push = (...events: AppendInput<D>[]): PushResult<D> => {\n      touch(sessionId)\n      return withConfirmed(\n        (async () => {\n          if (events.length === 0) {\n            throw new TypeError('push requires at least one event')\n          }\n          const entries: Pending<D>[] = validated(events).map((e) => ({\n            id: e.id,\n            type: e.type,\n            payload: e.payload,\n            createdAt: new Date(),\n          }))\n          // Reserve before notifying: a subscriber may reenter push(),\n          // and that work must follow the call whose state it observed.\n          const waitForPriorPush = pushWireTail\n          let releasePush!: () => void\n          pushWireTail = new Promise<void>((resolve) => {\n            releasePush = resolve\n          })\n          pending.push(...entries)\n          inFlightPushes += 1\n\n          try {\n            refreshIdleStream()\n            notify() // optimistic — the view updates before the network moves\n            await waitForPriorPush\n            const acked = await post({\n              sessionId,\n              events: entries.map(({ id, type, payload }) => ({\n                id,\n                type,\n                payload,\n              })),\n            })\n            for (const event of acked) {\n              const entry = pending.find((p) => p.id === event.id)\n              if (entry) entry.acked = event // stream retires it at its index\n            }\n            pending = pending.filter(\n              (entry) =>\n                entry.acked === undefined ||\n                entry.acked.index >\n                  Math.min(stateIndex, streamIndex ?? stateIndex),\n            )\n            if ((acked.at(-1)?.index ?? 0) > (streamIndex ?? stateIndex))\n              refreshIdleStream()\n            notify()\n            return acked\n          } catch (err) {\n            // Rollback: refold without the rejected events.\n            const ids = new Set(entries.map((e) => e.id))\n            pending = pending.filter((p) => !ids.has(p.id))\n            notify()\n            throw err\n          } finally {\n            releasePush()\n            inFlightPushes -= 1\n            if (inFlightPushes === 0 && deferredHydration) {\n              const next = deferredHydration\n              deferredHydration = undefined\n              runtime.hydrate(next)\n            }\n            touch(sessionId)\n          }\n        })(),\n      )\n    }\n\n    // ── backscroll ───────────────────────────────────────────────\n    // Cold reads of the log below the state index. Fetched events merge\n    // into `serverEvents` only — never the fold, never the overlay.\n    let historyLoads = 0\n    /** Calls chain per session: each resolves its bounds after the\n     * prior call's merge, so overlapping backscrolls page backward\n     * instead of re-fetching the same range. */\n    let historyTail: Promise<unknown> = Promise.resolve()\n\n    const eventsBetween = (gte: number, lte: number): ContractEvent<D>[] =>\n      serverEvents.filter((event) => event.index >= gte && event.index <= lte)\n\n    /** The narrowest sub-range of [gte, lte] missing from the feed, or\n     * null when the range is fully loaded (nothing to fetch). */\n    const missingBetween = (\n      gte: number,\n      lte: number,\n    ): { gte: number; lte: number } | null => {\n      const present = new Set(eventsBetween(gte, lte).map((e) => e.index))\n      let lo = gte\n      while (lo <= lte && present.has(lo)) lo += 1\n      if (lo > lte) return null\n      let hi = lte\n      while (hi > lo && present.has(hi)) hi -= 1\n      return { gte: lo, lte: hi }\n    }\n\n    const loadHistory = (\n      loadOptions?: LoadHistoryOptions,\n    ): Promise<ContractEvent<D>[]> => {\n      const readHistory = transport.history\n      if (readHistory === undefined) {\n        throw new TypeError(\n          'loadHistory requires an http api — the ws transport has no history lane; serve the session with server.fetch and pass its route url as the string or { type: \"http\" } api',\n        )\n      }\n      const before = loadOptions?.before\n      const limit = loadOptions?.limit\n      if (\n        before !== undefined &&\n        (!Number.isSafeInteger(before) || before < 1)\n      ) {\n        throw new TypeError(\n          'loadHistory before must be a positive safe integer',\n        )\n      }\n      if (limit !== undefined && (!Number.isSafeInteger(limit) || limit < 1)) {\n        throw new TypeError('loadHistory limit must be a positive safe integer')\n      }\n      touch(sessionId)\n      const run = historyTail.then(async () => {\n        const upper = before ?? serverEvents[0]?.index ?? stateIndex + 1\n        // Strictly at or below the state index: the live stream owns\n        // everything above it, and the optimistic overlay must never\n        // collide with a backscrolled row.\n        const lte = Math.min(upper - 1, stateIndex)\n        const gte = Math.max(1, upper - (limit ?? DEFAULT_HISTORY_LIMIT))\n        if (gte > lte) return []\n        const missing = missingBetween(gte, lte)\n        if (missing === null) return eventsBetween(gte, lte)\n        historyLoads += 1\n        notify()\n        try {\n          const rows = await readHistory({ sessionId, ...missing })\n          mergeServerEvents(\n            rows.map((row) => eventFromWire(row) as ContractEvent<D>),\n            stateIndex,\n          )\n          return eventsBetween(gte, lte)\n        } catch (error) {\n          throw asClientError(error)\n        } finally {\n          historyLoads -= 1\n          notify()\n          touch(sessionId)\n        }\n      })\n      // Failures reject the caller, never the chain.\n      historyTail = run.catch(() => {})\n      return run\n    }\n\n    // ── the live stream ──────────────────────────────────────────\n    // A run-generation model instead of a terminal `closed` flag:\n    // stopping bumps the generation (the running loop notices and\n    // exits), connect() starts a fresh one. Reentrant by design.\n    // Consumers hold leases: connect() counts one and returns its\n    // release, the last release stops the stream, and close() is the\n    // hard stop — it drops every lease and stops now (bumping\n    // `leaseEpoch` makes the outstanding releases inert).\n    let generation = 0\n    let active = false\n    let streamIdle = false\n    let abort: AbortController | null = null\n    let leases = 0\n    let leaseEpoch = 0\n\n    const stopStream = (): void => {\n      touch(sessionId)\n      if (!active) return\n      active = false\n      streamIdle = false\n      generation += 1 // the running loop notices and exits\n      abort?.abort()\n      abort = null\n      // A pending trailing send dies with the stream — losing one is\n      // fine by definition; sets made while closed accumulate in\n      // `presenceResend` and repaint after the next connect.\n      clearTimeout(presenceTimer)\n      presenceTimer = undefined\n      presenceBuffer = null\n      status = 'closed'\n      notify()\n    }\n\n    const runStream = async (run: number): Promise<void> => {\n      let backoff = STREAM_TIMINGS.reconnectBaseMs\n      let attempt = 0\n      // oxlint-disable no-await-in-loop -- sequential reconnect loop\n      // oxlint-disable-next-line no-unmodified-loop-condition -- close() bumps `generation`\n      while (generation === run) {\n        streamIdle = false\n        const controller = new AbortController()\n        abort = controller\n        // The stall watchdog: the server heartbeats the stream, so a\n        // healthy connection is never silent for long. Silence past the\n        // timeout means the connection is dead in a way the socket\n        // won't report (an offline browser's established SSE socket\n        // neither errors nor receives) — abort it and let the normal\n        // reconnect path run. This is what keeps `status: 'live'`\n        // honest.\n        let stall: ReturnType<typeof setTimeout> | undefined\n        let stalled = false\n        const armStall = (): void => {\n          clearTimeout(stall)\n          stall = setTimeout(() => {\n            stalled = true\n            controller.abort()\n          }, STREAM_TIMINGS.stallTimeoutMs)\n          ;(stall as { unref?: () => void }).unref?.()\n        }\n        let wasLive = false\n        try {\n          const frames = transport.connect({\n            sessionId,\n            startAfter: (streamIndex ??= stateIndex),\n            signal: controller.signal,\n          })\n          for await (const frame of frames) {\n            if (generation !== run) break\n            // Every frame counts — heartbeats included. Liveness is\n            // about the connection, not about events.\n            armStall()\n            if (!wasLive) {\n              // The first frame is the connection signal: the transport\n              // yields it the moment the stream is established.\n              backoff = STREAM_TIMINGS.reconnectBaseMs\n              attempt = 0\n              wasLive = true\n              status = 'live'\n              lastError = null\n              notify()\n              if (generation !== run) break\n              if (presenceResend) {\n                const values = presenceResend\n                presenceResend = null\n                queuePresenceSend(values)\n              }\n            }\n            if (frame.kind === 'event') {\n              streamIdle = false\n              ingest(eventFromWire(frame.event) as ContractEvent<D>)\n            } else if (frame.kind === 'activity') {\n              streamIdle = frame.idle\n              if (\n                streamIdle &&\n                (inFlightPushes > 0 ||\n                  pending.some(\n                    (entry) =>\n                      (entry.acked?.index ?? 0) > (streamIndex ?? stateIndex),\n                  ))\n              ) {\n                refreshIdleStream()\n              }\n            } else if (frame.kind === 'presence') {\n              applyPresencePatch(presencePatchFromWire(frame.patch))\n            } else if (frame.kind === 'presence-snapshot') {\n              applyPresenceSnapshot(\n                presenceSnapshotFromWire(frame.snapshot).snapshot,\n              )\n            }\n          }\n          // The transport ended the stream cleanly — reconnect, but it\n          // isn't an error.\n          if (generation === run) {\n            lastError = null\n          }\n        } catch (err) {\n          if (generation === run) {\n            lastError = stalled\n              ? new A2ClientError(\n                  'TIMEOUT',\n                  `stream stalled: no data for ${STREAM_TIMINGS.stallTimeoutMs}ms`,\n                  { phase: 'stream', timeoutMs: STREAM_TIMINGS.stallTimeoutMs },\n                )\n              : asClientError(err)\n          }\n        } finally {\n          clearTimeout(stall)\n        }\n        if (generation !== run) break\n        streamIdle = false\n        if (wasLive) reconnects += 1\n        attempt += 1\n        let delay: number | false\n        try {\n          delay = options.reconnect\n            ? options.reconnect({ sessionId, error: lastError, attempt })\n            : backoff\n          if (\n            delay !== false &&\n            (!Number.isFinite(delay) || delay < 0 || delay > 2_147_483_647)\n          ) {\n            throw new RangeError(\n              'reconnect must return false or a delay from 0 to 2147483647 ms',\n            )\n          }\n        } catch (error) {\n          if (generation !== run) break\n          lastError = asClientError(error)\n          delay = false\n        }\n        if (generation !== run) break\n        if (delay === false) {\n          abort = null\n          status = 'paused'\n          notify()\n          return\n        }\n        const waiting = new AbortController()\n        abort = waiting\n        status = 'connecting'\n        notify()\n        if (generation !== run) break\n        await new Promise<void>((resolve) => {\n          let settled = false\n          const finish = (): void => {\n            if (settled) return\n            settled = true\n            clearTimeout(timer)\n            waiting.signal.removeEventListener('abort', finish)\n            // oxlint-disable-next-line no-multiple-resolved -- guarded above\n            resolve()\n          }\n          const timer = setTimeout(finish, delay)\n          ;(timer as { unref?: () => void }).unref?.()\n          if (waiting.signal.aborted) finish()\n          else waiting.signal.addEventListener('abort', finish, { once: true })\n        })\n        backoff = Math.min(backoff * 2, STREAM_TIMINGS.reconnectMaxMs)\n      }\n      // oxlint-enable no-await-in-loop\n    }\n\n    const refreshIdleStream = (): void => {\n      if (streamIdle && status !== 'paused') reconnectStream()\n    }\n\n    const reconnectStream = (): void => {\n      touch(sessionId)\n      if (!active) return\n      streamIdle = false\n      generation += 1\n      const run = generation\n      const previous = abort\n      abort = null\n      reconnects += 1\n      status = 'connecting'\n      lastError = null\n      notify()\n      // Replace the lane before aborting so a multiplexed session keeps its socket.\n      if (active && generation === run) void runStream(run)\n      previous?.abort()\n    }\n\n    const runtime: SessionRuntime<D, S, P> = {\n      sessionId,\n      // Only on presence-declaring contracts — the type surface\n      // promises no runtime-inert members (a2-api.md §12).\n      ...(declaresPresence ? { setPresence } : {}),\n      subscribe(listener) {\n        touch(sessionId)\n        listeners.add(listener)\n        return () => {\n          listeners.delete(listener)\n          touch(sessionId)\n        }\n      },\n      getSnapshot() {\n        snapshot ??= buildSnapshot()\n        return snapshot\n      },\n      push,\n      loadHistory,\n      reconnect: reconnectStream,\n      connect() {\n        touch(sessionId)\n        leases += 1\n        const epoch = leaseEpoch\n        if (!active) {\n          active = true\n          status = 'connecting'\n          lastError = null\n          const run = generation\n          notify()\n          if (active && generation === run) void runStream(run)\n        }\n        let released = false\n        return () => {\n          // Idempotent, and inert after a hard close() — a stale\n          // release must not touch leases taken since.\n          if (released || leaseEpoch !== epoch) return\n          released = true\n          touch(sessionId)\n          leases -= 1\n          if (leases === 0) stopStream()\n        }\n      },\n      close() {\n        leases = 0\n        leaseEpoch += 1\n        stopStream()\n      },\n      hydrate(next) {\n        touch(sessionId)\n        if (!next) return\n        participant ??= next.participant\n        const nextIndex = next.initialIndex ?? 0\n        if (nextIndex > stateIndex && inFlightPushes > 0) {\n          if (\n            !deferredHydration ||\n            nextIndex > (deferredHydration.initialIndex ?? 0)\n          ) {\n            deferredHydration = next\n          }\n          return\n        }\n\n        const historyChanged = mergeServerEvents(\n          next.initialEvents,\n          Math.min(nextIndex, stateIndex),\n        )\n        if (next.initialState !== undefined) streamIndex ??= nextIndex\n        if (next.initialState === undefined || nextIndex <= stateIndex) {\n          if (historyChanged) notifyHydrated()\n          return\n        }\n\n        // State hydration does not subsume delivery: unobserved ACKs still\n        // keep an idle stream catching up even when their state is covered.\n        stateIndex = nextIndex\n        foldedState = next.initialState\n        mergeServerEvents(next.initialEvents, stateIndex)\n        pending = pending.filter(\n          (entry) =>\n            !entry.acked ||\n            entry.acked.index > Math.min(stateIndex, streamIndex ?? stateIndex),\n        )\n        if (confirmWatchers.some((watcher) => watcher.index <= stateIndex)) {\n          const due = confirmWatchers.filter(\n            (watcher) => watcher.index <= stateIndex,\n          )\n          confirmWatchers = confirmWatchers.filter(\n            (watcher) => watcher.index > stateIndex,\n          )\n          for (const watcher of due) watcher.resolve()\n        }\n        notifyHydrated()\n      },\n      canEvict() {\n        return (\n          listeners.size === 0 &&\n          !active &&\n          inFlightPushes === 0 &&\n          historyLoads === 0 &&\n          confirmWatchers.length === 0 &&\n          presenceTimer === undefined\n        )\n      },\n    } as SessionRuntime<D, S, P>\n\n    return runtime\n  }\n\n  return {\n    session(sessionId, sessionOptions) {\n      const existing = sessions.get(sessionId)\n      if (existing) {\n        existing.runtime.hydrate(sessionOptions)\n        touch(sessionId)\n        return existing.runtime\n      }\n\n      const runtime = makeSession(sessionId, sessionOptions)\n      sessions.set(sessionId, { runtime })\n      touch(sessionId)\n      return runtime\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/client.d.ts

@@ -1,2 +1,2 @@
-import { _ as createClient, a as Connection, c as HistoryState, d as ReconnectPolicy, f as SessionClient, g as SessionUrl, h as SessionSnapshot, i as ClientWebSocketConstructor, l as LoadHistoryOptions, m as SessionOptions, n as ClientApi, o as ConnectionStatus, p as SessionClientPresence, r as ClientWebSocket, s as CreateClientOptions, t as A2Client, u as PushResult, v as A2ClientError, y as A2ClientErrorOptions } from "./client-P_NNNRM-.js";
+import { _ as createClient, a as Connection, c as HistoryState, d as ReconnectPolicy, f as SessionClient, g as SessionUrl, h as SessionSnapshot, i as ClientWebSocketConstructor, l as LoadHistoryOptions, m as SessionOptions, n as ClientApi, o as ConnectionStatus, p as SessionClientPresence, r as ClientWebSocket, s as CreateClientOptions, t as A2Client, u as PushResult, v as A2ClientError, y as A2ClientErrorOptions } from "./client-BAEABRZB.js";
 export { A2Client, A2ClientError, type A2ClientErrorOptions, ClientApi, ClientWebSocket, ClientWebSocketConstructor, Connection, ConnectionStatus, CreateClientOptions, HistoryState, LoadHistoryOptions, PushResult, ReconnectPolicy, SessionClient, SessionClientPresence, SessionOptions, SessionSnapshot, SessionUrl, createClient };

package/dist/client.js

@@ -1,2 +1,2 @@
-import { n as A2ClientError, t as createClient } from "./client-Bf6uSEAk.js";
+import { n as A2ClientError, t as createClient } from "./client-BYzHjkwU.js";
 export { A2ClientError, createClient };

package/dist/{contract-48bUMgcL.js → contract-CKRg_E4q.js}

@@ -1,28 +1,5 @@
-import { n as validateSync, t as assertSyncSchema } from "./validate-XKT4FSNn.js";
-//#region src/reducer.ts
-/** Internal — reducers are created through `contract.reducer(...).fold(...)`. */
-function makeReducerBuilder(events, presence, options) {
-	const { name } = options;
-	if (typeof name !== "string" || name.length === 0) throw new TypeError("reducer name must be a non-empty string — it identifies the reducer and keys cached snapshots");
-	let initialState = options.initialState;
-	if (options.stateSchema) {
-		const result = validateSync(options.stateSchema, options.initialState, "the stateSchema");
-		if (result.issues) throw new TypeError(`reducer initialState does not match its stateSchema: ${result.issues.map((issue) => issue.message).join("; ")}`);
-		initialState = result.value;
-	}
-	return { fold(fold) {
-		if (typeof fold !== "function") throw new TypeError("reducer fold must be a function");
-		return {
-			name,
-			events,
-			presence,
-			fold,
-			initialState,
-			stateSchema: options.stateSchema
-		};
-	} };
-}
-//#endregion
+import { t as assertSyncSchema } from "./validate-XKT4FSNn.js";
+import { n as makeReducerBuilder } from "./reducer-DEMjEY_O.js";
 //#region src/contract.ts
 /**
 * The contract — a2's primary noun. A named event vocabulary, shared by
@@ -68,4 +45,4 @@ function contract(options) {
 //#endregion
 export { contract as t };
 
-//# sourceMappingURL=contract-48bUMgcL.js.map
+//# sourceMappingURL=contract-CKRg_E4q.js.map

package/dist/contract-CKRg_E4q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-CKRg_E4q.js","names":[],"sources":["../src/contract.ts"],"sourcesContent":["/**\n * The contract — a2's primary noun. A named event vocabulary, shared by\n * everything: the server implements it (experimental-a2/server's `createServer`),\n * reducers derive from it (`contract.reducer`), the browser types its\n * pushes off it. Isomorphic by construction: this module imports\n * nothing but schema plumbing.\n *\n * The contract says what can be *said*; the server says how it's\n * *reacted to*; a reducer says how it's *seen*.\n */\n\nimport { makeReducerBuilder, type ReducerBuilder } from './reducer.ts'\nimport type { StandardSchemaV1 } from './standard-schema.ts'\nimport { assertSyncSchema } from './validate.ts'\n\n/** The event vocabulary shape: event name → payload schema. */\nexport type EventDefs = Record<string, StandardSchemaV1>\n\n/** The presence vocabulary shape: field name → value schema. */\nexport type PresenceDefs = Record<string, StandardSchemaV1>\n\n/** One event of a contract, narrowed to type `K`. */\nexport type ContractEvent<\n  D extends EventDefs,\n  K extends keyof D & string = keyof D & string,\n> = {\n  [T in keyof D & string]: {\n    id: string\n    type: T\n    payload: StandardSchemaV1.InferOutput<D[T]>\n    index: number\n    sessionId: string\n    createdAt: Date\n  }\n}[K]\n\n/** Input to `append`/`push`, typed against the contract's schemas. */\nexport type AppendInput<D extends EventDefs> = {\n  [T in keyof D & string]: {\n    type: T\n    payload: StandardSchemaV1.InferInput<D[T]>\n    id?: string\n  }\n}[keyof D & string]\n\nexport type EventBatchFactory<D extends EventDefs> = <\n  const E extends readonly AppendInput<D>[],\n>(\n  ...events: E\n) => E\n\n/**\n * One presence update: a participant's changed fields (`null` marks a\n * cleared one), stamped with the sender's stream frontier (`seen`).\n * This is what `stream({ presence: true })` interleaves with events.\n */\nexport type PresencePatch<P extends PresenceDefs = PresenceDefs> = {\n  participant: string\n  values: {\n    [F in keyof P & string]?: StandardSchemaV1.InferOutput<P[F]> | null\n  }\n  seen: number\n  at: Date\n}\n\n/**\n * The replicated ephemeral map: participant → field → latest value,\n * last-writer-wins per field. Never stored in the log; how long a\n * value stays painted is view logic, decided at render time against\n * `at`.\n */\nexport type PresenceMap<P extends PresenceDefs = PresenceDefs> = {\n  [participant: string]: {\n    [F in keyof P & string]?: {\n      value: StandardSchemaV1.InferOutput<P[F]>\n      seen: number\n      at: Date\n    }\n  }\n}\n\n/**\n * The one item a presence stream yields before live patches: the\n * current pruned map, per-field stamps exact. Discriminate\n * structurally (`'snapshot' in item`).\n */\nexport type PresenceSnapshot<P extends PresenceDefs = PresenceDefs> = {\n  snapshot: PresenceMap<P>\n}\n\n/**\n * Intersect into a surface type to add `Members` only when the\n * contract declares presence fields — on presence-less contracts the\n * members do not exist, a type error rather than a runtime throw.\n */\nexport type WithPresence<\n  P extends PresenceDefs,\n  Members,\n> = keyof P extends never ? unknown : Members\n\nexport type ReducerOptions<Seed, S> = {\n  /**\n   * Identity and snapshot cache key. Rename it when the fold's logic\n   * changes — snapshots under the old name are ignored and refolded.\n   */\n  name: string\n  /**\n   * The seed the fold starts from. With a `stateSchema`, it's typed as\n   * the schema's *input*: validated at definition, and the validated\n   * output (defaults applied) is what the fold actually starts from.\n   */\n  initialState: Seed\n  /**\n   * Optional: declares the state's shape (the fold's state type becomes\n   * the schema's output) and guards cached folds — server snapshots and\n   * the browser cache reject mismatching shapes and refold.\n   */\n  stateSchema?: StandardSchemaV1<Seed, S>\n}\n\nexport type Contract<\n  D extends EventDefs = EventDefs,\n  P extends PresenceDefs = Record<never, never>,\n> = {\n  /** Identity — prefixes storage keys and queue messages. */\n  readonly name: string\n  /** The vocabulary. */\n  readonly events: Readonly<D>\n  /** The presence vocabulary — empty unless declared. */\n  readonly presence: Readonly<P>\n  /** Preserve literal types for a handler-returned event batch. */\n  readonly batch: EventBatchFactory<D>\n  /**\n   * Derive a view from this contract. The reducer's `name` is its\n   * identity and snapshot cache key: rename it when the fold's logic\n   * changes. Two steps by design: this call fixes the state and event\n   * types, so `.fold()` receives fully concrete types — literal unions\n   * in your state survive, with zero annotations. (A single call can't\n   * do this: TypeScript never contextually types the returns of a\n   * context-sensitive argument against generics inferred in the same\n   * call.)\n   */\n  reducer<Seed, S = Seed>(\n    options: ReducerOptions<Seed, S>,\n  ): ReducerBuilder<D, S, P>\n}\n\n/**\n * Define a contract: a name plus the events it understands. Validators\n * must be synchronous — async ones are rejected here, at definition\n * time. The result is a plain, importable, isomorphic value.\n */\nexport function contract<\n  D extends EventDefs,\n  P extends PresenceDefs = Record<never, never>,\n>(options: {\n  /** Identity — prefixes storage keys and queue messages. */\n  name: string\n  /** The vocabulary: event name → payload schema (Standard Schema). */\n  events: D\n  /**\n   * Optional second vocabulary: presence field → value schema.\n   * Per-participant ephemeral state, replicated last-writer-wins and\n   * never stored in the log — reducers cannot see it.\n   */\n  presence?: P\n}): Contract<D, P> {\n  const { name } = options\n  if (typeof name !== 'string' || name.length === 0) {\n    throw new TypeError('contract name must be a non-empty string')\n  }\n  if (name.includes('\\u001f')) {\n    throw new TypeError('contract name contains a reserved control character')\n  }\n  const defs = options.events\n  for (const [type, schema] of Object.entries(defs)) {\n    if (typeof schema?.['~standard']?.validate !== 'function') {\n      throw new TypeError(\n        `contract '${name}': the value for '${type}' is not a Standard Schema (expected an object with '~standard')`,\n      )\n    }\n    assertSyncSchema(schema, `event '${type}'`)\n  }\n  const events = Object.freeze({ ...defs })\n\n  const presenceDefs = options.presence ?? ({} as P)\n  for (const [field, schema] of Object.entries(presenceDefs)) {\n    if (typeof schema?.['~standard']?.validate !== 'function') {\n      throw new TypeError(\n        `contract '${name}': the value for presence field '${field}' is not a Standard Schema (expected an object with '~standard')`,\n      )\n    }\n    assertSyncSchema(schema, `presence field '${field}'`)\n  }\n  const presence = Object.freeze({ ...presenceDefs })\n\n  return {\n    name,\n    events,\n    presence,\n    batch: (...items) => items,\n    reducer(reducerOptions) {\n      return makeReducerBuilder(events, presence, reducerOptions)\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwJA,SAAgB,SAGd,SAWiB;CACjB,MAAM,EAAE,SAAS;CACjB,IAAI,OAAO,SAAS,YAAY,KAAK,WAAW,GAC9C,MAAM,IAAI,UAAU,0CAA0C;CAEhE,IAAI,KAAK,SAAS,GAAQ,GACxB,MAAM,IAAI,UAAU,qDAAqD;CAE3E,MAAM,OAAO,QAAQ;CACrB,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,IAAI,GAAG;EACjD,IAAI,OAAO,SAAS,YAAY,EAAE,aAAa,YAC7C,MAAM,IAAI,UACR,aAAa,KAAK,oBAAoB,KAAK,iEAC7C;EAEF,iBAAiB,QAAQ,UAAU,KAAK,EAAE;CAC5C;CACA,MAAM,SAAS,OAAO,OAAO,EAAE,GAAG,KAAK,CAAC;CAExC,MAAM,eAAe,QAAQ,YAAa,CAAC;CAC3C,KAAK,MAAM,CAAC,OAAO,WAAW,OAAO,QAAQ,YAAY,GAAG;EAC1D,IAAI,OAAO,SAAS,YAAY,EAAE,aAAa,YAC7C,MAAM,IAAI,UACR,aAAa,KAAK,mCAAmC,MAAM,iEAC7D;EAEF,iBAAiB,QAAQ,mBAAmB,MAAM,EAAE;CACtD;CACA,MAAM,WAAW,OAAO,OAAO,EAAE,GAAG,aAAa,CAAC;CAElD,OAAO;EACL;EACA;EACA;EACA,QAAQ,GAAG,UAAU;EACrB,QAAQ,gBAAgB;GACtB,OAAO,mBAAmB,QAAQ,UAAU,cAAc;EAC5D;CACF;AACF"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as ContractEvent, c as PresenceDefs, d as PresenceSnapshot, f as ReducerOptions, h as StandardSchemaV1, i as Contract, l as PresenceMap, m as contract, n as ReducerBuilder, o as EventBatchFactory, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-DJKWm3cp.js";
-import { i as Event } from "./store-DtDOWLSn.js";
+import { a as ContractEvent, c as PresenceDefs, d as PresenceSnapshot, f as ReducerOptions, h as StandardSchemaV1, i as Contract, l as PresenceMap, m as contract, n as ReducerBuilder, o as EventBatchFactory, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-BcS9VDKC.js";
+import { i as Event } from "./store-D_yhNdPz.js";
 import { i as NonRetriableError, n as A2ErrorCode, r as A2ServerErrorCode, t as A2Error } from "./errors-DvhSXnxk.js";
 import { i as A2Telemetry, n as A2SpanHandle, r as A2SpanName, t as A2AttributeValue } from "./telemetry-CpeclqB2.js";
 export { type A2AttributeValue, A2Error, type A2ErrorCode, type A2ServerErrorCode, type A2SpanHandle, type A2SpanName, type A2Telemetry, type AppendInput, type Contract, type ContractEvent, type Event, type EventBatchFactory, type EventDefs, NonRetriableError, type PresenceDefs, type PresenceMap, type PresencePatch, type PresenceSnapshot, type Reducer, type ReducerBuilder, type ReducerOptions, type StandardSchemaV1, contract };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { t as contract } from "./contract-48bUMgcL.js";
+import { t as contract } from "./contract-CKRg_E4q.js";
 import { n as NonRetriableError, t as A2Error } from "./errors-DCk6ch5n.js";
 export { A2Error, NonRetriableError, contract };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { a as ContractEvent, c as PresenceDefs, l as PresenceMap, p as WithPresence, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-DJKWm3cp.js";
-import { a as Connection, c as HistoryState, l as LoadHistoryOptions, t as A2Client, u as PushResult } from "./client-P_NNNRM-.js";
+import { a as ContractEvent, c as PresenceDefs, l as PresenceMap, p as WithPresence, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-BcS9VDKC.js";
+import { a as Connection, c as HistoryState, l as LoadHistoryOptions, t as A2Client, u as PushResult } from "./client-BAEABRZB.js";
 import { ReactElement, ReactNode } from "react";
 //#region src/react.d.ts
 type UseSessionOptions<S> = {

package/dist/react.js

@@ -1,5 +1,5 @@
 "use client";
-import { t as createClient } from "./client-Bf6uSEAk.js";
+import { t as createClient } from "./client-BYzHjkwU.js";
 import { createContext, createElement, useContext, useEffect, useMemo, useSyncExternalStore } from "react";
 //#region src/react.ts
 /**

package/dist/{reducer-DJKWm3cp.d.ts → reducer-BcS9VDKC.d.ts}

@@ -179,6 +179,7 @@ declare function contract<D extends EventDefs, P extends PresenceDefs = Record<n
 }): Contract<D, P>;
 //#endregion
 //#region src/reducer.d.ts
+declare const clientStateProjection: unique symbol;
 /**
  * A pure fold over a session's events — `(state, event) => state` —
  * derived from a contract via `contract.reducer(options).fold(fn)`.
@@ -202,6 +203,8 @@ type Reducer<D extends EventDefs = EventDefs, S = unknown, P extends PresenceDef
   readonly presence: Readonly<P>;
   readonly fold: (state: S, event: ContractEvent<D>) => S;
   readonly initialState: S;
+  /** Internal read-side projection. Never used as a fold input or persisted. */
+  readonly [clientStateProjection]?: (state: S) => S;
   /**
    * When present: `initialState` was validated against it at
    * definition, and any cached fold a2 rehydrates (server snapshots,
@@ -216,4 +219,4 @@ type ReducerBuilder<D extends EventDefs, S, P extends PresenceDefs = Record<neve
 };
 //#endregion
 export { ContractEvent as a, PresenceDefs as c, PresenceSnapshot as d, ReducerOptions as f, StandardSchemaV1 as h, Contract as i, PresenceMap as l, contract as m, ReducerBuilder as n, EventBatchFactory as o, WithPresence as p, AppendInput as r, EventDefs as s, Reducer as t, PresencePatch as u };
-//# sourceMappingURL=reducer-DJKWm3cp.d.ts.map
+//# sourceMappingURL=reducer-BcS9VDKC.d.ts.map

package/dist/{reducer-DJKWm3cp.d.ts.map → reducer-BcS9VDKC.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"reducer-DJKWm3cp.d.ts","names":[],"sources":["../src/standard-schema.ts","../src/contract.ts","../src/reducer.ts"],"mappings":";;;;;;;;UAQiB,iBAAiB,iBAAiB,SAAS;;WAEjD,aAAa,iBAAiB,MAAM,OAAO;;kBAG7B;;mBAEN,MAAM,iBAAiB,SAAS;;aAEtC;;aAEA;;aAEA,WACP,mBACG,OAAO,UAAU,QAAQ,OAAO;;aAE5B,QAAQ,MAAM,OAAO;;;cAIpB,OAAO,UAAU,cAAc,UAAU;;mBAGpC,cAAc;;aAEpB,OAAO;;aAEP;;;mBAIM;;aAEN,QAAQ,cAAc;;;mBAIhB;;aAEN;;aAEA,OAAO,cAAc,cAAc;;;mBAI7B;;aAEN,KAAK;;;mBAIC,MAAM,iBAAiB,SAAS;;aAEtC,OAAO;;aAEP,QAAQ;;;cAIP,WAAW,eAAe,oBAAoB,YACxD;;cAIU,YAAY,eAAe,oBAAoB,YACzD;;;;;KC1DQ,YAAY,eAAe;;KAG3B,eAAe,eAAe;;KAG9B,cACV,UAAU,WACV,gBAAgB,mBAAmB,iBAElC,WAAW;EACV;EACA,MAAM;EACN,SAAS,iBAAiB,YAAY,EAAE;EACxC;EACA;EACA,WAAW;KAEb;;KAGU,YAAY,UAAU,gBAC/B,WAAW;EACV,MAAM;EACN,SAAS,iBAAiB,WAAW,EAAE;EACvC;WAEI;KAEI,kBAAkB,UAAU,oBAChC,mBAAmB,YAAY,SAElC,QAAQ,MACR;;;;;;KAOO,cAAc,UAAU,eAAe;EACjD;EACA,WACG,WAAW,cAAc,iBAAiB,YAAY,EAAE;EAE3D;EACA,IAAI;;;;;;;;KASM,YAAY,UAAU,eAAe;GAE5C,yBAAA,WAAW;IACV,OAAO,iBAAiB,YAAY,EAAE;IACtC;IACA,IAAI;;;;;;;;KAUE,iBAAiB,UAAU,eAAe;EACpD,UAAU,YAAY;;;;;;;KAQZ,aACV,UAAU,cACV,iBACQ,4BAA4B;KAE1B,eAAe,MAAM;;;;;EAK/B;;;;;;EAMA,cAAc;;;;;;EAMd,cAAc,iBAAiB,MAAM;;KAG3B,SACV,UAAU,YAAY,WACtB,UAAU,eAAe;;WAGhB;;WAEA,QAAQ,SAAS;;WAEjB,UAAU,SAAS;;WAEnB,OAAO,kBAAkB;;;;;;;;;;;EAWlC,QAAQ,MAAM,IAAI,MAChB,SAAS,eAAe,MAAM,KAC7B,eAAe,GAAG,GAAG;;;;;;;iBAQV,SACd,UAAU,WACV,UAAU,eAAe,sBACzB;;EAEA;;EAEA,QAAQ;;;;;;EAMR,WAAW;IACT,SAAS,GAAG;;;;;;;;;;;;;KCxJJ,QACV,UAAU,YAAY,WACtB,aACA,UAAU,eAAe;;WAGhB;;WAEA,QAAQ,SAAS;;;;;;WAMjB,UAAU,SAAS;WACnB,OAAO,OAAO,GAAG,OAAO,cAAc,OAAO;WAC7C,cAAc;;;;;;;WAOd,aAAa,0BAA0B;;;KAItC,eACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,KAAK,OAAO,OAAO,GAAG,OAAO,cAAc,OAAO,IAAI,QAAQ,GAAG,GAAG"}
+{"version":3,"file":"reducer-BcS9VDKC.d.ts","names":[],"sources":["../src/standard-schema.ts","../src/contract.ts","../src/reducer.ts"],"mappings":";;;;;;;;UAQiB,iBAAiB,iBAAiB,SAAS;;WAEjD,aAAa,iBAAiB,MAAM,OAAO;;kBAG7B;;mBAEN,MAAM,iBAAiB,SAAS;;aAEtC;;aAEA;;aAEA,WACP,mBACG,OAAO,UAAU,QAAQ,OAAO;;aAE5B,QAAQ,MAAM,OAAO;;;cAIpB,OAAO,UAAU,cAAc,UAAU;;mBAGpC,cAAc;;aAEpB,OAAO;;aAEP;;;mBAIM;;aAEN,QAAQ,cAAc;;;mBAIhB;;aAEN;;aAEA,OAAO,cAAc,cAAc;;;mBAI7B;;aAEN,KAAK;;;mBAIC,MAAM,iBAAiB,SAAS;;aAEtC,OAAO;;aAEP,QAAQ;;;cAIP,WAAW,eAAe,oBAAoB,YACxD;;cAIU,YAAY,eAAe,oBAAoB,YACzD;;;;;KC1DQ,YAAY,eAAe;;KAG3B,eAAe,eAAe;;KAG9B,cACV,UAAU,WACV,gBAAgB,mBAAmB,iBAElC,WAAW;EACV;EACA,MAAM;EACN,SAAS,iBAAiB,YAAY,EAAE;EACxC;EACA;EACA,WAAW;KAEb;;KAGU,YAAY,UAAU,gBAC/B,WAAW;EACV,MAAM;EACN,SAAS,iBAAiB,WAAW,EAAE;EACvC;WAEI;KAEI,kBAAkB,UAAU,oBAChC,mBAAmB,YAAY,SAElC,QAAQ,MACR;;;;;;KAOO,cAAc,UAAU,eAAe;EACjD;EACA,WACG,WAAW,cAAc,iBAAiB,YAAY,EAAE;EAE3D;EACA,IAAI;;;;;;;;KASM,YAAY,UAAU,eAAe;GAE5C,yBAAA,WAAW;IACV,OAAO,iBAAiB,YAAY,EAAE;IACtC;IACA,IAAI;;;;;;;;KAUE,iBAAiB,UAAU,eAAe;EACpD,UAAU,YAAY;;;;;;;KAQZ,aACV,UAAU,cACV,iBACQ,4BAA4B;KAE1B,eAAe,MAAM;;;;;EAK/B;;;;;;EAMA,cAAc;;;;;;EAMd,cAAc,iBAAiB,MAAM;;KAG3B,SACV,UAAU,YAAY,WACtB,UAAU,eAAe;;WAGhB;;WAEA,QAAQ,SAAS;;WAEjB,UAAU,SAAS;;WAEnB,OAAO,kBAAkB;;;;;;;;;;;EAWlC,QAAQ,MAAM,IAAI,MAChB,SAAS,eAAe,MAAM,KAC7B,eAAe,GAAG,GAAG;;;;;;;iBAQV,SACd,UAAU,WACV,UAAU,eAAe,sBACzB;;EAEA;;EAEA,QAAQ;;;;;;EAMR,WAAW;IACT,SAAS,GAAG;;;cClKH;;;;;;;;;;;KAcD,QACV,UAAU,YAAY,WACtB,aACA,UAAU,eAAe;;WAGhB;;WAEA,QAAQ,SAAS;;;;;;WAMjB,UAAU,SAAS;WACnB,OAAO,OAAO,GAAG,OAAO,cAAc,OAAO;WAC7C,cAAc;;YAEb,0BAA0B,OAAO,MAAM;;;;;;;WAOxC,aAAa,0BAA0B;;;KAItC,eACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,KAAK,OAAO,OAAO,GAAG,OAAO,cAAc,OAAO,IAAI,QAAQ,GAAG,GAAG"}

package/dist/reducer-DEMjEY_O.js

@@ -0,0 +1,29 @@
+import { n as validateSync } from "./validate-XKT4FSNn.js";
+//#region src/reducer.ts
+const clientStateProjection = Symbol("a2.clientStateProjection");
+/** Internal — reducers are created through `contract.reducer(...).fold(...)`. */
+function makeReducerBuilder(events, presence, options) {
+	const { name } = options;
+	if (typeof name !== "string" || name.length === 0) throw new TypeError("reducer name must be a non-empty string — it identifies the reducer and keys cached snapshots");
+	let initialState = options.initialState;
+	if (options.stateSchema) {
+		const result = validateSync(options.stateSchema, options.initialState, "the stateSchema");
+		if (result.issues) throw new TypeError(`reducer initialState does not match its stateSchema: ${result.issues.map((issue) => issue.message).join("; ")}`);
+		initialState = result.value;
+	}
+	return { fold(fold) {
+		if (typeof fold !== "function") throw new TypeError("reducer fold must be a function");
+		return {
+			name,
+			events,
+			presence,
+			fold,
+			initialState,
+			stateSchema: options.stateSchema
+		};
+	} };
+}
+//#endregion
+export { makeReducerBuilder as n, clientStateProjection as t };
+
+//# sourceMappingURL=reducer-DEMjEY_O.js.map

package/dist/reducer-DEMjEY_O.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer-DEMjEY_O.js","names":[],"sources":["../src/reducer.ts"],"sourcesContent":["import type { ContractEvent, EventDefs, PresenceDefs } from './contract.ts'\nimport type { StandardSchemaV1 } from './standard-schema.ts'\nimport { validateSync } from './validate.ts'\n\nexport const clientStateProjection: unique symbol = Symbol(\n  'a2.clientStateProjection',\n)\n\n/**\n * A pure fold over a session's events — `(state, event) => state` —\n * derived from a contract via `contract.reducer(options).fold(fn)`.\n *\n * The name is the reducer's identity. Cached folds (server snapshots,\n * the browser cache) are keyed by it, which makes it the invalidation\n * knob too: changed the fold's logic? Change the name. Snapshots under\n * the old name are ignored and the next read refolds from raw events.\n * See docs/concepts/04-state.mdx.\n */\nexport type Reducer<\n  D extends EventDefs = EventDefs,\n  S = unknown,\n  P extends PresenceDefs = Record<never, never>,\n> = {\n  /** Identity and cache key. Rename when the fold's logic changes. */\n  readonly name: string\n  /** The contract's vocabulary — types every event in the fold. */\n  readonly events: Readonly<D>\n  /**\n   * The contract's presence vocabulary — carried because the reducer\n   * is the client's typed handle on the contract. The fold never sees\n   * presence.\n   */\n  readonly presence: Readonly<P>\n  readonly fold: (state: S, event: ContractEvent<D>) => S\n  readonly initialState: S\n  /** Internal read-side projection. Never used as a fold input or persisted. */\n  readonly [clientStateProjection]?: (state: S) => S\n  /**\n   * When present: `initialState` was validated against it at\n   * definition, and any cached fold a2 rehydrates (server snapshots,\n   * the browser cache) is checked against it — failing snapshots are\n   * discarded and refolded, catching shape drift a stale name can't.\n   */\n  readonly stateSchema: StandardSchemaV1<unknown, S> | undefined\n}\n\n/** The second step of `contract.reducer` — see the method's doc. */\nexport type ReducerBuilder<\n  D extends EventDefs,\n  S,\n  P extends PresenceDefs = Record<never, never>,\n> = {\n  fold(fold: (state: S, event: ContractEvent<D>) => S): Reducer<D, S, P>\n}\n\n/** Internal — reducers are created through `contract.reducer(...).fold(...)`. */\nexport function makeReducerBuilder<\n  D extends EventDefs,\n  P extends PresenceDefs,\n  Seed,\n  S,\n>(\n  events: Readonly<D>,\n  presence: Readonly<P>,\n  options: {\n    name: string\n    initialState: Seed\n    stateSchema?: StandardSchemaV1<Seed, S>\n  },\n): ReducerBuilder<D, S, P> {\n  const { name } = options\n  if (typeof name !== 'string' || name.length === 0) {\n    throw new TypeError(\n      'reducer name must be a non-empty string — it identifies the reducer and keys cached snapshots',\n    )\n  }\n\n  // Without a schema, S = Seed (the type parameter default), so the\n  // seed is the state. With one, the seed is the schema's input and the\n  // validated output (defaults applied) becomes the fold's actual seed.\n  let initialState = options.initialState as unknown as S\n  if (options.stateSchema) {\n    const result = validateSync(\n      options.stateSchema,\n      options.initialState,\n      'the stateSchema',\n    )\n    if (result.issues) {\n      throw new TypeError(\n        `reducer initialState does not match its stateSchema: ${result.issues\n          .map((issue) => issue.message)\n          .join('; ')}`,\n      )\n    }\n    initialState = result.value as S\n  }\n\n  return {\n    fold(fold) {\n      if (typeof fold !== 'function') {\n        throw new TypeError('reducer fold must be a function')\n      }\n      return {\n        name,\n        events,\n        presence,\n        fold,\n        initialState,\n        stateSchema: options.stateSchema as\n          StandardSchemaV1<unknown, S> | undefined,\n      }\n    },\n  }\n}\n"],"mappings":";;AAIA,MAAa,wBAAuC,OAClD,0BACF;;AAkDA,SAAgB,mBAMd,QACA,UACA,SAKyB;CACzB,MAAM,EAAE,SAAS;CACjB,IAAI,OAAO,SAAS,YAAY,KAAK,WAAW,GAC9C,MAAM,IAAI,UACR,+FACF;CAMF,IAAI,eAAe,QAAQ;CAC3B,IAAI,QAAQ,aAAa;EACvB,MAAM,SAAS,aACb,QAAQ,aACR,QAAQ,cACR,iBACF;EACA,IAAI,OAAO,QACT,MAAM,IAAI,UACR,wDAAwD,OAAO,OAC5D,KAAK,UAAU,MAAM,OAAO,CAAC,CAC7B,KAAK,IAAI,GACd;EAEF,eAAe,OAAO;CACxB;CAEA,OAAO,EACL,KAAK,MAAM;EACT,IAAI,OAAO,SAAS,YAClB,MAAM,IAAI,UAAU,iCAAiC;EAEvD,OAAO;GACL;GACA;GACA;GACA;GACA;GACA,aAAa,QAAQ;EAEvB;CACF,EACF;AACF"}

package/dist/scheduler-qstash.d.ts

@@ -1,5 +1,5 @@
-import { r as Clock } from "./store-DtDOWLSn.js";
-import { E as SchedulerTask, t as A2Scheduler } from "./server-DjZZa1wr.js";
+import { r as Clock } from "./store-D_yhNdPz.js";
+import { E as SchedulerTask, t as A2Scheduler } from "./server-Bp5Nd1pF.js";
 //#region src/scheduler-qstash.d.ts
 type QStashStoreOutage = {
   version: 1;

package/dist/scheduler-qstash.js

@@ -1,7 +1,7 @@
 import { t as A2Error } from "./errors-DCk6ch5n.js";
 import { d as classifySchedulerSendFailure, g as serverInternals, t as DRAIN_TIMINGS, u as assertSchedulerTargets } from "./internal-Dq2qYxou.js";
 import { n as platformVercelOidcToken } from "./platform-B4TnJtWu.js";
-import { n as deliverSchedulerAppend } from "./server-BeNADlCI.js";
+import { n as deliverSchedulerAppend } from "./server-CjJSGcF7.js";
 import { t as retryableLazy } from "./retryable-lazy-DZWmHpii.js";
 import { n as SYSTEM_CLOCK } from "./store-N8PXxDAS.js";
 import { t as normalizeSchedulerTask } from "./scheduler-task-BpzhPnRS.js";

package/dist/scheduler-vercel.d.ts

@@ -1,5 +1,5 @@
-import { r as Clock } from "./store-DtDOWLSn.js";
-import { E as SchedulerTask, t as A2Scheduler } from "./server-DjZZa1wr.js";
+import { r as Clock } from "./store-D_yhNdPz.js";
+import { E as SchedulerTask, t as A2Scheduler } from "./server-Bp5Nd1pF.js";
 //#region src/scheduler-vercel.d.ts
 /**
  * The "not settled yet" signal for a stalled handler — an expected state,

package/dist/scheduler-vercel.js

@@ -1,5 +1,5 @@
 import { d as classifySchedulerSendFailure, g as serverInternals, t as DRAIN_TIMINGS, u as assertSchedulerTargets } from "./internal-Dq2qYxou.js";
-import { n as deliverSchedulerAppend } from "./server-BeNADlCI.js";
+import { n as deliverSchedulerAppend } from "./server-CjJSGcF7.js";
 import { t as retryableLazy } from "./retryable-lazy-DZWmHpii.js";
 import { n as SYSTEM_CLOCK } from "./store-N8PXxDAS.js";
 import { t as normalizeSchedulerTask } from "./scheduler-task-BpzhPnRS.js";

package/dist/{server-DjZZa1wr.d.ts → server-Bp5Nd1pF.d.ts}

@@ -1,5 +1,5 @@
-import { a as ContractEvent, c as PresenceDefs, d as PresenceSnapshot, i as Contract, l as PresenceMap, p as WithPresence, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-DJKWm3cp.js";
-import { t as A2Store } from "./store-DtDOWLSn.js";
+import { a as ContractEvent, c as PresenceDefs, d as PresenceSnapshot, i as Contract, l as PresenceMap, p as WithPresence, r as AppendInput, s as EventDefs, t as Reducer, u as PresencePatch } from "./reducer-BcS9VDKC.js";
+import { t as A2Store } from "./store-D_yhNdPz.js";
 import { i as A2Telemetry } from "./telemetry-CpeclqB2.js";
 //#region src/session-socket.d.ts
 /**
@@ -287,4 +287,4 @@ type ServerOptions<D extends EventDefs, P extends PresenceDefs = Record<never, n
 declare function createServer<D extends EventDefs, P extends PresenceDefs = Record<never, never>>(options: ServerOptions<D, P>): A2Server<D, P>;
 //#endregion
 export { ServerFetchOptions as A, ScheduledEvent as C, A2Operation as D, SchedulerTask as E, A2Socket as M, A2PushEvent as O, handler as S, SchedulerDrainTask as T, SessionPresence as _, Handler as a, createServer as b, HandlerEntry as c, ScheduleDelay as d, ScheduleTiming as f, SessionDispatch as g, SessionAppend as h, DrainableServer as i, UpgradeWebSocket as j, A2PushPresence as k, Lane as l, Session as m, A2Server as n, HandlerAppend as o, ServerOptions as p, AbortSpec as r, HandlerContext as s, A2Scheduler as t, LaneContext as u, SessionSchedule as v, SchedulerAppendTask as w, deliverSchedulerAppend as x, StateOptions as y };
-//# sourceMappingURL=server-DjZZa1wr.d.ts.map
+//# sourceMappingURL=server-Bp5Nd1pF.d.ts.map