@fantastic.dev/better-stripe 0.53.0 → 0.55.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 (184) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +1 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +226 -34
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +97 -1
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +226 -34
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +97 -1
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +8 -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 +8 -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/usage/invoiceObservation.d.ts +38 -0
  36. package/dist/client/usage/invoiceObservation.d.ts.map +1 -0
  37. package/dist/client/usage/invoiceObservation.js +157 -0
  38. package/dist/client/usage/invoiceObservation.js.map +1 -0
  39. package/dist/client/usage/observationClient.d.ts +83 -0
  40. package/dist/client/usage/observationClient.d.ts.map +1 -0
  41. package/dist/client/usage/observationClient.js +157 -0
  42. package/dist/client/usage/observationClient.js.map +1 -0
  43. package/dist/client/usage/observationTypes.d.ts +63 -0
  44. package/dist/client/usage/observationTypes.d.ts.map +1 -0
  45. package/dist/client/usage/observationTypes.js +59 -0
  46. package/dist/client/usage/observationTypes.js.map +1 -0
  47. package/dist/client/usage/providerObservation.d.ts +4 -0
  48. package/dist/client/usage/providerObservation.d.ts.map +1 -0
  49. package/dist/client/usage/providerObservation.js +96 -0
  50. package/dist/client/usage/providerObservation.js.map +1 -0
  51. package/dist/client/usage/reconciliation.d.ts +12 -0
  52. package/dist/client/usage/reconciliation.d.ts.map +1 -0
  53. package/dist/client/usage/reconciliation.js +48 -0
  54. package/dist/client/usage/reconciliation.js.map +1 -0
  55. package/dist/client/usage/summary.d.ts +50 -0
  56. package/dist/client/usage/summary.d.ts.map +1 -0
  57. package/dist/client/usage/summary.js +110 -0
  58. package/dist/client/usage/summary.js.map +1 -0
  59. package/dist/client/webhooks/handler.d.ts.map +1 -1
  60. package/dist/client/webhooks/handler.js +2 -1
  61. package/dist/client/webhooks/handler.js.map +1 -1
  62. package/dist/client/webhooks/meterErrors.d.ts +5 -0
  63. package/dist/client/webhooks/meterErrors.d.ts.map +1 -0
  64. package/dist/client/webhooks/meterErrors.js +98 -0
  65. package/dist/client/webhooks/meterErrors.js.map +1 -0
  66. package/dist/client/webhooks/v2.d.ts.map +1 -1
  67. package/dist/client/webhooks/v2.js +5 -0
  68. package/dist/client/webhooks/v2.js.map +1 -1
  69. package/dist/component/_generated/api.d.ts +22 -0
  70. package/dist/component/_generated/api.d.ts.map +1 -1
  71. package/dist/component/_generated/api.js.map +1 -1
  72. package/dist/component/_generated/component.d.ts +265 -0
  73. package/dist/component/_generated/component.d.ts.map +1 -1
  74. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  75. package/dist/component/balanceFunding/mutations.d.ts +27 -27
  76. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  77. package/dist/component/earnings/triggers.d.ts +206 -18
  78. package/dist/component/earnings/triggers.d.ts.map +1 -1
  79. package/dist/component/schema.d.ts +97 -1
  80. package/dist/component/schema.js +6 -0
  81. package/dist/component/schema.js.map +1 -1
  82. package/dist/component/usage/schema.d.ts +101 -1
  83. package/dist/component/usage/schema.d.ts.map +1 -1
  84. package/dist/component/usage/schema.js +11 -2
  85. package/dist/component/usage/schema.js.map +1 -1
  86. package/dist/component/usageDelivery/bridge.d.ts +25 -0
  87. package/dist/component/usageDelivery/bridge.d.ts.map +1 -0
  88. package/dist/component/usageDelivery/bridge.js +45 -0
  89. package/dist/component/usageDelivery/bridge.js.map +1 -0
  90. package/dist/component/usageDelivery/fields.d.ts +79 -0
  91. package/dist/component/usageDelivery/fields.d.ts.map +1 -0
  92. package/dist/component/usageDelivery/fields.js +39 -0
  93. package/dist/component/usageDelivery/fields.js.map +1 -0
  94. package/dist/component/usageDelivery/helpers.d.ts +84 -0
  95. package/dist/component/usageDelivery/helpers.d.ts.map +1 -0
  96. package/dist/component/usageDelivery/helpers.js +63 -0
  97. package/dist/component/usageDelivery/helpers.js.map +1 -0
  98. package/dist/component/usageDelivery/mutations.d.ts +97 -0
  99. package/dist/component/usageDelivery/mutations.d.ts.map +1 -0
  100. package/dist/component/usageDelivery/mutations.js +160 -0
  101. package/dist/component/usageDelivery/mutations.js.map +1 -0
  102. package/dist/component/usageDelivery/queries.d.ts +115 -0
  103. package/dist/component/usageDelivery/queries.d.ts.map +1 -0
  104. package/dist/component/usageDelivery/queries.js +22 -0
  105. package/dist/component/usageDelivery/queries.js.map +1 -0
  106. package/dist/component/usageDelivery/schema.d.ts +79 -0
  107. package/dist/component/usageDelivery/schema.d.ts.map +1 -0
  108. package/dist/component/usageDelivery/schema.js +30 -0
  109. package/dist/component/usageDelivery/schema.js.map +1 -0
  110. package/dist/component/usageDelivery/steps.d.ts +85 -0
  111. package/dist/component/usageDelivery/steps.d.ts.map +1 -0
  112. package/dist/component/usageDelivery/steps.js +161 -0
  113. package/dist/component/usageDelivery/steps.js.map +1 -0
  114. package/dist/component/usageDelivery/workflow.d.ts +15 -0
  115. package/dist/component/usageDelivery/workflow.d.ts.map +1 -0
  116. package/dist/component/usageDelivery/workflow.js +28 -0
  117. package/dist/component/usageDelivery/workflow.js.map +1 -0
  118. package/dist/component/usageObservations/helpers.d.ts +38 -0
  119. package/dist/component/usageObservations/helpers.d.ts.map +1 -0
  120. package/dist/component/usageObservations/helpers.js +80 -0
  121. package/dist/component/usageObservations/helpers.js.map +1 -0
  122. package/dist/component/usageObservations/history.d.ts +6 -0
  123. package/dist/component/usageObservations/history.d.ts.map +1 -0
  124. package/dist/component/usageObservations/history.js +29 -0
  125. package/dist/component/usageObservations/history.js.map +1 -0
  126. package/dist/component/usageObservations/mutations.d.ts +6 -0
  127. package/dist/component/usageObservations/mutations.d.ts.map +1 -0
  128. package/dist/component/usageObservations/mutations.js +39 -0
  129. package/dist/component/usageObservations/mutations.js.map +1 -0
  130. package/dist/component/usageObservations/queries.d.ts +78 -0
  131. package/dist/component/usageObservations/queries.d.ts.map +1 -0
  132. package/dist/component/usageObservations/queries.js +131 -0
  133. package/dist/component/usageObservations/queries.js.map +1 -0
  134. package/dist/component/usageObservations/schema.d.ts +72 -0
  135. package/dist/component/usageObservations/schema.d.ts.map +1 -0
  136. package/dist/component/usageObservations/schema.js +29 -0
  137. package/dist/component/usageObservations/schema.js.map +1 -0
  138. package/docs/README.md +5 -1
  139. package/docs/metering-setup.md +3 -1
  140. package/docs/usage-delivery.md +143 -0
  141. package/docs/usage-observations.md +152 -0
  142. package/package.json +4 -2
  143. package/src/client/index.ts +34 -0
  144. package/src/client/usage/client.ts +5 -2
  145. package/src/client/usage/deliveryClient.ts +130 -0
  146. package/src/client/usage/deliveryProtocol.ts +26 -0
  147. package/src/client/usage/deliveryProvider.test.ts +207 -0
  148. package/src/client/usage/deliveryProvider.ts +155 -0
  149. package/src/client/usage/index.ts +31 -0
  150. package/src/client/usage/invoiceObservation.test.ts +195 -0
  151. package/src/client/usage/invoiceObservation.ts +203 -0
  152. package/src/client/usage/observationClient.ts +233 -0
  153. package/src/client/usage/observationTypes.ts +101 -0
  154. package/src/client/usage/providerObservation.test.ts +207 -0
  155. package/src/client/usage/providerObservation.ts +124 -0
  156. package/src/client/usage/reconciliation.test.ts +117 -0
  157. package/src/client/usage/reconciliation.ts +86 -0
  158. package/src/client/usage/summary.test.ts +222 -0
  159. package/src/client/usage/summary.ts +188 -0
  160. package/src/client/webhooks/handler.ts +2 -1
  161. package/src/client/webhooks/meterErrors.test.ts +164 -0
  162. package/src/client/webhooks/meterErrors.ts +118 -0
  163. package/src/client/webhooks/v2.ts +5 -0
  164. package/src/component/_generated/api.ts +22 -0
  165. package/src/component/_generated/component.ts +437 -0
  166. package/src/component/schema.ts +12 -0
  167. package/src/component/usage/schema.ts +11 -2
  168. package/src/component/usageDelivery/bridge.ts +56 -0
  169. package/src/component/usageDelivery/concurrency.test.ts +62 -0
  170. package/src/component/usageDelivery/fields.ts +60 -0
  171. package/src/component/usageDelivery/helpers.ts +77 -0
  172. package/src/component/usageDelivery/mutations.ts +210 -0
  173. package/src/component/usageDelivery/queries.ts +25 -0
  174. package/src/component/usageDelivery/schema.ts +33 -0
  175. package/src/component/usageDelivery/steps.ts +209 -0
  176. package/src/component/usageDelivery/workflow.test.ts +402 -0
  177. package/src/component/usageDelivery/workflow.ts +36 -0
  178. package/src/component/usageObservations/helpers.ts +95 -0
  179. package/src/component/usageObservations/history.test.ts +87 -0
  180. package/src/component/usageObservations/history.ts +39 -0
  181. package/src/component/usageObservations/mutations.ts +39 -0
  182. package/src/component/usageObservations/queries.test.ts +162 -0
  183. package/src/component/usageObservations/queries.ts +145 -0
  184. package/src/component/usageObservations/schema.ts +40 -0
@@ -0,0 +1,161 @@
1
+ import { appendDeliveryHistory } from "../usageObservations/history.js";
2
+ import { internalMutation } from "../_generated/server.js";
3
+ import { v } from "convex/values";
4
+ import { refFields, request, status } from "./schema.js";
5
+ import { outcome } from "./fields.js";
6
+ import { read, statusOf, lockKeys } from "./helpers.js";
7
+ export const claim = internalMutation({
8
+ args: refFields,
9
+ returns: v.union(v.object({ kind: v.literal("ready"), request: v.object(request) }), v.object({ kind: v.literal("wait"), delayMs: v.number() }), v.object({ kind: v.literal("done") })),
10
+ handler: async (ctx, args) => {
11
+ const { outbox, record } = await read(ctx, args), now = Math.floor(Date.now() / 1000);
12
+ if (outbox.held ||
13
+ ["provider_accepted", "rejected", "unknown", "held"].includes(outbox.state))
14
+ return { kind: "done" };
15
+ if (record.occurredAt < now - 35 * 86400 ||
16
+ record.occurredAt > now + 300 ||
17
+ (outbox.firstSendAt !== undefined &&
18
+ now - outbox.firstSendAt >= 23 * 3600)) {
19
+ await ctx.db.patch("usageOutbox", outbox._id, {
20
+ state: outbox.firstSendAt === undefined ? "held" : "unknown",
21
+ reason: "delivery_window_expired",
22
+ });
23
+ await appendDeliveryHistory(ctx, args.eventId, "window_expired", outbox.attempts, `window:${outbox.attempts}`);
24
+ return { kind: "done" };
25
+ }
26
+ if (outbox.state === "sending") {
27
+ if ((outbox.leaseUntil ?? 0) > now)
28
+ return {
29
+ kind: "wait",
30
+ delayMs: Math.min(60000, Math.max(1000, ((outbox.leaseUntil ?? now) - now) * 1000)),
31
+ };
32
+ await ctx.db.patch("usageOutbox", outbox._id, {
33
+ state: "unknown",
34
+ reason: "provider_outcome_unknown",
35
+ });
36
+ await appendDeliveryHistory(ctx, args.eventId, "unknown", outbox.attempts, `result:${outbox.attempts}:unknown`);
37
+ return { kind: "done" };
38
+ }
39
+ const keys = lockKeys(record);
40
+ const realm = await ctx.db
41
+ .query("usageDeliveryLocks")
42
+ .withIndex("by_key", (q) => q.eq("key", keys.realm))
43
+ .unique();
44
+ const customer = await ctx.db
45
+ .query("usageDeliveryLocks")
46
+ .withIndex("by_key", (q) => q.eq("key", keys.customer))
47
+ .unique();
48
+ const waitUntil = Math.max(outbox.nextAttemptAt, realm?.nextAttemptAt ?? 0, customer?.leaseUntil ?? 0);
49
+ if (waitUntil > now)
50
+ return {
51
+ kind: "wait",
52
+ delayMs: Math.min(60000, (waitUntil - now) * 1000),
53
+ };
54
+ const slot = { key: keys.realm, leaseUntil: 0, nextAttemptAt: now + 1 };
55
+ if (realm)
56
+ await ctx.db.patch("usageDeliveryLocks", realm._id, slot);
57
+ else
58
+ await ctx.db.insert("usageDeliveryLocks", slot);
59
+ const lock = {
60
+ key: keys.customer,
61
+ eventId: args.eventId,
62
+ leaseUntil: now + 900,
63
+ nextAttemptAt: 0,
64
+ };
65
+ if (customer)
66
+ await ctx.db.patch("usageDeliveryLocks", customer._id, lock);
67
+ else
68
+ await ctx.db.insert("usageDeliveryLocks", lock);
69
+ const attempt = outbox.attempts + 1;
70
+ await ctx.db.patch("usageOutbox", outbox._id, {
71
+ state: "sending",
72
+ attempts: attempt,
73
+ firstSendAt: outbox.firstSendAt ?? now,
74
+ leaseUntil: now + 900,
75
+ reason: undefined,
76
+ });
77
+ await appendDeliveryHistory(ctx, args.eventId, "started", attempt, `started:${attempt}`);
78
+ return {
79
+ kind: "ready",
80
+ request: {
81
+ ...args,
82
+ attempt,
83
+ definitionVersion: 1,
84
+ apiVersion: record.binding.apiVersion,
85
+ identifier: outbox.providerIdentifier,
86
+ },
87
+ };
88
+ },
89
+ });
90
+ export const save = internalMutation({
91
+ args: { ...request, outcome },
92
+ returns: status,
93
+ handler: async (ctx, args) => {
94
+ const { outbox, record } = await read(ctx, args);
95
+ if (outbox.attempts !== args.attempt ||
96
+ outbox.providerIdentifier !== args.identifier ||
97
+ record.binding.apiVersion !== args.apiVersion ||
98
+ outbox.definitionVersion !== args.definitionVersion)
99
+ throw new Error("Stale usage delivery receipt");
100
+ if (outbox.receipt || outbox.state === "rejected")
101
+ return statusOf(outbox);
102
+ const result = args.outcome, now = Math.floor(Date.now() / 1000);
103
+ const update = result.status === "accepted"
104
+ ? {
105
+ state: "provider_accepted",
106
+ receipt: { identifier: args.identifier, created: result.created },
107
+ reason: undefined,
108
+ }
109
+ : result.status === "unknown"
110
+ ? {
111
+ state: "unknown",
112
+ reason: "provider_outcome_unknown",
113
+ }
114
+ : result.status === "rejected"
115
+ ? {
116
+ state: "rejected",
117
+ reason: "provider_rejected",
118
+ }
119
+ : result.status === "unavailable"
120
+ ? {
121
+ state: "held",
122
+ reason: "provider_unavailable",
123
+ }
124
+ : {
125
+ state: outbox.held ? "held" : "queued",
126
+ reason: "rate_limited",
127
+ nextAttemptAt: now + Math.min(60, 2 ** Math.min(outbox.attempts, 6)),
128
+ };
129
+ await ctx.db.patch("usageOutbox", outbox._id, update);
130
+ if (result.status !== "unknown") {
131
+ const key = lockKeys(record).customer;
132
+ const lock = await ctx.db
133
+ .query("usageDeliveryLocks")
134
+ .withIndex("by_key", (q) => q.eq("key", key))
135
+ .unique();
136
+ if (lock?.eventId === args.eventId)
137
+ await ctx.db.patch("usageDeliveryLocks", lock._id, {
138
+ leaseUntil: 0,
139
+ eventId: undefined,
140
+ });
141
+ }
142
+ await appendDeliveryHistory(ctx, args.eventId, result.status, args.attempt, `result:${args.attempt}:${result.status}`, result.status === "accepted" ? result.created : undefined);
143
+ return statusOf((await read(ctx, args)).outbox);
144
+ },
145
+ });
146
+ export const exhaust = internalMutation({
147
+ args: refFields,
148
+ returns: v.null(),
149
+ handler: async (ctx, args) => {
150
+ const { outbox } = await read(ctx, args);
151
+ if (outbox.state === "queued") {
152
+ await ctx.db.patch("usageOutbox", outbox._id, {
153
+ state: "held",
154
+ reason: "retry_exhausted",
155
+ });
156
+ await appendDeliveryHistory(ctx, args.eventId, "retry_exhausted", outbox.attempts, `exhaust:${outbox.attempts}`);
157
+ }
158
+ return null;
159
+ },
160
+ });
161
+ //# sourceMappingURL=steps.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"steps.js","sourceRoot":"","sources":["../../../src/component/usageDelivery/steps.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ export declare const run: import("convex/server").RegisteredMutation<"internal", import("@convex-dev/workflow").WorkflowArgs<{
2
+ scope: import("convex/values").VObject<{
3
+ customerAccount: string;
4
+ livemode: boolean;
5
+ meterId: string;
6
+ stripeAccountId: string;
7
+ }, {
8
+ stripeAccountId: import("convex/values").VString<string, "required">;
9
+ customerAccount: import("convex/values").VString<string, "required">;
10
+ meterId: import("convex/values").VString<string, "required">;
11
+ livemode: import("convex/values").VBoolean<boolean, "required">;
12
+ }, "required", "customerAccount" | "livemode" | "meterId" | "stripeAccountId">;
13
+ eventId: import("convex/values").VId<import("convex/values").GenericId<"usageEvents">, "required">;
14
+ }>, import("@convex-dev/workflow").WorkflowMutationResult<null>>;
15
+ //# sourceMappingURL=workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/component/usageDelivery/workflow.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,GAAG;;;;;;;;;;;;;gEA+BZ,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { anyApi } from "convex/server";
2
+ import { executionWorkflow } from "../durableExecution/runtime.js";
3
+ import { refFields } from "./schema.js";
4
+ import { v } from "convex/values";
5
+ export const run = executionWorkflow
6
+ .define({ args: refFields, returns: v.null() })
7
+ .handler(async (step, args) => {
8
+ let sends = 0;
9
+ for (let turn = 0; turn < 40; turn++) {
10
+ const claimed = await step.runMutation(anyApi.usageDelivery.steps.claim, args, { name: `claim-${turn}` });
11
+ if (claimed.kind === "done")
12
+ return null;
13
+ if (claimed.kind === "wait") {
14
+ await step.sleep(claimed.delayMs);
15
+ continue;
16
+ }
17
+ const outcome = await step.runAction(anyApi.usageDelivery.bridge.invoke, claimed.request, { name: `provider-${turn}`, retry: false });
18
+ const saved = await step.runMutation(anyApi.usageDelivery.steps.save, { ...claimed.request, outcome }, { name: "save-receipt" });
19
+ sends++;
20
+ if (saved.state !== "queued")
21
+ return null;
22
+ if (sends >= 3)
23
+ break;
24
+ }
25
+ await step.runMutation(anyApi.usageDelivery.steps.exhaust, args);
26
+ return null;
27
+ });
28
+ //# sourceMappingURL=workflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/component/usageDelivery/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,MAAM,CAAC,MAAM,GAAG,GAAG,iBAAiB;KACjC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;KAC9C,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAiB,EAAE;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CACpC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAChC,IAAI,EACJ,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE,EAAE,CAC1B,CAAC;QACF,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAClC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAClC,OAAO,CAAC,OAAO,EACf,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAC3C,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAClC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAC/B,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAC/B,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CAAC;QACF,KAAK,EAAE,CAAC;QACR,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,KAAK,IAAI,CAAC;YAAE,MAAM;IACxB,CAAC;IACD,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC"}
@@ -0,0 +1,38 @@
1
+ import { observationOptions } from "../../client/usage/observationTypes.js";
2
+ export declare function source(json: string): Promise<{
3
+ opts: {
4
+ scope: {
5
+ stripeAccountId: string;
6
+ customerAccount: string;
7
+ meterId: string;
8
+ livemode: boolean;
9
+ };
10
+ binding: Omit<{
11
+ stripeCustomerId: string;
12
+ stripePriceId: string;
13
+ eventName: string;
14
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
15
+ plan: unknown;
16
+ }, "plan"> & {
17
+ plan: import("../../client/usage/contracts.js").UsagePlan;
18
+ };
19
+ subscription: {
20
+ subscriptionId: string;
21
+ subscriptionItemId: string;
22
+ stripePriceId: string;
23
+ period: {
24
+ start: number;
25
+ end: number;
26
+ };
27
+ interval: "month";
28
+ };
29
+ period: import("../../client/usage/boundaries.js").UsagePeriod;
30
+ limit: number;
31
+ cursor: string | null;
32
+ };
33
+ sourceJson: string;
34
+ scopeKey: string;
35
+ key: string;
36
+ }>;
37
+ export declare function observation(json: string, opts: ReturnType<typeof observationOptions>): string;
38
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAEnB,MAAM,wCAAwC,CAAC;AA8ChD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAWxC;AACD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,UA6B5C"}
@@ -0,0 +1,80 @@
1
+ import { z } from "zod";
2
+ import { canonicalFingerprint } from "../operationEvidence/canonical.js";
3
+ import { observationOptions, } from "../../client/usage/observationTypes.js";
4
+ import { scopeKey } from "../usage/helpers.js";
5
+ import { decimalFromScaled } from "../../client/usage/summary.js";
6
+ const integer = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
7
+ const period = z.strictObject({ start: integer, end: integer });
8
+ const scaled = z.string().regex(/^\d{1,30}$/), quantity = z.string().regex(/^\d{1,30}(\.\d{1,6})?$/);
9
+ const value = z.strictObject({
10
+ period,
11
+ quantity,
12
+ scaledQuantity: scaled,
13
+ complete: z.boolean(),
14
+ nextCursor: z.string().max(2048).nullable(),
15
+ aggregationLagPossible: z.literal(true),
16
+ stale: z.literal(false),
17
+ entries: z
18
+ .array(z.strictObject({
19
+ id: z.string().min(1).max(2048),
20
+ start: integer,
21
+ end: integer,
22
+ scaledQuantity: scaled,
23
+ }))
24
+ .max(100),
25
+ });
26
+ const availability = z.union([
27
+ z.strictObject({
28
+ status: z.literal("available"),
29
+ observedAt: integer,
30
+ value,
31
+ }),
32
+ z.strictObject({
33
+ status: z.enum(["unavailable", "unsupported"]),
34
+ reason: z.enum([
35
+ "minute_alignment_required",
36
+ "provider_binding_mismatch",
37
+ "unsupported_scope",
38
+ "aggregation_pending",
39
+ "provider_history_incomplete",
40
+ "provider_precision_unsupported",
41
+ "provider_unavailable",
42
+ ]),
43
+ retryable: z.boolean(),
44
+ }),
45
+ ]);
46
+ export async function source(json) {
47
+ if (new TextEncoder().encode(json).length > 8192)
48
+ throw new Error("Usage observation source exceeds limit");
49
+ const opts = observationOptions(JSON.parse(json));
50
+ const sourceJson = JSON.stringify(opts);
51
+ return {
52
+ opts,
53
+ sourceJson,
54
+ scopeKey: scopeKey(opts.scope),
55
+ key: await canonicalFingerprint(opts),
56
+ };
57
+ }
58
+ export function observation(json, opts) {
59
+ if (new TextEncoder().encode(json).length > 65536)
60
+ throw new Error("Invalid usage provider observation");
61
+ const parsed = availability.safeParse(JSON.parse(json));
62
+ if (!parsed.success)
63
+ throw new Error("Invalid usage provider observation");
64
+ const result = parsed.data;
65
+ if (result.status === "available") {
66
+ const v = result.value;
67
+ if (result.observedAt > Date.now() / 1000 + 300 ||
68
+ JSON.stringify(v.period) !== JSON.stringify(opts.period) ||
69
+ v.quantity !==
70
+ decimalFromScaled(BigInt(v.scaledQuantity), opts.binding.plan.unit.precision) ||
71
+ v.entries.reduce((sum, e) => sum + BigInt(e.scaledQuantity), 0n) !==
72
+ BigInt(v.scaledQuantity) ||
73
+ v.entries.some((e) => e.start < opts.period.start ||
74
+ e.end > opts.period.end ||
75
+ e.end <= e.start))
76
+ throw new Error("Invalid usage provider observation");
77
+ }
78
+ return JSON.stringify(result);
79
+ }
80
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/component/usageObservations/helpers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { MutationCtx } from "../_generated/server.js";
2
+ import type { Id } from "../_generated/dataModel.js";
3
+ import type { Infer } from "convex/values";
4
+ import type { historyPhase } from "./schema.js";
5
+ export declare function appendDeliveryHistory(ctx: MutationCtx, eventId: Id<"usageEvents">, phase: Infer<typeof historyPhase>, attempt: number, identity: string, created?: number): Promise<void>;
6
+ //# sourceMappingURL=history.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,EAC1B,KAAK,EAAE,KAAK,CAAC,OAAO,YAAY,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,iBA4BjB"}
@@ -0,0 +1,29 @@
1
+ export async function appendDeliveryHistory(ctx, eventId, phase, attempt, identity, created) {
2
+ const prior = await ctx.db
3
+ .query("usageDeliveryHistory")
4
+ .withIndex("by_event_identity", (q) => q.eq("eventId", eventId).eq("identity", identity))
5
+ .unique();
6
+ if (prior)
7
+ return;
8
+ const outbox = await ctx.db
9
+ .query("usageOutbox")
10
+ .withIndex("by_event", (q) => q.eq("eventId", eventId))
11
+ .unique();
12
+ if (!outbox)
13
+ throw new Error("Usage history event unavailable");
14
+ const sequence = (outbox.historySequence ?? 0) + 1;
15
+ if (!Number.isSafeInteger(sequence))
16
+ throw new Error("Usage history sequence exhausted");
17
+ await ctx.db.insert("usageDeliveryHistory", {
18
+ eventId,
19
+ scopeKey: outbox.scopeKey,
20
+ sequence,
21
+ attempt,
22
+ phase,
23
+ identity,
24
+ recordedAt: Math.floor(Date.now() / 1000),
25
+ ...(created !== undefined ? { created } : {}),
26
+ });
27
+ await ctx.db.patch("usageOutbox", outbox._id, { historySequence: sequence });
28
+ }
29
+ //# sourceMappingURL=history.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/component/usageObservations/history.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAgB,EAChB,OAA0B,EAC1B,KAAiC,EACjC,OAAe,EACf,QAAgB,EAChB,OAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACpC,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAClD;SACA,MAAM,EAAE,CAAC;IACZ,IAAI,KAAK;QAAE,OAAO;IAClB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;SACxB,KAAK,CAAC,aAAa,CAAC;SACpB,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SACtD,MAAM,EAAE,CAAC;IACZ,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE;QAC1C,OAAO;QACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ;QACR,OAAO;QACP,KAAK;QACL,QAAQ;QACR,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACzC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/E,CAAC"}
@@ -0,0 +1,6 @@
1
+ export declare const save: import("convex/server").RegisteredMutation<"public", {
2
+ observationJson: string;
3
+ sourceJson: string;
4
+ startedAt: number;
5
+ }, Promise<null>>;
6
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/mutations.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI;;;;iBAmCf,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { mutation } from "../_generated/server.js";
2
+ import { v } from "convex/values";
3
+ import { source, observation } from "./helpers.js";
4
+ export const save = mutation({
5
+ args: {
6
+ sourceJson: v.string(),
7
+ observationJson: v.string(),
8
+ startedAt: v.number(),
9
+ },
10
+ returns: v.null(),
11
+ handler: async (ctx, args) => {
12
+ if (!Number.isSafeInteger(args.startedAt) ||
13
+ args.startedAt < 0 ||
14
+ args.startedAt > Date.now() + 300000)
15
+ throw new Error("Invalid observation start time");
16
+ const binding = await source(args.sourceJson), observationJson = observation(args.observationJson, binding.opts);
17
+ const prior = await ctx.db
18
+ .query("usageProviderObservations")
19
+ .withIndex("by_key", (q) => q.eq("key", binding.key))
20
+ .unique();
21
+ if (prior && prior.sourceJson !== binding.sourceJson)
22
+ throw new Error("Usage observation binding conflict");
23
+ if (prior && prior.startedAt > args.startedAt)
24
+ return null;
25
+ const fields = {
26
+ key: binding.key,
27
+ scopeKey: binding.scopeKey,
28
+ sourceJson: binding.sourceJson,
29
+ observationJson,
30
+ startedAt: args.startedAt,
31
+ };
32
+ if (prior)
33
+ await ctx.db.patch("usageProviderObservations", prior._id, fields);
34
+ else
35
+ await ctx.db.insert("usageProviderObservations", fields);
36
+ return null;
37
+ },
38
+ });
39
+ //# sourceMappingURL=mutations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/usageObservations/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC;YACrC,IAAI,CAAC,SAAS,GAAG,CAAC;YAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM;YAEpC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAC3C,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;aACvB,KAAK,CAAC,2BAA2B,CAAC;aAClC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;aACpD,MAAM,EAAE,CAAC;QACZ,IAAI,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;YAClD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3D,MAAM,MAAM,GAAG;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,eAAe;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QACF,IAAI,KAAK;YACP,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;;YAChE,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,78 @@
1
+ export declare const summary: import("convex/server").RegisteredQuery<"public", {
2
+ maxRecords: number;
3
+ period: {
4
+ end: number;
5
+ start: number;
6
+ };
7
+ scope: {
8
+ customerAccount: string;
9
+ livemode: boolean;
10
+ meterId: string;
11
+ stripeAccountId: string;
12
+ };
13
+ }, Promise<string>>;
14
+ export declare const cached: import("convex/server").RegisteredQuery<"public", {
15
+ sourceJson: string;
16
+ }, Promise<string | null>>;
17
+ export declare const deliveryHistory: import("convex/server").RegisteredQuery<"public", {
18
+ eventId: import("convex/values").GenericId<"usageEvents">;
19
+ paginationOpts: {
20
+ id?: number;
21
+ endCursor?: string | null;
22
+ maximumRowsRead?: number;
23
+ maximumBytesRead?: number;
24
+ numItems: number;
25
+ cursor: string | null;
26
+ };
27
+ scope: {
28
+ customerAccount: string;
29
+ livemode: boolean;
30
+ meterId: string;
31
+ stripeAccountId: string;
32
+ };
33
+ }, Promise<{
34
+ page: {
35
+ _creationTime: number;
36
+ _id: import("convex/values").GenericId<"usageDeliveryHistory">;
37
+ attempt: number;
38
+ created?: number | undefined;
39
+ eventId: import("convex/values").GenericId<"usageEvents">;
40
+ identity: string;
41
+ phase: "accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired";
42
+ recordedAt: number;
43
+ scopeKey: string;
44
+ sequence: number;
45
+ }[];
46
+ isDone: boolean;
47
+ continueCursor: import("convex/server").Cursor;
48
+ splitCursor?: import("convex/server").Cursor | null;
49
+ pageStatus?: "SplitRecommended" | "SplitRequired" | null;
50
+ legacyHistoryMissing: boolean;
51
+ }>>;
52
+ export declare const validationHistory: import("convex/server").RegisteredQuery<"public", {
53
+ eventId: import("convex/values").GenericId<"usageEvents">;
54
+ paginationOpts: {
55
+ id?: number;
56
+ endCursor?: string | null;
57
+ maximumRowsRead?: number;
58
+ maximumBytesRead?: number;
59
+ numItems: number;
60
+ cursor: string | null;
61
+ };
62
+ scope: {
63
+ customerAccount: string;
64
+ livemode: boolean;
65
+ meterId: string;
66
+ stripeAccountId: string;
67
+ };
68
+ }, Promise<import("convex/server").PaginationResult<{
69
+ _creationTime: number;
70
+ _id: import("convex/values").GenericId<"usageDeliveryErrors">;
71
+ code: "archived_meter" | "meter_event_customer_not_found" | "meter_event_dimension_count_too_high" | "meter_event_invalid_value" | "meter_event_no_customer_defined" | "meter_event_value_not_found" | "no_meter" | "timestamp_in_future" | "timestamp_too_far_in_past";
72
+ dedupe: string;
73
+ eventId: import("convex/values").GenericId<"usageEvents">;
74
+ observedAt: number;
75
+ providerEventId: string;
76
+ scopeKey: string;
77
+ }>>>;
78
+ //# sourceMappingURL=queries.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/queries.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,OAAO;;;;;;;;;;;;mBAsDlB,CAAC;AAEH,eAAO,MAAM,MAAM;;0BAejB,CAAC;AAUH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4B1B,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;IAgB5B,CAAC"}