experimental-a2 0.16.1 → 0.18.0

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_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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"}
+{"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, supersededAttemptError } from './errors.ts'\nimport { CLEAR_EVENT_TYPE, sessionClearedError } from './session-clear.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_clears (\n  session_id  text    not null primary key,\n  clear_index integer not null\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 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  clear_index: number | bigint | null\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\nconst RECLAIM_BATCH = 256\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                   and idx > ?\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             and idx > ?\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 and idx > ?\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                  and pending.idx > ?\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 selectClearIndex = db.prepare(\n    'select clear_index from a2_clears where session_id = ?',\n  )\n  const clearIndexOf = (sessionId: string): number =>\n    Number(\n      (\n        selectClearIndex.get(sessionId) as\n          { clear_index: number | bigint } | undefined\n      )?.clear_index ?? 0,\n    )\n  const deleteEventById = db.prepare(\n    'delete from a2_events where session_id = ? and event_id = ?',\n  )\n\n  /**\n   * The rows owning `ids`. This session's rows below its clear marker do\n   * not own their ids: they are deleted here so the ids can be reused.\n   */\n  const liveOwnersOf = (\n    sessionId: string,\n    clearIndex: number,\n    ids: readonly string[],\n  ): ExistingEventRow[] => {\n    if (ids.length === 0) return []\n    const rows = selectByIds(ids.length).all(\n      sessionId,\n      clearIndex,\n      ...ids,\n    ) as unknown as ExistingEventRow[]\n    return rows.filter((row) => {\n      if (row.session_id !== sessionId || Number(row.idx) >= clearIndex)\n        return true\n      deleteEventById.run(sessionId, row.event_id)\n      return false\n    })\n  }\n\n  const selectCauseParent = db.prepare(\n    'select attempt_count, failed_at from a2_events where session_id = ? and idx = ?',\n  )\n  /** The attempt-currency fence shared by handler appends and clears. */\n  const assertCurrentCause = ({\n    sessionId,\n    cause,\n    clearIndex,\n  }: {\n    sessionId: string\n    cause: EventCause\n    clearIndex: number\n  }): void => {\n    if (cause.index <= clearIndex)\n      throw supersededAttemptError(sessionId, cause)\n    const parent = selectCauseParent.get(sessionId, cause.index) as\n      { attempt_count: number | bigint; failed_at: unknown } | undefined\n    if (!parent) {\n      throw new TypeError(\n        `no event at index ${cause.index} in session '${sessionId}'`,\n      )\n    }\n    if (\n      Number(parent.attempt_count) !== cause.attempt ||\n      parent.failed_at !== null\n    ) {\n      throw supersededAttemptError(sessionId, cause)\n    }\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, appendOptions) {\n      if (events.length === 0) {\n        return wrap(() => {\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n            clearIndexOf(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 clearIndex = clearIndexOf(sessionId)\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 = liveOwnersOf(sessionId, clearIndex, suppliedIds)\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          const originIndex = appendOptions?.originIndex\n          if (originIndex !== undefined && originIndex <= clearIndex) {\n            throw sessionClearedError(\n              `scheduled work from event ${originIndex} was cleared in session '${sessionId}'`,\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)\n              assertCurrentCause({ sessionId, cause: e.cause, clearIndex })\n          }\n\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n            clearIndex,\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              clearIndex,\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        // Reads start at the latest clear marker.\n        const conditions = [\n          'session_id = ?',\n          'idx >= coalesce((select clear_index from a2_clears where session_id = ?), 0)',\n        ]\n        const params: (string | number)[] = [sessionId, 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 clearIndex = clearIndexOf(sessionId)\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.idx > ?\n                  and (event.claim_expires_at is null or event.claim_expires_at <= ?)\n                  ${exclusion}\n                order by event.idx`,\n            )\n            .all(\n              sessionId,\n              clearIndex,\n              now,\n              ...excludeIndexes,\n            ) 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              const stored = toStored(claimed)\n              if (clearIndex > 0) stored.clearIndex = clearIndex\n              return stored\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 idx > ?\n                  and claim_expires_at > ?`,\n            )\n            .get(sessionId, clearIndex, 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          const clearIndex = clearIndexOf(sessionId)\n          for (const claim of claims) {\n            if (claim.index <= clearIndex) {\n              superseded.push(claim.index)\n              continue\n            }\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 clearIndex = clearIndexOf(sessionId)\n          if (index <= clearIndex) return { outcome: 'superseded' }\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                    clearIndex,\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 (liveOwnersOf(sessionId, clearIndex, ids).length > 0) {\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            clearIndex,\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, clearIndex)\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              clearIndex,\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          if (index <= clearIndexOf(sessionId)) {\n            return { outcome: 'superseded', failureCount: 0 }\n          }\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 deadLetters(sessionId) {\n      return wrap(() => {\n        const rows = db\n          .prepare(\n            `select * from a2_events\n              where session_id = ?\n                and processed_at is null\n                and failed_at is not null\n                and idx > coalesce(\n                  (select clear_index from a2_clears where session_id = ?), 0\n                )\n              order by idx`,\n          )\n          .all(sessionId, sessionId) as unknown as EventRow[]\n        return rows.map(toStored)\n      })\n    },\n\n    async redrive({ sessionId, index, action }) {\n      return wrap(() =>\n        tx(() => {\n          const clearIndex = clearIndexOf(sessionId)\n          const row =\n            index > clearIndex\n              ? (db\n                  .prepare(\n                    'select lane, processed_at, failed_at from a2_events where session_id = ? and idx = ?',\n                  )\n                  .get(sessionId, index) as\n                  | Pick<EventRow, 'lane' | 'processed_at' | 'failed_at'>\n                  | undefined)\n              : undefined\n          const redriven =\n            row !== undefined &&\n            row.processed_at === null &&\n            row.failed_at !== null\n          if (redriven && action === 'skip') {\n            db.prepare(\n              `update a2_events set processed_at = ?, lane_ready = 0\n                where session_id = ? and idx = ?`,\n            ).run(clock.now().getTime(), sessionId, index)\n            if (row.lane !== null) {\n              promoteLaneHead.run(sessionId, sessionId, row.lane, clearIndex)\n            }\n          } else if (redriven) {\n            db.prepare(\n              `update a2_events set failed_at = null, failure_count = 0\n                where session_id = ? and idx = ?`,\n            ).run(sessionId, index)\n          }\n          const status = appendStatus.get(\n            sessionId,\n            sessionId,\n            clearIndex,\n          ) as AppendStatusRow\n          return { redriven, hasPending: Number(status.has_pending) === 1 }\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 boundary as materialized (\n             select coalesce(\n               (select clear_index from a2_clears where session_id = ?), 0\n             ) as clear_index\n           ), head as materialized (\n             select up_to_index, state, updated_at\n               from a2_snapshots\n              where session_id = ? and reducer_name = ?\n                and up_to_index >= (select clear_index from boundary)\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 up_to_index >= (select clear_index from boundary)\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 clear_index from boundary) as clear_index,\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                    null as clear_index,\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 > max(\n                 coalesce((select up_to_index from snapshot), 0),\n                 (select clear_index from boundary) - 1\n               )\n               and (? is null or event.idx <= ?)\n             order by row_order, idx`,\n          )\n          .all(\n            sessionId,\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        const clearIndex = Number(snapshot?.clear_index ?? 0)\n        return {\n          ...(clearIndex > 0 ? { clearIndex } : {}),\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 = ? 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          const clearIndex = clearIndexOf(sessionId)\n          for (const write of writes.toSorted((a, b) => a.index - b.index)) {\n            // A fold from before the latest clear describes a lifetime that is gone.\n            if (write.index < clearIndex) continue\n            for (const eventIndex of write.pinEventIndexes ?? []) {\n              if (unfinished.get(sessionId, eventIndex, clearIndex)) {\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                Number(head.up_to_index) >= clearIndex &&\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          // A cursor below the latest marker resumes at it.\n          const rows = db\n            .prepare(\n              `select * from a2_events\n                where session_id = ? and idx > ?\n                  and idx >= coalesce((select clear_index from a2_clears where session_id = ?), 0)\n                order by idx`,\n            )\n            .all(sessionId, afterIndex, sessionId) 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    async clear({ sessionId, ifLastIndex, cause }) {\n      return wrap(() =>\n        tx(() => {\n          const clearIndex = clearIndexOf(sessionId)\n          if (cause) assertCurrentCause({ sessionId, cause, clearIndex })\n          const head = Number(\n            (\n              appendStatus.get(\n                sessionId,\n                sessionId,\n                clearIndex,\n              ) as AppendStatusRow\n            ).max,\n          )\n          if (ifLastIndex !== undefined && clearIndex === ifLastIndex + 1) {\n            return { cleared: true, index: head, clearIndex }\n          }\n          if (ifLastIndex !== undefined && ifLastIndex !== head) {\n            return { cleared: false, index: head, clearIndex }\n          }\n          if (head === 0 || clearIndex === head) {\n            return { cleared: true, index: head, clearIndex }\n          }\n          const marker = head + 1\n          const now = clock.now().getTime()\n          insertEvent.run(\n            sessionId,\n            marker,\n            CLEAR_EVENT_TYPE,\n            'null',\n            generateId(),\n            now,\n            null,\n            null,\n            null,\n            sessionId,\n            null,\n            clearIndex,\n            now,\n          )\n          db.prepare(\n            `insert into a2_clears (session_id, clear_index) values (?, ?)\n             on conflict (session_id) do update set clear_index = excluded.clear_index`,\n          ).run(sessionId, marker)\n          return { cleared: true, index: marker, clearIndex: marker }\n        }),\n      )\n    },\n\n    async reclaim(sessionId) {\n      return wrap(() =>\n        tx(() => {\n          const clearIndex = clearIndexOf(sessionId)\n          if (clearIndex === 0) return { deleted: 0, done: true }\n          const last = db\n            .prepare(\n              `select max(idx) as last from (\n                 select idx from a2_events\n                  where session_id = ? and idx < ?\n                  order by idx limit ?\n               )`,\n            )\n            .get(sessionId, clearIndex, RECLAIM_BATCH) as {\n            last: number | bigint | null\n          }\n          let deleted = 0\n          if (last.last !== null) {\n            const through = Number(last.last)\n            deleted = Number(\n              db\n                .prepare(\n                  'delete from a2_events where session_id = ? and idx <= ?',\n                )\n                .run(sessionId, through).changes,\n            )\n            db.prepare(\n              'delete from a2_snapshot_pins where session_id = ? and event_index <= ?',\n            ).run(sessionId, through)\n          }\n          const done =\n            db\n              .prepare(\n                'select 1 from a2_events where session_id = ? and idx < ? limit 1',\n              )\n              .get(sessionId, clearIndex) === undefined\n          // Writes serialize with the clear, so none lands below the marker later.\n          if (done) {\n            for (const table of [\n              'a2_snapshot_pins',\n              'a2_snapshot_history',\n              'a2_snapshots',\n            ]) {\n              db.prepare(\n                `delete from ${table} where session_id = ? and up_to_index < ?`,\n              ).run(sessionId, clearIndex)\n            }\n          }\n          return { deleted, done }\n        }),\n      )\n    },\n\n    close() {\n      db.close()\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA+CA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4Ff,MAAM,qBAAqB,OAA2B;CACpD,KAAK,IAAI,UAAU,IAAK,WAAW,GACjC,IAAI;EACF,GAAG,KAAK,2BAA2B;EACnC;CACF,SAAS,KAAK;EAEZ,IAAI,EADU,IAA6B,YAAY,MAC1C,WAAW,KAAK,MAAM;EAEnC,QAAQ,KAAK,IAAI,WAAW,IAAI,kBAAkB,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;CAChE;AAEJ;AAEA,MAAM,QAAW,OAAmB;CAClC,IAAI;EACF,OAAO,GAAG;CACZ,SAAS,KAAK;EACZ,IAAI,eAAe,WAAW,eAAe,WAAW,MAAM;EAC9D,MAAM,IAAI,QAAQ,qBAAqB,iCAAiC,EACtE,OAAO,IACT,CAAC;CACH;AACF;AAEA,MAAM,UAAU,OACd,OAAO,OAAO,OAAO,IAAI,KAAK,OAAO,EAAE,CAAC;AAE1C,MAAM,WAAW,SAA2C;CAC1D,IAAI,SAAS,MAAM,OAAO;CAC1B,MAAM,QAAQ,KAAK,MAAM,IAAI;CAK7B,IACE,CAAC,OAAO,UAAU,MAAM,KAAK,KAC7B,OAAO,MAAM,KAAK,IAAI,KACtB,CAAC,OAAO,UAAU,MAAM,OAAO,KAC/B,OAAO,MAAM,OAAO,IAAI,GAExB,MAAM,IAAI,UAAU,mCAAmC;CAEzD,IACE,MAAM,cAAc,KAAA,MACnB,CAAC,OAAO,UAAU,MAAM,SAAS,KAAK,OAAO,MAAM,SAAS,IAAI,IAEjE,MAAM,IAAI,UAAU,mCAAmC;CAEzD,OAAO;EACL,OAAO,OAAO,MAAM,KAAK;EACzB,SAAS,OAAO,MAAM,OAAO;EAC7B,GAAI,MAAM,cAAc,KAAA,IACpB,CAAC,IACD,EAAE,WAAW,OAAO,MAAM,SAAS,EAAE;CAC3C;AACF;AAEA,MAAM,YAAY,SAAgC;CAChD,IAAI,IAAI;CACR,MAAM,IAAI;CACV,SAAS,KAAK,MAAM,IAAI,OAAO;CAC/B,OAAO,OAAO,IAAI,GAAG;CACrB,WAAW,IAAI;CACf,WAAW,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC;CAC1C,OAAO,QAAQ,IAAI,KAAK;CACxB,MAAM,IAAI;CACV,aAAa,OAAO,IAAI,YAAY;CACpC,oBACE,IAAI,yBAAyB,OAAO,OAAO,OAAO,IAAI,oBAAoB;CAC5E,kBACE,IAAI,uBAAuB,OACvB,OACA,uBAAuB,IAAI,kBAAkB;CACnD,gBAAgB,OAAO,IAAI,gBAAgB;CAC3C,eAAe,OAAO,IAAI,eAAe;CACzC,cAAc,OAAO,IAAI,aAAa;CACtC,cAAc,OAAO,IAAI,aAAa;CACtC,cAAc,OAAO,IAAI,cAAc;CACvC,mBACE,IAAI,wBAAwB,OAAO,OAAO,OAAO,IAAI,mBAAmB;CAC1E,WAAW,IAAI;CACf,UAAU,OAAO,IAAI,SAAS;CAC9B,aAAa,IAAI;CACjB,gBAAgB,OAAO,IAAI,gBAAgB;AAC7C;AAEA,MAAM,WAAW,SAA0B;CACzC,IAAI,IAAI;CACR,MAAM,IAAI;CACV,SAAS,KAAK,MAAM,IAAI,OAAO;CAC/B,OAAO,OAAO,IAAI,GAAG;CACrB,WAAW,IAAI;CACf,WAAW,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC;AAC5C;AA0DA,MAAM,gBAAgB;AAEtB,SAAgB,OAAO,UAA8B,CAAC,GAAgB;CACpE,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,aAAa,QAAQ,OAAO;CAElC,IAAI,SAAS,YAIX,UAAU,QAAQ;;EAAoC;CAAI,CAAC,GAAG,EAC5D,WAAW,KACb,CAAC;CAEH,MAAM,KAAK,IAAI,aAAa,IAAI;CAIhC,GAAG,KAAK,4BAA4B;CACpC,kBAAkB,EAAE;CACpB,GAAG,KAAK,6BAA6B;CACrC,GAAG,KAAK,MAAM;CAEd,MAAM,cAAc,GAAG,QACrB;;;;;;;;;;;;;cAcF;CACA,MAAM,kBAAkB,GAAG,QACzB;;;;;;;UAQF;CACA,MAAM,eAAe,GAAG,QACtB;;;;;;;6BAQF;CACA,MAAM,iBAAiB,GAAG,QACxB;;;;;;;yCAQF;CACA,MAAM,iBAAiB,GAAG,QACxB;iEAEF;CACA,MAAM,gBAAgB,GAAG,QACvB,0DACF;CACA,MAAM,iBAAiB,GAAG,QACxB;;;kCAIF;CACA,MAAM,eAAe,UACnB,GAAG,QACD;;;;;;;;oCAQ8B,MAAM,KAAK,EAAE,QAAQ,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE;4BAEpF;CAEF,MAAM,mBAAmB,GAAG,QAC1B,wDACF;CACA,MAAM,gBAAgB,cACpB,OAEI,iBAAiB,IAAI,SAAS,CAAC,EAE9B,eAAe,CACpB;CACF,MAAM,kBAAkB,GAAG,QACzB,6DACF;;;;;CAMA,MAAM,gBACJ,WACA,YACA,QACuB;EACvB,IAAI,IAAI,WAAW,GAAG,OAAO,CAAC;EAM9B,OALa,YAAY,IAAI,MAAM,CAAC,CAAC,IACnC,WACA,YACA,GAAG,GAEK,CAAC,CAAC,QAAQ,QAAQ;GAC1B,IAAI,IAAI,eAAe,aAAa,OAAO,IAAI,GAAG,KAAK,YACrD,OAAO;GACT,gBAAgB,IAAI,WAAW,IAAI,QAAQ;GAC3C,OAAO;EACT,CAAC;CACH;CAEA,MAAM,oBAAoB,GAAG,QAC3B,iFACF;;CAEA,MAAM,sBAAsB,EAC1B,WACA,OACA,iBAKU;EACV,IAAI,MAAM,SAAS,YACjB,MAAM,uBAAuB,WAAW,KAAK;EAC/C,MAAM,SAAS,kBAAkB,IAAI,WAAW,MAAM,KAAK;EAE3D,IAAI,CAAC,QACH,MAAM,IAAI,UACR,qBAAqB,MAAM,MAAM,eAAe,UAAU,EAC5D;EAEF,IACE,OAAO,OAAO,aAAa,MAAM,MAAM,WACvC,OAAO,cAAc,MAErB,MAAM,uBAAuB,WAAW,KAAK;CAEjD;CAEA,MAAM,MAAS,OAAmB;EAChC,GAAG,KAAK,iBAAiB;EACzB,IAAI;GACF,MAAM,SAAS,GAAG;GAClB,GAAG,KAAK,QAAQ;GAChB,OAAO;EACT,SAAS,KAAK;GACZ,IAAI;IACF,GAAG,KAAK,UAAU;GACpB,QAAQ,CAGR;GACA,MAAM;EACR;CACF;CAEA,OAAO;EACL,MAAM,OAAO,WAAW,QAAQ,eAAe;GAC7C,IAAI,OAAO,WAAW,GACpB,OAAO,WAAW;IAChB,MAAM,SAAS,aAAa,IAC1B,WACA,WACA,aAAa,SAAS,CACxB;IACA,OAAO;KACL,QAAQ,CAAC;KACT,YAAY,OAAO,OAAO,WAAW,MAAM;IAC7C;GACF,CAAC;GAEH,OAAO,WACL,SAAS;IACP,MAAM,aAAa,aAAa,SAAS;IAEzC,MAAM,cADW,OAAO,QAAQ,MAAM,EAAE,OAAO,KAAA,CACpB,CAAC,CAAC,KAAK,MAAM,EAAE,EAAY;IACtD,IAAI,IAAI,IAAI,WAAW,CAAC,CAAC,SAAS,YAAY,QAC5C,MAAM,IAAI,QACR,2BACA,iDACF;IAEF,IAAI,YAAY,SAAS,GAAG;KAC1B,MAAM,WAAW,aAAa,WAAW,YAAY,WAAW;KAChE,IAAI,SAAS,SAAS,GAAG;MACvB,MAAM,UAAU,SAAS,MACtB,QAAQ,IAAI,eAAe,SAC9B;MACA,IAAI,SACF,MAAM,IAAI,QACR,2BACA,aAAa,QAAQ,SAAS,oCAChC;MAEF,IAAI,SAAS,WAAW,OAAO,QAC7B,OAAO;OACL,QAAQ,iBAAiB,QAAQ,SAAS,IAAI,QAAQ,CAAC;OACvD,YAAY,OAAO,SAAS,EAAE,CAAE,mBAAmB,MAAM;MAC3D;MAEF,MAAM,IAAI,QACR,2BACA,eAAe,SAAS,OAAO,wBAAwB,OAAO,SAAS,SAAS,OAAO,cACzF;KACF;IACF;IAEA,MAAM,cAAc,eAAe;IACnC,IAAI,gBAAgB,KAAA,KAAa,eAAe,YAC9C,MAAM,oBACJ,6BAA6B,YAAY,2BAA2B,UAAU,EAChF;IAMF,KAAK,MAAM,KAAK,QACd,IAAI,EAAE,OACJ,mBAAmB;KAAE;KAAW,OAAO,EAAE;KAAO;IAAW,CAAC;IAGhE,MAAM,SAAS,aAAa,IAC1B,WACA,WACA,UACF;IACA,MAAM,OAAO,OAAO,OAAO,GAAG;IAC9B,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;IA2ChC,OAAO;KACL,QA3C8B,OAAO,KAAK,GAAG,MAAM;MACnD,MAAM,KAAK,EAAE,MAAM,WAAW;MAC9B,MAAM,QAAQ,OAAO,IAAI;MACzB,YAAY,IACV,WACA,OACA,EAAE,MACF,KAAK,UAAU,EAAE,OAAO,KAAK,QAC7B,IACA,KACA,EAAE,QAAQ,KAAK,UAAU,EAAE,KAAK,IAAI,MACpC,EAAE,QAAQ,MACV,EAAE,QAAQ,MACV,WACA,EAAE,QAAQ,MACV,YACA,EAAE,UAAU,MAAM,IACpB;MACA,OAAO;OACL;OACA,MAAM,EAAE;OACR,SAAS,gBAAgB,EAAE,OAAO;OAClC;OACA;OACA,WAAW,IAAI,KAAK,GAAG;OACvB,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,IAAI;OAClC,MAAM,EAAE,QAAQ;OAChB,aAAa,EAAE,UAAU,IAAI,KAAK,GAAG,IAAI;OACzC,oBAAoB;OACpB,kBAAkB;OAClB,gBAAgB;OAChB,eAAe;OACf,cAAc;OACd,cAAc;OACd,cAAc;OACd,mBAAmB;OACnB,WAAW;OACX,UAAU;OACV,aAAa;OACb,gBAAgB;MAClB;KACF,CAEiB;KACf,YACE,OAAO,OAAO,WAAW,MAAM,KAC/B,OAAO,MAAM,UAAU,MAAM,YAAY,IAAI;IACjD;GACF,CAAC,CACH;EACF;EAEA,MAAM,KAAK,WAAW,MAAM;GAC1B,OAAO,WAAW;IAEhB,MAAM,aAAa,CACjB,kBACA,8EACF;IACA,MAAM,SAA8B,CAAC,WAAW,SAAS;IACzD,IAAI,MAAM,eAAe,KAAA,GAAW;KAClC,WAAW,KAAK,SAAS;KACzB,OAAO,KAAK,KAAK,UAAU;IAC7B;IACA,IAAI,MAAM,iBAAiB,KAAA,GAAW;KACpC,WAAW,KAAK,UAAU;KAC1B,OAAO,KAAK,KAAK,YAAY;IAC/B;IAMA,OALa,GACV,QACC,iCAAiC,WAAW,KAAK,OAAO,EAAE,cAC5D,CAAC,CACA,IAAI,GAAG,MACA,CAAC,CAAC,IAAI,QAAQ;GAC1B,CAAC;EACH;EAEA,MAAM,eAAe,EACnB,WACA,QACA,OACA,aACA,iBAAiB,CAAC,KACjB;GACD,OAAO,WACL,SAAS;IACP,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;IAChC,MAAM,YAAY,eAAe,MAAM;IACvC,MAAM,aAAa,aAAa,SAAS;IACzC,MAAM,YACJ,eAAe,WAAW,IACtB,KACA,yBAAyB,eAAe,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE;IACxE,MAAM,WAAW,GACd,QACC;;;;;;;;oBAQM,UAAU;mCAElB,CAAC,CACA,IACC,WACA,YACA,KACA,GAAG,cACL;IAGF,IAAI,SAAS,SAAS,GAAG;KACvB,MAAM,SAAS,GAAG,QAChB;;;;;;;2BAQF;KAcA,OAAO;MAAE,SAAS;MAAW,QAbd,SAAS,KAAK,QAAQ;OACnC,MAAM,UAAU,OAAO,IACrB,KACA,KACA,QACA,WACA,WACA,IAAI,GACN;OACA,MAAM,SAAS,SAAS,OAAO;OAC/B,IAAI,aAAa,GAAG,OAAO,aAAa;OACxC,OAAO;MACT,CACkC;KAAE;IACtC;IAEA,MAAM,SAAS,GACZ,QACC;;;;;;;2CAQF,CAAC,CACA,IAAI,WAAW,YAAY,GAAG;IAGjC,OAAO,OAAO,aAAa,OACvB,EAAE,SAAS,UAAU,IACrB;KAAE,SAAS;KAAQ,SAAS,IAAI,KAAK,OAAO,OAAO,QAAQ,CAAC;IAAE;GACpE,CAAC,CACH;EACF;EAEA,MAAM,YAAY,EAAE,WAAW,QAAQ,QAAQ,OAAO,eAAe;GACnE,IAAI,OAAO,WAAW,GAAG,OAAO;IAAE,SAAS,CAAC;IAAG,YAAY,CAAC;GAAE;GAC9D,OAAO,WACL,SAAS;IACP,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;IAChC,MAAM,YAAY,eAAe,MAAM;IACvC,MAAM,UAAoB,CAAC;IAC3B,MAAM,aAAuB,CAAC;IAC9B,MAAM,iBAAiB,GAAG,QACxB,sEACF;IACA,MAAM,SAAS,GAAG,QAChB;;;;;;;yCAQF;IACA,MAAM,aAAa,aAAa,SAAS;IACzC,KAAK,MAAM,SAAS,QAAQ;KAC1B,IAAI,MAAM,SAAS,YAAY;MAC7B,WAAW,KAAK,MAAM,KAAK;MAC3B;KACF;KACA,MAAM,MAAM,eAAe,IAAI,WAAW,MAAM,KAAK;KAErD,IAAI,CAAC,KAAK;KACV,IAAI,OAAO,IAAI,aAAa,IAAI,MAAM,SAAS;MAC7C,WAAW,KAAK,MAAM,KAAK;MAC3B;KACF;KACA,MAAM,UAAU,OAAO,IACrB,WACA,WACA,MAAM,OACN,MAAM,SACN,QACA,GACF;KACA,IAAI,OAAO,QAAQ,OAAO,MAAM,GAAG,QAAQ,KAAK,MAAM,KAAK;IAC7D;IACA,OAAO;KACL,SAAS,QAAQ,UAAU,GAAG,MAAM,IAAI,CAAC;KACzC,YAAY,WAAW,UAAU,GAAG,MAAM,IAAI,CAAC;IACjD;GACF,CAAC,CACH;EACF;EAEA,MAAM,gBAAgB,EAAE,WAAW,OAAO,SAAS,UAAU;GAC3D,OAAO,WACL,SAAS;IACP,MAAM,aAAa,aAAa,SAAS;IACzC,IAAI,SAAS,YAAY,OAAO,EAAE,SAAS,aAAa;IACxD,MAAM,SAAS,GACZ,QAAQ,0DAA0D,CAAC,CACnE,IAAI,WAAW,KAAK;IACvB,IAAI,CAAC,QACH,MAAM,IAAI,UACR,qBAAqB,MAAM,eAAe,UAAU,EACtD;IAEF,MAAM,MAAM,OAAO,KAAK,UAAU,MAAM,EAAE;IAC1C,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,QAC5B,MAAM,IAAI,QACR,2BACA,gEACF;IAGF,IAAI,OAAO,iBAAiB,MAAM;KAChC,IAAI,OAAO,OAAO,oBAAoB,MAAM,SAC1C,OAAO,EAAE,SAAS,aAAa;KAEjC,MAAM,cACJ,OAAO,uBAAuB,OAC1B,OACA,uBAAuB,OAAO,kBAAkB;KACtD,IACE,gBAAgB,QAChB,YAAY,WAAW,IAAI,UAC3B,YAAY,MAAM,IAAI,WAAW,OAAO,IAAI,OAAO,GAEnD,MAAM,IAAI,QACR,2BACA,2DACF;KAEF,MAAM,WACJ,IAAI,WAAW,IACX,CAAC,IACA,YAAY,IAAI,MAAM,CAAC,CAAC,IACvB,WACA,YACA,GAAG,GACL;KACN,MAAM,OAAO,IAAI,IAAI,SAAS,KAAK,QAAQ,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC;KAC/D,MAAM,UAAU,IAAI,KAAK,OAAO,KAAK,IAAI,EAAE,CAAC;KAC5C,IACE,QAAQ,MACL,QACC,CAAC,OACD,IAAI,eAAe,aACnB,IAAI,UAAU,QACd,QAAQ,IAAI,KAAK,CAAC,EAAE,UAAU,SAC9B,QAAQ,IAAI,KAAK,CAAC,EAAE,YAAY,OACpC,GAEA,MAAM,IAAI,QACR,2BACA,yDACF;KAEF,OAAO;MACL,SAAS;MACT,QAAQ,iBACN,QACC,QAA+B,IAAI,QAAQ,CAC9C;KACF;IACF;IACA,IACE,OAAO,OAAO,aAAa,MAAM,WACjC,OAAO,iBAAiB,QACxB,OAAO,cAAc,MAErB,OAAO,EAAE,SAAS,aAAa;IAGjC,IAAI,aAAa,WAAW,YAAY,GAAG,CAAC,CAAC,SAAS,GACpD,MAAM,IAAI,QACR,2BACA,4DACF;IAGF,MAAM,SAAS,aAAa,IAC1B,WACA,WACA,UACF;IACA,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;IAChC,GAAG,QACD;;;;;;;8CAQF,CAAC,CAAC,IAAI,KAAK,SAAS,KAAK,UAAU,GAAG,GAAG,WAAW,KAAK;IACzD,GAAG,QACD,uEACF,CAAC,CAAC,IAAI,WAAW,KAAK;IACtB,GAAG,QACD;;;;;;;kBAQF,CAAC,CAAC,IAAI,SAAS;IACf,IAAI,OAAO,SAAS,MAClB,gBAAgB,IAAI,WAAW,WAAW,OAAO,MAAM,UAAU;IA6BnE,OAAO;KAAE,SAAS;KAAa,QA3Bd,OAAO,KAAK,OAAO,WAAW;MAC7C,MAAM,KAAK,MAAM;MACjB,MAAM,aAAa,OAAO,OAAO,GAAG,IAAI,SAAS;MACjD,MAAM,QAAQ;OAAE;OAAO;MAAQ;MAC/B,YAAY,IACV,WACA,YACA,MAAM,MACN,KAAK,UAAU,MAAM,OAAO,KAAK,QACjC,IACA,KACA,KAAK,UAAU,KAAK,GACpB,MAAM,QAAQ,MACd,MAAM,QAAQ,MACd,WACA,MAAM,QAAQ,MACd,YACA,MAAM,UAAU,MAAM,IACxB;MACA,OAAO,SACL,GACG,QACC,0DACF,CAAC,CACA,IAAI,WAAW,UAAU,CAC9B;KACF,CAC8C;IAAE;GAClD,CAAC,CACH;EACF;EAEA,MAAM,YAAY,EAAE,WAAW,OAAO,SAAS,OAAO,eAAe;GACnE,OAAO,WACL,SAAS;IACP,IAAI,SAAS,aAAa,SAAS,GACjC,OAAO;KAAE,SAAS;KAAc,cAAc;IAAE;IAElD,MAAM,UAAU,GACb,QAAQ,0DAA0D,CAAC,CACnE,IAAI,WAAW,KAAK;IACvB,IAAI,CAAC,SACH,MAAM,IAAI,UACR,qBAAqB,MAAM,eAAe,UAAU,EACtD;IAEF,MAAM,eAAe,OAAO,QAAQ,aAAa;IACjD,IACE,QAAQ,iBAAiB,QACzB,OAAO,QAAQ,aAAa,MAAM,SAElC,OAAO;KAAE,SAAS;KAAc;IAAa;IAE/C,IAAI,QAAQ,cAAc,MACxB,OAAO;KAAE,SAAS;KAAiB;IAAa;IAElD,IACE,QAAQ,iBAAiB,QACzB,QAAQ,wBAAwB,QAChC,OAAO,QAAQ,mBAAmB,MAAM,SAExC,OAAO;KAAE,SAAS;KAAU;IAAa;IAE3C,IAAI,QAAQ,iBAAiB,MAC3B,OAAO;KAAE,SAAS;KAAc;IAAa;IAG/C,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;IAChC,MAAM,mBAAmB,eAAe;IACxC,MAAM,eAAe,oBAAoB;IACzC,GAAG,QACD;;;;;;;;8CASF,CAAC,CAAC,IACA,kBACA,OACA,KACA,SACA,eAAe,MAAM,MACrB,WACA,KACF;IACA,IAAI,cAAc;KAChB,GAAG,QACD,uEACF,CAAC,CAAC,IAAI,WAAW,KAAK;KACtB,GAAG,QACD;;;;;;;oBAQF,CAAC,CAAC,IAAI,SAAS;IACjB;IACA,OAAO;KACL,SAAS,eAAe,kBAAkB;KAC1C,cAAc;IAChB;GACF,CAAC,CACH;EACF;EAEA,MAAM,YAAY,WAAW;GAC3B,OAAO,WAAW;IAahB,OAZa,GACV,QACC;;;;;;;2BAQF,CAAC,CACA,IAAI,WAAW,SACR,CAAC,CAAC,IAAI,QAAQ;GAC1B,CAAC;EACH;EAEA,MAAM,QAAQ,EAAE,WAAW,OAAO,UAAU;GAC1C,OAAO,WACL,SAAS;IACP,MAAM,aAAa,aAAa,SAAS;IACzC,MAAM,MACJ,QAAQ,aACH,GACE,QACC,sFACF,CAAC,CACA,IAAI,WAAW,KAAK,IAGvB,KAAA;IACN,MAAM,WACJ,QAAQ,KAAA,KACR,IAAI,iBAAiB,QACrB,IAAI,cAAc;IACpB,IAAI,YAAY,WAAW,QAAQ;KACjC,GAAG,QACD;iDAEF,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,QAAQ,GAAG,WAAW,KAAK;KAC7C,IAAI,IAAI,SAAS,MACf,gBAAgB,IAAI,WAAW,WAAW,IAAI,MAAM,UAAU;IAElE,OAAO,IAAI,UACT,GAAG,QACD;iDAEF,CAAC,CAAC,IAAI,WAAW,KAAK;IAExB,MAAM,SAAS,aAAa,IAC1B,WACA,WACA,UACF;IACA,OAAO;KAAE;KAAU,YAAY,OAAO,OAAO,WAAW,MAAM;IAAE;GAClE,CAAC,CACH;EACF;EAEA,MAAM,UAAU,WAAW,aAAa,cAAc;GACpD,OAAO,WAAW;IAChB,MAAM,eAAe,cAAc,gBAAgB;IACnD,MAAM,uBACJ,cAAc,wBAAwB;IACxC,MAAM,OAAO,GACV,QACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAmDF,CAAC,CACA,IACC,WACA,WACA,aACA,sBACA,sBACA,WACA,aACA,sBACA,sBACA,WACA,cACA,YACF;IACF,MAAM,WAAW,KAAK,MAAM,QAAQ,IAAI,aAAa,UAAU;IAC/D,MAAM,aAAa,OAAO,UAAU,eAAe,CAAC;IACpD,OAAO;KACL,GAAI,aAAa,IAAI,EAAE,WAAW,IAAI,CAAC;KACvC,WACE,UAAU,eAAe,QAAQ,UAAU,eAAe,KAAA,IACtD,OACA,OAAO,SAAS,UAAU;KAChC,UACE,UAAU,mBAAmB,QAC7B,UAAU,mBAAmB,KAAA,IACzB;MACE,OAAO,OAAO,SAAS,cAAc;MACrC,OAAO,KAAK,MAAM,SAAS,cAAe;KAC5C,IACA;KACN,QAAQ,KACL,QACE,QAAwC,IAAI,aAAa,OAC5D,CAAC,CACA,IAAI,OAAO;IAChB;GACF,CAAC;EACH;EAEA,MAAM,aAAa,WAAW,aAAa,QAAQ;GACjD,MAAM,WACJ,SAAS;IACP,MAAM,aAAa,GAAG,QACpB;wDAEF;IACA,MAAM,aAAa,GAAG,QACpB;;+DAGF;IACA,MAAM,YAAY,GAAG,QACnB;;iCAGF;IACA,MAAM,SAAS,GAAG,QAChB;;sBAGF;IACA,MAAM,aAAa,GAAG,QACpB;;;;wEAKF;IACA,MAAM,UAAU,GAAG,QACjB;;;;;;;oEAQF;IACA,MAAM,gBAAgB,GAAG,QACvB;4EAEF;IACA,MAAM,aAAa,aAAa,SAAS;IACzC,KAAK,MAAM,SAAS,OAAO,UAAU,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG;KAEhE,IAAI,MAAM,QAAQ,YAAY;KAC9B,KAAK,MAAM,cAAc,MAAM,mBAAmB,CAAC,GACjD,IAAI,WAAW,IAAI,WAAW,YAAY,UAAU,GAClD,UAAU,IAAI,WAAW,YAAY,aAAa,MAAM,KAAK;KAGjE,MAAM,OAAO,WAAW,IAAI,WAAW,WAAW;KAElD,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;KAChC,IAAI,CAAC,QAAQ,MAAM,SAAS,OAAO,KAAK,WAAW,GAAG;MACpD,IACE,QACA,MAAM,QAAQ,OAAO,KAAK,WAAW,KACrC,OAAO,KAAK,WAAW,KAAK,cAC5B,OAAO,IAAI,WAAW,aAAa,OAAO,KAAK,WAAW,CAAC,GAE3D,WAAW,IACT,WACA,aACA,OAAO,KAAK,WAAW,GACvB,KAAK,OACL,OAAO,KAAK,UAAU,CACxB;MAEF,QAAQ,IACN,WACA,aACA,MAAM,OACN,KAAK,UAAU,MAAM,KAAK,KAAK,QAC/B,GACF;MACA,cAAc,IAAI,WAAW,aAAa,MAAM,KAAK;KACvD,OAAO,IACL,MAAM,QAAQ,OAAO,KAAK,WAAW,KACrC,OAAO,IAAI,WAAW,aAAa,MAAM,KAAK,GAE9C,WAAW,IACT,WACA,aACA,MAAM,OACN,KAAK,UAAU,MAAM,KAAK,KAAK,QAC/B,GACF;IAEJ;GACF,CAAC,CACH;EACF;EAEA,UAAU;GACR,MAAM,IAAI,IAAI,aAAa,QAAQ,MAAM;IACvC,MAAM,UAAU,OAAO,QAAQ,MAAM;IACrC,IAAI,QAAQ,WAAW,GAAG;IAC1B,WACE,SAAS;KACP,MAAM,OAAO,KAAK,GAAG,QAAQ;KAG7B,MAAM,cAAc,MAAM,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK;KACjD,KAAK,MAAM,CAAC,OAAO,UAAU,SAG3B,IAAI,UAAU,MACZ,eAAe,IAAI,IAAI,aAAa,OAAO,IAAI;UAE/C,eAAe,IACb,IACA,aACA,OACA,KAAK,UAAU,KAAK,KAAK,QACzB,KAAK,MACL,MACA,WACF;IAGN,CAAC,CACH;GACF;GAEA,MAAM,KAAK,IAAI;IACb,OAAO,WAAW;KAChB,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;KAGhC,cAAc,IAAI,IAAI,GAAG;KAEzB,OADa,eAAe,IAAI,IAAI,GAC1B,CAAC,CAAC,KAAK,SAAS;MACxB,aAAa,IAAI;MACjB,OAAO,IAAI;MACX,OAAO,KAAK,MAAM,IAAI,KAAK;MAC3B,MAAM,OAAO,IAAI,IAAI;MACrB,IAAI,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC;MAC3B,WAAW,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC;KAC5C,EAAE;IACJ,CAAC;GACH;EACF;EAEA,OAAO,WAAW,MAAM;GACtB,MAAM,aAAa,eACjB,WAAW;IAUT,OARa,GACV,QACC;;;6BAIF,CAAC,CACA,IAAI,WAAW,YAAY,SACpB,CAAC,CAAC,IAAI,QAAQ;GAC1B,CAAC;GACH,OAAO,cACL,WACA,MAAM,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC,CACtE;EACF;EAEA,MAAM,MAAM,EAAE,WAAW,aAAa,SAAS;GAC7C,OAAO,WACL,SAAS;IACP,MAAM,aAAa,aAAa,SAAS;IACzC,IAAI,OAAO,mBAAmB;KAAE;KAAW;KAAO;IAAW,CAAC;IAC9D,MAAM,OAAO,OAET,aAAa,IACX,WACA,WACA,UACF,CAAC,CACD,GACJ;IACA,IAAI,gBAAgB,KAAA,KAAa,eAAe,cAAc,GAC5D,OAAO;KAAE,SAAS;KAAM,OAAO;KAAM;IAAW;IAElD,IAAI,gBAAgB,KAAA,KAAa,gBAAgB,MAC/C,OAAO;KAAE,SAAS;KAAO,OAAO;KAAM;IAAW;IAEnD,IAAI,SAAS,KAAK,eAAe,MAC/B,OAAO;KAAE,SAAS;KAAM,OAAO;KAAM;IAAW;IAElD,MAAM,SAAS,OAAO;IACtB,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ;IAChC,YAAY,IACV,WACA,QACA,kBACA,QACA,WAAW,GACX,KACA,MACA,MACA,MACA,WACA,MACA,YACA,GACF;IACA,GAAG,QACD;uFAEF,CAAC,CAAC,IAAI,WAAW,MAAM;IACvB,OAAO;KAAE,SAAS;KAAM,OAAO;KAAQ,YAAY;IAAO;GAC5D,CAAC,CACH;EACF;EAEA,MAAM,QAAQ,WAAW;GACvB,OAAO,WACL,SAAS;IACP,MAAM,aAAa,aAAa,SAAS;IACzC,IAAI,eAAe,GAAG,OAAO;KAAE,SAAS;KAAG,MAAM;IAAK;IACtD,MAAM,OAAO,GACV,QACC;;;;iBAKF,CAAC,CACA,IAAI,WAAW,YAAY,aAAa;IAG3C,IAAI,UAAU;IACd,IAAI,KAAK,SAAS,MAAM;KACtB,MAAM,UAAU,OAAO,KAAK,IAAI;KAChC,UAAU,OACR,GACG,QACC,yDACF,CAAC,CACA,IAAI,WAAW,OAAO,CAAC,CAAC,OAC7B;KACA,GAAG,QACD,wEACF,CAAC,CAAC,IAAI,WAAW,OAAO;IAC1B;IACA,MAAM,OACJ,GACG,QACC,kEACF,CAAC,CACA,IAAI,WAAW,UAAU,MAAM,KAAA;IAEpC,IAAI,MACF,KAAK,MAAM,SAAS;KAClB;KACA;KACA;IACF,GACE,GAAG,QACD,eAAe,MAAM,0CACvB,CAAC,CAAC,IAAI,WAAW,UAAU;IAG/B,OAAO;KAAE;KAAS;IAAK;GACzB,CAAC,CACH;EACF;EAEA,QAAQ;GACN,GAAG,MAAM;EACX;CACF;AACF"}

package/dist/stream-buffer-Cx7AAPGq.js

@@ -0,0 +1,23 @@
+//#region src/stream-buffer.ts
+const isSerializedEvent = (event) => "payloadJson" in event;
+const parseSerializedEvent = (event) => ({
+	id: event.id,
+	type: event.type,
+	payload: JSON.parse(event.payloadJson),
+	index: event.index,
+	sessionId: event.sessionId,
+	createdAt: new Date(event.createdAtMs)
+});
+/**
+* The next event a stream iterator already holds, removed without
+* awaiting its `next()`, which then continues after it; `undefined` when
+* it holds none. Call only while no `next()` is pending. The SSE encoder
+* writes these with the event `next()` just returned, so a buffered
+* backlog leaves in few writes.
+*/
+const bufferedEvents = /* @__PURE__ */ new WeakMap();
+const takeBuffered = (iterator) => bufferedEvents.get(iterator)?.();
+//#endregion
+export { takeBuffered as i, isSerializedEvent as n, parseSerializedEvent as r, bufferedEvents as t };
+
+//# sourceMappingURL=stream-buffer-Cx7AAPGq.js.map

package/dist/stream-buffer-Cx7AAPGq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-buffer-Cx7AAPGq.js","names":[],"sources":["../src/stream-buffer.ts"],"sourcesContent":["import type { Event } from './store.ts'\n\n/**\n * An event as a store returned it, its payload still the JSON text A2's\n * store wrote with `JSON.stringify`. For payloads built from ordinary objects,\n * parsing and re-serializing that text yields the same text, so the SSE lane\n * can write it into a frame unchanged.\n */\nexport type SerializedEvent = {\n  id: string\n  type: string\n  payloadJson: string\n  index: number\n  sessionId: string\n  createdAtMs: number\n}\n\nexport type HeldEvent = Event | SerializedEvent\n\nexport const isSerializedEvent = (event: object): event is SerializedEvent =>\n  'payloadJson' in event\n\nexport const parseSerializedEvent = (event: SerializedEvent): Event => ({\n  id: event.id,\n  type: event.type,\n  payload: JSON.parse(event.payloadJson),\n  index: event.index,\n  sessionId: event.sessionId,\n  createdAt: new Date(event.createdAtMs),\n})\n\n/**\n * The next event a stream iterator already holds, removed without\n * awaiting its `next()`, which then continues after it; `undefined` when\n * it holds none. Call only while no `next()` is pending. The SSE encoder\n * writes these with the event `next()` just returned, so a buffered\n * backlog leaves in few writes.\n */\nexport const bufferedEvents: WeakMap<object, () => HeldEvent | undefined> =\n  new WeakMap()\n\nexport const takeBuffered = (iterator: object): HeldEvent | undefined =>\n  bufferedEvents.get(iterator)?.()\n"],"mappings":";AAmBA,MAAa,qBAAqB,UAChC,iBAAiB;AAEnB,MAAa,wBAAwB,WAAmC;CACtE,IAAI,MAAM;CACV,MAAM,MAAM;CACZ,SAAS,KAAK,MAAM,MAAM,WAAW;CACrC,OAAO,MAAM;CACb,WAAW,MAAM;CACjB,WAAW,IAAI,KAAK,MAAM,WAAW;AACvC;;;;;;;;AASA,MAAa,iCACX,IAAI,QAAQ;AAEd,MAAa,gBAAgB,aAC3B,eAAe,IAAI,QAAQ,CAAC,GAAG"}

package/dist/{telemetry-B5jzpy6y.d.ts → telemetry-Cyfqo6Qt.d.ts}

@@ -8,7 +8,7 @@
 /** Attribute values a2 emits. */
 type A2AttributeValue = string | number | boolean;
 /** The spans a2 emits today. The catalogue grows with the surface. */
-type A2SpanName = "a2.append" | "a2.drain" | "a2.event" | "a2.state" | "a2.snapshot";
+type A2SpanName = "a2.append" | "a2.drain" | "a2.event" | "a2.claim" | "a2.commit" | "a2.state" | "a2.snapshot" | "a2.redrive" | "a2.ai.control" | "a2.ai.ack" | "a2.ai.generate" | "a2.ai.context" | "a2.ai.compaction" | "a2.ai.tool";
 type A2SpanHandle = {
   /** Attach or update an attribute mid-span (e.g. the outcome). */
   setAttribute(key: string, value: A2AttributeValue): void;
@@ -30,4 +30,4 @@ type A2Telemetry = {
 };
 //#endregion
 export { A2Telemetry as i, A2SpanHandle as n, A2SpanName as r, A2AttributeValue as t };
-//# sourceMappingURL=telemetry-B5jzpy6y.d.ts.map
+//# sourceMappingURL=telemetry-Cyfqo6Qt.d.ts.map

package/dist/telemetry-Cyfqo6Qt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-Cyfqo6Qt.d.ts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;;;;;;KAQY;;KAGA;KAgBA;;EAEV,aAAa,aAAa,OAAO;;;;;;EAMjC,YAAY;;KAGF;;;;;;;EAOV,KAAK,GACH,MAAM,YACN,YAAY,eAAe,mBAC3B,KAAK,MAAM,iBAAiB,QAAQ,KACnC,QAAQ"}

package/dist/{wire-BO5wWCb1.js → wire-rSUglYo8.js}

@@ -1,5 +1,6 @@
-import { t as A2Error } from "./errors-DCk6ch5n.js";
-import { h as nullProtoRecord } from "./internal-Dq2qYxou.js";
+import { i as A2Error } from "./session-clear-DGI4jTQ5.js";
+import { _ as nullProtoRecord } from "./internal-B2T3U4Rq.js";
+import { i as takeBuffered, n as isSerializedEvent } from "./stream-buffer-Cx7AAPGq.js";
 //#region src/wire.ts
 /**
 * The wire format shared by server.fetch and experimental-a2/client
@@ -17,6 +18,87 @@ function eventToWire(event) {
 		createdAt: event.createdAt.toISOString()
 	};
 }
+const lastEncoding = (encode) => {
+	let last;
+	let text = "";
+	return (value) => {
+		if (value !== last) {
+			text = encode(value);
+			last = value;
+		}
+		return text;
+	};
+};
+const isoJson = lastEncoding((ms) => JSON.stringify(new Date(ms).toISOString()));
+const sessionJson = lastEncoding((id) => JSON.stringify(id));
+const typeJson = lastEncoding((type) => JSON.stringify(type));
+/**
+* `JSON.stringify(eventToWire(event))` for the parsed event, built around the
+* stored payload text instead of parsing and re-serializing it.
+*/
+function serializedEventToWireJson(event) {
+	return `{"id":${JSON.stringify(event.id)},"type":${typeJson(event.type)},"payload":${event.payloadJson},"index":${event.index},"sessionId":${sessionJson(event.sessionId)},"createdAt":${isoJson(event.createdAtMs)}}`;
+}
+function wireVersion(value) {
+	return value === "2" ? 2 : 1;
+}
+/**
+* Events already held by a stream join one write while it is shorter than
+* this many characters, so a write can exceed it by the event that crosses it.
+*/
+const EVENT_WRITE_CHARS = 65536;
+/** Stream items that are events, as opposed to snapshot or presence frames. */
+function isStreamEvent(item) {
+	return !("kind" in item) && !("snapshot" in item) && !("participant" in item);
+}
+/**
+* `first` and the events `iterator` already holds, encoded, until the batch
+* reaches `EVENT_WRITE_CHARS`; `last` is the batch's final event.
+*/
+function heldEventBatch(options) {
+	const { iterator, encode } = options;
+	let last = options.first;
+	const events = [encode(last)];
+	let chars = events[0].length;
+	while (chars < EVENT_WRITE_CHARS) {
+		const held = takeBuffered(iterator);
+		if (!held) break;
+		const json = encode(held);
+		events.push(json);
+		chars += json.length + 1;
+		last = held;
+	}
+	return {
+		events,
+		last
+	};
+}
+/** One version 2 event as JSON, splicing a held row's stored payload. */
+function compactEventJson(event) {
+	if (!isSerializedEvent(event)) return JSON.stringify({
+		id: event.id,
+		type: event.type,
+		payload: event.payload,
+		index: event.index,
+		createdAt: event.createdAt.getTime()
+	});
+	return `{"id":${JSON.stringify(event.id)},"type":${typeJson(event.type)},"payload":${event.payloadJson},"index":${event.index},"createdAt":${event.createdAtMs}}`;
+}
+function isCompactWireEvent(value) {
+	if (value === null || typeof value !== "object") return false;
+	const v = value;
+	return typeof v["id"] === "string" && typeof v["type"] === "string" && typeof v["index"] === "number" && typeof v["createdAt"] === "number" && Number.isFinite(v["createdAt"]);
+}
+function eventFromCompactWire(wire, sessionId) {
+	return {
+		id: wire.id,
+		type: wire.type,
+		payload: wire.payload,
+		index: wire.index,
+		sessionId,
+		createdAt: new Date(wire.createdAt)
+	};
+}
 function eventFromWire(wire) {
 	return {
 		id: wire.id,
@@ -93,6 +175,7 @@ const ERROR_STATUS = {
 	UNKNOWN_EVENT_TYPE: 400,
 	PARTIAL_DUPLICATE_BATCH: 400,
 	SUPERSEDED_ATTEMPT: 409,
+	SESSION_CLEARED: 409,
 	CLAIM_EXPIRED: 409,
 	STORE_UNAVAILABLE: 503,
 	STORE_NOT_CONFIGURED: 500,
@@ -128,6 +211,18 @@ function errorFromWire(body) {
 	return new A2Error(code, String(message ?? code), { details });
 }
 const isServerErrorCode = (code) => Object.hasOwn(ERROR_STATUS, code);
+function stateSnapshotToWire(frame) {
+	return frame.state === void 0 ? {
+		...frame,
+		state: null,
+		stateUndefined: true
+	} : frame;
+}
+function isStateSnapshotFrame(value) {
+	if (value === null || typeof value !== "object") return false;
+	const frame = value;
+	return frame["kind"] === "snapshot" && typeof frame["sessionId"] === "string" && typeof frame["name"] === "string" && frame["name"].length > 0 && typeof frame["index"] === "number" && Number.isSafeInteger(frame["index"]) && frame["index"] >= 0 && Object.hasOwn(frame, "state") && (!Object.hasOwn(frame, "stateUndefined") || frame["stateUndefined"] === true && frame["state"] === null) && (!Object.hasOwn(frame, "clearIndex") || typeof frame["clearIndex"] === "number" && Number.isSafeInteger(frame["clearIndex"]) && frame["clearIndex"] > 0 && frame["clearIndex"] <= frame["index"]);
+}
 const SOCKET_PING_FRAME = JSON.stringify({ kind: "ping" });
 /** One stream item as a socket frame — `sseResponse`'s framing over
 * the same codecs, with `kind` instead of an SSE event name. On a
@@ -135,6 +230,7 @@ const SOCKET_PING_FRAME = JSON.stringify({ kind: "ping" });
 * already carry theirs in the wire event. */
 function socketFrameFor(item, sessionId) {
 	const tag = sessionId === void 0 ? {} : { sessionId };
+	if ("kind" in item) return JSON.stringify(stateSnapshotToWire(item));
 	if ("snapshot" in item) return JSON.stringify({
 		kind: "presence-snapshot",
 		...presenceSnapshotToWire(item),
@@ -150,6 +246,11 @@ function socketFrameFor(item, sessionId) {
 		...eventToWire(item)
 	});
 }
+/** A version 2 batch frame from compact event JSON; a multiplexed
+* socket names the batch's session once. */
+function socketEventsFor(events, sessionId) {
+	return `{"kind":"events",${sessionId === void 0 ? "" : `"sessionId":${JSON.stringify(sessionId)},`}"events":[${events.join(",")}]}`;
+}
 function socketAckFor(req, events, sessionId) {
 	return JSON.stringify({
 		kind: "ack",
@@ -166,22 +267,27 @@ function socketErrorAckFor(req, error, sessionId) {
 		...sessionId === void 0 ? {} : { sessionId }
 	});
 }
-function socketSubscribedFor(sessionId) {
+function socketSubscribedFor(options) {
+	const { sessionId, attempt } = options;
 	return JSON.stringify({
 		kind: "subscribed",
-		sessionId
+		sessionId,
+		...attempt === void 0 ? {} : { attempt }
 	});
 }
 /** The subscription-over notice: with a `reason` the server rejected
 * or lost the session's stream, without one it ended cleanly. */
-function socketUnsubscribedFor(sessionId, reason, error) {
+function socketUnsubscribedFor(options) {
+	const { sessionId, attempt, reason, error } = options;
 	return JSON.stringify({
 		kind: "unsubscribed",
 		sessionId,
+		...attempt === void 0 ? {} : { attempt },
 		...reason === void 0 ? {} : { reason },
 		...error === void 0 ? {} : errorToWire(error)
 	});
 }
+const isAttempt = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
 function parseSocketFrame(data) {
 	let parsed;
 	try {
@@ -192,6 +298,9 @@ function parseSocketFrame(data) {
 	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return null;
 	const frame = parsed;
 	switch (frame["kind"]) {
+		case "snapshot":
+			if (!isStateSnapshotFrame(parsed)) throw new A2Error("INVALID_PAYLOAD", "invalid bootstrap snapshot");
+			return parsed;
 		case "ping": return { kind: "ping" };
 		case "event": {
 			if (!isWireEvent(parsed)) return null;
@@ -208,6 +317,15 @@ function parseSocketFrame(data) {
 				}
 			};
 		}
+		case "events": {
+			const events = frame["events"];
+			if (!Array.isArray(events) || !events.every(isCompactWireEvent)) throw new A2Error("INVALID_PAYLOAD", "invalid event batch");
+			return {
+				kind: "events",
+				events,
+				...sessionTag(frame)
+			};
+		}
 		case "presence": {
 			if (!isWirePresencePatch(parsed)) return null;
 			const { participant, values, seen, at } = parsed;
@@ -230,21 +348,25 @@ function parseSocketFrame(data) {
 				...sessionTag(frame)
 			};
 		case "subscribed": {
-			const sessionId = frame["sessionId"];
+			const { sessionId, attempt } = frame;
 			if (typeof sessionId !== "string") return null;
+			if (attempt !== void 0 && !isAttempt(attempt)) return null;
 			return {
 				kind: "subscribed",
-				sessionId
+				sessionId,
+				...attempt === void 0 ? {} : { attempt }
 			};
 		}
 		case "unsubscribed": {
-			const sessionId = frame["sessionId"];
+			const { sessionId, attempt } = frame;
 			if (typeof sessionId !== "string") return null;
+			if (attempt !== void 0 && !isAttempt(attempt)) return null;
 			const reason = frame["reason"];
 			const error = errorFromWire(parsed) ?? ("error" in frame ? new A2Error("STORE_UNAVAILABLE", "unintelligible subscription error") : null);
 			return {
 				kind: "unsubscribed",
 				sessionId,
+				...attempt === void 0 ? {} : { attempt },
 				...typeof reason === "string" ? { reason } : {},
 				...error === null ? {} : { error }
 			};
@@ -282,6 +404,6 @@ const sessionTag = (frame) => {
 	return typeof sessionId === "string" ? { sessionId } : {};
 };
 //#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 };
+export { stateSnapshotToWire as A, serializedEventToWireJson as C, socketFrameFor as D, socketEventsFor as E, socketSubscribedFor as O, presenceSnapshotToWire as S, socketErrorAckFor as T, isWirePresenceSnapshot as _, errorFromWire as a, presencePatchToWire as b, eventFromCompactWire as c, heldEventBatch as d, isCompactWireEvent as f, isWirePresencePatch as g, isWireEvent as h, compactEventJson as i, wireVersion as j, socketUnsubscribedFor as k, eventFromWire as l, isStreamEvent as m, SOCKET_PING_FRAME as n, errorStatus as o, isStateSnapshotFrame as p, asA2Error as r, errorToWire as s, EVENT_WRITE_CHARS as t, eventToWire as u, parseSocketFrame as v, socketAckFor as w, presenceSnapshotFromWire as x, presencePatchFromWire as y };
 
-//# sourceMappingURL=wire-BO5wWCb1.js.map
+//# sourceMappingURL=wire-rSUglYo8.js.map