experimental-a2 0.6.0 → 0.7.0

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["/**\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 { A2Error } from './errors.ts'\nimport {\n  PRESENCE_TIMINGS,\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 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 type ConnectionStatus = 'idle' | 'connecting' | '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      /** Drops of an established stream so far. `0` = first connect. */\n      reconnects: number\n      /** Why the last connection ended; `null` on the first connect. */\n      error: Error | null\n    }\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 stream frontier: the last server-confirmed 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 only `STORE_UNAVAILABLE`. 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 reconnects with backoff and resumes from the frontier.\n   */\n  connect(): () => 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 current frontier.\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 string 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 — every session of this client — over one\n * multiplexed WebSocket, served by `sessionsSocket`.\n */\nexport type ClientApi =\n  | string // one route: GET SSE stream + POST push\n  | { type: 'http'; push: string; stream: string } // split routes\n  | { type: 'ws'; url: string } // one socket, all sessions, both directions\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  /** 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 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: '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 the wire-deserialized A2Error. */\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 httpTransport = (\n  routes: { push: string; stream: string },\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 sep = routes.stream.includes('?') ? '&' : '?'\n    const res = await fetchImpl(\n      `${routes.stream}${sep}sessionId=${encodeURIComponent(sessionId)}&index=${startAfter}`,\n      { headers: { accept: 'text/event-stream' }, signal },\n    )\n    if (!res.ok || !res.body) {\n      throw new Error(`stream failed with ${res.status}`)\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          }\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(routes.push, {\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 A2Error(\n          'STORE_UNAVAILABLE',\n          'push ack was not a list of events',\n        )\n      }\n      return rows\n    }\n    throw (\n      errorFromWire(await res.json().catch(() => null)) ??\n      new A2Error('STORE_UNAVAILABLE', `push failed with ${res.status}`)\n    )\n  },\n\n  async history({ sessionId, gte, lte }) {\n    const sep = routes.stream.includes('?') ? '&' : '?'\n    const res = await fetchImpl(\n      `${routes.stream}${sep}sessionId=${encodeURIComponent(sessionId)}&gte=${gte}&lte=${lte}`,\n      { headers: { accept: 'application/json' } },\n    )\n    if (!res.ok) {\n      throw (\n        errorFromWire(await res.json().catch(() => null)) ??\n        new A2Error('STORE_UNAVAILABLE', `history failed with ${res.status}`)\n      )\n    }\n    const rows = (await res.json()) as unknown\n    if (!Array.isArray(rows) || !rows.every(isWireEvent)) {\n      throw new A2Error(\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(routes.push, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: JSON.stringify(envelope),\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\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 wsTransport = (\n  url: string,\n  webSocketImpl: ClientWebSocketConstructor | undefined,\n  presence: boolean,\n): Transport => {\n  type PendingAck = {\n    resolve: (events: WireEvent[]) => void\n    reject: (error: A2Error) => void\n  }\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 readyWaiters = new Map<string, Set<() => void>>()\n  let socket: ClientWebSocket | null = null\n  let socketOpen = false\n  let watchdog: ReturnType<typeof setTimeout> | undefined\n  let nextReq = 1\n\n  const flushReadyWaiters = (sessionId: string): void => {\n    const waiters = readyWaiters.get(sessionId)\n    if (!waiters) return\n    readyWaiters.delete(sessionId)\n    for (const waiter of waiters) waiter()\n  }\n\n  const socketUrl = (): string => {\n    let resolved: URL\n    if (/^(https?|wss?):\\/\\//i.test(url)) {\n      resolved = new URL(url)\n    } else {\n      // A relative url resolves against the page, exactly like fetch.\n      // Outside a browser (SSR, tests) there is nothing to resolve\n      // against — demand an absolute url there.\n      const base = (globalThis as { location?: { href: string } }).location\n        ?.href\n      if (base === undefined) {\n        throw new TypeError(\n          `cannot resolve the relative ws url '${url}' without a browser location — pass an absolute ws:// or wss:// url`,\n        )\n      }\n      resolved = new URL(url, base)\n    }\n    if (resolved.protocol === 'http:') resolved.protocol = 'ws:'\n    else if (resolved.protocol === 'https:') resolved.protocol = 'wss:'\n    return resolved.href\n  }\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    if (pending.size > 0) {\n      const rejection = new A2Error(\n        'STORE_UNAVAILABLE',\n        'socket closed with the ack outstanding',\n      )\n      for (const waiter of pending.values()) waiter.reject(rejection)\n      pending.clear()\n    }\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 Error(\n          `socket stalled: no data for ${STREAM_TIMINGS.stallTimeoutMs}ms`,\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        flushReadyWaiters(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.reason === undefined ? null : new Error(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(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(socketUrl())\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 Error(\n              `socket closed (${event.code}${event.reason ? `: ${event.reason}` : ''})`,\n            ),\n      )\n    })\n    created.addEventListener('error', () => {\n      if (socket !== created) return\n      failSocket(new Error('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 Error(\n            'subscribe not confirmed: is the ws route calling server.fetch with upgradeWebSocket?',\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 A2Error('STORE_UNAVAILABLE', 'no open socket for the session')\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 A2Error('STORE_UNAVAILABLE', 'socket send failed', { cause }),\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 new Promise((resolve) => {\n        let waiters = readyWaiters.get(sessionId)\n        if (!waiters) {\n          waiters = new Set()\n          readyWaiters.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) readyWaiters.delete(sessionId)\n          // oxlint-disable-next-line promise/no-multiple-resolved -- `settled` guards the two callers (timer, open flush); the rule cannot see through the flag\n          resolve()\n        }\n        // The cap keeps a session nobody reconnects (write-only usage,\n        // an unreachable server) from parking a push forever — the\n        // attempt then fails fast and the loop moves on.\n        const timer = setTimeout(done, maxWaitMs)\n        ;(timer as { unref?: () => void }).unref?.()\n        waiters.add(done)\n      })\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') {\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  return wsTransport(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 webSocketImpl =\n    options.webSocket ??\n    (globalThis as { WebSocket?: ClientWebSocketConstructor }).WebSocket\n  const transport = transportFor(\n    api,\n    fetchImpl,\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 frontier = sessionOptions?.initialIndex ?? 0\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 <= frontier)\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: Error | 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 = acked.at(-1)?.index ?? frontier\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          return { status: 'connecting', 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 frontier of 0, an empty log as far as\n        // this client knows — means nothing older is left to fetch.\n        complete: oldestLoaded === 1 || frontier === 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) state = reducer.fold(state, event)\n      return {\n        state,\n        events: [...serverEvents, ...overlay],\n        index: frontier,\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: frontier, 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 frontier 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: frontier, 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        const schema = Object.hasOwn(presenceDefs, field)\n          ? presenceDefs[field]\n          : undefined\n        if (!schema) {\n          throw new A2Error(\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 A2Error(\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 frontier 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 <= frontier) return\n      frontier = event.index\n      serverEvents.push(event)\n      foldedState = reducer.fold(foldedState, event)\n      pending = pending.filter((p) => p.id !== event.id)\n      if (confirmWatchers.some((w) => w.index <= frontier)) {\n        const due = confirmWatchers.filter((w) => w.index <= frontier)\n        confirmWatchers = confirmWatchers.filter((w) => w.index > frontier)\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 A2Error(\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 A2Error(\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: A2Error = new A2Error(\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 =\n            err instanceof A2Error\n              ? err\n              : new A2Error('STORE_UNAVAILABLE', 'push request failed', {\n                  cause: err,\n                })\n        }\n        // Only the documented retryable code retries; identical ids\n        // make the retry idempotent on the server.\n        if (lastPushError.code !== 'STORE_UNAVAILABLE') 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 (frontier >= 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            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            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 frontier. 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 ?? frontier + 1\n        // Strictly at or below the frontier: 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, frontier)\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            frontier,\n          )\n          return eventsBetween(gte, lte)\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 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      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      // 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        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: frontier,\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              wasLive = true\n              status = 'live'\n              lastError = null\n              notify()\n              if (presenceResend) {\n                const values = presenceResend\n                presenceResend = null\n                queuePresenceSend(values)\n              }\n            }\n            if (frame.kind === 'event') {\n              ingest(eventFromWire(frame.event) as ContractEvent<D>)\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 Error(\n                  `stream stalled: no data for ${STREAM_TIMINGS.stallTimeoutMs}ms`,\n                )\n              : err instanceof Error\n                ? err\n                : new Error(String(err))\n          }\n        } finally {\n          clearTimeout(stall)\n        }\n        if (generation !== run) break\n        if (wasLive) reconnects += 1\n        status = 'connecting'\n        notify()\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            // oxlint-disable-next-line no-multiple-resolved -- guarded above\n            resolve()\n          }\n          const timer = setTimeout(finish, backoff)\n          ;(timer as { unref?: () => void }).unref?.()\n          abort?.signal.addEventListener('abort', finish)\n        })\n        backoff = Math.min(backoff * 2, STREAM_TIMINGS.reconnectMaxMs)\n      }\n      // oxlint-enable no-await-in-loop\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      connect() {\n        touch(sessionId)\n        leases += 1\n        const epoch = leaseEpoch\n        if (!active) {\n          active = true\n          status = 'connecting'\n          notify()\n          void runStream(generation)\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 > frontier && 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, frontier),\n        )\n        if (next.initialState === undefined || nextIndex <= frontier) {\n          if (historyChanged) notifyHydrated()\n          return\n        }\n\n        // The server fold subsumes everything observed through the old\n        // frontier. Keep later optimistic work overlaid, retiring acked\n        // entries the new frontier proves are already durable.\n        frontier = nextIndex\n        foldedState = next.initialState\n        mergeServerEvents(next.initialEvents, frontier)\n        pending = pending.filter(\n          (entry) => !entry.acked || entry.acked.index > frontier,\n        )\n        if (confirmWatchers.some((watcher) => watcher.index <= frontier)) {\n          const due = confirmWatchers.filter(\n            (watcher) => watcher.index <= frontier,\n          )\n          confirmWatchers = confirmWatchers.filter(\n            (watcher) => watcher.index > frontier,\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/errors-BQuJpe82.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors-BQuJpe82.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * a2 errors — one class, discriminated by `code`.\n *\n * See specs/a2-implementation.md §10 and docs/reference/02-errors.mdx.\n * A single class serializes cleanly across the push-route boundary and\n * keeps `instanceof` checks working after bundling.\n */\n\nexport type A2ErrorCode =\n  | 'INVALID_PAYLOAD' // schema validation failed — thrown before anything is written\n  | 'UNKNOWN_EVENT_TYPE' // event type not in the machine's `events` map\n  | 'PARTIAL_DUPLICATE_BATCH' // batch mixed already-appended and fresh events\n  | 'SUPERSEDED_ATTEMPT' // handler append from an attempt a recovery claim replaced\n  | 'CLAIM_EXPIRED' // ctx.signal abort reason: the attempt's lease lapsed without renewal\n  | 'STORE_UNAVAILABLE' // store backend failure — retryable, nothing was written\n  | 'STORE_NOT_CONFIGURED' // production boot with no `store` passed\n  | 'UNKNOWN_PRESENCE_FIELD' // presence field not in the contract's `presence` map\n  | 'PRESENCE_NOT_SUPPORTED' // contract declares presence but the store lacks the capability\n\nexport class A2Error extends Error {\n  readonly code: A2ErrorCode\n  /** e.g. the Standard Schema issues for INVALID_PAYLOAD */\n  readonly details: unknown\n\n  constructor(\n    code: A2ErrorCode,\n    message: string,\n    options?: { details?: unknown; cause?: unknown },\n  ) {\n    super(\n      message,\n      options && 'cause' in options ? { cause: options.cause } : undefined,\n    )\n    this.name = 'A2Error'\n    this.code = code\n    this.details = options?.details\n  }\n}\n\n/**\n * Wrap an arbitrary thrown value as STORE_UNAVAILABLE, preserving the\n * original as `cause`. A2Errors pass through untouched — they already\n * carry their own meaning.\n */\nexport function asStoreUnavailable(err: unknown): A2Error {\n  if (err instanceof A2Error) return err\n  return new A2Error('STORE_UNAVAILABLE', 'the store backend failed', {\n    cause: err,\n  })\n}\n"],"mappings":";AAmBA,IAAa,UAAb,cAA6B,MAAM;CACjC;;CAEA;CAEA,YACE,MACA,SACA,SACA;EACA,MACE,SACA,WAAW,WAAW,UAAU,EAAE,OAAO,QAAQ,MAAM,IAAI,KAAA,CAC7D;EACA,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,UAAU,SAAS;CAC1B;AACF;;;;;;AAOA,SAAgB,mBAAmB,KAAuB;CACxD,IAAI,eAAe,SAAS,OAAO;CACnC,OAAO,IAAI,QAAQ,qBAAqB,4BAA4B,EAClE,OAAO,IACT,CAAC;AACH"}
+{"version":3,"file":"errors-BQuJpe82.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * a2 errors — one class, discriminated by `code`.\n *\n * See specs/a2-implementation.md §10 and docs/reference/02-errors.mdx.\n * A single class serializes cleanly across the push-route boundary and\n * keeps `instanceof` checks working after bundling.\n */\n\nexport type A2ErrorCode =\n  | 'INVALID_PAYLOAD' // schema validation failed — thrown before anything is written\n  | 'FORBIDDEN' // external ingress was denied by server.fetch authorization\n  | 'UNKNOWN_EVENT_TYPE' // event type not in the machine's `events` map\n  | 'PARTIAL_DUPLICATE_BATCH' // batch mixed already-appended and fresh events\n  | 'SUPERSEDED_ATTEMPT' // handler append from an attempt a recovery claim replaced\n  | 'CLAIM_EXPIRED' // ctx.signal abort reason: the attempt's lease lapsed without renewal\n  | 'STORE_UNAVAILABLE' // store backend failure — retryable, nothing was written\n  | 'STORE_NOT_CONFIGURED' // production boot with no `store` passed\n  | 'UNKNOWN_PRESENCE_FIELD' // presence field not in the contract's `presence` map\n  | 'PRESENCE_NOT_SUPPORTED' // contract declares presence but the store lacks the capability\n\nexport class A2Error extends Error {\n  readonly code: A2ErrorCode\n  /** e.g. the Standard Schema issues for INVALID_PAYLOAD */\n  readonly details: unknown\n\n  constructor(\n    code: A2ErrorCode,\n    message: string,\n    options?: { details?: unknown; cause?: unknown },\n  ) {\n    super(\n      message,\n      options && 'cause' in options ? { cause: options.cause } : undefined,\n    )\n    this.name = 'A2Error'\n    this.code = code\n    this.details = options?.details\n  }\n}\n\n/**\n * Wrap an arbitrary thrown value as STORE_UNAVAILABLE, preserving the\n * original as `cause`. A2Errors pass through untouched — they already\n * carry their own meaning.\n */\nexport function asStoreUnavailable(err: unknown): A2Error {\n  if (err instanceof A2Error) return err\n  return new A2Error('STORE_UNAVAILABLE', 'the store backend failed', {\n    cause: err,\n  })\n}\n"],"mappings":";AAoBA,IAAa,UAAb,cAA6B,MAAM;CACjC;;CAEA;CAEA,YACE,MACA,SACA,SACA;EACA,MACE,SACA,WAAW,WAAW,UAAU,EAAE,OAAO,QAAQ,MAAM,IAAI,KAAA,CAC7D;EACA,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,UAAU,SAAS;CAC1B;AACF;;;;;;AAOA,SAAgB,mBAAmB,KAAuB;CACxD,IAAI,eAAe,SAAS,OAAO;CACnC,OAAO,IAAI,QAAQ,qBAAqB,4BAA4B,EAClE,OAAO,IACT,CAAC;AACH"}

package/dist/index.d.ts

@@ -1,5 +1,24 @@
 import { a as EventDefs, c as PresencePatch, f as contract, h as StandardSchemaV1, i as EventBatchFactory, l as PresenceSnapshot, m as ReducerBuilder, n as Contract, o as PresenceDefs, p as Reducer, r as ContractEvent, s as PresenceMap, t as AppendInput, u as ReducerOptions } from "./contract-jIfaR085.js";
-import { a as Event } from "./store-DysUkTH3.js";
+import { i as Event } from "./store-flRz1OWh.js";
 import { i as A2Telemetry, n as A2SpanHandle, r as A2SpanName, t as A2AttributeValue } from "./telemetry-CpeclqB2.js";
-import { n as A2ErrorCode, t as A2Error } from "./errors-W6nwJ-fm.js";
-export { type A2AttributeValue, A2Error, type A2ErrorCode, type A2SpanHandle, type A2SpanName, type A2Telemetry, type AppendInput, type Contract, type ContractEvent, type Event, type EventBatchFactory, type EventDefs, type PresenceDefs, type PresenceMap, type PresencePatch, type PresenceSnapshot, type Reducer, type ReducerBuilder, type ReducerOptions, type StandardSchemaV1, contract };
+//#region src/errors.d.ts
+/**
+ * a2 errors — one class, discriminated by `code`.
+ *
+ * See specs/a2-implementation.md §10 and docs/reference/02-errors.mdx.
+ * A single class serializes cleanly across the push-route boundary and
+ * keeps `instanceof` checks working after bundling.
+ */
+type A2ErrorCode = "INVALID_PAYLOAD" | "FORBIDDEN" | "UNKNOWN_EVENT_TYPE" | "PARTIAL_DUPLICATE_BATCH" | "SUPERSEDED_ATTEMPT" | "CLAIM_EXPIRED" | "STORE_UNAVAILABLE" | "STORE_NOT_CONFIGURED" | "UNKNOWN_PRESENCE_FIELD" | "PRESENCE_NOT_SUPPORTED";
+declare class A2Error extends Error {
+  readonly code: A2ErrorCode;
+  /** e.g. the Standard Schema issues for INVALID_PAYLOAD */
+  readonly details: unknown;
+  constructor(code: A2ErrorCode, message: string, options?: {
+    details?: unknown;
+    cause?: unknown;
+  });
+}
+//#endregion
+export { type A2AttributeValue, A2Error, type A2ErrorCode, type A2SpanHandle, type A2SpanName, type A2Telemetry, type AppendInput, type Contract, type ContractEvent, type Event, type EventBatchFactory, type EventDefs, type PresenceDefs, type PresenceMap, type PresencePatch, type PresenceSnapshot, type Reducer, type ReducerBuilder, type ReducerOptions, type StandardSchemaV1, contract };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;;;;;;;KAQY;cAYC,gBAAgB;WAClB,MAAM;;WAEN;EAET,YACE,MAAM,aACN,iBACA;IAAY;IAAmB"}

package/dist/{internal-DstsI6Re.js → internal-DRXJ56EI.js}

@@ -28,8 +28,6 @@ const RESERVED_PARTICIPANT_IDS = /* @__PURE__ */ new Set([
 	"prototype"
 ]);
 const serverInternals = /* @__PURE__ */ new WeakMap();
-/** Scheduler configuration captured only for servers made by `createServer`. */
-const serverSchedulerBindings = /* @__PURE__ */ new WeakMap();
 const objectLike = (value) => typeof value === "object" && value !== null || typeof value === "function";
 const TOOL_SCOPE_STORAGE = Symbol.for("experimental-a2.ai.tool-scope");
 function ambientToolScopeStorage() {
@@ -104,39 +102,18 @@ const isDrainableServer = (value) => {
 };
 /**
 * Validate the server list captured by a scheduler route at construction time.
-* Built-in adapters keep their low-level target seam structural for custom
-* integrations. The application-facing `schedulerHandler` uses strict mode
-* so only servers made by this A2 copy reach a configured adapter.
+* The seam stays structural so custom scheduler integrations can supply their
+* own drainable targets.
 */
-function assertSchedulerTargets(servers, options) {
+function assertSchedulerTargets(servers) {
 	const contracts = /* @__PURE__ */ new Set();
 	for (const target of servers) {
 		if (!isDrainableServer(target)) throw new TypeError("a2 scheduler: expected a server from createServer()");
 		const name = target.contract.name;
 		if (contracts.has(name)) throw new TypeError(`a2 scheduler: duplicate server contract '${name}' in one handler`);
 		contracts.add(name);
-		if (!serverSchedulerBindings.get(target)) {
-			if (!options.allowStructural) throw new TypeError(`a2 scheduler: server for contract '${name}' was not created by createServer()`);
-			continue;
-		}
 	}
 }
-/** Require every real server to share one exact configured scheduler. */
-function assertServerSchedulerBindings(scheduler, servers) {
-	for (const server of servers) {
-		const binding = serverSchedulerBindings.get(server);
-		if (!binding?.scheduler) throw new TypeError(`a2 scheduler: server for contract '${server.contract.name}' has no scheduler configured`);
-		if (binding.scheduler !== scheduler) throw new TypeError(`a2 scheduler: server for contract '${server.contract.name}' is configured with a different scheduler instance`);
-	}
-}
-/** Resolve the scheduler privately bound to a real A2 server. */
-function schedulerForServer(server) {
-	if (!isDrainableServer(server)) throw new TypeError("a2 scheduler: expected a server from createServer()");
-	const binding = serverSchedulerBindings.get(server);
-	if (!binding) throw new TypeError(`a2 scheduler: server for contract '${server.contract.name}' was not created by createServer()`);
-	if (!binding.scheduler) throw new TypeError(`a2 scheduler: server for contract '${server.contract.name}' has no scheduler configured`);
-	return binding.scheduler;
-}
 /**
 * Drain timing knobs. Mutable only as a white-box test seam. Claim
 * heartbeats run on real timers, so tests shrink these to keep suites
@@ -206,6 +183,6 @@ const SOCKET_TIMINGS = {
 */
 const PRESENCE_TIMINGS = { sendIntervalMs: 66 };
 //#endregion
-export { schedulerForServer as _, PRESENCE_TIMINGS as a, STREAM_TIMINGS as c, assertServerSchedulerBindings as d, classifySchedulerSendFailure as f, nullProtoRecord as g, markSchedulerSendFailure as h, POLL_TIMINGS as i, ambientToolScopeStorage as l, installAmbientToolScopeStorage as m, MAX_DATE_MS as n, RESERVED_PARTICIPANT_IDS as o, consumeSchedulerSendFailure as p, NOTIFY_TIMINGS as r, SOCKET_TIMINGS as s, DRAIN_TIMINGS as t, assertSchedulerTargets as u, serverInternals as v, serverSchedulerBindings as y };
+export { PRESENCE_TIMINGS as a, STREAM_TIMINGS as c, classifySchedulerSendFailure as d, consumeSchedulerSendFailure as f, serverInternals as g, nullProtoRecord as h, POLL_TIMINGS as i, ambientToolScopeStorage as l, markSchedulerSendFailure as m, MAX_DATE_MS as n, RESERVED_PARTICIPANT_IDS as o, installAmbientToolScopeStorage as p, NOTIFY_TIMINGS as r, SOCKET_TIMINGS as s, DRAIN_TIMINGS as t, assertSchedulerTargets as u };
 
-//# sourceMappingURL=internal-DstsI6Re.js.map
+//# sourceMappingURL=internal-DRXJ56EI.js.map

package/dist/internal-DRXJ56EI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-DRXJ56EI.js","names":[],"sources":["../src/internal.ts"],"sourcesContent":["/**\n * Private seams shared by a2 entry points and a2's own tests. Not exported\n * from the package. Nothing here is public API.\n */\n\nimport type { ScheduledEvent } from './scheduler-task.ts'\nimport type { DrainableServer } from './server.ts'\n\nexport type DrainOutcome = 'busy' | 'stalled' | 'settled'\n\n/**\n * A null-prototype record for maps keyed by caller-controlled strings\n * (participant ids, presence field names). On a normal object,\n * assigning to '__proto__' rewrites the prototype instead of creating\n * an own property — the prototype-pollution class. Null-prototype\n * objects still satisfy Record types and JSON.stringify cleanly.\n */\nexport function nullProtoRecord<T extends object>(): T {\n  return Object.create(null) as T\n}\n\n/**\n * ECMA-262's maximum Date value (±8.64e15 ms). A presence stamp past\n * it becomes an Invalid Date whose toISOString throws — one hostile\n * stamp would poison every subscriber's snapshot frame — so both\n * seams bound `at` to the representable range.\n */\nexport const MAX_DATE_MS = 8_640_000_000_000_000\n\n/**\n * Participant ids that collide with Object.prototype plumbing.\n * Null-prototype construction already defuses them, but they are\n * rejected at both seams (`parsePushBody`, `setPresence`) so a hostile\n * id never propagates into userland maps either.\n */\nexport const RESERVED_PARTICIPANT_IDS: ReadonlySet<string> = new Set([\n  '__proto__',\n  'constructor',\n  'prototype',\n])\n\nexport type DrainResult = {\n  settled: boolean\n  outcome: DrainOutcome\n  /** Existing successor arm a scheduler callback may join before acking. */\n  schedulerArm?: Promise<void>\n}\n\nexport type ServerInternals = {\n  /**\n   * Await every in-flight background drain this machine has scheduled,\n   * including ones scheduled while waiting. Lets tests flush the\n   * fire-and-forget inline path deterministically — no sleeps.\n   */\n  settle(): Promise<void>\n  /** The public `server.drain()` result deliberately remains `{ settled }`. */\n  schedulerDrain(\n    sessionId: string,\n    opts?: { watchdogDueAt?: number },\n  ): Promise<DrainResult>\n  /** Deliver a scheduler-owned delayed append through the normal root path. */\n  schedulerAppend(\n    sessionId: string,\n    events: readonly ScheduledEvent[],\n  ): Promise<void>\n}\n\nexport const serverInternals: WeakMap<object, ServerInternals> = new WeakMap()\n\nconst objectLike = (value: unknown): value is object =>\n  (typeof value === 'object' && value !== null) || typeof value === 'function'\n\n/** The ambient value delivered to `handlerContext` during a tool execution. */\nexport type AmbientToolScope = {\n  /** Executing server identity; a test scope from `runWithHandlerContext` has none. */\n  contract?: { readonly name: string }\n  context: unknown\n}\n\n/**\n * Structural AsyncLocalStorage surface for the ambient tool scope. The\n * instance is created by the server-only AI entry point (the only place\n * `node:async_hooks` may be imported) and shared through a global\n * symbol slot, so `handlerContext` in the isomorphic AI entry point and\n * independently bundled A2 copies all read the same scope.\n */\nexport type AmbientToolScopeStorage = {\n  getStore(): AmbientToolScope | undefined\n  run<R>(store: AmbientToolScope, callback: () => R): R\n}\n\nconst TOOL_SCOPE_STORAGE = Symbol.for('experimental-a2.ai.tool-scope')\n\nexport function ambientToolScopeStorage(): AmbientToolScopeStorage | undefined {\n  const value = Reflect.get(globalThis, TOOL_SCOPE_STORAGE)\n  if (\n    !objectLike(value) ||\n    typeof Reflect.get(value, 'getStore') !== 'function' ||\n    typeof Reflect.get(value, 'run') !== 'function'\n  ) {\n    return undefined\n  }\n  return value as AmbientToolScopeStorage\n}\n\nexport function installAmbientToolScopeStorage(\n  create: () => AmbientToolScopeStorage,\n): AmbientToolScopeStorage {\n  const existing = ambientToolScopeStorage()\n  if (existing !== undefined) return existing\n  const storage = create()\n  Reflect.set(globalThis, TOOL_SCOPE_STORAGE, storage)\n  return storage\n}\n\nexport type SchedulerSendFailureDisposition = 'retryable' | 'terminal'\n\ntype SchedulerSendFailureMarker = {\n  readonly version: 1\n  readonly pending: SchedulerSendFailureDisposition[]\n  readonly active: SchedulerSendFailureDisposition[]\n}\n\nconst SCHEDULER_SEND_FAILURE = Symbol.for(\n  'experimental-a2.scheduler.send-failure',\n)\n\nconst schedulerSendFailureMarker = (\n  value: unknown,\n): SchedulerSendFailureMarker | undefined => {\n  if (!objectLike(value)) return undefined\n  const marker = Reflect.get(value, SCHEDULER_SEND_FAILURE)\n  if (\n    !objectLike(marker) ||\n    Reflect.get(marker, 'version') !== 1 ||\n    !Array.isArray(Reflect.get(marker, 'pending')) ||\n    !Array.isArray(Reflect.get(marker, 'active'))\n  ) {\n    return undefined\n  }\n  return marker as SchedulerSendFailureMarker\n}\n\nconst schedulerFailureObject = (error: unknown): object => {\n  if (\n    objectLike(error) &&\n    (schedulerSendFailureMarker(error) !== undefined ||\n      Object.isExtensible(error))\n  ) {\n    return error\n  }\n  return new Error(String(error), { cause: error })\n}\n\nconst schedulerSendFailureState = (\n  error: object,\n): SchedulerSendFailureMarker => {\n  const existing = schedulerSendFailureMarker(error)\n  if (existing !== undefined) return existing\n  const marker: SchedulerSendFailureMarker = {\n    version: 1,\n    pending: [],\n    active: [],\n  }\n  Object.defineProperty(error, SCHEDULER_SEND_FAILURE, {\n    value: marker,\n    enumerable: false,\n    configurable: true,\n    writable: false,\n  })\n  return marker\n}\n\nconst clearSchedulerSendFailureState = (\n  error: object,\n  marker: SchedulerSendFailureMarker,\n): void => {\n  if (marker.pending.length === 0 && marker.active.length === 0) {\n    Reflect.deleteProperty(error, SCHEDULER_SEND_FAILURE)\n  }\n}\n\n/**\n * Classify an adapter error before throwing it. Unclassified adapter failures\n * are retryable because the caller cannot know whether a remote send landed.\n */\nexport function classifySchedulerSendFailure(\n  error: unknown,\n  disposition: SchedulerSendFailureDisposition,\n): unknown {\n  const classified = schedulerFailureObject(error)\n  schedulerSendFailureState(classified).pending.push(disposition)\n  return classified\n}\n\n/** Consume a pending adapter classification and count this rejected send. */\nexport function markSchedulerSendFailure(error: unknown): unknown {\n  const marked = schedulerFailureObject(error)\n  const marker = schedulerSendFailureState(marked)\n  marker.active.push(marker.pending.pop() ?? 'retryable')\n  return marked\n}\n\nexport function consumeSchedulerSendFailure(\n  error: unknown,\n): SchedulerSendFailureDisposition | undefined {\n  if (!objectLike(error)) return undefined\n  const marker = schedulerSendFailureMarker(error)\n  const disposition = marker?.active.pop()\n  if (marker !== undefined) clearSchedulerSendFailureState(error, marker)\n  return disposition\n}\n\nconst isDrainableServer = (value: unknown): value is DrainableServer => {\n  if (value === null || typeof value !== 'object') return false\n  const contract = Reflect.get(value, 'contract')\n  return (\n    contract !== null &&\n    typeof contract === 'object' &&\n    typeof Reflect.get(contract, 'name') === 'string' &&\n    typeof Reflect.get(value, 'drain') === 'function'\n  )\n}\n\n/**\n * Validate the server list captured by a scheduler route at construction time.\n * The seam stays structural so custom scheduler integrations can supply their\n * own drainable targets.\n */\nexport function assertSchedulerTargets(\n  servers: readonly unknown[],\n): asserts servers is readonly DrainableServer[] {\n  const contracts = new Set<string>()\n  for (const target of servers) {\n    if (!isDrainableServer(target)) {\n      throw new TypeError('a2 scheduler: expected a server from createServer()')\n    }\n    const name = target.contract.name\n    if (contracts.has(name)) {\n      throw new TypeError(\n        `a2 scheduler: duplicate server contract '${name}' in one handler`,\n      )\n    }\n    contracts.add(name)\n  }\n}\n\n/**\n * Drain timing knobs. Mutable only as a white-box test seam. Claim\n * heartbeats run on real timers, so tests shrink these to keep suites\n * fast. Production always uses the defaults.\n */\nexport const DRAIN_TIMINGS: {\n  /** How long a claim lives without renewal. */\n  claimTtlMs: number\n  /** Heartbeat cadence while a handler is running. */\n  claimHeartbeatMs: number\n  /** Base delay before retrying a failed renewal while the lease lives. */\n  renewRetryMs: number\n  /** Delay between a claim's expiry and its scheduler watchdog. */\n  watchdogGraceMs: number\n  /** Maximum time a top-level append waits for its initial scheduler arm. */\n  schedulerArmTimeoutMs: number\n} = {\n  claimTtlMs: 5_000,\n  claimHeartbeatMs: 2_000,\n  renewRetryMs: 400,\n  watchdogGraceMs: 1_000,\n  schedulerArmTimeoutMs: 2_000,\n}\n\n/**\n * Stream liveness knobs — the server-side SSE heartbeat and the\n * client-side stall watchdog. Paired by design: the client declares a\n * connection dead after roughly two missed heartbeats. Mutable only as\n * a white-box test seam; production always uses the defaults.\n */\n/**\n * Poll cadence for the poll-based store streams (sqlite, postgres) —\n * owned, not configurable: adaptive polling removed the operator's\n * reason to tune it (the floor keeps active streams smooth; the\n * ceiling bounds idle cost). Mutable only as a white-box test seam so\n * suites don't wait out real idle gaps.\n */\nexport const POLL_TIMINGS: {\n  /** Gap between polls while a session is producing events. */\n  activeFloorMs: number\n  /** The idle ceiling — the longest gap between polls. */\n  idleCeilingMs: number\n} = {\n  activeFloorMs: 25,\n  idleCeilingMs: 250,\n}\n\n/**\n * Safety-read cadence for the notify-driven redis live stream. A\n * parked feed re-reads the store at this interval even without a\n * pub/sub wake-up, so a lost notification (subscriber reconnect gap,\n * dropped PUBLISH) costs latency, never an event. Mutable only as a\n * white-box test seam.\n */\nexport const NOTIFY_TIMINGS: {\n  safetyReadMs: number\n} = {\n  safetyReadMs: 10_000,\n}\n\nexport const STREAM_TIMINGS: {\n  /** Cadence of `: ping` comment frames from `sseResponse`. */\n  sseHeartbeatMs: number\n  /** How far ahead of an invocation deadline an SSE response closes. */\n  sseDeadlineGraceMs: number\n  /** Client: silence longer than this means the connection is dead. */\n  stallTimeoutMs: number\n  /** Client reconnect backoff: first retry delay, doubling per attempt. */\n  reconnectBaseMs: number\n  /** Client reconnect backoff ceiling. */\n  reconnectMaxMs: number\n} = {\n  sseHeartbeatMs: 15_000,\n  sseDeadlineGraceMs: 1_000,\n  stallTimeoutMs: 35_000,\n  reconnectBaseMs: 500,\n  reconnectMaxMs: 5_000,\n}\n\n/**\n * WebSocket down-pump backpressure — `sessionsSocket` parks its pull\n * loop while the socket reports more buffered bytes than the\n * high-water mark and re-checks on the poll cadence, so a slow reader\n * applies backpressure to the store subscription instead of buffering\n * without bound in the socket. Acks and heartbeats stay exempt: they\n * are small and correctness-relevant. Mutable only as a white-box test\n * seam.\n */\nexport const SOCKET_TIMINGS: {\n  highWaterMarkBytes: number\n  resumePollMs: number\n  /** Up-lane bound: concurrent push/presence handlers per socket. POST\n   * gets per-request platform limits for free; the socket must bring\n   * its own. Over the cap, pushes are answered with a retryable error\n   * ack and presence frames are shed (that plane repaints). */\n  maxInFlightMessages: number\n  /** Hard ceiling on `bufferedAmount`: past it the peer is a\n   * non-reader (acks and pings are park-exempt, so only a peer that\n   * never reads can reach it) and the socket closes 1008. */\n  disconnectWaterMarkBytes: number\n} = {\n  highWaterMarkBytes: 1_048_576,\n  resumePollMs: 25,\n  maxInFlightMessages: 32,\n  disconnectWaterMarkBytes: 8_388_608,\n}\n\n/**\n * Client presence send cadence — a leading send immediately, then at\n * most one merged send per interval (~15Hz). Owned, not configurable\n * (decision #36's rule): coupling the cadence to the POST ack tied\n * remote cursor smoothness to RTT, and the ack serves no correctness\n * purpose on a fire-and-forget LWW plane. Mutable only as a white-box\n * test seam.\n */\nexport const PRESENCE_TIMINGS: {\n  sendIntervalMs: number\n} = {\n  sendIntervalMs: 66,\n}\n"],"mappings":"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"}

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { a as EventDefs, c as PresencePatch, d as WithPresence, o as PresenceDefs, p as Reducer, r as ContractEvent, s as PresenceMap, t as AppendInput } from "./contract-jIfaR085.js";
-import { a as Connection, c as HistoryState, l as LoadHistoryOptions, t as A2Client, u as PushResult } from "./client-CdMqi7mC.js";
+import { A2Client, Connection, HistoryState, LoadHistoryOptions, PushResult } from "./client.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-Dj5d3SP_.js";
+import { createClient } from "./client.js";
 import { createContext, createElement, useContext, useEffect, useMemo, useSyncExternalStore } from "react";
 //#region src/react.ts
 /**

package/dist/scheduler-qstash.d.ts

@@ -1,5 +1,5 @@
-import { i as Clock } from "./store-DysUkTH3.js";
-import { D as SchedulerTask, t as A2Scheduler } from "./server-DpvjhdoE.js";
+import { r as Clock } from "./store-flRz1OWh.js";
+import { t as A2Scheduler, w as SchedulerTask } from "./server-DgXmORIq.js";
 //#region src/scheduler-qstash.d.ts
 type QStashStoreOutage = {
   version: 1;
@@ -52,7 +52,7 @@ type QStashTransport = {
   verify(request: QStashVerifyRequest): Promise<boolean>;
 };
 type QStashSchedulerOptions = {
-  /** Exact URL mounted with `schedulerHandler(...)`. Inferred in local dev and on Vercel. */
+  /** Exact URL mounted with `scheduler.handler(...)`. Inferred in local dev and on Vercel. */
   url?: string;
   /** QStash API token. Default: `QSTASH_TOKEN`. */
   token?: string;

package/dist/scheduler-qstash.js

@@ -1,7 +1,6 @@
 import { t as A2Error } from "./errors-BQuJpe82.js";
-import { f as classifySchedulerSendFailure, t as DRAIN_TIMINGS, u as assertSchedulerTargets, v as serverInternals } from "./internal-DstsI6Re.js";
-import { n as deliverSchedulerAppend } from "./server-Duw6MVlB.js";
-import { n as platformVercelOidcToken } from "./platform-B4TnJtWu.js";
+import { d as classifySchedulerSendFailure, g as serverInternals, t as DRAIN_TIMINGS, u as assertSchedulerTargets } from "./internal-DRXJ56EI.js";
+import { i as platformVercelOidcToken, n as deliverSchedulerAppend } from "./server-286j79Mt.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";
@@ -424,7 +423,7 @@ function qstash(options = {}) {
 			await sendTask(task);
 		},
 		handler(...servers) {
-			assertSchedulerTargets(servers, { allowStructural: true });
+			assertSchedulerTargets(servers);
 			const byContract = /* @__PURE__ */ new Map();
 			for (const server of servers) byContract.set(server.contract.name, server);
 			return async (req) => {
@@ -448,7 +447,7 @@ function qstash(options = {}) {
 				if (!parsed) return response.malformed();
 				const { task, outage } = parsed;
 				const server = byContract.get(task.contract);
-				if (!server) throw new Error(`a2 scheduler: no server for contract '${task.contract}' — pass it to schedulerHandler(...)`);
+				if (!server) throw new Error(`a2 scheduler: no server for contract '${task.contract}' — pass it to scheduler.handler(...)`);
 				const internals = serverInternals.get(server);
 				if (task.kind === "append") {
 					try {