better-ship 0.39.1 → 0.41.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 (135) hide show
  1. package/dist/{application-Dsz-o9Aj.js → application-CnsIQX8h.js} +152 -41
  2. package/dist/application-CnsIQX8h.js.map +1 -0
  3. package/dist/application.d.ts +3 -3
  4. package/dist/application.js +2 -2
  5. package/dist/{auth-secondary-storage-CcNkkEk0.d.ts → auth-secondary-storage-DlzjamBm.d.ts} +2 -2
  6. package/dist/{auth-secondary-storage-CcNkkEk0.d.ts.map → auth-secondary-storage-DlzjamBm.d.ts.map} +1 -1
  7. package/dist/better-auth/apple-client-secret.d.ts +1 -1
  8. package/dist/better-auth/apple-client-secret.js +1 -1
  9. package/dist/better-auth/auth-client.js +1 -1
  10. package/dist/better-auth/rate-limit.d.ts +1 -1
  11. package/dist/better-auth/rate-limit.js +1 -1
  12. package/dist/better-auth/secondary-storage.d.ts +1 -1
  13. package/dist/better-auth.js +1 -1
  14. package/dist/billing/client.d.ts +1 -1
  15. package/dist/billing/client.js +1 -1
  16. package/dist/browser-support/floor.d.ts +1 -1
  17. package/dist/browser-support/floor.js +1 -1
  18. package/dist/browser-support/oxlint.js +1 -1
  19. package/dist/client-BZgpmuSp.js +27 -0
  20. package/dist/client-BZgpmuSp.js.map +1 -0
  21. package/dist/cloudflare/auth-secondary-storage.d.ts +1 -1
  22. package/dist/cloudflare/auth-secondary-storage.js +1 -1
  23. package/dist/cloudflare/durable-object-client.js +2 -2
  24. package/dist/cloudflare/durable-object-errors.d.ts +1 -1
  25. package/dist/cloudflare/durable-object-errors.js +1 -1
  26. package/dist/cloudflare/kv-client.js +2 -2
  27. package/dist/cloudflare/kv-errors.d.ts +1 -1
  28. package/dist/cloudflare/kv-errors.js +1 -1
  29. package/dist/cloudflare/queue.d.ts +57 -68
  30. package/dist/cloudflare/queue.d.ts.map +1 -1
  31. package/dist/cloudflare/queue.js +37 -65
  32. package/dist/cloudflare/queue.js.map +1 -1
  33. package/dist/cloudflare/r2-client.js +2 -2
  34. package/dist/cloudflare/r2-errors.d.ts +1 -1
  35. package/dist/cloudflare/r2-errors.js +1 -1
  36. package/dist/cloudflare/rate-limiter.d.ts +1 -1
  37. package/dist/cloudflare/rate-limiter.js +1 -1
  38. package/dist/cloudflare/scheduled.d.ts +1 -1
  39. package/dist/cloudflare/scheduled.js +1 -1
  40. package/dist/cloudflare/turnstile.d.ts +1 -1
  41. package/dist/cloudflare/turnstile.js +1 -1
  42. package/dist/cloudflare.d.ts +9 -9
  43. package/dist/cloudflare.d.ts.map +1 -1
  44. package/dist/cloudflare.js +24 -29
  45. package/dist/cloudflare.js.map +1 -1
  46. package/dist/{core-DOBZeYSX.js → core-CV8SQv01.js} +65 -4
  47. package/dist/core-CV8SQv01.js.map +1 -0
  48. package/dist/core.d.ts +2 -2
  49. package/dist/core.js +2 -2
  50. package/dist/{durable-object-errors-CcfTu0PQ.js → durable-object-errors-C7e7essH.js} +2 -2
  51. package/dist/{durable-object-errors-CcfTu0PQ.js.map → durable-object-errors-C7e7essH.js.map} +1 -1
  52. package/dist/{floor-BTBtPI9_.js → floor-BdRTO_LO.js} +2 -2
  53. package/dist/{floor-BTBtPI9_.js.map → floor-BdRTO_LO.js.map} +1 -1
  54. package/dist/http.d.ts +2 -2
  55. package/dist/http.js +2 -2
  56. package/dist/{index-BMY7ylgk.d.ts → index-DaiY8xJJ.d.ts} +140 -73
  57. package/dist/index-DaiY8xJJ.d.ts.map +1 -0
  58. package/dist/{index-CtIdbnEZ.d.ts → index-tJzJUgTh.d.ts} +30 -4
  59. package/dist/index-tJzJUgTh.d.ts.map +1 -0
  60. package/dist/{kv-errors-B2k_2lyY.js → kv-errors-DXbnO7cB.js} +2 -2
  61. package/dist/{kv-errors-B2k_2lyY.js.map → kv-errors-DXbnO7cB.js.map} +1 -1
  62. package/dist/{metrics-CdTF_lWR.d.ts → metrics-DzSCDk-u.d.ts} +2 -2
  63. package/dist/{metrics-CdTF_lWR.d.ts.map → metrics-DzSCDk-u.d.ts.map} +1 -1
  64. package/dist/{outbox-repository-options-q-CGUoCr.d.ts → outbox-repository-options-BPsuMSwA.d.ts} +5 -7
  65. package/dist/{outbox-repository-options-q-CGUoCr.d.ts.map → outbox-repository-options-BPsuMSwA.d.ts.map} +1 -1
  66. package/dist/{outbox-repository-options-Ca67c3c9.js → outbox-repository-options-DTsXMiR1.js} +4 -8
  67. package/dist/{outbox-repository-options-Ca67c3c9.js.map → outbox-repository-options-DTsXMiR1.js.map} +1 -1
  68. package/dist/{payment-service.error-BR10zqxk.js → payment-service.error-oW2bKAfU.js} +2 -2
  69. package/dist/{payment-service.error-BR10zqxk.js.map → payment-service.error-oW2bKAfU.js.map} +1 -1
  70. package/dist/postgres.d.ts +9 -9
  71. package/dist/postgres.d.ts.map +1 -1
  72. package/dist/postgres.js +23 -27
  73. package/dist/postgres.js.map +1 -1
  74. package/dist/posthog/metrics.d.ts +1 -1
  75. package/dist/posthog/server.d.ts +3 -3
  76. package/dist/posthog/server.js +1 -1
  77. package/dist/{r2-errors-BF49eqU_.js → r2-errors-DzpOvciV.js} +2 -2
  78. package/dist/{r2-errors-BF49eqU_.js.map → r2-errors-DzpOvciV.js.map} +1 -1
  79. package/dist/{request-BYQodKDU.js → request-C5k8ME_7.js} +2 -2
  80. package/dist/{request-BYQodKDU.js.map → request-C5k8ME_7.js.map} +1 -1
  81. package/dist/resend.d.ts +3 -3
  82. package/dist/resend.js +2 -2
  83. package/dist/sentry/client.d.ts +1 -1
  84. package/dist/sentry/client.js +1 -1
  85. package/dist/sentry/server.d.ts +2 -2
  86. package/dist/sentry/tanstack.d.ts +1 -1
  87. package/dist/stripe/client.d.ts +7 -2
  88. package/dist/stripe/client.d.ts.map +1 -1
  89. package/dist/stripe/client.js +1 -1
  90. package/dist/stripe/payment-service.error.d.ts +1 -1
  91. package/dist/stripe/payment-service.error.js +1 -1
  92. package/dist/stripe/payment-service.js +1 -1
  93. package/dist/stripe/payment-webhook.d.ts +1 -1
  94. package/dist/stripe/payment-webhook.js +1 -1
  95. package/dist/stripe/request.js +1 -1
  96. package/dist/{stripe-fixture-yFUknTJO.js → stripe-fixture-11EmnD6F.js} +2 -2
  97. package/dist/{stripe-fixture-yFUknTJO.js.map → stripe-fixture-11EmnD6F.js.map} +1 -1
  98. package/dist/tanstack.d.ts +1 -1
  99. package/dist/tanstack.js +1 -1
  100. package/dist/testing/outbox-repository.d.ts +2 -2
  101. package/dist/testing/outbox-repository.js +35 -50
  102. package/dist/testing/outbox-repository.js.map +1 -1
  103. package/dist/testing/payment-service.js +2 -2
  104. package/dist/testing/stripe.js +1 -1
  105. package/dist/{webhook-verification-C4R6OO7f.js → webhook-verification-B8v3-LQ2.js} +2 -2
  106. package/dist/{webhook-verification-C4R6OO7f.js.map → webhook-verification-B8v3-LQ2.js.map} +1 -1
  107. package/dist/{webhook-verification-DL4L3zbu.d.ts → webhook-verification-Cy4Z5djk.d.ts} +2 -2
  108. package/dist/{webhook-verification-DL4L3zbu.d.ts.map → webhook-verification-Cy4Z5djk.d.ts.map} +1 -1
  109. package/package.json +1 -1
  110. package/src/application/index.ts +10 -8
  111. package/src/application/outbox-publisher.ts +15 -0
  112. package/src/application/outbox-relay.ts +139 -68
  113. package/src/application/outbox-repository.ts +18 -18
  114. package/src/application/outbox-wake.ts +8 -0
  115. package/src/application/queue-or-rpc-publisher.ts +64 -0
  116. package/src/application/unit-of-work.ts +2 -2
  117. package/src/core/classify-failure.ts +12 -2
  118. package/src/core/index.ts +6 -0
  119. package/src/core/redelivery-policy.ts +66 -0
  120. package/src/infrastructure/cloudflare/d1-outbox-repository.ts +36 -52
  121. package/src/infrastructure/cloudflare/queue/index.ts +0 -1
  122. package/src/infrastructure/cloudflare/queue/queue-client.ts +41 -23
  123. package/src/infrastructure/cloudflare/queue/queue-consumer.ts +11 -4
  124. package/src/infrastructure/cloudflare/queue/wait-until-wake.ts +2 -2
  125. package/src/infrastructure/outbox-repository-options.ts +2 -4
  126. package/src/infrastructure/postgres/postgres-outbox-repository.ts +31 -41
  127. package/src/infrastructure/stripe/client.ts +7 -3
  128. package/src/infrastructure/testing/outbox-repository-contract.ts +36 -37
  129. package/dist/application-Dsz-o9Aj.js.map +0 -1
  130. package/dist/client-Dv1Ch7yY.js +0 -20
  131. package/dist/client-Dv1Ch7yY.js.map +0 -1
  132. package/dist/core-DOBZeYSX.js.map +0 -1
  133. package/dist/index-BMY7ylgk.d.ts.map +0 -1
  134. package/dist/index-CtIdbnEZ.d.ts.map +0 -1
  135. package/src/infrastructure/cloudflare/queue/redelivery-policy.ts +0 -64
@@ -1,4 +1,4 @@
1
- import { D as unreachable, O as DatabaseError, d as classifyFailure, r as createLogger, tt as AppError } from "./core-DOBZeYSX.js";
1
+ import { A as DatabaseError, c as decideRedelivery, k as unreachable, r as createLogger, rt as AppError } from "./core-CV8SQv01.js";
2
2
  import { panic } from "better-result";
3
3
 
4
4
  //#region src/application/analytics-service.ts
@@ -140,75 +140,186 @@ var MessageBus = class {
140
140
  //#region src/application/outbox-relay.ts
141
141
  const logger = createLogger("outbox-relay");
142
142
  /**
143
- * Publishes committed events with bounded durable retries. Ported from Typist's relay with per-row exhaustion.
144
- * Send failures are recorded; repository failures propagate to the wake or scheduled boundary.
143
+ * Moves committed events out of the outbox: claims due rows, sends their events through the publisher,
144
+ * and records each result on its row. A repository failure propagates to the caller.
145
145
  */
146
146
  var OutboxRelay = class {
147
147
  publisher;
148
- repository;
148
+ outboxRepo;
149
+ now;
149
150
  options;
150
- constructor(publisher, repository, options = {}) {
151
+ constructor(publisher, outboxRepo, options = {}, now = () => /* @__PURE__ */ new Date()) {
151
152
  this.publisher = publisher;
152
- this.repository = repository;
153
+ this.outboxRepo = outboxRepo;
154
+ this.now = now;
153
155
  this.options = {
154
156
  batchSize: options.batchSize ?? 50,
155
157
  maxBatches: options.maxBatches ?? 10,
156
- maxAttempts: options.maxAttempts ?? 10
158
+ maxAttempts: options.maxAttempts ?? 10,
159
+ retryBaseDelayMs: options.retryBaseDelayMs ?? 1e3,
160
+ retryMaxDelayMs: options.retryMaxDelayMs ?? 6e4
157
161
  };
158
162
  }
159
- /** Return the claimed count, including released and dead-lettered rows. Zero means no due rows. */
163
+ /**
164
+ * Runs one batch: claims due rows, marks rows with no attempt left failed, and publishes the rest.
165
+ * Called by `drain()`. Returns the claimed count; zero means no row was due.
166
+ */
160
167
  async flush() {
161
- const claim = await this.repository.claimPending(this.options.batchSize);
162
- const exhausted = claim.messages.filter((row) => row.attempts > this.options.maxAttempts);
163
- await this.deadLetter(claim, exhausted, "exhausted", "Claim attempt limit exceeded");
164
- const pending = claim.messages.filter((row) => row.attempts <= this.options.maxAttempts);
165
- if (pending.length === 0) return claim.messages.length;
166
- let oversized;
168
+ const batch = await this.outboxRepo.claimDueRows(this.options.batchSize);
169
+ const { exhaustedRows, dueRows } = this.splitByAttemptsLeft(batch.rows);
170
+ await this.markFailed(batch.token, exhaustedRows, "exhausted", "Claim attempt limit exceeded");
171
+ if (dueRows.length > 0) await this.publishDueRows(batch.token, dueRows);
172
+ return batch.rows.length;
173
+ }
174
+ /** Sends the rows' events, marks the delivered rows published, and fails or retries the rest by their error. */
175
+ async publishDueRows(claimToken, dueRows) {
176
+ const rejectedEvents = await this.publishEvents(dueRows);
177
+ const rejectedEventIds = new Set(rejectedEvents.map(({ message: event }) => event.id));
178
+ const deliveredRows = dueRows.filter((row) => !rejectedEventIds.has(row.payload.id));
179
+ if (deliveredRows.length > 0) await this.outboxRepo.markPublished(claimToken, deliveredRows);
180
+ for (const [error, rows] of rowsByError(rejectedEvents, dueRows)) await this.failOrRetry(claimToken, rows, error);
181
+ }
182
+ /** Publishes the rows' events. A thrown publish counts as every event rejected with that error. */
183
+ async publishEvents(rows) {
184
+ const events = rows.map((row) => row.payload);
167
185
  try {
168
- oversized = await this.publisher.sendBatchPartial(pending.map((row) => row.payload));
186
+ return await this.publisher.publish(events);
169
187
  } catch (error) {
170
- await this.handleSendFailure(claim, pending, error);
171
- return claim.messages.length;
188
+ return events.map((event) => ({
189
+ message: event,
190
+ error
191
+ }));
172
192
  }
173
- const oversizedIds = new Set(oversized.map((event) => event.id));
174
- await this.deadLetter(claim, pending.filter((row) => oversizedIds.has(row.payload.id)), "oversized", "Exceeds queue message size limit");
175
- const sent = pending.filter((row) => !oversizedIds.has(row.payload.id));
176
- if (sent.length > 0) await this.repository.markPublished(claim, sent);
177
- return claim.messages.length;
178
193
  }
179
- /** Drain until an empty claim or the batch limit; return the total claimed count. */
194
+ /**
195
+ * Runs batches until no row is due: at most `maxBatches` × `batchSize` rows, 500 by default. Called
196
+ * after a commit through `waitUntilWake`, and by the app's cron sweep. Returns the total claimed count.
197
+ */
180
198
  async drain() {
181
199
  let total = 0;
182
- for (let batch = 0; batch < this.options.maxBatches; batch += 1) {
200
+ for (let batchCount = 0; batchCount < this.options.maxBatches; batchCount += 1) {
183
201
  const claimed = await this.flush();
184
202
  total += claimed;
185
203
  if (claimed === 0) break;
186
204
  }
187
205
  return total;
188
206
  }
189
- async handleSendFailure(claim, pending, cause) {
190
- const classification = classifyFailure(cause);
191
- const message = cause instanceof Error ? cause.message : "Publisher rejected with a non-error value";
192
- if (classification === "terminal") {
193
- await this.deadLetter(claim, pending, "terminal", message, cause);
207
+ /**
208
+ * Decides fail or retry for rows whose events were not delivered: the whole send failed, or one event
209
+ * was rejected. Marks them failed on a terminal error or a last attempt; releases the rest for retry.
210
+ */
211
+ async failOrRetry(claimToken, rows, cause) {
212
+ const errorMessage = cause instanceof Error ? cause.message : "Publisher rejected with a non-error value";
213
+ if (decideRedelivery(cause, 1, this.delays).action === "ack") {
214
+ await this.markFailed(claimToken, rows, "terminal", errorMessage, cause);
194
215
  return;
195
216
  }
196
- const exhausted = pending.filter((row) => row.attempts >= this.options.maxAttempts);
197
- await this.deadLetter(claim, exhausted, "exhausted", message, cause);
198
- const retry = pending.filter((row) => row.attempts < this.options.maxAttempts);
199
- if (retry.length > 0) await this.repository.releaseClaim(claim, retry);
217
+ const { exhaustedRows, retryRows } = this.splitByLastAttempt(rows);
218
+ await this.markFailed(claimToken, exhaustedRows, "exhausted", errorMessage, cause);
219
+ await this.releaseForRetry(claimToken, retryRows, cause);
200
220
  }
201
- async deadLetter(claim, messages, reason, errorMessage, cause) {
202
- if (messages.length === 0) return;
203
- await this.repository.deadLetter(claim, messages, reason, errorMessage);
204
- logger.error("outbox_messages_dead_lettered", {
221
+ /** Releases rows for another attempt. Each row waits longer the more attempts it has used. */
222
+ async releaseForRetry(claimToken, rows, cause) {
223
+ const now = this.now().getTime();
224
+ for (const attempts of new Set(rows.map((row) => row.attempts))) {
225
+ const decision = decideRedelivery(cause, attempts, this.delays);
226
+ const delayMs = decision.action === "retry" ? decision.delayMs : 0;
227
+ const rowsWithSameAttempts = rows.filter((row) => row.attempts === attempts);
228
+ await this.outboxRepo.releaseClaim(claimToken, rowsWithSameAttempts, new Date(now + delayMs));
229
+ }
230
+ }
231
+ get delays() {
232
+ return {
233
+ baseDelayMs: this.options.retryBaseDelayMs,
234
+ maxDelayMs: this.options.retryMaxDelayMs
235
+ };
236
+ }
237
+ /** Splits claimed rows: rows whose last run crashed with no attempt left, and rows that may run now. */
238
+ splitByAttemptsLeft(rows) {
239
+ return {
240
+ exhaustedRows: rows.filter((row) => this.hasNoAttemptLeft(row)),
241
+ dueRows: rows.filter((row) => !this.hasNoAttemptLeft(row))
242
+ };
243
+ }
244
+ /** Splits failed rows: rows that just used their last attempt, and rows that may retry. */
245
+ splitByLastAttempt(rows) {
246
+ return {
247
+ exhaustedRows: rows.filter((row) => this.isLastAttempt(row)),
248
+ retryRows: rows.filter((row) => !this.isLastAttempt(row))
249
+ };
250
+ }
251
+ /** True when the row used every attempt before this claim: its last run crashed, so it must not run again. */
252
+ hasNoAttemptLeft(row) {
253
+ return row.attempts > this.options.maxAttempts;
254
+ }
255
+ /** True when the run that just failed was the row's last allowed attempt, so it must not be retried. */
256
+ isLastAttempt(row) {
257
+ return row.attempts >= this.options.maxAttempts;
258
+ }
259
+ /** Calls `outboxRepo.markFailed`, then logs one error. Does nothing for an empty list. */
260
+ async markFailed(claimToken, rows, reason, errorMessage, cause) {
261
+ if (rows.length === 0) return;
262
+ await this.outboxRepo.markFailed(claimToken, rows, reason, errorMessage);
263
+ logger.error("outbox_rows_failed", {
205
264
  error: cause,
206
- claimToken: claim.token,
207
- count: messages.length,
265
+ claimToken,
266
+ count: rows.length,
208
267
  reason
209
268
  });
210
269
  }
211
270
  };
271
+ /** Groups the rejected events' rows by error object, so one error decides fail or retry for all its rows at once. */
272
+ function rowsByError(rejectedEvents, rows) {
273
+ const rowByEventId = new Map(rows.map((row) => [row.payload.id, row]));
274
+ const groups = /* @__PURE__ */ new Map();
275
+ for (const { message: event, error } of rejectedEvents) {
276
+ const row = rowByEventId.get(event.id);
277
+ if (row === void 0) continue;
278
+ const group = groups.get(error) ?? [];
279
+ group.push(row);
280
+ groups.set(error, group);
281
+ }
282
+ return groups;
283
+ }
284
+
285
+ //#endregion
286
+ //#region src/application/queue-or-rpc-publisher.ts
287
+ const DEFAULT_CALLS_PER_REQUEST = 25;
288
+ /**
289
+ * Publishes each event over RPC or to the queue. Events that the rule picks are consumed over RPC,
290
+ * in parallel, until the request's call budget is used; every other event goes to the queue.
291
+ * Build one per request, so the budget counts that request's calls. A failed call or queue send
292
+ * rejects only its own events.
293
+ */
294
+ var QueueOrRpcPublisher = class {
295
+ options;
296
+ callsLeft;
297
+ constructor(options) {
298
+ this.options = options;
299
+ this.callsLeft = options.callsPerRequest ?? DEFAULT_CALLS_PER_REQUEST;
300
+ }
301
+ async publish(events) {
302
+ const rpcEvents = [];
303
+ const queuedEvents = [];
304
+ for (const event of events) if (this.options.usesRpc(event) && this.callsLeft > 0) {
305
+ rpcEvents.push(event);
306
+ this.callsLeft -= 1;
307
+ } else queuedEvents.push(event);
308
+ const [queueResult, ...callResults] = await Promise.allSettled([queuedEvents.length > 0 ? this.options.queue.publish(queuedEvents) : Promise.resolve([]), ...rpcEvents.map((event) => this.options.consumer.consume(event))]);
309
+ const queueRejected = queueResult?.status === "fulfilled" ? queueResult.value : queuedEvents.map((event) => ({
310
+ message: event,
311
+ error: queueResult?.reason
312
+ }));
313
+ const callRejected = rpcEvents.flatMap((event, index) => {
314
+ const result = callResults[index];
315
+ return result?.status === "rejected" ? [{
316
+ message: event,
317
+ error: result.reason
318
+ }] : [];
319
+ });
320
+ return [...queueRejected, ...callRejected];
321
+ }
322
+ };
212
323
 
213
324
  //#endregion
214
325
  //#region src/application/outbox-retention.ts
@@ -288,5 +399,5 @@ var UnitOfWorkAlreadyActiveError = class extends AppError {
288
399
  };
289
400
 
290
401
  //#endregion
291
- export { MessageBus as a, RecordingEmailService as c, OutboxRelay as i, NULL_METRICS_SERVICE as l, UnitOfWork as n, MessageAlreadyProcessedError as o, OutboxRetention as r, recordEmailEvent as s, UnitOfWorkAlreadyActiveError as t, NULL_ANALYTICS as u };
292
- //# sourceMappingURL=application-Dsz-o9Aj.js.map
402
+ export { OutboxRelay as a, recordEmailEvent as c, NULL_ANALYTICS as d, QueueOrRpcPublisher as i, RecordingEmailService as l, UnitOfWork as n, MessageBus as o, OutboxRetention as r, MessageAlreadyProcessedError as s, UnitOfWorkAlreadyActiveError as t, NULL_METRICS_SERVICE as u };
403
+ //# sourceMappingURL=application-CnsIQX8h.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"application-CnsIQX8h.js","names":["logger"],"sources":["../src/application/analytics-service.ts","../src/application/metrics-service.ts","../src/application/email-service.ts","../src/application/record-email-event.ts","../src/application/message-already-processed.error.ts","../src/application/message-bus.ts","../src/application/outbox-relay.ts","../src/application/queue-or-rpc-publisher.ts","../src/application/outbox-retention.ts","../src/application/unit-of-work.ts","../src/application/unit-of-work.errors.ts"],"sourcesContent":["import type { AnalyticsEventInput, AnalyticsProperties, AnalyticsTarget } from '@/core'\n\n/** The properties of one event name; an untyped service accepts any properties. */\nexport type AnalyticsPropertiesOf<\n TEvent extends AnalyticsEventInput,\n TName extends TEvent['name'],\n> = string extends TEvent['name']\n ? TEvent['properties']\n : Extract<TEvent, { readonly name: TName }>['properties']\n\n/** Product analytics without an SDK dependency, ported from Typist and Porte. */\nexport interface AnalyticsService<TEvent extends AnalyticsEventInput = AnalyticsEventInput> {\n /** Attach traits to one person. */\n identify(distinctId: string, properties?: AnalyticsProperties): void\n /** Merge a previous ID into this person; the application must establish that both identify the same person. */\n alias(distinctId: string, previousDistinctId: string): void\n /** Schedule an event for a person; returning does not confirm remote acceptance. */\n track<TName extends TEvent['name']>(\n name: TName,\n properties: AnalyticsPropertiesOf<TEvent, TName>,\n target: AnalyticsTarget,\n ): void\n /** Schedule an event without creating a person profile for its distinct ID. */\n trackAnonymous<TName extends TEvent['name']>(\n name: TName,\n properties: AnalyticsPropertiesOf<TEvent, TName>,\n target: AnalyticsTarget,\n ): void\n}\n\n/**\n * Reports to nobody. The composition root selects this service when analytics is disabled.\n * `satisfies` keeps its own type, so it serves an `AnalyticsService` of any event map.\n */\nexport const NULL_ANALYTICS = {\n identify: () => {},\n alias: () => {},\n track: (\n _name: string,\n _properties: AnalyticsEventInput['properties'],\n _target: AnalyticsTarget,\n ) => {},\n trackAnonymous: (\n _name: string,\n _properties: AnalyticsEventInput['properties'],\n _target: AnalyticsTarget,\n ) => {},\n} satisfies AnalyticsService\n","/** A metric dimension; use a small, bounded value set and never user or request IDs. */\nexport type MetricAttributeValue = string | number | boolean\n\n/** Dimensions shared by observations in one time series. */\nexport type MetricAttributes = Readonly<Record<string, MetricAttributeValue>>\n\n/** Unit and dimensions for an operational measurement. */\nexport interface MetricOptions {\n readonly attributes?: MetricAttributes\n readonly unit?: string\n}\n\n/** Operational measurements, ported from Typist's metrics-service.ts; applications own metric names. */\nexport interface MetricsService<TName extends string = string> {\n /** Add a nonnegative value to a total; the default increment is one. */\n count(name: TName, value?: number, options?: MetricOptions): void\n /** Record a current value. */\n gauge(name: TName, value: number, options?: MetricOptions): void\n /** Record one observation in a distribution. */\n histogram(name: TName, value: number, options?: MetricOptions): void\n}\n\n/** Records nothing when the composition root disables metrics. */\nexport const NULL_METRICS_SERVICE: MetricsService = {\n count: () => {},\n gauge: () => {},\n histogram: () => {},\n}\n","import type { EmailIdempotencyKey } from '@/core'\n\n/** A media type such as `application/pdf`. */\nexport type MimeType = `${string}/${string}`\n\n/** A file to attach. Binary content is bytes; the adapter encodes it for the provider. */\nexport type EmailAttachment = {\n readonly filename: string\n readonly content: string | Uint8Array\n /** Optional MIME metadata; Resend accepts filename and content without it. */\n readonly contentType?: MimeType\n}\n\n/**\n * One transactional email. Resend accepts 50 recipients, 75 tags with ASCII names and values,\n * and 40 MB of attachments after base64. Sources: https://resend.com/docs/api-reference/emails/send-email\n * and https://resend.com/docs/dashboard/emails/tags\n */\nexport type OutboundEmail = {\n /** Override the default for this email, for example \"Display Name <address@domain.com>\". */\n readonly from?: string\n readonly to: string | readonly string[]\n readonly subject: string\n readonly html: string\n /** Optional stable identity of this send. Resend deduplicates supplied keys for 24 hours. */\n readonly idempotencyKey?: EmailIdempotencyKey\n /** Resend generates plain text from html when omitted. An empty string disables that generation. */\n readonly text?: string\n readonly replyTo?: string\n /** Labels the provider stores with the email and returns on every delivery event. */\n readonly tags?: Readonly<Record<string, string>>\n readonly attachments?: readonly EmailAttachment[]\n}\n\n/** Received email headers, without the body or attachments. */\nexport type ReceivedEmail = { readonly headers: Readonly<Record<string, string>> }\n\n/** One attachment of a received email. `downloadUrl` is a signed link that stops working at `expiresAt`. */\nexport type ReceivedAttachment = {\n readonly filename: string | null\n readonly contentType: string\n readonly size: number\n readonly downloadUrl: string\n readonly expiresAt: string\n}\n\n/** A received email's sender, plain text body, and attachments, for an application that reads mail it receives. */\nexport type ReceivedContent = {\n /** The sender as the email states it, for example \"Display Name <address@domain.com>\". */\n readonly from: string\n readonly text: string | null\n readonly attachments: readonly ReceivedAttachment[]\n}\n\n/** The provider accepted the email and assigned its id. */\nexport type EmailAccepted = { readonly providerId: string }\n\n/**\n * The adapter supplies the default sender and maps provider errors. Each email can override the sender.\n * A provider rejection throws `EmailServiceError`; unexpected SDK rejections propagate unchanged.\n */\nexport interface IEmailService {\n /** Resolve after provider acceptance; this does not confirm delivery to the recipient. */\n sendEmail(email: OutboundEmail): Promise<EmailAccepted>\n}\n\n/** Records every send for a test. Provider ids count up as `recorded-1`, `recorded-2`. */\nexport class RecordingEmailService implements IEmailService {\n /** Sends in call order, including repeated idempotency keys. */\n readonly sent: OutboundEmail[] = []\n\n /** Record the send before returning its provider id. */\n async sendEmail(email: OutboundEmail): Promise<EmailAccepted> {\n this.sent.push(email)\n return { providerId: `recorded-${this.sent.length}` }\n }\n}\n","import type { BounceType, DomainCommand, EmailAddress, RecordEmailEventPayload } from '@/core'\n\nimport type { IUnitOfWork } from './unit-of-work.ts'\n\n/** What a bounce records for one address. */\nexport type EmailBounceRecord = {\n readonly type: BounceType\n readonly subType: string | null\n}\n\n/**\n * The application's deliverability state per address. An implementation keeps the higher bounce\n * severity with `shouldUpdateBounce`, and treats an unknown address as nothing to record.\n */\nexport interface IEmailDeliverabilityStore {\n /** Keep the higher severity atomically. Equal severity permits replacement; the store owns timestamp ordering. */\n recordBounce(address: EmailAddress, bounce: EmailBounceRecord): Promise<void>\n /** Record a complaint without clearing existing suppression state. */\n recordComplaint(address: EmailAddress): Promise<void>\n}\n\n/** The repositories the handler needs from the unit of work. */\nexport type RecordEmailEventRepos = { readonly emailDeliverability: IEmailDeliverabilityStore }\n\n/** The container slice the handler reads. */\nexport type RecordEmailEventDeps = { readonly uow: IUnitOfWork<RecordEmailEventRepos> }\n\n/** The command, under whatever name the application registered the payload. */\nexport type RecordEmailEventCommand = DomainCommand & RecordEmailEventPayload\n\n/**\n * Record a bounce or a complaint for every recipient inside the command's unit of work.\n * The command id is the provider's event id, so a redelivered webhook is `MessageAlreadyProcessedError`.\n */\nexport async function recordEmailEvent(\n command: RecordEmailEventCommand,\n deps: RecordEmailEventDeps,\n): Promise<void> {\n await deps.uow.run(command.id, async ({ emailDeliverability }) => {\n for (const address of command.recipients) {\n if (command.event.type === 'bounced') {\n // oxlint-disable-next-line no-await-in-loop -- Finish each transaction write before starting another; a failure must leave no pending writes.\n await emailDeliverability.recordBounce(address, {\n type: command.event.bounceType,\n subType: command.event.bounceSubType,\n })\n } else {\n // oxlint-disable-next-line no-await-in-loop -- A rejected write must stop the transaction before another write starts.\n await emailDeliverability.recordComplaint(address)\n }\n }\n })\n}\n","import { AppError, DatabaseError, type MessageId } from '@/core'\n\n/** The message's effects already committed. A caller can skip duplicate delivery without repeating those effects. */\nexport class MessageAlreadyProcessedError extends AppError {\n readonly _tag = 'MessageAlreadyProcessedError'\n readonly classification = 'terminal'\n\n constructor(\n readonly messageId: MessageId,\n options?: { readonly cause: unknown },\n ) {\n super(`message ${messageId} already processed`, options)\n }\n\n /** Recognize only the processed-message primary key; preserve other failures unchanged at the call site. */\n static from(cause: unknown, messageId: MessageId): MessageAlreadyProcessedError | undefined {\n if (cause instanceof MessageAlreadyProcessedError) return cause\n if (!(cause instanceof DatabaseError)) return undefined\n const details = cause.details\n const duplicate =\n details.database === 'd1'\n ? details.kind === 'unique' &&\n details.table === 'processed_messages' &&\n details.column === 'message_id'\n : details.code === '23505' &&\n details.table_name === 'processed_messages' &&\n details.constraint_name === 'processed_messages_pkey'\n if (!duplicate) return undefined\n return new MessageAlreadyProcessedError(messageId, { cause })\n }\n}\n","import { panic } from 'better-result'\n\nimport {\n createLogger,\n unreachable,\n type DomainCommand,\n type DomainEvent,\n type DomainMessage,\n type DomainQuery,\n} from '@/core'\n\nimport { MessageAlreadyProcessedError } from './message-already-processed.error.ts'\nimport type { Handlers, MessageResult, RegistryMessage } from './registry.ts'\n\nconst logger = createLogger('message-bus')\n\n/** The port an entrypoint dispatches through. `AppDeps` names this as `IMessageBus<typeof registry>`. */\nexport interface IMessageBus<TRegistry extends Handlers<never>> {\n handle<TMessage extends DomainMessage & RegistryMessage<TRegistry>>(\n message: TMessage,\n ): Promise<MessageResult<TMessage, TRegistry>>\n}\n\n/**\n * Routes one message to its slot. The bus opens no transaction and keeps no outbox:\n * a handler that writes opens the unit of work itself.\n */\nexport class MessageBus<Deps, TRegistry extends Handlers<Deps>> implements IMessageBus<TRegistry> {\n constructor(\n private readonly deps: Deps,\n private readonly registry: TRegistry,\n ) {}\n\n /** Resolves to the handler's own value for a command or query, and to void for an event. */\n async handle<TMessage extends DomainMessage & RegistryMessage<TRegistry>>(\n message: TMessage,\n ): Promise<MessageResult<TMessage, TRegistry>> {\n // SAFETY: the slot for this name is what `MessageResult` names, and dispatch returns its value.\n return (await this.dispatch(message)) as MessageResult<TMessage, TRegistry>\n }\n\n // oxlint-disable-next-line anti-slop/no-unknown-returns -- one table holds every slot's value; `handle` names it.\n private dispatch(message: DomainMessage): Promise<unknown> {\n if (message.type === 'command') return this.handleCommand(message)\n if (message.type === 'query') return this.handleQuery(message)\n if (message.type === 'event') return this.handleEvent(message)\n // A message parsed at a boundary cannot reach here; one that does must not resolve silently.\n return unreachable(message)\n }\n\n // oxlint-disable-next-line anti-slop/no-unknown-returns -- see dispatch.\n private handleCommand(command: DomainCommand): Promise<unknown> {\n // `satisfies` proved the registry complete, so a missing slot is a broken registry object.\n const handler = this.registry.commands[command.name]\n if (handler === undefined) return panic(`No handler for command ${command.name}`)\n logger.debug('handling_command', { name: command.name, id: command.id })\n return handler(command, this.deps)\n }\n\n // oxlint-disable-next-line anti-slop/no-unknown-returns -- see dispatch.\n private handleQuery(query: DomainQuery): Promise<unknown> {\n const handler = this.registry.queries[query.name]\n if (handler === undefined) return panic(`No handler for query ${query.name}`)\n return handler(query, this.deps)\n }\n\n /**\n * Subscribers run one after another, so one unit of work finishes before the next starts.\n * Every subscriber still runs. One failure is rethrown as is. Several are thrown as one `AggregateError`.\n * A `MessageAlreadyProcessedError` means that subscriber already committed on an earlier delivery, so it counts as delivered.\n */\n private async handleEvent(event: DomainEvent): Promise<void> {\n const subscriptions = this.registry.events[event.name] ?? []\n const failures: unknown[] = []\n for (const [subscriber, subscription] of subscriptions.entries()) {\n try {\n await subscription(event, this.deps)\n } catch (reason) {\n if (reason instanceof MessageAlreadyProcessedError) {\n // The bus swallows this error, so this line is the only record that the skip happened.\n logger.info('duplicate_subscriber_ignored', {\n event: event.name,\n id: event.id,\n subscriber,\n })\n continue\n }\n failures.push(reason)\n }\n }\n if (failures.length === 1) throw failures[0]\n if (failures.length > 1) {\n throw new AggregateError(failures, `${event.name}: ${failures.length} subscribers failed`)\n }\n }\n}\n","import { createLogger, decideRedelivery, type DomainEvent, type RedeliveryDelays } from '@/core'\n\nimport type { IOutboxPublisher, RejectedMessage } from './outbox-publisher.ts'\nimport type { IOutboxRepository, OutboxFailureReason, OutboxRow } from './outbox-repository.ts'\n\n/** Optional limits for one relay; durable attempts exclude the publisher's immediate retries. */\nexport type OutboxRelayOptions = {\n readonly batchSize?: number\n readonly maxBatches?: number\n readonly maxAttempts?: number\n /** The longest wait before the first retry; each later retry doubles it. Jitter picks between half and all of it. */\n readonly retryBaseDelayMs?: number\n /** The longest wait before a retry. */\n readonly retryMaxDelayMs?: number\n}\n\nconst logger = createLogger('outbox-relay')\n\n/**\n * Moves committed events out of the outbox: claims due rows, sends their events through the publisher,\n * and records each result on its row. A repository failure propagates to the caller.\n */\nexport class OutboxRelay {\n private readonly options: Required<OutboxRelayOptions>\n\n constructor(\n private readonly publisher: IOutboxPublisher,\n private readonly outboxRepo: IOutboxRepository,\n options: OutboxRelayOptions = {},\n private readonly now: () => Date = () => new Date(),\n ) {\n this.options = {\n batchSize: options.batchSize ?? 50,\n maxBatches: options.maxBatches ?? 10,\n maxAttempts: options.maxAttempts ?? 10,\n retryBaseDelayMs: options.retryBaseDelayMs ?? 1_000,\n retryMaxDelayMs: options.retryMaxDelayMs ?? 60_000,\n }\n }\n\n /**\n * Runs one batch: claims due rows, marks rows with no attempt left failed, and publishes the rest.\n * Called by `drain()`. Returns the claimed count; zero means no row was due.\n */\n async flush(): Promise<number> {\n const batch = await this.outboxRepo.claimDueRows(this.options.batchSize)\n const { exhaustedRows, dueRows } = this.splitByAttemptsLeft(batch.rows)\n await this.markFailed(batch.token, exhaustedRows, 'exhausted', 'Claim attempt limit exceeded')\n if (dueRows.length > 0) await this.publishDueRows(batch.token, dueRows)\n // drain() keeps going while a claim finds rows, even if every row was exhausted.\n return batch.rows.length\n }\n\n /** Sends the rows' events, marks the delivered rows published, and fails or retries the rest by their error. */\n private async publishDueRows(\n claimToken: string,\n dueRows: ReadonlyArray<OutboxRow>,\n ): Promise<void> {\n const rejectedEvents = await this.publishEvents(dueRows)\n const rejectedEventIds = new Set(rejectedEvents.map(({ message: event }) => event.id))\n const deliveredRows = dueRows.filter((row) => !rejectedEventIds.has(row.payload.id))\n if (deliveredRows.length > 0) await this.outboxRepo.markPublished(claimToken, deliveredRows)\n for (const [error, rows] of rowsByError(rejectedEvents, dueRows)) {\n // oxlint-disable-next-line no-await-in-loop -- Each error decides fail or retry for its own rows.\n await this.failOrRetry(claimToken, rows, error)\n }\n }\n\n /** Publishes the rows' events. A thrown publish counts as every event rejected with that error. */\n private async publishEvents(\n rows: ReadonlyArray<OutboxRow>,\n ): Promise<readonly RejectedMessage<DomainEvent>[]> {\n const events = rows.map((row) => row.payload)\n try {\n return await this.publisher.publish(events)\n } catch (error) {\n return events.map((event) => ({ message: event, error }))\n }\n }\n\n /**\n * Runs batches until no row is due: at most `maxBatches` × `batchSize` rows, 500 by default. Called\n * after a commit through `waitUntilWake`, and by the app's cron sweep. Returns the total claimed count.\n */\n async drain(): Promise<number> {\n let total = 0\n for (let batchCount = 0; batchCount < this.options.maxBatches; batchCount += 1) {\n // oxlint-disable-next-line no-await-in-loop -- An empty claim must stop the drain before another claim starts.\n const claimed = await this.flush()\n total += claimed\n if (claimed === 0) break\n }\n return total\n }\n\n /**\n * Decides fail or retry for rows whose events were not delivered: the whole send failed, or one event\n * was rejected. Marks them failed on a terminal error or a last attempt; releases the rest for retry.\n */\n private async failOrRetry(\n claimToken: string,\n rows: ReadonlyArray<OutboxRow>,\n cause: unknown,\n ): Promise<void> {\n const errorMessage =\n cause instanceof Error ? cause.message : 'Publisher rejected with a non-error value'\n if (decideRedelivery(cause, 1, this.delays).action === 'ack') {\n await this.markFailed(claimToken, rows, 'terminal', errorMessage, cause)\n return\n }\n const { exhaustedRows, retryRows } = this.splitByLastAttempt(rows)\n await this.markFailed(claimToken, exhaustedRows, 'exhausted', errorMessage, cause)\n await this.releaseForRetry(claimToken, retryRows, cause)\n }\n\n /** Releases rows for another attempt. Each row waits longer the more attempts it has used. */\n private async releaseForRetry(\n claimToken: string,\n rows: ReadonlyArray<OutboxRow>,\n cause: unknown,\n ): Promise<void> {\n const now = this.now().getTime()\n for (const attempts of new Set(rows.map((row) => row.attempts))) {\n const decision = decideRedelivery(cause, attempts, this.delays)\n // An ack here means a member error changed between calls; the row then retries at once.\n const delayMs = decision.action === 'retry' ? decision.delayMs : 0\n const rowsWithSameAttempts = rows.filter((row) => row.attempts === attempts)\n // oxlint-disable-next-line no-await-in-loop -- Stop releasing rows on the first database failure.\n await this.outboxRepo.releaseClaim(claimToken, rowsWithSameAttempts, new Date(now + delayMs))\n }\n }\n\n private get delays(): RedeliveryDelays {\n return { baseDelayMs: this.options.retryBaseDelayMs, maxDelayMs: this.options.retryMaxDelayMs }\n }\n\n /** Splits claimed rows: rows whose last run crashed with no attempt left, and rows that may run now. */\n private splitByAttemptsLeft(rows: ReadonlyArray<OutboxRow>) {\n return {\n exhaustedRows: rows.filter((row) => this.hasNoAttemptLeft(row)),\n dueRows: rows.filter((row) => !this.hasNoAttemptLeft(row)),\n }\n }\n\n /** Splits failed rows: rows that just used their last attempt, and rows that may retry. */\n private splitByLastAttempt(rows: ReadonlyArray<OutboxRow>) {\n return {\n exhaustedRows: rows.filter((row) => this.isLastAttempt(row)),\n retryRows: rows.filter((row) => !this.isLastAttempt(row)),\n }\n }\n\n /** True when the row used every attempt before this claim: its last run crashed, so it must not run again. */\n private hasNoAttemptLeft(row: OutboxRow): boolean {\n // The claim already counted this run, so a row on its last allowed run equals the limit.\n return row.attempts > this.options.maxAttempts\n }\n\n /** True when the run that just failed was the row's last allowed attempt, so it must not be retried. */\n private isLastAttempt(row: OutboxRow): boolean {\n return row.attempts >= this.options.maxAttempts\n }\n\n /** Calls `outboxRepo.markFailed`, then logs one error. Does nothing for an empty list. */\n private async markFailed(\n claimToken: string,\n rows: ReadonlyArray<OutboxRow>,\n reason: OutboxFailureReason,\n errorMessage: string,\n cause?: unknown,\n ): Promise<void> {\n if (rows.length === 0) return\n await this.outboxRepo.markFailed(claimToken, rows, reason, errorMessage)\n logger.error('outbox_rows_failed', {\n error: cause,\n claimToken,\n count: rows.length,\n reason,\n })\n }\n}\n\n/** Groups the rejected events' rows by error object, so one error decides fail or retry for all its rows at once. */\nfunction rowsByError(\n rejectedEvents: readonly RejectedMessage<DomainEvent>[],\n rows: ReadonlyArray<OutboxRow>,\n): Map<unknown, OutboxRow[]> {\n const rowByEventId = new Map(rows.map((row) => [row.payload.id, row]))\n const groups = new Map<unknown, OutboxRow[]>()\n for (const { message: event, error } of rejectedEvents) {\n const row = rowByEventId.get(event.id)\n if (row === undefined) continue\n const group = groups.get(error) ?? []\n group.push(row)\n groups.set(error, group)\n }\n return groups\n}\n","import type { DomainEvent } from '@/core'\n\nimport type { IOutboxPublisher, RejectedMessage } from './outbox-publisher.ts'\n\n/** A client for a consumer that runs one event when called over RPC; it rejects when the event fails. */\nexport interface IEventConsumerClient {\n consume(event: DomainEvent): Promise<void>\n}\n\n/** The two clients, the app's rule for choosing between them, and the RPC budget. */\nexport type QueueOrRpcPublisherOptions = {\n readonly queue: IOutboxPublisher\n readonly consumer: IEventConsumerClient\n /** The app's rule: which events go over RPC. */\n readonly usesRpc: (event: DomainEvent) => boolean\n /** RPC calls in one request. Cloudflare allows 32 Worker invocations per request. */\n readonly callsPerRequest?: number\n}\n\nconst DEFAULT_CALLS_PER_REQUEST = 25\n\n/**\n * Publishes each event over RPC or to the queue. Events that the rule picks are consumed over RPC,\n * in parallel, until the request's call budget is used; every other event goes to the queue.\n * Build one per request, so the budget counts that request's calls. A failed call or queue send\n * rejects only its own events.\n */\nexport class QueueOrRpcPublisher implements IOutboxPublisher {\n private callsLeft: number\n\n constructor(private readonly options: QueueOrRpcPublisherOptions) {\n this.callsLeft = options.callsPerRequest ?? DEFAULT_CALLS_PER_REQUEST\n }\n\n async publish(\n events: ReadonlyArray<DomainEvent>,\n ): Promise<readonly RejectedMessage<DomainEvent>[]> {\n const rpcEvents: DomainEvent[] = []\n const queuedEvents: DomainEvent[] = []\n for (const event of events) {\n if (this.options.usesRpc(event) && this.callsLeft > 0) {\n rpcEvents.push(event)\n this.callsLeft -= 1\n } else {\n queuedEvents.push(event)\n }\n }\n\n const [queueResult, ...callResults] = await Promise.allSettled([\n queuedEvents.length > 0 ? this.options.queue.publish(queuedEvents) : Promise.resolve([]),\n ...rpcEvents.map((event) => this.options.consumer.consume(event)),\n ])\n\n const queueRejected =\n queueResult?.status === 'fulfilled'\n ? queueResult.value\n : queuedEvents.map((event) => ({ message: event, error: queueResult?.reason }))\n const callRejected = rpcEvents.flatMap((event, index) => {\n const result = callResults[index]\n return result?.status === 'rejected' ? [{ message: event, error: result.reason }] : []\n })\n return [...queueRejected, ...callRejected]\n }\n}\n","import type { IOutboxRetentionRepository } from './outbox-repository.ts'\n\n/** Typist's retention defaults; receipt retention must cover the application's supported replay period. */\nexport type OutboxRetentionOptions = {\n readonly publishedRetentionMs?: number\n readonly failedRetentionMs?: number\n readonly receiptRetentionMs?: number\n readonly batchSize?: number\n readonly maxBatches?: number\n}\n\n/** Deleted records per category during one bounded sweep. */\nexport type OutboxRetentionResult = {\n readonly published: number\n readonly failed: number\n readonly receipts: number\n}\n\n/** Bounded cleanup ported from Typist's message retention handler. The application schedules each sweep. */\nexport class OutboxRetention {\n private readonly options: Required<OutboxRetentionOptions>\n\n constructor(\n private readonly repository: IOutboxRetentionRepository,\n options: OutboxRetentionOptions = {},\n ) {\n this.options = {\n publishedRetentionMs: options.publishedRetentionMs ?? 86_400_000,\n failedRetentionMs: options.failedRetentionMs ?? 30 * 86_400_000,\n receiptRetentionMs: options.receiptRetentionMs ?? 7 * 86_400_000,\n batchSize: options.batchSize ?? 1_000,\n maxBatches: options.maxBatches ?? 10,\n }\n }\n\n /** Calculate all cutoffs from one supplied time; propagate repository failures to the calling boundary. */\n async sweep(at: Date): Promise<OutboxRetentionResult> {\n const { publishedRetentionMs, failedRetentionMs, receiptRetentionMs } = this.options\n const published = await this.deleteBatches((size) =>\n this.repository.deletePublishedBefore(new Date(at.getTime() - publishedRetentionMs), size),\n )\n const failed = await this.deleteBatches((size) =>\n this.repository.deleteFailedBefore(new Date(at.getTime() - failedRetentionMs), size),\n )\n const receipts = await this.deleteBatches((size) =>\n this.repository.deleteReceiptsBefore(new Date(at.getTime() - receiptRetentionMs), size),\n )\n return { published, failed, receipts }\n }\n\n private async deleteBatches(deleteBatch: (size: number) => Promise<number>): Promise<number> {\n let total = 0\n for (let batch = 0; batch < this.options.maxBatches; batch += 1) {\n // oxlint-disable-next-line no-await-in-loop -- The delete count decides whether another batch is needed.\n const deleted = await deleteBatch(this.options.batchSize)\n total += deleted\n if (deleted < this.options.batchSize) break\n }\n return total\n }\n}\n","import type { MessageId } from '@/core'\n\nimport type { IEventCollector } from './event-collector.ts'\nimport { MessageAlreadyProcessedError } from './message-already-processed.error.ts'\nimport type { IMessageStore } from './message-store.ts'\nimport type { IOutboxWake } from './outbox-wake.ts'\nimport type { ITransaction } from './transaction.ts'\n\n/**\n * Commits the processed-message record, repository writes, and emitted events together before resolving.\n * An existing record rejects with `MessageAlreadyProcessedError`; external effects must run through the outbox after commit.\n * Nested calls reject with `UnitOfWorkAlreadyActiveError`.\n */\nexport interface IUnitOfWork<Repos> {\n run<T>(messageId: MessageId, work: (repos: Repos) => Promise<T>): Promise<T>\n}\n\nexport type UnitOfWorkDeps<Tx, Repos> = {\n readonly transaction: ITransaction<Tx>\n /** The processed-messages and outbox repository for this transaction. */\n readonly messageStore: (tx: Tx) => IMessageStore\n /** Repositories participate in the current transaction. */\n readonly createRepositories: (tx: Tx) => Repos\n readonly eventCollector: IEventCollector\n readonly relay: IOutboxWake\n}\n\n/** The unit of work: the boundary, the repositories, the events. Every database call is a port. */\nexport class UnitOfWork<Tx, Repos> implements IUnitOfWork<Repos> {\n constructor(private readonly deps: UnitOfWorkDeps<Tx, Repos>) {}\n\n async run<T>(messageId: MessageId, work: (repos: Repos) => Promise<T>): Promise<T> {\n const { transaction, messageStore, createRepositories, eventCollector, relay } = this.deps\n let written = 0\n\n let value: T\n try {\n value = await transaction.transaction(async (tx) => {\n const store = messageStore(tx)\n await store.claim(messageId)\n const repos = createRepositories(tx)\n const result = await work(repos)\n const pending = eventCollector.collect()\n await store.persistEvents(pending)\n written = pending.length\n return result\n })\n } catch (error) {\n throw MessageAlreadyProcessedError.from(error, messageId) ?? error\n }\n\n if (written > 0) relay.wake()\n return value\n }\n}\n","import { AppError } from '@/core'\n\n/** A boundary was opened inside another. One message, one atomic scope. */\nexport class UnitOfWorkAlreadyActiveError extends AppError {\n readonly _tag = 'UnitOfWorkAlreadyActiveError'\n readonly classification = 'terminal'\n\n constructor() {\n super('a unit of work is already active')\n }\n}\n"],"mappings":"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"}
@@ -1,3 +1,3 @@
1
- import { G as DomainMessage, K as DomainQuery, U as DomainCommand, W as DomainEvent, q as MessageId } from "./index-CtIdbnEZ.js";
2
- import { $ as MetricsService, A as IOutboxRepository, B as OutboundEmail, C as UnitOfWorkDeps, D as OutboxRelay, E as IOutboxRelay, F as IEventCollector, G as applyObservabilityUser, H as ReceivedContent, I as EmailAccepted, J as ObservabilityService, K as setObservabilityUserHook, L as EmailAttachment, M as OutboxClaim, N as OutboxMessage, O as OutboxRelayOptions, P as IMessageStore, Q as MetricOptions, R as IEmailService, S as UnitOfWork, T as IOutboxPublisher, U as ReceivedEmail, V as ReceivedAttachment, W as RecordingEmailService, X as MetricAttributeValue, Y as ObservabilityUser, Z as MetricAttributes, _ as RecordEmailEventCommand, a as OutboxRetentionResult, at as EventHandler, b as recordEmailEvent, c as CommandRegistry, d as MessageRegistry, et as NULL_METRICS_SERVICE, f as MessageResult, g as IEmailDeliverabilityStore, h as EmailBounceRecord, i as OutboxRetentionOptions, it as CommandHandler, j as IOutboxRetentionRepository, k as DeadLetterReason, l as EventRegistry, m as RegistryMessage, n as MessageAlreadyProcessedError, nt as AnalyticsService, o as IMessageBus, ot as QueryHandler, p as QueryRegistry, q as ObservabilityScope, r as OutboxRetention, rt as NULL_ANALYTICS, s as MessageBus, t as UnitOfWorkAlreadyActiveError, tt as AnalyticsPropertiesOf, u as Handlers, v as RecordEmailEventDeps, w as ITransaction, x as IUnitOfWork, y as RecordEmailEventRepos, z as MimeType } from "./index-BMY7ylgk.js";
3
- export { type AnalyticsPropertiesOf, type AnalyticsService, type CommandHandler, type CommandRegistry, type DeadLetterReason, type DomainCommand, type DomainEvent, type DomainMessage, type DomainQuery, type EmailAccepted, type EmailAttachment, type EmailBounceRecord, type EventHandler, type EventRegistry, type Handlers, type IEmailDeliverabilityStore, type IEmailService, type IEventCollector, type IMessageBus, type IMessageStore, type IOutboxPublisher, type IOutboxRelay, type IOutboxRepository, type IOutboxRetentionRepository, type ITransaction, type IUnitOfWork, MessageAlreadyProcessedError, MessageBus, type MessageId, type MessageRegistry, type MessageResult, type MetricAttributeValue, type MetricAttributes, type MetricOptions, type MetricsService, type MimeType, NULL_ANALYTICS, NULL_METRICS_SERVICE, type ObservabilityScope, type ObservabilityService, type ObservabilityUser, type OutboundEmail, type OutboxClaim, type OutboxMessage, OutboxRelay, type OutboxRelayOptions, OutboxRetention, type OutboxRetentionOptions, type OutboxRetentionResult, type QueryHandler, type QueryRegistry, type ReceivedAttachment, type ReceivedContent, type ReceivedEmail, type RecordEmailEventCommand, type RecordEmailEventDeps, type RecordEmailEventRepos, RecordingEmailService, type RegistryMessage, UnitOfWork, UnitOfWorkAlreadyActiveError, type UnitOfWorkDeps, applyObservabilityUser, recordEmailEvent, setObservabilityUserHook };
1
+ import { J as DomainEvent, X as DomainQuery, Y as DomainMessage, Z as MessageId, q as DomainCommand } from "./index-tJzJUgTh.js";
2
+ import { $ as ObservabilityUser, A as RecordEmailEventDeps, B as EmailAccepted, C as MessageRegistry, D as EmailBounceRecord, E as RegistryMessage, F as UnitOfWorkDeps, G as ReceivedAttachment, H as IEmailService, I as ITransaction, J as RecordingEmailService, K as ReceivedContent, L as IOutboxWake, M as recordEmailEvent, N as IUnitOfWork, O as IEmailDeliverabilityStore, P as UnitOfWork, Q as ObservabilityService, R as IMessageStore, S as Handlers, T as QueryRegistry, U as MimeType, V as EmailAttachment, W as OutboundEmail, X as setObservabilityUserHook, Y as applyObservabilityUser, Z as ObservabilityScope, _ as RejectedMessage, a as OutboxRetentionResult, at as AnalyticsPropertiesOf, b as CommandRegistry, c as QueueOrRpcPublisherOptions, ct as CommandHandler, d as IOutboxRepository, et as MetricAttributeValue, f as IOutboxRetentionRepository, g as IOutboxPublisher, h as OutboxRow, i as OutboxRetentionOptions, it as NULL_METRICS_SERVICE, j as RecordEmailEventRepos, k as RecordEmailEventCommand, l as OutboxRelay, lt as EventHandler, m as OutboxFailureReason, n as MessageAlreadyProcessedError, nt as MetricOptions, o as IEventConsumerClient, ot as AnalyticsService, p as OutboxBatch, q as ReceivedEmail, r as OutboxRetention, rt as MetricsService, s as QueueOrRpcPublisher, st as NULL_ANALYTICS, t as UnitOfWorkAlreadyActiveError, tt as MetricAttributes, u as OutboxRelayOptions, ut as QueryHandler, v as IMessageBus, w as MessageResult, x as EventRegistry, y as MessageBus, z as IEventCollector } from "./index-DaiY8xJJ.js";
3
+ export { type AnalyticsPropertiesOf, type AnalyticsService, type CommandHandler, type CommandRegistry, type DomainCommand, type DomainEvent, type DomainMessage, type DomainQuery, type EmailAccepted, type EmailAttachment, type EmailBounceRecord, type EventHandler, type EventRegistry, type Handlers, type IEmailDeliverabilityStore, type IEmailService, type IEventCollector, type IEventConsumerClient, type IMessageBus, type IMessageStore, type IOutboxPublisher, type IOutboxRepository, type IOutboxRetentionRepository, type IOutboxWake, type ITransaction, type IUnitOfWork, MessageAlreadyProcessedError, MessageBus, type MessageId, type MessageRegistry, type MessageResult, type MetricAttributeValue, type MetricAttributes, type MetricOptions, type MetricsService, type MimeType, NULL_ANALYTICS, NULL_METRICS_SERVICE, type ObservabilityScope, type ObservabilityService, type ObservabilityUser, type OutboundEmail, type OutboxBatch, type OutboxFailureReason, OutboxRelay, type OutboxRelayOptions, OutboxRetention, type OutboxRetentionOptions, type OutboxRetentionResult, type OutboxRow, type QueryHandler, type QueryRegistry, QueueOrRpcPublisher, type QueueOrRpcPublisherOptions, type ReceivedAttachment, type ReceivedContent, type ReceivedEmail, type RecordEmailEventCommand, type RecordEmailEventDeps, type RecordEmailEventRepos, RecordingEmailService, type RegistryMessage, type RejectedMessage, UnitOfWork, UnitOfWorkAlreadyActiveError, type UnitOfWorkDeps, applyObservabilityUser, recordEmailEvent, setObservabilityUserHook };
@@ -1,4 +1,4 @@
1
- import { a as MessageBus, c as RecordingEmailService, i as OutboxRelay, l as NULL_METRICS_SERVICE, n as UnitOfWork, o as MessageAlreadyProcessedError, r as OutboxRetention, s as recordEmailEvent, t as UnitOfWorkAlreadyActiveError, u as NULL_ANALYTICS } from "./application-Dsz-o9Aj.js";
1
+ import { a as OutboxRelay, c as recordEmailEvent, d as NULL_ANALYTICS, i as QueueOrRpcPublisher, l as RecordingEmailService, n as UnitOfWork, o as MessageBus, r as OutboxRetention, s as MessageAlreadyProcessedError, t as UnitOfWorkAlreadyActiveError, u as NULL_METRICS_SERVICE } from "./application-CnsIQX8h.js";
2
2
  import { n as setObservabilityUserHook, t as applyObservabilityUser } from "./request-user-B4rh1c2-.js";
3
3
 
4
- export { MessageAlreadyProcessedError, MessageBus, NULL_ANALYTICS, NULL_METRICS_SERVICE, OutboxRelay, OutboxRetention, RecordingEmailService, UnitOfWork, UnitOfWorkAlreadyActiveError, applyObservabilityUser, recordEmailEvent, setObservabilityUserHook };
4
+ export { MessageAlreadyProcessedError, MessageBus, NULL_ANALYTICS, NULL_METRICS_SERVICE, OutboxRelay, OutboxRetention, QueueOrRpcPublisher, RecordingEmailService, UnitOfWork, UnitOfWorkAlreadyActiveError, applyObservabilityUser, recordEmailEvent, setObservabilityUserHook };
@@ -1,4 +1,4 @@
1
- import { Jt as AppError } from "./index-CtIdbnEZ.js";
1
+ import { Qt as AppError } from "./index-tJzJUgTh.js";
2
2
  import { DurableObject } from "cloudflare:workers";
3
3
  //#region src/infrastructure/cloudflare/auth-secondary-storage.d.ts
4
4
  /** The supplied TTL cannot produce a valid expiry timestamp. Retrying the same input cannot fix it. */
@@ -34,4 +34,4 @@ declare class AuthSecondaryStorage extends DurableObject {
34
34
  }
35
35
  //#endregion
36
36
  export { InvalidCounterError as n, InvalidTtlError as r, AuthSecondaryStorage as t };
37
- //# sourceMappingURL=auth-secondary-storage-CcNkkEk0.d.ts.map
37
+ //# sourceMappingURL=auth-secondary-storage-DlzjamBm.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"auth-secondary-storage-CcNkkEk0.d.ts","names":[],"sources":["../src/infrastructure/cloudflare/auth-secondary-storage.ts"],"mappings":";;;;cAWa,wBAAwB;WAC1B;WACA;EAET;;;cAMW,4BAA4B;WAC9B;WACA;EAET;;;;;;;cAUW,6BAA6B;;EAElC,OAAO;;EAMP,IAAI,eAAe,eAAe;;EAUlC,UAAU;;EAKV,gBAAgB;;EAQhB,UAAU,cAAc;;EAef,SAAS"}
1
+ {"version":3,"file":"auth-secondary-storage-DlzjamBm.d.ts","names":[],"sources":["../src/infrastructure/cloudflare/auth-secondary-storage.ts"],"mappings":";;;;cAWa,wBAAwB;WAC1B;WACA;EAET;;;cAMW,4BAA4B;WAC9B;WACA;EAET;;;;;;;cAUW,6BAA6B;;EAElC,OAAO;;EAMP,IAAI,eAAe,eAAe;;EAUlC,UAAU;;EAKV,gBAAgB;;EAQhB,UAAU,cAAc;;EAef,SAAS"}
@@ -1,4 +1,4 @@
1
- import { Jt as AppError } from "../index-CtIdbnEZ.js";
1
+ import { Qt as AppError } from "../index-tJzJUgTh.js";
2
2
  //#region src/infrastructure/better-auth/apple-client-secret.d.ts
3
3
  /**
4
4
  * Apple's issuer and OAuth callback origin, and the `aud` claim of the client secret. Include it in
@@ -1,4 +1,4 @@
1
- import { r as createLogger, tt as AppError } from "../core-DOBZeYSX.js";
1
+ import { r as createLogger, rt as AppError } from "../core-CV8SQv01.js";
2
2
  import { Buffer } from "node:buffer";
3
3
  import { createPrivateKey, sign } from "node:crypto";
4
4
 
@@ -1,4 +1,4 @@
1
- import { U as RateLimitError } from "../core-DOBZeYSX.js";
1
+ import { G as RateLimitError } from "../core-CV8SQv01.js";
2
2
  import { createAuthClient } from "better-auth/client";
3
3
 
4
4
  //#region src/infrastructure/better-auth/auth-client.ts
@@ -1,4 +1,4 @@
1
- import { Jt as AppError } from "../index-CtIdbnEZ.js";
1
+ import { Qt as AppError } from "../index-tJzJUgTh.js";
2
2
  import { BetterAuthOptions, BetterAuthRateLimitStorage } from "better-auth";
3
3
  //#region src/infrastructure/better-auth/rate-limit.d.ts
4
4
  /** A rule Better Auth passes to storage: a window in seconds and the requests it allows. */
@@ -1,4 +1,4 @@
1
- import { r as createLogger, tt as AppError } from "../core-DOBZeYSX.js";
1
+ import { r as createLogger, rt as AppError } from "../core-CV8SQv01.js";
2
2
 
3
3
  //#region src/infrastructure/better-auth/rate-limit.ts
4
4
  /**
@@ -1,4 +1,4 @@
1
- import { t as AuthSecondaryStorage } from "../auth-secondary-storage-CcNkkEk0.js";
1
+ import { t as AuthSecondaryStorage } from "../auth-secondary-storage-DlzjamBm.js";
2
2
  import { BetterAuthOptions } from "better-auth";
3
3
  //#region src/infrastructure/better-auth/secondary-storage.d.ts
4
4
  type SecondaryStorage = NonNullable<BetterAuthOptions['secondaryStorage']>;
@@ -1,4 +1,4 @@
1
- import { r as createLogger } from "./core-DOBZeYSX.js";
1
+ import { r as createLogger } from "./core-CV8SQv01.js";
2
2
  import { v7 } from "uuid";
3
3
  import { isAPIError } from "better-auth/api";
4
4
  import { anonymous, bearer, captcha, deviceAuthorization, emailOTP, lastLoginMethod, magicLink, openAPI } from "better-auth/plugins";
@@ -1,4 +1,4 @@
1
- import { Jt as AppError, Yt as FailureClassification } from "../index-CtIdbnEZ.js";
1
+ import { $t as FailureClassification, Qt as AppError } from "../index-tJzJUgTh.js";
2
2
  import { createAuthClient } from "better-auth/client";
3
3
  import { stripeClient } from "@better-auth/stripe/client";
4
4
  //#region src/infrastructure/billing/client.d.ts
@@ -1,4 +1,4 @@
1
- import { tt as AppError } from "../core-DOBZeYSX.js";
1
+ import { rt as AppError } from "../core-CV8SQv01.js";
2
2
 
3
3
  //#region src/infrastructure/billing/client.ts
4
4
  /** A Better Auth billing endpoint rejected the request. The browser boundary owns reporting. */
@@ -1,4 +1,4 @@
1
- import { Jt as AppError } from "../index-CtIdbnEZ.js";
1
+ import { Qt as AppError } from "../index-tJzJUgTh.js";
2
2
  //#region src/infrastructure/browser-support/browser-floor.error.d.ts
3
3
  /** The browserslist file is missing, empty, or not a query browserslist can resolve. */
4
4
  export declare class BrowserFloorError extends AppError {
@@ -1,3 +1,3 @@
1
- import { i as BrowserFloorError, n as buildTargets, r as updateScreenCopy, t as browserFloor } from "../floor-BTBtPI9_.js";
1
+ import { i as BrowserFloorError, n as buildTargets, r as updateScreenCopy, t as browserFloor } from "../floor-BdRTO_LO.js";
2
2
 
3
3
  export { BrowserFloorError, browserFloor, buildTargets, updateScreenCopy };
@@ -1,4 +1,4 @@
1
- import { i as BrowserFloorError, t as browserFloor } from "../floor-BTBtPI9_.js";
1
+ import { i as BrowserFloorError, t as browserFloor } from "../floor-BdRTO_LO.js";
2
2
  import { t as POLYFILLED_APIS } from "../polyfills-DEQFkqRI.js";
3
3
  import { defineRule, eslintCompatPlugin } from "@oxlint/plugins";
4
4
  import bcd from "@mdn/browser-compat-data/forLegacyNode";
@@ -0,0 +1,27 @@
1
+ import Stripe from "stripe";
2
+
3
+ //#region src/infrastructure/stripe/client.ts
4
+ /**
5
+ * Default SDK retries and per-request timeout; client configuration and individual requests can
6
+ * override them. Three tries of 8 s plus the SDK's short waits stay under a Worker's 30 s `waitUntil`
7
+ * limit and the outbox's 60 s lease. The SDK's own timeout is 80 s.
8
+ */
9
+ const STRIPE_REQUEST_OPTIONS = Object.freeze({
10
+ maxNetworkRetries: 2,
11
+ timeout: 8e3
12
+ });
13
+ /**
14
+ * Construct a native Stripe client with fetch transport, two SDK retries and an 8 s timeout by default.
15
+ * Native configuration overrides these defaults. Inject the client into application services.
16
+ */
17
+ function createStripeClient(secretKey, options = {}) {
18
+ return new Stripe(secretKey, {
19
+ httpClient: Stripe.createFetchHttpClient(),
20
+ ...STRIPE_REQUEST_OPTIONS,
21
+ ...options
22
+ });
23
+ }
24
+
25
+ //#endregion
26
+ export { createStripeClient as n, STRIPE_REQUEST_OPTIONS as t };
27
+ //# sourceMappingURL=client-BZgpmuSp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client-BZgpmuSp.js","names":[],"sources":["../src/infrastructure/stripe/client.ts"],"sourcesContent":["import Stripe from 'stripe'\n\n/**\n * Default SDK retries and per-request timeout; client configuration and individual requests can\n * override them. Three tries of 8 s plus the SDK's short waits stay under a Worker's 30 s `waitUntil`\n * limit and the outbox's 60 s lease. The SDK's own timeout is 80 s.\n */\nexport const STRIPE_REQUEST_OPTIONS = Object.freeze({ maxNetworkRetries: 2, timeout: 8_000 })\n\n/**\n * Construct a native Stripe client with fetch transport, two SDK retries and an 8 s timeout by default.\n * Native configuration overrides these defaults. Inject the client into application services.\n */\nexport function createStripeClient(secretKey: string, options: Stripe.StripeConfig = {}): Stripe {\n return new Stripe(secretKey, {\n httpClient: Stripe.createFetchHttpClient(),\n ...STRIPE_REQUEST_OPTIONS,\n ...options,\n })\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,yBAAyB,OAAO,OAAO;CAAE,mBAAmB;CAAG,SAAS;AAAM,CAAC;;;;;AAM5F,SAAgB,mBAAmB,WAAmB,UAA+B,CAAC,GAAW;CAC/F,OAAO,IAAI,OAAO,WAAW;EAC3B,YAAY,OAAO,sBAAsB;EACzC,GAAG;EACH,GAAG;CACL,CAAC;AACH"}
@@ -1,2 +1,2 @@
1
- import { n as InvalidCounterError, r as InvalidTtlError, t as AuthSecondaryStorage } from "../auth-secondary-storage-CcNkkEk0.js";
1
+ import { n as InvalidCounterError, r as InvalidTtlError, t as AuthSecondaryStorage } from "../auth-secondary-storage-DlzjamBm.js";
2
2
  export { AuthSecondaryStorage, InvalidCounterError, InvalidTtlError };
@@ -1,4 +1,4 @@
1
- import { tt as AppError } from "../core-DOBZeYSX.js";
1
+ import { rt as AppError } from "../core-CV8SQv01.js";
2
2
  import { DurableObject } from "cloudflare:workers";
3
3
 
4
4
  //#region src/infrastructure/cloudflare/auth-secondary-storage.ts
@@ -1,5 +1,5 @@
1
- import { b as shouldRetryFailure, v as isAbortError } from "../core-DOBZeYSX.js";
2
- import { i as isClassifiedDurableObjectError, n as DurableObjectCallError, r as classifyDurableObjectError } from "../durable-object-errors-CcfTu0PQ.js";
1
+ import { S as shouldRetryFailure, b as isAbortError } from "../core-CV8SQv01.js";
2
+ import { i as isClassifiedDurableObjectError, n as DurableObjectCallError, r as classifyDurableObjectError } from "../durable-object-errors-C7e7essH.js";
3
3
  import { Result } from "better-result";
4
4
 
5
5
  //#region src/infrastructure/cloudflare/durable-object-client.ts
@@ -1,4 +1,4 @@
1
- import { Jt as AppError, Yt as FailureClassification } from "../index-CtIdbnEZ.js";
1
+ import { $t as FailureClassification, Qt as AppError } from "../index-tJzJUgTh.js";
2
2
  import { z } from "zod";
3
3
  //#region src/infrastructure/cloudflare/durable-object-errors.d.ts
4
4
  /** Stable tag for a failed Durable Object call. */
@@ -1,3 +1,3 @@
1
- import { a as isDurableObjectCallError, i as isClassifiedDurableObjectError, n as DurableObjectCallError, r as classifyDurableObjectError, t as DURABLE_OBJECT_CALL_ERROR } from "../durable-object-errors-CcfTu0PQ.js";
1
+ import { a as isDurableObjectCallError, i as isClassifiedDurableObjectError, n as DurableObjectCallError, r as classifyDurableObjectError, t as DURABLE_OBJECT_CALL_ERROR } from "../durable-object-errors-C7e7essH.js";
2
2
 
3
3
  export { DURABLE_OBJECT_CALL_ERROR, DurableObjectCallError, classifyDurableObjectError, isClassifiedDurableObjectError, isDurableObjectCallError };
@@ -1,5 +1,5 @@
1
- import { l as spreadJitterMs, s as exponentialDelayCapMs } from "../core-DOBZeYSX.js";
2
- import { i as isKVPutRateLimitError, n as decideKVRetry, t as KVError } from "../kv-errors-B2k_2lyY.js";
1
+ import { d as spreadJitterMs, l as exponentialDelayCapMs } from "../core-CV8SQv01.js";
2
+ import { i as isKVPutRateLimitError, n as decideKVRetry, t as KVError } from "../kv-errors-DXbnO7cB.js";
3
3
  import { Result } from "better-result";
4
4
 
5
5
  //#region src/infrastructure/cloudflare/kv-client.ts
@@ -1,4 +1,4 @@
1
- import { Jt as AppError, Yt as FailureClassification } from "../index-CtIdbnEZ.js";
1
+ import { $t as FailureClassification, Qt as AppError } from "../index-tJzJUgTh.js";
2
2
  //#region src/infrastructure/cloudflare/kv-errors.d.ts
3
3
  /** KV operations recognized in binding error messages. */
4
4
  export type KVOperation = 'get' | 'put' | 'delete' | 'list';
@@ -1,3 +1,3 @@
1
- import { a as isRetryableKVError, i as isKVPutRateLimitError, n as decideKVRetry, o as isTerminalKVError, r as extractKVMeta, s as isTransientKVError, t as KVError } from "../kv-errors-B2k_2lyY.js";
1
+ import { a as isRetryableKVError, i as isKVPutRateLimitError, n as decideKVRetry, o as isTerminalKVError, r as extractKVMeta, s as isTransientKVError, t as KVError } from "../kv-errors-DXbnO7cB.js";
2
2
 
3
3
  export { KVError, decideKVRetry, extractKVMeta, isKVPutRateLimitError, isRetryableKVError, isTerminalKVError, isTransientKVError };