@replit/river 0.23.18 → 0.24.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 (84) hide show
  1. package/README.md +17 -16
  2. package/dist/chunk-227EQHH5.js +653 -0
  3. package/dist/chunk-227EQHH5.js.map +1 -0
  4. package/dist/chunk-6YFPHVNO.js +277 -0
  5. package/dist/chunk-6YFPHVNO.js.map +1 -0
  6. package/dist/{chunk-7MJYOL32.js → chunk-BGJDNLTJ.js} +15 -23
  7. package/dist/chunk-BGJDNLTJ.js.map +1 -0
  8. package/dist/chunk-HXOQQXL4.js +382 -0
  9. package/dist/chunk-HXOQQXL4.js.map +1 -0
  10. package/dist/{chunk-R2HAS3GM.js → chunk-IYYQ7BII.js} +55 -41
  11. package/dist/chunk-IYYQ7BII.js.map +1 -0
  12. package/dist/{chunk-AVL32IMG.js → chunk-L664A3WA.js} +20 -16
  13. package/dist/chunk-L664A3WA.js.map +1 -0
  14. package/dist/{chunk-EV5HW4IC.js → chunk-M7E6LQO2.js} +66 -53
  15. package/dist/chunk-M7E6LQO2.js.map +1 -0
  16. package/dist/{chunk-6LCL2ZZF.js → chunk-TAH2GVTJ.js} +1 -1
  17. package/dist/chunk-TAH2GVTJ.js.map +1 -0
  18. package/dist/chunk-XOFF3UPL.js +399 -0
  19. package/dist/chunk-XOFF3UPL.js.map +1 -0
  20. package/dist/{client-5776a6bb.d.ts → client-2ba72e89.d.ts} +12 -15
  21. package/dist/connection-55cba970.d.ts +11 -0
  22. package/dist/{connection-bd35d442.d.ts → connection-c6db05d9.d.ts} +1 -5
  23. package/dist/{handshake-a947c234.d.ts → handshake-0b88e8fc.d.ts} +150 -184
  24. package/dist/logging/index.cjs.map +1 -1
  25. package/dist/logging/index.d.cts +1 -1
  26. package/dist/logging/index.d.ts +1 -1
  27. package/dist/logging/index.js +1 -1
  28. package/dist/{index-ea74cdbb.d.ts → message-e6c560fd.d.ts} +2 -2
  29. package/dist/router/index.cjs +105 -63
  30. package/dist/router/index.cjs.map +1 -1
  31. package/dist/router/index.d.cts +11 -10
  32. package/dist/router/index.d.ts +11 -10
  33. package/dist/router/index.js +2 -2
  34. package/dist/server-732e7014.d.ts +42 -0
  35. package/dist/{services-38b3f758.d.ts → services-adfd0bc3.d.ts} +3 -3
  36. package/dist/transport/impls/uds/client.cjs +1246 -1230
  37. package/dist/transport/impls/uds/client.cjs.map +1 -1
  38. package/dist/transport/impls/uds/client.d.cts +4 -4
  39. package/dist/transport/impls/uds/client.d.ts +4 -4
  40. package/dist/transport/impls/uds/client.js +7 -13
  41. package/dist/transport/impls/uds/client.js.map +1 -1
  42. package/dist/transport/impls/uds/server.cjs +1298 -1151
  43. package/dist/transport/impls/uds/server.cjs.map +1 -1
  44. package/dist/transport/impls/uds/server.d.cts +4 -4
  45. package/dist/transport/impls/uds/server.d.ts +4 -4
  46. package/dist/transport/impls/uds/server.js +6 -6
  47. package/dist/transport/impls/ws/client.cjs +976 -965
  48. package/dist/transport/impls/ws/client.cjs.map +1 -1
  49. package/dist/transport/impls/ws/client.d.cts +4 -4
  50. package/dist/transport/impls/ws/client.d.ts +4 -4
  51. package/dist/transport/impls/ws/client.js +6 -7
  52. package/dist/transport/impls/ws/client.js.map +1 -1
  53. package/dist/transport/impls/ws/server.cjs +1182 -1047
  54. package/dist/transport/impls/ws/server.cjs.map +1 -1
  55. package/dist/transport/impls/ws/server.d.cts +4 -4
  56. package/dist/transport/impls/ws/server.d.ts +4 -4
  57. package/dist/transport/impls/ws/server.js +6 -6
  58. package/dist/transport/index.cjs +1433 -1360
  59. package/dist/transport/index.cjs.map +1 -1
  60. package/dist/transport/index.d.cts +5 -5
  61. package/dist/transport/index.d.ts +5 -5
  62. package/dist/transport/index.js +9 -9
  63. package/dist/util/testHelpers.cjs +744 -310
  64. package/dist/util/testHelpers.cjs.map +1 -1
  65. package/dist/util/testHelpers.d.cts +9 -6
  66. package/dist/util/testHelpers.d.ts +9 -6
  67. package/dist/util/testHelpers.js +34 -10
  68. package/dist/util/testHelpers.js.map +1 -1
  69. package/package.json +1 -1
  70. package/dist/chunk-6LCL2ZZF.js.map +0 -1
  71. package/dist/chunk-7MJYOL32.js.map +0 -1
  72. package/dist/chunk-AVL32IMG.js.map +0 -1
  73. package/dist/chunk-DPKOJQWF.js +0 -476
  74. package/dist/chunk-DPKOJQWF.js.map +0 -1
  75. package/dist/chunk-EV5HW4IC.js.map +0 -1
  76. package/dist/chunk-J6N6H2WU.js +0 -476
  77. package/dist/chunk-J6N6H2WU.js.map +0 -1
  78. package/dist/chunk-MW5JXLHY.js +0 -348
  79. package/dist/chunk-MW5JXLHY.js.map +0 -1
  80. package/dist/chunk-R2HAS3GM.js.map +0 -1
  81. package/dist/chunk-RJOWZIWB.js +0 -335
  82. package/dist/chunk-RJOWZIWB.js.map +0 -1
  83. package/dist/connection-df85db7e.d.ts +0 -17
  84. package/dist/server-53cd5b7e.d.ts +0 -24
@@ -0,0 +1,399 @@
1
+ import {
2
+ ProtocolError,
3
+ Transport
4
+ } from "./chunk-6YFPHVNO.js";
5
+ import {
6
+ SessionStateGraph,
7
+ defaultClientTransportOptions
8
+ } from "./chunk-227EQHH5.js";
9
+ import {
10
+ ControlMessageHandshakeResponseSchema,
11
+ HandshakeErrorRetriableResponseCodes,
12
+ coerceErrorString,
13
+ getPropagationContext,
14
+ handshakeRequestMessage,
15
+ tracing_default
16
+ } from "./chunk-IYYQ7BII.js";
17
+
18
+ // transport/client.ts
19
+ import { SpanStatusCode } from "@opentelemetry/api";
20
+
21
+ // transport/rateLimit.ts
22
+ var LeakyBucketRateLimit = class {
23
+ budgetConsumed;
24
+ intervalHandles;
25
+ options;
26
+ constructor(options) {
27
+ this.options = options;
28
+ this.budgetConsumed = /* @__PURE__ */ new Map();
29
+ this.intervalHandles = /* @__PURE__ */ new Map();
30
+ }
31
+ getBackoffMs(user) {
32
+ if (!this.budgetConsumed.has(user))
33
+ return 0;
34
+ const exponent = Math.max(0, this.getBudgetConsumed(user) - 1);
35
+ const jitter = Math.floor(Math.random() * this.options.maxJitterMs);
36
+ const backoffMs = Math.min(
37
+ this.options.baseIntervalMs * 2 ** exponent,
38
+ this.options.maxBackoffMs
39
+ );
40
+ return backoffMs + jitter;
41
+ }
42
+ get totalBudgetRestoreTime() {
43
+ return this.options.budgetRestoreIntervalMs * this.options.attemptBudgetCapacity;
44
+ }
45
+ consumeBudget(user) {
46
+ this.stopLeak(user);
47
+ this.budgetConsumed.set(user, this.getBudgetConsumed(user) + 1);
48
+ }
49
+ getBudgetConsumed(user) {
50
+ return this.budgetConsumed.get(user) ?? 0;
51
+ }
52
+ hasBudget(user) {
53
+ return this.getBudgetConsumed(user) < this.options.attemptBudgetCapacity;
54
+ }
55
+ startRestoringBudget(user) {
56
+ if (this.intervalHandles.has(user)) {
57
+ return;
58
+ }
59
+ const restoreBudgetForUser = () => {
60
+ const currentBudget = this.budgetConsumed.get(user);
61
+ if (!currentBudget) {
62
+ this.stopLeak(user);
63
+ return;
64
+ }
65
+ const newBudget = currentBudget - 1;
66
+ if (newBudget === 0) {
67
+ this.budgetConsumed.delete(user);
68
+ return;
69
+ }
70
+ this.budgetConsumed.set(user, newBudget);
71
+ };
72
+ const intervalHandle = setInterval(
73
+ restoreBudgetForUser,
74
+ this.options.budgetRestoreIntervalMs
75
+ );
76
+ this.intervalHandles.set(user, intervalHandle);
77
+ }
78
+ stopLeak(user) {
79
+ if (!this.intervalHandles.has(user)) {
80
+ return;
81
+ }
82
+ clearInterval(this.intervalHandles.get(user));
83
+ this.intervalHandles.delete(user);
84
+ }
85
+ close() {
86
+ for (const user of this.intervalHandles.keys()) {
87
+ this.stopLeak(user);
88
+ }
89
+ }
90
+ };
91
+
92
+ // transport/client.ts
93
+ import { Value } from "@sinclair/typebox/value";
94
+ var ClientTransport = class extends Transport {
95
+ /**
96
+ * The options for this transport.
97
+ */
98
+ options;
99
+ retryBudget;
100
+ /**
101
+ * A flag indicating whether the transport should automatically reconnect
102
+ * when a connection is dropped.
103
+ * Realistically, this should always be true for clients unless you are writing
104
+ * tests or a special case where you don't want to reconnect.
105
+ */
106
+ reconnectOnConnectionDrop = true;
107
+ /**
108
+ * Optional handshake options for this client.
109
+ */
110
+ handshakeExtensions;
111
+ constructor(clientId, providedOptions) {
112
+ super(clientId, providedOptions);
113
+ this.options = {
114
+ ...defaultClientTransportOptions,
115
+ ...providedOptions
116
+ };
117
+ this.retryBudget = new LeakyBucketRateLimit(this.options);
118
+ }
119
+ extendHandshake(options) {
120
+ this.handshakeExtensions = options;
121
+ }
122
+ tryReconnecting(to) {
123
+ if (this.reconnectOnConnectionDrop && this.getStatus() === "open") {
124
+ this.connect(to);
125
+ }
126
+ }
127
+ send(to, msg) {
128
+ if (this.getStatus() === "closed") {
129
+ const err = "transport is closed, cant send";
130
+ this.log?.error(err, {
131
+ clientId: this.clientId,
132
+ transportMessage: msg,
133
+ tags: ["invariant-violation"]
134
+ });
135
+ throw new Error(err);
136
+ }
137
+ let session = this.sessions.get(to);
138
+ if (!session) {
139
+ session = this.createUnconnectedSession(to);
140
+ }
141
+ return session.send(msg);
142
+ }
143
+ createUnconnectedSession(to) {
144
+ const session = SessionStateGraph.entrypoints.NoConnection(
145
+ to,
146
+ this.clientId,
147
+ {
148
+ onSessionGracePeriodElapsed: () => {
149
+ this.onSessionGracePeriodElapsed(session);
150
+ }
151
+ },
152
+ this.options,
153
+ this.log
154
+ );
155
+ this.updateSession(session);
156
+ return session;
157
+ }
158
+ // listeners
159
+ onConnectingFailed(session) {
160
+ const noConnectionSession = super.onConnectingFailed(session);
161
+ this.tryReconnecting(noConnectionSession.to);
162
+ return noConnectionSession;
163
+ }
164
+ onConnClosed(session) {
165
+ const noConnectionSession = super.onConnClosed(session);
166
+ this.tryReconnecting(noConnectionSession.to);
167
+ return noConnectionSession;
168
+ }
169
+ onConnectionEstablished(session, conn) {
170
+ const handshakingSession = SessionStateGraph.transition.ConnectingToHandshaking(session, conn, {
171
+ onConnectionErrored: (err) => {
172
+ const errStr = coerceErrorString(err);
173
+ this.log?.error(
174
+ `connection to ${handshakingSession.to} errored during handshake: ${errStr}`,
175
+ handshakingSession.loggingMetadata
176
+ );
177
+ },
178
+ onConnectionClosed: () => {
179
+ this.log?.warn(
180
+ `connection to ${handshakingSession.to} closed during handshake`,
181
+ handshakingSession.loggingMetadata
182
+ );
183
+ this.onConnClosed(handshakingSession);
184
+ },
185
+ onHandshake: (msg) => {
186
+ this.onHandshakeResponse(handshakingSession, msg);
187
+ },
188
+ onInvalidHandshake: (reason) => {
189
+ this.log?.error(
190
+ `invalid handshake: ${reason}`,
191
+ handshakingSession.loggingMetadata
192
+ );
193
+ this.deleteSession(session);
194
+ this.protocolError(ProtocolError.HandshakeFailed, reason);
195
+ },
196
+ onHandshakeTimeout: () => {
197
+ this.log?.error(
198
+ `connection to ${handshakingSession.to} timed out during handshake`,
199
+ handshakingSession.loggingMetadata
200
+ );
201
+ this.onConnClosed(handshakingSession);
202
+ }
203
+ });
204
+ this.updateSession(handshakingSession);
205
+ void this.sendHandshake(handshakingSession);
206
+ return handshakingSession;
207
+ }
208
+ rejectHandshakeResponse(session, reason, metadata) {
209
+ session.conn.telemetry?.span.setStatus({
210
+ code: SpanStatusCode.ERROR,
211
+ message: reason
212
+ });
213
+ this.log?.warn(reason, metadata);
214
+ this.deleteSession(session);
215
+ }
216
+ onHandshakeResponse(session, msg) {
217
+ if (!Value.Check(ControlMessageHandshakeResponseSchema, msg.payload)) {
218
+ const reason = `received invalid handshake response`;
219
+ this.rejectHandshakeResponse(session, reason, {
220
+ ...session.loggingMetadata,
221
+ transportMessage: msg,
222
+ validationErrors: [
223
+ ...Value.Errors(ControlMessageHandshakeResponseSchema, msg.payload)
224
+ ]
225
+ });
226
+ return;
227
+ }
228
+ if (!msg.payload.status.ok) {
229
+ const retriable = msg.payload.status.code ? Value.Check(
230
+ HandshakeErrorRetriableResponseCodes,
231
+ msg.payload.status.code
232
+ ) : false;
233
+ const reason = `handshake failed: ${msg.payload.status.reason}`;
234
+ this.rejectHandshakeResponse(session, reason, {
235
+ ...session.loggingMetadata,
236
+ transportMessage: msg
237
+ });
238
+ if (retriable) {
239
+ this.tryReconnecting(session.to);
240
+ } else {
241
+ this.deleteSession(session);
242
+ this.protocolError(ProtocolError.HandshakeFailed, reason);
243
+ }
244
+ return;
245
+ }
246
+ if (msg.payload.status.sessionId !== session.id) {
247
+ const reason = `session id mismatch: expected ${session.id}, got ${msg.payload.status.sessionId}`;
248
+ this.rejectHandshakeResponse(session, reason, {
249
+ ...session.loggingMetadata,
250
+ transportMessage: msg
251
+ });
252
+ return;
253
+ }
254
+ this.log?.info(`handshake from ${msg.from} ok`, {
255
+ ...session.loggingMetadata,
256
+ transportMessage: msg
257
+ });
258
+ const connectedSession = SessionStateGraph.transition.HandshakingToConnected(session, {
259
+ onConnectionErrored: (err) => {
260
+ const errStr = coerceErrorString(err);
261
+ this.log?.warn(
262
+ `connection to ${connectedSession.to} errored: ${errStr}`,
263
+ connectedSession.loggingMetadata
264
+ );
265
+ },
266
+ onConnectionClosed: () => {
267
+ this.log?.info(
268
+ `connection to ${connectedSession.to} closed`,
269
+ connectedSession.loggingMetadata
270
+ );
271
+ this.onConnClosed(connectedSession);
272
+ },
273
+ onMessage: (msg2) => this.handleMsg(msg2),
274
+ onInvalidMessage: (reason) => {
275
+ this.deleteSession(connectedSession);
276
+ this.protocolError(ProtocolError.MessageOrderingViolated, reason);
277
+ }
278
+ });
279
+ this.updateSession(connectedSession);
280
+ this.retryBudget.startRestoringBudget(connectedSession.to);
281
+ }
282
+ /**
283
+ * Manually attempts to connect to a client.
284
+ * @param to The client ID of the node to connect to.
285
+ */
286
+ connect(to) {
287
+ let session = this.sessions.get(to);
288
+ session ??= this.createUnconnectedSession(to);
289
+ if (session.state !== "NoConnection" /* NoConnection */) {
290
+ this.log?.debug(
291
+ `session to ${to} has state ${session.state}, skipping connect attempt`,
292
+ session.loggingMetadata
293
+ );
294
+ return;
295
+ }
296
+ if (this.getStatus() !== "open") {
297
+ this.log?.info(
298
+ `transport state is no longer open, cancelling attempt to connect to ${to}`,
299
+ session.loggingMetadata
300
+ );
301
+ return;
302
+ }
303
+ if (!this.retryBudget.hasBudget(to)) {
304
+ const budgetConsumed = this.retryBudget.getBudgetConsumed(to);
305
+ const errMsg = `tried to connect to ${to} but retry budget exceeded (more than ${budgetConsumed} attempts in the last ${this.retryBudget.totalBudgetRestoreTime}ms)`;
306
+ this.log?.error(errMsg, session.loggingMetadata);
307
+ this.protocolError(ProtocolError.RetriesExceeded, errMsg);
308
+ return;
309
+ }
310
+ let sleep = Promise.resolve();
311
+ const backoffMs = this.retryBudget.getBackoffMs(to);
312
+ if (backoffMs > 0) {
313
+ sleep = new Promise((resolve) => setTimeout(resolve, backoffMs));
314
+ }
315
+ this.log?.info(
316
+ `attempting connection to ${to} (${backoffMs}ms backoff)`,
317
+ session.loggingMetadata
318
+ );
319
+ this.retryBudget.consumeBudget(to);
320
+ const reconnectPromise = tracing_default.startActiveSpan("connect", async (span) => {
321
+ try {
322
+ span.addEvent("backoff", { backoffMs });
323
+ await sleep;
324
+ if (this.getStatus() !== "open") {
325
+ throw new Error("transport state is no longer open");
326
+ }
327
+ span.addEvent("connecting");
328
+ return await this.createNewOutgoingConnection(to);
329
+ } catch (err) {
330
+ const errStr = coerceErrorString(err);
331
+ span.recordException(errStr);
332
+ span.setStatus({ code: SpanStatusCode.ERROR });
333
+ throw err;
334
+ } finally {
335
+ span.end();
336
+ }
337
+ });
338
+ const connectingSession = SessionStateGraph.transition.NoConnectionToConnecting(
339
+ session,
340
+ reconnectPromise,
341
+ {
342
+ onConnectionEstablished: (conn) => {
343
+ this.log?.debug(
344
+ `connection to ${connectingSession.to} established`,
345
+ connectingSession.loggingMetadata
346
+ );
347
+ this.onConnectionEstablished(connectingSession, conn);
348
+ },
349
+ onConnectionFailed: (error) => {
350
+ const errStr = coerceErrorString(error);
351
+ this.log?.error(
352
+ `error connecting to ${connectingSession.to}: ${errStr}`,
353
+ connectingSession.loggingMetadata
354
+ );
355
+ this.onConnectingFailed(connectingSession);
356
+ },
357
+ onConnectionTimeout: () => {
358
+ this.log?.error(
359
+ `connection to ${connectingSession.to} timed out`,
360
+ connectingSession.loggingMetadata
361
+ );
362
+ this.onConnectingFailed(connectingSession);
363
+ }
364
+ }
365
+ );
366
+ this.updateSession(connectingSession);
367
+ }
368
+ async sendHandshake(session) {
369
+ let metadata = void 0;
370
+ if (this.handshakeExtensions) {
371
+ metadata = await this.handshakeExtensions.construct();
372
+ }
373
+ const requestMsg = handshakeRequestMessage({
374
+ from: this.clientId,
375
+ to: session.to,
376
+ sessionId: session.id,
377
+ expectedSessionState: {
378
+ nextExpectedSeq: session.ack,
379
+ nextSentSeq: session.nextSeq()
380
+ },
381
+ metadata,
382
+ tracing: getPropagationContext(session.telemetry.ctx)
383
+ });
384
+ this.log?.debug(`sending handshake request to ${session.to}`, {
385
+ ...session.loggingMetadata,
386
+ transportMessage: requestMsg
387
+ });
388
+ session.sendHandshake(requestMsg);
389
+ }
390
+ close() {
391
+ this.retryBudget.close();
392
+ super.close();
393
+ }
394
+ };
395
+
396
+ export {
397
+ ClientTransport
398
+ };
399
+ //# sourceMappingURL=chunk-XOFF3UPL.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../transport/client.ts","../transport/rateLimit.ts"],"sourcesContent":["import { SpanStatusCode } from '@opentelemetry/api';\nimport { ClientHandshakeOptions } from '../router/handshake';\nimport {\n ControlMessageHandshakeResponseSchema,\n HandshakeErrorRetriableResponseCodes,\n OpaqueTransportMessage,\n PartialTransportMessage,\n TransportClientId,\n handshakeRequestMessage,\n} from './message';\nimport {\n ClientTransportOptions,\n ProvidedClientTransportOptions,\n defaultClientTransportOptions,\n} from './options';\nimport { LeakyBucketRateLimit } from './rateLimit';\nimport { Transport } from './transport';\nimport { coerceErrorString } from '../util/stringify';\nimport { ProtocolError } from './events';\nimport { Value } from '@sinclair/typebox/value';\nimport tracer, { getPropagationContext } from '../tracing';\nimport { Connection } from './connection';\nimport { MessageMetadata } from '../logging';\nimport { SessionConnecting } from './sessionStateMachine/SessionConnecting';\nimport { SessionHandshaking } from './sessionStateMachine/SessionHandshaking';\nimport { SessionConnected } from './sessionStateMachine/SessionConnected';\nimport { SessionStateGraph } from './sessionStateMachine/transitions';\nimport { SessionState } from './sessionStateMachine/common';\nimport { SessionNoConnection } from './sessionStateMachine/SessionNoConnection';\n\nexport abstract class ClientTransport<\n ConnType extends Connection,\n> extends Transport<ConnType> {\n /**\n * The options for this transport.\n */\n protected options: ClientTransportOptions;\n\n retryBudget: LeakyBucketRateLimit;\n\n /**\n * A flag indicating whether the transport should automatically reconnect\n * when a connection is dropped.\n * Realistically, this should always be true for clients unless you are writing\n * tests or a special case where you don't want to reconnect.\n */\n reconnectOnConnectionDrop = true;\n\n /**\n * Optional handshake options for this client.\n */\n handshakeExtensions?: ClientHandshakeOptions;\n\n constructor(\n clientId: TransportClientId,\n providedOptions?: ProvidedClientTransportOptions,\n ) {\n super(clientId, providedOptions);\n this.options = {\n ...defaultClientTransportOptions,\n ...providedOptions,\n };\n this.retryBudget = new LeakyBucketRateLimit(this.options);\n }\n\n extendHandshake(options: ClientHandshakeOptions) {\n this.handshakeExtensions = options;\n }\n\n /**\n * Abstract method that creates a new {@link Connection} object.\n * This should call {@link handleConnection} when the connection is created.\n * The downstream client implementation needs to implement this.\n *\n * @param to The client ID of the node to connect to.\n * @returns The new connection object.\n */\n protected abstract createNewOutgoingConnection(\n to: TransportClientId,\n ): Promise<ConnType>;\n\n private tryReconnecting(to: string) {\n if (this.reconnectOnConnectionDrop && this.getStatus() === 'open') {\n this.connect(to);\n }\n }\n\n send(to: string, msg: PartialTransportMessage): string {\n if (this.getStatus() === 'closed') {\n const err = 'transport is closed, cant send';\n this.log?.error(err, {\n clientId: this.clientId,\n transportMessage: msg,\n tags: ['invariant-violation'],\n });\n\n throw new Error(err);\n }\n\n let session = this.sessions.get(to);\n if (!session) {\n session = this.createUnconnectedSession(to);\n }\n\n return session.send(msg);\n }\n\n private createUnconnectedSession(to: string): SessionNoConnection {\n const session = SessionStateGraph.entrypoints.NoConnection(\n to,\n this.clientId,\n {\n onSessionGracePeriodElapsed: () => {\n this.onSessionGracePeriodElapsed(session);\n },\n },\n this.options,\n this.log,\n );\n\n this.updateSession(session);\n return session;\n }\n\n // listeners\n protected onConnectingFailed(session: SessionConnecting<ConnType>) {\n const noConnectionSession = super.onConnectingFailed(session);\n this.tryReconnecting(noConnectionSession.to);\n return noConnectionSession;\n }\n\n protected onConnClosed(\n session: SessionHandshaking<ConnType> | SessionConnected<ConnType>,\n ) {\n const noConnectionSession = super.onConnClosed(session);\n this.tryReconnecting(noConnectionSession.to);\n return noConnectionSession;\n }\n\n protected onConnectionEstablished(\n session: SessionConnecting<ConnType>,\n conn: ConnType,\n ): SessionHandshaking<ConnType> {\n // transition to handshaking\n const handshakingSession =\n SessionStateGraph.transition.ConnectingToHandshaking(session, conn, {\n onConnectionErrored: (err) => {\n // just log, when we error we also emit close\n const errStr = coerceErrorString(err);\n this.log?.error(\n `connection to ${handshakingSession.to} errored during handshake: ${errStr}`,\n handshakingSession.loggingMetadata,\n );\n },\n onConnectionClosed: () => {\n this.log?.warn(\n `connection to ${handshakingSession.to} closed during handshake`,\n handshakingSession.loggingMetadata,\n );\n this.onConnClosed(handshakingSession);\n },\n onHandshake: (msg) => {\n this.onHandshakeResponse(handshakingSession, msg);\n },\n onInvalidHandshake: (reason) => {\n this.log?.error(\n `invalid handshake: ${reason}`,\n handshakingSession.loggingMetadata,\n );\n this.deleteSession(session);\n this.protocolError(ProtocolError.HandshakeFailed, reason);\n },\n onHandshakeTimeout: () => {\n this.log?.error(\n `connection to ${handshakingSession.to} timed out during handshake`,\n handshakingSession.loggingMetadata,\n );\n this.onConnClosed(handshakingSession);\n },\n });\n\n this.updateSession(handshakingSession);\n void this.sendHandshake(handshakingSession);\n return handshakingSession;\n }\n\n private rejectHandshakeResponse(\n session: SessionHandshaking<ConnType>,\n reason: string,\n metadata: MessageMetadata,\n ) {\n session.conn.telemetry?.span.setStatus({\n code: SpanStatusCode.ERROR,\n message: reason,\n });\n\n this.log?.warn(reason, metadata);\n this.deleteSession(session);\n }\n\n protected onHandshakeResponse(\n session: SessionHandshaking<ConnType>,\n msg: OpaqueTransportMessage,\n ) {\n // invariant: msg is a handshake response\n if (!Value.Check(ControlMessageHandshakeResponseSchema, msg.payload)) {\n const reason = `received invalid handshake response`;\n this.rejectHandshakeResponse(session, reason, {\n ...session.loggingMetadata,\n transportMessage: msg,\n validationErrors: [\n ...Value.Errors(ControlMessageHandshakeResponseSchema, msg.payload),\n ],\n });\n return;\n }\n\n // invariant: handshake response should be ok\n if (!msg.payload.status.ok) {\n // TODO: remove conditional check after we know code is always present\n const retriable = msg.payload.status.code\n ? Value.Check(\n HandshakeErrorRetriableResponseCodes,\n msg.payload.status.code,\n )\n : false;\n\n const reason = `handshake failed: ${msg.payload.status.reason}`;\n this.rejectHandshakeResponse(session, reason, {\n ...session.loggingMetadata,\n transportMessage: msg,\n });\n\n if (retriable) {\n this.tryReconnecting(session.to);\n } else {\n this.deleteSession(session);\n this.protocolError(ProtocolError.HandshakeFailed, reason);\n }\n\n return;\n }\n\n // invariant: session id should match between client + server\n if (msg.payload.status.sessionId !== session.id) {\n const reason = `session id mismatch: expected ${session.id}, got ${msg.payload.status.sessionId}`;\n this.rejectHandshakeResponse(session, reason, {\n ...session.loggingMetadata,\n transportMessage: msg,\n });\n return;\n }\n\n // transition to connected!\n this.log?.info(`handshake from ${msg.from} ok`, {\n ...session.loggingMetadata,\n transportMessage: msg,\n });\n\n const connectedSession =\n SessionStateGraph.transition.HandshakingToConnected(session, {\n onConnectionErrored: (err) => {\n // just log, when we error we also emit close\n const errStr = coerceErrorString(err);\n this.log?.warn(\n `connection to ${connectedSession.to} errored: ${errStr}`,\n connectedSession.loggingMetadata,\n );\n },\n onConnectionClosed: () => {\n this.log?.info(\n `connection to ${connectedSession.to} closed`,\n connectedSession.loggingMetadata,\n );\n this.onConnClosed(connectedSession);\n },\n onMessage: (msg) => this.handleMsg(msg),\n onInvalidMessage: (reason) => {\n this.deleteSession(connectedSession);\n this.protocolError(ProtocolError.MessageOrderingViolated, reason);\n },\n });\n\n this.updateSession(connectedSession);\n this.retryBudget.startRestoringBudget(connectedSession.to);\n }\n\n /**\n * Manually attempts to connect to a client.\n * @param to The client ID of the node to connect to.\n */\n connect(to: TransportClientId) {\n // create a new session if one does not exist\n let session = this.sessions.get(to);\n session ??= this.createUnconnectedSession(to);\n\n if (session.state !== SessionState.NoConnection) {\n // already trying to connect\n this.log?.debug(\n `session to ${to} has state ${session.state}, skipping connect attempt`,\n session.loggingMetadata,\n );\n return;\n }\n\n if (this.getStatus() !== 'open') {\n this.log?.info(\n `transport state is no longer open, cancelling attempt to connect to ${to}`,\n session.loggingMetadata,\n );\n return;\n }\n\n // check budget\n if (!this.retryBudget.hasBudget(to)) {\n const budgetConsumed = this.retryBudget.getBudgetConsumed(to);\n const errMsg = `tried to connect to ${to} but retry budget exceeded (more than ${budgetConsumed} attempts in the last ${this.retryBudget.totalBudgetRestoreTime}ms)`;\n this.log?.error(errMsg, session.loggingMetadata);\n this.protocolError(ProtocolError.RetriesExceeded, errMsg);\n return;\n }\n\n let sleep = Promise.resolve();\n const backoffMs = this.retryBudget.getBackoffMs(to);\n if (backoffMs > 0) {\n sleep = new Promise((resolve) => setTimeout(resolve, backoffMs));\n }\n\n this.log?.info(\n `attempting connection to ${to} (${backoffMs}ms backoff)`,\n session.loggingMetadata,\n );\n\n this.retryBudget.consumeBudget(to);\n const reconnectPromise = tracer.startActiveSpan('connect', async (span) => {\n try {\n span.addEvent('backoff', { backoffMs });\n await sleep;\n if (this.getStatus() !== 'open') {\n throw new Error('transport state is no longer open');\n }\n\n span.addEvent('connecting');\n return await this.createNewOutgoingConnection(to);\n } catch (err) {\n // rethrow the error so that the promise is rejected\n // as it was before we wrapped it in a span\n const errStr = coerceErrorString(err);\n span.recordException(errStr);\n span.setStatus({ code: SpanStatusCode.ERROR });\n throw err;\n } finally {\n span.end();\n }\n });\n\n const connectingSession =\n SessionStateGraph.transition.NoConnectionToConnecting(\n session,\n reconnectPromise,\n {\n onConnectionEstablished: (conn) => {\n this.log?.debug(\n `connection to ${connectingSession.to} established`,\n connectingSession.loggingMetadata,\n );\n\n // cast here because conn can't be narrowed to ConnType\n // in the callback due to variance rules\n this.onConnectionEstablished(connectingSession, conn as ConnType);\n },\n onConnectionFailed: (error: unknown) => {\n const errStr = coerceErrorString(error);\n this.log?.error(\n `error connecting to ${connectingSession.to}: ${errStr}`,\n connectingSession.loggingMetadata,\n );\n this.onConnectingFailed(connectingSession);\n },\n onConnectionTimeout: () => {\n this.log?.error(\n `connection to ${connectingSession.to} timed out`,\n connectingSession.loggingMetadata,\n );\n this.onConnectingFailed(connectingSession);\n },\n },\n );\n\n this.updateSession(connectingSession);\n }\n\n private async sendHandshake(session: SessionHandshaking<ConnType>) {\n let metadata: unknown = undefined;\n\n if (this.handshakeExtensions) {\n metadata = await this.handshakeExtensions.construct();\n }\n\n const requestMsg = handshakeRequestMessage({\n from: this.clientId,\n to: session.to,\n sessionId: session.id,\n expectedSessionState: {\n nextExpectedSeq: session.ack,\n nextSentSeq: session.nextSeq(),\n },\n metadata,\n tracing: getPropagationContext(session.telemetry.ctx),\n });\n\n this.log?.debug(`sending handshake request to ${session.to}`, {\n ...session.loggingMetadata,\n transportMessage: requestMsg,\n });\n\n session.sendHandshake(requestMsg);\n }\n\n close() {\n this.retryBudget.close();\n super.close();\n }\n}\n","import { TransportClientId } from './message';\n\n/**\n * Options to control the backoff and retry behavior of the client transport's connection behaviour.\n *\n * River implements exponential backoff with jitter to prevent flooding the server\n * when there's an issue with connection establishment.\n *\n * The backoff is calculated via the following:\n * backOff = min(jitter + {@link baseIntervalMs} * 2 ^ budget_consumed, {@link maxBackoffMs})\n *\n * We use a leaky bucket rate limit with a budget of {@link attemptBudgetCapacity} reconnection attempts.\n * Budget only starts to restore after a successful handshake at a rate of one budget per {@link budgetRestoreIntervalMs}.\n */\nexport interface ConnectionRetryOptions {\n /**\n * The base interval to wait before retrying a connection.\n */\n baseIntervalMs: number;\n\n /**\n * The maximum random jitter to add to the total backoff time.\n */\n maxJitterMs: number;\n\n /**\n * The maximum amount of time to wait before retrying a connection.\n * This does not include the jitter.\n */\n maxBackoffMs: number;\n\n /**\n * The max number of times to attempt a connection before a successful handshake.\n * This persists across connections but starts restoring budget after a successful handshake.\n * The restoration interval depends on {@link budgetRestoreIntervalMs}\n */\n attemptBudgetCapacity: number;\n\n /**\n * After a successful connection attempt, how long to wait before we restore a single budget.\n */\n budgetRestoreIntervalMs: number;\n}\n\nexport class LeakyBucketRateLimit {\n private budgetConsumed: Map<TransportClientId, number>;\n private intervalHandles: Map<\n TransportClientId,\n ReturnType<typeof setInterval>\n >;\n private readonly options: ConnectionRetryOptions;\n\n constructor(options: ConnectionRetryOptions) {\n this.options = options;\n this.budgetConsumed = new Map();\n this.intervalHandles = new Map();\n }\n\n getBackoffMs(user: TransportClientId) {\n if (!this.budgetConsumed.has(user)) return 0;\n\n const exponent = Math.max(0, this.getBudgetConsumed(user) - 1);\n const jitter = Math.floor(Math.random() * this.options.maxJitterMs);\n const backoffMs = Math.min(\n this.options.baseIntervalMs * 2 ** exponent,\n this.options.maxBackoffMs,\n );\n\n return backoffMs + jitter;\n }\n\n get totalBudgetRestoreTime() {\n return (\n this.options.budgetRestoreIntervalMs * this.options.attemptBudgetCapacity\n );\n }\n\n consumeBudget(user: TransportClientId) {\n // If we're consuming again, let's ensure that we're not leaking\n this.stopLeak(user);\n this.budgetConsumed.set(user, this.getBudgetConsumed(user) + 1);\n }\n\n getBudgetConsumed(user: TransportClientId) {\n return this.budgetConsumed.get(user) ?? 0;\n }\n\n hasBudget(user: TransportClientId) {\n return this.getBudgetConsumed(user) < this.options.attemptBudgetCapacity;\n }\n\n startRestoringBudget(user: TransportClientId) {\n if (this.intervalHandles.has(user)) {\n return;\n }\n\n const restoreBudgetForUser = () => {\n const currentBudget = this.budgetConsumed.get(user);\n if (!currentBudget) {\n this.stopLeak(user);\n return;\n }\n\n const newBudget = currentBudget - 1;\n if (newBudget === 0) {\n this.budgetConsumed.delete(user);\n return;\n }\n\n this.budgetConsumed.set(user, newBudget);\n };\n\n const intervalHandle = setInterval(\n restoreBudgetForUser,\n this.options.budgetRestoreIntervalMs,\n );\n\n this.intervalHandles.set(user, intervalHandle);\n }\n\n private stopLeak(user: TransportClientId) {\n if (!this.intervalHandles.has(user)) {\n return;\n }\n\n clearInterval(this.intervalHandles.get(user));\n this.intervalHandles.delete(user);\n }\n\n close() {\n for (const user of this.intervalHandles.keys()) {\n this.stopLeak(user);\n }\n }\n}\n"],"mappings":"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","names":["msg"]}
@@ -1,15 +1,11 @@
1
- import { C as Connection, T as Transport, j as ClientTransportOptions, L as LeakyBucketRateLimit, k as ClientHandshakeOptions, b as ProvidedClientTransportOptions, S as Session } from './handshake-a947c234.js';
2
- import { c as TransportClientId } from './index-ea74cdbb.js';
1
+ import { C as Connection, T as Transport, o as ClientTransportOptions, L as LeakyBucketRateLimit, p as ClientHandshakeOptions, b as ProvidedClientTransportOptions, f as SessionConnecting, e as SessionNoConnection, g as SessionHandshaking, h as SessionConnected } from './handshake-0b88e8fc.js';
2
+ import { c as TransportClientId, P as PartialTransportMessage, b as OpaqueTransportMessage } from './message-e6c560fd.js';
3
3
 
4
4
  declare abstract class ClientTransport<ConnType extends Connection> extends Transport<ConnType> {
5
5
  /**
6
6
  * The options for this transport.
7
7
  */
8
8
  protected options: ClientTransportOptions;
9
- /**
10
- * The map of reconnect promises for each client ID.
11
- */
12
- inflightConnectionPromises: Map<TransportClientId, Promise<ConnType>>;
13
9
  retryBudget: LeakyBucketRateLimit;
14
10
  /**
15
11
  * A flag indicating whether the transport should automatically reconnect
@@ -24,8 +20,6 @@ declare abstract class ClientTransport<ConnType extends Connection> extends Tran
24
20
  handshakeExtensions?: ClientHandshakeOptions;
25
21
  constructor(clientId: TransportClientId, providedOptions?: ProvidedClientTransportOptions);
26
22
  extendHandshake(options: ClientHandshakeOptions): void;
27
- protected handleConnection(conn: ConnType, to: TransportClientId): void;
28
- receiveHandshakeResponseMessage(data: Uint8Array, conn: ConnType): Session<ConnType> | false;
29
23
  /**
30
24
  * Abstract method that creates a new {@link Connection} object.
31
25
  * This should call {@link handleConnection} when the connection is created.
@@ -35,17 +29,20 @@ declare abstract class ClientTransport<ConnType extends Connection> extends Tran
35
29
  * @returns The new connection object.
36
30
  */
37
31
  protected abstract createNewOutgoingConnection(to: TransportClientId): Promise<ConnType>;
32
+ private tryReconnecting;
33
+ send(to: string, msg: PartialTransportMessage): string;
34
+ private createUnconnectedSession;
35
+ protected onConnectingFailed(session: SessionConnecting<ConnType>): SessionNoConnection;
36
+ protected onConnClosed(session: SessionHandshaking<ConnType> | SessionConnected<ConnType>): SessionNoConnection;
37
+ protected onConnectionEstablished(session: SessionConnecting<ConnType>, conn: ConnType): SessionHandshaking<ConnType>;
38
+ private rejectHandshakeResponse;
39
+ protected onHandshakeResponse(session: SessionHandshaking<ConnType>, msg: OpaqueTransportMessage): void;
38
40
  /**
39
41
  * Manually attempts to connect to a client.
40
42
  * @param to The client ID of the node to connect to.
41
43
  */
42
- connect(to: TransportClientId): Promise<void>;
43
- protected deleteSession({ session, closeHandshakingConnection, handshakingConn, }: {
44
- session: Session<ConnType>;
45
- closeHandshakingConnection: boolean;
46
- handshakingConn?: ConnType;
47
- }): void;
48
- protected sendHandshake(to: TransportClientId, conn: ConnType): Promise<boolean>;
44
+ connect(to: TransportClientId): void;
45
+ private sendHandshake;
49
46
  close(): void;
50
47
  }
51
48
 
@@ -0,0 +1,11 @@
1
+ import { C as Connection } from './handshake-0b88e8fc.js';
2
+ import { W as WsLike } from './wslike-e0b32dd5.js';
3
+
4
+ declare class WebSocketConnection extends Connection {
5
+ ws: WsLike;
6
+ constructor(ws: WsLike);
7
+ send(payload: Uint8Array): boolean;
8
+ close(): void;
9
+ }
10
+
11
+ export { WebSocketConnection as W };
@@ -1,6 +1,6 @@
1
- import { C as Connection } from './handshake-a947c234.js';
2
1
  import { Socket } from 'node:net';
3
2
  import stream, { Transform, TransformCallback, TransformOptions } from 'node:stream';
3
+ import { C as Connection } from './handshake-0b88e8fc.js';
4
4
 
5
5
  interface LengthEncodedOptions extends TransformOptions {
6
6
  /** Maximum in-memory buffer size before we throw */
@@ -24,10 +24,6 @@ declare class UdsConnection extends Connection {
24
24
  input: stream.Readable;
25
25
  framer: Uint32LengthPrefixFraming;
26
26
  constructor(sock: Socket);
27
- addDataListener(cb: (msg: Uint8Array) => void): void;
28
- removeDataListener(cb: (msg: Uint8Array) => void): void;
29
- addCloseListener(cb: () => void): void;
30
- addErrorListener(cb: (err: Error) => void): void;
31
27
  send(payload: Uint8Array): boolean;
32
28
  close(): void;
33
29
  }