experimental-a2 0.10.0 → 0.11.0

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 (121) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/dist/actor-D_54lz_1.d.ts +310 -0
  3. package/dist/actor-D_54lz_1.d.ts.map +1 -0
  4. package/dist/actor-client.d.ts +13 -4
  5. package/dist/actor-client.d.ts.map +1 -1
  6. package/dist/actor-client.js +63 -7
  7. package/dist/actor-client.js.map +1 -1
  8. package/dist/actor-react.d.ts +5 -4
  9. package/dist/actor-react.d.ts.map +1 -1
  10. package/dist/actor-react.js +16 -2
  11. package/dist/actor-react.js.map +1 -1
  12. package/dist/actor.d.ts +2 -176
  13. package/dist/actor.js +13 -2
  14. package/dist/actor.js.map +1 -1
  15. package/dist/ai-server.d.ts +1 -1
  16. package/dist/ai-server.js +2 -2
  17. package/dist/ai.d.ts +1 -1
  18. package/dist/ai.js +1 -1
  19. package/dist/client-Bf6uSEAk.js +1342 -0
  20. package/dist/client-Bf6uSEAk.js.map +1 -0
  21. package/dist/client-P_NNNRM-.d.ts +243 -0
  22. package/dist/client-P_NNNRM-.d.ts.map +1 -0
  23. package/dist/client.d.ts +2 -208
  24. package/dist/client.js +2 -1206
  25. package/dist/errors-DCk6ch5n.js.map +1 -1
  26. package/dist/errors-DvhSXnxk.d.ts +28 -0
  27. package/dist/errors-DvhSXnxk.d.ts.map +1 -0
  28. package/dist/index.d.ts +3 -35
  29. package/dist/{internal-DRXJ56EI.js → internal-Dq2qYxou.js} +2 -2
  30. package/dist/{internal-DRXJ56EI.js.map → internal-Dq2qYxou.js.map} +1 -1
  31. package/dist/platform-B4TnJtWu.js +34 -0
  32. package/dist/platform-B4TnJtWu.js.map +1 -0
  33. package/dist/react.d.ts +3 -1
  34. package/dist/react.d.ts.map +1 -1
  35. package/dist/react.js +2 -1
  36. package/dist/react.js.map +1 -1
  37. package/dist/scheduler-qstash.d.ts +2 -2
  38. package/dist/scheduler-qstash.js +3 -2
  39. package/dist/scheduler-qstash.js.map +1 -1
  40. package/dist/scheduler-vercel.d.ts +2 -2
  41. package/dist/scheduler-vercel.js +2 -2
  42. package/dist/{server-DlLyvaSH.js → server-Dkz2a84E.js} +165 -62
  43. package/dist/server-Dkz2a84E.js.map +1 -0
  44. package/dist/{server-DgCrSuhB.d.ts → server-DwPrMqHB.d.ts} +2 -2
  45. package/dist/{server-DgCrSuhB.d.ts.map → server-DwPrMqHB.d.ts.map} +1 -1
  46. package/dist/server.d.ts +2 -2
  47. package/dist/server.js +1 -1
  48. package/dist/{store-DGHeBtIQ.d.ts → store-DtDOWLSn.d.ts} +4 -5
  49. package/dist/{store-DGHeBtIQ.d.ts.map → store-DtDOWLSn.d.ts.map} +1 -1
  50. package/dist/store-N8PXxDAS.js.map +1 -1
  51. package/dist/store-memory.d.ts +1 -1
  52. package/dist/store-memory.js +1 -1
  53. package/dist/{store-polling-6DW7F1DT.js → store-polling-CmxUbV93.js} +56 -7
  54. package/dist/store-polling-CmxUbV93.js.map +1 -0
  55. package/dist/store-postgres.d.ts +6 -4
  56. package/dist/store-postgres.d.ts.map +1 -1
  57. package/dist/store-postgres.js +701 -53
  58. package/dist/store-postgres.js.map +1 -1
  59. package/dist/store-presence-polling-C7-XZyW9.js +94 -0
  60. package/dist/store-presence-polling-C7-XZyW9.js.map +1 -0
  61. package/dist/store-redis-http.d.ts +2 -2
  62. package/dist/store-redis-http.d.ts.map +1 -1
  63. package/dist/store-redis-http.js +184 -38
  64. package/dist/store-redis-http.js.map +1 -1
  65. package/dist/{store-redis-core-z-ykbyMg.js → store-redis-notify-BUCyXOn0.js} +491 -27
  66. package/dist/store-redis-notify-BUCyXOn0.js.map +1 -0
  67. package/dist/store-redis.d.ts +5 -13
  68. package/dist/store-redis.d.ts.map +1 -1
  69. package/dist/store-redis.js +27 -271
  70. package/dist/store-redis.js.map +1 -1
  71. package/dist/store-sqlite.d.ts +1 -1
  72. package/dist/store-sqlite.js +1 -1
  73. package/dist/{wire--yji6mO3.js → wire-BO5wWCb1.js} +18 -16
  74. package/dist/wire-BO5wWCb1.js.map +1 -0
  75. package/docs/actors/04-routes.mdx +40 -8
  76. package/docs/guides/03-react.mdx +52 -10
  77. package/docs/guides/05-production.mdx +54 -5
  78. package/docs/guides/09-presence.mdx +12 -7
  79. package/docs/guides/10-transports.mdx +15 -2
  80. package/docs/reference/01-api.mdx +60 -16
  81. package/docs/reference/02-errors.mdx +45 -11
  82. package/examples/playground/package.json +1 -1
  83. package/package.json +1 -1
  84. package/src/actor-client.ts +114 -14
  85. package/src/actor-react.ts +18 -3
  86. package/src/actor.ts +16 -1
  87. package/src/client-errors.ts +51 -0
  88. package/src/client.ts +253 -96
  89. package/src/errors.ts +4 -9
  90. package/src/index.ts +1 -1
  91. package/src/internal.ts +1 -1
  92. package/src/postgres-notification-scope.ts +134 -0
  93. package/src/postgres-notifications.ts +244 -0
  94. package/src/postgres-pool.ts +65 -0
  95. package/src/postgres-resources.ts +185 -0
  96. package/src/presence-recovery.ts +120 -0
  97. package/src/react.ts +3 -0
  98. package/src/redis-http-subscriptions.ts +199 -0
  99. package/src/server.ts +146 -19
  100. package/src/session-socket.ts +25 -7
  101. package/src/sse.ts +17 -0
  102. package/src/store-polling.ts +32 -12
  103. package/src/store-postgres.ts +292 -75
  104. package/src/store-presence-polling.ts +125 -0
  105. package/src/store-redis-core.ts +37 -30
  106. package/src/store-redis-http.ts +51 -45
  107. package/src/store-redis-notify.ts +464 -0
  108. package/src/store-redis.ts +9 -364
  109. package/src/store.ts +3 -4
  110. package/src/stream-activity.ts +32 -0
  111. package/src/wire.ts +39 -15
  112. package/dist/actor-shared-USo5MyuF.d.ts +0 -136
  113. package/dist/actor-shared-USo5MyuF.d.ts.map +0 -1
  114. package/dist/actor.d.ts.map +0 -1
  115. package/dist/client.d.ts.map +0 -1
  116. package/dist/client.js.map +0 -1
  117. package/dist/index.d.ts.map +0 -1
  118. package/dist/server-DlLyvaSH.js.map +0 -1
  119. package/dist/store-polling-6DW7F1DT.js.map +0 -1
  120. package/dist/store-redis-core-z-ykbyMg.js.map +0 -1
  121. package/dist/wire--yji6mO3.js.map +0 -1
@@ -1,136 +0,0 @@
1
- import { h as StandardSchemaV1 } from "./reducer-DJKWm3cp.js";
2
- import { f as ScheduleTiming } from "./server-DgCrSuhB.js";
3
- //#region src/actor-shared.d.ts
4
- /**
5
- * A handler answered by throwing `NonRetriableError`: the event
6
- * settled, the state did not change. Isomorphic — the server raises it
7
- * from calls and `fetch()` serializes it as a 409; the client's `call`
8
- * proxy revives it from that response.
9
- */
10
- declare class ActorRefusedError extends Error {
11
- /** The refused event's name. */
12
- readonly event: string;
13
- /** The refused event's message id. */
14
- readonly messageId: string;
15
- constructor(event: string, messageId: string, message: string);
16
- }
17
- /**
18
- * The declaration an actor is defined over: its state shape and its
19
- * event vocabulary, as types. Core A2 contracts are schemas because
20
- * the wire is untrusted; actor protocols are types because your
21
- * server is trusted — same contract-first design language, dialed to
22
- * the trust level.
23
- */
24
- type ActorProtocol = {
25
- state: object;
26
- events: object;
27
- /**
28
- * Optional third vocabulary: presence field → value type. Ephemeral
29
- * audience state (who is here, cursors), replicated to subscribers
30
- * and never stored in the log. Declaring it requires `presence:
31
- * true` in the actor options — the wire bit types cannot carry.
32
- */
33
- presence?: object;
34
- };
35
- /** The protocol's presence vocabulary, `never` when undeclared. */
36
- type ActorPresenceOf<D extends ActorProtocol> = D extends {
37
- presence: infer P extends object;
38
- } ? P : never;
39
- /** A `setPresence` patch: changed fields, `null` clears one. */
40
- type ActorPresenceValues<P> = { [F in keyof P & string]?: P[F] | null; };
41
- /**
42
- * The replicated presence map: participant → field → latest value,
43
- * last write wins per field. Values are peer-authored — render them
44
- * like user input.
45
- */
46
- type ActorPresenceMap<P> = {
47
- [participant: string]: { [F in keyof P & string]?: {
48
- value: P[F];
49
- seen: number;
50
- at: Date;
51
- }; };
52
- };
53
- /**
54
- * The typed self-send surface: one method per declared event —
55
- * `ctx.send.transfer({ ref, amount })`. Buffered, not immediate: every
56
- * send requested during a handler commits atomically with that
57
- * handler's completion (a serial handler's state commit, a concurrent
58
- * handler's settlement), riding core's returned-events semantics — so
59
- * a reserve-and-trigger can never half-happen, and re-runs converge on
60
- * the same deterministic message ids.
61
- */
62
- type ActorSend<E> = { readonly [K in keyof E]: {} extends E[K] ? (input?: E[K]) => void : (input: E[K]) => void; };
63
- /**
64
- * Timing for a scheduled event: exactly `{ delay: '5d' }` or
65
- * `{ at: Date }` (core §6 semantics — relative delays anchor to the
66
- * triggering message's durable `createdAt`, so re-runs resolve the
67
- * same due time). `name` overrides the timer's identity — it defaults
68
- * to the target event name, scoped to the triggering message, so one
69
- * handler run gets one timer per target event unless named apart.
70
- */
71
- type ActorScheduleOptions = ScheduleTiming & {
72
- name?: string;
73
- };
74
- /**
75
- * The typed durable-timer surface: one method per declared event —
76
- * `ctx.schedule.refund({ ref: ctx.id }, { delay: '1h' })`. Unlike
77
- * `send`, scheduling is immediate, not buffered: it awaits provider
78
- * acceptance at call time (a timer is provider-side, not a log row),
79
- * so a handler that schedules and then refuses has still armed the
80
- * timer. That is safe by the guarded-delivery idiom — the stale timer
81
- * fires into an idempotent no-op — but it is the one exception to
82
- * "refusals are total". Requires a configured `scheduler`.
83
- */
84
- type ActorScheduleSend<E> = { readonly [K in keyof E]: {} extends E[K] ? (input: E[K] | undefined, options: ActorScheduleOptions) => Promise<void> : (input: E[K], options: ActorScheduleOptions) => Promise<void>; };
85
- /** What a serial handler receives alongside its typed input. */
86
- type ActorContext<D extends ActorProtocol> = {
87
- /** Mutable draft, committed atomically with the handler's completion. */
88
- state: D["state"];
89
- /** The message id — stable across re-runs; the idempotency key for external I/O. */
90
- id: string;
91
- /** Durable 1-based dispatch ordinal of this message. */
92
- attempt: number;
93
- /** The ordinary A2 handler signal — fires on claim expiry or supersession. */
94
- signal: AbortSignal;
95
- /** Typed buffered self-send — committed atomically with the state commit. */
96
- send: ActorSend<D["events"]>;
97
- /** Typed durable timers — immediate provider handoff, see ActorScheduleSend. */
98
- schedule: ActorScheduleSend<D["events"]>;
99
- };
100
- /**
101
- * What a `concurrent: true` handler receives. No draft — concurrent
102
- * handlers run off the lane, in parallel, so state is a snapshot read
103
- * (honest about staleness) and mutations happen by sending events
104
- * whose serial handlers decide against fresh state.
105
- */
106
- type ActorConcurrentContext<D extends ActorProtocol> = {
107
- /** The message id — stable across re-runs; the idempotency key for external I/O. */
108
- id: string;
109
- /** Durable 1-based dispatch ordinal of this message. */
110
- attempt: number;
111
- /** The ordinary A2 handler signal — fires on claim expiry or supersession. */
112
- signal: AbortSignal;
113
- /** Snapshot read — observational; the world moves while this runs. */
114
- state(): Promise<{
115
- state: D["state"];
116
- index: number;
117
- }>;
118
- /** Typed buffered self-send — committed atomically with settlement. */
119
- send: ActorSend<D["events"]>;
120
- /** Typed durable timers — immediate provider handoff, see ActorScheduleSend. */
121
- schedule: ActorScheduleSend<D["events"]>;
122
- };
123
- type ActorStatePayload<S> = {
124
- state: S;
125
- /** The event whose handler committed this state. */
126
- event: string;
127
- /** The message (invocation event) id this state answers. */
128
- message: string;
129
- };
130
- /** The event vocabulary a client needs to follow an actor's state. */
131
- type ActorClientEventDefs<S> = {
132
- "a2.actor.state": StandardSchemaV1<ActorStatePayload<S>>;
133
- };
134
- //#endregion
135
- export { ActorPresenceOf as a, ActorRefusedError as c, ActorSend as d, ActorPresenceMap as i, ActorScheduleOptions as l, ActorConcurrentContext as n, ActorPresenceValues as o, ActorContext as r, ActorProtocol as s, ActorClientEventDefs as t, ActorScheduleSend as u };
136
- //# sourceMappingURL=actor-shared-USo5MyuF.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor-shared-USo5MyuF.d.ts","names":[],"sources":["../src/actor-shared.ts"],"mappings":";;;;;;;;;cAgCa,0BAA0B;;WAE5B;;WAEA;EACT,YAAY,eAAe,mBAAmB;;;;;;;;;KAepC;EACV;EACA;;;;;;;EAOA;;;KAIU,gBAAgB,UAAU,iBAAiB;EACrD,gBAAgB;IAEd;;KAIQ,oBAAoB,QAC7B,WAAW,cAAc,EAAE;;;;;;KAQlB,iBAAiB;GAExB,yBAAA,WAAW;IAAgB,OAAO,EAAE;IAAI;IAAc,IAAI;;;;;;;;;;;;KAanD,UAAU,iBACV,WAAW,eAAe,EAAE,MACjC,QAAQ,EAAE,eACV,OAAO,EAAE;;;;;;;;;KAWJ,uBAAuB;EAAmB;;;;;;;;;;;;KAY1C,kBAAkB,iBAClB,WAAW,eAAe,EAAE,MACjC,OAAO,EAAE,gBAAgB,SAAS,yBAAyB,iBAC3D,OAAO,EAAE,IAAI,SAAS,yBAAyB;;KAI1C,aAAa,UAAU;;EAEjC,OAAO;;EAEP;;EAEA;;EAEA,QAAQ;;EAER,MAAM,UAAU;;EAEhB,UAAU,kBAAkB;;;;;;;;KASlB,uBAAuB,UAAU;;EAE3C;;EAEA;;EAEA,QAAQ;;EAER,SAAS;IAAU,OAAO;IAAY;;;EAEtC,MAAM,UAAU;;EAEhB,UAAU,kBAAkB;;KAGlB,kBAAkB;EAC5B,OAAO;;EAEP;;EAEA;;;KAWU,qBAAqB;EAC/B,kBAAkB,iBAAiB,kBAAkB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor.d.ts","names":[],"sources":["../src/actor.ts"],"mappings":";;;;;;;;;;;;;;;;KA6GY,aAAa,UAAU,eAAe,gBAAgB,iBAC5D,KAAK,aAAa,IAAI,OAAO,YAAY,cAAc;EAEvD;EACA,SACE,KAAK,uBAAuB,IAC5B,OAAO,YAAY,cACT;;;;;;;;;;;;;;;;iBAiBF,WAAW,KAAK,GAC9B,SAAS,KAAK,KAAK,OAAO,aAAa;EACpC;EAAkB,SAAS,KAAK,KAAK,OAAO,aAAa;;KAIlD,aAAa,UAAU;;EAEjC;;EAEA,OAAO;;;;;EAKP,aAAa,WAAW,cAAc,aAAa,GAAG;EACtD,QAAQ;EACR,YAAY;EACZ,YAAY;MACR,gBAAgB;EAChB;;;;;;;;;;;;EAYA;;;;;;;KAQM;WAEG;WACA;WACA;;WAGA;WACA;WACA;WACA;WACA;;WAGA;WACA;WACA;WACA,QAAQ,SAAS;;KAGpB,kBAAkB,UAAU;;EAEtC,aAAa,WAAW,6BAA6B;;;;;;;;;;;;EAYrD,QAAQ,OAAO;;KAGL;;EAEV;;KAGU,mBAAmB;;EAE7B;;KAGU,gBAAgB;;EAE1B,OAAO;;EAEP;;KAGG,WACH,UAAU,eACV,gBAAgB,0BACH,YAAY,MAErB,QAAQ,YAAY,IACpB,UAAU,qBACP,QAAQ,gBAAgB,gBAE3B,OAAO,YAAY,IACnB,UAAU,qBACP,QAAQ,gBAAgB;KAE5B,WACH,UAAU,eACV,gBAAgB,0BACH,YAAY,MAErB,QAAQ,YAAY,IACpB,UAAU,qBACP;EAAU;EAAY;MAEzB,OAAO,YAAY,IACnB,UAAU,qBACP;EAAU;EAAY;;;KAGnB,YAAY,UAAU;WACvB;;;;;;WAMA,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,kBAAkB,WAAW,cAAc,WAAW,GAAG;;WAEzD,aAAa,QAAQ,gBAAgB;;;;;;;;;;WAUrC,QACP,SAAS,SACT,UAAU,kBAAkB,OACzB,QAAQ;;WAEJ,SAAS,QAAQ;;KAGhB,gBAAgB,UAAU;WAC3B;;;;;;WAMA,WAAW;;WAEX,UAAU,SAAS;;WAEnB,QAAQ,SAAS;;WAEjB,SAAS,QAAQ,qBAAqB,aAAa;EAC5D,MAAM,aAAa,YAAY;;;;;;;iBAsDjB,MAAM,UAAU,eAC9B,SAAS,aAAa,KACrB,gBAAgB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"client.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;KAqDY;;;;;;;KAQA;EACN;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;EAAgB;;EAChB;;;;;;;;;;KAUM,WAAW,UAAU,aAAa,QAAQ,cAAc;WACzD,WAAW,QAAQ,cAAc;;KAGhC;;;;;;EAMV;;EAEA;;;KAIU;;EAEV;;EAEA;;EAEA;;;KAIU,gBACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aACF;;EAGE,UAAU,YAAY;;;EAIxB,OAAO;;;;;EAKP,QAAQ,cAAc;;;EAGtB;;EAEA,SAAS;EACT,YAAY;;;;;;;KAQF,sBAAsB,UAAU;;;;;;;;;;EAU1C,YAAY,QAAQ,cAAc;;KAGxB,cACV,UAAU,WACV,GACA,UAAU,eAAe,wBACvB,aAAa,GAAG,sBAAsB;WAC/B;EACT,UAAU;EACV,eAAe,gBAAgB,GAAG,GAAG;;;;;;;;;;EAUrC,QAAQ,QAAQ,YAAY,OAAO,WAAW;;;;;;;;;;;EAW9C,YAAY,UAAU,qBAAqB,QAAQ,cAAc;;;;;;;;;EASjE;;;;;;EAMA;;KAGU,eAAe,UAAU,WAAW;EAC9C,eAAe;EACf;;EAEA,gBAAgB,cAAc;;;EAG9B;;KAGU,SACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,QACE,mBACA,UAAU,eAAe,GAAG,KAC3B,cAAc,GAAG,GAAG;;;;;;;;;KAUb,wBAAwB;KAExB,YACR;EACE;EAAc,MAAM;EAAY,QAAQ;;EAExC;EAAY,KAAK;EAAY;;EAE7B;EAAY;EAAa;;;;;;;KAOnB;WACD;EACT,KAAK;EACL,MAAM,eAAe;EACrB,iBAAiB,cAAc;EAC/B,iBACE,iBACA,WAAW;IAAS;;EAEtB,iBACE,eACA,WAAW;IAAS;IAAc;;EAEpC,iBAAiB,eAAe;;KAGtB,kCAAkC,gBAAgB;KAElD,oBACV,UAAU,WACV,GACA,UAAU,eAAe;EAEzB,SAAS,QAAQ,GAAG,GAAG;;EAEvB,KAAK;;EAEL,eAAe,WAAW;;;EAG1B,YAAY;;;EAGZ;;;;;;;;EAQA;;iBAi6Bc,aACd,UAAU,WACV,GACA,UAAU,eAAe,sBACzB,SAAS,oBAAoB,GAAG,GAAG,KAAK,SAAS,GAAG,GAAG"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["/**\n * experimental-a2/client — the framework-agnostic session client.\n *\n * Everything the browser needs to read a session live and push\n * optimistically, with no framework attached: the SSE subscription with\n * frontier resume and reconnection, the optimistic push queue with\n * ack/rollback, and the local fold through the same reducer the server\n * uses. `experimental-a2/react`'s `createReact` is a thin binding over it, and the\n * store contract (`subscribe`/`getSnapshot`) is exactly what\n * `useSyncExternalStore` wants.\n *\n * The client is a replica, never an access path — the routes it talks\n * to authorize every read and write.\n */\n\n// oxlint-disable no-await-in-loop -- retry/backoff/stream loops are sequential by nature\nimport { A2Error } from './errors.ts'\nimport {\n PRESENCE_TIMINGS,\n RESERVED_PARTICIPANT_IDS,\n STREAM_TIMINGS,\n nullProtoRecord,\n} from './internal.ts'\nimport type {\n AppendInput,\n ContractEvent,\n EventDefs,\n PresenceDefs,\n PresenceMap,\n PresencePatch,\n WithPresence,\n} from './contract.ts'\nimport type { Reducer } from './reducer.ts'\nimport { validateSync } from './validate.ts'\nimport {\n errorFromWire,\n eventFromWire,\n isWireEvent,\n isWirePresencePatch,\n isWirePresenceSnapshot,\n parseSocketFrame,\n presencePatchFromWire,\n presenceSnapshotFromWire,\n type SocketDownFrame,\n type SocketPresenceFrame,\n type SocketPushFrame,\n type SocketSubscribeFrame,\n type SocketUnsubscribeFrame,\n type WireEvent,\n type WirePresencePatch,\n type WirePresenceSnapshot,\n} from './wire.ts'\n\nexport type ConnectionStatus = 'idle' | 'connecting' | 'live' | 'closed'\n\n/**\n * The connection, as a discriminated union — impossible states are\n * unrepresentable: an error only exists while disconnected,\n * `reconnects` only once a connection has been attempted.\n * \"Reconnecting…\" is `status === 'connecting' && reconnects > 0`.\n */\nexport type Connection =\n | { status: 'idle' }\n | {\n status: 'connecting'\n /** Drops of an established stream so far. `0` = first connect. */\n reconnects: number\n /** Why the last connection ended; `null` on the first connect. */\n error: Error | null\n }\n | { status: 'live'; reconnects: number }\n | { status: 'closed' }\n\n/**\n * What `push` returns: resolves at the server ack (exactly like a\n * plain promise — `await push(...)` gives the acked events), and\n * carries `confirmed` for the later moment when the live stream has\n * delivered the whole batch back and the optimistic overlay entry\n * retired — the view now shows server truth. `confirmed` is lazy:\n * never accessed, never created. A rejected push rejects both.\n */\nexport type PushResult<D extends EventDefs> = Promise<ContractEvent<D>[]> & {\n readonly confirmed: Promise<ContractEvent<D>[]>\n}\n\nexport type LoadHistoryOptions = {\n /**\n * Exclusive upper bound for the fetch. Defaults to the oldest\n * already-loaded index — successive calls page backward — or one\n * past the hydration frontier while nothing is loaded yet.\n */\n before?: number\n /** Page size; defaults to 50. */\n limit?: number\n}\n\n/** Backscroll progress, derived from the raw event feed. */\nexport type HistoryState = {\n /** A `loadHistory` fetch is in flight. */\n loading: boolean\n /** The feed reaches index 1 — nothing older remains to fetch. */\n complete: boolean\n /** The oldest loaded index; `null` while nothing is loaded. */\n oldestLoaded: number | null\n}\n\n/** One immutable view of the session — stable identity between changes. */\nexport type SessionSnapshot<\n D extends EventDefs,\n S,\n P extends PresenceDefs = Record<never, never>,\n> = WithPresence<\n P,\n {\n /** The replicated presence map, this client included (local echo). */\n presence: PresenceMap<P>\n }\n> & {\n /** The live view: server events folded, optimistic pushes applied. */\n state: S\n /** The raw event feed: server truth — observed, seeded, or\n * backscrolled via `loadHistory` — plus pending optimistic events\n * (provisional indexes past the frontier). `state` never folds\n * backscrolled events; they are display data below the frontier. */\n events: ContractEvent<D>[]\n /** The stream frontier: the last server-confirmed index. This is the\n * `lastSeenIndex` cancellation wants. */\n index: number\n /** Backscroll progress — `loadHistory` moves it. */\n history: HistoryState\n connection: Connection\n}\n\n/**\n * The presence member of a client session — intersected in via\n * `WithPresence`, so it exists exactly when the contract declares\n * presence fields.\n */\nexport type SessionClientPresence<P extends PresenceDefs> = {\n /**\n * Fire-and-forget presence: validates locally against the reducer's\n * presence schemas, merges into the local map immediately (the\n * echo), and coalesces on the wire to a fixed cadence — a leading\n * send immediately, then at most one merged send per interval,\n * later values winning field-wise. `null` clears a field. No ack,\n * no retry, no rollback: a lost patch is repainted by the next one.\n * Requires the session's `participant`.\n */\n setPresence(values: PresencePatch<P>['values']): void\n}\n\nexport type SessionClient<\n D extends EventDefs,\n S,\n P extends PresenceDefs = Record<never, never>,\n> = WithPresence<P, SessionClientPresence<P>> & {\n readonly sessionId: string\n subscribe(listener: () => void): () => void\n getSnapshot(): SessionSnapshot<D, S, P>\n /**\n * Optimistic append: validates locally against the reducer's event\n * schemas (instant `INVALID_PAYLOAD`, no flicker), applies to the\n * local fold, POSTs, swaps in the ack, rolls back on rejection.\n * Auto-retries only `STORE_UNAVAILABLE`. Resolves with the appended\n * events as the server recorded them. Overlapping calls on this\n * handle enter the transport in invocation order without delaying\n * their optimistic folds.\n */\n push(...events: AppendInput<D>[]): PushResult<D>\n /**\n * Backscroll: fetch a bounded slice of events from below the\n * frontier and merge it into `events` — deduped, ordered, shared by\n * every handle of this session. Folded state and the optimistic\n * overlay are never touched. Calls serialize per session and skip\n * already-loaded ranges, so overlapping backscrolls never fetch the\n * same range twice. Resolves with the events in the requested range.\n * Requires an http api; the `ws` transport has no history lane and\n * this throws a TypeError there.\n */\n loadHistory(options?: LoadHistoryOptions): Promise<ContractEvent<D>[]>\n /**\n * Take a lease on the live stream and return its release. Leases\n * refcount per handle — the first connects, releasing the last\n * closes — so independent consumers of one identity-mapped handle\n * (two hooks, a hook plus vanilla code) never fight over the\n * stream. Releasing twice is a no-op. While any lease is held the\n * stream reconnects with backoff and resumes from the frontier.\n */\n connect(): () => void\n /**\n * The hard stop: drops every outstanding lease and closes the\n * stream now. Not terminal — a later `connect()` starts fresh from\n * the current frontier.\n */\n close(): void\n}\n\nexport type SessionOptions<D extends EventDefs, S> = {\n initialState?: S\n initialIndex?: number\n /** Server-rendered history through `initialIndex`. Seeds the event feed. */\n initialEvents?: ContractEvent<D>[]\n /** Overrides the client's `participant` for this session handle.\n * Bound once per handle. */\n participant?: string\n}\n\nexport type A2Client<\n D extends EventDefs,\n S,\n P extends PresenceDefs = Record<never, never>,\n> = {\n session(\n sessionId: string,\n options?: SessionOptions<D, S>,\n ): SessionClient<D, S, P>\n}\n\n/**\n * The wire the client rides. The first form is one route serving GET\n * (SSE stream) + POST (push). `http` splits the verbs across two\n * routes, for when platform duration limits differ per verb. `ws`\n * rides everything over WebSocket, one socket per session by default.\n * Multiplexing every session of the client is an explicit opt-in.\n */\nexport type SessionUrl = string | ((sessionId: string) => string)\n\nexport type ClientApi =\n | SessionUrl // one route: GET SSE stream + POST push\n | { type: 'http'; push: SessionUrl; stream: SessionUrl } // split routes\n /** One socket per session. */\n | { type: 'ws'; url: SessionUrl; multiplex?: false }\n /** One socket for every session of this client. */\n | { type: 'ws'; url: string; multiplex: true }\n\n/**\n * The socket surface the `ws` transport drives — satisfied structurally\n * by the DOM `WebSocket` and Node's alike, and small enough to fake in\n * tests.\n */\nexport type ClientWebSocket = {\n readonly readyState: number\n send(data: string): void\n close(code?: number, reason?: string): void\n addEventListener(type: 'open', listener: () => void): void\n addEventListener(\n type: 'message',\n listener: (event: { data: unknown }) => void,\n ): void\n addEventListener(\n type: 'close',\n listener: (event: { code: number; reason: string }) => void,\n ): void\n addEventListener(type: 'error', listener: () => void): void\n}\n\nexport type ClientWebSocketConstructor = new (url: string) => ClientWebSocket\n\nexport type CreateClientOptions<\n D extends EventDefs,\n S,\n P extends PresenceDefs = Record<never, never>,\n> = {\n reducer: Reducer<D, S, P>\n /** The route (or routes) the client speaks — see `ClientApi`. */\n api: ClientApi\n /** Injectable fetch — defaults to the global. */\n fetch?: typeof globalThis.fetch\n /** Injectable WebSocket constructor for the `ws` api — defaults to\n * the global. The http transports never touch it. */\n webSocket?: ClientWebSocketConstructor\n /** How long an idle session keeps its in-memory identity, in\n * milliseconds. Defaults to five minutes; `Infinity` disables GC. */\n gcTime?: number\n /**\n * This client's presence identity — required to call `setPresence`.\n * Caller-supplied (a user id, a tab nonce, a guest name): A2 does\n * not invent an identity story; the app states it once here. The\n * default for every session handle this client creates;\n * `session(id, { participant })` overrides it per handle.\n */\n participant?: string\n}\n\nconst PUSH_ATTEMPTS = 3\nconst DEFAULT_GC_TIME_MS = 5 * 60 * 1_000\nconst DEFAULT_HISTORY_LIMIT = 50\n\n// ── the transport seam ───────────────────────────────────────────────\n// Everything above it — optimistic queue, retry loop, presence\n// throttle, reconnect/backoff, stall watchdog — is transport-agnostic.\n\n/** The parsed frame lanes every transport yields: the SSE frame\n * discrimination today, the ws `kind` discriminant tomorrow. `ping`\n * carries no data — it exists so the watchdog sees liveness. */\ntype TransportFrame =\n | { kind: 'event'; event: WireEvent }\n | { kind: 'presence'; patch: WirePresencePatch }\n | { kind: 'presence-snapshot'; snapshot: WirePresenceSnapshot }\n | { kind: 'ping' }\n\ntype TransportPushBody = {\n sessionId: string\n events: Array<{ id: string; type: string; payload: unknown }>\n}\n\ntype TransportPresenceEnvelope = {\n sessionId: string\n presence: {\n participant: string\n values: Record<string, unknown>\n seen: number\n at: number\n }\n}\n\ntype Transport = {\n /**\n * One live read: the first frame means the stream is established\n * (any kind — a bare `ping` when no data is pending), the iterable\n * ending or throwing is the disconnect. The caller owns\n * reconnect/backoff and counts every frame as liveness.\n */\n connect(opts: {\n sessionId: string\n startAfter: number\n signal: AbortSignal\n }): AsyncIterable<TransportFrame>\n /** One attempt (the retry loop lives above the seam): resolves with\n * the acked wire events, throws the wire-deserialized A2Error. */\n push(body: TransportPushBody): Promise<WireEvent[]>\n /** One bounded cold read of the log, oldest first — the lane\n * `loadHistory` rides. Absent on transports without a\n * request/response wire (ws), where `loadHistory` fails fast. */\n history?(opts: {\n sessionId: string\n gte: number\n lte: number\n }): Promise<WireEvent[]>\n /** Fire-and-forget; failures are dropped (presence repaints). */\n sendPresence(envelope: TransportPresenceEnvelope): void\n /**\n * Resolve when the session's wire can carry a push again, or after\n * `maxWaitMs` — whichever comes first; never rejects. Transports\n * whose pushes are connection-bound (ws) implement it so the retry\n * loop waits for the wire instead of a fixed clock; HTTP pushes are\n * stream-independent and omit it.\n */\n awaitReady?(sessionId: string, maxWaitMs: number): Promise<void>\n}\n\nconst sessionUrl = (url: SessionUrl, sessionId: string): string => {\n const resolved = typeof url === 'function' ? url(sessionId) : url\n if (typeof resolved !== 'string') {\n throw new TypeError('a session URL function must return a string')\n }\n return resolved\n}\n\nconst httpTransport = (\n routes: { push: SessionUrl; stream: SessionUrl },\n fetchImpl: typeof globalThis.fetch,\n // Contracts that declare no presence skip presence frames unparsed,\n // exactly like unknown named frames.\n presence: boolean,\n): Transport => ({\n async *connect({ sessionId, startAfter, signal }) {\n const streamUrl = sessionUrl(routes.stream, sessionId)\n const sep = streamUrl.includes('?') ? '&' : '?'\n const res = await fetchImpl(\n `${streamUrl}${sep}sessionId=${encodeURIComponent(sessionId)}&index=${startAfter}`,\n { headers: { accept: 'text/event-stream' }, signal },\n )\n if (!res.ok || !res.body) {\n throw new Error(`stream failed with ${res.status}`)\n }\n yield { kind: 'ping' } // connected — headers in hand, before any bytes\n const decoder = new TextDecoder()\n const reader = res.body.getReader()\n let buffer = ''\n try {\n for (;;) {\n // oxlint-disable-next-line no-await-in-loop -- stream read loop\n const { done, value } = await reader.read()\n if (done) return\n // Any bytes count — heartbeat comments included. Liveness is\n // about the connection, not about events.\n yield { kind: 'ping' }\n buffer += decoder.decode(value, { stream: true })\n for (;;) {\n const boundary = buffer.indexOf('\\n\\n')\n if (boundary === -1) break\n const frame = buffer.slice(0, boundary)\n buffer = buffer.slice(boundary + 2)\n let eventName: string | undefined\n const dataLines: string[] = []\n for (const line of frame.split('\\n')) {\n if (line.startsWith('data:')) {\n dataLines.push(line.slice(5).trimStart())\n } else if (line.startsWith('event:')) {\n eventName = line.slice(6).trim()\n }\n }\n const data = dataLines.join('\\n')\n if (!data) continue\n if (eventName === undefined) {\n const parsed: unknown = JSON.parse(data)\n if (isWireEvent(parsed)) yield { kind: 'event', event: parsed }\n } else if (presence && eventName === 'presence-snapshot') {\n const parsed: unknown = JSON.parse(data)\n if (isWirePresenceSnapshot(parsed)) {\n yield { kind: 'presence-snapshot', snapshot: parsed }\n }\n } else if (presence && eventName === 'presence') {\n const parsed: unknown = JSON.parse(data)\n if (isWirePresencePatch(parsed)) {\n yield { kind: 'presence', patch: parsed }\n }\n }\n // Other named frames: skipped — old clients stay compatible\n // with future lanes the same way.\n }\n }\n } finally {\n reader.cancel().catch(() => {})\n }\n },\n\n async push(body) {\n const res = await fetchImpl(sessionUrl(routes.push, body.sessionId), {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify(body),\n })\n if (res.ok) {\n const rows = (await res.json()) as unknown\n if (!Array.isArray(rows) || !rows.every(isWireEvent)) {\n throw new A2Error(\n 'STORE_UNAVAILABLE',\n 'push ack was not a list of events',\n )\n }\n return rows\n }\n throw (\n errorFromWire(await res.json().catch(() => null)) ??\n new A2Error('STORE_UNAVAILABLE', `push failed with ${res.status}`)\n )\n },\n\n async history({ sessionId, gte, lte }) {\n const streamUrl = sessionUrl(routes.stream, sessionId)\n const sep = streamUrl.includes('?') ? '&' : '?'\n const res = await fetchImpl(\n `${streamUrl}${sep}sessionId=${encodeURIComponent(sessionId)}&gte=${gte}&lte=${lte}`,\n { headers: { accept: 'application/json' } },\n )\n if (!res.ok) {\n throw (\n errorFromWire(await res.json().catch(() => null)) ??\n new A2Error('STORE_UNAVAILABLE', `history failed with ${res.status}`)\n )\n }\n const rows = (await res.json()) as unknown\n if (!Array.isArray(rows) || !rows.every(isWireEvent)) {\n throw new A2Error(\n 'STORE_UNAVAILABLE',\n 'history response was not a list of events',\n )\n }\n return rows\n },\n\n sendPresence(envelope) {\n void (async () => {\n try {\n const res = await fetchImpl(\n sessionUrl(routes.push, envelope.sessionId),\n {\n method: 'POST',\n headers: { 'content-type': 'application/json' },\n body: JSON.stringify(envelope),\n },\n )\n await res.arrayBuffer()\n } catch {\n // Dropped by design — nothing was ever true.\n }\n })()\n },\n})\n\n/** `WebSocket.OPEN` — fixed by the spec, identical in every runtime. */\nconst WS_OPEN = 1\n\ntype PendingAck = {\n resolve: (events: WireEvent[]) => void\n reject: (error: A2Error) => void\n}\n\nconst webSocketUrl = (value: string): URL => {\n let resolved: URL\n if (/^(https?|wss?):\\/\\//i.test(value)) {\n resolved = new URL(value)\n } else {\n const base = (globalThis as { location?: { href: string } }).location?.href\n if (base === undefined) {\n throw new TypeError(\n `cannot resolve the relative ws url '${value}' without a browser location — pass an absolute ws:// or wss:// url`,\n )\n }\n resolved = new URL(value, base)\n }\n if (resolved.protocol === 'http:') resolved.protocol = 'ws:'\n else if (resolved.protocol === 'https:') resolved.protocol = 'wss:'\n return resolved\n}\n\nconst socketReadyWaiters = () => {\n const sessions = new Map<string, Set<() => void>>()\n\n const notify = (sessionId: string): void => {\n const waiters = sessions.get(sessionId)\n if (!waiters) return\n sessions.delete(sessionId)\n for (const waiter of waiters) waiter()\n }\n\n const wait = (sessionId: string, maxWaitMs: number): Promise<void> =>\n new Promise((resolve) => {\n let waiters = sessions.get(sessionId)\n if (!waiters) {\n waiters = new Set()\n sessions.set(sessionId, waiters)\n }\n let settled = false\n const done = (): void => {\n if (settled) return\n settled = true\n clearTimeout(timer)\n waiters.delete(done)\n if (waiters.size === 0) sessions.delete(sessionId)\n // oxlint-disable-next-line promise/no-multiple-resolved -- `settled` guards the timer and notification callers\n resolve()\n }\n const timer = setTimeout(done, maxWaitMs)\n ;(timer as { unref?: () => void }).unref?.()\n waiters.add(done)\n })\n\n return { notify, wait }\n}\n\nconst rejectPendingAcks = (pending: Map<number, PendingAck>): void => {\n if (pending.size === 0) return\n const error = new A2Error(\n 'STORE_UNAVAILABLE',\n 'socket closed with the ack outstanding',\n )\n for (const waiter of pending.values()) waiter.reject(error)\n pending.clear()\n}\n\nconst sessionWsTransport = (\n url: SessionUrl,\n webSocketImpl: ClientWebSocketConstructor | undefined,\n presence: boolean,\n): Transport => {\n type SocketConnection = {\n socket: ClientWebSocket\n pending: Map<number, PendingAck>\n }\n\n const connections = new Map<string, SocketConnection>()\n const ready = socketReadyWaiters()\n let nextReq = 1\n\n const socketUrl = (sessionId: string, startAfter: number): string => {\n const resolved = webSocketUrl(sessionUrl(url, sessionId))\n resolved.searchParams.set('sessionId', sessionId)\n resolved.searchParams.set('index', String(startAfter))\n return resolved.href\n }\n\n return {\n async *connect({ sessionId, startAfter, signal }) {\n if (webSocketImpl === undefined) {\n throw new TypeError(\n 'no WebSocket implementation available — pass one via createClient({ webSocket }) where the global is missing',\n )\n }\n const socket = new webSocketImpl(socketUrl(sessionId, startAfter))\n const connection: SocketConnection = { socket, pending: new Map() }\n connections.set(sessionId, connection)\n\n const queue: TransportFrame[] = []\n let ended = false\n let failure: Error | null = null\n let wake: (() => void) | null = null\n const notify = (): void => {\n wake?.()\n wake = null\n }\n const finish = (error: Error | null): void => {\n if (ended) return\n ended = true\n failure = error\n if (connections.get(sessionId) === connection) {\n connections.delete(sessionId)\n }\n rejectPendingAcks(connection.pending)\n notify()\n }\n\n socket.addEventListener('open', () => {\n if (connections.get(sessionId) !== connection || ended) return\n queue.push({ kind: 'ping' })\n notify()\n ready.notify(sessionId)\n })\n socket.addEventListener('message', (event) => {\n if (connections.get(sessionId) !== connection || ended) return\n if (typeof event.data !== 'string') return\n const frame = parseSocketFrame(event.data)\n if (frame === null) return\n switch (frame.kind) {\n case 'ack': {\n const waiter = connection.pending.get(frame.req)\n if (waiter === undefined) return\n connection.pending.delete(frame.req)\n if (\n frame.sessionId !== undefined ||\n ('events' in frame &&\n frame.events.some((row) => row.sessionId !== sessionId))\n ) {\n waiter.reject(\n new A2Error(\n 'STORE_UNAVAILABLE',\n 'ack does not belong to the socket session',\n ),\n )\n return\n }\n if ('events' in frame) waiter.resolve(frame.events)\n else waiter.reject(frame.error)\n return\n }\n case 'event':\n if (frame.event.sessionId !== sessionId) return\n queue.push({ kind: 'event', event: frame.event })\n break\n case 'presence':\n if (presence && frame.sessionId === undefined) {\n queue.push({ kind: 'presence', patch: frame.patch })\n }\n break\n case 'presence-snapshot':\n if (presence && frame.sessionId === undefined) {\n queue.push({\n kind: 'presence-snapshot',\n snapshot: frame.snapshot,\n })\n }\n break\n case 'ping':\n queue.push(frame)\n break\n case 'subscribed':\n case 'unsubscribed':\n return\n }\n notify()\n })\n socket.addEventListener('close', (event) => {\n finish(\n event.code === 1000\n ? null\n : new Error(\n `socket closed (${event.code}${event.reason ? `: ${event.reason}` : ''})`,\n ),\n )\n })\n socket.addEventListener('error', () => {\n finish(new Error('socket error'))\n })\n\n const onAbort = (): void => {\n finish(\n signal.reason instanceof Error\n ? signal.reason\n : new Error('stream aborted'),\n )\n try {\n socket.close(1000)\n } catch {\n // Already closed.\n }\n }\n if (signal.aborted) onAbort()\n else signal.addEventListener('abort', onAbort, { once: true })\n\n try {\n for (;;) {\n while (queue.length > 0) yield queue.shift()!\n if (ended) {\n if (failure) throw failure\n return\n }\n await new Promise<void>((resolve) => {\n wake = resolve\n })\n }\n } finally {\n signal.removeEventListener('abort', onAbort)\n finish(null)\n try {\n socket.close(1000)\n } catch {\n // Already closed.\n }\n }\n },\n\n async push(body) {\n const connection = connections.get(body.sessionId)\n if (\n connection === undefined ||\n connection.socket.readyState !== WS_OPEN\n ) {\n throw new A2Error('STORE_UNAVAILABLE', 'no open socket for the session')\n }\n const req = nextReq\n nextReq += 1\n return await new Promise<WireEvent[]>((resolve, reject) => {\n connection.pending.set(req, { resolve, reject })\n const frame: SocketPushFrame = {\n kind: 'push',\n req,\n events: body.events,\n }\n try {\n connection.socket.send(JSON.stringify(frame))\n } catch (cause) {\n connection.pending.delete(req)\n reject(\n new A2Error('STORE_UNAVAILABLE', 'socket send failed', { cause }),\n )\n }\n })\n },\n\n awaitReady(sessionId, maxWaitMs) {\n const connection = connections.get(sessionId)\n if (connection?.socket.readyState === WS_OPEN) return Promise.resolve()\n return ready.wait(sessionId, maxWaitMs)\n },\n\n sendPresence(envelope) {\n const connection = connections.get(envelope.sessionId)\n if (\n connection === undefined ||\n connection.socket.readyState !== WS_OPEN\n ) {\n return\n }\n const frame: SocketPresenceFrame = {\n kind: 'presence',\n ...envelope.presence,\n }\n try {\n connection.socket.send(JSON.stringify(frame))\n } catch {\n return\n }\n },\n }\n}\n\n/** One session's lane on the shared ws socket — created per `connect`\n * attempt, so `startAfter` is that attempt's resume frontier. */\ntype WsChannel = {\n sessionId: string\n startAfter: number\n queue: TransportFrame[]\n /** The server confirmed the subscribe — pushes and presence ride. */\n live: boolean\n /** The server already dropped it — no unsubscribe frame owed. */\n dropped: boolean\n ended: boolean\n failure: Error | null\n wake: (() => void) | null\n}\n\nconst wakeChannel = (channel: WsChannel): void => {\n channel.wake?.()\n channel.wake = null\n}\n\nconst subscribeFrame = (\n sessions: Array<{ id: string; index: number }>,\n): string => {\n const frame: SocketSubscribeFrame = { kind: 'subscribe', sessions }\n return JSON.stringify(frame)\n}\n\nconst multiplexedWsTransport = (\n url: string,\n webSocketImpl: ClientWebSocketConstructor | undefined,\n presence: boolean,\n): Transport => {\n // ONE socket serves every session of this client (specs §13's\n // multiplexed superset): channels subscribe on it at their own\n // frontiers, down frames route back by sessionId, acks by req.\n const channels = new Map<string, WsChannel>()\n const pending = new Map<number, PendingAck>()\n /** Push retries parked in `awaitReady`, flushed per session on its\n * subscribe confirmation. */\n const ready = socketReadyWaiters()\n let socket: ClientWebSocket | null = null\n let socketOpen = false\n let watchdog: ReturnType<typeof setTimeout> | undefined\n let nextReq = 1\n\n const trySend = (data: string): void => {\n if (socket === null || !socketOpen) return\n try {\n socket.send(data)\n } catch {\n // Dropped — the socket is going down and its close event settles\n // everything that depended on this frame.\n }\n }\n\n const deliver = (channel: WsChannel, frame: TransportFrame): void => {\n channel.queue.push(frame)\n wakeChannel(channel)\n }\n\n const settleChannel = (channel: WsChannel, failure: Error | null): void => {\n if (channel.ended) return\n channel.ended = true\n channel.failure = failure\n wakeChannel(channel)\n }\n\n // Unhook the socket from the transport state and reject every\n // outstanding ack — nothing was acked, and the client-generated ids\n // make the retries idempotent (§13).\n const releaseSocket = (): ClientWebSocket | null => {\n const current = socket\n socket = null\n socketOpen = false\n clearTimeout(watchdog)\n watchdog = undefined\n rejectPendingAcks(pending)\n return current\n }\n\n // Idempotent from every direction (close event, error event, stall):\n // every channel ends — each session's reconnect loop re-subscribes at\n // its own current frontier.\n const failSocket = (failure: Error | null): void => {\n const current = releaseSocket()\n for (const channel of channels.values()) settleChannel(channel, failure)\n try {\n current?.close(1000)\n } catch {\n // Already closed — it is down either way.\n }\n }\n\n const detach = (channel: WsChannel): void => {\n if (channels.get(channel.sessionId) !== channel) return\n channels.delete(channel.sessionId)\n if (!channel.dropped) {\n const frame: SocketUnsubscribeFrame = {\n kind: 'unsubscribe',\n sessions: [channel.sessionId],\n }\n trySend(JSON.stringify(frame))\n }\n if (channels.size === 0) {\n // The last session left — the shared socket has no reason to live.\n const current = releaseSocket()\n try {\n current?.close(1000)\n } catch {\n // Already closed — it is down either way.\n }\n }\n }\n\n // One heartbeat watchdog per socket: any frame is liveness, and\n // silence past the stall timeout means the connection is dead in a\n // way the socket won't report.\n const armWatchdog = (created: ClientWebSocket): void => {\n clearTimeout(watchdog)\n watchdog = setTimeout(() => {\n if (socket !== created) return\n failSocket(\n new Error(\n `socket stalled: no data for ${STREAM_TIMINGS.stallTimeoutMs}ms`,\n ),\n )\n }, STREAM_TIMINGS.stallTimeoutMs)\n ;(watchdog as { unref?: () => void }).unref?.()\n }\n\n const route = (frame: SocketDownFrame): void => {\n switch (frame.kind) {\n case 'ping': {\n // Global liveness — every live channel's stall watchdog feeds\n // on it, the way each SSE stream feeds on its own heartbeat.\n for (const channel of channels.values()) {\n if (channel.live && !channel.ended) {\n deliver(channel, { kind: 'ping' })\n }\n }\n return\n }\n case 'subscribed': {\n const channel = channels.get(frame.sessionId)\n if (channel === undefined || channel.ended || channel.live) return\n channel.live = true\n deliver(channel, { kind: 'ping' }) // the connected signal\n ready.notify(frame.sessionId)\n return\n }\n case 'unsubscribed': {\n const channel = channels.get(frame.sessionId)\n if (channel === undefined) return\n channel.dropped = true\n settleChannel(\n channel,\n frame.reason === undefined ? null : new Error(frame.reason),\n )\n return\n }\n case 'ack': {\n const waiter = pending.get(frame.req)\n if (waiter === undefined) return\n pending.delete(frame.req)\n if ('events' in frame) waiter.resolve(frame.events)\n else waiter.reject(frame.error)\n return\n }\n case 'event': {\n // Pre-confirmation frames are safe to drop: the subscription\n // being confirmed replays from this channel's own frontier.\n const channel = channels.get(frame.event.sessionId)\n if (channel !== undefined && channel.live && !channel.ended) {\n deliver(channel, { kind: 'event', event: frame.event })\n }\n return\n }\n case 'presence': {\n // Contracts that declare no presence skip presence frames,\n // exactly like the http transport.\n if (!presence || frame.sessionId === undefined) return\n const channel = channels.get(frame.sessionId)\n if (channel !== undefined && channel.live && !channel.ended) {\n deliver(channel, { kind: 'presence', patch: frame.patch })\n }\n return\n }\n case 'presence-snapshot': {\n if (!presence || frame.sessionId === undefined) return\n const channel = channels.get(frame.sessionId)\n if (channel !== undefined && channel.live && !channel.ended) {\n deliver(channel, {\n kind: 'presence-snapshot',\n snapshot: frame.snapshot,\n })\n }\n return\n }\n }\n }\n\n const ensureSocket = (): void => {\n if (socket !== null) return\n if (webSocketImpl === undefined) {\n throw new TypeError(\n 'no WebSocket implementation available — pass one via createClient({ webSocket }) where the global is missing',\n )\n }\n const created = new webSocketImpl(webSocketUrl(url).href)\n socket = created\n socketOpen = false\n armWatchdog(created)\n created.addEventListener('open', () => {\n if (socket !== created) return\n socketOpen = true\n armWatchdog(created)\n const sessions = [...channels.values()]\n .filter((channel) => !channel.ended)\n .map((channel) => ({\n id: channel.sessionId,\n index: channel.startAfter,\n }))\n if (sessions.length > 0) trySend(subscribeFrame(sessions))\n })\n created.addEventListener('message', (event) => {\n if (socket !== created) return\n if (typeof event.data !== 'string') return\n armWatchdog(created)\n const frame = parseSocketFrame(event.data)\n if (frame === null) return\n route(frame)\n })\n created.addEventListener('close', (event) => {\n if (socket !== created) return\n failSocket(\n event.code === 1000\n ? null // deliberate server close — reconnect, but not an error\n : new Error(\n `socket closed (${event.code}${event.reason ? `: ${event.reason}` : ''})`,\n ),\n )\n })\n created.addEventListener('error', () => {\n if (socket !== created) return\n failSocket(new Error('socket error'))\n })\n }\n\n return {\n async *connect({ sessionId, startAfter, signal }) {\n const channel: WsChannel = {\n sessionId,\n startAfter,\n queue: [],\n live: false,\n dropped: false,\n ended: false,\n failure: null,\n wake: null,\n }\n channels.set(sessionId, channel)\n try {\n ensureSocket()\n if (socketOpen) {\n trySend(subscribeFrame([{ id: sessionId, index: startAfter }]))\n }\n } catch (error) {\n if (channels.get(sessionId) === channel) channels.delete(sessionId)\n throw error\n }\n\n const onAbort = (): void => {\n settleChannel(\n channel,\n signal.reason instanceof Error\n ? signal.reason\n : new Error('stream aborted'),\n )\n // Synchronously, not from the pump's finally: the watchdog and\n // close() must not leave a dead subscription behind.\n detach(channel)\n }\n if (signal.aborted) onAbort()\n else signal.addEventListener('abort', onAbort, { once: true })\n\n // An unconfirmed subscribe receives no frames at all (global\n // pings only feed live channels), so a server that never answers\n // — a single-session route, say — would hang this session\n // silently. Fail it loudly instead; the reconnect loop retries.\n const pendingSubscribe = setTimeout(() => {\n if (channel.live) return\n settleChannel(\n channel,\n new Error(\n 'subscribe not confirmed: is the ws route calling server.fetch with upgradeWebSocket?',\n ),\n )\n }, STREAM_TIMINGS.stallTimeoutMs)\n ;(pendingSubscribe as { unref?: () => void }).unref?.()\n\n try {\n for (;;) {\n while (channel.queue.length > 0) yield channel.queue.shift()!\n if (channel.ended) {\n if (channel.failure) throw channel.failure\n return\n }\n // oxlint-disable-next-line no-await-in-loop -- frame pump\n await new Promise<void>((resolve) => {\n channel.wake = resolve\n })\n }\n } finally {\n clearTimeout(pendingSubscribe)\n signal.removeEventListener('abort', onAbort)\n settleChannel(channel, null)\n detach(channel)\n }\n },\n\n async push(body) {\n const channel = channels.get(body.sessionId)\n const target = socket\n if (\n channel === undefined ||\n !channel.live ||\n channel.ended ||\n target === null ||\n !socketOpen ||\n target.readyState !== WS_OPEN\n ) {\n // Retryable by contract: the reconnect loop restores the\n // socket and the retry rides the same event ids.\n throw new A2Error('STORE_UNAVAILABLE', 'no open socket for the session')\n }\n const req = nextReq\n nextReq += 1\n return await new Promise<WireEvent[]>((resolve, reject) => {\n pending.set(req, { resolve, reject })\n const frame: SocketPushFrame = {\n kind: 'push',\n req,\n sessionId: body.sessionId,\n events: body.events,\n }\n try {\n target.send(JSON.stringify(frame))\n } catch (cause) {\n pending.delete(req)\n reject(\n new A2Error('STORE_UNAVAILABLE', 'socket send failed', { cause }),\n )\n }\n })\n },\n\n awaitReady(sessionId, maxWaitMs) {\n const channel = channels.get(sessionId)\n if (\n channel !== undefined &&\n channel.live &&\n !channel.ended &&\n socketOpen\n ) {\n return Promise.resolve()\n }\n return ready.wait(sessionId, maxWaitMs)\n },\n sendPresence(envelope) {\n const channel = channels.get(envelope.sessionId)\n if (channel === undefined || !channel.live || channel.ended) {\n return // dropped by design — the reconnect re-send covers the gap\n }\n const frame: SocketPresenceFrame = {\n kind: 'presence',\n sessionId: envelope.sessionId,\n ...envelope.presence,\n }\n trySend(JSON.stringify(frame))\n },\n }\n}\n\nconst transportFor = (\n api: ClientApi,\n fetchImpl: typeof globalThis.fetch,\n webSocketImpl: ClientWebSocketConstructor | undefined,\n presence: boolean,\n): Transport => {\n if (typeof api === 'string' || typeof api === 'function') {\n return httpTransport({ push: api, stream: api }, fetchImpl, presence)\n }\n if (api.type === 'http') {\n return httpTransport(\n { push: api.push, stream: api.stream },\n fetchImpl,\n presence,\n )\n }\n if (api.multiplex === true) {\n if (typeof api.url !== 'string') {\n throw new TypeError('a multiplexed WebSocket URL must be a string')\n }\n return multiplexedWsTransport(api.url, webSocketImpl, presence)\n }\n return sessionWsTransport(api.url, webSocketImpl, presence)\n}\n\ntype Pending<D extends EventDefs> = {\n id: string\n type: string\n payload: unknown\n createdAt: Date\n /** Set once the POST ack returns; the entry leaves the overlay when\n * the stream delivers its index. */\n acked?: ContractEvent<D>\n}\n\ntype SessionRuntime<\n D extends EventDefs,\n S,\n P extends PresenceDefs,\n> = SessionClient<D, S, P> & {\n hydrate(options?: SessionOptions<D, S>): void\n canEvict(): boolean\n}\n\ntype CachedSession<D extends EventDefs, S, P extends PresenceDefs> = {\n runtime: SessionRuntime<D, S, P>\n timer?: ReturnType<typeof setTimeout>\n}\n\nexport function createClient<\n D extends EventDefs,\n S,\n P extends PresenceDefs = Record<never, never>,\n>(options: CreateClientOptions<D, S, P>): A2Client<D, S, P> {\n const { reducer, api } = options\n const presenceDefs: Readonly<PresenceDefs> = reducer.presence\n const declaresPresence = Object.keys(presenceDefs).length > 0\n const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis)\n const webSocketImpl =\n options.webSocket ??\n (globalThis as { WebSocket?: ClientWebSocketConstructor }).WebSocket\n const transport = transportFor(\n api,\n fetchImpl,\n webSocketImpl,\n declaresPresence,\n )\n const gcTime = options.gcTime ?? DEFAULT_GC_TIME_MS\n if (Number.isNaN(gcTime) || gcTime < 0) {\n throw new RangeError('gcTime must be a non-negative number or Infinity')\n }\n const sessions = new Map<string, CachedSession<D, S, P>>()\n\n const scheduleGc = (sessionId: string, delay = gcTime): void => {\n const entry = sessions.get(sessionId)\n if (!entry) return\n clearTimeout(entry.timer)\n if (gcTime === Infinity) return\n entry.timer = setTimeout(() => {\n const current = sessions.get(sessionId)\n if (current !== entry) return\n if (entry.runtime.canEvict()) {\n sessions.delete(sessionId)\n return\n }\n // `gcTime: 0` is useful for tests and explicit no-cache clients,\n // but must not spin while a session is mounted or a push is in flight.\n scheduleGc(sessionId, Math.max(gcTime, 1_000))\n }, delay)\n ;(entry.timer as { unref?: () => void }).unref?.()\n }\n\n const touch = (sessionId: string): void => {\n scheduleGc(sessionId)\n }\n\n const makeSession = (\n sessionId: string,\n sessionOptions?: SessionOptions<D, S>,\n ): SessionRuntime<D, S, P> => {\n // ── server truth ─────────────────────────────────────────────\n let frontier = sessionOptions?.initialIndex ?? 0\n let foldedState: S =\n sessionOptions?.initialState !== undefined\n ? sessionOptions.initialState\n : reducer.initialState\n const serverEvents: ContractEvent<D>[] = (\n sessionOptions?.initialEvents ?? []\n )\n .filter((event) => event.index <= frontier)\n .toSorted((a, b) => a.index - b.index)\n\n // ── optimistic overlay ───────────────────────────────────────\n let pending: Pending<D>[] = []\n\n // ── the presence plane ───────────────────────────────────────\n // Never cached, never folded. Foreign entries replicate from the\n // stream; the own entry is the local echo — server copies of self\n // are ignored (the echo is at least as new, and comparing it to\n // server stamps would put two clocks in one order).\n let participant = sessionOptions?.participant ?? options.participant\n // Participant and field keys arrive off the wire, so the map and\n // every entry are built null-prototype — see `nullProtoRecord`.\n let presenceState: PresenceMap = nullProtoRecord()\n let presenceLastSentAt = 0\n /** The last LWW stamp issued — see `nextPresenceAt`. */\n let presenceLastAt = 0\n /** Values awaiting the trailing send — non-null exactly while\n * `presenceTimer` is armed. */\n let presenceBuffer: Record<string, unknown> | null = null\n let presenceTimer: ReturnType<typeof setTimeout> | undefined\n /** Own fields set while the stream was down — re-sent once on\n * reconnect (their POSTs may have been lost with the network). */\n let presenceResend: Record<string, unknown> | null = null\n\n // ── store plumbing ───────────────────────────────────────────\n const listeners = new Set<() => void>()\n let snapshot: SessionSnapshot<D, S> | null = null\n let status: ConnectionStatus = 'idle'\n let reconnects = 0\n let lastError: Error | null = null\n let inFlightPushes = 0\n let pushWireTail: Promise<void> = Promise.resolve()\n let deferredHydration: SessionOptions<D, S> | undefined\n let hydrationNotification: ReturnType<typeof setTimeout> | undefined\n\n const emit = (): void => {\n // copy: a listener may unsubscribe (or subscribe) mid-notify\n // oxlint-disable-next-line no-useless-spread\n for (const listener of [...listeners]) listener()\n }\n\n const notify = (): void => {\n snapshot = null\n emit()\n }\n\n const notifyHydrated = (): void => {\n // `session(id, serverFold)` is also called while a destination\n // provider renders. Its own snapshot must advance synchronously,\n // but notifying an outgoing provider during that render would be a\n // React setState-in-render violation.\n snapshot = null\n clearTimeout(hydrationNotification)\n hydrationNotification = setTimeout(emit, 0)\n ;(hydrationNotification as { unref?: () => void }).unref?.()\n }\n\n const mergeServerEvents = (\n events: ContractEvent<D>[] | undefined,\n throughIndex: number,\n ): boolean => {\n if (!events || events.length === 0) return false\n const byIndex = new Map(serverEvents.map((event) => [event.index, event]))\n let changed = false\n for (const event of events) {\n if (event.index > throughIndex) continue\n const existing = byIndex.get(event.index)\n if (existing?.id === event.id) continue\n byIndex.set(event.index, event)\n changed = true\n }\n if (!changed) return false\n serverEvents.splice(\n 0,\n serverEvents.length,\n ...[...byIndex.values()].toSorted((a, b) => a.index - b.index),\n )\n return true\n }\n\n const overlayEvents = (): ContractEvent<D>[] => {\n // Acked entries first (they have a server-assigned order), then\n // unacked in push order with provisional indexes.\n const acked = pending\n .filter((p) => p.acked)\n .map((p) => p.acked!)\n .toSorted((a, b) => a.index - b.index)\n const maxKnown = acked.at(-1)?.index ?? frontier\n const unacked = pending\n .filter((p) => !p.acked)\n .map(\n (p, i) =>\n ({\n id: p.id,\n type: p.type,\n payload: p.payload,\n index: maxKnown + 1 + i, // provisional\n sessionId,\n createdAt: p.createdAt,\n }) as ContractEvent<D>,\n )\n return [...acked, ...unacked]\n }\n\n const connection = (): Connection => {\n switch (status) {\n case 'idle':\n return { status: 'idle' }\n case 'closed':\n return { status: 'closed' }\n case 'live':\n return { status: 'live', reconnects }\n case 'connecting':\n return { status: 'connecting', reconnects, error: lastError }\n }\n }\n\n const historyState = (): HistoryState => {\n const oldestLoaded = serverEvents[0]?.index ?? null\n return {\n loading: historyLoads > 0,\n // Index 1 loaded — or a frontier of 0, an empty log as far as\n // this client knows — means nothing older is left to fetch.\n complete: oldestLoaded === 1 || frontier === 0,\n oldestLoaded,\n }\n }\n\n const buildSnapshot = (): SessionSnapshot<D, S, P> => {\n const overlay = overlayEvents()\n let state = foldedState\n for (const event of overlay) state = reducer.fold(state, event)\n return {\n state,\n events: [...serverEvents, ...overlay],\n index: frontier,\n history: historyState(),\n connection: connection(),\n ...(declaresPresence\n ? { presence: presenceState as PresenceMap<P> }\n : {}),\n } as SessionSnapshot<D, S, P>\n }\n\n // ── presence ─────────────────────────────────────────────────\n /**\n * The per-session monotonic LWW stamp: wall-seeded, guarded\n * `max(now, last + 1)`, so overlapping sends can never invert —\n * the wall clock seeds it because it is the only monotonic state\n * that survives a reload without A2 owning persistence.\n */\n const nextPresenceAt = (): number => {\n presenceLastAt = Math.max(Date.now(), presenceLastAt + 1)\n return presenceLastAt\n }\n\n // Copy-on-write throughout: snapshots alias `presenceState`, so\n // every change replaces the map and the touched entry instead of\n // mutating them.\n const applyPresencePatch = (patch: PresencePatch): void => {\n if (patch.participant === participant) return // the echo is self truth\n const entry: PresenceMap[string] = Object.assign(\n nullProtoRecord<PresenceMap[string]>(),\n presenceState[patch.participant],\n )\n let changed = false\n for (const [field, value] of Object.entries(patch.values)) {\n if (value === undefined) continue\n const existing = entry[field]\n // Field-wise LWW: an older stamp loses, a tie goes to the wire.\n if (existing && existing.at.getTime() > patch.at.getTime()) continue\n if (value === null) {\n if (existing) {\n delete entry[field]\n changed = true\n }\n } else {\n entry[field] = { value, seen: patch.seen, at: patch.at }\n changed = true\n }\n }\n if (!changed) return\n const next = Object.assign(nullProtoRecord<PresenceMap>(), presenceState)\n if (Object.keys(entry).length === 0) delete next[patch.participant]\n else next[patch.participant] = entry\n presenceState = next\n notify()\n }\n\n const applyPresenceSnapshot = (incoming: PresenceMap): void => {\n const next: PresenceMap = nullProtoRecord()\n for (const [id, fields] of Object.entries(incoming)) {\n if (id === participant) continue\n next[id] = fields\n }\n // Foreign entries replaced wholesale; the own echo survives.\n const own =\n participant === undefined ? undefined : presenceState[participant]\n if (participant !== undefined && own !== undefined)\n next[participant] = own\n presenceState = next\n notify()\n }\n\n const echoPresence = (\n id: string,\n values: Record<string, unknown>,\n atMs: number,\n ): void => {\n const entry: PresenceMap[string] = Object.assign(\n nullProtoRecord<PresenceMap[string]>(),\n presenceState[id],\n )\n const at = new Date(atMs)\n for (const [field, value] of Object.entries(values)) {\n if (value === null) delete entry[field]\n else entry[field] = { value, seen: frontier, at }\n }\n const next = Object.assign(nullProtoRecord<PresenceMap>(), presenceState)\n if (Object.keys(entry).length === 0) delete next[id]\n else next[id] = entry\n presenceState = next\n notify()\n }\n\n // One send, fire-and-forget: no retry, no rollback, failures\n // dropped silently — the next send repaints. Sends are NOT\n // serialized on the ack and may overlap in flight: safe, because\n // merges are LWW by `at` per (participant, field) and one\n // sender's stamps are monotonic. `seen` is the frontier at send\n // time, not at set time; `at` is the sender's monotonic stamp.\n const sendPresence = (\n values: Record<string, unknown>,\n at: number,\n ): void => {\n presenceLastSentAt = Date.now()\n transport.sendPresence({\n sessionId,\n // Every path here starts at setPresence, which requires the\n // participant.\n presence: { participant: participant!, values, seen: frontier, at },\n })\n touch(sessionId)\n }\n\n // The fixed-cadence throttle: a set outside the interval sends on\n // the leading edge; within it, values merge field-wise into one\n // trailing send at the boundary. The cadence never couples to RTT\n // — waiting on the ack served no purpose on this plane and\n // stretched remote motion on slow links.\n const queuePresenceSend = (\n values: Record<string, unknown>,\n at?: number,\n ): void => {\n if (presenceTimer !== undefined) {\n presenceBuffer = { ...presenceBuffer, ...values }\n return\n }\n const wait =\n presenceLastSentAt + PRESENCE_TIMINGS.sendIntervalMs - Date.now()\n if (wait <= 0) {\n sendPresence(values, at ?? nextPresenceAt())\n return\n }\n presenceBuffer = { ...presenceBuffer, ...values }\n presenceTimer = setTimeout(() => {\n presenceTimer = undefined\n const buffered = presenceBuffer\n presenceBuffer = null\n // The trailing send stamps at fire time — always past every\n // stamp its merged values echoed with.\n if (buffered) sendPresence(buffered, nextPresenceAt())\n }, wait)\n ;(presenceTimer as { unref?: () => void }).unref?.()\n }\n\n const setPresence = (values: PresencePatch<P>['values']): void => {\n if (participant === undefined) {\n throw new TypeError(\n 'setPresence requires a participant — pass one to createClient({ participant }) or in the session options (the SessionProvider/useSession participant prop)',\n )\n }\n const validated: Record<string, unknown> = nullProtoRecord()\n for (const [field, value] of Object.entries(values)) {\n if (value === undefined) continue\n // '*' is a catch-all vocabulary entry: any field name (bar\n // object-plumbing names) validates against it. The actor\n // module's follower reducer declares it — the browser cannot\n // know a server-defined vocabulary, so the server stays the\n // authority.\n const schema = Object.hasOwn(presenceDefs, field)\n ? presenceDefs[field]\n : RESERVED_PARTICIPANT_IDS.has(field)\n ? undefined\n : presenceDefs['*']\n if (!schema) {\n throw new A2Error(\n 'UNKNOWN_PRESENCE_FIELD',\n `no presence field '${field}' in the reducer's vocabulary`,\n )\n }\n if (value === null) {\n validated[field] = null\n continue\n }\n const result = validateSync(schema, value, `presence field '${field}'`)\n if (result.issues) {\n throw new A2Error(\n 'INVALID_PAYLOAD',\n `invalid value for presence field '${field}'`,\n { details: result.issues },\n )\n }\n validated[field] = result.value\n }\n if (Object.keys(validated).length === 0) return\n // One stamp per set: the echo and a leading send share it, so\n // the local map and the wire agree on this write's LWW position.\n const at = nextPresenceAt()\n echoPresence(participant, validated, at)\n if (status !== 'live') {\n presenceResend = { ...presenceResend, ...validated }\n }\n queuePresenceSend(validated, at)\n touch(sessionId)\n }\n\n /** Pushes awaiting stream confirmation — resolved by `ingest` the\n * moment the frontier passes their batch. */\n let confirmWatchers: Array<{ index: number; resolve: () => void }> = []\n\n /** The single ingest point: every server-confirmed event, in log\n * order, from the stream. */\n const ingest = (event: ContractEvent<D>): void => {\n if (event.index <= frontier) return\n frontier = event.index\n serverEvents.push(event)\n foldedState = reducer.fold(foldedState, event)\n pending = pending.filter((p) => p.id !== event.id)\n if (confirmWatchers.some((w) => w.index <= frontier)) {\n const due = confirmWatchers.filter((w) => w.index <= frontier)\n confirmWatchers = confirmWatchers.filter((w) => w.index > frontier)\n for (const watcher of due) watcher.resolve()\n }\n notify()\n touch(sessionId)\n }\n\n // ── push ─────────────────────────────────────────────────────\n const validated = (\n events: AppendInput<D>[],\n ): Array<{ id: string; type: string; payload: unknown }> =>\n events.map((event) => {\n const schema = Object.hasOwn(reducer.events, event.type)\n ? reducer.events[event.type]\n : undefined\n if (!schema) {\n throw new A2Error(\n 'UNKNOWN_EVENT_TYPE',\n `no event type '${String(event.type)}' in the reducer's vocabulary`,\n )\n }\n const result = validateSync(\n schema,\n event.payload,\n `event '${String(event.type)}'`,\n )\n if (result.issues) {\n throw new A2Error(\n 'INVALID_PAYLOAD',\n `invalid payload for event '${String(event.type)}'`,\n { details: result.issues },\n )\n }\n return {\n id: event.id ?? crypto.randomUUID(),\n type: event.type,\n payload: result.value,\n }\n })\n\n const post = async (\n body: TransportPushBody,\n ): Promise<ContractEvent<D>[]> => {\n let lastPushError: A2Error = new A2Error(\n 'STORE_UNAVAILABLE',\n 'push failed',\n )\n for (let attempt = 1; attempt <= PUSH_ATTEMPTS; attempt += 1) {\n try {\n const rows = await transport.push(body)\n return rows.map((row) => eventFromWire(row) as ContractEvent<D>)\n } catch (err) {\n lastPushError =\n err instanceof A2Error\n ? err\n : new A2Error('STORE_UNAVAILABLE', 'push request failed', {\n cause: err,\n })\n }\n // Only the documented retryable code retries; identical ids\n // make the retry idempotent on the server.\n if (lastPushError.code !== 'STORE_UNAVAILABLE') throw lastPushError\n if (attempt < PUSH_ATTEMPTS) {\n const sleepMs = 250 * attempt\n // Wait for the clock AND, when the transport can tell us,\n // the wire. The pacing sleep is a floor: a failure acked\n // over a healthy socket (a shedding store) must not re-fire\n // at wire speed. A push caught in a routine reconnect blip\n // additionally parks until the subscription is confirmed;\n // that cap scales with the reconnect backoff so an\n // unreachable server still exhausts attempts promptly.\n await Promise.all([\n new Promise((resolve) => setTimeout(resolve, sleepMs)),\n transport.awaitReady?.(\n sessionId,\n sleepMs + STREAM_TIMINGS.reconnectBaseMs * attempt,\n ),\n ])\n }\n }\n throw lastPushError\n }\n\n /**\n * Decorate the ack promise into a PushResult. `confirmed` is a\n * lazy getter — materialized on first access, so callers that\n * ignore it can't leak an unhandled rejection.\n */\n const withConfirmed = (ack: Promise<ContractEvent<D>[]>): PushResult<D> => {\n let confirmed: Promise<ContractEvent<D>[]> | undefined\n return Object.defineProperty(ack as PushResult<D>, 'confirmed', {\n get(): Promise<ContractEvent<D>[]> {\n confirmed ??= ack.then(\n (acked) =>\n new Promise<ContractEvent<D>[]>((resolve) => {\n const last = acked.at(-1)?.index ?? 0\n if (frontier >= last) {\n resolve(acked)\n return\n }\n confirmWatchers.push({\n index: last,\n resolve: () => resolve(acked),\n })\n }),\n )\n return confirmed\n },\n })\n }\n\n const push = (...events: AppendInput<D>[]): PushResult<D> => {\n touch(sessionId)\n return withConfirmed(\n (async () => {\n if (events.length === 0) {\n throw new TypeError('push requires at least one event')\n }\n const entries: Pending<D>[] = validated(events).map((e) => ({\n id: e.id,\n type: e.type,\n payload: e.payload,\n createdAt: new Date(),\n }))\n // Reserve before notifying: a subscriber may reenter push(),\n // and that work must follow the call whose state it observed.\n const waitForPriorPush = pushWireTail\n let releasePush!: () => void\n pushWireTail = new Promise<void>((resolve) => {\n releasePush = resolve\n })\n pending.push(...entries)\n inFlightPushes += 1\n\n try {\n notify() // optimistic — the view updates before the network moves\n await waitForPriorPush\n const acked = await post({\n sessionId,\n events: entries.map(({ id, type, payload }) => ({\n id,\n type,\n payload,\n })),\n })\n for (const event of acked) {\n const entry = pending.find((p) => p.id === event.id)\n if (entry) entry.acked = event // stream retires it at its index\n }\n notify()\n return acked\n } catch (err) {\n // Rollback: refold without the rejected events.\n const ids = new Set(entries.map((e) => e.id))\n pending = pending.filter((p) => !ids.has(p.id))\n notify()\n throw err\n } finally {\n releasePush()\n inFlightPushes -= 1\n if (inFlightPushes === 0 && deferredHydration) {\n const next = deferredHydration\n deferredHydration = undefined\n runtime.hydrate(next)\n }\n touch(sessionId)\n }\n })(),\n )\n }\n\n // ── backscroll ───────────────────────────────────────────────\n // Cold reads of the log below the frontier. Fetched events merge\n // into `serverEvents` only — never the fold, never the overlay.\n let historyLoads = 0\n /** Calls chain per session: each resolves its bounds after the\n * prior call's merge, so overlapping backscrolls page backward\n * instead of re-fetching the same range. */\n let historyTail: Promise<unknown> = Promise.resolve()\n\n const eventsBetween = (gte: number, lte: number): ContractEvent<D>[] =>\n serverEvents.filter((event) => event.index >= gte && event.index <= lte)\n\n /** The narrowest sub-range of [gte, lte] missing from the feed, or\n * null when the range is fully loaded (nothing to fetch). */\n const missingBetween = (\n gte: number,\n lte: number,\n ): { gte: number; lte: number } | null => {\n const present = new Set(eventsBetween(gte, lte).map((e) => e.index))\n let lo = gte\n while (lo <= lte && present.has(lo)) lo += 1\n if (lo > lte) return null\n let hi = lte\n while (hi > lo && present.has(hi)) hi -= 1\n return { gte: lo, lte: hi }\n }\n\n const loadHistory = (\n loadOptions?: LoadHistoryOptions,\n ): Promise<ContractEvent<D>[]> => {\n const readHistory = transport.history\n if (readHistory === undefined) {\n throw new TypeError(\n 'loadHistory requires an http api — the ws transport has no history lane; serve the session with server.fetch and pass its route url as the string or { type: \"http\" } api',\n )\n }\n const before = loadOptions?.before\n const limit = loadOptions?.limit\n if (\n before !== undefined &&\n (!Number.isSafeInteger(before) || before < 1)\n ) {\n throw new TypeError(\n 'loadHistory before must be a positive safe integer',\n )\n }\n if (limit !== undefined && (!Number.isSafeInteger(limit) || limit < 1)) {\n throw new TypeError('loadHistory limit must be a positive safe integer')\n }\n touch(sessionId)\n const run = historyTail.then(async () => {\n const upper = before ?? serverEvents[0]?.index ?? frontier + 1\n // Strictly at or below the frontier: the live stream owns\n // everything above it, and the optimistic overlay must never\n // collide with a backscrolled row.\n const lte = Math.min(upper - 1, frontier)\n const gte = Math.max(1, upper - (limit ?? DEFAULT_HISTORY_LIMIT))\n if (gte > lte) return []\n const missing = missingBetween(gte, lte)\n if (missing === null) return eventsBetween(gte, lte)\n historyLoads += 1\n notify()\n try {\n const rows = await readHistory({ sessionId, ...missing })\n mergeServerEvents(\n rows.map((row) => eventFromWire(row) as ContractEvent<D>),\n frontier,\n )\n return eventsBetween(gte, lte)\n } finally {\n historyLoads -= 1\n notify()\n touch(sessionId)\n }\n })\n // Failures reject the caller, never the chain.\n historyTail = run.catch(() => {})\n return run\n }\n\n // ── the live stream ──────────────────────────────────────────\n // A run-generation model instead of a terminal `closed` flag:\n // stopping bumps the generation (the running loop notices and\n // exits), connect() starts a fresh one. Reentrant by design.\n // Consumers hold leases: connect() counts one and returns its\n // release, the last release stops the stream, and close() is the\n // hard stop — it drops every lease and stops now (bumping\n // `leaseEpoch` makes the outstanding releases inert).\n let generation = 0\n let active = false\n let abort: AbortController | null = null\n let leases = 0\n let leaseEpoch = 0\n\n const stopStream = (): void => {\n touch(sessionId)\n if (!active) return\n active = false\n generation += 1 // the running loop notices and exits\n abort?.abort()\n abort = null\n // A pending trailing send dies with the stream — losing one is\n // fine by definition; sets made while closed accumulate in\n // `presenceResend` and repaint after the next connect.\n clearTimeout(presenceTimer)\n presenceTimer = undefined\n presenceBuffer = null\n status = 'closed'\n notify()\n }\n\n const runStream = async (run: number): Promise<void> => {\n let backoff = STREAM_TIMINGS.reconnectBaseMs\n // oxlint-disable no-await-in-loop -- sequential reconnect loop\n // oxlint-disable-next-line no-unmodified-loop-condition -- close() bumps `generation`\n while (generation === run) {\n const controller = new AbortController()\n abort = controller\n // The stall watchdog: the server heartbeats the stream, so a\n // healthy connection is never silent for long. Silence past the\n // timeout means the connection is dead in a way the socket\n // won't report (an offline browser's established SSE socket\n // neither errors nor receives) — abort it and let the normal\n // reconnect path run. This is what keeps `status: 'live'`\n // honest.\n let stall: ReturnType<typeof setTimeout> | undefined\n let stalled = false\n const armStall = (): void => {\n clearTimeout(stall)\n stall = setTimeout(() => {\n stalled = true\n controller.abort()\n }, STREAM_TIMINGS.stallTimeoutMs)\n ;(stall as { unref?: () => void }).unref?.()\n }\n let wasLive = false\n try {\n const frames = transport.connect({\n sessionId,\n startAfter: frontier,\n signal: controller.signal,\n })\n for await (const frame of frames) {\n if (generation !== run) break\n // Every frame counts — heartbeats included. Liveness is\n // about the connection, not about events.\n armStall()\n if (!wasLive) {\n // The first frame is the connection signal: the transport\n // yields it the moment the stream is established.\n backoff = STREAM_TIMINGS.reconnectBaseMs\n wasLive = true\n status = 'live'\n lastError = null\n notify()\n if (presenceResend) {\n const values = presenceResend\n presenceResend = null\n queuePresenceSend(values)\n }\n }\n if (frame.kind === 'event') {\n ingest(eventFromWire(frame.event) as ContractEvent<D>)\n } else if (frame.kind === 'presence') {\n applyPresencePatch(presencePatchFromWire(frame.patch))\n } else if (frame.kind === 'presence-snapshot') {\n applyPresenceSnapshot(\n presenceSnapshotFromWire(frame.snapshot).snapshot,\n )\n }\n }\n // The transport ended the stream cleanly — reconnect, but it\n // isn't an error.\n if (generation === run) {\n lastError = null\n }\n } catch (err) {\n if (generation === run) {\n lastError = stalled\n ? new Error(\n `stream stalled: no data for ${STREAM_TIMINGS.stallTimeoutMs}ms`,\n )\n : err instanceof Error\n ? err\n : new Error(String(err))\n }\n } finally {\n clearTimeout(stall)\n }\n if (generation !== run) break\n if (wasLive) reconnects += 1\n status = 'connecting'\n notify()\n await new Promise<void>((resolve) => {\n let settled = false\n const finish = (): void => {\n if (settled) return\n settled = true\n clearTimeout(timer)\n // oxlint-disable-next-line no-multiple-resolved -- guarded above\n resolve()\n }\n const timer = setTimeout(finish, backoff)\n ;(timer as { unref?: () => void }).unref?.()\n abort?.signal.addEventListener('abort', finish)\n })\n backoff = Math.min(backoff * 2, STREAM_TIMINGS.reconnectMaxMs)\n }\n // oxlint-enable no-await-in-loop\n }\n\n const runtime: SessionRuntime<D, S, P> = {\n sessionId,\n // Only on presence-declaring contracts — the type surface\n // promises no runtime-inert members (a2-api.md §12).\n ...(declaresPresence ? { setPresence } : {}),\n subscribe(listener) {\n touch(sessionId)\n listeners.add(listener)\n return () => {\n listeners.delete(listener)\n touch(sessionId)\n }\n },\n getSnapshot() {\n snapshot ??= buildSnapshot()\n return snapshot\n },\n push,\n loadHistory,\n connect() {\n touch(sessionId)\n leases += 1\n const epoch = leaseEpoch\n if (!active) {\n active = true\n status = 'connecting'\n notify()\n void runStream(generation)\n }\n let released = false\n return () => {\n // Idempotent, and inert after a hard close() — a stale\n // release must not touch leases taken since.\n if (released || leaseEpoch !== epoch) return\n released = true\n touch(sessionId)\n leases -= 1\n if (leases === 0) stopStream()\n }\n },\n close() {\n leases = 0\n leaseEpoch += 1\n stopStream()\n },\n hydrate(next) {\n touch(sessionId)\n if (!next) return\n participant ??= next.participant\n const nextIndex = next.initialIndex ?? 0\n if (nextIndex > frontier && inFlightPushes > 0) {\n if (\n !deferredHydration ||\n nextIndex > (deferredHydration.initialIndex ?? 0)\n ) {\n deferredHydration = next\n }\n return\n }\n\n const historyChanged = mergeServerEvents(\n next.initialEvents,\n Math.min(nextIndex, frontier),\n )\n if (next.initialState === undefined || nextIndex <= frontier) {\n if (historyChanged) notifyHydrated()\n return\n }\n\n // The server fold subsumes everything observed through the old\n // frontier. Keep later optimistic work overlaid, retiring acked\n // entries the new frontier proves are already durable.\n frontier = nextIndex\n foldedState = next.initialState\n mergeServerEvents(next.initialEvents, frontier)\n pending = pending.filter(\n (entry) => !entry.acked || entry.acked.index > frontier,\n )\n if (confirmWatchers.some((watcher) => watcher.index <= frontier)) {\n const due = confirmWatchers.filter(\n (watcher) => watcher.index <= frontier,\n )\n confirmWatchers = confirmWatchers.filter(\n (watcher) => watcher.index > frontier,\n )\n for (const watcher of due) watcher.resolve()\n }\n notifyHydrated()\n },\n canEvict() {\n return (\n listeners.size === 0 &&\n !active &&\n inFlightPushes === 0 &&\n historyLoads === 0 &&\n confirmWatchers.length === 0 &&\n presenceTimer === undefined\n )\n },\n } as SessionRuntime<D, S, P>\n\n return runtime\n }\n\n return {\n session(sessionId, sessionOptions) {\n const existing = sessions.get(sessionId)\n if (existing) {\n existing.runtime.hydrate(sessionOptions)\n touch(sessionId)\n return existing.runtime\n }\n\n const runtime = makeSession(sessionId, sessionOptions)\n sessions.set(sessionId, { runtime })\n touch(sessionId)\n return runtime\n },\n }\n}\n"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;;;;;;;KAQY;cAYC,gBAAgB;WAClB,MAAM;;WAEN;EAET,YACE,MAAM,aACN,iBACA;IAAY;IAAmB;;;;;;;;;;;cAgCtB,0BAA0B;EACrC,YAAY,iBAAiB;IAAY"}