@absolutejs/sync 0.0.1 → 0.1.0

package/dist/client/index.js.map

@@ -1,10 +1,14 @@
 {
   "version": 3,
-  "sources": ["../../src/client/index.ts"],
+  "sources": ["../src/client/subscriber.ts", "../src/reactiveHub.ts", "../src/client/liveQuery.ts", "../src/client/syncCollection.ts", "../src/client/syncStore.ts"],
   "sourcesContent": [
-    "import type { ReactiveEvent } from '../reactiveHub';\n\nexport type { ReactiveEvent } from '../reactiveHub';\n\nexport type SyncSubscriberOptions = {\n\t/** Topics to subscribe to. A trailing `*` matches by prefix server-side. */\n\ttopics: string[];\n\t/** Called for every reactive event pushed from the server. */\n\tonEvent: (event: ReactiveEvent) => void;\n\t/** SSE endpoint mounted by the {@link sync} plugin. Defaults to `/sync`. */\n\turl?: string;\n\tonOpen?: () => void;\n\tonError?: (event: Event) => void;\n\t/** Send cookies with the SSE request (cross-origin auth). */\n\twithCredentials?: boolean;\n\t/**\n\t * EventSource implementation to use. Defaults to the global one; pass a polyfill\n\t * for non-browser runtimes.\n\t */\n\teventSourceImpl?: typeof EventSource;\n};\n\nexport type SyncSubscriber = {\n\tclose: () => void;\n\t/** The underlying EventSource, for advanced listeners. */\n\tsource: EventSource;\n};\n\n/**\n * Subscribe a browser to the server's {@link ReactiveHub} over SSE. `onEvent` fires\n * whenever a subscribed topic is published — the cue to refetch (or read the pushed\n * payload) instead of polling. EventSource reconnects automatically on transient\n * network drops.\n */\nexport const createSyncSubscriber = ({\n\ttopics,\n\tonEvent,\n\turl = '/sync',\n\tonOpen,\n\tonError,\n\twithCredentials,\n\teventSourceImpl\n}: SyncSubscriberOptions): SyncSubscriber => {\n\tconst Impl = eventSourceImpl ?? globalThis.EventSource;\n\tif (!Impl) {\n\t\tthrow new Error(\n\t\t\t'createSyncSubscriber requires EventSource. Run in a browser or pass eventSourceImpl.'\n\t\t);\n\t}\n\n\tconst params = new URLSearchParams({ topics: topics.join(',') });\n\tconst separator = url.includes('?') ? '&' : '?';\n\tconst source = new Impl(`${url}${separator}${params.toString()}`, {\n\t\twithCredentials: withCredentials ?? false\n\t});\n\n\tsource.onmessage = (event) => {\n\t\ttry {\n\t\t\tonEvent(JSON.parse(event.data) as ReactiveEvent);\n\t\t} catch {\n\t\t\t// ignore heartbeats / non-JSON frames\n\t\t}\n\t};\n\tif (onOpen) {\n\t\tsource.onopen = () => onOpen();\n\t}\n\tif (onError) {\n\t\tsource.onerror = (event) => onError(event);\n\t}\n\n\treturn {\n\t\tclose: () => source.close(),\n\t\tsource\n\t};\n};\n"
+    "import type { ReactiveEvent } from '../reactiveHub';\n\nexport type SyncSubscriberOptions = {\n\t/** Topics to subscribe to. A trailing `*` matches by prefix server-side. */\n\ttopics: string[];\n\t/** Called for every reactive event pushed from the server. */\n\tonEvent: (event: ReactiveEvent) => void;\n\t/** SSE endpoint mounted by the {@link sync} plugin. Defaults to `/sync`. */\n\turl?: string;\n\tonOpen?: () => void;\n\tonError?: (event: Event) => void;\n\t/** Send cookies with the SSE request (cross-origin auth). */\n\twithCredentials?: boolean;\n\t/**\n\t * EventSource implementation to use. Defaults to the global one; pass a polyfill\n\t * for non-browser runtimes.\n\t */\n\teventSourceImpl?: typeof EventSource;\n};\n\nexport type SyncSubscriber = {\n\tclose: () => void;\n\t/** The underlying EventSource, for advanced listeners. */\n\tsource: EventSource;\n};\n\n/**\n * Subscribe a browser to the server's {@link ReactiveHub} over SSE. `onEvent` fires\n * whenever a subscribed topic is published — the cue to refetch (or read the pushed\n * payload) instead of polling. EventSource reconnects automatically on transient\n * network drops.\n */\nexport const createSyncSubscriber = ({\n\ttopics,\n\tonEvent,\n\turl = '/sync',\n\tonOpen,\n\tonError,\n\twithCredentials,\n\teventSourceImpl\n}: SyncSubscriberOptions): SyncSubscriber => {\n\tconst Impl = eventSourceImpl ?? globalThis.EventSource;\n\tif (!Impl) {\n\t\tthrow new Error(\n\t\t\t'createSyncSubscriber requires EventSource. Run in a browser or pass eventSourceImpl.'\n\t\t);\n\t}\n\n\tconst params = new URLSearchParams({ topics: topics.join(',') });\n\tconst separator = url.includes('?') ? '&' : '?';\n\tconst source = new Impl(`${url}${separator}${params.toString()}`, {\n\t\twithCredentials: withCredentials ?? false\n\t});\n\n\tsource.onmessage = (event) => {\n\t\ttry {\n\t\t\tonEvent(JSON.parse(event.data) as ReactiveEvent);\n\t\t} catch {\n\t\t\t// ignore heartbeats / non-JSON frames\n\t\t}\n\t};\n\tif (onOpen) {\n\t\tsource.onopen = () => onOpen();\n\t}\n\tif (onError) {\n\t\tsource.onerror = (event) => onError(event);\n\t}\n\n\treturn {\n\t\tclose: () => source.close(),\n\t\tsource\n\t};\n};\n",
+    "/**\n * Topic of the synthetic frame the SSE plugin emits when a stream opens (and\n * re-opens after a reconnect). Clients use it to tell \"the stream connected\"\n * apart from a real data-change event.\n */\nexport const SYNC_OPEN_TOPIC = '@absolutejs/sync:open';\n\nexport type ReactiveEvent<TPayload = unknown> = {\n\ttopic: string;\n\tat: number;\n\tpayload?: TPayload;\n};\n\nexport type ReactiveListener<TPayload = unknown> = (\n\tevent: ReactiveEvent<TPayload>\n) => void;\n\nexport type ReactiveHub = {\n\t/**\n\t * Notify every subscriber of `topic` (and any prefix-wildcard subscriber that\n\t * matches it). Call this from a mutation after the durable write commits.\n\t */\n\tpublish: (topic: string, payload?: unknown) => void;\n\t/**\n\t * Listen on one or more topics. A topic ending in `*` matches every topic that\n\t * starts with the prefix before it (e.g. `voice:session:*`). Returns an\n\t * unsubscribe function.\n\t */\n\tsubscribe: (topics: string[], listener: ReactiveListener) => () => void;\n\t/** Number of active subscribers, optionally for a single exact topic. */\n\tsubscriberCount: (topic?: string) => number;\n};\n\ntype Subscription = {\n\texact: Set<string>;\n\tprefixes: string[];\n\tlistener: ReactiveListener;\n};\n\n/**\n * An in-memory topic pub/sub for reactive, push-on-change updates.\n *\n * The pattern that replaces polling: a query/widget subscribes to the topics its\n * data depends on; a mutation `publish`es those topics after it writes; subscribers\n * are notified immediately and refetch (or receive the pushed payload) — instead of\n * every client hammering the server on a timer.\n *\n * Dependencies are explicit (you name the topics) rather than auto-tracked from a\n * query's read set — deliberately small, with no sandbox or query interception.\n * Pair it with the {@link sync} Elysia plugin to stream events to browsers over SSE.\n */\nexport const createReactiveHub = (): ReactiveHub => {\n\tconst subscriptions = new Set<Subscription>();\n\n\tconst matches = (subscription: Subscription, topic: string) => {\n\t\tif (subscription.exact.has(topic)) {\n\t\t\treturn true;\n\t\t}\n\t\treturn subscription.prefixes.some((prefix) => topic.startsWith(prefix));\n\t};\n\n\treturn {\n\t\tpublish: (topic, payload) => {\n\t\t\tconst event: ReactiveEvent = { topic, at: Date.now(), payload };\n\t\t\tfor (const subscription of subscriptions) {\n\t\t\t\tif (matches(subscription, topic)) {\n\t\t\t\t\tsubscription.listener(event);\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\tsubscribe: (topics, listener) => {\n\t\t\tconst exact = new Set<string>();\n\t\t\tconst prefixes: string[] = [];\n\t\t\tfor (const topic of topics) {\n\t\t\t\tif (topic.endsWith('*')) {\n\t\t\t\t\tprefixes.push(topic.slice(0, -1));\n\t\t\t\t} else {\n\t\t\t\t\texact.add(topic);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst subscription: Subscription = { exact, prefixes, listener };\n\t\t\tsubscriptions.add(subscription);\n\t\t\treturn () => {\n\t\t\t\tsubscriptions.delete(subscription);\n\t\t\t};\n\t\t},\n\t\tsubscriberCount: (topic) => {\n\t\t\tif (topic === undefined) {\n\t\t\t\treturn subscriptions.size;\n\t\t\t}\n\t\t\tlet count = 0;\n\t\t\tfor (const subscription of subscriptions) {\n\t\t\t\tif (matches(subscription, topic)) {\n\t\t\t\t\tcount += 1;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn count;\n\t\t}\n\t};\n};\n",
+    "import { SYNC_OPEN_TOPIC } from '../reactiveHub';\nimport type { ReactiveEvent } from '../reactiveHub';\nimport { createSyncSubscriber } from './subscriber';\n\nexport type LiveQueryState<T> = {\n\t/** Latest query result, or `undefined` before the first successful fetch. */\n\tdata: T | undefined;\n\t/** Error from the most recent fetch, or `undefined` if it succeeded. */\n\terror: unknown;\n\t/** `true` until the first result arrives (no data yet). */\n\tloading: boolean;\n\t/** `true` while a (re)fetch is in flight — data may still be present. */\n\tfetching: boolean;\n};\n\nexport type LiveQueryOptions<T> = {\n\t/**\n\t * Topics this query depends on — typically the server's\n\t * `deriveReadTopics(...).topics`. Any event on one of them triggers a\n\t * refetch. A trailing `*` matches by prefix server-side.\n\t */\n\ttopics: string[];\n\t/**\n\t * Runs the read and resolves the query result. Receives an `AbortSignal`\n\t * that fires when a newer fetch supersedes this one or the query is closed.\n\t */\n\tfetcher: (signal: AbortSignal) => Promise<T>;\n\t/** SSE endpoint mounted by the {@link sync} plugin. Defaults to `/sync`. */\n\turl?: string;\n\t/** Send cookies with the SSE request (cross-origin auth). */\n\twithCredentials?: boolean;\n\t/** EventSource implementation; defaults to the global one. */\n\teventSourceImpl?: typeof EventSource;\n\t/**\n\t * Seed data (e.g. from SSR). When provided, the initial fetch is skipped —\n\t * the query trusts this until an event or a manual {@link LiveQuery.refetch}.\n\t */\n\tinitialData?: T;\n\t/**\n\t * Skip the initial fetch and stay idle until the first event or a manual\n\t * refetch. Reconnects still re-hydrate.\n\t */\n\tmanual?: boolean;\n\t/**\n\t * Coalesce a burst of events into one refetch within this window (ms).\n\t * Defaults to 0 — refetch once per event.\n\t */\n\tdebounceMs?: number;\n\t/** Called when a fetch rejects (stale data is retained). */\n\tonError?: (error: unknown) => void;\n};\n\nexport type LiveQuery<T> = {\n\t/** Current state snapshot (stable reference until the next change). */\n\tget: () => LiveQueryState<T>;\n\t/** Subscribe to state changes; returns an unsubscribe. */\n\tsubscribe: (listener: (state: LiveQueryState<T>) => void) => () => void;\n\t/** Force a refetch now. Resolves when this fetch settles. */\n\trefetch: () => Promise<void>;\n\t/** Stop the SSE subscription, cancel any in-flight fetch, drop listeners. */\n\tclose: () => void;\n};\n\n/**\n * A live, self-refreshing query: hydrate once via `fetcher`, then refetch\n * whenever the server publishes one of `topics` — the read half of Tier 2,\n * built on {@link createSyncSubscriber}. Framework-agnostic: `get` + `subscribe`\n * plug straight into React's `useSyncExternalStore` or any equivalent.\n *\n * Pair it with the Drizzle adapter's `deriveReadTopics` (server) and\n * `publishChange`/`publishWhere` (mutations) so a write invalidates exactly the\n * queries that read the changed rows.\n */\nexport const createLiveQuery = <T>(\n\toptions: LiveQueryOptions<T>\n): LiveQuery<T> => {\n\tconst hasSeed = options.initialData !== undefined;\n\tlet state: LiveQueryState<T> = {\n\t\tdata: options.initialData,\n\t\terror: undefined,\n\t\tloading: !options.manual && !hasSeed,\n\t\tfetching: false\n\t};\n\n\tconst listeners = new Set<(state: LiveQueryState<T>) => void>();\n\tconst setState = (patch: Partial<LiveQueryState<T>>) => {\n\t\tstate = { ...state, ...patch };\n\t\tfor (const listener of listeners) {\n\t\t\tlistener(state);\n\t\t}\n\t};\n\n\tlet requestSeq = 0;\n\tlet inFlight: AbortController | undefined;\n\tlet closed = false;\n\n\tconst refetch = async () => {\n\t\tif (closed) {\n\t\t\treturn;\n\t\t}\n\t\tconst seq = (requestSeq += 1);\n\t\tinFlight?.abort();\n\t\tconst controller = new AbortController();\n\t\tinFlight = controller;\n\t\tsetState({ fetching: true });\n\n\t\ttry {\n\t\t\tconst data = await options.fetcher(controller.signal);\n\t\t\tif (seq !== requestSeq) {\n\t\t\t\treturn; // superseded by a newer fetch\n\t\t\t}\n\t\t\tsetState({\n\t\t\t\tdata,\n\t\t\t\terror: undefined,\n\t\t\t\tloading: false,\n\t\t\t\tfetching: false\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (controller.signal.aborted || seq !== requestSeq) {\n\t\t\t\treturn; // aborted or superseded — leave state to the winner\n\t\t\t}\n\t\t\tsetState({ error, loading: false, fetching: false });\n\t\t\toptions.onError?.(error);\n\t\t} finally {\n\t\t\tif (inFlight === controller) {\n\t\t\t\tinFlight = undefined;\n\t\t\t}\n\t\t}\n\t};\n\n\tlet debounceTimer: ReturnType<typeof setTimeout> | undefined;\n\tconst scheduleRefetch = () => {\n\t\tif (closed) {\n\t\t\treturn;\n\t\t}\n\t\tif (!options.debounceMs) {\n\t\t\tvoid refetch();\n\t\t\treturn;\n\t\t}\n\t\tif (debounceTimer !== undefined) {\n\t\t\treturn; // a refetch is already queued for this window\n\t\t}\n\t\tdebounceTimer = setTimeout(() => {\n\t\t\tdebounceTimer = undefined;\n\t\t\tvoid refetch();\n\t\t}, options.debounceMs);\n\t};\n\n\tlet opened = false;\n\tconst onEvent = (event: ReactiveEvent) => {\n\t\tif (event.topic === SYNC_OPEN_TOPIC) {\n\t\t\t// First open is the initial connect (already hydrated); a later open\n\t\t\t// is a reconnect, so re-hydrate to catch events missed while down.\n\t\t\tif (opened) {\n\t\t\t\tscheduleRefetch();\n\t\t\t}\n\t\t\topened = true;\n\t\t\treturn;\n\t\t}\n\t\tscheduleRefetch();\n\t};\n\n\tconst subscriber = createSyncSubscriber({\n\t\ttopics: options.topics,\n\t\tonEvent,\n\t\turl: options.url,\n\t\twithCredentials: options.withCredentials,\n\t\teventSourceImpl: options.eventSourceImpl\n\t});\n\n\tif (!options.manual && !hasSeed) {\n\t\tvoid refetch();\n\t}\n\n\tconst close = () => {\n\t\tif (closed) {\n\t\t\treturn;\n\t\t}\n\t\tclosed = true;\n\t\tsubscriber.close();\n\t\tinFlight?.abort();\n\t\tif (debounceTimer !== undefined) {\n\t\t\tclearTimeout(debounceTimer);\n\t\t\tdebounceTimer = undefined;\n\t\t}\n\t\tlisteners.clear();\n\t};\n\n\treturn {\n\t\tget: () => state,\n\t\tsubscribe: (listener) => {\n\t\t\tlisteners.add(listener);\n\t\t\treturn () => {\n\t\t\t\tlisteners.delete(listener);\n\t\t\t};\n\t\t},\n\t\trefetch,\n\t\tclose\n\t};\n};\n\n/**\n * A small default `fetcher`: GET `url` and parse JSON. Forwards the live query's\n * abort signal and throws on a non-2xx response.\n *\n * @example\n * createLiveQuery({ topics, fetcher: jsonFetcher<User[]>('/api/users') })\n */\nexport const jsonFetcher =\n\t<T>(url: string, init?: RequestInit) =>\n\tasync (signal: AbortSignal): Promise<T> => {\n\t\tconst response = await fetch(url, { ...init, signal });\n\t\tif (!response.ok) {\n\t\t\tthrow new Error(`${response.status} ${response.statusText}`);\n\t\t}\n\t\treturn (await response.json()) as T;\n\t};\n",
+    "import type { ServerFrame } from '../engine/connection';\nimport type { RowKey } from '../engine/types';\n\nexport type { ServerFrame } from '../engine/connection';\n\nexport type SyncCollectionStatus = 'connecting' | 'ready' | 'closed';\n\nexport type SyncCollectionState<T> = {\n\t/** Visible rows: the server state with pending optimistic mutations applied. */\n\tdata: T[];\n\t/** Connection/sync status. */\n\tstatus: SyncCollectionStatus;\n\t/** Last error message from the server, or `undefined`. */\n\terror: unknown;\n};\n\n/** A working set a mutation's optimistic effect edits in place. */\nexport type OptimisticDraft<T> = {\n\t/** Insert or replace a row by key. */\n\tset: (row: T) => void;\n\t/** Remove a row by key. */\n\tdelete: (key: RowKey) => void;\n};\n\nexport type MutateOptions<T> = {\n\t/** Registered server mutation name. */\n\tname: string;\n\t/** Arguments forwarded to the mutation handler. */\n\targs?: unknown;\n\t/**\n\t * Apply this mutation's effect to the local set immediately for instant UI.\n\t * Reverted automatically if the server rejects it. Omit for a non-optimistic\n\t * mutation (UI updates only once the authoritative diff arrives).\n\t */\n\toptimistic?: (draft: OptimisticDraft<T>) => void;\n};\n\n/** A pending mutation persisted for replay across reloads. */\nexport type PendingMutationRecord = {\n\tmutationId: number;\n\tname: string;\n\targs: unknown;\n};\n\n/**\n * Durable storage for the pending-mutation queue, so unconfirmed mutations\n * survive a page reload (offline). The queue is replayed when the socket\n * connects; records are dropped as they're acked.\n */\nexport type MutationStorage = {\n\tload: () => PendingMutationRecord[] | Promise<PendingMutationRecord[]>;\n\tsave: (records: PendingMutationRecord[]) => void | Promise<void>;\n};\n\n/**\n * A {@link MutationStorage} backed by `localStorage` under `key`. No-ops where\n * `localStorage` is unavailable (e.g. SSR).\n */\nexport const localStorageMutationStorage = (key: string): MutationStorage => ({\n\tload: () => {\n\t\tconst raw = globalThis.localStorage?.getItem(key);\n\t\treturn raw ? (JSON.parse(raw) as PendingMutationRecord[]) : [];\n\t},\n\tsave: (records) => {\n\t\tglobalThis.localStorage?.setItem(key, JSON.stringify(records));\n\t}\n});\n\nexport type SyncCollectionOptions<T> = {\n\t/** WebSocket URL of the {@link syncSocket} endpoint (e.g. `ws://host/sync/ws`). */\n\turl: string;\n\t/** Registered collection name to subscribe to. */\n\tcollection: string;\n\t/** Query params forwarded to the server collection's hydrate/match/authorize. */\n\tparams?: unknown;\n\t/** Row identity, used to apply diffs and optimistic edits. Defaults to `row.id`. */\n\tkey?: (row: T) => RowKey;\n\t/** WebSocket implementation; defaults to the global one (pass for tests/SSR). */\n\twebSocketImpl?: typeof WebSocket;\n\t/**\n\t * Base reconnect delay (ms), doubled each attempt up to `maxReconnectMs`.\n\t * Set 0 to disable auto-reconnect. Defaults to 500.\n\t */\n\treconnectMs?: number;\n\t/** Maximum reconnect backoff (ms). Defaults to 10000. */\n\tmaxReconnectMs?: number;\n\t/**\n\t * Persist the pending-mutation queue so it survives a reload (offline) and\n\t * replays on connect. See {@link localStorageMutationStorage}.\n\t */\n\tstorage?: MutationStorage;\n\t/** Called with each server error message. */\n\tonError?: (error: unknown) => void;\n};\n\nexport type SyncCollection<T> = {\n\t/** Current state snapshot (stable reference until the next change). */\n\tget: () => SyncCollectionState<T>;\n\t/** Subscribe to state changes; returns an unsubscribe. */\n\tsubscribe: (\n\t\tlistener: (state: SyncCollectionState<T>) => void\n\t) => () => void;\n\t/**\n\t * Run a server mutation, optionally applying it optimistically. Resolves with\n\t * the server's result on ack, rejects (and rolls back) on reject. Pending\n\t * mutations are replayed when the socket reconnects, so they survive a drop.\n\t */\n\tmutate: <R = unknown>(options: MutateOptions<T>) => Promise<R>;\n\t/** Unsubscribe on the server, close the socket, and stop reconnecting. */\n\tclose: () => void;\n};\n\n// One store subscribes to exactly one collection, so a fixed frame id suffices.\nconst SUBSCRIPTION_ID = 's';\n\ntype PendingMutation<T> = {\n\tmutationId: number;\n\tname: string;\n\targs: unknown;\n\toptimistic?: (draft: OptimisticDraft<T>) => void;\n\tresolve: (result: unknown) => void;\n\treject: (error: unknown) => void;\n};\n\n/**\n * A live collection backed by the WebSocket sync engine. Reads: connect,\n * subscribe, apply the server's snapshot then row-level diffs, re-sync on\n * reconnect. Writes: {@link SyncCollection.mutate} applies an optimistic overlay\n * immediately, sends the mutation, and reconciles on ack (drop the overlay — the\n * authoritative diff already arrived) or reject (roll back). Framework-agnostic\n * (`get` + `subscribe`).\n *\n * Mutations are replayed on reconnect, so make server mutations idempotent —\n * delivery is at-least-once if an ack is lost across a drop.\n */\nexport const createSyncCollection = <T>(\n\toptions: SyncCollectionOptions<T>\n): SyncCollection<T> => {\n\tconst key = options.key ?? ((row: T) => (row as { id: RowKey }).id);\n\tconst reconnectMs = options.reconnectMs ?? 500;\n\tconst maxReconnectMs = options.maxReconnectMs ?? 10_000;\n\tconst Impl = options.webSocketImpl ?? globalThis.WebSocket;\n\tif (!Impl) {\n\t\tthrow new Error(\n\t\t\t'createSyncCollection requires WebSocket. Run in a browser or pass webSocketImpl.'\n\t\t);\n\t}\n\n\t// Server-authoritative rows; `pending` is the optimistic overlay on top.\n\tconst confirmed = new Map<RowKey, T>();\n\tconst pending: PendingMutation<T>[] = [];\n\tlet mutationSeq = 0;\n\n\tlet state: SyncCollectionState<T> = {\n\t\tdata: [],\n\t\tstatus: 'connecting',\n\t\terror: undefined\n\t};\n\tconst listeners = new Set<(state: SyncCollectionState<T>) => void>();\n\tconst setState = (patch: Partial<SyncCollectionState<T>>) => {\n\t\tstate = { ...state, ...patch };\n\t\tfor (const listener of listeners) {\n\t\t\tlistener(state);\n\t\t}\n\t};\n\n\t/** Recompute visible rows = confirmed + pending optimistic effects. */\n\tconst recompute = (patch: Partial<SyncCollectionState<T>> = {}) => {\n\t\tconst working = new Map(confirmed);\n\t\tconst draft: OptimisticDraft<T> = {\n\t\t\tset: (row) => working.set(key(row), row),\n\t\t\tdelete: (rowKey) => working.delete(rowKey)\n\t\t};\n\t\tfor (const mutation of pending) {\n\t\t\tmutation.optimistic?.(draft);\n\t\t}\n\t\tsetState({ ...patch, data: [...working.values()] });\n\t};\n\n\tlet socket: WebSocket | undefined;\n\tlet connected = false;\n\tlet closed = false;\n\tlet attempt = 0;\n\tlet reconnectTimer: ReturnType<typeof setTimeout> | undefined;\n\t// Highest change-feed version applied; sent as `since` to resume on reconnect.\n\tlet appliedVersion = 0;\n\n\tconst persist = () => {\n\t\tvoid options.storage?.save(\n\t\t\tpending.map((mutation) => ({\n\t\t\t\tmutationId: mutation.mutationId,\n\t\t\t\tname: mutation.name,\n\t\t\t\targs: mutation.args\n\t\t\t}))\n\t\t);\n\t};\n\n\tconst settlePending = (mutationId: number) => {\n\t\tconst index = pending.findIndex(\n\t\t\t(mutation) => mutation.mutationId === mutationId\n\t\t);\n\t\tif (index === -1) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst [mutation] = pending.splice(index, 1);\n\t\tpersist();\n\t\treturn mutation;\n\t};\n\n\tconst applyFrame = (frame: ServerFrame<T>) => {\n\t\tif (frame.type === 'snapshot') {\n\t\t\tconfirmed.clear();\n\t\t\tfor (const row of frame.rows) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\tif (frame.version !== undefined) {\n\t\t\t\tappliedVersion = frame.version;\n\t\t\t}\n\t\t\trecompute({ status: 'ready', error: undefined });\n\t\t} else if (frame.type === 'diff') {\n\t\t\tfor (const row of frame.removed) {\n\t\t\t\tconfirmed.delete(key(row));\n\t\t\t}\n\t\t\tfor (const row of frame.added) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\tfor (const row of frame.changed) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\tif (frame.version !== undefined) {\n\t\t\t\tappliedVersion = Math.max(appliedVersion, frame.version);\n\t\t\t}\n\t\t\trecompute();\n\t\t} else if (frame.type === 'error') {\n\t\t\tsetState({ error: frame.message });\n\t\t\toptions.onError?.(frame.message);\n\t\t} else if (frame.type === 'ack') {\n\t\t\t// The authoritative diff already arrived (ordered before the ack), so\n\t\t\t// dropping the overlay leaves the confirmed row in place — no flicker.\n\t\t\tconst mutation = settlePending(frame.mutationId);\n\t\t\tif (mutation !== undefined) {\n\t\t\t\trecompute();\n\t\t\t\tmutation.resolve(frame.result);\n\t\t\t}\n\t\t} else {\n\t\t\t// reject — roll the optimistic overlay back.\n\t\t\tconst mutation = settlePending(frame.mutationId);\n\t\t\tif (mutation !== undefined) {\n\t\t\t\trecompute();\n\t\t\t\tmutation.reject(new Error(String(frame.message)));\n\t\t\t}\n\t\t}\n\t};\n\n\tconst sendMutate = (mutation: PendingMutation<T>) => {\n\t\tif (connected) {\n\t\t\tsocket?.send(\n\t\t\t\tJSON.stringify({\n\t\t\t\t\ttype: 'mutate',\n\t\t\t\t\tmutationId: mutation.mutationId,\n\t\t\t\t\tname: mutation.name,\n\t\t\t\t\targs: mutation.args\n\t\t\t\t})\n\t\t\t);\n\t\t}\n\t};\n\n\tconst connect = () => {\n\t\tif (closed) {\n\t\t\treturn;\n\t\t}\n\t\tsetState({ status: 'connecting' });\n\t\tconst ws = new Impl(options.url);\n\t\tsocket = ws;\n\t\tws.onopen = () => {\n\t\t\tattempt = 0;\n\t\t\tconnected = true;\n\t\t\tws.send(\n\t\t\t\tJSON.stringify({\n\t\t\t\t\ttype: 'subscribe',\n\t\t\t\t\tid: SUBSCRIPTION_ID,\n\t\t\t\t\tcollection: options.collection,\n\t\t\t\t\tparams: options.params,\n\t\t\t\t\t// Resume from what we've applied (catch-up instead of snapshot).\n\t\t\t\t\tsince: appliedVersion > 0 ? appliedVersion : undefined\n\t\t\t\t})\n\t\t\t);\n\t\t\t// Replay anything still pending across the (re)connect.\n\t\t\tfor (const mutation of pending) {\n\t\t\t\tsendMutate(mutation);\n\t\t\t}\n\t\t};\n\t\tws.onmessage = (event) => {\n\t\t\ttry {\n\t\t\t\tapplyFrame(JSON.parse(event.data as string) as ServerFrame<T>);\n\t\t\t} catch {\n\t\t\t\t// ignore non-JSON frames\n\t\t\t}\n\t\t};\n\t\tws.onclose = () => {\n\t\t\tconnected = false;\n\t\t\tif (closed || reconnectMs <= 0) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst delay = Math.min(reconnectMs * 2 ** attempt, maxReconnectMs);\n\t\t\tattempt += 1;\n\t\t\treconnectTimer = setTimeout(connect, delay);\n\t\t};\n\t};\n\n\tconnect();\n\n\t// Reload recovery: re-queue persisted unconfirmed mutations and replay them.\n\t// They carry no optimistic effect or promise (the fresh snapshot is\n\t// authoritative); resending produces the server diffs that bring them in.\n\tconst hydratePersisted = async () => {\n\t\tif (options.storage === undefined) {\n\t\t\treturn;\n\t\t}\n\t\tconst records = await options.storage.load();\n\t\tfor (const record of records) {\n\t\t\tif (pending.some((m) => m.mutationId === record.mutationId)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tpending.push({\n\t\t\t\tmutationId: record.mutationId,\n\t\t\t\tname: record.name,\n\t\t\t\targs: record.args,\n\t\t\t\tresolve: () => {},\n\t\t\t\treject: () => {}\n\t\t\t});\n\t\t\tmutationSeq = Math.max(mutationSeq, record.mutationId);\n\t\t}\n\t\tif (connected) {\n\t\t\tfor (const mutation of pending) {\n\t\t\t\tsendMutate(mutation);\n\t\t\t}\n\t\t}\n\t};\n\tvoid hydratePersisted();\n\n\treturn {\n\t\tget: () => state,\n\t\tsubscribe: (listener) => {\n\t\t\tlisteners.add(listener);\n\t\t\treturn () => {\n\t\t\t\tlisteners.delete(listener);\n\t\t\t};\n\t\t},\n\t\tmutate: <R = unknown>(mutateOptions: MutateOptions<T>) =>\n\t\t\tnew Promise<R>((resolve, reject) => {\n\t\t\t\tconst mutation: PendingMutation<T> = {\n\t\t\t\t\tmutationId: (mutationSeq += 1),\n\t\t\t\t\tname: mutateOptions.name,\n\t\t\t\t\targs: mutateOptions.args,\n\t\t\t\t\toptimistic: mutateOptions.optimistic,\n\t\t\t\t\tresolve: (result) => resolve(result as R),\n\t\t\t\t\treject\n\t\t\t\t};\n\t\t\t\tpending.push(mutation);\n\t\t\t\tpersist();\n\t\t\t\trecompute(); // apply the optimistic overlay immediately\n\t\t\t\tsendMutate(mutation);\n\t\t\t}),\n\t\tclose: () => {\n\t\t\tif (closed) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tclosed = true;\n\t\t\tconnected = false;\n\t\t\tif (reconnectTimer !== undefined) {\n\t\t\t\tclearTimeout(reconnectTimer);\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tsocket?.send(\n\t\t\t\t\tJSON.stringify({ type: 'unsubscribe', id: SUBSCRIPTION_ID })\n\t\t\t\t);\n\t\t\t\tsocket?.close();\n\t\t\t} catch {\n\t\t\t\t// socket already closing/closed\n\t\t\t}\n\t\t\t// Fail any still-pending mutations so their promises don't hang.\n\t\t\tfor (const mutation of pending.splice(0)) {\n\t\t\t\tmutation.reject(new Error('sync collection closed'));\n\t\t\t}\n\t\t\tpersist();\n\t\t\tsetState({ status: 'closed' });\n\t\t\tlisteners.clear();\n\t\t}\n\t};\n};\n",
+    "import type { ServerFrame } from '../engine/connection';\nimport type { RowKey } from '../engine/types';\nimport type { MutationStorage, PendingMutationRecord } from './syncCollection';\n\nexport type SyncStoreStatus = 'connecting' | 'ready' | 'closed';\n\nexport type SyncStoreState<Row> = {\n\t/** Visible rows: confirmed server state with pending optimistic edits applied. */\n\tdata: Row[];\n\tstatus: SyncStoreStatus;\n\terror: unknown;\n};\n\n/** A working set a mutation's optimistic effect edits in place. */\nexport type OptimisticDraft<Row> = {\n\tset: (row: Row) => void;\n\tdelete: (key: RowKey) => void;\n};\n\n/** A map of named server mutations — typically Eden calls. */\nexport type MutationMap = Record<string, (args: never) => Promise<unknown>>;\n\nexport type MutateOptions<Row> = {\n\t/** Apply the mutation's effect locally for instant UI (rolled back on reject). */\n\toptimistic?: (draft: OptimisticDraft<Row>) => void;\n};\n\nexport type SyncStoreOptions<Row, M extends MutationMap> = {\n\t/** WebSocket URL of the {@link syncSocket} endpoint. */\n\turl: string;\n\t/** Collection name to subscribe to for diffs. */\n\tcollection: string;\n\t/** Query params forwarded to the server collection. */\n\tparams?: unknown;\n\t/**\n\t * Typed read — typically an Eden call (`() => unwrapEden(api.sync.orders.get(...))`).\n\t * It is the source of the `Row` **type**, gives an eager first paint, and is\n\t * reusable for SSR. Live confirmed state then comes from the WS snapshot.\n\t */\n\thydrate?: () => Promise<Row[]>;\n\t/** Seed rows (e.g. from SSR); shown immediately, refreshed by the WS snapshot. */\n\tinitialData?: Row[];\n\t/** Typed server mutations (Eden calls). Enables `store.mutate(name, args, ...)`. */\n\tmutations?: M;\n\t/** Row identity. Defaults to `row.id`. */\n\tkey?: (row: Row) => RowKey;\n\twebSocketImpl?: typeof WebSocket;\n\treconnectMs?: number;\n\tmaxReconnectMs?: number;\n\t/**\n\t * After the server confirms a mutation, drop its optimistic overlay this long\n\t * after if no diff has reflected it (covers mutations that don't touch this\n\t * collection). Defaults to 3000.\n\t */\n\treconcileGraceMs?: number;\n\t/** Persist the pending-mutation queue across reloads (offline). */\n\tstorage?: MutationStorage;\n\tonError?: (error: unknown) => void;\n};\n\nexport type SyncStore<Row, M extends MutationMap> = {\n\tget: () => SyncStoreState<Row>;\n\tsubscribe: (listener: (state: SyncStoreState<Row>) => void) => () => void;\n\t/**\n\t * Run a named server mutation, optionally applying it optimistically. Resolves\n\t * with the server's result; rolls back and rejects if the server rejects it.\n\t * While offline (socket down) it stays queued and retries on reconnect.\n\t */\n\tmutate: <K extends keyof M>(\n\t\tname: K,\n\t\targs: Parameters<M[K]>[0],\n\t\toptions?: MutateOptions<Row>\n\t) => Promise<Awaited<ReturnType<M[K]>>>;\n\t/** Re-run `hydrate` and refresh confirmed state. */\n\trefetch: () => Promise<void>;\n\tclose: () => void;\n};\n\nconst SUBSCRIPTION_ID = 's';\n\ntype Pending<Row> = {\n\tid: number;\n\tname: string;\n\targs: unknown;\n\t/** Keys this mutation's optimistic effect touched, and how. */\n\ttouched: Map<RowKey, 'set' | 'delete'>;\n\toptimistic?: (draft: OptimisticDraft<Row>) => void;\n\tsettled: boolean;\n\tinFlight: boolean;\n\tresolve: (value: unknown) => void;\n\treject: (error: unknown) => void;\n\tgraceTimer?: ReturnType<typeof setTimeout>;\n};\n\n/**\n * A generic, Eden-fed live collection store (the typed Tier 3 client). Confirmed\n * state is maintained from the WS snapshot + diffs; mutations run over your typed\n * transport (Eden), apply an optimistic overlay, and reconcile against the diffs.\n * Types come entirely from the `hydrate`/`mutations` you pass — no `<T>`.\n */\nexport const syncStore = <Row, M extends MutationMap = MutationMap>(\n\toptions: SyncStoreOptions<Row, M>\n): SyncStore<Row, M> => {\n\tconst key = options.key ?? ((row: Row) => (row as { id: RowKey }).id);\n\tconst reconnectMs = options.reconnectMs ?? 500;\n\tconst maxReconnectMs = options.maxReconnectMs ?? 10_000;\n\tconst reconcileGraceMs = options.reconcileGraceMs ?? 3000;\n\tconst mutations = options.mutations ?? ({} as M);\n\tconst Impl = options.webSocketImpl ?? globalThis.WebSocket;\n\tif (!Impl) {\n\t\tthrow new Error(\n\t\t\t'syncStore requires WebSocket. Run in a browser or pass webSocketImpl.'\n\t\t);\n\t}\n\n\tconst confirmed = new Map<RowKey, Row>();\n\tconst pending: Pending<Row>[] = [];\n\tlet mutationSeq = 0;\n\n\tlet state: SyncStoreState<Row> = {\n\t\tdata: options.initialData ? [...options.initialData] : [],\n\t\tstatus: 'connecting',\n\t\terror: undefined\n\t};\n\tif (options.initialData) {\n\t\tfor (const row of options.initialData) {\n\t\t\tconfirmed.set(key(row), row);\n\t\t}\n\t}\n\n\tconst listeners = new Set<(state: SyncStoreState<Row>) => void>();\n\tconst setState = (patch: Partial<SyncStoreState<Row>>) => {\n\t\tstate = { ...state, ...patch };\n\t\tfor (const listener of listeners) {\n\t\t\tlistener(state);\n\t\t}\n\t};\n\tconst recompute = (patch: Partial<SyncStoreState<Row>> = {}) => {\n\t\tconst working = new Map(confirmed);\n\t\tconst draft: OptimisticDraft<Row> = {\n\t\t\tset: (row) => working.set(key(row), row),\n\t\t\tdelete: (rowKey) => working.delete(rowKey)\n\t\t};\n\t\tfor (const mutation of pending) {\n\t\t\tmutation.optimistic?.(draft);\n\t\t}\n\t\tsetState({ ...patch, data: [...working.values()] });\n\t};\n\n\tconst persist = () => {\n\t\tvoid options.storage?.save(\n\t\t\tpending.map((mutation) => ({\n\t\t\t\tmutationId: mutation.id,\n\t\t\t\tname: mutation.name,\n\t\t\t\targs: mutation.args\n\t\t\t}))\n\t\t);\n\t};\n\n\tconst dropPending = (mutation: Pending<Row>) => {\n\t\tconst index = pending.indexOf(mutation);\n\t\tif (index !== -1) {\n\t\t\tpending.splice(index, 1);\n\t\t}\n\t\tif (mutation.graceTimer !== undefined) {\n\t\t\tclearTimeout(mutation.graceTimer);\n\t\t}\n\t};\n\n\t/** Drop settled overlays whose touched keys are now reflected in confirmed. */\n\tconst reconcileSettled = () => {\n\t\tlet changed = false;\n\t\tfor (const mutation of [...pending]) {\n\t\t\tif (!mutation.settled) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tlet reflected = true;\n\t\t\tfor (const [rowKey, kind] of mutation.touched) {\n\t\t\t\tconst present = confirmed.has(rowKey);\n\t\t\t\tif (kind === 'set' ? !present : present) {\n\t\t\t\t\treflected = false;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (reflected) {\n\t\t\t\tdropPending(mutation);\n\t\t\t\tchanged = true;\n\t\t\t}\n\t\t}\n\t\tif (changed) {\n\t\t\trecompute();\n\t\t}\n\t};\n\n\tlet socket: WebSocket | undefined;\n\tlet connected = false;\n\tlet closed = false;\n\tlet attempt = 0;\n\tlet reconnectTimer: ReturnType<typeof setTimeout> | undefined;\n\t// Highest change-feed version applied; sent as `since` to resume on reconnect.\n\tlet appliedVersion = 0;\n\n\tconst applyFrame = (frame: ServerFrame<Row>) => {\n\t\tif (frame.type === 'snapshot') {\n\t\t\tconfirmed.clear();\n\t\t\tfor (const row of frame.rows) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\tif (frame.version !== undefined) {\n\t\t\t\tappliedVersion = frame.version;\n\t\t\t}\n\t\t\trecompute({ status: 'ready', error: undefined });\n\t\t\treconcileSettled();\n\t\t} else if (frame.type === 'diff') {\n\t\t\tfor (const row of frame.removed) {\n\t\t\t\tconfirmed.delete(key(row));\n\t\t\t}\n\t\t\tfor (const row of frame.added) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\tfor (const row of frame.changed) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\tif (frame.version !== undefined) {\n\t\t\t\tappliedVersion = Math.max(appliedVersion, frame.version);\n\t\t\t}\n\t\t\trecompute();\n\t\t\treconcileSettled();\n\t\t} else if (frame.type === 'error') {\n\t\t\tsetState({ error: frame.message });\n\t\t\toptions.onError?.(frame.message);\n\t\t}\n\t\t// ack/reject frames are unused here — mutations run over the typed transport.\n\t};\n\n\tconst runMutation = async (mutation: Pending<Row>) => {\n\t\tif (mutation.inFlight || mutation.settled) {\n\t\t\treturn;\n\t\t}\n\t\tconst run = mutations[mutation.name];\n\t\tif (run === undefined) {\n\t\t\tdropPending(mutation);\n\t\t\trecompute();\n\t\t\tmutation.reject(new Error(`Unknown mutation \"${mutation.name}\"`));\n\t\t\treturn;\n\t\t}\n\t\tmutation.inFlight = true;\n\t\ttry {\n\t\t\tconst result = await (run as (args: unknown) => Promise<unknown>)(\n\t\t\t\tmutation.args\n\t\t\t);\n\t\t\tmutation.inFlight = false;\n\t\t\tmutation.settled = true;\n\t\t\tmutation.resolve(result);\n\t\t\tpersist();\n\t\t\treconcileSettled();\n\t\t\t// If the diff hasn't reflected it yet, drop the overlay after a grace.\n\t\t\tif (pending.includes(mutation)) {\n\t\t\t\tmutation.graceTimer = setTimeout(() => {\n\t\t\t\t\tdropPending(mutation);\n\t\t\t\t\trecompute();\n\t\t\t\t}, reconcileGraceMs);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tmutation.inFlight = false;\n\t\t\tif (connected) {\n\t\t\t\t// Server is reachable → a real rejection: roll back.\n\t\t\t\tdropPending(mutation);\n\t\t\t\trecompute();\n\t\t\t\tpersist();\n\t\t\t\tmutation.reject(error);\n\t\t\t} else {\n\t\t\t\t// Offline → keep queued; retry on reconnect.\n\t\t\t\toptions.onError?.(error);\n\t\t\t}\n\t\t}\n\t};\n\n\tconst connect = () => {\n\t\tif (closed) {\n\t\t\treturn;\n\t\t}\n\t\tsetState({ status: 'connecting' });\n\t\tconst ws = new Impl(options.url);\n\t\tsocket = ws;\n\t\tws.onopen = () => {\n\t\t\tattempt = 0;\n\t\t\tconnected = true;\n\t\t\tws.send(\n\t\t\t\tJSON.stringify({\n\t\t\t\t\ttype: 'subscribe',\n\t\t\t\t\tid: SUBSCRIPTION_ID,\n\t\t\t\t\tcollection: options.collection,\n\t\t\t\t\tparams: options.params,\n\t\t\t\t\t// Resume from what we've applied (catch-up instead of snapshot).\n\t\t\t\t\tsince: appliedVersion > 0 ? appliedVersion : undefined\n\t\t\t\t})\n\t\t\t);\n\t\t\t// Retry mutations that failed/queued while offline.\n\t\t\tfor (const mutation of pending) {\n\t\t\t\tif (!mutation.settled && !mutation.inFlight) {\n\t\t\t\t\tvoid runMutation(mutation);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\t\tws.onmessage = (event) => {\n\t\t\ttry {\n\t\t\t\tapplyFrame(\n\t\t\t\t\tJSON.parse(event.data as string) as ServerFrame<Row>\n\t\t\t\t);\n\t\t\t} catch {\n\t\t\t\t// ignore non-JSON frames\n\t\t\t}\n\t\t};\n\t\tws.onclose = () => {\n\t\t\tconnected = false;\n\t\t\tif (closed || reconnectMs <= 0) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst delay = Math.min(reconnectMs * 2 ** attempt, maxReconnectMs);\n\t\t\tattempt += 1;\n\t\t\treconnectTimer = setTimeout(connect, delay);\n\t\t};\n\t};\n\n\tconst eagerHydrate = async () => {\n\t\tif (\n\t\t\toptions.hydrate === undefined ||\n\t\t\toptions.initialData !== undefined\n\t\t) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst rows = await options.hydrate();\n\t\t\t// Don't clobber a WS snapshot that already arrived.\n\t\t\tif (state.status !== 'ready') {\n\t\t\t\tconfirmed.clear();\n\t\t\t\tfor (const row of rows) {\n\t\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t\t}\n\t\t\t\trecompute({ status: 'ready' });\n\t\t\t}\n\t\t} catch (error) {\n\t\t\toptions.onError?.(error);\n\t\t}\n\t};\n\n\tconst hydratePersisted = async () => {\n\t\tif (options.storage === undefined) {\n\t\t\treturn;\n\t\t}\n\t\tconst records = await options.storage.load();\n\t\tfor (const record of records as PendingMutationRecord[]) {\n\t\t\tif (pending.some((m) => m.id === record.mutationId)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tpending.push({\n\t\t\t\tid: record.mutationId,\n\t\t\t\tname: record.name,\n\t\t\t\targs: record.args,\n\t\t\t\ttouched: new Map(),\n\t\t\t\tsettled: false,\n\t\t\t\tinFlight: false,\n\t\t\t\tresolve: () => {},\n\t\t\t\treject: () => {}\n\t\t\t});\n\t\t\tmutationSeq = Math.max(mutationSeq, record.mutationId);\n\t\t}\n\t\tif (connected) {\n\t\t\tfor (const mutation of pending) {\n\t\t\t\tvoid runMutation(mutation);\n\t\t\t}\n\t\t}\n\t};\n\n\tconnect();\n\tvoid eagerHydrate();\n\tvoid hydratePersisted();\n\n\tconst collectTouched = (\n\t\toptimistic?: (draft: OptimisticDraft<Row>) => void\n\t) => {\n\t\tconst touched = new Map<RowKey, 'set' | 'delete'>();\n\t\toptimistic?.({\n\t\t\tset: (row) => touched.set(key(row), 'set'),\n\t\t\tdelete: (rowKey) => touched.set(rowKey, 'delete')\n\t\t});\n\t\treturn touched;\n\t};\n\n\treturn {\n\t\tget: () => state,\n\t\tsubscribe: (listener) => {\n\t\t\tlisteners.add(listener);\n\t\t\treturn () => {\n\t\t\t\tlisteners.delete(listener);\n\t\t\t};\n\t\t},\n\t\tmutate: ((name, args, mutateOptions) =>\n\t\t\tnew Promise((resolve, reject) => {\n\t\t\t\tconst mutation: Pending<Row> = {\n\t\t\t\t\tid: (mutationSeq += 1),\n\t\t\t\t\tname: name as string,\n\t\t\t\t\targs,\n\t\t\t\t\ttouched: collectTouched(mutateOptions?.optimistic),\n\t\t\t\t\toptimistic: mutateOptions?.optimistic,\n\t\t\t\t\tsettled: false,\n\t\t\t\t\tinFlight: false,\n\t\t\t\t\tresolve: resolve as (value: unknown) => void,\n\t\t\t\t\treject\n\t\t\t\t};\n\t\t\t\tpending.push(mutation);\n\t\t\t\tpersist();\n\t\t\t\trecompute();\n\t\t\t\tvoid runMutation(mutation);\n\t\t\t})) as SyncStore<Row, M>['mutate'],\n\t\trefetch: async () => {\n\t\t\tif (options.hydrate === undefined) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst rows = await options.hydrate();\n\t\t\tconfirmed.clear();\n\t\t\tfor (const row of rows) {\n\t\t\t\tconfirmed.set(key(row), row);\n\t\t\t}\n\t\t\trecompute({ status: 'ready' });\n\t\t},\n\t\tclose: () => {\n\t\t\tif (closed) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tclosed = true;\n\t\t\tconnected = false;\n\t\t\tif (reconnectTimer !== undefined) {\n\t\t\t\tclearTimeout(reconnectTimer);\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tsocket?.send(\n\t\t\t\t\tJSON.stringify({ type: 'unsubscribe', id: SUBSCRIPTION_ID })\n\t\t\t\t);\n\t\t\t\tsocket?.close();\n\t\t\t} catch {\n\t\t\t\t// already closing\n\t\t\t}\n\t\t\tfor (const mutation of pending.splice(0)) {\n\t\t\t\tif (mutation.graceTimer !== undefined) {\n\t\t\t\t\tclearTimeout(mutation.graceTimer);\n\t\t\t\t}\n\t\t\t\tmutation.reject(new Error('sync store closed'));\n\t\t\t}\n\t\t\tpersist();\n\t\t\tsetState({ status: 'closed' });\n\t\t\tlisteners.clear();\n\t\t}\n\t};\n};\n\n/**\n * Unwrap an Eden treaty response (`{ data, error }`) to its data, throwing the\n * error. Use it to feed Eden calls to {@link syncStore}'s `hydrate`/`mutations`:\n * `hydrate: () => unwrapEden(api.sync.orders.get({ query }))`.\n */\nexport const unwrapEden = async <T>(\n\tresponse: Promise<{ data: T | null; error?: unknown }>\n): Promise<T> => {\n\tconst { data, error } = await response;\n\tif (error !== null && error !== undefined) {\n\t\tthrow error;\n\t}\n\treturn data as T;\n};\n"
   ],
-  "mappings": ";AAkCO,IAAM,uBAAuB;AAAA,EACnC;AAAA,EACA;AAAA,EACA,MAAM;AAAA,EACN;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,MAC4C;AAAA,EAC5C,MAAM,OAAO,mBAAmB,WAAW;AAAA,EAC3C,IAAI,CAAC,MAAM;AAAA,IACV,MAAM,IAAI,MACT,sFACD;AAAA,EACD;AAAA,EAEA,MAAM,SAAS,IAAI,gBAAgB,EAAE,QAAQ,OAAO,KAAK,GAAG,EAAE,CAAC;AAAA,EAC/D,MAAM,YAAY,IAAI,SAAS,GAAG,IAAI,MAAM;AAAA,EAC5C,MAAM,SAAS,IAAI,KAAK,GAAG,MAAM,YAAY,OAAO,SAAS,KAAK;AAAA,IACjE,iBAAiB,mBAAmB;AAAA,EACrC,CAAC;AAAA,EAED,OAAO,YAAY,CAAC,UAAU;AAAA,IAC7B,IAAI;AAAA,MACH,QAAQ,KAAK,MAAM,MAAM,IAAI,CAAkB;AAAA,MAC9C,MAAM;AAAA;AAAA,EAIT,IAAI,QAAQ;AAAA,IACX,OAAO,SAAS,MAAM,OAAO;AAAA,EAC9B;AAAA,EACA,IAAI,SAAS;AAAA,IACZ,OAAO,UAAU,CAAC,UAAU,QAAQ,KAAK;AAAA,EAC1C;AAAA,EAEA,OAAO;AAAA,IACN,OAAO,MAAM,OAAO,MAAM;AAAA,IAC1B;AAAA,EACD;AAAA;",
-  "debugId": "10D2496AED02ED9364756E2164756E21",
+  "mappings": "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",
+  "debugId": "5E158140B740DFD964756E2164756E21",
   "names": []
 }

package/dist/client/liveQuery.d.ts

@@ -0,0 +1,75 @@
+export type LiveQueryState<T> = {
+    /** Latest query result, or `undefined` before the first successful fetch. */
+    data: T | undefined;
+    /** Error from the most recent fetch, or `undefined` if it succeeded. */
+    error: unknown;
+    /** `true` until the first result arrives (no data yet). */
+    loading: boolean;
+    /** `true` while a (re)fetch is in flight — data may still be present. */
+    fetching: boolean;
+};
+export type LiveQueryOptions<T> = {
+    /**
+     * Topics this query depends on — typically the server's
+     * `deriveReadTopics(...).topics`. Any event on one of them triggers a
+     * refetch. A trailing `*` matches by prefix server-side.
+     */
+    topics: string[];
+    /**
+     * Runs the read and resolves the query result. Receives an `AbortSignal`
+     * that fires when a newer fetch supersedes this one or the query is closed.
+     */
+    fetcher: (signal: AbortSignal) => Promise<T>;
+    /** SSE endpoint mounted by the {@link sync} plugin. Defaults to `/sync`. */
+    url?: string;
+    /** Send cookies with the SSE request (cross-origin auth). */
+    withCredentials?: boolean;
+    /** EventSource implementation; defaults to the global one. */
+    eventSourceImpl?: typeof EventSource;
+    /**
+     * Seed data (e.g. from SSR). When provided, the initial fetch is skipped —
+     * the query trusts this until an event or a manual {@link LiveQuery.refetch}.
+     */
+    initialData?: T;
+    /**
+     * Skip the initial fetch and stay idle until the first event or a manual
+     * refetch. Reconnects still re-hydrate.
+     */
+    manual?: boolean;
+    /**
+     * Coalesce a burst of events into one refetch within this window (ms).
+     * Defaults to 0 — refetch once per event.
+     */
+    debounceMs?: number;
+    /** Called when a fetch rejects (stale data is retained). */
+    onError?: (error: unknown) => void;
+};
+export type LiveQuery<T> = {
+    /** Current state snapshot (stable reference until the next change). */
+    get: () => LiveQueryState<T>;
+    /** Subscribe to state changes; returns an unsubscribe. */
+    subscribe: (listener: (state: LiveQueryState<T>) => void) => () => void;
+    /** Force a refetch now. Resolves when this fetch settles. */
+    refetch: () => Promise<void>;
+    /** Stop the SSE subscription, cancel any in-flight fetch, drop listeners. */
+    close: () => void;
+};
+/**
+ * A live, self-refreshing query: hydrate once via `fetcher`, then refetch
+ * whenever the server publishes one of `topics` — the read half of Tier 2,
+ * built on {@link createSyncSubscriber}. Framework-agnostic: `get` + `subscribe`
+ * plug straight into React's `useSyncExternalStore` or any equivalent.
+ *
+ * Pair it with the Drizzle adapter's `deriveReadTopics` (server) and
+ * `publishChange`/`publishWhere` (mutations) so a write invalidates exactly the
+ * queries that read the changed rows.
+ */
+export declare const createLiveQuery: <T>(options: LiveQueryOptions<T>) => LiveQuery<T>;
+/**
+ * A small default `fetcher`: GET `url` and parse JSON. Forwards the live query's
+ * abort signal and throws on a non-2xx response.
+ *
+ * @example
+ * createLiveQuery({ topics, fetcher: jsonFetcher<User[]>('/api/users') })
+ */
+export declare const jsonFetcher: <T>(url: string, init?: RequestInit) => (signal: AbortSignal) => Promise<T>;

package/dist/client/subscriber.d.ts

@@ -0,0 +1,30 @@
+import type { ReactiveEvent } from '../reactiveHub';
+export type SyncSubscriberOptions = {
+    /** Topics to subscribe to. A trailing `*` matches by prefix server-side. */
+    topics: string[];
+    /** Called for every reactive event pushed from the server. */
+    onEvent: (event: ReactiveEvent) => void;
+    /** SSE endpoint mounted by the {@link sync} plugin. Defaults to `/sync`. */
+    url?: string;
+    onOpen?: () => void;
+    onError?: (event: Event) => void;
+    /** Send cookies with the SSE request (cross-origin auth). */
+    withCredentials?: boolean;
+    /**
+     * EventSource implementation to use. Defaults to the global one; pass a polyfill
+     * for non-browser runtimes.
+     */
+    eventSourceImpl?: typeof EventSource;
+};
+export type SyncSubscriber = {
+    close: () => void;
+    /** The underlying EventSource, for advanced listeners. */
+    source: EventSource;
+};
+/**
+ * Subscribe a browser to the server's {@link ReactiveHub} over SSE. `onEvent` fires
+ * whenever a subscribed topic is published — the cue to refetch (or read the pushed
+ * payload) instead of polling. EventSource reconnects automatically on transient
+ * network drops.
+ */
+export declare const createSyncSubscriber: ({ topics, onEvent, url, onOpen, onError, withCredentials, eventSourceImpl }: SyncSubscriberOptions) => SyncSubscriber;

package/dist/client/syncCollection.d.ts

@@ -0,0 +1,102 @@
+import type { RowKey } from '../engine/types';
+export type { ServerFrame } from '../engine/connection';
+export type SyncCollectionStatus = 'connecting' | 'ready' | 'closed';
+export type SyncCollectionState<T> = {
+    /** Visible rows: the server state with pending optimistic mutations applied. */
+    data: T[];
+    /** Connection/sync status. */
+    status: SyncCollectionStatus;
+    /** Last error message from the server, or `undefined`. */
+    error: unknown;
+};
+/** A working set a mutation's optimistic effect edits in place. */
+export type OptimisticDraft<T> = {
+    /** Insert or replace a row by key. */
+    set: (row: T) => void;
+    /** Remove a row by key. */
+    delete: (key: RowKey) => void;
+};
+export type MutateOptions<T> = {
+    /** Registered server mutation name. */
+    name: string;
+    /** Arguments forwarded to the mutation handler. */
+    args?: unknown;
+    /**
+     * Apply this mutation's effect to the local set immediately for instant UI.
+     * Reverted automatically if the server rejects it. Omit for a non-optimistic
+     * mutation (UI updates only once the authoritative diff arrives).
+     */
+    optimistic?: (draft: OptimisticDraft<T>) => void;
+};
+/** A pending mutation persisted for replay across reloads. */
+export type PendingMutationRecord = {
+    mutationId: number;
+    name: string;
+    args: unknown;
+};
+/**
+ * Durable storage for the pending-mutation queue, so unconfirmed mutations
+ * survive a page reload (offline). The queue is replayed when the socket
+ * connects; records are dropped as they're acked.
+ */
+export type MutationStorage = {
+    load: () => PendingMutationRecord[] | Promise<PendingMutationRecord[]>;
+    save: (records: PendingMutationRecord[]) => void | Promise<void>;
+};
+/**
+ * A {@link MutationStorage} backed by `localStorage` under `key`. No-ops where
+ * `localStorage` is unavailable (e.g. SSR).
+ */
+export declare const localStorageMutationStorage: (key: string) => MutationStorage;
+export type SyncCollectionOptions<T> = {
+    /** WebSocket URL of the {@link syncSocket} endpoint (e.g. `ws://host/sync/ws`). */
+    url: string;
+    /** Registered collection name to subscribe to. */
+    collection: string;
+    /** Query params forwarded to the server collection's hydrate/match/authorize. */
+    params?: unknown;
+    /** Row identity, used to apply diffs and optimistic edits. Defaults to `row.id`. */
+    key?: (row: T) => RowKey;
+    /** WebSocket implementation; defaults to the global one (pass for tests/SSR). */
+    webSocketImpl?: typeof WebSocket;
+    /**
+     * Base reconnect delay (ms), doubled each attempt up to `maxReconnectMs`.
+     * Set 0 to disable auto-reconnect. Defaults to 500.
+     */
+    reconnectMs?: number;
+    /** Maximum reconnect backoff (ms). Defaults to 10000. */
+    maxReconnectMs?: number;
+    /**
+     * Persist the pending-mutation queue so it survives a reload (offline) and
+     * replays on connect. See {@link localStorageMutationStorage}.
+     */
+    storage?: MutationStorage;
+    /** Called with each server error message. */
+    onError?: (error: unknown) => void;
+};
+export type SyncCollection<T> = {
+    /** Current state snapshot (stable reference until the next change). */
+    get: () => SyncCollectionState<T>;
+    /** Subscribe to state changes; returns an unsubscribe. */
+    subscribe: (listener: (state: SyncCollectionState<T>) => void) => () => void;
+    /**
+     * Run a server mutation, optionally applying it optimistically. Resolves with
+     * the server's result on ack, rejects (and rolls back) on reject. Pending
+     * mutations are replayed when the socket reconnects, so they survive a drop.
+     */
+    mutate: <R = unknown>(options: MutateOptions<T>) => Promise<R>;
+    /** Unsubscribe on the server, close the socket, and stop reconnecting. */
+    close: () => void;
+};
+/**
+ * A live collection backed by the WebSocket sync engine. Reads: connect,
+ * subscribe, apply the server's snapshot then row-level diffs, re-sync on
+ * reconnect. Writes: {@link SyncCollection.mutate} applies an optimistic overlay
+ * immediately, sends the mutation, and reconciles on ack (drop the overlay — the
+ * authoritative diff already arrived) or reject (roll back). Framework-agnostic
+ * (`get` + `subscribe`).
+ *
+ * Mutations are replayed on reconnect, so make server mutations idempotent —
+ * delivery is at-least-once if an ack is lost across a drop.
+ */
+export declare const createSyncCollection: <T>(options: SyncCollectionOptions<T>) => SyncCollection<T>;

package/dist/client/syncStore.d.ts

@@ -0,0 +1,81 @@
+import type { RowKey } from '../engine/types';
+import type { MutationStorage } from './syncCollection';
+export type SyncStoreStatus = 'connecting' | 'ready' | 'closed';
+export type SyncStoreState<Row> = {
+    /** Visible rows: confirmed server state with pending optimistic edits applied. */
+    data: Row[];
+    status: SyncStoreStatus;
+    error: unknown;
+};
+/** A working set a mutation's optimistic effect edits in place. */
+export type OptimisticDraft<Row> = {
+    set: (row: Row) => void;
+    delete: (key: RowKey) => void;
+};
+/** A map of named server mutations — typically Eden calls. */
+export type MutationMap = Record<string, (args: never) => Promise<unknown>>;
+export type MutateOptions<Row> = {
+    /** Apply the mutation's effect locally for instant UI (rolled back on reject). */
+    optimistic?: (draft: OptimisticDraft<Row>) => void;
+};
+export type SyncStoreOptions<Row, M extends MutationMap> = {
+    /** WebSocket URL of the {@link syncSocket} endpoint. */
+    url: string;
+    /** Collection name to subscribe to for diffs. */
+    collection: string;
+    /** Query params forwarded to the server collection. */
+    params?: unknown;
+    /**
+     * Typed read — typically an Eden call (`() => unwrapEden(api.sync.orders.get(...))`).
+     * It is the source of the `Row` **type**, gives an eager first paint, and is
+     * reusable for SSR. Live confirmed state then comes from the WS snapshot.
+     */
+    hydrate?: () => Promise<Row[]>;
+    /** Seed rows (e.g. from SSR); shown immediately, refreshed by the WS snapshot. */
+    initialData?: Row[];
+    /** Typed server mutations (Eden calls). Enables `store.mutate(name, args, ...)`. */
+    mutations?: M;
+    /** Row identity. Defaults to `row.id`. */
+    key?: (row: Row) => RowKey;
+    webSocketImpl?: typeof WebSocket;
+    reconnectMs?: number;
+    maxReconnectMs?: number;
+    /**
+     * After the server confirms a mutation, drop its optimistic overlay this long
+     * after if no diff has reflected it (covers mutations that don't touch this
+     * collection). Defaults to 3000.
+     */
+    reconcileGraceMs?: number;
+    /** Persist the pending-mutation queue across reloads (offline). */
+    storage?: MutationStorage;
+    onError?: (error: unknown) => void;
+};
+export type SyncStore<Row, M extends MutationMap> = {
+    get: () => SyncStoreState<Row>;
+    subscribe: (listener: (state: SyncStoreState<Row>) => void) => () => void;
+    /**
+     * Run a named server mutation, optionally applying it optimistically. Resolves
+     * with the server's result; rolls back and rejects if the server rejects it.
+     * While offline (socket down) it stays queued and retries on reconnect.
+     */
+    mutate: <K extends keyof M>(name: K, args: Parameters<M[K]>[0], options?: MutateOptions<Row>) => Promise<Awaited<ReturnType<M[K]>>>;
+    /** Re-run `hydrate` and refresh confirmed state. */
+    refetch: () => Promise<void>;
+    close: () => void;
+};
+/**
+ * A generic, Eden-fed live collection store (the typed Tier 3 client). Confirmed
+ * state is maintained from the WS snapshot + diffs; mutations run over your typed
+ * transport (Eden), apply an optimistic overlay, and reconcile against the diffs.
+ * Types come entirely from the `hydrate`/`mutations` you pass — no `<T>`.
+ */
+export declare const syncStore: <Row, M extends MutationMap = MutationMap>(options: SyncStoreOptions<Row, M>) => SyncStore<Row, M>;
+/**
+ * Unwrap an Eden treaty response (`{ data, error }`) to its data, throwing the
+ * error. Use it to feed Eden calls to {@link syncStore}'s `hydrate`/`mutations`:
+ * `hydrate: () => unwrapEden(api.sync.orders.get({ query }))`.
+ */
+export declare const unwrapEden: <T>(response: Promise<{
+    data: T | null;
+    error?: unknown;
+}>) => Promise<T>;

package/dist/engine/aggregate.d.ts

@@ -0,0 +1,45 @@
+import type { RowChange, RowKey } from './types';
+export type AggregateOptions<T> = {
+    /** Row identity — used to track each row's contribution across updates. */
+    key: (row: T) => RowKey;
+    /** Group rows by this key. Omit to aggregate everything into one group (`''`). */
+    groupBy?: (row: T) => RowKey;
+    /**
+     * Numeric value to aggregate for `sum`/`avg`/`min`/`max`. Omit for a
+     * count-only aggregate (sum stays 0, min/max stay undefined).
+     */
+    value?: (row: T) => number;
+};
+/** Maintained summary for one group. */
+export type AggregateGroup = {
+    group: RowKey;
+    count: number;
+    sum: number;
+    /** `sum / count`, or 0 when the group is empty. */
+    avg: number;
+    min: number | undefined;
+    max: number | undefined;
+};
+export type Aggregate<T> = {
+    /** Bulk-load the initial rows (replaces current state). */
+    hydrate: (rows: Iterable<T>) => void;
+    /** Fold one row change into the running aggregates. */
+    apply: (change: RowChange<T>) => void;
+    /** Current summary for every non-empty group. */
+    groups: () => AggregateGroup[];
+    /** Current summary for one group, or `undefined` if empty. */
+    group: (group: RowKey) => AggregateGroup | undefined;
+};
+/**
+ * An incrementally-maintained aggregation — the DD-lite for `count`/`sum`/`avg`/
+ * `min`/`max`, optionally grouped. Feed it the change feed (insert/update/delete)
+ * and it updates each group's summary in place: count/sum/avg are O(1); min/max
+ * use a value multiset so removing the current extremum recomputes correctly
+ * (O(distinct values) only when the extremum leaves).
+ *
+ * Per-row contributions are tracked by `key`, so updates (including a row moving
+ * between groups) and deletes adjust the right group without re-scanning. Use it
+ * server-side over the engine's change feed, or client-side over collection
+ * diffs.
+ */
+export declare const createAggregate: <T>(options: AggregateOptions<T>) => Aggregate<T>;

package/dist/engine/collection.d.ts

@@ -0,0 +1,87 @@
+import type { RowKey } from './types';
+/**
+ * App-provided context for a subscription — typically the authenticated session
+ * (user id, roles). Passed to `authorize`, `hydrate`, and `match` so a
+ * collection can scope its rows to the caller.
+ */
+export type CollectionContext = Record<string, unknown>;
+export type CollectionDefinition<T, P = void, Ctx = CollectionContext> = {
+    /** Collection name — its identity for subscribe (e.g. `orders`). */
+    name: string;
+    /**
+     * Source tables this collection reads. A committed change to any of them
+     * updates the collection. Defaults to `[name]`. List several for a join /
+     * aggregate collection — which uses the refetch fallback, since a single
+     * table's row can't be matched into a multi-table result.
+     */
+    tables?: string[];
+    /**
+     * Fetch the initial result set from your database (any ORM). Receives the
+     * subscription's params and context so it can filter to the caller.
+     */
+    hydrate: (params: P, ctx: Ctx) => Promise<Iterable<T>> | Iterable<T>;
+    /** Row identity. Defaults to `row.id`. */
+    key?: (row: T) => RowKey;
+    /**
+     * The query's filter as a JS predicate, for incremental matching. Omit to use
+     * the refetch fallback (re-hydrate on every change to the collection).
+     *
+     * It MUST encode the same row filter as `hydrate`/`authorize`: a change that
+     * the predicate accepts is pushed to the subscriber, so a too-loose predicate
+     * leaks rows. (Deriving `match` from the same filter as `hydrate` keeps the
+     * two in lockstep — the planned adapter convenience.)
+     */
+    match?: (row: T, params: P, ctx: Ctx) => boolean;
+    /**
+     * Access control: return `false` (or throw) to deny the subscription. Runs
+     * before `hydrate`. Without it a collection is world-readable, so treat it as
+     * mandatory for any non-public data.
+     */
+    authorize?: (params: P, ctx: Ctx) => boolean | Promise<boolean>;
+};
+/**
+ * Define a syncable collection. Identity at runtime — it exists for type
+ * inference, so `params`/`ctx`/row types flow through `hydrate`/`match`/
+ * `authorize` without restating them. Register it with a {@link SyncEngine}.
+ */
+export declare const defineCollection: <T, P = void, Ctx = CollectionContext>(definition: CollectionDefinition<T, P, Ctx>) => CollectionDefinition<T, P, Ctx>;
+/** One input of a join collection. */
+export type JoinSide<Row, P, Ctx> = {
+    /** Source table name (the change feed routes its changes to this side). */
+    table: string;
+    /** Fetch this side's rows for the subscription (scoped to the caller). */
+    hydrate: (params: P, ctx: Ctx) => Promise<Iterable<Row>> | Iterable<Row>;
+    /** Row identity within this side. */
+    key: (row: Row) => RowKey;
+    /** Join value — matched for equality against the other side's `on`. */
+    on: (row: Row) => RowKey;
+    /**
+     * Access/predicate filter for incremental changes on this side. A changed row
+     * that fails it is treated as a leave (removed from the join), so a row that
+     * becomes invisible drops out. Omit only for an unscoped side.
+     */
+    match?: (row: Row, params: P, ctx: Ctx) => boolean;
+};
+/**
+ * A collection that is the incremental inner equi-join of two tables. The engine
+ * maintains it with an {@link createEquiJoin} operator — a change to either side
+ * moves only the affected pairs, instead of re-hydrating the whole join.
+ */
+export type JoinCollectionDefinition<L, R, Out, P = void, Ctx = CollectionContext> = {
+    name: string;
+    kind: 'join';
+    left: JoinSide<L, P, Ctx>;
+    right: JoinSide<R, P, Ctx>;
+    /** Combine a matched pair into an output row. */
+    select: (left: L, right: R) => Out;
+    /** Output row identity (must be unique per emitted row). */
+    key: (out: Out) => RowKey;
+    /** Access control; return false (or throw) to deny the subscription. */
+    authorize?: (params: P, ctx: Ctx) => boolean | Promise<boolean>;
+};
+/**
+ * Define an incremental equi-join collection (see {@link JoinCollectionDefinition}).
+ * For a many-to-one join the output can key by the left id; for many-to-many,
+ * include both ids in the output and key on the pair.
+ */
+export declare const defineJoinCollection: <L, R, Out, P = void, Ctx = CollectionContext>(definition: Omit<JoinCollectionDefinition<L, R, Out, P, Ctx>, "kind">) => JoinCollectionDefinition<L, R, Out, P, Ctx>;

package/dist/engine/connection.d.ts

@@ -0,0 +1,71 @@
+import type { SyncEngine } from './syncEngine';
+/**
+ * Wire protocol for the sync-engine WebSocket. One connection multiplexes many
+ * collection subscriptions, each tagged with a client-chosen `id`.
+ */
+/** Client → server. */
+export type ClientFrame = {
+    type: 'subscribe';
+    id: string;
+    collection: string;
+    params?: unknown;
+    /** Resume from a version already applied (catch-up instead of snapshot). */
+    since?: number;
+} | {
+    type: 'unsubscribe';
+    id: string;
+} | {
+    type: 'mutate';
+    mutationId: number;
+    name: string;
+    args?: unknown;
+};
+/** Server → client. `version` is the change-feed watermark this frame brings. */
+export type ServerFrame<T = unknown> = {
+    type: 'snapshot';
+    id: string;
+    rows: T[];
+    version?: number;
+} | {
+    type: 'diff';
+    id: string;
+    added: T[];
+    removed: T[];
+    changed: T[];
+    version?: number;
+} | {
+    type: 'error';
+    id?: string;
+    message: string;
+} | {
+    type: 'ack';
+    mutationId: number;
+    result?: unknown;
+} | {
+    type: 'reject';
+    mutationId: number;
+    message: string;
+};
+export type SyncConnectionOptions = {
+    engine: SyncEngine;
+    /** Resolved auth context for this connection; passed to every subscribe. */
+    ctx: unknown;
+    /** Send a frame to the client (the transport serializes it). */
+    send: (frame: ServerFrame) => void;
+};
+export type SyncConnection = {
+    /** Handle one client frame (a parsed object or a raw JSON string). */
+    handle: (raw: unknown) => Promise<void>;
+    /** Tear down every subscription on this connection (call on socket close). */
+    close: () => void;
+};
+/**
+ * The per-connection protocol handler — transport-agnostic glue between a single
+ * client socket and the {@link SyncEngine}. It owns that connection's
+ * subscriptions: a `subscribe` frame authorizes + hydrates and replies with a
+ * `snapshot`, then streams `diff` frames; `unsubscribe`/`close` release views.
+ *
+ * Pure (no WebSocket import) so it can be unit-tested with a fake `send`; the
+ * Elysia `syncSocket` plugin is the thin adapter that feeds it socket events.
+ */
+export declare const createSyncConnection: ({ engine, ctx, send }: SyncConnectionOptions) => SyncConnection;