experimental-a2 0.6.0 → 0.8.0

package/dist/store-sqlite.js

@@ -1,5 +1,5 @@
 import { t as A2Error } from "./errors-BQuJpe82.js";
-import { n as pollingStream } from "./store-polling-dSeLxzfb.js";
+import { n as pollingStream } from "./store-polling-6DW7F1DT.js";
 import { t as idempotentReplay } from "./idempotent-replay-DuqEkYA7.js";
 import { n as SYSTEM_CLOCK, t as RANDOM_IDS } from "./store-N8PXxDAS.js";
 import { t as decodeReturnedEventIds } from "./store-codec-DTG0Ftek.js";
@@ -68,6 +68,26 @@ create table if not exists a2_snapshots (
   primary key (session_id, reducer_name)
 ) strict;
 
+create table if not exists a2_snapshot_history (
+  session_id   text    not null,
+  reducer_name text    not null,
+  up_to_index  integer not null,
+  state        text    not null,
+  updated_at   integer not null,
+  primary key (session_id, reducer_name, up_to_index)
+) strict;
+
+create table if not exists a2_snapshot_pins (
+  session_id   text    not null,
+  event_index  integer not null,
+  reducer_name text    not null,
+  up_to_index  integer not null,
+  primary key (session_id, event_index, reducer_name, up_to_index)
+) strict;
+
+create index if not exists a2_snapshot_pins_checkpoint
+  on a2_snapshot_pins (session_id, reducer_name, up_to_index);
+
 create table if not exists a2_presence (
   ns          text    not null,
   participant text    not null,
@@ -415,6 +435,15 @@ function sqlite(options = {}) {
                claim_holder = null,
                claim_expires_at = null
              where session_id = ? and idx = ?`).run(now, attempt, JSON.stringify(ids), sessionId, index);
+				db.prepare("delete from a2_snapshot_pins where session_id = ? and event_index = ?").run(sessionId, index);
+				db.prepare(`delete from a2_snapshot_history
+              where session_id = ?
+                and not exists (
+                  select 1 from a2_snapshot_pins pin
+                   where pin.session_id = a2_snapshot_history.session_id
+                     and pin.reducer_name = a2_snapshot_history.reducer_name
+                     and pin.up_to_index = a2_snapshot_history.up_to_index
+                )`).run(sessionId);
 				if (parent.lane !== null) promoteLaneHead.run(sessionId, sessionId, parent.lane);
 				return {
 					outcome: "completed",
@@ -464,22 +493,46 @@ function sqlite(options = {}) {
                claim_holder = null,
                claim_expires_at = null
              where session_id = ? and idx = ?`).run(nextFailureCount, error, now, attempt, deadLettered ? now : null, sessionId, index);
+				if (deadLettered) {
+					db.prepare("delete from a2_snapshot_pins where session_id = ? and event_index = ?").run(sessionId, index);
+					db.prepare(`delete from a2_snapshot_history
+                where session_id = ?
+                  and not exists (
+                    select 1 from a2_snapshot_pins pin
+                     where pin.session_id = a2_snapshot_history.session_id
+                       and pin.reducer_name = a2_snapshot_history.reducer_name
+                       and pin.up_to_index = a2_snapshot_history.up_to_index
+                  )`).run(sessionId);
+				}
 				return {
 					outcome: deadLettered ? "dead_lettered" : "failed",
 					failureCount: nextFailureCount
 				};
 			}));
 		},
-		async readState(sessionId, reducerName) {
+		async readState(sessionId, reducerName, stateOptions) {
 			return wrap(() => {
-				const rows = db.prepare(`with snapshot as materialized (
-             select up_to_index, state
+				const throughIndex = stateOptions?.throughIndex ?? null;
+				const snapshotThroughIndex = stateOptions?.snapshotThroughIndex ?? throughIndex;
+				const rows = db.prepare(`with head as materialized (
+             select up_to_index, state, updated_at
                from a2_snapshots
-               where session_id = ? and reducer_name = ?
+              where session_id = ? and reducer_name = ?
+           ), snapshot as materialized (
+             select up_to_index, state from (
+               select up_to_index, state from head
+                where (? is null or up_to_index <= ?)
+               union all
+               select up_to_index, state
+                 from a2_snapshot_history
+                where session_id = ? and reducer_name = ?
+                  and (? is null or up_to_index <= ?)
+             ) order by up_to_index desc limit 1
              )
              select 0 as row_order, 'snapshot' as row_kind,
-                    snapshot.up_to_index as snapshot_index,
-                    snapshot.state as snapshot_state,
+                    (select up_to_index from head) as head_index,
+                    (select up_to_index from snapshot) as snapshot_index,
+                    (select state from snapshot) as snapshot_state,
                     null as session_id, null as idx, null as event_type,
                     null as payload, null as event_id, null as created_at,
                     null as cause, null as lane, null as lane_ready,
@@ -491,18 +544,20 @@ function sqlite(options = {}) {
                     null as last_failed_attempt, null as last_error,
                     null as failed_at, null as claim_holder,
                     null as claim_expires_at
-             from snapshot
              union all
              select 1 as row_order, 'event' as row_kind,
+                    (select up_to_index from head) as head_index,
                     null as snapshot_index, null as snapshot_state,
                     event.*
              from a2_events as event
              where event.session_id = ?
                and event.idx > coalesce((select up_to_index from snapshot), 0)
-             order by row_order, idx`).all(sessionId, reducerName, sessionId);
+               and (? is null or event.idx <= ?)
+             order by row_order, idx`).all(sessionId, reducerName, snapshotThroughIndex, snapshotThroughIndex, sessionId, reducerName, snapshotThroughIndex, snapshotThroughIndex, sessionId, throughIndex, throughIndex);
 				const snapshot = rows.find((row) => row.row_kind === "snapshot");
 				return {
-					snapshot: snapshot ? {
+					headIndex: snapshot?.head_index === null || snapshot?.head_index === void 0 ? null : Number(snapshot.head_index),
+					snapshot: snapshot?.snapshot_index !== null && snapshot?.snapshot_index !== void 0 ? {
 						index: Number(snapshot.snapshot_index),
 						state: JSON.parse(snapshot.snapshot_state)
 					} : null,
@@ -510,16 +565,45 @@ function sqlite(options = {}) {
 				};
 			});
 		},
-		async putSnapshot(sessionId, reducerName, index, state) {
-			wrap(() => {
-				db.prepare(`insert into a2_snapshots (session_id, reducer_name, up_to_index, state, updated_at)
-           values (?, ?, ?, ?, ?)
-           on conflict (session_id, reducer_name) do update set
-             up_to_index = excluded.up_to_index,
-             state = excluded.state,
-             updated_at = excluded.updated_at
-           where excluded.up_to_index > a2_snapshots.up_to_index`).run(sessionId, reducerName, index, JSON.stringify(state) ?? "null", clock.now().getTime());
-			});
+		async putSnapshots(sessionId, reducerName, writes) {
+			await wrap(() => tx(() => {
+				const selectHead = db.prepare(`select up_to_index, state, updated_at from a2_snapshots
+              where session_id = ? and reducer_name = ?`);
+				const unfinished = db.prepare(`select 1 from a2_events
+              where session_id = ? and idx = ?
+                and processed_at is null and failed_at is null`);
+				const insertPin = db.prepare(`insert or ignore into a2_snapshot_pins
+               (session_id, event_index, reducer_name, up_to_index)
+             values (?, ?, ?, ?)`);
+				const hasPin = db.prepare(`select 1 from a2_snapshot_pins
+              where session_id = ? and reducer_name = ? and up_to_index = ?
+              limit 1`);
+				const putHistory = db.prepare(`insert into a2_snapshot_history
+               (session_id, reducer_name, up_to_index, state, updated_at)
+             values (?, ?, ?, ?, ?)
+             on conflict (session_id, reducer_name, up_to_index) do update set
+               state = excluded.state, updated_at = excluded.updated_at`);
+				const putHead = db.prepare(`insert into a2_snapshots
+               (session_id, reducer_name, up_to_index, state, updated_at)
+             values (?, ?, ?, ?, ?)
+             on conflict (session_id, reducer_name) do update set
+               up_to_index = excluded.up_to_index,
+               state = excluded.state,
+               updated_at = excluded.updated_at
+             where excluded.up_to_index >= a2_snapshots.up_to_index`);
+				const deleteHistory = db.prepare(`delete from a2_snapshot_history
+              where session_id = ? and reducer_name = ? and up_to_index = ?`);
+				for (const write of writes.toSorted((a, b) => a.index - b.index)) {
+					for (const eventIndex of write.pinEventIndexes ?? []) if (unfinished.get(sessionId, eventIndex)) insertPin.run(sessionId, eventIndex, reducerName, write.index);
+					const head = selectHead.get(sessionId, reducerName);
+					const now = clock.now().getTime();
+					if (!head || write.index >= Number(head.up_to_index)) {
+						if (head && write.index > Number(head.up_to_index) && hasPin.get(sessionId, reducerName, Number(head.up_to_index))) putHistory.run(sessionId, reducerName, Number(head.up_to_index), head.state, Number(head.updated_at));
+						putHead.run(sessionId, reducerName, write.index, JSON.stringify(write.state) ?? "null", now);
+						deleteHistory.run(sessionId, reducerName, write.index);
+					} else if (write.index < Number(head.up_to_index) && hasPin.get(sessionId, reducerName, write.index)) putHistory.run(sessionId, reducerName, write.index, JSON.stringify(write.state) ?? "null", now);
+				}
+			}));
 		},
 		presence: {
 			async set(ns, participant, values, meta) {
@@ -547,77 +631,6 @@ function sqlite(options = {}) {
 				});
 			}
 		},
-		inspect: {
-			async listSessions(inspectionOptions) {
-				return wrap(() => {
-					const conditions = ["substr(session_id, 1, ?) = ?"];
-					const params = [inspectionOptions.prefix.length, inspectionOptions.prefix];
-					if (inspectionOptions.cursor !== void 0) {
-						conditions.push("session_id > ?");
-						params.push(inspectionOptions.cursor);
-					}
-					params.push(inspectionOptions.limit + 1);
-					const rows = db.prepare(`select
-                 session_id,
-                 count(*) as event_count,
-                 sum(case when processed_at is null and failed_at is null then 1 else 0 end) as pending_count,
-                 sum(case when failed_at is not null then 1 else 0 end) as failed_count,
-                 sum(attempt_count) as attempt_count,
-                 sum(failure_count) as failure_count,
-                 min(created_at) as first_event_at,
-                 max(max(
-                   created_at,
-                   coalesce(first_claimed_at, 0),
-                   coalesce(last_claimed_at, 0),
-                   coalesce(last_failed_at, 0),
-                   coalesce(processed_at, 0),
-                   coalesce(failed_at, 0)
-                 )) as updated_at
-               from a2_events
-               where ${conditions.join(" and ")}
-               group by session_id
-               order by session_id
-               limit ?`).all(...params);
-					const hasMore = rows.length > inspectionOptions.limit;
-					const visible = rows.slice(0, inspectionOptions.limit);
-					return {
-						sessions: visible.map((row) => ({
-							sessionId: row.session_id,
-							eventCount: Number(row.event_count),
-							pendingCount: Number(row.pending_count),
-							failedCount: Number(row.failed_count),
-							attemptCount: Number(row.attempt_count),
-							failureCount: Number(row.failure_count),
-							firstEventAt: new Date(Number(row.first_event_at)),
-							updatedAt: new Date(Number(row.updated_at))
-						})),
-						cursor: hasMore ? visible.at(-1)?.session_id ?? null : null
-					};
-				});
-			},
-			async readEvents(sessionId, pageOptions) {
-				return wrap(() => {
-					const currentFrontier = Number(db.prepare("select coalesce(max(idx), 0) as frontier from a2_events where session_id = ?").get(sessionId).frontier);
-					const throughIndex = Math.min(pageOptions.throughIndex ?? currentFrontier, currentFrontier);
-					return {
-						events: db.prepare(`select * from a2_events
-                where session_id = ? and idx > ? and idx <= ?
-                order by idx limit ?`).all(sessionId, pageOptions.afterIndex, throughIndex, pageOptions.limit).map(toStored),
-						throughIndex
-					};
-				});
-			},
-			async listSnapshots(sessionId) {
-				return wrap(() => {
-					return db.prepare(`select reducer_name, up_to_index, updated_at
-               from a2_snapshots where session_id = ? order by reducer_name`).all(sessionId).map((row) => ({
-						reducerName: row.reducer_name,
-						index: Number(row.up_to_index),
-						updatedAt: new Date(Number(row.updated_at))
-					}));
-				});
-			}
-		},
 		stream(sessionId, opts) {
 			const readAfter = (afterIndex) => wrap(() => {
 				return db.prepare("select * from a2_events where session_id = ? and idx > ? order by idx").all(sessionId, afterIndex).map(toStored);

package/dist/store-sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-sqlite.js","names":[],"sources":["../src/store-sqlite.ts"],"sourcesContent":["/**\n * experimental-a2/store-sqlite — sqlite store backend (the dev default, `.a2/dev.db`).\n *\n * Built on `node:sqlite` (Node ≥ 22.13) so it ships with zero\n * dependencies. Implements the A2Store interface; the conformance suite\n * in test/conformance is the executable contract.\n *\n * The spec's `index` column is stored as `idx` (a2-implementation.md\n * §11 — `index` collides with a reserved word) and mapped back at the\n * API boundary. Timestamps are epoch milliseconds written from the\n * injected clock — never SQL `now()` — so tests can time-travel against\n * real storage.\n */\n\nimport { mkdirSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { DatabaseSync } from 'node:sqlite'\nimport { A2Error } from './errors.ts'\nimport { idempotentReplay } from './idempotent-replay.ts'\nimport { decodeReturnedEventIds } from './store-codec.ts'\nimport { pollingStream } from './store-polling.ts'\nimport {\n  RANDOM_IDS,\n  SYSTEM_CLOCK,\n  type A2Store,\n  type Clock,\n  type Event,\n  type EventCause,\n  type IdSource,\n  type StoredEvent,\n} from './store.ts'\n\nexport type SqliteStoreOptions = {\n  /** Database file path. Defaults to `.a2/dev.db`; `:memory:` works. */\n  path?: string\n  /** Injectable clock — every stored timestamp comes from here. */\n  clock?: Clock\n  /** Injectable id source for generated event ids. */\n  ids?: IdSource\n}\n\nexport type SqliteStore = A2Store & {\n  /** Close the underlying database handle. */\n  close(): void\n}\n\nconst SCHEMA = `\ncreate table if not exists a2_events (\n  session_id   text    not null,\n  idx          integer not null,\n  event_type   text    not null,\n  payload      text    not null,\n  event_id     text    not null,\n  created_at   integer not null,\n  cause        text,\n  lane         text,\n  lane_ready   integer not null default 0,\n  processed_at integer,\n  processed_by_attempt integer,\n  returned_event_ids text,\n  first_claimed_at integer,\n  last_claimed_at integer,\n  attempt_count integer not null default 0,\n  failure_count integer not null default 0,\n  last_failed_at integer,\n  last_failed_attempt integer,\n  last_error   text,\n  failed_at    integer,\n  claim_holder text,\n  claim_expires_at integer,\n  primary key (session_id, idx)\n) strict;\n\ncreate unique index if not exists a2_events_event_id on a2_events (event_id);\ncreate index if not exists a2_events_unprocessed\n  on a2_events (session_id, idx) where processed_at is null;\ncreate index if not exists a2_events_lane_pending\n  on a2_events (session_id, lane, idx) where processed_at is null;\ncreate index if not exists a2_events_dispatch_ready\n  on a2_events (session_id, idx)\n  where lane_ready = 1 and processed_at is null and failed_at is null;\ncreate index if not exists a2_events_claim_expiry\n  on a2_events (session_id, claim_expires_at)\n  where lane_ready = 1 and processed_at is null and failed_at is null;\n\ncreate table if not exists a2_snapshots (\n  session_id   text    not null,\n  reducer_name text    not null,\n  up_to_index  integer not null,\n  state        text    not null,\n  updated_at   integer not null,\n  primary key (session_id, reducer_name)\n) strict;\n\ncreate table if not exists a2_presence (\n  ns          text    not null,\n  participant text    not null,\n  field       text    not null,\n  value       text    not null,\n  seen        integer not null,\n  at          integer not null,\n  expires_at  integer not null,\n  primary key (ns, participant, field)\n) strict;\n`\n\n/**\n * Switching journal modes takes an exclusive lock, and — unlike normal\n * statements — the switch can return SQLITE_BUSY without consulting the\n * busy handler while several connections race it (instances cold-booting\n * against one file). Bounded synchronous retry; the window is boot-only\n * and tiny. Found by the multi-process torture test.\n */\nconst setWalJournalMode = (db: DatabaseSync): void => {\n  for (let attempt = 0; ; attempt += 1) {\n    try {\n      db.exec('pragma journal_mode = wal')\n      return\n    } catch (err) {\n      const busy = (err as { errcode?: number }).errcode === 5\n      if (!busy || attempt >= 100) throw err\n      // Synchronous 5ms sleep — sqlite() is a sync constructor.\n      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 5)\n    }\n  }\n}\n\nconst wrap = <T>(fn: () => T): T => {\n  try {\n    return fn()\n  } catch (err) {\n    if (err instanceof A2Error || err instanceof TypeError) throw err\n    throw new A2Error('STORE_UNAVAILABLE', 'sqlite store operation failed', {\n      cause: err,\n    })\n  }\n}\n\nconst toDate = (ms: number | bigint | null): Date | null =>\n  ms === null ? null : new Date(Number(ms))\n\nconst toCause = (json: string | null): EventCause | null => {\n  if (json === null) return null\n  const value = JSON.parse(json) as {\n    index?: unknown\n    attempt?: unknown\n    batchSize?: unknown\n  }\n  if (\n    !Number.isInteger(value.index) ||\n    Number(value.index) < 1 ||\n    !Number.isInteger(value.attempt) ||\n    Number(value.attempt) < 1\n  ) {\n    throw new TypeError('stored event has an invalid cause')\n  }\n  if (\n    value.batchSize !== undefined &&\n    (!Number.isInteger(value.batchSize) || Number(value.batchSize) < 1)\n  ) {\n    throw new TypeError('stored event has an invalid cause')\n  }\n  return {\n    index: Number(value.index),\n    attempt: Number(value.attempt),\n    ...(value.batchSize === undefined\n      ? {}\n      : { batchSize: Number(value.batchSize) }),\n  }\n}\n\nconst toStored = (row: EventRow): StoredEvent => ({\n  id: row.event_id,\n  type: row.event_type,\n  payload: JSON.parse(row.payload),\n  index: Number(row.idx),\n  sessionId: row.session_id,\n  createdAt: new Date(Number(row.created_at)),\n  cause: toCause(row.cause),\n  lane: row.lane,\n  processedAt: toDate(row.processed_at),\n  processedByAttempt:\n    row.processed_by_attempt === null ? null : Number(row.processed_by_attempt),\n  returnedEventIds:\n    row.returned_event_ids === null\n      ? null\n      : decodeReturnedEventIds(row.returned_event_ids),\n  firstClaimedAt: toDate(row.first_claimed_at),\n  lastClaimedAt: toDate(row.last_claimed_at),\n  attemptCount: Number(row.attempt_count),\n  failureCount: Number(row.failure_count),\n  lastFailedAt: toDate(row.last_failed_at),\n  lastFailedAttempt:\n    row.last_failed_attempt === null ? null : Number(row.last_failed_attempt),\n  lastError: row.last_error,\n  failedAt: toDate(row.failed_at),\n  claimHolder: row.claim_holder,\n  claimExpiresAt: toDate(row.claim_expires_at),\n})\n\nconst toEvent = (row: EventRow): Event => ({\n  id: row.event_id,\n  type: row.event_type,\n  payload: JSON.parse(row.payload),\n  index: Number(row.idx),\n  sessionId: row.session_id,\n  createdAt: new Date(Number(row.created_at)),\n})\n\ntype EventRow = {\n  session_id: string\n  idx: number | bigint\n  event_type: string\n  payload: string\n  event_id: string\n  created_at: number | bigint\n  cause: string | null\n  lane: string | null\n  processed_at: number | bigint | null\n  processed_by_attempt: number | bigint | null\n  returned_event_ids: string | null\n  first_claimed_at: number | bigint | null\n  last_claimed_at: number | bigint | null\n  attempt_count: number | bigint\n  failure_count: number | bigint\n  last_failed_at: number | bigint | null\n  last_failed_attempt: number | bigint | null\n  last_error: string | null\n  failed_at: number | bigint | null\n  claim_holder: string | null\n  claim_expires_at: number | bigint | null\n}\n\ntype SessionSummaryRow = {\n  session_id: string\n  event_count: number | bigint\n  pending_count: number | bigint\n  failed_count: number | bigint\n  attempt_count: number | bigint\n  failure_count: number | bigint\n  first_event_at: number | bigint\n  updated_at: number | bigint\n}\n\ntype SnapshotRow = {\n  reducer_name: string\n  up_to_index: number | bigint\n  updated_at: number | bigint\n}\n\ntype PresenceDbRow = {\n  participant: string\n  field: string\n  value: string\n  seen: number | bigint\n  at: number | bigint\n  expires_at: number | bigint\n}\n\ntype StateReadRow = Partial<EventRow> & {\n  row_kind: 'snapshot' | 'event'\n  snapshot_index: number | bigint | null\n  snapshot_state: string | null\n}\n\ntype AppendStatusRow = {\n  max: number | bigint\n  has_pending: number | bigint\n}\n\ntype ExistingEventRow = EventRow & {\n  session_has_pending: number | bigint\n}\n\nexport function sqlite(options: SqliteStoreOptions = {}): SqliteStore {\n  const path = options.path ?? '.a2/dev.db'\n  const clock = options.clock ?? SYSTEM_CLOCK\n  const generateId = options.ids ?? RANDOM_IDS\n\n  if (path !== ':memory:') {\n    // The dev-default backend only ever runs outside production, but\n    // bundlers can't know that: without the ignore, Turbopack sees a\n    // dynamic fs path and traces the entire project into the output.\n    mkdirSync(dirname(resolve(/* turbopackIgnore: true */ path)), {\n      recursive: true,\n    })\n  }\n  const db = new DatabaseSync(path)\n  // busy_timeout before anything that takes locks: concurrent\n  // cold-opens (several instances booting at once) race the WAL switch\n  // and schema creation.\n  db.exec('pragma busy_timeout = 5000')\n  setWalJournalMode(db)\n  db.exec('pragma synchronous = normal')\n  db.exec(SCHEMA)\n\n  const insertEvent = db.prepare(\n    `insert into a2_events\n       (session_id, idx, event_type, payload, event_id, created_at,\n        cause, lane, lane_ready, processed_at)\n     select ?, ?, ?, ?, ?, ?, ?, ?,\n            case\n              when ? is null then 1\n              when not exists (\n                select 1 from a2_events\n                 where session_id = ? and lane = ? and processed_at is null\n              ) then 1\n              else 0\n            end,\n            ?`,\n  )\n  const promoteLaneHead = db.prepare(\n    `update a2_events set lane_ready = 1\n      where session_id = ?\n        and idx = (\n          select idx from a2_events\n           where session_id = ? and lane = ? and processed_at is null\n           order by idx limit 1\n        )`,\n  )\n  const appendStatus = db.prepare(\n    `select coalesce(\n              (select max(idx) from a2_events where session_id = ?),\n              0\n            ) as max,\n            exists(\n              select 1 from a2_events\n              where session_id = ? and processed_at is null\n            ) as has_pending`,\n  )\n  const upsertPresence = db.prepare(\n    `insert into a2_presence (ns, participant, field, value, seen, at, expires_at)\n     values (?, ?, ?, ?, ?, ?, ?)\n     on conflict (ns, participant, field) do update set\n       value = excluded.value,\n       seen = excluded.seen,\n       at = excluded.at,\n       expires_at = excluded.expires_at\n     where a2_presence.at <= excluded.at`,\n  )\n  const deletePresence = db.prepare(\n    `delete from a2_presence\n      where ns = ? and participant = ? and field = ? and at <= ?`,\n  )\n  const sweepPresence = db.prepare(\n    'delete from a2_presence where ns = ? and expires_at <= ?',\n  )\n  const selectPresence = db.prepare(\n    `select participant, field, value, seen, at, expires_at\n       from a2_presence\n      where ns = ? and expires_at > ?\n      order by participant, field`,\n  )\n  const selectByIds = (count: number) =>\n    db.prepare(\n      `select stored.*,\n              exists(\n                select 1 from a2_events pending\n                where pending.session_id = ?\n                  and pending.processed_at is null\n              ) as session_has_pending\n         from a2_events stored\n        where stored.event_id in (${Array.from({ length: count }, () => '?').join(', ')})\n        order by stored.idx`,\n    )\n\n  const tx = <T>(fn: () => T): T => {\n    db.exec('begin immediate')\n    try {\n      const result = fn()\n      db.exec('commit')\n      return result\n    } catch (err) {\n      try {\n        db.exec('rollback')\n      } catch {\n        // Rollback can fail if the transaction never started; the\n        // original error is what matters.\n      }\n      throw err\n    }\n  }\n\n  return {\n    async append(sessionId, events) {\n      if (events.length === 0) {\n        return wrap(() => {\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n          ) as AppendStatusRow\n          return {\n            events: [],\n            hasPending: Number(status.has_pending) === 1,\n          }\n        })\n      }\n      return wrap(() =>\n        tx(() => {\n          const supplied = events.filter((e) => e.id !== undefined)\n          const suppliedIds = supplied.map((e) => e.id as string)\n          if (new Set(suppliedIds).size !== suppliedIds.length) {\n            throw new A2Error(\n              'PARTIAL_DUPLICATE_BATCH',\n              'batch contains the same event id more than once',\n            )\n          }\n          if (suppliedIds.length > 0) {\n            const existing = selectByIds(suppliedIds.length).all(\n              sessionId,\n              ...suppliedIds,\n            ) as unknown as ExistingEventRow[]\n            if (existing.length > 0) {\n              const foreign = existing.find(\n                (row) => row.session_id !== sessionId,\n              )\n              if (foreign) {\n                throw new A2Error(\n                  'PARTIAL_DUPLICATE_BATCH',\n                  `event id '${foreign.event_id}' already exists in another session`,\n                )\n              }\n              if (existing.length === events.length) {\n                return {\n                  events: idempotentReplay(events, existing.map(toStored)),\n                  hasPending: Number(existing[0]!.session_has_pending) === 1,\n                }\n              }\n              throw new A2Error(\n                'PARTIAL_DUPLICATE_BATCH',\n                `batch mixes ${existing.length} already-appended and ${events.length - existing.length} fresh events`,\n              )\n            }\n          }\n\n          // Attempt-currency fence: a fresh handler append commits only\n          // while its causal attempt is still the parent's latest\n          // (store.ts `append`). `begin immediate` serializes this read\n          // against a concurrent claim.\n          for (const e of events) {\n            if (!e.cause) continue\n            const parent = db\n              .prepare(\n                'select attempt_count, failed_at from a2_events where session_id = ? and idx = ?',\n              )\n              .get(sessionId, e.cause.index) as\n              { attempt_count: number | bigint; failed_at: unknown } | undefined\n            if (!parent) {\n              throw new TypeError(\n                `no event at index ${e.cause.index} in session '${sessionId}'`,\n              )\n            }\n            if (\n              Number(parent.attempt_count) !== e.cause.attempt ||\n              parent.failed_at !== null\n            ) {\n              throw new A2Error(\n                'SUPERSEDED_ATTEMPT',\n                `attempt ${e.cause.attempt} no longer owns event ${e.cause.index} in session '${sessionId}'`,\n              )\n            }\n          }\n\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n          ) as AppendStatusRow\n          const base = Number(status.max)\n          const now = clock.now().getTime()\n          const inserted: StoredEvent[] = events.map((e, i) => {\n            const id = e.id ?? generateId()\n            const index = base + 1 + i\n            insertEvent.run(\n              sessionId,\n              index,\n              e.type,\n              JSON.stringify(e.payload) ?? 'null',\n              id,\n              now,\n              e.cause ? JSON.stringify(e.cause) : null,\n              e.lane ?? null,\n              e.lane ?? null,\n              sessionId,\n              e.lane ?? null,\n              e.settled ? now : null,\n            )\n            return {\n              id,\n              type: e.type,\n              payload: structuredClone(e.payload),\n              index,\n              sessionId,\n              createdAt: new Date(now),\n              cause: e.cause ? { ...e.cause } : null,\n              lane: e.lane ?? null,\n              processedAt: e.settled ? new Date(now) : null,\n              processedByAttempt: null,\n              returnedEventIds: null,\n              firstClaimedAt: null,\n              lastClaimedAt: null,\n              attemptCount: 0,\n              failureCount: 0,\n              lastFailedAt: null,\n              lastFailedAttempt: null,\n              lastError: null,\n              failedAt: null,\n              claimHolder: null,\n              claimExpiresAt: null,\n            }\n          })\n          return {\n            events: inserted,\n            hasPending:\n              Number(status.has_pending) === 1 ||\n              events.some((event) => event.settled !== true),\n          }\n        }),\n      )\n    },\n\n    async read(sessionId, opts) {\n      return wrap(() => {\n        const conditions = ['session_id = ?']\n        const params: (string | number)[] = [sessionId]\n        if (opts?.afterIndex !== undefined) {\n          conditions.push('idx > ?')\n          params.push(opts.afterIndex)\n        }\n        if (opts?.throughIndex !== undefined) {\n          conditions.push('idx <= ?')\n          params.push(opts.throughIndex)\n        }\n        const rows = db\n          .prepare(\n            `select * from a2_events where ${conditions.join(' and ')} order by idx`,\n          )\n          .all(...params) as unknown as EventRow[]\n        return rows.map(toStored)\n      })\n    },\n\n    async claimAvailable({\n      sessionId,\n      holder,\n      ttlMs,\n      expiresAtMs,\n      excludeIndexes = [],\n    }) {\n      return wrap(() =>\n        tx(() => {\n          const now = clock.now().getTime()\n          const expiresAt = expiresAtMs ?? now + ttlMs\n          const exclusion =\n            excludeIndexes.length === 0\n              ? ''\n              : `and event.idx not in (${excludeIndexes.map(() => '?').join(', ')})`\n          const eligible = db\n            .prepare(\n              `select event.idx\n                 from a2_events event\n                where event.session_id = ?\n                  and event.processed_at is null\n                  and event.failed_at is null\n                  and event.lane_ready = 1\n                  and (event.claim_expires_at is null or event.claim_expires_at <= ?)\n                  ${exclusion}\n                order by event.idx`,\n            )\n            .all(sessionId, now, ...excludeIndexes) as unknown as Array<{\n            idx: number | bigint\n          }>\n          if (eligible.length > 0) {\n            const update = db.prepare(\n              `update a2_events set\n                 attempt_count = attempt_count + 1,\n                 first_claimed_at = coalesce(first_claimed_at, ?),\n                 last_claimed_at = ?,\n                 claim_holder = ?,\n                 claim_expires_at = ?\n               where session_id = ? and idx = ?\n               returning *`,\n            )\n            const events = eligible.map((row) => {\n              const claimed = update.get(\n                now,\n                now,\n                holder,\n                expiresAt,\n                sessionId,\n                row.idx,\n              ) as EventRow\n              return toStored(claimed)\n            })\n            return { outcome: 'claimed', events }\n          }\n\n          const active = db\n            .prepare(\n              `select min(claim_expires_at) as retry_at\n                 from a2_events\n                where session_id = ?\n                  and processed_at is null\n                  and failed_at is null\n                  and lane_ready = 1\n                  and claim_expires_at > ?`,\n            )\n            .get(sessionId, now) as {\n            retry_at: number | bigint | null\n          }\n          return active.retry_at === null\n            ? { outcome: 'settled' }\n            : { outcome: 'busy', retryAt: new Date(Number(active.retry_at)) }\n        }),\n      )\n    },\n\n    async renewClaims({ sessionId, holder, claims, ttlMs, expiresAtMs }) {\n      if (claims.length === 0) return { renewed: [], superseded: [] }\n      return wrap(() =>\n        tx(() => {\n          const now = clock.now().getTime()\n          const expiresAt = expiresAtMs ?? now + ttlMs\n          const renewed: number[] = []\n          const superseded: number[] = []\n          const currentAttempt = db.prepare(\n            'select attempt_count from a2_events where session_id = ? and idx = ?',\n          )\n          const extend = db.prepare(\n            `update a2_events set claim_expires_at = ?\n              where session_id = ?\n                and idx = ?\n                and attempt_count = ?\n                and processed_at is null\n                and failed_at is null\n                and claim_holder = ?\n                and claim_expires_at > ?`,\n          )\n          for (const claim of claims) {\n            const row = currentAttempt.get(sessionId, claim.index) as\n              { attempt_count: number | bigint } | undefined\n            if (!row) continue\n            if (Number(row.attempt_count) > claim.attempt) {\n              superseded.push(claim.index)\n              continue\n            }\n            const updated = extend.run(\n              expiresAt,\n              sessionId,\n              claim.index,\n              claim.attempt,\n              holder,\n              now,\n            )\n            if (Number(updated.changes) === 1) renewed.push(claim.index)\n          }\n          return {\n            renewed: renewed.toSorted((a, b) => a - b),\n            superseded: superseded.toSorted((a, b) => a - b),\n          }\n        }),\n      )\n    },\n\n    async completeAttempt({ sessionId, index, attempt, events }) {\n      return wrap(() =>\n        tx(() => {\n          const parent = db\n            .prepare('select * from a2_events where session_id = ? and idx = ?')\n            .get(sessionId, index) as EventRow | undefined\n          if (!parent) {\n            throw new TypeError(\n              `no event at index ${index} in session '${sessionId}'`,\n            )\n          }\n          const ids = events.map((event) => event.id)\n          if (new Set(ids).size !== ids.length) {\n            throw new A2Error(\n              'PARTIAL_DUPLICATE_BATCH',\n              'returned event batch contains the same event id more than once',\n            )\n          }\n\n          if (parent.processed_at !== null) {\n            if (Number(parent.processed_by_attempt) !== attempt) {\n              return { outcome: 'superseded' }\n            }\n            const returnedIds =\n              parent.returned_event_ids === null\n                ? null\n                : decodeReturnedEventIds(parent.returned_event_ids)\n            if (\n              returnedIds === null ||\n              returnedIds.length !== ids.length ||\n              returnedIds.some((id, offset) => id !== ids[offset])\n            ) {\n              throw new A2Error(\n                'PARTIAL_DUPLICATE_BATCH',\n                'completed attempt does not match the returned event batch',\n              )\n            }\n            const existing =\n              ids.length === 0\n                ? []\n                : (selectByIds(ids.length).all(\n                    sessionId,\n                    ...ids,\n                  ) as unknown as ExistingEventRow[])\n            const byId = new Map(existing.map((row) => [row.event_id, row]))\n            const ordered = ids.map((id) => byId.get(id))\n            if (\n              ordered.some(\n                (row) =>\n                  !row ||\n                  row.session_id !== sessionId ||\n                  row.cause === null ||\n                  toCause(row.cause)?.index !== index ||\n                  toCause(row.cause)?.attempt !== attempt,\n              )\n            ) {\n              throw new A2Error(\n                'PARTIAL_DUPLICATE_BATCH',\n                'returned event retry does not match the committed batch',\n              )\n            }\n            return {\n              outcome: 'completed',\n              events: idempotentReplay(\n                events,\n                (ordered as ExistingEventRow[]).map(toStored),\n              ),\n            }\n          }\n          if (\n            Number(parent.attempt_count) !== attempt ||\n            parent.claim_holder === null ||\n            parent.failed_at !== null\n          ) {\n            return { outcome: 'superseded' }\n          }\n\n          if (\n            ids.length > 0 &&\n            (selectByIds(ids.length).all(sessionId, ...ids) as unknown[])\n              .length > 0\n          ) {\n            throw new A2Error(\n              'PARTIAL_DUPLICATE_BATCH',\n              'returned event batch contains an already-appended event id',\n            )\n          }\n\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n          ) as AppendStatusRow\n          const now = clock.now().getTime()\n          db.prepare(\n            `update a2_events set\n               processed_at = ?,\n               processed_by_attempt = ?,\n               returned_event_ids = ?,\n               lane_ready = 0,\n               claim_holder = null,\n               claim_expires_at = null\n             where session_id = ? and idx = ?`,\n          ).run(now, attempt, JSON.stringify(ids), sessionId, index)\n          if (parent.lane !== null) {\n            promoteLaneHead.run(sessionId, sessionId, parent.lane)\n          }\n          const inserted = events.map((event, offset) => {\n            const id = event.id\n            const childIndex = Number(status.max) + offset + 1\n            const cause = { index, attempt }\n            insertEvent.run(\n              sessionId,\n              childIndex,\n              event.type,\n              JSON.stringify(event.payload) ?? 'null',\n              id,\n              now,\n              JSON.stringify(cause),\n              event.lane ?? null,\n              event.lane ?? null,\n              sessionId,\n              event.lane ?? null,\n              event.settled ? now : null,\n            )\n            return toStored(\n              db\n                .prepare(\n                  'select * from a2_events where session_id = ? and idx = ?',\n                )\n                .get(sessionId, childIndex) as EventRow,\n            )\n          })\n          return { outcome: 'completed', events: inserted }\n        }),\n      )\n    },\n\n    async failAttempt({ sessionId, index, attempt, error, maxFailures }) {\n      return wrap(() =>\n        tx(() => {\n          const current = db\n            .prepare('select * from a2_events where session_id = ? and idx = ?')\n            .get(sessionId, index) as EventRow | undefined\n          if (!current) {\n            throw new TypeError(\n              `no event at index ${index} in session '${sessionId}'`,\n            )\n          }\n          const failureCount = Number(current.failure_count)\n          if (\n            current.processed_at !== null ||\n            Number(current.attempt_count) !== attempt\n          ) {\n            return { outcome: 'superseded', failureCount }\n          }\n          if (current.failed_at !== null) {\n            return { outcome: 'dead_lettered', failureCount }\n          }\n          if (\n            current.claim_holder === null &&\n            current.last_failed_attempt !== null &&\n            Number(current.last_failed_attempt) === attempt\n          ) {\n            return { outcome: 'failed', failureCount }\n          }\n          if (current.claim_holder === null) {\n            return { outcome: 'superseded', failureCount }\n          }\n\n          const now = clock.now().getTime()\n          const nextFailureCount = failureCount + 1\n          const deadLettered = nextFailureCount >= maxFailures\n          db.prepare(\n            `update a2_events set\n               failure_count = ?,\n               last_error = ?,\n               last_failed_at = ?,\n               last_failed_attempt = ?,\n               failed_at = ?,\n               claim_holder = null,\n               claim_expires_at = null\n             where session_id = ? and idx = ?`,\n          ).run(\n            nextFailureCount,\n            error,\n            now,\n            attempt,\n            deadLettered ? now : null,\n            sessionId,\n            index,\n          )\n          return {\n            outcome: deadLettered ? 'dead_lettered' : 'failed',\n            failureCount: nextFailureCount,\n          }\n        }),\n      )\n    },\n\n    async readState(sessionId, reducerName) {\n      return wrap(() => {\n        const rows = db\n          .prepare(\n            `with snapshot as materialized (\n             select up_to_index, state\n               from a2_snapshots\n               where session_id = ? and reducer_name = ?\n             )\n             select 0 as row_order, 'snapshot' as row_kind,\n                    snapshot.up_to_index as snapshot_index,\n                    snapshot.state as snapshot_state,\n                    null as session_id, null as idx, null as event_type,\n                    null as payload, null as event_id, null as created_at,\n                    null as cause, null as lane, null as lane_ready,\n                    null as processed_at,\n                    null as processed_by_attempt, null as returned_event_ids,\n                    null as first_claimed_at,\n                    null as last_claimed_at, null as attempt_count,\n                    null as failure_count, null as last_failed_at,\n                    null as last_failed_attempt, null as last_error,\n                    null as failed_at, null as claim_holder,\n                    null as claim_expires_at\n             from snapshot\n             union all\n             select 1 as row_order, 'event' as row_kind,\n                    null as snapshot_index, null as snapshot_state,\n                    event.*\n             from a2_events as event\n             where event.session_id = ?\n               and event.idx > coalesce((select up_to_index from snapshot), 0)\n             order by row_order, idx`,\n          )\n          .all(sessionId, reducerName, sessionId) as unknown as StateReadRow[]\n        const snapshot = rows.find((row) => row.row_kind === 'snapshot')\n        return {\n          snapshot: snapshot\n            ? {\n                index: Number(snapshot.snapshot_index),\n                state: JSON.parse(snapshot.snapshot_state!),\n              }\n            : null,\n          events: rows\n            .filter(\n              (row): row is StateReadRow & EventRow => row.row_kind === 'event',\n            )\n            .map(toEvent),\n        }\n      })\n    },\n\n    async putSnapshot(sessionId, reducerName, index, state) {\n      wrap(() => {\n        // Guarded upsert: a slower concurrent writer must never clobber\n        // a further-along snapshot (spec §3).\n        db.prepare(\n          `insert into a2_snapshots (session_id, reducer_name, up_to_index, state, updated_at)\n           values (?, ?, ?, ?, ?)\n           on conflict (session_id, reducer_name) do update set\n             up_to_index = excluded.up_to_index,\n             state = excluded.state,\n             updated_at = excluded.updated_at\n           where excluded.up_to_index > a2_snapshots.up_to_index`,\n        ).run(\n          sessionId,\n          reducerName,\n          index,\n          JSON.stringify(state) ?? 'null',\n          clock.now().getTime(),\n        )\n      })\n    },\n\n    presence: {\n      async set(ns, participant, values, meta) {\n        const entries = Object.entries(values)\n        if (entries.length === 0) return\n        wrap(() =>\n          tx(() => {\n            const atMs = meta.at.getTime()\n            // Expiry anchors on the storage clock — the sender's `at`\n            // orders writes but never anchors their lifetime.\n            const expiresAtMs = clock.now().getTime() + meta.ttlMs\n            for (const [field, value] of entries) {\n              // Field-wise LWW: a stored row with a strictly newer `at`\n              // survives; ties go to the incoming write (memory parity).\n              if (value === null) {\n                deletePresence.run(ns, participant, field, atMs)\n              } else {\n                upsertPresence.run(\n                  ns,\n                  participant,\n                  field,\n                  JSON.stringify(value) ?? 'null',\n                  meta.seen,\n                  atMs,\n                  expiresAtMs,\n                )\n              }\n            }\n          }),\n        )\n      },\n\n      async read(ns) {\n        return wrap(() => {\n          const now = clock.now().getTime()\n          // The sweep is opportunistic cleanup; the select's filter\n          // alone keeps expired rows out of this result.\n          sweepPresence.run(ns, now)\n          const rows = selectPresence.all(ns, now) as unknown as PresenceDbRow[]\n          return rows.map((row) => ({\n            participant: row.participant,\n            field: row.field,\n            value: JSON.parse(row.value) as unknown,\n            seen: Number(row.seen),\n            at: new Date(Number(row.at)),\n            expiresAt: new Date(Number(row.expires_at)),\n          }))\n        })\n      },\n    },\n\n    inspect: {\n      async listSessions(inspectionOptions) {\n        return wrap(() => {\n          const conditions = ['substr(session_id, 1, ?) = ?']\n          const params: (string | number)[] = [\n            inspectionOptions.prefix.length,\n            inspectionOptions.prefix,\n          ]\n          if (inspectionOptions.cursor !== undefined) {\n            conditions.push('session_id > ?')\n            params.push(inspectionOptions.cursor)\n          }\n          params.push(inspectionOptions.limit + 1)\n          const rows = db\n            .prepare(\n              `select\n                 session_id,\n                 count(*) as event_count,\n                 sum(case when processed_at is null and failed_at is null then 1 else 0 end) as pending_count,\n                 sum(case when failed_at is not null then 1 else 0 end) as failed_count,\n                 sum(attempt_count) as attempt_count,\n                 sum(failure_count) as failure_count,\n                 min(created_at) as first_event_at,\n                 max(max(\n                   created_at,\n                   coalesce(first_claimed_at, 0),\n                   coalesce(last_claimed_at, 0),\n                   coalesce(last_failed_at, 0),\n                   coalesce(processed_at, 0),\n                   coalesce(failed_at, 0)\n                 )) as updated_at\n               from a2_events\n               where ${conditions.join(' and ')}\n               group by session_id\n               order by session_id\n               limit ?`,\n            )\n            .all(...params) as unknown as SessionSummaryRow[]\n          const hasMore = rows.length > inspectionOptions.limit\n          const visible = rows.slice(0, inspectionOptions.limit)\n          return {\n            sessions: visible.map((row) => ({\n              sessionId: row.session_id,\n              eventCount: Number(row.event_count),\n              pendingCount: Number(row.pending_count),\n              failedCount: Number(row.failed_count),\n              attemptCount: Number(row.attempt_count),\n              failureCount: Number(row.failure_count),\n              firstEventAt: new Date(Number(row.first_event_at)),\n              updatedAt: new Date(Number(row.updated_at)),\n            })),\n            cursor: hasMore ? (visible.at(-1)?.session_id ?? null) : null,\n          }\n        })\n      },\n      async readEvents(sessionId, pageOptions) {\n        return wrap(() => {\n          const currentFrontier = Number(\n            (\n              db\n                .prepare(\n                  'select coalesce(max(idx), 0) as frontier from a2_events where session_id = ?',\n                )\n                .get(sessionId) as { frontier: number }\n            ).frontier,\n          )\n          const throughIndex = Math.min(\n            pageOptions.throughIndex ?? currentFrontier,\n            currentFrontier,\n          )\n          const rows = db\n            .prepare(\n              `select * from a2_events\n                where session_id = ? and idx > ? and idx <= ?\n                order by idx limit ?`,\n            )\n            .all(\n              sessionId,\n              pageOptions.afterIndex,\n              throughIndex,\n              pageOptions.limit,\n            ) as unknown as EventRow[]\n          return { events: rows.map(toStored), throughIndex }\n        })\n      },\n      async listSnapshots(sessionId) {\n        return wrap(() => {\n          const rows = db\n            .prepare(\n              `select reducer_name, up_to_index, updated_at\n               from a2_snapshots where session_id = ? order by reducer_name`,\n            )\n            .all(sessionId) as unknown as SnapshotRow[]\n          return rows.map((row) => ({\n            reducerName: row.reducer_name,\n            index: Number(row.up_to_index),\n            updatedAt: new Date(Number(row.updated_at)),\n          }))\n        })\n      },\n    },\n\n    stream(sessionId, opts) {\n      const readAfter = (afterIndex: number): StoredEvent[] =>\n        wrap(() => {\n          const rows = db\n            .prepare(\n              'select * from a2_events where session_id = ? and idx > ? order by idx',\n            )\n            .all(sessionId, afterIndex) as unknown as EventRow[]\n          return rows.map(toStored)\n        })\n      return pollingStream(\n        readAfter,\n        opts?.startAfter !== undefined ? { startAfter: opts.startAfter } : {},\n      )\n    },\n\n    close() {\n      db.close()\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"store-sqlite.js","names":[],"sources":["../src/store-sqlite.ts"],"sourcesContent":["/**\n * experimental-a2/store-sqlite — sqlite store backend (the dev default, `.a2/dev.db`).\n *\n * Built on `node:sqlite` (Node ≥ 22.13) so it ships with zero\n * dependencies. Implements the A2Store interface; the conformance suite\n * in test/conformance is the executable contract.\n *\n * The spec's `index` column is stored as `idx` (a2-implementation.md\n * §11 — `index` collides with a reserved word) and mapped back at the\n * API boundary. Timestamps are epoch milliseconds written from the\n * injected clock — never SQL `now()` — so tests can time-travel against\n * real storage.\n */\n\nimport { mkdirSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { DatabaseSync } from 'node:sqlite'\nimport { A2Error } from './errors.ts'\nimport { idempotentReplay } from './idempotent-replay.ts'\nimport { decodeReturnedEventIds } from './store-codec.ts'\nimport { pollingStream } from './store-polling.ts'\nimport {\n  RANDOM_IDS,\n  SYSTEM_CLOCK,\n  type A2Store,\n  type Clock,\n  type Event,\n  type EventCause,\n  type IdSource,\n  type StoredEvent,\n} from './store.ts'\n\nexport type SqliteStoreOptions = {\n  /** Database file path. Defaults to `.a2/dev.db`; `:memory:` works. */\n  path?: string\n  /** Injectable clock — every stored timestamp comes from here. */\n  clock?: Clock\n  /** Injectable id source for generated event ids. */\n  ids?: IdSource\n}\n\nexport type SqliteStore = A2Store & {\n  /** Close the underlying database handle. */\n  close(): void\n}\n\nconst SCHEMA = `\ncreate table if not exists a2_events (\n  session_id   text    not null,\n  idx          integer not null,\n  event_type   text    not null,\n  payload      text    not null,\n  event_id     text    not null,\n  created_at   integer not null,\n  cause        text,\n  lane         text,\n  lane_ready   integer not null default 0,\n  processed_at integer,\n  processed_by_attempt integer,\n  returned_event_ids text,\n  first_claimed_at integer,\n  last_claimed_at integer,\n  attempt_count integer not null default 0,\n  failure_count integer not null default 0,\n  last_failed_at integer,\n  last_failed_attempt integer,\n  last_error   text,\n  failed_at    integer,\n  claim_holder text,\n  claim_expires_at integer,\n  primary key (session_id, idx)\n) strict;\n\ncreate unique index if not exists a2_events_event_id on a2_events (event_id);\ncreate index if not exists a2_events_unprocessed\n  on a2_events (session_id, idx) where processed_at is null;\ncreate index if not exists a2_events_lane_pending\n  on a2_events (session_id, lane, idx) where processed_at is null;\ncreate index if not exists a2_events_dispatch_ready\n  on a2_events (session_id, idx)\n  where lane_ready = 1 and processed_at is null and failed_at is null;\ncreate index if not exists a2_events_claim_expiry\n  on a2_events (session_id, claim_expires_at)\n  where lane_ready = 1 and processed_at is null and failed_at is null;\n\ncreate table if not exists a2_snapshots (\n  session_id   text    not null,\n  reducer_name text    not null,\n  up_to_index  integer not null,\n  state        text    not null,\n  updated_at   integer not null,\n  primary key (session_id, reducer_name)\n) strict;\n\ncreate table if not exists a2_snapshot_history (\n  session_id   text    not null,\n  reducer_name text    not null,\n  up_to_index  integer not null,\n  state        text    not null,\n  updated_at   integer not null,\n  primary key (session_id, reducer_name, up_to_index)\n) strict;\n\ncreate table if not exists a2_snapshot_pins (\n  session_id   text    not null,\n  event_index  integer not null,\n  reducer_name text    not null,\n  up_to_index  integer not null,\n  primary key (session_id, event_index, reducer_name, up_to_index)\n) strict;\n\ncreate index if not exists a2_snapshot_pins_checkpoint\n  on a2_snapshot_pins (session_id, reducer_name, up_to_index);\n\ncreate table if not exists a2_presence (\n  ns          text    not null,\n  participant text    not null,\n  field       text    not null,\n  value       text    not null,\n  seen        integer not null,\n  at          integer not null,\n  expires_at  integer not null,\n  primary key (ns, participant, field)\n) strict;\n`\n\n/**\n * Switching journal modes takes an exclusive lock, and — unlike normal\n * statements — the switch can return SQLITE_BUSY without consulting the\n * busy handler while several connections race it (instances cold-booting\n * against one file). Bounded synchronous retry; the window is boot-only\n * and tiny. Found by the multi-process torture test.\n */\nconst setWalJournalMode = (db: DatabaseSync): void => {\n  for (let attempt = 0; ; attempt += 1) {\n    try {\n      db.exec('pragma journal_mode = wal')\n      return\n    } catch (err) {\n      const busy = (err as { errcode?: number }).errcode === 5\n      if (!busy || attempt >= 100) throw err\n      // Synchronous 5ms sleep — sqlite() is a sync constructor.\n      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 5)\n    }\n  }\n}\n\nconst wrap = <T>(fn: () => T): T => {\n  try {\n    return fn()\n  } catch (err) {\n    if (err instanceof A2Error || err instanceof TypeError) throw err\n    throw new A2Error('STORE_UNAVAILABLE', 'sqlite store operation failed', {\n      cause: err,\n    })\n  }\n}\n\nconst toDate = (ms: number | bigint | null): Date | null =>\n  ms === null ? null : new Date(Number(ms))\n\nconst toCause = (json: string | null): EventCause | null => {\n  if (json === null) return null\n  const value = JSON.parse(json) as {\n    index?: unknown\n    attempt?: unknown\n    batchSize?: unknown\n  }\n  if (\n    !Number.isInteger(value.index) ||\n    Number(value.index) < 1 ||\n    !Number.isInteger(value.attempt) ||\n    Number(value.attempt) < 1\n  ) {\n    throw new TypeError('stored event has an invalid cause')\n  }\n  if (\n    value.batchSize !== undefined &&\n    (!Number.isInteger(value.batchSize) || Number(value.batchSize) < 1)\n  ) {\n    throw new TypeError('stored event has an invalid cause')\n  }\n  return {\n    index: Number(value.index),\n    attempt: Number(value.attempt),\n    ...(value.batchSize === undefined\n      ? {}\n      : { batchSize: Number(value.batchSize) }),\n  }\n}\n\nconst toStored = (row: EventRow): StoredEvent => ({\n  id: row.event_id,\n  type: row.event_type,\n  payload: JSON.parse(row.payload),\n  index: Number(row.idx),\n  sessionId: row.session_id,\n  createdAt: new Date(Number(row.created_at)),\n  cause: toCause(row.cause),\n  lane: row.lane,\n  processedAt: toDate(row.processed_at),\n  processedByAttempt:\n    row.processed_by_attempt === null ? null : Number(row.processed_by_attempt),\n  returnedEventIds:\n    row.returned_event_ids === null\n      ? null\n      : decodeReturnedEventIds(row.returned_event_ids),\n  firstClaimedAt: toDate(row.first_claimed_at),\n  lastClaimedAt: toDate(row.last_claimed_at),\n  attemptCount: Number(row.attempt_count),\n  failureCount: Number(row.failure_count),\n  lastFailedAt: toDate(row.last_failed_at),\n  lastFailedAttempt:\n    row.last_failed_attempt === null ? null : Number(row.last_failed_attempt),\n  lastError: row.last_error,\n  failedAt: toDate(row.failed_at),\n  claimHolder: row.claim_holder,\n  claimExpiresAt: toDate(row.claim_expires_at),\n})\n\nconst toEvent = (row: EventRow): Event => ({\n  id: row.event_id,\n  type: row.event_type,\n  payload: JSON.parse(row.payload),\n  index: Number(row.idx),\n  sessionId: row.session_id,\n  createdAt: new Date(Number(row.created_at)),\n})\n\ntype EventRow = {\n  session_id: string\n  idx: number | bigint\n  event_type: string\n  payload: string\n  event_id: string\n  created_at: number | bigint\n  cause: string | null\n  lane: string | null\n  processed_at: number | bigint | null\n  processed_by_attempt: number | bigint | null\n  returned_event_ids: string | null\n  first_claimed_at: number | bigint | null\n  last_claimed_at: number | bigint | null\n  attempt_count: number | bigint\n  failure_count: number | bigint\n  last_failed_at: number | bigint | null\n  last_failed_attempt: number | bigint | null\n  last_error: string | null\n  failed_at: number | bigint | null\n  claim_holder: string | null\n  claim_expires_at: number | bigint | null\n}\n\ntype PresenceDbRow = {\n  participant: string\n  field: string\n  value: string\n  seen: number | bigint\n  at: number | bigint\n  expires_at: number | bigint\n}\n\ntype StateReadRow = Partial<EventRow> & {\n  row_kind: 'snapshot' | 'event'\n  head_index: number | bigint | null\n  snapshot_index: number | bigint | null\n  snapshot_state: string | null\n}\n\ntype SnapshotHeadRow = {\n  up_to_index: number | bigint\n  state: string\n  updated_at: number | bigint\n}\n\ntype AppendStatusRow = {\n  max: number | bigint\n  has_pending: number | bigint\n}\n\ntype ExistingEventRow = EventRow & {\n  session_has_pending: number | bigint\n}\n\nexport function sqlite(options: SqliteStoreOptions = {}): SqliteStore {\n  const path = options.path ?? '.a2/dev.db'\n  const clock = options.clock ?? SYSTEM_CLOCK\n  const generateId = options.ids ?? RANDOM_IDS\n\n  if (path !== ':memory:') {\n    // The dev-default backend only ever runs outside production, but\n    // bundlers can't know that: without the ignore, Turbopack sees a\n    // dynamic fs path and traces the entire project into the output.\n    mkdirSync(dirname(resolve(/* turbopackIgnore: true */ path)), {\n      recursive: true,\n    })\n  }\n  const db = new DatabaseSync(path)\n  // busy_timeout before anything that takes locks: concurrent\n  // cold-opens (several instances booting at once) race the WAL switch\n  // and schema creation.\n  db.exec('pragma busy_timeout = 5000')\n  setWalJournalMode(db)\n  db.exec('pragma synchronous = normal')\n  db.exec(SCHEMA)\n\n  const insertEvent = db.prepare(\n    `insert into a2_events\n       (session_id, idx, event_type, payload, event_id, created_at,\n        cause, lane, lane_ready, processed_at)\n     select ?, ?, ?, ?, ?, ?, ?, ?,\n            case\n              when ? is null then 1\n              when not exists (\n                select 1 from a2_events\n                 where session_id = ? and lane = ? and processed_at is null\n              ) then 1\n              else 0\n            end,\n            ?`,\n  )\n  const promoteLaneHead = db.prepare(\n    `update a2_events set lane_ready = 1\n      where session_id = ?\n        and idx = (\n          select idx from a2_events\n           where session_id = ? and lane = ? and processed_at is null\n           order by idx limit 1\n        )`,\n  )\n  const appendStatus = db.prepare(\n    `select coalesce(\n              (select max(idx) from a2_events where session_id = ?),\n              0\n            ) as max,\n            exists(\n              select 1 from a2_events\n              where session_id = ? and processed_at is null\n            ) as has_pending`,\n  )\n  const upsertPresence = db.prepare(\n    `insert into a2_presence (ns, participant, field, value, seen, at, expires_at)\n     values (?, ?, ?, ?, ?, ?, ?)\n     on conflict (ns, participant, field) do update set\n       value = excluded.value,\n       seen = excluded.seen,\n       at = excluded.at,\n       expires_at = excluded.expires_at\n     where a2_presence.at <= excluded.at`,\n  )\n  const deletePresence = db.prepare(\n    `delete from a2_presence\n      where ns = ? and participant = ? and field = ? and at <= ?`,\n  )\n  const sweepPresence = db.prepare(\n    'delete from a2_presence where ns = ? and expires_at <= ?',\n  )\n  const selectPresence = db.prepare(\n    `select participant, field, value, seen, at, expires_at\n       from a2_presence\n      where ns = ? and expires_at > ?\n      order by participant, field`,\n  )\n  const selectByIds = (count: number) =>\n    db.prepare(\n      `select stored.*,\n              exists(\n                select 1 from a2_events pending\n                where pending.session_id = ?\n                  and pending.processed_at is null\n              ) as session_has_pending\n         from a2_events stored\n        where stored.event_id in (${Array.from({ length: count }, () => '?').join(', ')})\n        order by stored.idx`,\n    )\n\n  const tx = <T>(fn: () => T): T => {\n    db.exec('begin immediate')\n    try {\n      const result = fn()\n      db.exec('commit')\n      return result\n    } catch (err) {\n      try {\n        db.exec('rollback')\n      } catch {\n        // Rollback can fail if the transaction never started; the\n        // original error is what matters.\n      }\n      throw err\n    }\n  }\n\n  return {\n    async append(sessionId, events) {\n      if (events.length === 0) {\n        return wrap(() => {\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n          ) as AppendStatusRow\n          return {\n            events: [],\n            hasPending: Number(status.has_pending) === 1,\n          }\n        })\n      }\n      return wrap(() =>\n        tx(() => {\n          const supplied = events.filter((e) => e.id !== undefined)\n          const suppliedIds = supplied.map((e) => e.id as string)\n          if (new Set(suppliedIds).size !== suppliedIds.length) {\n            throw new A2Error(\n              'PARTIAL_DUPLICATE_BATCH',\n              'batch contains the same event id more than once',\n            )\n          }\n          if (suppliedIds.length > 0) {\n            const existing = selectByIds(suppliedIds.length).all(\n              sessionId,\n              ...suppliedIds,\n            ) as unknown as ExistingEventRow[]\n            if (existing.length > 0) {\n              const foreign = existing.find(\n                (row) => row.session_id !== sessionId,\n              )\n              if (foreign) {\n                throw new A2Error(\n                  'PARTIAL_DUPLICATE_BATCH',\n                  `event id '${foreign.event_id}' already exists in another session`,\n                )\n              }\n              if (existing.length === events.length) {\n                return {\n                  events: idempotentReplay(events, existing.map(toStored)),\n                  hasPending: Number(existing[0]!.session_has_pending) === 1,\n                }\n              }\n              throw new A2Error(\n                'PARTIAL_DUPLICATE_BATCH',\n                `batch mixes ${existing.length} already-appended and ${events.length - existing.length} fresh events`,\n              )\n            }\n          }\n\n          // Attempt-currency fence: a fresh handler append commits only\n          // while its causal attempt is still the parent's latest\n          // (store.ts `append`). `begin immediate` serializes this read\n          // against a concurrent claim.\n          for (const e of events) {\n            if (!e.cause) continue\n            const parent = db\n              .prepare(\n                'select attempt_count, failed_at from a2_events where session_id = ? and idx = ?',\n              )\n              .get(sessionId, e.cause.index) as\n              { attempt_count: number | bigint; failed_at: unknown } | undefined\n            if (!parent) {\n              throw new TypeError(\n                `no event at index ${e.cause.index} in session '${sessionId}'`,\n              )\n            }\n            if (\n              Number(parent.attempt_count) !== e.cause.attempt ||\n              parent.failed_at !== null\n            ) {\n              throw new A2Error(\n                'SUPERSEDED_ATTEMPT',\n                `attempt ${e.cause.attempt} no longer owns event ${e.cause.index} in session '${sessionId}'`,\n              )\n            }\n          }\n\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n          ) as AppendStatusRow\n          const base = Number(status.max)\n          const now = clock.now().getTime()\n          const inserted: StoredEvent[] = events.map((e, i) => {\n            const id = e.id ?? generateId()\n            const index = base + 1 + i\n            insertEvent.run(\n              sessionId,\n              index,\n              e.type,\n              JSON.stringify(e.payload) ?? 'null',\n              id,\n              now,\n              e.cause ? JSON.stringify(e.cause) : null,\n              e.lane ?? null,\n              e.lane ?? null,\n              sessionId,\n              e.lane ?? null,\n              e.settled ? now : null,\n            )\n            return {\n              id,\n              type: e.type,\n              payload: structuredClone(e.payload),\n              index,\n              sessionId,\n              createdAt: new Date(now),\n              cause: e.cause ? { ...e.cause } : null,\n              lane: e.lane ?? null,\n              processedAt: e.settled ? new Date(now) : null,\n              processedByAttempt: null,\n              returnedEventIds: null,\n              firstClaimedAt: null,\n              lastClaimedAt: null,\n              attemptCount: 0,\n              failureCount: 0,\n              lastFailedAt: null,\n              lastFailedAttempt: null,\n              lastError: null,\n              failedAt: null,\n              claimHolder: null,\n              claimExpiresAt: null,\n            }\n          })\n          return {\n            events: inserted,\n            hasPending:\n              Number(status.has_pending) === 1 ||\n              events.some((event) => event.settled !== true),\n          }\n        }),\n      )\n    },\n\n    async read(sessionId, opts) {\n      return wrap(() => {\n        const conditions = ['session_id = ?']\n        const params: (string | number)[] = [sessionId]\n        if (opts?.afterIndex !== undefined) {\n          conditions.push('idx > ?')\n          params.push(opts.afterIndex)\n        }\n        if (opts?.throughIndex !== undefined) {\n          conditions.push('idx <= ?')\n          params.push(opts.throughIndex)\n        }\n        const rows = db\n          .prepare(\n            `select * from a2_events where ${conditions.join(' and ')} order by idx`,\n          )\n          .all(...params) as unknown as EventRow[]\n        return rows.map(toStored)\n      })\n    },\n\n    async claimAvailable({\n      sessionId,\n      holder,\n      ttlMs,\n      expiresAtMs,\n      excludeIndexes = [],\n    }) {\n      return wrap(() =>\n        tx(() => {\n          const now = clock.now().getTime()\n          const expiresAt = expiresAtMs ?? now + ttlMs\n          const exclusion =\n            excludeIndexes.length === 0\n              ? ''\n              : `and event.idx not in (${excludeIndexes.map(() => '?').join(', ')})`\n          const eligible = db\n            .prepare(\n              `select event.idx\n                 from a2_events event\n                where event.session_id = ?\n                  and event.processed_at is null\n                  and event.failed_at is null\n                  and event.lane_ready = 1\n                  and (event.claim_expires_at is null or event.claim_expires_at <= ?)\n                  ${exclusion}\n                order by event.idx`,\n            )\n            .all(sessionId, now, ...excludeIndexes) as unknown as Array<{\n            idx: number | bigint\n          }>\n          if (eligible.length > 0) {\n            const update = db.prepare(\n              `update a2_events set\n                 attempt_count = attempt_count + 1,\n                 first_claimed_at = coalesce(first_claimed_at, ?),\n                 last_claimed_at = ?,\n                 claim_holder = ?,\n                 claim_expires_at = ?\n               where session_id = ? and idx = ?\n               returning *`,\n            )\n            const events = eligible.map((row) => {\n              const claimed = update.get(\n                now,\n                now,\n                holder,\n                expiresAt,\n                sessionId,\n                row.idx,\n              ) as EventRow\n              return toStored(claimed)\n            })\n            return { outcome: 'claimed', events }\n          }\n\n          const active = db\n            .prepare(\n              `select min(claim_expires_at) as retry_at\n                 from a2_events\n                where session_id = ?\n                  and processed_at is null\n                  and failed_at is null\n                  and lane_ready = 1\n                  and claim_expires_at > ?`,\n            )\n            .get(sessionId, now) as {\n            retry_at: number | bigint | null\n          }\n          return active.retry_at === null\n            ? { outcome: 'settled' }\n            : { outcome: 'busy', retryAt: new Date(Number(active.retry_at)) }\n        }),\n      )\n    },\n\n    async renewClaims({ sessionId, holder, claims, ttlMs, expiresAtMs }) {\n      if (claims.length === 0) return { renewed: [], superseded: [] }\n      return wrap(() =>\n        tx(() => {\n          const now = clock.now().getTime()\n          const expiresAt = expiresAtMs ?? now + ttlMs\n          const renewed: number[] = []\n          const superseded: number[] = []\n          const currentAttempt = db.prepare(\n            'select attempt_count from a2_events where session_id = ? and idx = ?',\n          )\n          const extend = db.prepare(\n            `update a2_events set claim_expires_at = ?\n              where session_id = ?\n                and idx = ?\n                and attempt_count = ?\n                and processed_at is null\n                and failed_at is null\n                and claim_holder = ?\n                and claim_expires_at > ?`,\n          )\n          for (const claim of claims) {\n            const row = currentAttempt.get(sessionId, claim.index) as\n              { attempt_count: number | bigint } | undefined\n            if (!row) continue\n            if (Number(row.attempt_count) > claim.attempt) {\n              superseded.push(claim.index)\n              continue\n            }\n            const updated = extend.run(\n              expiresAt,\n              sessionId,\n              claim.index,\n              claim.attempt,\n              holder,\n              now,\n            )\n            if (Number(updated.changes) === 1) renewed.push(claim.index)\n          }\n          return {\n            renewed: renewed.toSorted((a, b) => a - b),\n            superseded: superseded.toSorted((a, b) => a - b),\n          }\n        }),\n      )\n    },\n\n    async completeAttempt({ sessionId, index, attempt, events }) {\n      return wrap(() =>\n        tx(() => {\n          const parent = db\n            .prepare('select * from a2_events where session_id = ? and idx = ?')\n            .get(sessionId, index) as EventRow | undefined\n          if (!parent) {\n            throw new TypeError(\n              `no event at index ${index} in session '${sessionId}'`,\n            )\n          }\n          const ids = events.map((event) => event.id)\n          if (new Set(ids).size !== ids.length) {\n            throw new A2Error(\n              'PARTIAL_DUPLICATE_BATCH',\n              'returned event batch contains the same event id more than once',\n            )\n          }\n\n          if (parent.processed_at !== null) {\n            if (Number(parent.processed_by_attempt) !== attempt) {\n              return { outcome: 'superseded' }\n            }\n            const returnedIds =\n              parent.returned_event_ids === null\n                ? null\n                : decodeReturnedEventIds(parent.returned_event_ids)\n            if (\n              returnedIds === null ||\n              returnedIds.length !== ids.length ||\n              returnedIds.some((id, offset) => id !== ids[offset])\n            ) {\n              throw new A2Error(\n                'PARTIAL_DUPLICATE_BATCH',\n                'completed attempt does not match the returned event batch',\n              )\n            }\n            const existing =\n              ids.length === 0\n                ? []\n                : (selectByIds(ids.length).all(\n                    sessionId,\n                    ...ids,\n                  ) as unknown as ExistingEventRow[])\n            const byId = new Map(existing.map((row) => [row.event_id, row]))\n            const ordered = ids.map((id) => byId.get(id))\n            if (\n              ordered.some(\n                (row) =>\n                  !row ||\n                  row.session_id !== sessionId ||\n                  row.cause === null ||\n                  toCause(row.cause)?.index !== index ||\n                  toCause(row.cause)?.attempt !== attempt,\n              )\n            ) {\n              throw new A2Error(\n                'PARTIAL_DUPLICATE_BATCH',\n                'returned event retry does not match the committed batch',\n              )\n            }\n            return {\n              outcome: 'completed',\n              events: idempotentReplay(\n                events,\n                (ordered as ExistingEventRow[]).map(toStored),\n              ),\n            }\n          }\n          if (\n            Number(parent.attempt_count) !== attempt ||\n            parent.claim_holder === null ||\n            parent.failed_at !== null\n          ) {\n            return { outcome: 'superseded' }\n          }\n\n          if (\n            ids.length > 0 &&\n            (selectByIds(ids.length).all(sessionId, ...ids) as unknown[])\n              .length > 0\n          ) {\n            throw new A2Error(\n              'PARTIAL_DUPLICATE_BATCH',\n              'returned event batch contains an already-appended event id',\n            )\n          }\n\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n          ) as AppendStatusRow\n          const now = clock.now().getTime()\n          db.prepare(\n            `update a2_events set\n               processed_at = ?,\n               processed_by_attempt = ?,\n               returned_event_ids = ?,\n               lane_ready = 0,\n               claim_holder = null,\n               claim_expires_at = null\n             where session_id = ? and idx = ?`,\n          ).run(now, attempt, JSON.stringify(ids), sessionId, index)\n          db.prepare(\n            'delete from a2_snapshot_pins where session_id = ? and event_index = ?',\n          ).run(sessionId, index)\n          db.prepare(\n            `delete from a2_snapshot_history\n              where session_id = ?\n                and not exists (\n                  select 1 from a2_snapshot_pins pin\n                   where pin.session_id = a2_snapshot_history.session_id\n                     and pin.reducer_name = a2_snapshot_history.reducer_name\n                     and pin.up_to_index = a2_snapshot_history.up_to_index\n                )`,\n          ).run(sessionId)\n          if (parent.lane !== null) {\n            promoteLaneHead.run(sessionId, sessionId, parent.lane)\n          }\n          const inserted = events.map((event, offset) => {\n            const id = event.id\n            const childIndex = Number(status.max) + offset + 1\n            const cause = { index, attempt }\n            insertEvent.run(\n              sessionId,\n              childIndex,\n              event.type,\n              JSON.stringify(event.payload) ?? 'null',\n              id,\n              now,\n              JSON.stringify(cause),\n              event.lane ?? null,\n              event.lane ?? null,\n              sessionId,\n              event.lane ?? null,\n              event.settled ? now : null,\n            )\n            return toStored(\n              db\n                .prepare(\n                  'select * from a2_events where session_id = ? and idx = ?',\n                )\n                .get(sessionId, childIndex) as EventRow,\n            )\n          })\n          return { outcome: 'completed', events: inserted }\n        }),\n      )\n    },\n\n    async failAttempt({ sessionId, index, attempt, error, maxFailures }) {\n      return wrap(() =>\n        tx(() => {\n          const current = db\n            .prepare('select * from a2_events where session_id = ? and idx = ?')\n            .get(sessionId, index) as EventRow | undefined\n          if (!current) {\n            throw new TypeError(\n              `no event at index ${index} in session '${sessionId}'`,\n            )\n          }\n          const failureCount = Number(current.failure_count)\n          if (\n            current.processed_at !== null ||\n            Number(current.attempt_count) !== attempt\n          ) {\n            return { outcome: 'superseded', failureCount }\n          }\n          if (current.failed_at !== null) {\n            return { outcome: 'dead_lettered', failureCount }\n          }\n          if (\n            current.claim_holder === null &&\n            current.last_failed_attempt !== null &&\n            Number(current.last_failed_attempt) === attempt\n          ) {\n            return { outcome: 'failed', failureCount }\n          }\n          if (current.claim_holder === null) {\n            return { outcome: 'superseded', failureCount }\n          }\n\n          const now = clock.now().getTime()\n          const nextFailureCount = failureCount + 1\n          const deadLettered = nextFailureCount >= maxFailures\n          db.prepare(\n            `update a2_events set\n               failure_count = ?,\n               last_error = ?,\n               last_failed_at = ?,\n               last_failed_attempt = ?,\n               failed_at = ?,\n               claim_holder = null,\n               claim_expires_at = null\n             where session_id = ? and idx = ?`,\n          ).run(\n            nextFailureCount,\n            error,\n            now,\n            attempt,\n            deadLettered ? now : null,\n            sessionId,\n            index,\n          )\n          if (deadLettered) {\n            db.prepare(\n              'delete from a2_snapshot_pins where session_id = ? and event_index = ?',\n            ).run(sessionId, index)\n            db.prepare(\n              `delete from a2_snapshot_history\n                where session_id = ?\n                  and not exists (\n                    select 1 from a2_snapshot_pins pin\n                     where pin.session_id = a2_snapshot_history.session_id\n                       and pin.reducer_name = a2_snapshot_history.reducer_name\n                       and pin.up_to_index = a2_snapshot_history.up_to_index\n                  )`,\n            ).run(sessionId)\n          }\n          return {\n            outcome: deadLettered ? 'dead_lettered' : 'failed',\n            failureCount: nextFailureCount,\n          }\n        }),\n      )\n    },\n\n    async readState(sessionId, reducerName, stateOptions) {\n      return wrap(() => {\n        const throughIndex = stateOptions?.throughIndex ?? null\n        const snapshotThroughIndex =\n          stateOptions?.snapshotThroughIndex ?? throughIndex\n        const rows = db\n          .prepare(\n            `with head as materialized (\n             select up_to_index, state, updated_at\n               from a2_snapshots\n              where session_id = ? and reducer_name = ?\n           ), snapshot as materialized (\n             select up_to_index, state from (\n               select up_to_index, state from head\n                where (? is null or up_to_index <= ?)\n               union all\n               select up_to_index, state\n                 from a2_snapshot_history\n                where session_id = ? and reducer_name = ?\n                  and (? is null or up_to_index <= ?)\n             ) order by up_to_index desc limit 1\n             )\n             select 0 as row_order, 'snapshot' as row_kind,\n                    (select up_to_index from head) as head_index,\n                    (select up_to_index from snapshot) as snapshot_index,\n                    (select state from snapshot) as snapshot_state,\n                    null as session_id, null as idx, null as event_type,\n                    null as payload, null as event_id, null as created_at,\n                    null as cause, null as lane, null as lane_ready,\n                    null as processed_at,\n                    null as processed_by_attempt, null as returned_event_ids,\n                    null as first_claimed_at,\n                    null as last_claimed_at, null as attempt_count,\n                    null as failure_count, null as last_failed_at,\n                    null as last_failed_attempt, null as last_error,\n                    null as failed_at, null as claim_holder,\n                    null as claim_expires_at\n             union all\n             select 1 as row_order, 'event' as row_kind,\n                    (select up_to_index from head) as head_index,\n                    null as snapshot_index, null as snapshot_state,\n                    event.*\n             from a2_events as event\n             where event.session_id = ?\n               and event.idx > coalesce((select up_to_index from snapshot), 0)\n               and (? is null or event.idx <= ?)\n             order by row_order, idx`,\n          )\n          .all(\n            sessionId,\n            reducerName,\n            snapshotThroughIndex,\n            snapshotThroughIndex,\n            sessionId,\n            reducerName,\n            snapshotThroughIndex,\n            snapshotThroughIndex,\n            sessionId,\n            throughIndex,\n            throughIndex,\n          ) as unknown as StateReadRow[]\n        const snapshot = rows.find((row) => row.row_kind === 'snapshot')\n        return {\n          headIndex:\n            snapshot?.head_index === null || snapshot?.head_index === undefined\n              ? null\n              : Number(snapshot.head_index),\n          snapshot:\n            snapshot?.snapshot_index !== null &&\n            snapshot?.snapshot_index !== undefined\n              ? {\n                  index: Number(snapshot.snapshot_index),\n                  state: JSON.parse(snapshot.snapshot_state!),\n                }\n              : null,\n          events: rows\n            .filter(\n              (row): row is StateReadRow & EventRow => row.row_kind === 'event',\n            )\n            .map(toEvent),\n        }\n      })\n    },\n\n    async putSnapshots(sessionId, reducerName, writes) {\n      await wrap(() =>\n        tx(() => {\n          const selectHead = db.prepare(\n            `select up_to_index, state, updated_at from a2_snapshots\n              where session_id = ? and reducer_name = ?`,\n          )\n          const unfinished = db.prepare(\n            `select 1 from a2_events\n              where session_id = ? and idx = ?\n                and processed_at is null and failed_at is null`,\n          )\n          const insertPin = db.prepare(\n            `insert or ignore into a2_snapshot_pins\n               (session_id, event_index, reducer_name, up_to_index)\n             values (?, ?, ?, ?)`,\n          )\n          const hasPin = db.prepare(\n            `select 1 from a2_snapshot_pins\n              where session_id = ? and reducer_name = ? and up_to_index = ?\n              limit 1`,\n          )\n          const putHistory = db.prepare(\n            `insert into a2_snapshot_history\n               (session_id, reducer_name, up_to_index, state, updated_at)\n             values (?, ?, ?, ?, ?)\n             on conflict (session_id, reducer_name, up_to_index) do update set\n               state = excluded.state, updated_at = excluded.updated_at`,\n          )\n          const putHead = db.prepare(\n            `insert into a2_snapshots\n               (session_id, reducer_name, up_to_index, state, updated_at)\n             values (?, ?, ?, ?, ?)\n             on conflict (session_id, reducer_name) do update set\n               up_to_index = excluded.up_to_index,\n               state = excluded.state,\n               updated_at = excluded.updated_at\n             where excluded.up_to_index >= a2_snapshots.up_to_index`,\n          )\n          const deleteHistory = db.prepare(\n            `delete from a2_snapshot_history\n              where session_id = ? and reducer_name = ? and up_to_index = ?`,\n          )\n          for (const write of writes.toSorted((a, b) => a.index - b.index)) {\n            for (const eventIndex of write.pinEventIndexes ?? []) {\n              if (unfinished.get(sessionId, eventIndex)) {\n                insertPin.run(sessionId, eventIndex, reducerName, write.index)\n              }\n            }\n            const head = selectHead.get(sessionId, reducerName) as\n              SnapshotHeadRow | undefined\n            const now = clock.now().getTime()\n            if (!head || write.index >= Number(head.up_to_index)) {\n              if (\n                head &&\n                write.index > Number(head.up_to_index) &&\n                hasPin.get(sessionId, reducerName, Number(head.up_to_index))\n              ) {\n                putHistory.run(\n                  sessionId,\n                  reducerName,\n                  Number(head.up_to_index),\n                  head.state,\n                  Number(head.updated_at),\n                )\n              }\n              putHead.run(\n                sessionId,\n                reducerName,\n                write.index,\n                JSON.stringify(write.state) ?? 'null',\n                now,\n              )\n              deleteHistory.run(sessionId, reducerName, write.index)\n            } else if (\n              write.index < Number(head.up_to_index) &&\n              hasPin.get(sessionId, reducerName, write.index)\n            ) {\n              putHistory.run(\n                sessionId,\n                reducerName,\n                write.index,\n                JSON.stringify(write.state) ?? 'null',\n                now,\n              )\n            }\n          }\n        }),\n      )\n    },\n\n    presence: {\n      async set(ns, participant, values, meta) {\n        const entries = Object.entries(values)\n        if (entries.length === 0) return\n        wrap(() =>\n          tx(() => {\n            const atMs = meta.at.getTime()\n            // Expiry anchors on the storage clock — the sender's `at`\n            // orders writes but never anchors their lifetime.\n            const expiresAtMs = clock.now().getTime() + meta.ttlMs\n            for (const [field, value] of entries) {\n              // Field-wise LWW: a stored row with a strictly newer `at`\n              // survives; ties go to the incoming write (memory parity).\n              if (value === null) {\n                deletePresence.run(ns, participant, field, atMs)\n              } else {\n                upsertPresence.run(\n                  ns,\n                  participant,\n                  field,\n                  JSON.stringify(value) ?? 'null',\n                  meta.seen,\n                  atMs,\n                  expiresAtMs,\n                )\n              }\n            }\n          }),\n        )\n      },\n\n      async read(ns) {\n        return wrap(() => {\n          const now = clock.now().getTime()\n          // The sweep is opportunistic cleanup; the select's filter\n          // alone keeps expired rows out of this result.\n          sweepPresence.run(ns, now)\n          const rows = selectPresence.all(ns, now) as unknown as PresenceDbRow[]\n          return rows.map((row) => ({\n            participant: row.participant,\n            field: row.field,\n            value: JSON.parse(row.value) as unknown,\n            seen: Number(row.seen),\n            at: new Date(Number(row.at)),\n            expiresAt: new Date(Number(row.expires_at)),\n          }))\n        })\n      },\n    },\n\n    stream(sessionId, opts) {\n      const readAfter = (afterIndex: number): StoredEvent[] =>\n        wrap(() => {\n          const rows = db\n            .prepare(\n              'select * from a2_events where session_id = ? and idx > ? order by idx',\n            )\n            .all(sessionId, afterIndex) as unknown as EventRow[]\n          return rows.map(toStored)\n        })\n      return pollingStream(\n        readAfter,\n        opts?.startAfter !== undefined ? { startAfter: opts.startAfter } : {},\n      )\n    },\n\n    close() {\n      db.close()\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/{wire-BFQmSJ-9.js → wire-B6te_wns.js}

@@ -1,8 +1,8 @@
 import { t as A2Error } from "./errors-BQuJpe82.js";
-import { g as nullProtoRecord } from "./internal-DstsI6Re.js";
+import { h as nullProtoRecord } from "./internal-DRXJ56EI.js";
 //#region src/wire.ts
 /**
-* The wire format shared by experimental-a2/http (server side) and experimental-a2/client
+* The wire format shared by server.fetch and experimental-a2/client
 * (browser side): events as JSON with ISO timestamps, and the A2Error
 * envelope. Internal module — both entry points re-export what's
 * public.
@@ -89,6 +89,7 @@ function isWirePresenceSnapshot(value) {
 }
 const ERROR_STATUS = {
 	INVALID_PAYLOAD: 400,
+	FORBIDDEN: 403,
 	UNKNOWN_EVENT_TYPE: 400,
 	PARTIAL_DUPLICATE_BATCH: 400,
 	SUPERSEDED_ATTEMPT: 409,
@@ -281,4 +282,4 @@ const sessionTag = (frame) => {
 //#endregion
 export { socketErrorAckFor as _, errorToWire as a, socketUnsubscribedFor as b, isWireEvent as c, parseSocketFrame as d, presencePatchFromWire as f, socketAckFor as g, presenceSnapshotToWire as h, errorStatus as i, isWirePresencePatch as l, presenceSnapshotFromWire as m, asA2Error as n, eventFromWire as o, presencePatchToWire as p, errorFromWire as r, eventToWire as s, SOCKET_PING_FRAME as t, isWirePresenceSnapshot as u, socketFrameFor as v, socketSubscribedFor as y };
 
-//# sourceMappingURL=wire-BFQmSJ-9.js.map
+//# sourceMappingURL=wire-B6te_wns.js.map

package/dist/wire-B6te_wns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-B6te_wns.js","names":[],"sources":["../src/wire.ts"],"sourcesContent":["/**\n * The wire format shared by server.fetch and experimental-a2/client\n * (browser side): events as JSON with ISO timestamps, and the A2Error\n * envelope. Internal module — both entry points re-export what's\n * public.\n */\n\nimport { A2Error, type A2ErrorCode } from './errors.ts'\nimport { nullProtoRecord } from './internal.ts'\nimport type { Event } from './store.ts'\nimport type {\n  PresenceMap,\n  PresencePatch,\n  PresenceSnapshot,\n} from './contract.ts'\n\nexport type WireEvent = {\n  id: string\n  type: string\n  payload: unknown\n  index: number\n  sessionId: string\n  /** ISO 8601 — revived to a Date on the client so reducers see the\n   * same shape on both sides of the wire. */\n  createdAt: string\n}\n\nexport function eventToWire(event: Event): WireEvent {\n  return {\n    id: event.id,\n    type: event.type,\n    payload: event.payload,\n    index: event.index,\n    sessionId: event.sessionId,\n    createdAt: event.createdAt.toISOString(),\n  }\n}\n\nexport function eventFromWire(wire: WireEvent): Event {\n  return {\n    id: wire.id,\n    type: wire.type,\n    payload: wire.payload,\n    index: wire.index,\n    sessionId: wire.sessionId,\n    createdAt: new Date(wire.createdAt),\n  }\n}\n\nexport function isWireEvent(value: unknown): value is WireEvent {\n  if (value === null || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    typeof v['id'] === 'string' &&\n    typeof v['type'] === 'string' &&\n    typeof v['index'] === 'number' &&\n    typeof v['sessionId'] === 'string' &&\n    typeof v['createdAt'] === 'string'\n  )\n}\n\n// ── the presence wire pair ───────────────────────────────────────────\n\n/** The `event: presence` SSE frame body: one patch as JSON. */\nexport type WirePresencePatch = {\n  participant: string\n  values: Record<string, unknown>\n  seen: number\n  /** ISO 8601 — revived to a Date on the client. */\n  at: string\n}\n\n/**\n * The `event: presence-snapshot` SSE frame body: the in-memory\n * `PresenceSnapshot` shape verbatim, with each per-field `at`\n * serialized to ISO 8601.\n */\nexport type WirePresenceSnapshot = {\n  snapshot: {\n    [participant: string]: {\n      [field: string]: { value: unknown; seen: number; at: string }\n    }\n  }\n}\n\nexport function presencePatchToWire(patch: PresencePatch): WirePresencePatch {\n  return {\n    participant: patch.participant,\n    values: patch.values,\n    seen: patch.seen,\n    at: patch.at.toISOString(),\n  }\n}\n\nexport function presencePatchFromWire(wire: WirePresencePatch): PresencePatch {\n  return {\n    participant: wire.participant,\n    values: wire.values,\n    seen: wire.seen,\n    at: new Date(wire.at),\n  }\n}\n\n// Participant and field keys come off the wire, so every object keyed\n// by them is built null-prototype — see `nullProtoRecord`.\nexport function presenceSnapshotToWire(\n  snapshot: PresenceSnapshot,\n): WirePresenceSnapshot {\n  const wire: WirePresenceSnapshot['snapshot'] = nullProtoRecord()\n  for (const [participant, fields] of Object.entries(snapshot.snapshot)) {\n    const wireFields: WirePresenceSnapshot['snapshot'][string] =\n      nullProtoRecord()\n    for (const [field, entry] of Object.entries(fields)) {\n      if (entry === undefined) continue\n      wireFields[field] = {\n        value: entry.value,\n        seen: entry.seen,\n        at: entry.at.toISOString(),\n      }\n    }\n    wire[participant] = wireFields\n  }\n  return { snapshot: wire }\n}\n\nexport function presenceSnapshotFromWire(\n  wire: WirePresenceSnapshot,\n): PresenceSnapshot {\n  const map: PresenceMap = nullProtoRecord()\n  for (const [participant, fields] of Object.entries(wire.snapshot)) {\n    const revived: PresenceMap[string] = nullProtoRecord()\n    for (const [field, entry] of Object.entries(fields)) {\n      revived[field] = {\n        value: entry.value,\n        seen: entry.seen,\n        at: new Date(entry.at),\n      }\n    }\n    map[participant] = revived\n  }\n  return { snapshot: map }\n}\n\nexport function isWirePresencePatch(\n  value: unknown,\n): value is WirePresencePatch {\n  if (value === null || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    typeof v['participant'] === 'string' &&\n    v['values'] !== null &&\n    typeof v['values'] === 'object' &&\n    !Array.isArray(v['values']) &&\n    typeof v['seen'] === 'number' &&\n    typeof v['at'] === 'string'\n  )\n}\n\nexport function isWirePresenceSnapshot(\n  value: unknown,\n): value is WirePresenceSnapshot {\n  if (value === null || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    v['snapshot'] !== null &&\n    typeof v['snapshot'] === 'object' &&\n    !Array.isArray(v['snapshot'])\n  )\n}\n\n// ── the A2Error envelope ─────────────────────────────────────────────\n\nexport type WireError = {\n  error: { code: A2ErrorCode; message: string; details?: unknown }\n}\n\nconst ERROR_STATUS: Record<A2ErrorCode, number> = {\n  INVALID_PAYLOAD: 400,\n  FORBIDDEN: 403,\n  UNKNOWN_EVENT_TYPE: 400,\n  PARTIAL_DUPLICATE_BATCH: 400,\n  SUPERSEDED_ATTEMPT: 409,\n  CLAIM_EXPIRED: 409,\n  STORE_UNAVAILABLE: 503,\n  STORE_NOT_CONFIGURED: 500,\n  UNKNOWN_PRESENCE_FIELD: 400,\n  PRESENCE_NOT_SUPPORTED: 500,\n}\n\nexport function errorStatus(code: A2ErrorCode): number {\n  return ERROR_STATUS[code]\n}\n\nexport function errorToWire(error: A2Error): WireError {\n  const body: WireError = {\n    error: { code: error.code, message: error.message },\n  }\n  if (error.details !== undefined) body.error.details = error.details\n  return body\n}\n\n/** Wrap an arbitrary thrown value for the wire: A2Errors pass through,\n * anything else becomes STORE_UNAVAILABLE — from the client's\n * perspective an unknown server failure is retryable-once, not a\n * protocol contract. */\nexport function asA2Error(error: unknown): A2Error {\n  return error instanceof A2Error\n    ? error\n    : new A2Error('STORE_UNAVAILABLE', 'internal error', { cause: error })\n}\n\n/** Rebuild an A2Error from a wire body; null if the body isn't one. */\nexport function errorFromWire(body: unknown): A2Error | null {\n  if (body === null || typeof body !== 'object') return null\n  const err = (body as { error?: unknown }).error\n  if (err === null || typeof err !== 'object') return null\n  const { code, message, details } = err as Record<string, unknown>\n  if (typeof code !== 'string' || !Object.hasOwn(ERROR_STATUS, code))\n    return null\n  return new A2Error(code as A2ErrorCode, String(message ?? code), {\n    details,\n  })\n}\n\n// ── the ws frame layer ───────────────────────────────────────────────\n// The SSE lanes reframed for a socket (specs/a2-api.md §13): every\n// message is one JSON text frame, and a frame is its wire payload plus\n// a `kind` discriminant (plus `req` where a reply must correlate).\n// Unknown kinds are skipped by both sides — the same\n// forward-compatibility rule as named SSE frames.\n//\n// The multiplexed superset rides the same frames: `subscribe` /\n// `unsubscribe` up-frames open and close per-session lanes on one\n// socket, `sessionId` tags route everything else. Single-session\n// frames (no tags) keep parsing unchanged — a route opts into\n// multiplexing by choosing the multi-session server handler, never by\n// breaking the old protocol.\n\n/**\n * Server → client, parsed: a live-stream item, a push ack, a\n * subscription lifecycle notice, or the heartbeat. `parseSocketFrame`\n * yields these; frames of unknown kind (or ones failing their shape\n * guard) come back `null`. `sessionId` is present on frames from a\n * multiplexed socket and absent on a single-session one.\n */\nexport type SocketDownFrame =\n  | { kind: 'event'; event: WireEvent }\n  | { kind: 'presence'; patch: WirePresencePatch; sessionId?: string }\n  | {\n      kind: 'presence-snapshot'\n      snapshot: WirePresenceSnapshot\n      sessionId?: string\n    }\n  | { kind: 'ack'; req: number; events: WireEvent[]; sessionId?: string }\n  | { kind: 'ack'; req: number; error: A2Error; sessionId?: string }\n  | { kind: 'subscribed'; sessionId: string }\n  | { kind: 'unsubscribed'; sessionId: string; reason?: string }\n  | { kind: 'ping' }\n\n/**\n * Client → server: the push envelope's two planes. `sessionId` is\n * implied by the socket on a single-session connection and required by\n * the multiplexed handler. Plain JSON on the wire; the server parses\n * and validates them through the same seams as `parsePushBody`.\n */\nexport type SocketPushFrame = {\n  kind: 'push'\n  /** Client-local ack correlator — opaque to the server. */\n  req: number\n  events: Array<{ type: string; payload: unknown; id?: string }>\n  sessionId?: string\n}\n\nexport type SocketPresenceFrame = {\n  kind: 'presence'\n  participant: string\n  values: Record<string, unknown>\n  seen?: number\n  at?: number\n  sessionId?: string\n}\n\n/** Open per-session lanes on a multiplexed socket. `index` is each\n * session's exclusive resume frontier — `stream({ startAfter })`. */\nexport type SocketSubscribeFrame = {\n  kind: 'subscribe'\n  sessions: Array<{ id: string; index: number }>\n}\n\nexport type SocketUnsubscribeFrame = {\n  kind: 'unsubscribe'\n  sessions: string[]\n}\n\nexport type SocketUpFrame =\n  | SocketPushFrame\n  | SocketPresenceFrame\n  | SocketSubscribeFrame\n  | SocketUnsubscribeFrame\n\nexport const SOCKET_PING_FRAME: string = JSON.stringify({ kind: 'ping' })\n\n/** One stream item as a socket frame — `sseResponse`'s framing over\n * the same codecs, with `kind` instead of an SSE event name. On a\n * multiplexed socket presence frames carry the `sessionId` tag; events\n * already carry theirs in the wire event. */\nexport function socketFrameFor(\n  item: Event | PresencePatch | PresenceSnapshot,\n  sessionId?: string,\n): string {\n  const tag = sessionId === undefined ? {} : { sessionId }\n  if ('snapshot' in item) {\n    return JSON.stringify({\n      kind: 'presence-snapshot',\n      ...presenceSnapshotToWire(item),\n      ...tag,\n    })\n  }\n  if ('participant' in item) {\n    return JSON.stringify({\n      kind: 'presence',\n      ...presencePatchToWire(item),\n      ...tag,\n    })\n  }\n  return JSON.stringify({ kind: 'event', ...eventToWire(item) })\n}\n\nexport function socketAckFor(\n  req: number,\n  events: Event[],\n  sessionId?: string,\n): string {\n  return JSON.stringify({\n    kind: 'ack',\n    req,\n    events: events.map(eventToWire),\n    ...(sessionId === undefined ? {} : { sessionId }),\n  })\n}\n\nexport function socketErrorAckFor(\n  req: number,\n  error: A2Error,\n  sessionId?: string,\n): string {\n  return JSON.stringify({\n    kind: 'ack',\n    req,\n    ...errorToWire(error),\n    ...(sessionId === undefined ? {} : { sessionId }),\n  })\n}\n\nexport function socketSubscribedFor(sessionId: string): string {\n  return JSON.stringify({ kind: 'subscribed', sessionId })\n}\n\n/** The subscription-over notice: with a `reason` the server rejected\n * or lost the session's stream, without one it ended cleanly. */\nexport function socketUnsubscribedFor(\n  sessionId: string,\n  reason?: string,\n): string {\n  return JSON.stringify({\n    kind: 'unsubscribed',\n    sessionId,\n    ...(reason === undefined ? {} : { reason }),\n  })\n}\n\nexport function parseSocketFrame(data: string): SocketDownFrame | null {\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(data)\n  } catch {\n    return null\n  }\n  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    return null\n  }\n  const frame = parsed as Record<string, unknown>\n  switch (frame['kind']) {\n    case 'ping':\n      return { kind: 'ping' }\n    case 'event': {\n      if (!isWireEvent(parsed)) return null\n      const { id, type, payload, index, sessionId, createdAt } = parsed\n      return {\n        kind: 'event',\n        event: { id, type, payload, index, sessionId, createdAt },\n      }\n    }\n    case 'presence': {\n      if (!isWirePresencePatch(parsed)) return null\n      const { participant, values, seen, at } = parsed\n      return {\n        kind: 'presence',\n        patch: { participant, values, seen, at },\n        ...sessionTag(frame),\n      }\n    }\n    case 'presence-snapshot': {\n      if (!isWirePresenceSnapshot(parsed)) return null\n      return {\n        kind: 'presence-snapshot',\n        snapshot: { snapshot: parsed.snapshot },\n        ...sessionTag(frame),\n      }\n    }\n    case 'subscribed': {\n      const sessionId = frame['sessionId']\n      if (typeof sessionId !== 'string') return null\n      return { kind: 'subscribed', sessionId }\n    }\n    case 'unsubscribed': {\n      const sessionId = frame['sessionId']\n      if (typeof sessionId !== 'string') return null\n      const reason = frame['reason']\n      return typeof reason === 'string'\n        ? { kind: 'unsubscribed', sessionId, reason }\n        : { kind: 'unsubscribed', sessionId }\n    }\n    case 'ack': {\n      const req = frame['req']\n      if (typeof req !== 'number') return null\n      const tag = sessionTag(frame)\n      const events = frame['events']\n      if (Array.isArray(events) && events.every(isWireEvent)) {\n        return { kind: 'ack', req, events, ...tag }\n      }\n      const error = errorFromWire(parsed)\n      if (error) return { kind: 'ack', req, error, ...tag }\n      // A correlatable ack must never be dropped: its waiter would hang\n      // forever behind a healthy socket (pings keep the watchdog fed).\n      // An outcome this client cannot interpret — an error code from a\n      // newer server, an event shape that fails a guard — degrades to\n      // a lost ack: retryable, and the client-generated ids make the\n      // retry idempotent even if the append actually committed.\n      return {\n        kind: 'ack',\n        req,\n        error: new A2Error('STORE_UNAVAILABLE', 'unintelligible ack'),\n        ...tag,\n      }\n    }\n    default:\n      return null\n  }\n}\n\nconst sessionTag = (frame: Record<string, unknown>): { sessionId?: string } => {\n  const sessionId = frame['sessionId']\n  return typeof sessionId === 'string' ? { sessionId } : {}\n}\n"],"mappings":"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"}

package/docs/concepts/02-handlers.mdx

@@ -66,6 +66,10 @@ when a process dies between the claim and handler entry.
 `ctx.session.id` is the same value as `ctx.event.sessionId`. Use
 `ctx.session.history()` when a handler needs raw facts. Use
 [`state()`](/concepts/state) for a cached computed view of a long session.
+The handler-scoped state read folds through `ctx.event.index` by default, so
+later concurrent appends do not change what that event sees. Use
+`ctx.session.state(reducer, { through: 'latest' })` when the handler
+intentionally joins against the current committed frontier.
 
 ## Return what happens after success