experimental-a2 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (182) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/dist/{ai-B4YhEnfw.d.ts → ai-D_PGS-JR.d.ts} +3 -2
  3. package/dist/ai-D_PGS-JR.d.ts.map +1 -0
  4. package/dist/ai-server.browser.js +2 -0
  5. package/dist/ai-server.browser.js.map +1 -0
  6. package/dist/ai-server.d.ts +4 -3
  7. package/dist/ai-server.d.ts.map +1 -0
  8. package/dist/ai-server.js +4 -2
  9. package/dist/ai-server.js.map +1 -0
  10. package/dist/ai.d.ts +1 -1
  11. package/dist/ai.js +3 -1
  12. package/dist/ai.js.map +1 -0
  13. package/dist/cli-B3VuxoDe.js +2 -0
  14. package/dist/cli-B3VuxoDe.js.map +1 -0
  15. package/dist/cli-bin.js +2 -0
  16. package/dist/cli-bin.js.map +1 -0
  17. package/dist/cli.d.ts +2 -1
  18. package/dist/cli.d.ts.map +1 -0
  19. package/dist/{client-Bt4tAKi9.js → client-BKlyLiOU.js} +295 -85
  20. package/dist/client-BKlyLiOU.js.map +1 -0
  21. package/dist/{client-BrfDXQ8A.d.ts → client-D7mvIXrF.d.ts} +40 -4
  22. package/dist/client-D7mvIXrF.d.ts.map +1 -0
  23. package/dist/client.d.ts +2 -2
  24. package/dist/client.js +1 -1
  25. package/dist/contract-48bUMgcL.js +2 -0
  26. package/dist/contract-48bUMgcL.js.map +1 -0
  27. package/dist/contract-jIfaR085.d.ts +2 -1
  28. package/dist/contract-jIfaR085.d.ts.map +1 -0
  29. package/dist/devtools-J_jZ2vQf.d.ts +2 -1
  30. package/dist/devtools-J_jZ2vQf.d.ts.map +1 -0
  31. package/dist/devtools-kJJaORn-.js +2 -0
  32. package/dist/devtools-kJJaORn-.js.map +1 -0
  33. package/dist/devtools-server.browser.js +2 -0
  34. package/dist/devtools-server.browser.js.map +1 -0
  35. package/dist/devtools-server.d.ts +2 -1
  36. package/dist/devtools-server.d.ts.map +1 -0
  37. package/dist/devtools-server.js +2 -0
  38. package/dist/devtools-server.js.map +1 -0
  39. package/dist/errors-BQuJpe82.js +2 -0
  40. package/dist/errors-BQuJpe82.js.map +1 -0
  41. package/dist/errors-W6nwJ-fm.d.ts +2 -1
  42. package/dist/errors-W6nwJ-fm.d.ts.map +1 -0
  43. package/dist/http.d.ts +121 -72
  44. package/dist/http.d.ts.map +1 -0
  45. package/dist/http.js +503 -178
  46. package/dist/http.js.map +1 -0
  47. package/dist/idempotent-replay-DuqEkYA7.js +2 -0
  48. package/dist/idempotent-replay-DuqEkYA7.js.map +1 -0
  49. package/dist/index.d.ts +2 -2
  50. package/dist/inspection-DaxB5jM2.js +2 -0
  51. package/dist/inspection-DaxB5jM2.js.map +1 -0
  52. package/dist/{internal-aEotMzu_.js → internal-DstsI6Re.js} +3 -1
  53. package/dist/internal-DstsI6Re.js.map +1 -0
  54. package/dist/otel.d.ts +3 -2
  55. package/dist/otel.d.ts.map +1 -0
  56. package/dist/otel.js +2 -0
  57. package/dist/otel.js.map +1 -0
  58. package/dist/platform-B4TnJtWu.js +2 -0
  59. package/dist/platform-B4TnJtWu.js.map +1 -0
  60. package/dist/react.d.ts +12 -3
  61. package/dist/react.d.ts.map +1 -0
  62. package/dist/react.js +5 -1
  63. package/dist/react.js.map +1 -0
  64. package/dist/retryable-lazy-DZWmHpii.js +2 -0
  65. package/dist/retryable-lazy-DZWmHpii.js.map +1 -0
  66. package/dist/scheduler-qstash.d.ts +4 -3
  67. package/dist/scheduler-qstash.d.ts.map +1 -0
  68. package/dist/scheduler-qstash.js +4 -2
  69. package/dist/scheduler-qstash.js.map +1 -0
  70. package/dist/scheduler-task-BpzhPnRS.js +2 -0
  71. package/dist/scheduler-task-BpzhPnRS.js.map +1 -0
  72. package/dist/scheduler-vercel.d.ts +4 -3
  73. package/dist/scheduler-vercel.d.ts.map +1 -0
  74. package/dist/scheduler-vercel.js +4 -2
  75. package/dist/scheduler-vercel.js.map +1 -0
  76. package/dist/{server-YtPq7hjw.d.ts → server-DpvjhdoE.d.ts} +6 -5
  77. package/dist/server-DpvjhdoE.d.ts.map +1 -0
  78. package/dist/{server-CcNnFnoW.js → server-Duw6MVlB.js} +112 -54
  79. package/dist/server-Duw6MVlB.js.map +1 -0
  80. package/dist/server.browser.js +2 -0
  81. package/dist/server.browser.js.map +1 -0
  82. package/dist/server.d.ts +2 -2
  83. package/dist/server.js +1 -1
  84. package/dist/{store-C3sNAaBT.d.ts → store-DysUkTH3.d.ts} +10 -1
  85. package/dist/store-DysUkTH3.d.ts.map +1 -0
  86. package/dist/store-N8PXxDAS.js +2 -0
  87. package/dist/store-N8PXxDAS.js.map +1 -0
  88. package/dist/store-codec-DTG0Ftek.js +2 -0
  89. package/dist/store-codec-DTG0Ftek.js.map +1 -0
  90. package/dist/store-memory.d.ts +3 -2
  91. package/dist/store-memory.d.ts.map +1 -0
  92. package/dist/store-memory.js +19 -11
  93. package/dist/store-memory.js.map +1 -0
  94. package/dist/{store-polling-DgrrAE3d.js → store-polling-dSeLxzfb.js} +3 -1
  95. package/dist/store-polling-dSeLxzfb.js.map +1 -0
  96. package/dist/store-postgres.d.ts +3 -2
  97. package/dist/store-postgres.d.ts.map +1 -0
  98. package/dist/store-postgres.js +57 -1
  99. package/dist/store-postgres.js.map +1 -0
  100. package/dist/{store-redis-core-DWqx3F47.js → store-redis-core-BFLwz0Wj.js} +3 -1
  101. package/dist/store-redis-core-BFLwz0Wj.js.map +1 -0
  102. package/dist/store-redis-http.d.ts +3 -2
  103. package/dist/store-redis-http.d.ts.map +1 -0
  104. package/dist/store-redis-http.js +4 -2
  105. package/dist/store-redis-http.js.map +1 -0
  106. package/dist/store-redis.d.ts +3 -2
  107. package/dist/store-redis.d.ts.map +1 -0
  108. package/dist/store-redis.js +5 -3
  109. package/dist/store-redis.js.map +1 -0
  110. package/dist/store-sqlite.d.ts +3 -2
  111. package/dist/store-sqlite.d.ts.map +1 -0
  112. package/dist/store-sqlite.js +3 -1
  113. package/dist/store-sqlite.js.map +1 -0
  114. package/dist/{telemetry-BjYHTfh2.d.ts → telemetry-CpeclqB2.d.ts} +4 -3
  115. package/dist/telemetry-CpeclqB2.d.ts.map +1 -0
  116. package/dist/testing.browser.js +2 -0
  117. package/dist/testing.browser.js.map +1 -0
  118. package/dist/testing.d.ts +2 -1
  119. package/dist/testing.d.ts.map +1 -0
  120. package/dist/testing.js +2 -0
  121. package/dist/testing.js.map +1 -0
  122. package/dist/validate-XKT4FSNn.js +2 -0
  123. package/dist/validate-XKT4FSNn.js.map +1 -0
  124. package/dist/{wire-DCUZBUlT.js → wire-BFQmSJ-9.js} +77 -15
  125. package/dist/wire-BFQmSJ-9.js.map +1 -0
  126. package/docs/guides/03-react.mdx +59 -39
  127. package/docs/guides/06-ai-agents.mdx +5 -27
  128. package/docs/guides/09-presence.mdx +19 -40
  129. package/docs/guides/10-transports.mdx +49 -40
  130. package/docs/reference/01-api.mdx +107 -26
  131. package/docs/reference/02-errors.mdx +4 -2
  132. package/package.json +2 -1
  133. package/src/ai-coordinator.ts +358 -0
  134. package/src/ai-projector.ts +524 -0
  135. package/src/ai-sdk-step.ts +261 -0
  136. package/src/ai-server.browser.ts +5 -0
  137. package/src/ai-server.ts +1719 -0
  138. package/src/ai.ts +2155 -0
  139. package/src/cache-indexeddb.ts +10 -0
  140. package/src/cli-bin.ts +5 -0
  141. package/src/cli.ts +1046 -0
  142. package/src/client.ts +1826 -0
  143. package/src/contract.ts +206 -0
  144. package/src/deterministic-id.ts +72 -0
  145. package/src/devtools-app.ts +989 -0
  146. package/src/devtools-server.browser.ts +5 -0
  147. package/src/devtools-server.ts +604 -0
  148. package/src/devtools.ts +716 -0
  149. package/src/errors.ts +50 -0
  150. package/src/http.ts +394 -0
  151. package/src/idempotent-replay.ts +53 -0
  152. package/src/index.ts +37 -0
  153. package/src/inspection.ts +39 -0
  154. package/src/internal.ts +426 -0
  155. package/src/otel.ts +59 -0
  156. package/src/platform.ts +60 -0
  157. package/src/push-envelope.ts +137 -0
  158. package/src/react.ts +284 -0
  159. package/src/reducer.ts +108 -0
  160. package/src/retryable-lazy.ts +27 -0
  161. package/src/scheduler-qstash.ts +915 -0
  162. package/src/scheduler-task.ts +106 -0
  163. package/src/scheduler-vercel.ts +437 -0
  164. package/src/server.browser.ts +12 -0
  165. package/src/server.ts +2700 -0
  166. package/src/session-socket.ts +548 -0
  167. package/src/sse.ts +141 -0
  168. package/src/standard-schema.ts +77 -0
  169. package/src/store-codec.ts +10 -0
  170. package/src/store-memory.ts +788 -0
  171. package/src/store-polling.ts +102 -0
  172. package/src/store-postgres.ts +1212 -0
  173. package/src/store-redis-core.ts +1494 -0
  174. package/src/store-redis-http.ts +116 -0
  175. package/src/store-redis.ts +458 -0
  176. package/src/store-sqlite.ts +1108 -0
  177. package/src/store.ts +385 -0
  178. package/src/telemetry.ts +54 -0
  179. package/src/testing.browser.ts +5 -0
  180. package/src/testing.ts +185 -0
  181. package/src/validate.ts +39 -0
  182. package/src/wire.ts +454 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server-Duw6MVlB.js","names":[],"sources":["../src/deterministic-id.ts","../src/telemetry.ts","../src/server.ts"],"sourcesContent":["/**\n * Deterministic default ids for handler `session.append` calls. A handler\n * re-run after a crash calls `session.append` again; giving\n * each call a deterministic id — derived from the triggering event's id\n * and the caller's stable name — makes the re-run a no-op via the store's\n * unique index on event ids.\n *\n * The id is a UUIDv5-shaped SHA-1 over\n * `(namespace, triggerEventId, name, itemOrdinal)`, computed with\n * WebCrypto so it runs on any platform a2 core targets.\n */\n\nconst APPEND_NAMESPACE = 'a2:handler-append:v2'\nconst RETURN_NAMESPACE = 'a2:handler-return:v1'\nconst SCHEDULE_NAMESPACE = 'a2:schedule:v1'\nconst SCHEDULED_EVENT_NAMESPACE = 'a2:scheduled-event:v1'\n\nasync function deterministicIdFromInput(input: string): Promise<string> {\n const digest = await crypto.subtle.digest(\n 'SHA-1',\n new TextEncoder().encode(input),\n )\n const bytes = new Uint8Array(digest).slice(0, 16)\n bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x50\n bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80\n const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`\n}\n\nasync function deterministicId(parts: Array<string | number>): Promise<string> {\n return deterministicIdFromInput(parts.join('\\u0000'))\n}\n\nexport async function deterministicEventId(\n triggerEventId: string,\n name: string,\n itemOrdinal: number,\n): Promise<string> {\n if (name.length === 0) throw new TypeError('append name must not be empty')\n return deterministicId([APPEND_NAMESPACE, triggerEventId, name, itemOrdinal])\n}\n\nexport async function deterministicReturnedEventId(\n triggerEventId: string,\n itemOrdinal: number,\n): Promise<string> {\n return deterministicId([RETURN_NAMESPACE, triggerEventId, itemOrdinal])\n}\n\nexport async function deterministicScheduleId(\n contract: string,\n sessionId: string,\n triggerEventId: string | null,\n name: string,\n): Promise<string> {\n return deterministicIdFromInput(\n JSON.stringify([\n SCHEDULE_NAMESPACE,\n contract,\n sessionId,\n triggerEventId,\n name,\n ]),\n )\n}\n\nexport async function deterministicScheduledEventId(\n scheduleId: string,\n itemOrdinal: number,\n): Promise<string> {\n return deterministicId([SCHEDULED_EVENT_NAMESPACE, scheduleId, itemOrdinal])\n}\n","/**\n * The A2Telemetry interface — the instrumentation seam. Same philosophy\n * as store backends: the interface lives in core, implementations ship as\n * entry points (`experimental-a2/otel` adapts it to OpenTelemetry). Without\n * one, spans are free and swallowed errors print to the console.\n */\n\n/** Attribute values a2 emits. */\nexport type A2AttributeValue = string | number | boolean\n\n/** The spans a2 emits today. The catalogue grows with the surface. */\nexport type A2SpanName = 'a2.append' | 'a2.drain' | 'a2.event' | 'a2.state'\n\nexport type A2SpanHandle = {\n /** Attach or update an attribute mid-span (e.g. the outcome). */\n setAttribute(key: string, value: A2AttributeValue): void\n /**\n * Mark the span failed without a2's control flow throwing — used for\n * handler failures, which a2 swallows by design (they go into the\n * retry machinery, not up the stack) but telemetry must still see.\n */\n recordError(error: unknown): void\n}\n\nexport type A2Telemetry = {\n /**\n * Wrap one unit of a2 work. Implementations should time it, record a\n * thrown error as a failure, propagate context so nested spans tree\n * up, and always return `fn`'s result (or rethrow its error) —\n * telemetry observes, it never alters behavior.\n */\n span<T>(\n name: A2SpanName,\n attributes: Record<string, A2AttributeValue>,\n fn: (span: A2SpanHandle) => Promise<T>,\n ): Promise<T>\n}\n\n/**\n * The default when no telemetry is configured. Spans cost nothing, but\n * `recordError` prints: it only ever receives errors a2 swallows by\n * design, so without a configured sink the console is the one place\n * they can surface. Passing `telemetry` replaces this sink wholesale.\n */\nexport const CONSOLE_TELEMETRY: A2Telemetry = {\n span: (name, attributes, fn) =>\n fn({\n setAttribute: () => {},\n recordError: (error) => {\n // oxlint-disable-next-line no-console -- the whole point: swallowed errors must surface without configuration\n console.error(`[a2] error in ${name}`, attributes, error)\n },\n }),\n}\n","// oxlint-disable no-await-in-loop -- scheduler advances after durable outcomes\n/**\n * experimental-a2/server — where a contract is implemented. `createServer({\n * contract, store, handlers, ... })` binds the vocabulary to storage and\n * reactions; sessions, drains, claims, and scheduler all live here.\n * Server-only by construction: this entry point is the only one that\n * can reach a store backend, and its exports map fails loudly in browser\n * bundles.\n */\n\nimport type {\n AppendInput,\n Contract,\n ContractEvent,\n EventDefs,\n PresenceDefs,\n PresenceMap,\n PresencePatch,\n PresenceSnapshot,\n WithPresence,\n} from './contract.ts'\nimport { A2Error, asStoreUnavailable } from './errors.ts'\nimport {\n DRAIN_TIMINGS,\n POLL_TIMINGS,\n MAX_DATE_MS,\n RESERVED_PARTICIPANT_IDS,\n markSchedulerSendFailure,\n nullProtoRecord,\n serverInternals,\n serverSchedulerBindings,\n type DrainOutcome,\n type DrainResult,\n} from './internal.ts'\nimport { InspectionUnsupportedError, serverInspection } from './inspection.ts'\nimport { defaultSleep } from './store-polling.ts'\nimport type {\n A2Store,\n AppendEvent,\n Event,\n EventCause,\n StoreClaimAvailableResult,\n StoreStateRead,\n PresenceRow,\n ReturnedEvent,\n StoredEvent,\n} from './store.ts'\nimport type { Reducer } from './reducer.ts'\nimport { validateSync } from './validate.ts'\nimport {\n deterministicEventId,\n deterministicReturnedEventId,\n deterministicScheduledEventId,\n deterministicScheduleId,\n} from './deterministic-id.ts'\nimport { invocationDeadlineMs, platformWaitUntil } from './platform.ts'\nimport { retryableLazy } from './retryable-lazy.ts'\nimport type {\n ScheduledEvent,\n SchedulerAppendTask,\n SchedulerTask,\n} from './scheduler-task.ts'\nimport {\n CONSOLE_TELEMETRY,\n type A2SpanHandle,\n type A2Telemetry,\n} from './telemetry.ts'\n\n/**\n * Events that arrived over the wire through `parsePushBody` — already\n * envelope-validated, headed for schema validation inside `append`.\n * The brand lets the documented push route hand them straight to\n * `session.append` without weakening typed appends for app code: a\n * hand-written `{ type: string }` literal still fails to compile.\n */\nexport type PushedEvent = {\n type: string\n payload: unknown\n id?: string\n readonly '~a2.pushed': true\n}\n\n/**\n * A presence patch that arrived over the wire through `parsePushBody`\n * — same provenance brand as `PushedEvent`, so the documented route\n * hands it whole to `session.setPresence` while a hand-written\n * untyped patch still fails to compile. Field validation happens\n * inside `setPresence`.\n */\nexport type PushedPresence = {\n participant: string\n values: Record<string, unknown>\n seen?: number\n /** The sender's LWW stamp in epoch ms; receipt time when absent. */\n at?: number\n readonly '~a2.pushed': true\n}\n\nexport type PushValidationContext = {\n sessionId: string\n events: readonly PushedEvent[]\n /** The whole pushed patch — present exactly on the presence-plane\n * invocation, so the callback authorizes the participant id and can\n * apply size or cardinality policy. */\n presence?: PushedPresence\n}\n\n/** What every handler receives. */\nexport type HandlerContext<\n D extends EventDefs,\n K extends keyof D & string = keyof D & string,\n P extends PresenceDefs = Record<never, never>,\n> = {\n /** The triggering event. */\n event: ContractEvent<D, K>\n /** Durable, 1-based dispatch ordinal for this event. */\n attempt: number\n /** This session, with handler-scoped idempotent append. */\n session: Session<D, HandlerAppend<D>, P>\n /** Fires on `abortOn` events (cancellation slice); dormant otherwise. */\n signal: AbortSignal\n}\n\nexport type Handler<\n D extends EventDefs,\n K extends keyof D & string = keyof D & string,\n P extends PresenceDefs = Record<never, never>,\n> = (\n ctx: HandlerContext<D, K, P>,\n) => Promise<void | AppendInput<D> | readonly AppendInput<D>[]>\n\nexport type LaneContext<\n D extends EventDefs,\n K extends keyof D & string = keyof D & string,\n> = {\n sessionId: string\n event: Pick<ContractEvent<D, K>, 'type' | 'payload'> & { id?: string }\n}\n\nexport type Lane<\n D extends EventDefs,\n K extends keyof D & string = keyof D & string,\n> = string | ((context: LaneContext<D, K>) => string)\n\nexport type SessionDispatch<D extends EventDefs> = {\n (...events: AppendInput<D>[]): Promise<ContractEvent<D>[]>\n /** The push-route path: events from `parsePushBody`. */\n (...events: PushedEvent[]): Promise<ContractEvent<D>[]>\n}\n\nexport type SessionAppend<D extends EventDefs> = SessionDispatch<D> & {\n /** Commit, then hand pending work directly to configured scheduler. */\n dispatch: SessionDispatch<D>\n}\n\nexport type HandlerAppend<D extends EventDefs> = (\n name: string,\n ...events: AppendInput<D>[]\n) => Promise<ContractEvent<D>[]>\n\nexport type ScheduleDelay = `${number}${'ms' | 's' | 'm' | 'h' | 'd'}`\n\nexport type ScheduleTiming =\n { delay: ScheduleDelay; at?: never } | { at: Date; delay?: never }\n\nexport type SessionSchedule<D extends EventDefs> = (\n name: string,\n timing: ScheduleTiming,\n ...events: AppendInput<D>[]\n) => Promise<void>\n\n/**\n * The presence members of a session — intersected in via\n * `WithPresence`, so they exist exactly when the contract declares\n * presence fields. Intersected before the base members so the widened\n * `stream` overload is tried first: the literal `presence: true`\n * selects it, everything else falls through to the events-only base.\n */\nexport type SessionPresence<D extends EventDefs, P extends PresenceDefs> = {\n /**\n * The two-plane feed: one snapshot of the current pruned map first\n * (per-field stamps exact), then presence patches interleaved with\n * events.\n */\n stream(opts: {\n startAfter?: number\n presence: true\n }): AsyncIterable<ContractEvent<D> | PresencePatch<P> | PresenceSnapshot<P>>\n /**\n * Validate against the contract's presence schemas, then broadcast.\n * Never an append: no log row, no dispatch, no scheduler arm. `at`\n * is the sender's LWW stamp in epoch ms; omitted, receipt time\n * stands in (single writer, so receipt order is sender order).\n */\n setPresence(\n patch:\n | {\n participant: string\n values: PresencePatch<P>['values']\n seen?: number\n at?: number\n }\n | PushedPresence,\n ): Promise<void>\n /** The current map, expired values pruned — a point-in-time read. */\n presence(): Promise<PresenceMap<P>>\n}\n\n/** A handle on one instance of the machine. Creating it does no I/O. */\nexport type Session<\n D extends EventDefs,\n Append = SessionAppend<D>,\n P extends PresenceDefs = Record<never, never>,\n> = WithPresence<P, SessionPresence<D, P>> & {\n readonly id: string\n append: Append\n schedule: SessionSchedule<D>\n history(options?: { gte?: number; lte?: number }): Promise<ContractEvent<D>[]>\n state<S>(reducer: Reducer<D, S>): Promise<{ state: S; index: number }>\n /**\n * A live feed of this session's events, starting after `startAfter`\n * (exclusive). Server-side only — `handle` from experimental-a2/http\n * exposes it over SSE as the route's stream lane.\n */\n stream(opts?: { startAfter?: number }): AsyncIterable<ContractEvent<D>>\n}\n\n/**\n * The public server shape scheduler handlers accept. It stays structural so\n * servers of any contract mix in one route; A2's private server internals add\n * delayed-append delivery without exposing an untyped append method here.\n */\nexport type DrainableServer = {\n readonly contract: { readonly name: string }\n drain(sessionId: string): Promise<{ settled: boolean }>\n}\n\n/**\n * The scheduler seam (a2-implementation.md §7, §9). `schedule` puts a\n * versioned drain or delayed append task on durable infrastructure;\n * `handler` returns the route the transport delivers to. Claim holders\n * move the watchdog alongside their renewable execution window.\n * Implementations ship as\n * entry points (`experimental-a2/scheduler-vercel`); core never imports a\n * transport.\n */\nexport type A2Scheduler = {\n schedule(task: SchedulerTask): Promise<void>\n handler(...servers: DrainableServer[]): (req: Request) => Promise<Response>\n}\n\nexport type A2Server<\n D extends EventDefs,\n P extends PresenceDefs = Record<never, never>,\n> = {\n /** The contract this server implements. */\n readonly contract: Contract<D, P>\n session(id: string): Session<D, SessionAppend<D>, P>\n /**\n * Process every currently eligible event. `settled` means nothing\n * actionable remains, including work blocked behind a dead letter.\n */\n drain(sessionId: string): Promise<{ settled: boolean }>\n}\n\n/**\n * Deliver one authenticated scheduler append through an A2 server's ordinary\n * top-level append path. Custom scheduler adapters call this after validating\n * their transport envelope; application code normally uses `session.schedule`.\n */\nexport async function deliverSchedulerAppend(\n server: DrainableServer,\n task: SchedulerAppendTask,\n): Promise<void> {\n if (server.contract.name !== task.contract) {\n throw new TypeError(\n `a2 scheduler: append task for contract '${task.contract}' cannot be delivered to '${server.contract.name}'`,\n )\n }\n const internals = serverInternals.get(server)\n if (!internals) {\n throw new TypeError(\n `a2 scheduler: server for contract '${task.contract}' cannot receive scheduled appends`,\n )\n }\n await internals.schedulerAppend(task.sessionId, task.events)\n}\n\n/**\n * Which events fire `ctx.signal` while a handler runs — the preemption\n * channel for user cancellation. The array form matches by type; the\n * object form takes per-type predicates for targeted cancellation\n * (`(event, trigger) => event.payload.of === trigger.id`). Handlers\n * without `abortOn` pay nothing. An aborted handler should catch and\n * return normally; throwing means \"retry me\".\n */\nexport type AbortSpec<D extends EventDefs, K extends keyof D & string> =\n | Array<keyof D & string>\n | {\n [T in keyof D & string]?:\n | true\n | ((\n event: ContractEvent<D, T>,\n trigger: ContractEvent<D, K>,\n context: { attempt: number },\n ) => boolean)\n }\n\nexport type HandlerEntry<\n D extends EventDefs,\n K extends keyof D & string = keyof D & string,\n P extends PresenceDefs = Record<never, never>,\n> =\n | Handler<D, K, P>\n | {\n abortOn?: AbortSpec<D, K>\n /** Session-scoped FIFO key, resolved and persisted when the event lands. */\n lane?: Lane<D, K>\n handler: Handler<D, K, P>\n }\n\nexport type ServerOptions<\n D extends EventDefs,\n P extends PresenceDefs = Record<never, never>,\n> = {\n /** The contract this server implements (see `a2.contract`). */\n contract: Contract<D, P>\n /** Where events live. Defaults: sqlite in dev, memory in tests, required in prod. */\n store?: A2Store\n /**\n * Queue-backed scheduler — e.g. `vercelQueues()` from\n * `experimental-a2/scheduler-vercel`. Absent means append-driven healing only: a\n * working configuration, but a clockless one. Recommended in\n * production.\n */\n scheduler?: A2Scheduler\n /** Optional instrumentation — e.g. `otel()` from `experimental-a2/otel`. */\n telemetry?: A2Telemetry\n /** Validate events that came through `parsePushBody` before writing them. */\n validatePush?: (context: PushValidationContext) => void | PromiseLike<void>\n /**\n * Presence-plane policy — valid only when the contract declares\n * presence fields (TypeError at construction otherwise). `ttlMs` is\n * how long a value survives without a refreshing set; default 60s.\n */\n presence?: { ttlMs?: number }\n /**\n * The reactions, keyed by event type — all present at construction,\n * so a handler can never be silently missing because its module\n * wasn't imported. Compose across files by spreading objects (note:\n * a duplicate key under spread silently last-wins).\n */\n handlers?: { [K in keyof D & string]?: HandlerEntry<D, K, P> }\n}\n\nconst MAX_FAILURES = 10\n\n/** Default: how long a presence value survives without a refreshing set. */\nconst PRESENCE_TTL_MS = 60_000\n\ntype ClaimWindow = {\n ttlMs: number\n expiresAtMs: number\n watchdogAtMs: number\n deadlineCapped: boolean\n}\n\ntype DrainSignal = {\n version: number\n closed: boolean\n notify(): void\n wait(version: number): { promise: Promise<void>; cancel(): void }\n}\n\ntype AbortSubscription = {\n controller: AbortController\n triggerIndex: number\n types: Set<string>\n matches(event: Event): boolean\n}\n\ntype AbortHub = {\n subscriptions: Set<AbortSubscription>\n seen: Map<number, Event>\n startAfter: number\n ready: Promise<void>\n watch: Promise<void> | null\n error: unknown\n iterator: AsyncIterator<Event> | null\n stopped: boolean\n}\n\nfunction createDrainSignal(): DrainSignal {\n const listeners = new Set<() => void>()\n return {\n version: 0,\n closed: false,\n notify() {\n this.version += 1\n for (const listener of listeners) listener()\n listeners.clear()\n },\n wait(version) {\n if (this.version !== version) {\n return { promise: Promise.resolve(), cancel: () => {} }\n }\n let resolve!: () => void\n const promise = new Promise<void>((done) => {\n resolve = done\n })\n listeners.add(resolve)\n return { promise, cancel: () => listeners.delete(resolve) }\n },\n }\n}\n\nfunction dispatchAbortEvent(hub: AbortHub, event: Event): void {\n let relevant = false\n for (const subscription of hub.subscriptions) {\n if (!subscription.types.has(event.type)) continue\n relevant = true\n if (subscription.matches(event)) subscription.controller.abort()\n }\n if (relevant) hub.seen.set(event.index, event)\n}\n\nfunction pruneAbortHub(hub: AbortHub): void {\n let minimum = Infinity\n const types = new Set<string>()\n for (const subscription of hub.subscriptions) {\n minimum = Math.min(minimum, subscription.triggerIndex)\n for (const type of subscription.types) types.add(type)\n }\n for (const [index, event] of hub.seen) {\n if (index <= minimum || !types.has(event.type)) hub.seen.delete(index)\n }\n}\n\n/**\n * Deadlines tighten the claim/watchdog window; they never decide whether a\n * handler starts. A platform timeout therefore follows the same path as any\n * other process death: the in-flight event remains pending and is retried.\n */\nfunction nextClaimWindow(): ClaimWindow {\n const nowMs = Date.now()\n const deadlineMs = invocationDeadlineMs()\n const deadlineTtlMs =\n deadlineMs === null ? DRAIN_TIMINGS.claimTtlMs : deadlineMs - nowMs\n const deadlineCapped =\n deadlineMs !== null && deadlineTtlMs <= DRAIN_TIMINGS.claimTtlMs\n const ttlMs = Math.max(1, Math.min(DRAIN_TIMINGS.claimTtlMs, deadlineTtlMs))\n const expiresAtMs = nowMs + ttlMs\n return {\n ttlMs,\n expiresAtMs,\n watchdogAtMs: expiresAtMs + DRAIN_TIMINGS.watchdogGraceMs,\n deadlineCapped,\n }\n}\n\nfunction schedulerSlot(dueAt: number): number {\n return Math.ceil(dueAt / 1_000) * 1_000\n}\n\nfunction currentSchedulerSlot(now: number): number {\n return Math.floor(now / 1_000) * 1_000\n}\n\n/**\n * The namespace separator between machine name and session id in\n * storage. Machines sharing one store backend (the dev-default sqlite\n * file, a shared Postgres) must not collide on session ids; the machine\n * name is what makes multi-machine apps unambiguous (a2-api.md §1), so\n * it prefixes every storage key.\n */\nconst NS = '\\u001f'\n\nconst devDefaultStore = retryableLazy(() =>\n import('./store-sqlite.ts').then((m) => m.sqlite()),\n)\n\nfunction environment(): 'development' | 'test' | 'production' {\n const env =\n typeof process === 'undefined' ? undefined : process.env?.['NODE_ENV']\n if (env === 'test') return 'test'\n if (env === 'production') return 'production'\n return 'development'\n}\n\nfunction describeError(err: unknown): string {\n if (err instanceof Error) return err.stack ?? `${err.name}: ${err.message}`\n return String(err)\n}\n\n/**\n * Comparison key for a presence value in the degraded-tier diff — an\n * LWW tie can replace a value without moving its `seen`/`at` stamp.\n */\nfunction fingerprint(value: unknown): string {\n return JSON.stringify(value) ?? ''\n}\n\nfunction foldPresenceRows(\n rows: PresenceRow[],\n): Record<string, Record<string, { value: unknown; seen: number; at: Date }>> {\n // Null-prototype at both levels: participants and fields are caller\n // strings, and a '__proto__' key on a normal object rewrites its\n // prototype instead of setting an own property.\n const map =\n nullProtoRecord<\n Record<string, Record<string, { value: unknown; seen: number; at: Date }>>\n >()\n for (const row of rows) {\n ;(map[row.participant] ??= nullProtoRecord())[row.field] = {\n value: row.value,\n seen: row.seen,\n at: row.at,\n }\n }\n return map\n}\n\n/** Implement a contract: bind its vocabulary to storage and reactions. */\nexport function createServer<\n D extends EventDefs,\n P extends PresenceDefs = Record<never, never>,\n>(options: ServerOptions<D, P>): A2Server<D, P> {\n const serverContract = options?.contract\n if (\n serverContract === null ||\n typeof serverContract !== 'object' ||\n typeof serverContract.name !== 'string' ||\n serverContract.events === null\n ) {\n throw new TypeError(\n 'createServer expects options with a contract (see a2.contract)',\n )\n }\n const name = serverContract.name\n const defs = serverContract.events\n const presenceDefs: Readonly<PresenceDefs> = serverContract.presence\n const declaresPresence = Object.keys(presenceDefs).length > 0\n const presenceNotSupported = (): A2Error =>\n new A2Error(\n 'PRESENCE_NOT_SUPPORTED',\n `the contract '${name}' declares presence but the store backend for its server has no presence capability (A2Store.presence)`,\n )\n\n if (options.presence !== undefined) {\n // An option for a plane the contract doesn't declare is a mistake\n // worth failing loud at construction.\n if (!declaresPresence) {\n throw new TypeError(\n `the presence option requires a contract that declares presence fields — '${name}' has none`,\n )\n }\n const { ttlMs } = options.presence\n if (ttlMs !== undefined && (!Number.isInteger(ttlMs) || ttlMs <= 0)) {\n throw new TypeError(\n 'presence.ttlMs must be a positive integer of milliseconds',\n )\n }\n }\n const presenceTtlMs = options.presence?.ttlMs ?? PRESENCE_TTL_MS\n\n // Resolve where events live. Explicit store wins; otherwise the\n // environment decides — and production refuses to guess\n // (a2-implementation.md §8): a failed boot beats events written to an\n // ephemeral filesystem.\n let makeStore: () => Promise<A2Store>\n if (options.store) {\n const explicit = options.store\n // Fail at boot, not first use (a2-api.md §12).\n if (declaresPresence && !explicit.presence) throw presenceNotSupported()\n makeStore = () => Promise.resolve(explicit)\n } else {\n const env = environment()\n if (env === 'production') {\n const error = (): A2Error =>\n new A2Error(\n 'STORE_NOT_CONFIGURED',\n `the server for '${name}' has no store configured and NODE_ENV is 'production' — pass an explicit store backend (e.g. postgres from 'experimental-a2/store-postgres')`,\n )\n // `next build` evaluates route modules with NODE_ENV=production\n // to collect page data — in a CI without the runtime env vars, a\n // construction-time throw fails the build for nothing (the store is\n // never used during collection). During that phase only, defer\n // the failure to first use; a real production boot still fails at\n // construction, before any event can land somewhere ephemeral.\n if (process.env['NEXT_PHASE'] !== 'phase-production-build') {\n throw error()\n }\n makeStore = () => Promise.reject(error())\n } else {\n makeStore =\n env === 'test'\n ? () => import('./store-memory.ts').then((m) => m.memory())\n : devDefaultStore.get\n }\n }\n\n // Environment-resolved stores arrive lazily; assert the capability the\n // moment one resolves — the closest available moment to construction.\n if (declaresPresence && !options.store) {\n const inner = makeStore\n makeStore = async () => {\n const store = await inner()\n if (!store.presence) throw presenceNotSupported()\n return store\n }\n }\n\n const resolveStore = retryableLazy(makeStore).get\n\n const telemetry = options.telemetry ?? CONSOLE_TELEMETRY\n const scheduler = options.scheduler\n\n type AbortMatcher = Map<\n string,\n | true\n | ((\n event: ContractEvent<D>,\n trigger: ContractEvent<D>,\n context: { attempt: number },\n ) => boolean)\n >\n const handlers = new Map<\n string,\n { handler: Handler<D>; abortOn: AbortMatcher | null; lane: Lane<D> | null }\n >()\n for (const [type, entry] of Object.entries(options.handlers ?? {})) {\n if (entry === undefined) continue\n if (!Object.hasOwn(defs, type)) {\n throw new TypeError(\n `contract '${name}' has no event type '${type}' — cannot register a handler for it`,\n )\n }\n const handler = typeof entry === 'function' ? entry : entry?.handler\n if (typeof handler !== 'function') {\n throw new TypeError(`handler for '${type}' must be a function`)\n }\n let abortOn: AbortMatcher | null = null\n const spec = typeof entry === 'function' ? undefined : entry.abortOn\n if (spec !== undefined) {\n abortOn = new Map()\n const pairs = Array.isArray(spec)\n ? spec.map((abortType) => [abortType, true as const] as const)\n : (Object.entries(spec) as Array<\n [\n string,\n (\n | true\n | ((\n e: never,\n t: never,\n context: { attempt: number },\n ) => boolean)\n ),\n ]\n >)\n for (const [abortType, matcher] of pairs) {\n if (matcher === undefined) continue\n if (!Object.hasOwn(defs, abortType)) {\n throw new TypeError(\n `contract '${name}' has no event type '${String(abortType)}' — cannot abort on it`,\n )\n }\n abortOn.set(String(abortType), matcher as never)\n }\n if (abortOn.size === 0) abortOn = null\n }\n const lane = typeof entry === 'function' ? null : (entry.lane ?? null)\n if (\n lane !== null &&\n typeof lane !== 'function' &&\n (typeof lane !== 'string' || lane.length === 0)\n ) {\n throw new TypeError(\n `lane for '${type}' must be a non-empty string or a function`,\n )\n }\n handlers.set(type, {\n handler: handler as Handler<D>,\n abortOn,\n lane: lane as Lane<D> | null,\n })\n }\n\n const prefix = `${name}${NS}`\n const nsId = (sessionId: string): string => `${prefix}${sessionId}`\n const stripNs = (stored: string): string => stored.slice(prefix.length)\n\n const toPublic = (row: Event): ContractEvent<D> =>\n ({\n id: row.id,\n type: row.type,\n payload: row.payload,\n index: row.index,\n sessionId: stripNs(row.sessionId),\n createdAt: row.createdAt,\n }) as ContractEvent<D>\n\n // ── background work tracking ─────────────────────────────────────\n // Every fire-and-forget operation is tracked so (a) platforms with\n // waitUntil keep the invocation alive and (b) tests can flush\n // deterministically via serverInternals.\n const inFlight = new Set<Promise<unknown>>()\n const track = (p: Promise<unknown>): void => {\n inFlight.add(p)\n const drop = (): void => {\n inFlight.delete(p)\n }\n p.then(drop, drop)\n }\n\n type SchedulerArmSlot = {\n promise: Promise<void>\n forget: ReturnType<typeof setTimeout>\n }\n const schedulerArmSlots = new Map<string, SchedulerArmSlot>()\n\n /**\n * Start an optional scheduler arm without putting it on the execution path.\n * The returned raw promise lets the initial append report failure; the\n * tracked copy is always rejection-safe for heartbeat callers.\n */\n const startSchedulerArm = (\n sessionId: string,\n dueAt: number,\n ): Promise<void> | null => {\n if (!scheduler) return null\n const slottedDueAt = schedulerSlot(dueAt)\n const slotKey = JSON.stringify([sessionId, slottedDueAt])\n const existing = schedulerArmSlots.get(slotKey)\n if (existing) return existing.promise\n // Normalize even a custom adapter's synchronous throw into a rejected\n // promise. Optional scheduler must never stop inline claiming.\n const raw = Promise.resolve().then(() =>\n scheduler.schedule({\n version: 1,\n kind: 'drain',\n contract: name,\n sessionId,\n dueAt: slottedDueAt,\n }),\n )\n const forget = setTimeout(\n () => {\n if (schedulerArmSlots.get(slotKey)?.promise === raw) {\n schedulerArmSlots.delete(slotKey)\n }\n },\n Math.max(0, slottedDueAt - Date.now()) + 1_000,\n )\n ;(forget as { unref?: () => void }).unref?.()\n schedulerArmSlots.set(slotKey, { promise: raw, forget })\n void raw.then(undefined, () => {\n const current = schedulerArmSlots.get(slotKey)\n if (current?.promise !== raw) return\n clearTimeout(current.forget)\n schedulerArmSlots.delete(slotKey)\n })\n const safe = raw.catch(() => {})\n track(safe)\n platformWaitUntil(safe)\n return raw\n }\n\n const scheduledDrains = new Map<\n string,\n { signal: DrainSignal; promise: Promise<void> }\n >()\n\n const scheduleDrain = (sessionId: string, watchdogDueAt?: number): void => {\n const existing = scheduledDrains.get(sessionId)\n if (existing && !existing.signal.closed) {\n existing.signal.notify()\n return\n }\n if (existing) scheduledDrains.delete(sessionId)\n const signal = createDrainSignal()\n const p = new Promise<void>((resolve) => {\n queueMicrotask(() => {\n void drainSession(sessionId, watchdogDueAt, signal)\n .then(() => resolve())\n .catch(() => resolve())\n })\n }).finally(() => {\n if (scheduledDrains.get(sessionId)?.promise === p) {\n scheduledDrains.delete(sessionId)\n }\n })\n scheduledDrains.set(sessionId, { signal, promise: p })\n track(p)\n platformWaitUntil(p)\n }\n\n // ── append ───────────────────────────────────────────────────────\n\n const validateEvents = (\n sessionId: string,\n events: AppendInput<D>[],\n resolveDispatchMetadata = true,\n ): AppendEvent[] => {\n if (events.length === 0) {\n throw new TypeError('append requires at least one event')\n }\n return events.map((e) => {\n const schema = Object.hasOwn(defs, e.type) ? defs[e.type] : undefined\n if (!schema) {\n throw new A2Error(\n 'UNKNOWN_EVENT_TYPE',\n `contract '${name}' has no event type '${String(e.type)}'`,\n )\n }\n const result = validateSync(schema, e.payload, `event '${e.type}'`)\n if (result.issues) {\n throw new A2Error(\n 'INVALID_PAYLOAD',\n `invalid payload for event '${e.type}' on machine '${name}'`,\n { details: result.issues },\n )\n }\n const validated: AppendEvent = { type: e.type, payload: result.value }\n if (e.id !== undefined) validated.id = e.id\n if (!resolveDispatchMetadata) return validated\n const registration = handlers.get(e.type)\n if (!registration) {\n validated.settled = true\n } else if (registration.lane !== null) {\n const lane =\n typeof registration.lane === 'function'\n ? registration.lane({\n sessionId,\n event: {\n type: e.type,\n payload: structuredClone(result.value),\n ...(e.id === undefined ? {} : { id: e.id }),\n } as never,\n })\n : registration.lane\n if (typeof lane !== 'string' || lane.length === 0) {\n throw new TypeError(\n `lane for '${e.type}' must resolve to a non-empty string`,\n )\n }\n validated.lane = lane\n }\n return validated\n })\n }\n\n /**\n * Validate + write. `onAppended` runs inside the telemetry span, so\n * the drain it schedules is created in the append's active context —\n * with a real tracer, causal work remains connected.\n */\n const appendCore = (\n sessionId: string,\n events: AppendInput<D>[],\n source: 'external' | 'handler',\n mode: 'inline' | 'dispatch',\n onAppended: (rows: ContractEvent<D>[], watchdogDueAt?: number) => void,\n cause?: EventCause,\n generatedIds?: readonly boolean[],\n requireDurableInitialArm = false,\n ): Promise<ContractEvent<D>[]> =>\n telemetry.span(\n 'a2.append',\n {\n 'a2.contract': name,\n 'a2.session_id': sessionId,\n 'a2.append.source': source,\n 'a2.append.mode': mode,\n 'a2.append.types': events.map((e) => String(e.type)).join(','),\n 'a2.append.count': events.length,\n },\n async (span) => {\n if (mode === 'dispatch' && !scheduler) {\n throw new TypeError(\n 'append.dispatch requires a configured scheduler adapter',\n )\n }\n assertSessionId(sessionId)\n const validated = validateEvents(sessionId, events)\n if (cause) {\n for (const [index, event] of validated.entries()) {\n event.cause = generatedIds?.[index]\n ? { ...cause, batchSize: events.length }\n : cause\n }\n }\n const store = await resolveStore()\n let rows: StoredEvent[]\n let shouldHealSession: boolean\n try {\n const result = await store.append(nsId(sessionId), validated)\n rows = result.events\n shouldHealSession = result.hasPending\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n const appended = rows.map(toPublic)\n\n const initialWatchdogAt =\n shouldHealSession &&\n scheduler &&\n source === 'external' &&\n mode === 'inline'\n ? schedulerSlot(nextClaimWindow().watchdogAtMs)\n : undefined\n const initialArm =\n initialWatchdogAt !== undefined\n ? startSchedulerArm(sessionId, initialWatchdogAt)\n : null\n const dispatchArm =\n shouldHealSession && mode === 'dispatch'\n ? startSchedulerArm(sessionId, currentSchedulerSlot(Date.now()))\n : null\n if (shouldHealSession && mode === 'inline') {\n onAppended(appended, initialWatchdogAt)\n }\n if (dispatchArm) {\n await dispatchArm\n }\n if (initialArm) {\n let timeout: ReturnType<typeof setTimeout> | null = null\n try {\n await Promise.race([\n initialArm,\n new Promise<never>((_, reject) => {\n timeout = setTimeout(() => {\n reject(\n new Error(\n `a2 scheduler arm timed out after ${DRAIN_TIMINGS.schedulerArmTimeoutMs}ms`,\n ),\n )\n }, DRAIN_TIMINGS.schedulerArmTimeoutMs)\n }),\n ])\n } catch (err) {\n span.setAttribute('a2.append.armed', false)\n span.recordError(err)\n if (requireDurableInitialArm) throw err\n } finally {\n if (timeout) clearTimeout(timeout)\n }\n }\n return appended\n },\n )\n\n const readHistory = async (\n sessionId: string,\n bounds?: { gte?: number; lte?: number },\n ): Promise<StoredEvent[]> => {\n const gte = bounds?.gte\n const lte = bounds?.lte\n assertHistoryIndex('gte', gte)\n assertHistoryIndex('lte', lte)\n if (gte !== undefined && lte !== undefined && gte > lte) {\n throw new RangeError(\n 'history.gte must be less than or equal to history.lte',\n )\n }\n if (lte === 0) return []\n\n const store = await resolveStore()\n try {\n const readOptions =\n gte === undefined && lte === undefined\n ? undefined\n : {\n ...(gte === undefined\n ? {}\n : { afterIndex: Math.max(0, gte - 1) }),\n ...(lte === undefined ? {} : { throughIndex: lte }),\n }\n const rows = await store.read(nsId(sessionId), readOptions)\n return rows.filter(\n (row) =>\n (gte === undefined || row.index >= gte) &&\n (lte === undefined || row.index <= lte),\n )\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n }\n\n // Snapshot plus tail is one adapter operation. A cache-path failure is\n // not load-bearing: fall back to the raw store, which still reports a\n // real storage failure.\n const readCachedState = async (\n store: A2Store,\n sessionId: string,\n reducerName: string,\n ): Promise<StoreStateRead> => {\n try {\n return await store.readState(nsId(sessionId), reducerName)\n } catch {\n try {\n return { snapshot: null, events: await store.read(nsId(sessionId)) }\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n }\n }\n\n // The cache is untrusted: schema rejection refolds from the raw store.\n const foldStateRead = async <S>(\n store: A2Store,\n sessionId: string,\n reducer: Reducer<D, S>,\n stateRead: StoreStateRead,\n span: A2SpanHandle,\n ): Promise<{ state: S; index: number; folded: number }> => {\n let state = cloneInitial(reducer.initialState)\n let index = 0\n let snapshotOutcome = 'miss'\n const snap = stateRead.snapshot\n let rows = stateRead.events\n if (snap) {\n if (reducer.stateSchema) {\n const result = validateSync(\n reducer.stateSchema,\n snap.state,\n 'the stateSchema',\n )\n if (result.issues) {\n snapshotOutcome = 'rejected'\n } else {\n state = result.value as S\n index = snap.index\n snapshotOutcome = 'hit'\n }\n } else {\n state = snap.state as S\n index = snap.index\n snapshotOutcome = 'hit'\n }\n }\n span.setAttribute('a2.state.snapshot', snapshotOutcome)\n\n if (snapshotOutcome === 'rejected') {\n try {\n rows = await store.read(nsId(sessionId))\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n }\n for (const row of rows) {\n state = reducer.fold(state, toPublic(row) as never)\n index = row.index\n }\n span.setAttribute('a2.state.folded', rows.length)\n span.setAttribute('a2.state.index', index)\n return { state, index, folded: rows.length }\n }\n\n // ── same-tick state-read coalescing ──────────────────────────────\n // Concurrent state() calls for one reducer name coalesce into a\n // single store.readStates() round trip when the adapter has one.\n // Unlike DataLoader there is deliberately NO result cache: a batch\n // exists only between enqueue and flush, and nothing is shared after\n // distribution — every state() call still observes a fresh frontier.\n type PendingStateRead = {\n sessionId: string\n resolve: (read: StoreStateRead | Promise<StoreStateRead>) => void\n }\n const pendingStateReads = new Map<string, PendingStateRead[]>()\n\n // The flush microtask voids this promise, so the function must be\n // total: never reject, never leave an entry unresolved — even for a\n // synchronously throwing adapter or a read structuredClone rejects.\n const flushStateReads = async (\n store: A2Store,\n reducerName: string,\n batch: PendingStateRead[],\n ): Promise<void> => {\n let reads: StoreStateRead[] | null\n try {\n reads = store.readStates\n ? await store.readStates(\n batch.map((entry) => nsId(entry.sessionId)),\n reducerName,\n )\n : null\n } catch {\n reads = null\n }\n // A failed or misaligned batch is an ill-behaved cache path, never a\n // batch-shaped error: each caller falls back to its own per-call read\n // (promise adoption carries a real storage failure to that caller).\n if (!reads || reads.length !== batch.length) {\n for (const entry of batch) {\n entry.resolve(readCachedState(store, entry.sessionId, reducerName))\n }\n return\n }\n // Duplicate ids share one store read; their folds must not share\n // payload objects, exactly as two separate state() calls would not.\n const seen = new Set<string>()\n for (const [position, entry] of batch.entries()) {\n const shared = seen.has(entry.sessionId)\n seen.add(entry.sessionId)\n try {\n const read = reads[position]!\n entry.resolve(shared ? structuredClone(read) : read)\n } catch {\n entry.resolve(readCachedState(store, entry.sessionId, reducerName))\n }\n }\n }\n\n const enqueueStateRead = (\n store: A2Store,\n sessionId: string,\n reducerName: string,\n ): Promise<StoreStateRead> =>\n new Promise((resolve) => {\n let batch = pendingStateReads.get(reducerName)\n if (!batch) {\n const opened: PendingStateRead[] = []\n pendingStateReads.set(reducerName, opened)\n // One microtask is the whole batching window — deliberately NOT\n // DataLoader's post-promise-job nextTick, which would defer\n // handler-internal reads past the entire microtask cascade and\n // reorder drain interleaving (and has no edge-runtime primitive).\n // It still coalesces reliably: siblings of one Promise.all\n // traverse identical awaits (store resolution, span wrapper), so\n // their enqueues sit at consecutive queue positions — cold or\n // warm — and this flush, queued by the first of them, runs after\n // the last. A deeper-staggered caller just opens the next batch.\n queueMicrotask(() => {\n pendingStateReads.delete(reducerName)\n void flushStateReads(store, reducerName, opened)\n })\n batch = opened\n }\n batch.push({ sessionId, resolve })\n })\n\n const readState = async <S>(\n sessionId: string,\n reducer: Reducer<D, S>,\n ): Promise<{ state: S; index: number }> => {\n const store = await resolveStore()\n return telemetry.span(\n 'a2.state',\n {\n 'a2.contract': name,\n 'a2.session_id': sessionId,\n 'a2.state.reducer': reducer.name,\n },\n async (span) => {\n const stateRead = store.readStates\n ? await enqueueStateRead(store, sessionId, reducer.name)\n : await readCachedState(store, sessionId, reducer.name)\n const { state, index, folded } = await foldStateRead(\n store,\n sessionId,\n reducer,\n stateRead,\n span,\n )\n // Write-back is a disposable cache. Copy before returning so caller\n // mutations cannot race the background persistence.\n if (folded > 0) {\n const snapshotState = cloneInitial(state)\n const write = Promise.resolve()\n .then(() =>\n store.putSnapshot(\n nsId(sessionId),\n reducer.name,\n index,\n snapshotState,\n ),\n )\n .catch(() => {})\n track(write)\n platformWaitUntil(write)\n }\n return { state, index }\n },\n )\n }\n\n const makeSchedule = (\n sessionId: string,\n trigger: Pick<StoredEvent, 'id' | 'createdAt'> | null,\n ): SessionSchedule<D> => {\n const triggerEventId = trigger?.id ?? null\n const triggerCreatedAt = trigger?.createdAt.getTime()\n return async (scheduleName, timing, ...events) => {\n if (!scheduler) {\n throw new TypeError(\n 'session.schedule requires a configured scheduler adapter',\n )\n }\n assertScheduleName(scheduleName)\n if (events.length === 0) {\n throw new TypeError('schedule requires at least one event')\n }\n const dueAt = scheduleDueAt(timing, triggerCreatedAt ?? Date.now())\n const payloads = events.map((event) =>\n cloneScheduledPayload(event.payload),\n )\n const snapshottedEvents = events.map((event, index) => ({\n type: event.type,\n payload: payloads[index],\n ...(event.id === undefined ? {} : { id: event.id }),\n })) as AppendInput<D>[]\n const validated = validateEvents(\n sessionId,\n structuredClone(snapshottedEvents),\n false,\n )\n const scheduleId = await deterministicScheduleId(\n name,\n sessionId,\n triggerEventId,\n scheduleName,\n )\n const scheduledEvents: ScheduledEvent[] = await Promise.all(\n validated.map(async (event, item) => ({\n id:\n event.id ?? (await deterministicScheduledEventId(scheduleId, item)),\n type: event.type,\n payload: payloads[item],\n })),\n )\n if (\n new Set(scheduledEvents.map((event) => event.id)).size !==\n scheduledEvents.length\n ) {\n throw new A2Error(\n 'PARTIAL_DUPLICATE_BATCH',\n 'scheduled batch contains the same event id more than once',\n )\n }\n try {\n await scheduler.schedule({\n version: 1,\n kind: 'append',\n id: scheduleId,\n contract: name,\n sessionId,\n dueAt,\n events: scheduledEvents,\n })\n } catch (error) {\n throw markSchedulerSendFailure(error)\n }\n }\n }\n\n const toSessionEvent = (id: string, event: Event): ContractEvent<D> =>\n ({\n id: event.id,\n type: event.type,\n payload: event.payload,\n index: event.index,\n sessionId: id,\n createdAt: event.createdAt,\n }) as ContractEvent<D>\n\n const streamEvents = (\n id: string,\n startAfter: number,\n ): AsyncIterable<ContractEvent<D>> => {\n const store = resolveStore()\n const outer = async function* (): AsyncGenerator<ContractEvent<D>> {\n const inner = (await store).stream(nsId(id), { startAfter })\n for await (const event of inner) yield toSessionEvent(id, event)\n }\n return outer()\n }\n\n // ── presence ──────────────────────────────────────────────\n\n const requirePresence = (\n store: A2Store,\n ): NonNullable<A2Store['presence']> => {\n if (!store.presence) throw presenceNotSupported()\n return store.presence\n }\n\n const setPresence = async (\n sessionId: string,\n patch: {\n participant: string\n values: Record<string, unknown>\n seen?: number\n at?: number\n },\n fallbackSeen: number,\n ): Promise<void> => {\n // The push-route provenance seam, mirroring appendExternal: a\n // branded patch came from the wire, so `validatePush` runs before\n // field validation and the broadcast — with `events: []`, the\n // documented presence-only shape.\n if (Reflect.get(patch, '~a2.pushed') === true) {\n // Frozen before the callback: this is the authorization seam,\n // and an authorization hook must not be able to rewrite\n // authorship or values on its way through (assignment throws\n // under strict mode, failing the push loudly).\n Object.freeze(patch.values)\n await options.validatePush?.({\n sessionId,\n events: [],\n presence: Object.freeze(patch as PushedPresence),\n })\n }\n if (\n typeof patch.participant !== 'string' ||\n patch.participant.length === 0\n ) {\n throw new TypeError('presence participant must be a non-empty string')\n }\n if (RESERVED_PARTICIPANT_IDS.has(patch.participant)) {\n throw new TypeError(\n `presence participant must not be '${patch.participant}'`,\n )\n }\n if (\n patch.at !== undefined &&\n (typeof patch.at !== 'number' ||\n !Number.isFinite(patch.at) ||\n patch.at < 0 ||\n patch.at > MAX_DATE_MS)\n ) {\n throw new TypeError(\n 'presence at must be non-negative epoch milliseconds within the Date range',\n )\n }\n // Validate the whole patch before the adapter sees any of it — a\n // bad field means nothing is broadcast.\n const validated: Record<string, unknown> = nullProtoRecord()\n for (const [field, value] of Object.entries(patch.values)) {\n if (value === undefined) continue\n const schema = Object.hasOwn(presenceDefs, field)\n ? presenceDefs[field]\n : undefined\n if (!schema) {\n throw new A2Error(\n 'UNKNOWN_PRESENCE_FIELD',\n `contract '${name}' has no presence field '${field}'`,\n )\n }\n if (value === null) {\n validated[field] = null\n continue\n }\n const result = validateSync(schema, value, `presence field '${field}'`)\n if (result.issues) {\n throw new A2Error(\n 'INVALID_PAYLOAD',\n `invalid value for presence field '${field}' on machine '${name}'`,\n { details: result.issues },\n )\n }\n validated[field] = result.value\n }\n const store = await resolveStore()\n try {\n await requirePresence(store).set(\n nsId(sessionId),\n patch.participant,\n validated,\n {\n seen: patch.seen ?? fallbackSeen,\n // The sender's stamp is the LWW order; receipt time is the\n // fallback for stampless callers (handlers, old wire\n // clients), where receipt order is sender order — single\n // writer. Storage anchors expiry on its own clock either way.\n at: new Date(patch.at ?? Date.now()),\n ttlMs: presenceTtlMs,\n },\n )\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n }\n\n const readPresenceMap = async (\n sessionId: string,\n ): Promise<PresenceMap<P>> => {\n const store = await resolveStore()\n let rows: PresenceRow[]\n try {\n rows = await requirePresence(store).read(nsId(sessionId))\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n return foldPresenceRows(rows) as PresenceMap<P>\n }\n\n /**\n * The two-plane feed. Patches ride `subscribe` when the adapter has\n * the push tier; without it the map is re-read and diffed whenever\n * the event feed wakes, and at the poll idle ceiling while it is\n * silent — degraded means later, not lost while watched.\n */\n const streamWithPresence = (\n id: string,\n startAfter: number,\n ): AsyncIterable<ContractEvent<D> | PresencePatch | PresenceSnapshot> => {\n const ns = nsId(id)\n const outer = async function* (): AsyncGenerator<\n ContractEvent<D> | PresencePatch | PresenceSnapshot\n > {\n const store = await resolveStore()\n const api = requirePresence(store)\n\n const readRows = async (): Promise<PresenceRow[]> => {\n try {\n return await api.read(ns)\n } catch (err) {\n throw asStoreUnavailable(err)\n }\n }\n\n // What this feed has already painted, per (participant, field) —\n // the comparison state for re-read diffs.\n const painted = new Map<\n string,\n Map<string, { seen: number; atMs: number; value: string }>\n >()\n\n // One patch per (participant, field), never merged — a merged\n // stamp would let a stale field inherit a fresher sibling's\n // `seen` and survive the documented frontier reconciliation.\n const diffRows = (rows: PresenceRow[]): PresencePatch[] => {\n const patches: PresencePatch[] = []\n const live = new Map<string, Set<string>>()\n for (const row of rows) {\n let liveFields = live.get(row.participant)\n if (!liveFields) {\n liveFields = new Set()\n live.set(row.participant, liveFields)\n }\n liveFields.add(row.field)\n const stamp = {\n seen: row.seen,\n atMs: row.at.getTime(),\n value: fingerprint(row.value),\n }\n const prior = painted.get(row.participant)?.get(row.field)\n if (\n prior &&\n prior.seen === stamp.seen &&\n prior.atMs === stamp.atMs &&\n prior.value === stamp.value\n ) {\n continue\n }\n let paintedFields = painted.get(row.participant)\n if (!paintedFields) {\n paintedFields = new Map()\n painted.set(row.participant, paintedFields)\n }\n paintedFields.set(row.field, stamp)\n patches.push({\n participant: row.participant,\n values: { [row.field]: row.value },\n seen: row.seen,\n at: row.at,\n })\n }\n for (const [participant, fields] of painted) {\n for (const [field, prior] of fields) {\n if (live.get(participant)?.has(field)) continue\n fields.delete(field)\n patches.push({\n participant,\n values: { [field]: null },\n // A cleared field has no surviving row; its last painted\n // `seen` and the observation time are the honest stamps.\n seen: prior.seen,\n at: new Date(),\n })\n }\n if (fields.size === 0) painted.delete(participant)\n }\n return patches\n }\n\n const paint = (patch: PresencePatch): void => {\n let fields = painted.get(patch.participant)\n for (const [field, value] of Object.entries(patch.values)) {\n if (value === null || value === undefined) {\n fields?.delete(field)\n continue\n }\n if (!fields) {\n fields = new Map()\n painted.set(patch.participant, fields)\n }\n fields.set(field, {\n seen: patch.seen,\n atMs: patch.at.getTime(),\n value: fingerprint(value),\n })\n }\n if (fields?.size === 0) painted.delete(patch.participant)\n }\n\n // Arrivals coalesce per (participant, field): latest value wins,\n // each field keeps its own seen/at stamps (never merged — a stale\n // field must not inherit a fresher sibling's `seen`), one patch\n // per (participant, field) on drain. A stalled consumer therefore\n // holds at most the live presence cardinality, never the arrival\n // history.\n const queue = new Map<\n string,\n Map<string, { value: unknown; seen: number; at: Date }>\n >()\n let wakeQueue: (() => void) | null = null\n const enqueue = (patch: PresencePatch): void => {\n for (const [field, value] of Object.entries(patch.values)) {\n if (value === undefined) continue\n let fields = queue.get(patch.participant)\n if (!fields) {\n fields = new Map()\n queue.set(patch.participant, fields)\n }\n // Per-field LWW in the queue itself: pub/sub delivery order\n // is not apply order (two instances' PUBLISHes race), and an\n // unconditional overwrite would let an older patch swallow a\n // newer queued value that then never reaches the subscriber.\n // Ties go to the incoming patch, like every other comparator.\n const queued = fields.get(field)\n if (queued && queued.at.getTime() > patch.at.getTime()) continue\n fields.set(field, { value, seen: patch.seen, at: patch.at })\n }\n wakeQueue?.()\n }\n const dequeue = (): PresencePatch | null => {\n for (const [participant, fields] of queue) {\n for (const [field, stamp] of fields) {\n fields.delete(field)\n if (fields.size === 0) queue.delete(participant)\n return {\n participant,\n values: { [field]: stamp.value },\n seen: stamp.seen,\n at: stamp.at,\n }\n }\n queue.delete(participant)\n }\n return null\n }\n // Subscribe before the snapshot read: a patch landing between\n // the two is painted twice, never lost — repaints are idempotent.\n const unsubscribe = api.subscribe?.(ns, enqueue)\n\n const events = store.stream(ns, { startAfter })[Symbol.asyncIterator]()\n let pendingEvent: Promise<IteratorResult<Event>> | null = null\n try {\n // Exactly one snapshot before any live item: the pruned map,\n // per-field stamps exact — a reconnecting client replaces its\n // foreign entries wholesale from it.\n const snapshotRows = await readRows()\n for (const row of snapshotRows) {\n let fields = painted.get(row.participant)\n if (!fields) {\n fields = new Map()\n painted.set(row.participant, fields)\n }\n fields.set(row.field, {\n seen: row.seen,\n atMs: row.at.getTime(),\n value: fingerprint(row.value),\n })\n }\n yield { snapshot: foldPresenceRows(snapshotRows) }\n\n for (;;) {\n for (;;) {\n const patch = dequeue()\n if (!patch) break\n paint(patch)\n yield patch\n }\n pendingEvent ??= events.next()\n let woke: 'event' | 'patch' | 'tick'\n if (unsubscribe) {\n const arrival = new Promise<void>((resolve) => {\n wakeQueue = resolve\n })\n woke = await Promise.race([\n pendingEvent.then(() => 'event' as const),\n arrival.then(() => 'patch' as const),\n ])\n wakeQueue = null\n if (woke === 'patch') continue\n } else {\n const sleeper = defaultSleep(POLL_TIMINGS.idleCeilingMs)\n woke = await Promise.race([\n pendingEvent.then(() => 'event' as const),\n sleeper.promise.then(() => 'tick' as const),\n ])\n sleeper.cancel()\n }\n if (woke === 'event') {\n const result = await pendingEvent\n pendingEvent = null\n if (result.done) return\n yield toSessionEvent(id, result.value)\n }\n if (!unsubscribe) {\n for (const patch of diffRows(await readRows())) yield patch\n }\n }\n } finally {\n wakeQueue = null\n unsubscribe?.()\n // The consumer may close while an event read is in flight; its\n // settlement is no longer anyone's business.\n pendingEvent?.catch(() => {})\n await events.return?.()\n }\n }\n return outer()\n }\n\n const makeSession = <Append>(\n id: string,\n append: Append,\n trigger: Pick<StoredEvent, 'id' | 'createdAt' | 'index'> | null,\n ): Session<D, Append, P> =>\n ({\n id,\n append,\n schedule: makeSchedule(id, trigger),\n history: async (bounds?: { gte?: number; lte?: number }) =>\n (await readHistory(id, bounds)).map(toPublic),\n state: <S>(reducer: Reducer<D, S>) => readState(id, reducer),\n stream: (opts?: { startAfter?: number; presence?: boolean }) => {\n const startAfter = opts?.startAfter ?? 0\n assertStreamIndex(startAfter)\n return opts?.presence === true\n ? streamWithPresence(id, startAfter)\n : streamEvents(id, startAfter)\n },\n // Only on presence-declaring contracts — the type surface promises\n // no runtime-inert members (a2-api.md §12).\n ...(declaresPresence\n ? {\n setPresence: (patch: {\n participant: string\n values: Record<string, unknown>\n seen?: number\n at?: number\n }) => setPresence(id, patch, trigger?.index ?? 0),\n presence: () => readPresenceMap(id),\n }\n : {}),\n }) as Session<D, Append, P>\n\n // ── drain ────────────────────────────────────────────────────────\n\n const makeCtx = (\n trigger: StoredEvent,\n attempt: number,\n signal: AbortSignal,\n ): HandlerContext<D> => {\n const publicSessionId = stripNs(trigger.sessionId)\n const append: HandlerAppend<D> = async (appendName, ...events) => {\n assertAppendName(appendName)\n const generatedIds = events.map((event) => event.id === undefined)\n const withIds = await Promise.all(\n // oxlint-disable-next-line no-map-spread\n events.map(async (event, item) => {\n if (event.id !== undefined) return event\n const id = await deterministicEventId(trigger.id, appendName, item)\n return { ...event, id }\n }),\n )\n return appendCore(\n publicSessionId,\n withIds,\n 'handler',\n 'inline',\n (_rows, watchdogDueAt) => scheduleDrain(publicSessionId, watchdogDueAt),\n { index: trigger.index, attempt },\n generatedIds,\n )\n }\n return {\n event: toPublic(trigger),\n attempt,\n // The handler-scoped `setPresence` stamps `seen` with the\n // triggering event's index by default — the frontier the handler\n // provably reflects.\n session: makeSession(publicSessionId, append, trigger),\n signal,\n }\n }\n\n const abortHubs = new Map<string, AbortHub>()\n\n const createAbortHub = (\n store: A2Store,\n ns: string,\n startAfter: number,\n ): AbortHub => {\n const hub: AbortHub = {\n subscriptions: new Set(),\n seen: new Map(),\n startAfter,\n ready: Promise.resolve(),\n watch: null,\n error: null,\n iterator: null,\n stopped: false,\n }\n hub.ready = (async () => {\n const existing = await store.read(ns, { afterIndex: startAfter })\n for (const event of existing) dispatchAbortEvent(hub, event)\n const tail = existing.at(-1)?.index ?? startAfter\n const feed = store.stream(ns, { startAfter: tail })\n const iterator = feed[Symbol.asyncIterator]()\n hub.iterator = iterator\n hub.watch = (async () => {\n for (;;) {\n const { value, done } = await iterator.next()\n if (done || value === undefined || hub.stopped) return\n dispatchAbortEvent(hub, value)\n }\n })().catch((error: unknown) => {\n hub.error = error\n })\n })().catch((error: unknown) => {\n hub.error = error\n if (abortHubs.get(ns) === hub) abortHubs.delete(ns)\n throw error\n })\n abortHubs.set(ns, hub)\n return hub\n }\n\n const subscribeAbort = async (\n store: A2Store,\n ns: string,\n trigger: StoredEvent,\n abortOn: AbortMatcher,\n attempt: number,\n ): Promise<{\n signal: AbortSignal\n monitor<T>(operation: Promise<T>): Promise<T>\n close(): Promise<void>\n }> => {\n let hub = abortHubs.get(ns)\n if (!hub) hub = createAbortHub(store, ns, trigger.index)\n const activeTypes = new Set<string>()\n for (const active of hub.subscriptions) {\n for (const type of active.types) activeTypes.add(type)\n }\n const publicTrigger = toPublic(trigger)\n const subscription: AbortSubscription = {\n controller: new AbortController(),\n triggerIndex: trigger.index,\n types: new Set(abortOn.keys()),\n matches: (event) => {\n if (event.index <= trigger.index) return false\n const matcher = abortOn.get(event.type)\n if (matcher === undefined) return false\n return matcher === true\n ? true\n : matcher(toPublic(event as StoredEvent), publicTrigger, { attempt })\n },\n }\n hub.subscriptions.add(subscription)\n const needsCatchup =\n trigger.index < hub.startAfter ||\n [...subscription.types].some((type) => !activeTypes.has(type))\n if (needsCatchup) {\n const earlier = await store.read(ns, { afterIndex: trigger.index })\n hub.startAfter = Math.min(hub.startAfter, trigger.index)\n for (const event of earlier) dispatchAbortEvent(hub, event)\n }\n for (const event of hub.seen.values()) {\n if (subscription.matches(event)) subscription.controller.abort()\n }\n await hub.ready\n if (hub.error !== null) throw hub.error\n return {\n signal: subscription.controller.signal,\n monitor: async <T>(operation: Promise<T>): Promise<T> => {\n const outcome = await Promise.race([\n operation.then(\n (value) => ({ type: 'completed' as const, value }),\n (error: unknown) => ({ type: 'handler-failed' as const, error }),\n ),\n hub.watch!.then(() =>\n hub.error === null\n ? { type: 'monitor-closed' as const }\n : { type: 'monitor-failed' as const, error: hub.error },\n ),\n ])\n if (outcome.type === 'completed') return outcome.value\n if (outcome.type === 'handler-failed') throw outcome.error\n if (outcome.type === 'monitor-failed') {\n for (const active of hub.subscriptions) {\n active.controller.abort(outcome.error)\n }\n await operation.catch(() => {})\n throw outcome.error\n }\n await operation.catch(() => {})\n throw new Error('abort monitor closed while handlers were active')\n },\n close: async () => {\n hub.subscriptions.delete(subscription)\n if (hub.subscriptions.size > 0) {\n pruneAbortHub(hub)\n return\n }\n hub.stopped = true\n abortHubs.delete(ns)\n await hub.ready\n await hub.iterator?.return?.()\n await hub.watch\n },\n }\n }\n\n const returnedEvents = async (\n sessionId: string,\n trigger: StoredEvent,\n result: void | AppendInput<D> | readonly AppendInput<D>[],\n ): Promise<ReturnedEvent[]> => {\n if (result === undefined) return []\n const events = Array.isArray(result) ? [...result] : [result]\n if (events.length === 0) return []\n const withIds = await Promise.all(\n // oxlint-disable-next-line oxc/no-map-spread -- handler results remain caller-owned\n events.map(async (event, item) => {\n const withId = { ...event }\n withId.id =\n event.id ?? (await deterministicReturnedEventId(trigger.id, item))\n return withId\n }),\n )\n return validateEvents(sessionId, withIds).map((event) =>\n Object.assign(event, {\n id: event.id!,\n cause: {\n index: trigger.index,\n attempt: trigger.attemptCount,\n },\n }),\n )\n }\n\n type EventStatus =\n 'processed' | 'failed' | 'dead_lettered' | 'superseded' | 'surrendered'\n\n type EventOutcome = {\n status: EventStatus\n opensLane: boolean\n appendsEvents: boolean\n }\n\n const drainSession = (\n sessionId: string,\n watchdogDueAt?: number,\n signal?: DrainSignal,\n ): Promise<DrainResult> =>\n telemetry.span(\n 'a2.drain',\n { 'a2.contract': name, 'a2.session_id': sessionId },\n async (span) => {\n const store = await resolveStore()\n const ns = nsId(sessionId)\n const holder = crypto.randomUUID()\n type ActiveEvent = {\n attempt: number\n execution: Promise<EventOutcome>\n supersede: AbortController\n /** Resolves the tracked execution early once supersession is durable. */\n fence: (outcome: EventOutcome) => void\n /** Local lease estimate: request time + ttl — at or before the store's. */\n expiresAtMs: number\n lapsed: boolean\n }\n const active = new Map<number, ActiveEvent>()\n const excluded = new Set<number>()\n let processed = 0\n let sawFailure = false\n let schedulerArm: Promise<void> | undefined\n let heartbeat: ReturnType<typeof setInterval> | null = null\n let lapseTimer: ReturnType<typeof setTimeout> | null = null\n let retryTimer: ReturnType<typeof setTimeout> | null = null\n let renewal: Promise<void> | null = null\n let stopRenewing = false\n\n // Self-fencing at local lease lapse: the drain wrote every expiry it\n // holds (request time + ttl, at or before the store's own stamp), so\n // it can conclude \"assume a successor\" with zero I/O — including\n // while the store is unreachable or in the first tick after a stall.\n const lapseDue = (): void => {\n lapseTimer = null\n const nowMs = Date.now()\n for (const [index, entry] of active) {\n if (entry.lapsed || entry.expiresAtMs > nowMs) continue\n entry.lapsed = true\n entry.supersede.abort(\n new A2Error(\n 'CLAIM_EXPIRED',\n `the claim on event ${index} in session '${sessionId}' lapsed without renewal`,\n ),\n )\n }\n scheduleLapse()\n }\n const scheduleLapse = (): void => {\n if (lapseTimer) {\n clearTimeout(lapseTimer)\n lapseTimer = null\n }\n let next = Number.POSITIVE_INFINITY\n for (const entry of active.values()) {\n if (!entry.lapsed) next = Math.min(next, entry.expiresAtMs)\n }\n if (next === Number.POSITIVE_INFINITY) return\n lapseTimer = setTimeout(lapseDue, Math.max(0, next - Date.now()))\n ;(lapseTimer as { unref?: () => void }).unref?.()\n }\n\n // A missed beat spends lease slack; the next scheduled beat may be\n // provably too late. Retry promptly (jittered against fleet-wide\n // synchronization on a struggling store) while a lease can still be\n // saved — the lapse ends the retries naturally.\n const scheduleRenewRetry = (): void => {\n if (stopRenewing || retryTimer) return\n const nowMs = Date.now()\n const saveable = [...active.values()].some(\n (entry) => !entry.lapsed && entry.expiresAtMs > nowMs,\n )\n if (!saveable) return\n const delay = DRAIN_TIMINGS.renewRetryMs * (0.5 + Math.random() * 0.5)\n retryTimer = setTimeout(() => {\n retryTimer = null\n void renew()\n }, delay)\n ;(retryTimer as { unref?: () => void }).unref?.()\n }\n\n const alignWatchdogAt = (minimumDueAt: number): number => {\n if (watchdogDueAt === undefined) return minimumDueAt\n const beats = Math.max(\n 0,\n Math.ceil(\n (minimumDueAt - watchdogDueAt) / DRAIN_TIMINGS.claimHeartbeatMs,\n ),\n )\n return watchdogDueAt + beats * DRAIN_TIMINGS.claimHeartbeatMs\n }\n\n const requestWatchdog = (dueAt: number): void => {\n const arm = startSchedulerArm(sessionId, alignWatchdogAt(dueAt))\n if (arm) schedulerArm = arm\n }\n\n const renew = (): Promise<void> => {\n if (stopRenewing || renewal || active.size === 0) {\n return renewal ?? Promise.resolve()\n }\n const window = nextClaimWindow()\n requestWatchdog(window.watchdogAtMs)\n const claims = [...active.entries()].map(([index, entry]) => ({\n index,\n attempt: entry.attempt,\n }))\n const operation = store\n .renewClaims({\n sessionId: ns,\n holder,\n claims,\n ttlMs: window.ttlMs,\n ...(window.deadlineCapped\n ? { expiresAtMs: window.expiresAtMs }\n : {}),\n })\n .then(\n (result) => {\n for (const index of result.renewed) {\n const entry = active.get(index)\n if (entry && !entry.lapsed) {\n entry.expiresAtMs = window.expiresAtMs\n }\n }\n for (const index of result.superseded) {\n const entry = active.get(index)\n if (!entry) continue\n // Idempotent: the local lapse normally aborted this signal\n // already — this is the proof, whose job is the release.\n entry.supersede.abort(\n new A2Error(\n 'SUPERSEDED_ATTEMPT',\n `a newer attempt owns event ${index} in session '${sessionId}'`,\n ),\n )\n entry.fence({\n status: 'superseded',\n opensLane: false,\n appendsEvents: false,\n })\n }\n if (window.deadlineCapped) stopRenewing = true\n scheduleLapse()\n return undefined\n },\n () => {\n scheduleRenewRetry()\n return undefined\n },\n )\n let tracked!: Promise<void>\n tracked = operation.finally(() => {\n if (renewal === tracked) renewal = null\n })\n renewal = tracked\n return tracked\n }\n\n const runEvent = async (\n event: StoredEvent,\n supersedeSignal: AbortSignal,\n ): Promise<EventOutcome> => {\n const registration = handlers.get(event.type)\n return telemetry.span(\n 'a2.event',\n {\n 'a2.contract': name,\n 'a2.session_id': sessionId,\n 'a2.event.type': event.type,\n 'a2.event.index': event.index,\n 'a2.event.id': event.id,\n 'a2.event.attempt': event.attemptCount,\n 'a2.event.handled': registration !== undefined,\n ...(event.lane === null ? {} : { 'a2.event.lane': event.lane }),\n },\n async (eventSpan) => {\n let subscription:\n | {\n signal: AbortSignal\n monitor<T>(operation: Promise<T>): Promise<T>\n close(): Promise<void>\n }\n | undefined\n let handlerSignal = supersedeSignal\n let returned: ReturnedEvent[]\n try {\n if (registration?.abortOn) {\n subscription = await subscribeAbort(\n store,\n ns,\n event,\n registration.abortOn,\n event.attemptCount,\n )\n handlerSignal = AbortSignal.any([\n supersedeSignal,\n subscription.signal,\n ])\n }\n const operation = registration?.handler(\n makeCtx(event, event.attemptCount, handlerSignal),\n )\n const result = operation\n ? await (subscription\n ? subscription.monitor(operation)\n : operation)\n : undefined\n if (subscription) {\n await subscription.close()\n subscription = undefined\n }\n returned = await returnedEvents(sessionId, event, result)\n } catch (err) {\n if (supersedeSignal.aborted && err === supersedeSignal.reason) {\n // The handler surrendered to its own abort — identity, not\n // code, so it cannot arrive from another context. A lapse\n // is not a handler failure: no completion, no failure\n // budget spent; the claim simply expires and recovery\n // retries.\n eventSpan.setAttribute('a2.event.outcome', 'surrendered')\n return {\n status: 'surrendered',\n opensLane: false,\n appendsEvents: false,\n }\n }\n // Everything else — including a store fence rejection — is\n // adjudicated by failAttempt, which is itself fenced: a\n // genuinely superseded attempt gets 'superseded' back with\n // no mutation. One adjudicator, not two.\n eventSpan.recordError(err)\n const failure = await store.failAttempt({\n sessionId: ns,\n index: event.index,\n attempt: event.attemptCount,\n error: describeError(err),\n maxFailures: MAX_FAILURES,\n })\n eventSpan.setAttribute('a2.event.outcome', failure.outcome)\n return {\n status: failure.outcome,\n opensLane: false,\n appendsEvents: false,\n }\n } finally {\n await subscription?.close()\n }\n await renewal\n const completion = await store.completeAttempt({\n sessionId: ns,\n index: event.index,\n attempt: event.attemptCount,\n events: returned,\n })\n eventSpan.setAttribute(\n 'a2.event.outcome',\n completion.outcome === 'completed'\n ? 'processed'\n : completion.outcome,\n )\n if (completion.outcome === 'superseded') {\n return {\n status: 'superseded',\n opensLane: false,\n appendsEvents: false,\n }\n }\n if (handlerSignal.aborted) {\n eventSpan.setAttribute('a2.event.aborted', true)\n }\n return {\n status: 'processed',\n opensLane: event.lane !== null,\n appendsEvents: returned.length > 0,\n }\n },\n )\n }\n\n let claimAgain = false\n\n const start = (event: StoredEvent, expiresAtMs: number): void => {\n // Re-claiming an index this drain still tracks is durable proof\n // that the old attempt lost: our own new claim advanced the\n // ordinal. Fence the old entry before it can be confused with\n // the new one.\n const previous = active.get(event.index)\n if (previous) {\n previous.supersede.abort(\n new A2Error(\n 'SUPERSEDED_ATTEMPT',\n `a newer attempt owns event ${event.index} in session '${sessionId}'`,\n ),\n )\n previous.fence({\n status: 'superseded',\n opensLane: false,\n appendsEvents: false,\n })\n }\n const supersede = new AbortController()\n let fence!: (outcome: EventOutcome) => void\n const fenced = new Promise<EventOutcome>((resolve) => {\n fence = resolve\n })\n // The race lets a durable supersession release this slot while the\n // zombie handler keeps running — its completion and failure are\n // fenced by the store, so nothing it does from here is counted.\n let entry!: ActiveEvent\n const execution = Promise.race([\n runEvent(event, supersede.signal),\n fenced,\n ]).then((eventOutcome) => {\n // Identity-guarded: a fenced predecessor's continuation must\n // not delete the entry of the attempt that replaced it.\n if (active.get(event.index) === entry) active.delete(event.index)\n if (eventOutcome.status === 'processed') processed += 1\n if (eventOutcome.status === 'failed') {\n excluded.add(event.index)\n sawFailure = true\n }\n claimAgain ||= eventOutcome.opensLane || eventOutcome.appendsEvents\n return eventOutcome\n })\n entry = {\n attempt: event.attemptCount,\n execution,\n supersede,\n fence,\n expiresAtMs,\n lapsed: false,\n }\n active.set(event.index, entry)\n scheduleLapse()\n if (!heartbeat && !stopRenewing) {\n heartbeat = setInterval(\n () => void renew(),\n DRAIN_TIMINGS.claimHeartbeatMs,\n )\n ;(heartbeat as { unref?: () => void }).unref?.()\n }\n }\n\n let outcome: DrainOutcome = 'settled'\n let shouldClaim = true\n try {\n for (;;) {\n const signalVersion = signal?.version ?? 0\n let claim: StoreClaimAvailableResult | undefined\n if (shouldClaim) {\n const window = nextClaimWindow()\n claim = await store.claimAvailable({\n sessionId: ns,\n holder,\n ttlMs: window.ttlMs,\n ...(window.deadlineCapped\n ? { expiresAtMs: window.expiresAtMs }\n : {}),\n ...(excluded.size === 0\n ? {}\n : { excludeIndexes: [...excluded] }),\n })\n if (claim.outcome === 'claimed') {\n requestWatchdog(window.watchdogAtMs)\n if (window.deadlineCapped) stopRenewing = true\n for (const event of claim.events) {\n start(event, window.expiresAtMs)\n }\n shouldClaim = false\n }\n }\n if (active.size > 0) {\n const wake = signal?.wait(signalVersion)\n await Promise.race([\n ...[...active.values()].map((entry) => entry.execution),\n ...(wake ? [wake.promise] : []),\n ])\n wake?.cancel()\n shouldClaim =\n claimAgain ||\n active.size === 0 ||\n (signal !== undefined && signal.version !== signalVersion)\n claimAgain = false\n continue\n }\n if (!shouldClaim) {\n shouldClaim = true\n continue\n }\n if (claim === undefined) continue\n if (signal && signal.version !== signalVersion) continue\n if (claim.outcome === 'busy') {\n requestWatchdog(\n claim.retryAt.getTime() + DRAIN_TIMINGS.watchdogGraceMs,\n )\n outcome = 'busy'\n } else if (sawFailure) {\n outcome = 'stalled'\n }\n if (signal) signal.closed = true\n break\n }\n } finally {\n if (signal) signal.closed = true\n stopRenewing = true\n if (heartbeat) clearInterval(heartbeat)\n if (retryTimer) clearTimeout(retryTimer)\n await renewal\n await Promise.allSettled(\n [...active.values()].map((entry) => entry.execution),\n )\n if (lapseTimer) clearTimeout(lapseTimer)\n }\n span.setAttribute('a2.drain.processed', processed)\n span.setAttribute('a2.drain.outcome', outcome)\n return {\n settled: outcome === 'settled',\n outcome,\n processed,\n ...(schedulerArm ? { schedulerArm } : {}),\n }\n },\n )\n\n // ── public surface ───────────────────────────────────────────────\n\n const appendExternal = async (\n sessionId: string,\n mode: 'inline' | 'dispatch',\n events: Array<AppendInput<D> | PushedEvent>,\n requireDurableInitialArm = false,\n ): Promise<ContractEvent<D>[]> => {\n const pushed = events.filter(\n (event): event is PushedEvent =>\n Reflect.get(event, '~a2.pushed') === true,\n )\n if (pushed.length > 0) {\n await options.validatePush?.({ sessionId, events: pushed })\n }\n return appendCore(\n sessionId,\n events as AppendInput<D>[],\n 'external',\n mode,\n (_rows, watchdogDueAt) => scheduleDrain(sessionId, watchdogDueAt),\n undefined,\n undefined,\n requireDurableInitialArm,\n )\n }\n\n const self: A2Server<D, P> = {\n contract: serverContract,\n session(id) {\n assertSessionId(id)\n const appendInline = async (\n ...events: Array<AppendInput<D> | PushedEvent>\n ) => appendExternal(id, 'inline', events)\n const appendDispatch = async (\n ...events: Array<AppendInput<D> | PushedEvent>\n ) => appendExternal(id, 'dispatch', events)\n const append = Object.assign(appendInline, {\n dispatch: appendDispatch,\n }) as SessionAppend<D>\n return makeSession(id, append, null)\n },\n\n async drain(sessionId) {\n assertSessionId(sessionId)\n const { settled } = await drainSession(sessionId)\n return { settled }\n },\n }\n\n serverInternals.set(self, {\n settle: async () => {\n while (inFlight.size > 0) {\n await Promise.allSettled(inFlight)\n }\n },\n schedulerDrain: (sessionId, opts) => {\n assertSessionId(sessionId)\n return drainSession(sessionId, opts?.watchdogDueAt)\n },\n schedulerAppend: async (sessionId, events) => {\n if (!scheduler) {\n throw new TypeError(\n 'scheduled append delivery requires a configured scheduler adapter',\n )\n }\n assertSessionId(sessionId)\n await appendExternal(sessionId, 'inline', [...events], true)\n },\n })\n serverSchedulerBindings.set(self, { scheduler })\n\n serverInspection.set(self, {\n async listSessions(inspectionOptions) {\n const store = await resolveStore()\n if (!store.inspect) {\n throw new InspectionUnsupportedError(\n 'this store backend does not support inspection',\n )\n }\n const page = await store.inspect.listSessions({\n prefix: `${name}${NS}`,\n limit: inspectionOptions.limit,\n ...(inspectionOptions.cursor !== undefined\n ? { cursor: inspectionOptions.cursor }\n : {}),\n })\n return {\n cursor: page.cursor,\n // oxlint-disable-next-line oxc/no-map-spread -- inspection results remain adapter-owned\n sessions: page.sessions.map((session) => {\n const publicSession = { ...session }\n publicSession.sessionId = stripNs(session.sessionId)\n return publicSession\n }),\n }\n },\n async readSessionPage(sessionId, inspectionOptions) {\n assertSessionId(sessionId)\n if (\n !Number.isSafeInteger(inspectionOptions.afterIndex) ||\n inspectionOptions.afterIndex < 0 ||\n !Number.isSafeInteger(inspectionOptions.limit) ||\n inspectionOptions.limit < 1 ||\n (inspectionOptions.throughIndex !== undefined &&\n (!Number.isSafeInteger(inspectionOptions.throughIndex) ||\n inspectionOptions.throughIndex < 0))\n ) {\n throw new TypeError('invalid inspection event page bounds')\n }\n const store = await resolveStore()\n if (!store.inspect) {\n throw new InspectionUnsupportedError(\n 'this store backend does not support inspection',\n )\n }\n const ns = nsId(sessionId)\n const snapshots =\n inspectionOptions.afterIndex === 0\n ? await store.inspect.listSnapshots(ns)\n : []\n const page = store.inspect.readEvents\n ? await store.inspect.readEvents(ns, inspectionOptions)\n : await (async () => {\n const all = await store.read(ns)\n const currentFrontier = all.at(-1)?.index ?? 0\n const throughIndex = Math.min(\n inspectionOptions.throughIndex ?? currentFrontier,\n currentFrontier,\n )\n return {\n events: all\n .filter(\n (event) =>\n event.index > inspectionOptions.afterIndex &&\n event.index <= throughIndex,\n )\n .slice(0, inspectionOptions.limit),\n throughIndex,\n }\n })()\n const { events, throughIndex } = page\n if (\n !Number.isSafeInteger(throughIndex) ||\n throughIndex < 0 ||\n events.length > inspectionOptions.limit ||\n (inspectionOptions.throughIndex !== undefined &&\n inspectionOptions.afterIndex > 0 &&\n throughIndex !== inspectionOptions.throughIndex)\n ) {\n throw new A2Error(\n 'STORE_UNAVAILABLE',\n `inspection event page for session '${sessionId}' has invalid bounds`,\n )\n }\n for (let position = 0; position < events.length; position += 1) {\n if (\n events[position]!.index !==\n inspectionOptions.afterIndex + position + 1 ||\n events[position]!.index > throughIndex\n ) {\n throw new A2Error(\n 'STORE_UNAVAILABLE',\n `inspection event page for session '${sessionId}' is not contiguous`,\n )\n }\n }\n if (inspectionOptions.afterIndex < throughIndex && events.length === 0) {\n throw new A2Error(\n 'STORE_UNAVAILABLE',\n `inspection event page for session '${sessionId}' ended before index ${throughIndex}`,\n )\n }\n const lastIndex = events.at(-1)?.index ?? inspectionOptions.afterIndex\n return {\n // oxlint-disable-next-line oxc/no-map-spread -- inspection results remain adapter-owned\n events: events.map((event) => {\n const publicEvent = { ...event }\n publicEvent.sessionId = sessionId\n return publicEvent\n }),\n snapshots: snapshots.filter(\n (snapshot) => snapshot.index <= throughIndex,\n ),\n throughIndex,\n nextIndex: lastIndex < throughIndex ? lastIndex : null,\n }\n },\n })\n\n return self\n}\n\nfunction assertSessionId(id: string): void {\n if (typeof id !== 'string' || id.length === 0) {\n throw new TypeError('session id must be a non-empty string')\n }\n if (id.includes(NS)) {\n throw new TypeError('session id contains a reserved control character')\n }\n}\n\nfunction assertHistoryIndex(name: 'gte' | 'lte', value?: number): void {\n if (value !== undefined && (!Number.isSafeInteger(value) || value < 0)) {\n throw new TypeError(`history.${name} must be a non-negative safe integer`)\n }\n}\n\nfunction assertStreamIndex(value: number): void {\n if (!Number.isSafeInteger(value) || value < 0) {\n throw new TypeError('stream.startAfter must be a non-negative safe integer')\n }\n}\n\nfunction assertAppendName(name: string): void {\n if (typeof name !== 'string' || name.length === 0) {\n throw new TypeError('handler append name must be a non-empty string')\n }\n}\n\nfunction assertScheduleName(name: string): void {\n if (typeof name !== 'string' || name.length === 0) {\n throw new TypeError('schedule name must be a non-empty string')\n }\n}\n\nconst SCHEDULE_DELAY = /^(?:0|[1-9]\\d*)(?:\\.\\d+)?(ms|s|m|h|d)$/\nconst SCHEDULE_DELAY_MULTIPLIER: Record<'ms' | 's' | 'm' | 'h' | 'd', number> =\n {\n ms: 1,\n s: 1_000,\n m: 60_000,\n h: 3_600_000,\n d: 86_400_000,\n }\n\nfunction scheduleDueAt(timing: ScheduleTiming, baseTime: number): number {\n if (timing === null || typeof timing !== 'object' || Array.isArray(timing)) {\n throw new TypeError(\n \"schedule timing must contain exactly one of 'delay' or 'at'\",\n )\n }\n const record = timing as Record<string, unknown>\n const hasDelay = Object.hasOwn(record, 'delay')\n const hasAt = Object.hasOwn(record, 'at')\n if (hasDelay === hasAt) {\n throw new TypeError(\n \"schedule timing must contain exactly one of 'delay' or 'at'\",\n )\n }\n\n let dueAt: number\n if (hasAt) {\n const at = record['at']\n if (!(at instanceof Date) || !Number.isFinite(at.getTime())) {\n throw new TypeError('schedule at must be a valid Date')\n }\n dueAt = at.getTime()\n } else {\n const delay = record['delay']\n if (typeof delay !== 'string') {\n throw new TypeError(\n \"schedule delay must use ms, s, m, h, or d (for example '30s')\",\n )\n }\n const match = SCHEDULE_DELAY.exec(delay)\n const amount = match ? Number(delay.slice(0, -match[1]!.length)) : NaN\n if (!match || !Number.isFinite(amount) || amount <= 0) {\n throw new TypeError(\n \"schedule delay must be positive and use ms, s, m, h, or d (for example '30s')\",\n )\n }\n dueAt =\n baseTime +\n amount *\n SCHEDULE_DELAY_MULTIPLIER[\n match[1] as keyof typeof SCHEDULE_DELAY_MULTIPLIER\n ]\n }\n if (!Number.isFinite(dueAt)) {\n throw new TypeError('schedule due time must be a finite epoch time')\n }\n return dueAt\n}\n\nfunction assertScheduledPayload(payload: unknown): void {\n try {\n if (isJsonValue(payload, new WeakSet())) return\n } catch {\n // Proxies and hostile accessors are not stable transport values either.\n }\n throw new TypeError(\n 'session.schedule event payload must be JSON-serializable',\n )\n}\n\nfunction cloneScheduledPayload(payload: unknown): unknown {\n assertScheduledPayload(payload)\n try {\n const cloned = structuredClone(payload)\n const encoded = JSON.stringify(cloned)\n if (encoded === undefined) throw new TypeError()\n return JSON.parse(encoded) as unknown\n } catch {\n throw new TypeError(\n 'session.schedule event payload must be JSON-serializable',\n )\n }\n}\n\nfunction isJsonValue(value: unknown, ancestors: WeakSet<object>): boolean {\n if (value === null) return true\n if (typeof value === 'string' || typeof value === 'boolean') return true\n if (typeof value === 'number') {\n return Number.isFinite(value) && !Object.is(value, -0)\n }\n if (typeof value !== 'object') return false\n if (ancestors.has(value)) return false\n ancestors.add(value)\n try {\n if (Array.isArray(value)) {\n const keys = Reflect.ownKeys(value)\n if (keys.length !== value.length + 1 || !keys.includes('length')) {\n return false\n }\n for (let index = 0; index < value.length; index += 1) {\n const descriptor = Object.getOwnPropertyDescriptor(value, String(index))\n if (\n !descriptor ||\n !descriptor.enumerable ||\n !('value' in descriptor) ||\n !isJsonValue(descriptor.value, ancestors)\n ) {\n return false\n }\n }\n return true\n }\n const prototype = Object.getPrototypeOf(value)\n if (prototype !== Object.prototype) return false\n for (const key of Reflect.ownKeys(value)) {\n if (typeof key !== 'string') return false\n const descriptor = Object.getOwnPropertyDescriptor(value, key)\n if (\n !descriptor ||\n !descriptor.enumerable ||\n !('value' in descriptor) ||\n !isJsonValue(descriptor.value, ancestors)\n ) {\n return false\n }\n }\n return true\n } finally {\n ancestors.delete(value)\n }\n}\n\nfunction cloneInitial<S>(initial: S): S {\n // Defensive: a reducer that mutates state in place must not corrupt\n // the shared initialState across folds. Fall back to the original for\n // non-cloneable values (functions, class instances).\n try {\n return structuredClone(initial)\n } catch {\n return initial\n }\n}\n\n// Server-side types users need when passing custom stores or building\n// transports — re-exported so experimental-a2/server is self-sufficient.\nexport type {\n A2Store,\n A2StoreInspection,\n AppendEvent,\n Clock,\n Event,\n EventCause,\n FailAttemptResult,\n IdSource,\n StoreAppendResult,\n StoreClaimAvailableResult,\n StoreStateRead,\n PresenceRow,\n StoredEvent,\n StoredSessionPage,\n StoredSessionSummary,\n StoredSnapshot,\n} from './store.ts'\nexport type {\n ScheduledEvent,\n SchedulerAppendTask,\n SchedulerDrainTask,\n SchedulerTask,\n} from './scheduler-task.ts'\nexport type {\n AppendInput,\n Contract,\n ContractEvent,\n EventDefs,\n PresenceDefs,\n PresenceMap,\n PresencePatch,\n PresenceSnapshot,\n} from './contract.ts'\n"],"mappings":"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"}
@@ -9,3 +9,5 @@
9
9
  */
10
10
  throw new Error("experimental-a2/server is server-only — a client bundle imported it. Import the contract (a2) or the session client (experimental-a2/client, experimental-a2/react) in browser code instead.");
11
11
  //#endregion
12
+
13
+ //# sourceMappingURL=server.browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.browser.js","names":[],"sources":["../src/server.browser.ts"],"sourcesContent":["/**\n * The browser build of experimental-a2/server. There isn't one — on purpose.\n * Contracts and reducers (from `experimental-a2`) and the session client (from\n * `experimental-a2/client` / `experimental-a2/react`) are the isomorphic surface; the server is\n * where handlers and storage live. This module existing in a client\n * bundle means a `'use client'` file (or something it imports)\n * value-imported your server module.\n */\nthrow new Error(\n 'experimental-a2/server is server-only — a client bundle imported it. Import the contract (a2) or the session client (experimental-a2/client, experimental-a2/react) in browser code instead.',\n)\nexport {}\n"],"mappings":";;;;;;;;;AAQA,MAAM,IAAI,MACR,8LACF"}
package/dist/server.d.ts CHANGED
@@ -1,4 +1,4 @@
1
1
  import { a as EventDefs, c as PresencePatch, l as PresenceSnapshot, n as Contract, o as PresenceDefs, r as ContractEvent, s as PresenceMap, t as AppendInput } from "./contract-jIfaR085.js";
2
- import { a as Event, c as IdSource, d as StoreClaimAvailableResult, f as StoreStateRead, g as StoredSnapshot, h as StoredSessionSummary, i as Clock, l as PresenceRow, m as StoredSessionPage, n as A2StoreInspection, o as EventCause, p as StoredEvent, r as AppendEvent, s as FailAttemptResult, t as A2Store, u as StoreAppendResult } from "./store-C3sNAaBT.js";
3
- import { C as deliverSchedulerAppend, D as SchedulerTask, E as SchedulerDrainTask, S as createServer, T as SchedulerAppendTask, _ as Session, a as Handler, b as SessionPresence, c as HandlerEntry, d as PushValidationContext, f as PushedEvent, g as ServerOptions, h as ScheduleTiming, i as DrainableServer, l as Lane, m as ScheduleDelay, n as A2Server, o as HandlerAppend, p as PushedPresence, r as AbortSpec, s as HandlerContext, t as A2Scheduler, u as LaneContext, v as SessionAppend, w as ScheduledEvent, x as SessionSchedule, y as SessionDispatch } from "./server-YtPq7hjw.js";
2
+ import { a as Event, c as IdSource, d as StoreClaimAvailableResult, f as StoreStateRead, g as StoredSnapshot, h as StoredSessionSummary, i as Clock, l as PresenceRow, m as StoredSessionPage, n as A2StoreInspection, o as EventCause, p as StoredEvent, r as AppendEvent, s as FailAttemptResult, t as A2Store, u as StoreAppendResult } from "./store-DysUkTH3.js";
3
+ import { C as deliverSchedulerAppend, D as SchedulerTask, E as SchedulerDrainTask, S as createServer, T as SchedulerAppendTask, _ as Session, a as Handler, b as SessionPresence, c as HandlerEntry, d as PushValidationContext, f as PushedEvent, g as ServerOptions, h as ScheduleTiming, i as DrainableServer, l as Lane, m as ScheduleDelay, n as A2Server, o as HandlerAppend, p as PushedPresence, r as AbortSpec, s as HandlerContext, t as A2Scheduler, u as LaneContext, v as SessionAppend, w as ScheduledEvent, x as SessionSchedule, y as SessionDispatch } from "./server-DpvjhdoE.js";
4
4
  export { A2Scheduler, A2Server, type A2Store, type A2StoreInspection, AbortSpec, type AppendEvent, type AppendInput, type Clock, type Contract, type ContractEvent, DrainableServer, type Event, type EventCause, type EventDefs, type FailAttemptResult, Handler, HandlerAppend, HandlerContext, HandlerEntry, type IdSource, Lane, LaneContext, type PresenceDefs, type PresenceMap, type PresencePatch, type PresenceRow, type PresenceSnapshot, PushValidationContext, PushedEvent, PushedPresence, ScheduleDelay, ScheduleTiming, type ScheduledEvent, type SchedulerAppendTask, type SchedulerDrainTask, type SchedulerTask, ServerOptions, Session, SessionAppend, SessionDispatch, SessionPresence, SessionSchedule, type StoreAppendResult, type StoreClaimAvailableResult, type StoreStateRead, type StoredEvent, type StoredSessionPage, type StoredSessionSummary, type StoredSnapshot, createServer, deliverSchedulerAppend };
package/dist/server.js CHANGED
@@ -1,2 +1,2 @@
1
- import { n as deliverSchedulerAppend, t as createServer } from "./server-CcNnFnoW.js";
1
+ import { n as deliverSchedulerAppend, t as createServer } from "./server-Duw6MVlB.js";
2
2
  export { createServer, deliverSchedulerAppend };
@@ -286,6 +286,14 @@ interface A2Store {
286
286
  * `read()` when its state schema no longer accepts the cached value.
287
287
  */
288
288
  readState(sessionId: string, reducerName: string): Promise<StoreStateRead>;
289
+ /**
290
+ * Optional batched `readState` — one consistent snapshot-plus-tail read
291
+ * per session id, aligned positionally with the input (duplicates
292
+ * allowed). Each element has its own frontier; the batch makes no
293
+ * cross-session consistency claim. Core falls back to parallel
294
+ * `readState` calls when absent.
295
+ */
296
+ readStates?(sessionIds: string[], reducerName: string): Promise<StoreStateRead[]>;
289
297
  /**
290
298
  * Writes a disposable reducer cache. Guard this operation so a slower
291
299
  * concurrent writer can never clobber a further-along snapshot
@@ -336,4 +344,5 @@ interface A2Store {
336
344
  }): AsyncIterable<Event>;
337
345
  }
338
346
  //#endregion
339
- export { Event as a, IdSource as c, StoreClaimAvailableResult as d, StoreStateRead as f, StoredSnapshot as g, StoredSessionSummary as h, Clock as i, PresenceRow as l, StoredSessionPage as m, A2StoreInspection as n, EventCause as o, StoredEvent as p, AppendEvent as r, FailAttemptResult as s, A2Store as t, StoreAppendResult as u };
347
+ export { Event as a, IdSource as c, StoreClaimAvailableResult as d, StoreStateRead as f, StoredSnapshot as g, StoredSessionSummary as h, Clock as i, PresenceRow as l, StoredSessionPage as m, A2StoreInspection as n, EventCause as o, StoredEvent as p, AppendEvent as r, FailAttemptResult as s, A2Store as t, StoreAppendResult as u };
348
+ //# sourceMappingURL=store-DysUkTH3.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store-DysUkTH3.d.ts","names":[],"sources":["../src/store.ts"],"mappings":";;;KAaY;EACV;EACA;EACA;;EAEA;EACA;EACA,WAAW;;;KAID;EACV;EACA;;EAEA;;;;;;;KAQU,cAAc;;EAExB,OAAO;;EAEP;;EAEA,aAAa;;EAEb;;EAEA;;EAEA,gBAAgB;;EAEhB,eAAe;;EAEf;;EAEA;;EAEA,gBAAgB;;EAEhB;;EAEA,cAAc;;EAEd;;EAEA;;EAEA,UAAU;;;KAIA;EACV;EACA;EACA;EACA;;EAEA;;EAEA;EACA,cAAc;EACd,WAAW;;;;;;;;;KAUD;EACV;EACA;EACA;EACA;EACA,IAAI;EACJ,WAAW;;;KAID;EACV;EACA;EACA,WAAW;;;KAID;;EAEV;IAAY;IAAe;;;EAE3B,QAAQ;;KAGE;EACV,UAAU;;EAEV;;KAGU;EACV,QAAQ;;EAER;;;;;;;KAQU;EACV,aAAa;;IAEX;IACA;IACA;MACE,QAAQ;;;;;;EAMZ,YACE,mBACA;IAAW;IAAoB;IAAuB;MACrD,QAAQ;EACX,cAAc,oBAAoB,QAAQ;;;KAIhC;EACN;EAAoB,QAAQ;;EAC5B;EAAiB,SAAS;;EAC1B;;;KAGM;EACR;EAAsB,QAAQ;;EAAoB;;;KAG1C;;EAEV;;EAEA;;;KAIU;EACV;EACA;;;KAIU;EACV;EACA;;EAEA;;EAEA,QAAQ;;EAER;;EAEA;;;KAIU,gBAAgB;EAAgB;;;KAGhC;EACV,QAAQ;;EAER;;;;;;;KAQU;EACV,OAAO;;;KAIG;UAQK;;;;;;;;;;;;;;;;;;;;;;;EAuBf,OAAO,mBAAmB,QAAQ,gBAAgB,QAAQ;;EAG1D,KACE,mBACA;IAAS;IAAqB;MAC7B,QAAQ;;;;;;;;EASX,eAAe;IACb;IACA;IACA;IACA;IACA;MACE,QAAQ;;;;;;;;;;EAWZ,YAAY;IACV;IACA;IACA;MAAmB;MAAe;;IAClC;IACA;MACE,QAAQ;;;;;;EAOZ,gBAAgB;IACd;IACA;IACA;IACA,QAAQ;MACN,QAAQ;;;;;;EAOZ,YAAY;IACV;IACA;IACA;IACA;IACA;MACE,QAAQ;;;;;;;EAQZ,UAAU,mBAAmB,sBAAsB,QAAQ;;;;;;;;EAS3D,YACE,sBACA,sBACC,QAAQ;;;;;;EAOX,YACE,mBACA,qBACA,eACA,iBACC;;;;;;;EAQH;;;;;;;;;IASE,IACE,YACA,qBACA,QAAQ,gCACR;MAAQ;MAAc,IAAI;MAAM;QAC/B;;IAGH,KAAK,aAAa,QAAQ;;;;;;;IAQ1B,WAAW,YAAY,UAAU,OAAO;;;EAI1C,UAAU;;;;;;;;EASV,OACE,mBACA;IAAS;MACR,cAAc"}
@@ -3,3 +3,5 @@ const SYSTEM_CLOCK = { now: () => /* @__PURE__ */ new Date() };
3
3
  const RANDOM_IDS = () => crypto.randomUUID();
4
4
  //#endregion
5
5
  export { SYSTEM_CLOCK as n, RANDOM_IDS as t };
6
+
7
+ //# sourceMappingURL=store-N8PXxDAS.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store-N8PXxDAS.js","names":[],"sources":["../src/store.ts"],"sourcesContent":["/**\n * The A2Store interface — the storage contract every store backend\n * implements. See specs/a2-implementation.md §2–3.\n *\n * This is the whole storage contract: append, read, dispatch claims,\n * failure markers, snapshots, and the live stream. The scheduler\n * needs nothing extra — the armed queue message is its own state, and\n * the store is the only thing it consults.\n */\n\nimport type { PresencePatch } from './contract.ts'\n\n/** A stored event, as the public API exposes it. */\nexport type Event = {\n id: string\n type: string\n payload: unknown\n /** Position in the session's event log, from 1. */\n index: number\n sessionId: string\n createdAt: Date\n}\n\n/** The handler dispatch whose append first persisted a child event. */\nexport type EventCause = {\n index: number\n attempt: number\n /** Size of one named handler append, used to reject truncated retries. */\n batchSize?: number\n}\n\n/**\n * What the store persists: immutable event history, including its causal edge,\n * plus derived dispatch and failure bookkeeping. The bookkeeping is disposable;\n * the event and its cause are not.\n */\nexport type StoredEvent = Event & {\n /** Same-session handler dispatch that appended this event; null means root. */\n cause: EventCause | null\n /** Session-scoped serial execution key resolved when the event is appended. */\n lane: string | null\n /** Adapter clock time recorded by append settlement, completion, or manual skip; null while pending. */\n processedAt: Date | null\n /** Dispatch attempt that completed this event; null without dispatch or while pending. */\n processedByAttempt: number | null\n /** Exact ordered child ids atomically returned by the completing attempt. */\n returnedEventIds: string[] | null\n /** Adapter clock time recorded by the first durable dispatch claim. */\n firstClaimedAt: Date | null\n /** Adapter clock time recorded by the most recent durable dispatch claim. */\n lastClaimedAt: Date | null\n /** Durable dispatch claims, including claims abandoned by hard kills. */\n attemptCount: number\n /** Current dispatch holder; null when the event is not claimed. */\n claimHolder: string | null\n /** Adapter clock expiry for the current dispatch claim. */\n claimExpiresAt: Date | null\n /** Caught handler failures. This alone drives dead-lettering. */\n failureCount: number\n /** Adapter clock time recorded by the most recent caught handler failure. */\n lastFailedAt: Date | null\n /** Dispatch attempt that produced the most recent caught handler failure. */\n lastFailedAttempt: number | null\n /** The last handler failure, stringified. */\n lastError: string | null\n /** Adapter clock time recorded when dead-lettered; null otherwise. */\n failedAt: Date | null\n}\n\n/** Durable, read-only session metadata for administrative inspection. */\nexport type StoredSessionSummary = {\n sessionId: string\n eventCount: number\n pendingCount: number\n failedCount: number\n /** Durable dispatch claims across every event in the session. */\n attemptCount: number\n /** Caught handler failures across every event in the session. */\n failureCount: number\n firstEventAt: Date\n updatedAt: Date\n}\n\n/**\n * One live presence value, as `A2Store.presence.read` returns it. The\n * row is the LWW unit — one participant's one field. `at` is the\n * sender's stamp, the LWW comparator. `expiresAt` is the storage's\n * own clock at the applied set plus its `ttlMs` — never derived from\n * the sender stamp; a row is live strictly before it.\n */\nexport type PresenceRow = {\n participant: string\n field: string\n value: unknown\n seen: number\n at: Date\n expiresAt: Date\n}\n\n/** Metadata for the latest cached fold of one reducer. */\nexport type StoredSnapshot = {\n reducerName: string\n index: number\n updatedAt: Date\n}\n\n/** One consistent cache-plus-tail read for a reducer fold. */\nexport type StoreStateRead = {\n /** The latest cached fold for this reducer, if one exists. */\n snapshot: { index: number; state: unknown } | null\n /** Immutable events strictly after `snapshot.index`, or the full log on a miss. */\n events: Event[]\n}\n\nexport type StoredSessionPage = {\n sessions: StoredSessionSummary[]\n /** Opaque backend cursor; null means there is no next page. */\n cursor: string | null\n}\n\nexport type StoredEventPage = {\n events: StoredEvent[]\n /** Fixed inclusive log frontier shared by every page in one inspection. */\n throughIndex: number\n}\n\n/**\n * Optional read-only administration implemented by A2's shipped stores.\n * It is separate from the correctness contract so custom stores do not\n * need to expose storage-wide discovery merely to process events.\n */\nexport type A2StoreInspection = {\n listSessions(options: {\n /** Storage namespace prefix, including the contract separator. */\n prefix: string\n cursor?: string\n limit: number\n }): Promise<StoredSessionPage>\n /**\n * A bounded event page for read-only administration. The first page captures\n * `throughIndex`; callers pass it back so concurrent appends cannot extend a\n * walk indefinitely. Optional for custom stores; A2 falls back to `read()`.\n */\n readEvents?(\n sessionId: string,\n options: { afterIndex: number; throughIndex?: number; limit: number },\n ): Promise<StoredEventPage>\n listSnapshots(sessionId: string): Promise<StoredSnapshot[]>\n}\n\n/** The result of atomically claiming every currently eligible event. */\nexport type StoreClaimAvailableResult =\n | { outcome: 'claimed'; events: StoredEvent[] }\n | { outcome: 'busy'; retryAt: Date }\n | { outcome: 'settled' }\n\n/** A completion may lose to a newer claim or an earlier completion. */\nexport type CompleteAttemptResult =\n { outcome: 'completed'; events: StoredEvent[] } | { outcome: 'superseded' }\n\n/** The result of one claim-renewal heartbeat, both lists in append order. */\nexport type RenewClaimsResult = {\n /** Listed claims that remain owned by the holder. */\n renewed: number[]\n /** Listed claims whose event a newer attempt has durably taken. */\n superseded: number[]\n}\n\n/** The result of atomically recording a caught handler failure. */\nexport type FailAttemptResult = {\n outcome: 'failed' | 'dead_lettered' | 'superseded'\n failureCount: number\n}\n\n/** Input to `A2Store.append` — already validated by the machine. */\nexport type AppendEvent = {\n type: string\n payload: unknown\n /** Caller-supplied idempotency key; generated when absent. */\n id?: string\n /** Internal causal edge supplied atomically by handler `session.append`. */\n cause?: EventCause\n /** Session-scoped serial execution key resolved before persistence. */\n lane?: string\n /** Internal hint: settle this event in the append transaction; no handler is registered. */\n settled?: true\n}\n\n/** A handler-returned event with the deterministic id retries require. */\nexport type ReturnedEvent = AppendEvent & { id: string }\n\n/** The rows written by an append and the session's pending state. */\nexport type StoreAppendResult = {\n events: StoredEvent[]\n /** Whether the session contains an event without a completion marker. */\n hasPending: boolean\n}\n\n/**\n * An injectable clock. Adapters take one so tests can drive claim\n * expiry, failure timestamps, and (later) stuck-session detection\n * deterministically — against real storage, no mocking.\n */\nexport type Clock = {\n now(): Date\n}\n\n/** An injectable id source for generated event ids. */\nexport type IdSource = () => string\n\nexport const SYSTEM_CLOCK: Clock = {\n now: () => new Date(),\n}\n\nexport const RANDOM_IDS: IdSource = () => crypto.randomUUID()\n\nexport interface A2Store {\n /**\n * Accepts a batch; the batch is atomic — one transaction, consecutive\n * `index`es, all-or-nothing. The idempotency key covers the whole\n * operation, not each item: if *every* event's `id` already exists in\n * this session, this is a retry of a committed batch whose ack was\n * lost — return the existing rows as success. If only *some* ids\n * exist, the caller mixed an already-sent batch with fresh events —\n * always a caller bug — so throw `A2Error('PARTIAL_DUPLICATE_BATCH')`.\n * Events carrying `settled: true` get `processedAt` in this same atomic\n * operation, with no dispatch claim or `processedByAttempt`. The result's\n * `hasPending` reflects the whole session in the same atomic operation,\n * including older events and idempotent retries.\n *\n * An event carrying `cause` is a handler append, fenced by attempt\n * currency: accept it only while `cause.attempt` is still the parent\n * event's latest attempt and the parent is not dead-lettered; otherwise\n * throw `A2Error('SUPERSEDED_ATTEMPT')` and write nothing. The check is\n * part of this atomic operation and must serialize against a concurrent\n * `claimAvailable` — an unlocked read of the parent admits write skew.\n * The idempotent-replay path runs first, so a batch whose ids all exist\n * replays regardless of the current attempt.\n */\n append(sessionId: string, events: AppendEvent[]): Promise<StoreAppendResult>\n\n /** Events for one session, oldest first. Bounds form `(afterIndex, throughIndex]`. */\n read(\n sessionId: string,\n opts?: { afterIndex?: number; throughIndex?: number },\n ): Promise<StoredEvent[]>\n\n /**\n * Atomically claims every eligible pending event. Unlaned events are all\n * independently eligible. Within a lane, only the lowest-index unfinished\n * event is eligible. A live claim produces `busy` only when it is the sole\n * remaining obstacle to actionable work. Claimed events are returned in event-log\n * order. Excluded rows remain lane barriers.\n */\n claimAvailable(options: {\n sessionId: string\n holder: string\n ttlMs: number\n expiresAtMs?: number\n excludeIndexes?: readonly number[]\n }): Promise<StoreClaimAvailableResult>\n\n /**\n * Renews the listed live claims still owned by `holder`. Each listed claim\n * carries the attempt ordinal the holder owns. `renewed` lists the claims\n * that remain owned after the operation; `superseded` lists the claims\n * whose event's `attemptCount` has durably passed the listed attempt. An\n * expired claim no successor has taken appears in neither list — its\n * attempt may still complete (`completeAttempt` is the fence), so it is\n * not reported as lost. Renewal never revives an expired claim.\n */\n renewClaims(options: {\n sessionId: string\n holder: string\n claims: readonly { index: number; attempt: number }[]\n ttlMs: number\n expiresAtMs?: number\n }): Promise<RenewClaimsResult>\n\n /**\n * Atomically completes one current attempt and appends its returned events.\n * Retrying a committed completion with the same attempt and deterministic\n * child ids returns the existing children. A stale attempt never appends.\n */\n completeAttempt(options: {\n sessionId: string\n index: number\n attempt: number\n events: ReturnedEvent[]\n }): Promise<CompleteAttemptResult>\n\n /**\n * Atomically records a caught failure for one claimed attempt. A stale\n * attempt cannot poison a processed event or a newer dispatch. Accepted\n * failures record the operation's clock time.\n */\n failAttempt(options: {\n sessionId: string\n index: number\n attempt: number\n error: string\n maxFailures: number\n }): Promise<FailAttemptResult>\n\n /**\n * Reads a reducer snapshot and its event tail as one consistent adapter\n * operation. On a cache miss, `snapshot` is null and `events` is the full\n * log. The snapshot is untrusted; core may reject it and issue a full\n * `read()` when its state schema no longer accepts the cached value.\n */\n readState(sessionId: string, reducerName: string): Promise<StoreStateRead>\n\n /**\n * Optional batched `readState` — one consistent snapshot-plus-tail read\n * per session id, aligned positionally with the input (duplicates\n * allowed). Each element has its own frontier; the batch makes no\n * cross-session consistency claim. Core falls back to parallel\n * `readState` calls when absent.\n */\n readStates?(\n sessionIds: string[],\n reducerName: string,\n ): Promise<StoreStateRead[]>\n\n /**\n * Writes a disposable reducer cache. Guard this operation so a slower\n * concurrent writer can never clobber a further-along snapshot\n * (`where up_to_index < excluded.up_to_index`).\n */\n putSnapshot(\n sessionId: string,\n reducerName: string,\n index: number,\n state: unknown,\n ): Promise<void>\n\n /**\n * Optional ephemeral-plane capability (specs/a2-implementation.md\n * §15.1) — optional like snapshots are. Values arrive already\n * validated by core; adapters store them opaquely. Presence never\n * touches the event log: no index, no history row, no recovery arm.\n */\n presence?: {\n /**\n * Field-wise last-writer-wins merge of one participant's values:\n * a field whose existing row has a strictly newer `at` (the\n * sender's stamp) is left untouched; `null` deletes the row. Every\n * applied write refreshes that field's expiry to the storage's own\n * clock plus `ttlMs` — the sender stamp orders writes but never\n * anchors their lifetime.\n */\n set(\n ns: string,\n participant: string,\n values: Record<string, unknown | null>,\n meta: { seen: number; at: Date; ttlMs: number },\n ): Promise<void>\n\n /** The current map, pruned of rows at or past their `expiresAt`. */\n read(ns: string): Promise<PresenceRow[]>\n\n /**\n * Push-tier patch delivery; present only on backends with a real\n * broadcast primitive. Without it the backend is the degraded\n * tier: live feeds surface presence by re-reading on their\n * existing poll cadence.\n */\n subscribe?(ns: string, onPatch: (patch: PresencePatch) => void): () => void\n }\n\n /** Read-only operational data used by `experimental-a2/devtools/server`. */\n inspect?: A2StoreInspection\n\n /**\n * A live feed of one session's events, starting after `startAfter`\n * (exclusive). Transport is the backend's choice — in-process pub/sub,\n * polling, LISTEN/NOTIFY — callers never branch on which. The iterable\n * ends when the consumer calls `return()` (e.g. a disconnecting SSE\n * client) and must deliver events appended after subscription.\n */\n stream(\n sessionId: string,\n opts?: { startAfter?: number },\n ): AsyncIterable<Event>\n}\n"],"mappings":";AAkNA,MAAa,eAAsB,EACjC,2BAAW,IAAI,KAAK,EACtB;AAEA,MAAa,mBAA6B,OAAO,WAAW"}
@@ -6,3 +6,5 @@ const decodeReturnedEventIds = (value) => {
6
6
  };
7
7
  //#endregion
8
8
  export { decodeReturnedEventIds as t };
9
+
10
+ //# sourceMappingURL=store-codec-DTG0Ftek.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store-codec-DTG0Ftek.js","names":[],"sources":["../src/store-codec.ts"],"sourcesContent":["export const decodeReturnedEventIds = (value: unknown): string[] => {\n const decoded: unknown = typeof value === 'string' ? JSON.parse(value) : value\n if (\n !Array.isArray(decoded) ||\n decoded.some((eventId) => typeof eventId !== 'string')\n ) {\n throw new TypeError('stored event has invalid returned event ids')\n }\n return decoded\n}\n"],"mappings":";AAAA,MAAa,0BAA0B,UAA6B;CAClE,MAAM,UAAmB,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;CACzE,IACE,CAAC,MAAM,QAAQ,OAAO,KACtB,QAAQ,MAAM,YAAY,OAAO,YAAY,QAAQ,GAErD,MAAM,IAAI,UAAU,6CAA6C;CAEnE,OAAO;AACT"}
@@ -1,4 +1,4 @@
1
- import { c as IdSource, i as Clock, t as A2Store } from "./store-C3sNAaBT.js";
1
+ import { c as IdSource, i as Clock, t as A2Store } from "./store-DysUkTH3.js";
2
2
  //#region src/store-memory.d.ts
3
3
  type MemoryStoreOptions = {
4
4
  /** Injectable clock — every stored timestamp comes from here. */
@@ -8,4 +8,5 @@ type MemoryStoreOptions = {
8
8
  };
9
9
  declare function memory(options?: MemoryStoreOptions): A2Store;
10
10
  //#endregion
11
- export { MemoryStoreOptions, memory };
11
+ export { MemoryStoreOptions, memory };
12
+ //# sourceMappingURL=store-memory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store-memory.d.ts","names":[],"sources":["../src/store-memory.ts"],"mappings":";;KA2BY;;EAEV,QAAQ;;EAER,MAAM;;iBAyEQ,OAAO,UAAS,qBAA0B"}
@@ -1,5 +1,5 @@
1
1
  import { t as A2Error } from "./errors-BQuJpe82.js";
2
- import { g as nullProtoRecord } from "./internal-aEotMzu_.js";
2
+ import { g as nullProtoRecord } from "./internal-DstsI6Re.js";
3
3
  import { t as idempotentReplay } from "./idempotent-replay-DuqEkYA7.js";
4
4
  import { n as SYSTEM_CLOCK, t as RANDOM_IDS } from "./store-N8PXxDAS.js";
5
5
  //#region src/store-memory.ts
@@ -162,6 +162,18 @@ function memory(options = {}) {
162
162
  }
163
163
  return inserted;
164
164
  };
165
+ const readStateOf = (sessionId, reducerName) => {
166
+ const snap = snapshots.get(`${sessionId}\u0000${reducerName}`);
167
+ const snapshot = snap ? {
168
+ index: snap.index,
169
+ state: structuredClone(snap.state)
170
+ } : null;
171
+ const afterIndex = snapshot?.index ?? 0;
172
+ return {
173
+ snapshot,
174
+ events: (sessions.get(sessionId) ?? []).filter((row) => row.index > afterIndex).map(toEvent)
175
+ };
176
+ };
165
177
  return {
166
178
  async append(sessionId, events) {
167
179
  if (events.length === 0) return appendResult(sessionId, []);
@@ -304,16 +316,10 @@ function memory(options = {}) {
304
316
  };
305
317
  },
306
318
  async readState(sessionId, reducerName) {
307
- const snap = snapshots.get(`${sessionId}\u0000${reducerName}`);
308
- const snapshot = snap ? {
309
- index: snap.index,
310
- state: structuredClone(snap.state)
311
- } : null;
312
- const afterIndex = snapshot?.index ?? 0;
313
- return {
314
- snapshot,
315
- events: (sessions.get(sessionId) ?? []).filter((row) => row.index > afterIndex).map(toEvent)
316
- };
319
+ return readStateOf(sessionId, reducerName);
320
+ },
321
+ async readStates(sessionIds, reducerName) {
322
+ return sessionIds.map((sessionId) => readStateOf(sessionId, reducerName));
317
323
  },
318
324
  async putSnapshot(sessionId, reducerName, index, state) {
319
325
  const key = `${sessionId}\u0000${reducerName}`;
@@ -523,3 +529,5 @@ function memory(options = {}) {
523
529
  }
524
530
  //#endregion
525
531
  export { memory };
532
+
533
+ //# sourceMappingURL=store-memory.js.map