@fantastic.dev/better-stripe 0.53.0 → 0.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +1 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +116 -2
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +58 -1
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +116 -2
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +58 -1
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +3 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +1 -0
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/usage/client.d.ts +2 -2
  16. package/dist/client/usage/client.d.ts.map +1 -1
  17. package/dist/client/usage/client.js +3 -3
  18. package/dist/client/usage/client.js.map +1 -1
  19. package/dist/client/usage/deliveryClient.d.ts +64 -0
  20. package/dist/client/usage/deliveryClient.d.ts.map +1 -0
  21. package/dist/client/usage/deliveryClient.js +60 -0
  22. package/dist/client/usage/deliveryClient.js.map +1 -0
  23. package/dist/client/usage/deliveryProtocol.d.ts +130 -0
  24. package/dist/client/usage/deliveryProtocol.d.ts.map +1 -0
  25. package/dist/client/usage/deliveryProtocol.js +21 -0
  26. package/dist/client/usage/deliveryProtocol.js.map +1 -0
  27. package/dist/client/usage/deliveryProvider.d.ts +32 -0
  28. package/dist/client/usage/deliveryProvider.d.ts.map +1 -0
  29. package/dist/client/usage/deliveryProvider.js +127 -0
  30. package/dist/client/usage/deliveryProvider.js.map +1 -0
  31. package/dist/client/usage/index.d.ts +3 -0
  32. package/dist/client/usage/index.d.ts.map +1 -1
  33. package/dist/client/usage/index.js +1 -0
  34. package/dist/client/usage/index.js.map +1 -1
  35. package/dist/client/webhooks/handler.d.ts.map +1 -1
  36. package/dist/client/webhooks/handler.js +2 -1
  37. package/dist/client/webhooks/handler.js.map +1 -1
  38. package/dist/client/webhooks/meterErrors.d.ts +5 -0
  39. package/dist/client/webhooks/meterErrors.d.ts.map +1 -0
  40. package/dist/client/webhooks/meterErrors.js +98 -0
  41. package/dist/client/webhooks/meterErrors.js.map +1 -0
  42. package/dist/client/webhooks/v2.d.ts.map +1 -1
  43. package/dist/client/webhooks/v2.js +5 -0
  44. package/dist/client/webhooks/v2.js.map +1 -1
  45. package/dist/component/_generated/api.d.ts +14 -0
  46. package/dist/component/_generated/api.d.ts.map +1 -1
  47. package/dist/component/_generated/api.js.map +1 -1
  48. package/dist/component/_generated/component.d.ts +170 -0
  49. package/dist/component/_generated/component.d.ts.map +1 -1
  50. package/dist/component/balanceFunding/mutations.d.ts +43 -43
  51. package/dist/component/earnings/triggers.d.ts +104 -2
  52. package/dist/component/earnings/triggers.d.ts.map +1 -1
  53. package/dist/component/refundHistory/queries.d.ts +1 -1
  54. package/dist/component/schema.d.ts +58 -1
  55. package/dist/component/schema.js +3 -0
  56. package/dist/component/schema.js.map +1 -1
  57. package/dist/component/usage/schema.d.ts +96 -1
  58. package/dist/component/usage/schema.d.ts.map +1 -1
  59. package/dist/component/usage/schema.js +11 -2
  60. package/dist/component/usage/schema.js.map +1 -1
  61. package/dist/component/usageDelivery/bridge.d.ts +25 -0
  62. package/dist/component/usageDelivery/bridge.d.ts.map +1 -0
  63. package/dist/component/usageDelivery/bridge.js +45 -0
  64. package/dist/component/usageDelivery/bridge.js.map +1 -0
  65. package/dist/component/usageDelivery/fields.d.ts +78 -0
  66. package/dist/component/usageDelivery/fields.d.ts.map +1 -0
  67. package/dist/component/usageDelivery/fields.js +38 -0
  68. package/dist/component/usageDelivery/fields.js.map +1 -0
  69. package/dist/component/usageDelivery/helpers.d.ts +83 -0
  70. package/dist/component/usageDelivery/helpers.d.ts.map +1 -0
  71. package/dist/component/usageDelivery/helpers.js +63 -0
  72. package/dist/component/usageDelivery/helpers.js.map +1 -0
  73. package/dist/component/usageDelivery/mutations.d.ts +97 -0
  74. package/dist/component/usageDelivery/mutations.d.ts.map +1 -0
  75. package/dist/component/usageDelivery/mutations.js +153 -0
  76. package/dist/component/usageDelivery/mutations.js.map +1 -0
  77. package/dist/component/usageDelivery/queries.d.ts +113 -0
  78. package/dist/component/usageDelivery/queries.d.ts.map +1 -0
  79. package/dist/component/usageDelivery/queries.js +22 -0
  80. package/dist/component/usageDelivery/queries.js.map +1 -0
  81. package/dist/component/usageDelivery/schema.d.ts +79 -0
  82. package/dist/component/usageDelivery/schema.d.ts.map +1 -0
  83. package/dist/component/usageDelivery/schema.js +30 -0
  84. package/dist/component/usageDelivery/schema.js.map +1 -0
  85. package/dist/component/usageDelivery/steps.d.ts +85 -0
  86. package/dist/component/usageDelivery/steps.d.ts.map +1 -0
  87. package/dist/component/usageDelivery/steps.js +154 -0
  88. package/dist/component/usageDelivery/steps.js.map +1 -0
  89. package/dist/component/usageDelivery/workflow.d.ts +15 -0
  90. package/dist/component/usageDelivery/workflow.d.ts.map +1 -0
  91. package/dist/component/usageDelivery/workflow.js +28 -0
  92. package/dist/component/usageDelivery/workflow.js.map +1 -0
  93. package/docs/README.md +3 -1
  94. package/docs/metering-setup.md +1 -1
  95. package/docs/usage-delivery.md +143 -0
  96. package/package.json +3 -2
  97. package/src/client/index.ts +16 -0
  98. package/src/client/usage/client.ts +5 -2
  99. package/src/client/usage/deliveryClient.ts +130 -0
  100. package/src/client/usage/deliveryProtocol.ts +26 -0
  101. package/src/client/usage/deliveryProvider.test.ts +207 -0
  102. package/src/client/usage/deliveryProvider.ts +155 -0
  103. package/src/client/usage/index.ts +13 -0
  104. package/src/client/webhooks/handler.ts +2 -1
  105. package/src/client/webhooks/meterErrors.test.ts +164 -0
  106. package/src/client/webhooks/meterErrors.ts +118 -0
  107. package/src/client/webhooks/v2.ts +5 -0
  108. package/src/component/_generated/api.ts +14 -0
  109. package/src/component/_generated/component.ts +302 -0
  110. package/src/component/schema.ts +6 -0
  111. package/src/component/usage/schema.ts +11 -2
  112. package/src/component/usageDelivery/bridge.ts +56 -0
  113. package/src/component/usageDelivery/concurrency.test.ts +62 -0
  114. package/src/component/usageDelivery/fields.ts +59 -0
  115. package/src/component/usageDelivery/helpers.ts +77 -0
  116. package/src/component/usageDelivery/mutations.ts +185 -0
  117. package/src/component/usageDelivery/queries.ts +25 -0
  118. package/src/component/usageDelivery/schema.ts +33 -0
  119. package/src/component/usageDelivery/steps.ts +171 -0
  120. package/src/component/usageDelivery/workflow.test.ts +402 -0
  121. package/src/component/usageDelivery/workflow.ts +36 -0
@@ -0,0 +1,185 @@
1
+ import { errorCode } from "./fields.js";
2
+ import type { PreparedUsageRecord } from "../../client/usage/records.js";
3
+ import { mutation } from "../_generated/server.js";
4
+ import { anyApi, type FunctionReference } from "convex/server";
5
+ import type { WorkflowId } from "@convex-dev/workflow";
6
+ import { v } from "convex/values";
7
+ import { refFields, status } from "./schema.js";
8
+ import { read, currentStatus } from "./helpers.js";
9
+ import { executionWorkflow } from "../durableExecution/runtime.js";
10
+ import type { MutationCtx } from "../_generated/server.js";
11
+ import type { Doc } from "../_generated/dataModel.js";
12
+ const workflow = anyApi.usageDelivery.workflow.run as FunctionReference<
13
+ "mutation",
14
+ "internal"
15
+ >;
16
+ async function launch(
17
+ ctx: MutationCtx,
18
+ args: import("convex/values").Infer<typeof _refValidator>,
19
+ outbox: Doc<"usageOutbox">,
20
+ ) {
21
+ if (outbox.workflowId) {
22
+ const state = await executionWorkflow.status(
23
+ ctx,
24
+ outbox.workflowId as WorkflowId,
25
+ );
26
+ if (state.type === "inProgress") return;
27
+ if (state.type === "failed") {
28
+ const last = (
29
+ await executionWorkflow.listSteps(
30
+ ctx,
31
+ outbox.workflowId as WorkflowId,
32
+ { order: "desc", paginationOpts: { cursor: null, numItems: 1 } },
33
+ )
34
+ ).page[0];
35
+ if (last?.name === "save-receipt" && last.runResult?.kind === "failed") {
36
+ await executionWorkflow.restart(ctx, outbox.workflowId as WorkflowId, {
37
+ from: last.stepNumber,
38
+ startAsync: true,
39
+ });
40
+ return;
41
+ }
42
+ }
43
+ }
44
+ const workflowId = await executionWorkflow.start(ctx, workflow, args, {
45
+ startAsync: true,
46
+ });
47
+ await ctx.db.patch("usageOutbox", outbox._id, { workflowId });
48
+ }
49
+ const _refValidator = v.object(refFields);
50
+ export const start = mutation({
51
+ args: { ...refFields, provider: v.string(), definitionVersion: v.literal(1) },
52
+ returns: status,
53
+ handler: async (ctx, args) => {
54
+ const { outbox } = await read(ctx, args);
55
+ if (!args.provider.startsWith("function://") || args.provider.length > 2048)
56
+ throw new Error("Internal provider handle required");
57
+ if (outbox.provider && outbox.provider !== args.provider)
58
+ throw new Error("Usage provider binding is immutable");
59
+ if (!outbox.provider)
60
+ await ctx.db.patch("usageOutbox", outbox._id, {
61
+ provider: args.provider,
62
+ definitionVersion: 1,
63
+ });
64
+ if (
65
+ !["provider_accepted", "rejected", "unknown", "held"].includes(
66
+ outbox.state,
67
+ )
68
+ )
69
+ await launch(ctx, { scope: args.scope, eventId: args.eventId }, outbox);
70
+ return await currentStatus(ctx, (await read(ctx, args)).outbox);
71
+ },
72
+ });
73
+ export const hold = mutation({
74
+ args: refFields,
75
+ returns: status,
76
+ handler: async (ctx, args) => {
77
+ const { outbox } = await read(ctx, args);
78
+ await ctx.db.patch("usageOutbox", outbox._id, {
79
+ held: true,
80
+ ...(outbox.state === "queued"
81
+ ? { state: "held" as const, reason: "administrative_hold" as const }
82
+ : {}),
83
+ });
84
+ return await currentStatus(ctx, (await read(ctx, args)).outbox);
85
+ },
86
+ });
87
+ export const resume = mutation({
88
+ args: refFields,
89
+ returns: status,
90
+ handler: async (ctx, args) => {
91
+ const { outbox } = await read(ctx, args);
92
+ if (
93
+ outbox.state === "unknown" ||
94
+ ["provider_accepted", "rejected"].includes(outbox.state) ||
95
+ outbox.reason === "delivery_window_expired"
96
+ ) {
97
+ if (outbox.held)
98
+ await ctx.db.patch("usageOutbox", outbox._id, { held: false });
99
+ return await currentStatus(ctx, (await read(ctx, args)).outbox);
100
+ }
101
+ if (!outbox.provider)
102
+ throw new Error("Start delivery with a host provider first");
103
+ await ctx.db.patch("usageOutbox", outbox._id, {
104
+ held: false,
105
+ state: outbox.state === "sending" ? "sending" : "queued",
106
+ reason: undefined,
107
+ });
108
+ await launch(ctx, args, outbox);
109
+ return await currentStatus(ctx, (await read(ctx, args)).outbox);
110
+ },
111
+ });
112
+
113
+ /** Only a verified host webhook/provider action may submit native reports. */
114
+ export const recordErrorReport = mutation({
115
+ args: {
116
+ stripeAccountId: v.string(),
117
+ livemode: v.boolean(),
118
+ providerEventId: v.string(),
119
+ meterId: v.optional(v.string()),
120
+ samples: v.array(v.object({ identifier: v.string(), code: errorCode })),
121
+ truncated: v.boolean(),
122
+ },
123
+ returns: v.object({
124
+ matched: v.number(),
125
+ unattributed: v.number(),
126
+ truncated: v.boolean(),
127
+ }),
128
+ handler: async (ctx, args) => {
129
+ if (
130
+ args.samples.length > 100 ||
131
+ !/^evt_[a-zA-Z0-9_]+$/.test(args.providerEventId) ||
132
+ args.providerEventId.length > 100 ||
133
+ !/^acct_[a-zA-Z0-9]+$/.test(args.stripeAccountId)
134
+ )
135
+ throw new Error("Invalid usage error report");
136
+ let matched = 0,
137
+ unattributed = 0;
138
+ for (const sample of args.samples) {
139
+ if (sample.identifier.length > 100)
140
+ throw new Error("Invalid usage error identifier");
141
+ const outbox = await ctx.db
142
+ .query("usageOutbox")
143
+ .withIndex("by_provider_identifier", (q) =>
144
+ q.eq("providerIdentifier", sample.identifier),
145
+ )
146
+ .unique();
147
+ const event = outbox
148
+ ? await ctx.db.get("usageEvents", outbox.eventId)
149
+ : null;
150
+ const record = event
151
+ ? (JSON.parse(event.recordJson) as PreparedUsageRecord)
152
+ : null;
153
+ if (
154
+ !event ||
155
+ !record ||
156
+ record.scope.stripeAccountId !== args.stripeAccountId ||
157
+ record.scope.livemode !== args.livemode ||
158
+ (args.meterId !== undefined && record.scope.meterId !== args.meterId)
159
+ ) {
160
+ unattributed++;
161
+ continue;
162
+ }
163
+ const dedupe = JSON.stringify([
164
+ args.providerEventId,
165
+ event._id,
166
+ sample.code,
167
+ ]);
168
+ const prior = await ctx.db
169
+ .query("usageDeliveryErrors")
170
+ .withIndex("by_dedupe", (q) => q.eq("dedupe", dedupe))
171
+ .unique();
172
+ if (!prior)
173
+ await ctx.db.insert("usageDeliveryErrors", {
174
+ dedupe,
175
+ scopeKey: event.scopeKey,
176
+ eventId: event._id,
177
+ providerEventId: args.providerEventId,
178
+ code: sample.code,
179
+ observedAt: Math.floor(Date.now() / 1000),
180
+ });
181
+ matched++;
182
+ }
183
+ return { matched, unattributed, truncated: args.truncated };
184
+ },
185
+ });
@@ -0,0 +1,25 @@
1
+ import { query, internalQuery } from "../_generated/server.js";
2
+ import { refFields, status } from "./schema.js";
3
+ import { read, currentStatus } from "./helpers.js";
4
+ import { v } from "convex/values";
5
+ import { eventDoc, outboxDoc } from "../usage/schema.js";
6
+ export const get = query({
7
+ args: refFields,
8
+ returns: status,
9
+ handler: async (ctx, args) =>
10
+ currentStatus(ctx, (await read(ctx, args)).outbox),
11
+ });
12
+ const snapshotDefinition = {
13
+ args: refFields,
14
+ returns: v.object({ event: eventDoc, outbox: outboxDoc }),
15
+ handler: async (
16
+ ctx: import("../_generated/server.js").QueryCtx,
17
+ args: import("convex/values").Infer<typeof _refValidator>,
18
+ ) => {
19
+ const { event, outbox } = await read(ctx, args);
20
+ return { event, outbox };
21
+ },
22
+ };
23
+ const _refValidator = v.object(refFields);
24
+ export const saved = internalQuery(snapshotDefinition);
25
+ export const snapshot = query(snapshotDefinition);
@@ -0,0 +1,33 @@
1
+ import { v } from "convex/values";
2
+ import { scopeValidator, deliveryValidator } from "../usage/schema.js";
3
+ import { errorCode, reason } from "./fields.js";
4
+ export const refFields = {
5
+ scope: scopeValidator,
6
+ eventId: v.id("usageEvents"),
7
+ };
8
+ export const status = v.object({
9
+ validationErrors: v.array(
10
+ v.object({
11
+ providerEventId: v.string(),
12
+ code: errorCode,
13
+ observedAt: v.number(),
14
+ }),
15
+ ),
16
+ validationHistoryComplete: v.boolean(),
17
+ eventId: v.id("usageEvents"),
18
+ state: deliveryValidator,
19
+ attempts: v.number(),
20
+ held: v.boolean(),
21
+ reason: v.optional(reason),
22
+ providerIdentifier: v.string(),
23
+ receipt: v.optional(
24
+ v.object({ identifier: v.string(), created: v.number() }),
25
+ ),
26
+ });
27
+ export const request = {
28
+ ...refFields,
29
+ attempt: v.number(),
30
+ definitionVersion: v.literal(1),
31
+ apiVersion: v.string(),
32
+ identifier: v.string(),
33
+ };
@@ -0,0 +1,171 @@
1
+ import { internalMutation } from "../_generated/server.js";
2
+ import { v } from "convex/values";
3
+ import { refFields, request, status } from "./schema.js";
4
+ import { outcome } from "./fields.js";
5
+ import { read, statusOf, lockKeys } from "./helpers.js";
6
+ export const claim = internalMutation({
7
+ args: refFields,
8
+ returns: v.union(
9
+ v.object({ kind: v.literal("ready"), request: v.object(request) }),
10
+ v.object({ kind: v.literal("wait"), delayMs: v.number() }),
11
+ v.object({ kind: v.literal("done") }),
12
+ ),
13
+ handler: async (ctx, args) => {
14
+ const { outbox, record } = await read(ctx, args),
15
+ now = Math.floor(Date.now() / 1000);
16
+ if (
17
+ outbox.held ||
18
+ ["provider_accepted", "rejected", "unknown", "held"].includes(
19
+ outbox.state,
20
+ )
21
+ )
22
+ return { kind: "done" as const };
23
+ if (
24
+ record.occurredAt < now - 35 * 86400 ||
25
+ record.occurredAt > now + 300 ||
26
+ (outbox.firstSendAt !== undefined &&
27
+ now - outbox.firstSendAt >= 23 * 3600)
28
+ ) {
29
+ await ctx.db.patch("usageOutbox", outbox._id, {
30
+ state: outbox.firstSendAt === undefined ? "held" : "unknown",
31
+ reason: "delivery_window_expired",
32
+ });
33
+ return { kind: "done" as const };
34
+ }
35
+ if (outbox.state === "sending") {
36
+ if ((outbox.leaseUntil ?? 0) > now)
37
+ return {
38
+ kind: "wait" as const,
39
+ delayMs: Math.min(
40
+ 60000,
41
+ Math.max(1000, ((outbox.leaseUntil ?? now) - now) * 1000),
42
+ ),
43
+ };
44
+ await ctx.db.patch("usageOutbox", outbox._id, {
45
+ state: "unknown",
46
+ reason: "provider_outcome_unknown",
47
+ });
48
+ return { kind: "done" as const };
49
+ }
50
+ const keys = lockKeys(record);
51
+ const realm = await ctx.db
52
+ .query("usageDeliveryLocks")
53
+ .withIndex("by_key", (q) => q.eq("key", keys.realm))
54
+ .unique();
55
+ const customer = await ctx.db
56
+ .query("usageDeliveryLocks")
57
+ .withIndex("by_key", (q) => q.eq("key", keys.customer))
58
+ .unique();
59
+ const waitUntil = Math.max(
60
+ outbox.nextAttemptAt,
61
+ realm?.nextAttemptAt ?? 0,
62
+ customer?.leaseUntil ?? 0,
63
+ );
64
+ if (waitUntil > now)
65
+ return {
66
+ kind: "wait" as const,
67
+ delayMs: Math.min(60000, (waitUntil - now) * 1000),
68
+ };
69
+ const slot = { key: keys.realm, leaseUntil: 0, nextAttemptAt: now + 1 };
70
+ if (realm) await ctx.db.patch("usageDeliveryLocks", realm._id, slot);
71
+ else await ctx.db.insert("usageDeliveryLocks", slot);
72
+ const lock = {
73
+ key: keys.customer,
74
+ eventId: args.eventId,
75
+ leaseUntil: now + 900,
76
+ nextAttemptAt: 0,
77
+ };
78
+ if (customer) await ctx.db.patch("usageDeliveryLocks", customer._id, lock);
79
+ else await ctx.db.insert("usageDeliveryLocks", lock);
80
+ const attempt = outbox.attempts + 1;
81
+ await ctx.db.patch("usageOutbox", outbox._id, {
82
+ state: "sending",
83
+ attempts: attempt,
84
+ firstSendAt: outbox.firstSendAt ?? now,
85
+ leaseUntil: now + 900,
86
+ reason: undefined,
87
+ });
88
+ return {
89
+ kind: "ready" as const,
90
+ request: {
91
+ ...args,
92
+ attempt,
93
+ definitionVersion: 1 as const,
94
+ apiVersion: record.binding.apiVersion,
95
+ identifier: outbox.providerIdentifier,
96
+ },
97
+ };
98
+ },
99
+ });
100
+ export const save = internalMutation({
101
+ args: { ...request, outcome },
102
+ returns: status,
103
+ handler: async (ctx, args) => {
104
+ const { outbox, record } = await read(ctx, args);
105
+ if (
106
+ outbox.attempts !== args.attempt ||
107
+ outbox.providerIdentifier !== args.identifier ||
108
+ record.binding.apiVersion !== args.apiVersion ||
109
+ outbox.definitionVersion !== args.definitionVersion
110
+ )
111
+ throw new Error("Stale usage delivery receipt");
112
+ if (outbox.receipt || outbox.state === "rejected") return statusOf(outbox);
113
+ const result = args.outcome,
114
+ now = Math.floor(Date.now() / 1000);
115
+ const update =
116
+ result.status === "accepted"
117
+ ? {
118
+ state: "provider_accepted" as const,
119
+ receipt: { identifier: args.identifier, created: result.created },
120
+ reason: undefined,
121
+ }
122
+ : result.status === "unknown"
123
+ ? {
124
+ state: "unknown" as const,
125
+ reason: "provider_outcome_unknown" as const,
126
+ }
127
+ : result.status === "rejected"
128
+ ? {
129
+ state: "rejected" as const,
130
+ reason: "provider_rejected" as const,
131
+ }
132
+ : result.status === "unavailable"
133
+ ? {
134
+ state: "held" as const,
135
+ reason: "provider_unavailable" as const,
136
+ }
137
+ : {
138
+ state: outbox.held ? ("held" as const) : ("queued" as const),
139
+ reason: "rate_limited" as const,
140
+ nextAttemptAt:
141
+ now + Math.min(60, 2 ** Math.min(outbox.attempts, 6)),
142
+ };
143
+ await ctx.db.patch("usageOutbox", outbox._id, update);
144
+ if (result.status !== "unknown") {
145
+ const key = lockKeys(record).customer;
146
+ const lock = await ctx.db
147
+ .query("usageDeliveryLocks")
148
+ .withIndex("by_key", (q) => q.eq("key", key))
149
+ .unique();
150
+ if (lock?.eventId === args.eventId)
151
+ await ctx.db.patch("usageDeliveryLocks", lock._id, {
152
+ leaseUntil: 0,
153
+ eventId: undefined,
154
+ });
155
+ }
156
+ return statusOf((await read(ctx, args)).outbox);
157
+ },
158
+ });
159
+ export const exhaust = internalMutation({
160
+ args: refFields,
161
+ returns: v.null(),
162
+ handler: async (ctx, args) => {
163
+ const { outbox } = await read(ctx, args);
164
+ if (outbox.state === "queued")
165
+ await ctx.db.patch("usageOutbox", outbox._id, {
166
+ state: "held",
167
+ reason: "retry_exhausted",
168
+ });
169
+ return null;
170
+ },
171
+ });