@fantastic.dev/better-stripe 0.56.0 → 0.58.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 (248) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +5 -1
  3. package/dist/client/billing/setup-intent-read.d.ts +12 -1
  4. package/dist/client/billing/setup-intent-read.d.ts.map +1 -1
  5. package/dist/client/billing/setup-intent-read.js +13 -8
  6. package/dist/client/billing/setup-intent-read.js.map +1 -1
  7. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +366 -2
  8. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +183 -1
  10. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  11. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +366 -2
  12. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  13. package/dist/client/connect/payoutSyncTestHelpers.d.ts +183 -1
  14. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  15. package/dist/client/index.d.ts +2 -12
  16. package/dist/client/index.d.ts.map +1 -1
  17. package/dist/client/index.js +3 -20
  18. package/dist/client/index.js.map +1 -1
  19. package/dist/client/types/triggers.d.ts +3 -1
  20. package/dist/client/types/triggers.d.ts.map +1 -1
  21. package/dist/client/usage/allowanceClient.d.ts +51 -0
  22. package/dist/client/usage/allowanceClient.d.ts.map +1 -0
  23. package/dist/client/usage/allowanceClient.js +64 -0
  24. package/dist/client/usage/allowanceClient.js.map +1 -0
  25. package/dist/client/usage/allowanceTerms.d.ts +64 -0
  26. package/dist/client/usage/allowanceTerms.d.ts.map +1 -0
  27. package/dist/client/usage/allowanceTerms.js +101 -0
  28. package/dist/client/usage/allowanceTerms.js.map +1 -0
  29. package/dist/client/usage/client.d.ts +2 -2
  30. package/dist/client/usage/client.d.ts.map +1 -1
  31. package/dist/client/usage/client.js +4 -4
  32. package/dist/client/usage/client.js.map +1 -1
  33. package/dist/client/usage/creditCapacity.d.ts +5 -0
  34. package/dist/client/usage/creditCapacity.d.ts.map +1 -0
  35. package/dist/client/usage/creditCapacity.js +47 -0
  36. package/dist/client/usage/creditCapacity.js.map +1 -0
  37. package/dist/client/usage/creditClient.d.ts +104 -0
  38. package/dist/client/usage/creditClient.d.ts.map +1 -0
  39. package/dist/client/usage/creditClient.js +111 -0
  40. package/dist/client/usage/creditClient.js.map +1 -0
  41. package/dist/client/usage/creditDelivery.d.ts +6 -0
  42. package/dist/client/usage/creditDelivery.d.ts.map +1 -0
  43. package/dist/client/usage/creditDelivery.js +71 -0
  44. package/dist/client/usage/creditDelivery.js.map +1 -0
  45. package/dist/client/usage/creditInvoice.d.ts +6 -0
  46. package/dist/client/usage/creditInvoice.d.ts.map +1 -0
  47. package/dist/client/usage/creditInvoice.js +63 -0
  48. package/dist/client/usage/creditInvoice.js.map +1 -0
  49. package/dist/client/usage/creditLifecycle.d.ts +14 -0
  50. package/dist/client/usage/creditLifecycle.d.ts.map +1 -0
  51. package/dist/client/usage/creditLifecycle.js +90 -0
  52. package/dist/client/usage/creditLifecycle.js.map +1 -0
  53. package/dist/client/usage/creditNative.d.ts +20 -0
  54. package/dist/client/usage/creditNative.d.ts.map +1 -0
  55. package/dist/client/usage/creditNative.js +100 -0
  56. package/dist/client/usage/creditNative.js.map +1 -0
  57. package/dist/client/usage/creditObservation.d.ts +23 -0
  58. package/dist/client/usage/creditObservation.d.ts.map +1 -0
  59. package/dist/client/usage/creditObservation.js +54 -0
  60. package/dist/client/usage/creditObservation.js.map +1 -0
  61. package/dist/client/usage/creditProofs.d.ts +50 -0
  62. package/dist/client/usage/creditProofs.d.ts.map +1 -0
  63. package/dist/client/usage/creditProofs.js +58 -0
  64. package/dist/client/usage/creditProofs.js.map +1 -0
  65. package/dist/client/usage/creditProvider.d.ts +11 -0
  66. package/dist/client/usage/creditProvider.d.ts.map +1 -0
  67. package/dist/client/usage/creditProvider.js +195 -0
  68. package/dist/client/usage/creditProvider.js.map +1 -0
  69. package/dist/client/usage/creditRead.d.ts +47 -0
  70. package/dist/client/usage/creditRead.d.ts.map +1 -0
  71. package/dist/client/usage/creditRead.js +18 -0
  72. package/dist/client/usage/creditRead.js.map +1 -0
  73. package/dist/client/usage/creditReconciliation.d.ts +20 -0
  74. package/dist/client/usage/creditReconciliation.d.ts.map +1 -0
  75. package/dist/client/usage/creditReconciliation.js +157 -0
  76. package/dist/client/usage/creditReconciliation.js.map +1 -0
  77. package/dist/client/usage/creditTerms.d.ts +89 -0
  78. package/dist/client/usage/creditTerms.d.ts.map +1 -0
  79. package/dist/client/usage/creditTerms.js +76 -0
  80. package/dist/client/usage/creditTerms.js.map +1 -0
  81. package/dist/client/usage/creditTransport.fixtures.d.ts +101 -0
  82. package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -0
  83. package/dist/client/usage/creditTransport.fixtures.js +271 -0
  84. package/dist/client/usage/creditTransport.fixtures.js.map +1 -0
  85. package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
  86. package/dist/client/usage/deliveryProvider.js +2 -0
  87. package/dist/client/usage/deliveryProvider.js.map +1 -1
  88. package/dist/client/usage/index.d.ts +4 -0
  89. package/dist/client/usage/index.d.ts.map +1 -1
  90. package/dist/client/usage/index.js +1 -0
  91. package/dist/client/usage/index.js.map +1 -1
  92. package/dist/client/usage/records.d.ts +2 -0
  93. package/dist/client/usage/records.d.ts.map +1 -1
  94. package/dist/client/usage/records.js +22 -0
  95. package/dist/client/usage/records.js.map +1 -1
  96. package/dist/client/usage/subscriptionTransport.fixtures.d.ts +1 -1
  97. package/dist/client/usage/subscriptionTransport.fixtures.d.ts.map +1 -1
  98. package/dist/client/usage/subscriptionTransport.fixtures.js +4 -1
  99. package/dist/client/usage/subscriptionTransport.fixtures.js.map +1 -1
  100. package/dist/client/usage/summary.js +2 -2
  101. package/dist/client/usage/summary.js.map +1 -1
  102. package/dist/client/usageExports.d.ts +16 -0
  103. package/dist/client/usageExports.d.ts.map +1 -0
  104. package/dist/client/usageExports.js +3 -0
  105. package/dist/client/usageExports.js.map +1 -0
  106. package/dist/client/webhooks/subscriptionDeleted.d.ts +5 -0
  107. package/dist/client/webhooks/subscriptionDeleted.d.ts.map +1 -0
  108. package/dist/client/webhooks/subscriptionDeleted.js +34 -0
  109. package/dist/client/webhooks/subscriptionDeleted.js.map +1 -0
  110. package/dist/component/_generated/api.d.ts +18 -0
  111. package/dist/component/_generated/api.d.ts.map +1 -1
  112. package/dist/component/_generated/api.js.map +1 -1
  113. package/dist/component/_generated/component.d.ts +360 -0
  114. package/dist/component/_generated/component.d.ts.map +1 -1
  115. package/dist/component/accountClosure/mutations.d.ts.map +1 -1
  116. package/dist/component/accountClosure/mutations.js +10 -0
  117. package/dist/component/accountClosure/mutations.js.map +1 -1
  118. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  119. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  120. package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
  121. package/dist/component/balanceFunding/queries.d.ts +1 -1
  122. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  123. package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
  124. package/dist/component/earnings/triggers.d.ts +352 -18
  125. package/dist/component/earnings/triggers.d.ts.map +1 -1
  126. package/dist/component/payoutRelease/queries.d.ts +2 -2
  127. package/dist/component/payoutRelease/queries.d.ts.map +1 -1
  128. package/dist/component/schema.d.ts +183 -1
  129. package/dist/component/schema.js +8 -0
  130. package/dist/component/schema.js.map +1 -1
  131. package/dist/component/usage/mutations.d.ts.map +1 -1
  132. package/dist/component/usage/mutations.js +7 -0
  133. package/dist/component/usage/mutations.js.map +1 -1
  134. package/dist/component/usage/schema.d.ts +15 -1
  135. package/dist/component/usage/schema.d.ts.map +1 -1
  136. package/dist/component/usage/schema.js +12 -0
  137. package/dist/component/usage/schema.js.map +1 -1
  138. package/dist/component/usageAllowance/helpers.d.ts +78 -0
  139. package/dist/component/usageAllowance/helpers.d.ts.map +1 -0
  140. package/dist/component/usageAllowance/helpers.js +99 -0
  141. package/dist/component/usageAllowance/helpers.js.map +1 -0
  142. package/dist/component/usageAllowance/mutations.d.ts +37 -0
  143. package/dist/component/usageAllowance/mutations.d.ts.map +1 -0
  144. package/dist/component/usageAllowance/mutations.js +99 -0
  145. package/dist/component/usageAllowance/mutations.js.map +1 -0
  146. package/dist/component/usageAllowance/queries.d.ts +36 -0
  147. package/dist/component/usageAllowance/queries.d.ts.map +1 -0
  148. package/dist/component/usageAllowance/queries.js +113 -0
  149. package/dist/component/usageAllowance/queries.js.map +1 -0
  150. package/dist/component/usageAllowance/reservations.d.ts +25 -0
  151. package/dist/component/usageAllowance/reservations.d.ts.map +1 -0
  152. package/dist/component/usageAllowance/reservations.js +150 -0
  153. package/dist/component/usageAllowance/reservations.js.map +1 -0
  154. package/dist/component/usageAllowance/schema.d.ts +77 -0
  155. package/dist/component/usageAllowance/schema.d.ts.map +1 -0
  156. package/dist/component/usageAllowance/schema.js +32 -0
  157. package/dist/component/usageAllowance/schema.js.map +1 -0
  158. package/dist/component/usageCredits/helpers.d.ts +205 -0
  159. package/dist/component/usageCredits/helpers.d.ts.map +1 -0
  160. package/dist/component/usageCredits/helpers.js +129 -0
  161. package/dist/component/usageCredits/helpers.js.map +1 -0
  162. package/dist/component/usageCredits/mutations.d.ts +80 -0
  163. package/dist/component/usageCredits/mutations.d.ts.map +1 -0
  164. package/dist/component/usageCredits/mutations.js +344 -0
  165. package/dist/component/usageCredits/mutations.js.map +1 -0
  166. package/dist/component/usageCredits/purchase.d.ts +23 -0
  167. package/dist/component/usageCredits/purchase.d.ts.map +1 -0
  168. package/dist/component/usageCredits/purchase.js +166 -0
  169. package/dist/component/usageCredits/purchase.js.map +1 -0
  170. package/dist/component/usageCredits/queries.d.ts +184 -0
  171. package/dist/component/usageCredits/queries.d.ts.map +1 -0
  172. package/dist/component/usageCredits/queries.js +243 -0
  173. package/dist/component/usageCredits/queries.js.map +1 -0
  174. package/dist/component/usageCredits/reservations.d.ts +16 -0
  175. package/dist/component/usageCredits/reservations.d.ts.map +1 -0
  176. package/dist/component/usageCredits/reservations.js +161 -0
  177. package/dist/component/usageCredits/reservations.js.map +1 -0
  178. package/dist/component/usageCredits/schema.d.ts +282 -0
  179. package/dist/component/usageCredits/schema.d.ts.map +1 -0
  180. package/dist/component/usageCredits/schema.js +92 -0
  181. package/dist/component/usageCredits/schema.js.map +1 -0
  182. package/docs/README.md +4 -0
  183. package/docs/setup-intent-recovery.md +7 -0
  184. package/docs/usage-credits.md +255 -0
  185. package/docs/usage-ledger.md +7 -0
  186. package/docs/usage-limits.md +217 -0
  187. package/docs/webhooks.md +15 -1
  188. package/package.json +3 -1
  189. package/src/client/billing/setup-intent-read.test.ts +40 -0
  190. package/src/client/billing/setup-intent-read.ts +23 -9
  191. package/src/client/index.ts +9 -67
  192. package/src/client/types/triggers.ts +2 -0
  193. package/src/client/usage/allowanceClient.test.ts +93 -0
  194. package/src/client/usage/allowanceClient.ts +134 -0
  195. package/src/client/usage/allowanceTerms.test.ts +131 -0
  196. package/src/client/usage/allowanceTerms.ts +172 -0
  197. package/src/client/usage/client.ts +4 -4
  198. package/src/client/usage/creditCapacity.test.ts +83 -0
  199. package/src/client/usage/creditCapacity.ts +76 -0
  200. package/src/client/usage/creditClient.test.ts +221 -0
  201. package/src/client/usage/creditClient.ts +246 -0
  202. package/src/client/usage/creditDelivery.ts +105 -0
  203. package/src/client/usage/creditInvoice.test.ts +149 -0
  204. package/src/client/usage/creditInvoice.ts +87 -0
  205. package/src/client/usage/creditLifecycle.ts +175 -0
  206. package/src/client/usage/creditNative.ts +148 -0
  207. package/src/client/usage/creditObservation.test.ts +150 -0
  208. package/src/client/usage/creditObservation.ts +82 -0
  209. package/src/client/usage/creditProofs.ts +61 -0
  210. package/src/client/usage/creditProvider.test.ts +202 -0
  211. package/src/client/usage/creditProvider.ts +304 -0
  212. package/src/client/usage/creditRead.ts +32 -0
  213. package/src/client/usage/creditReconciliation.ts +213 -0
  214. package/src/client/usage/creditTerms.test.ts +48 -0
  215. package/src/client/usage/creditTerms.ts +140 -0
  216. package/src/client/usage/creditTransport.fixtures.ts +282 -0
  217. package/src/client/usage/deliveryProvider.ts +2 -0
  218. package/src/client/usage/index.ts +16 -0
  219. package/src/client/usage/record-composition.test.ts +195 -0
  220. package/src/client/usage/records.ts +26 -0
  221. package/src/client/usage/subscriptionTransport.fixtures.ts +6 -0
  222. package/src/client/usage/summary.test.ts +1 -1
  223. package/src/client/usage/summary.ts +2 -2
  224. package/src/client/usageExports.ts +56 -0
  225. package/src/client/webhook-handlers.test.ts +0 -34
  226. package/src/client/webhooks/subscription-deleted-dispatch.test.ts +61 -0
  227. package/src/client/webhooks/subscription-deleted.integration.test.ts +313 -0
  228. package/src/client/webhooks/subscriptionDeleted.ts +56 -0
  229. package/src/component/_generated/api.ts +18 -0
  230. package/src/component/_generated/component.ts +486 -0
  231. package/src/component/accountClosure/mutations.ts +14 -0
  232. package/src/component/schema.ts +16 -0
  233. package/src/component/usage/allowance.test.ts +435 -0
  234. package/src/component/usage/ledger.test.ts +8 -15
  235. package/src/component/usage/mutations.ts +22 -0
  236. package/src/component/usage/schema.ts +14 -0
  237. package/src/component/usageAllowance/helpers.ts +137 -0
  238. package/src/component/usageAllowance/mutations.ts +139 -0
  239. package/src/component/usageAllowance/queries.ts +133 -0
  240. package/src/component/usageAllowance/reservations.ts +220 -0
  241. package/src/component/usageAllowance/schema.ts +36 -0
  242. package/src/component/usageCredits/accounting.test.ts +389 -0
  243. package/src/component/usageCredits/helpers.ts +160 -0
  244. package/src/component/usageCredits/mutations.ts +451 -0
  245. package/src/component/usageCredits/purchase.ts +219 -0
  246. package/src/component/usageCredits/queries.ts +300 -0
  247. package/src/component/usageCredits/reservations.ts +214 -0
  248. package/src/component/usageCredits/schema.ts +106 -0
@@ -0,0 +1,157 @@
1
+ import { findCreditPurchase } from "./creditRead.js";
2
+ import { runMutationOrThrow } from "../helpers.js";
3
+ import { componentRef } from "../webhooks/helpers.js";
4
+ import { creditPurchaseTerms, UsageCreditRecoveryError, } from "./creditTerms.js";
5
+ import { creditCall, creditRequire, verifyCreditRealm, paymentIdentity, verifiedCreditPayment, } from "./creditNative.js";
6
+ import { observeCreditPurchase } from "./creditProvider.js";
7
+ import { verifyCreditInvoice } from "./creditInvoice.js";
8
+ import { creditNativeObservation } from "./creditProofs.js";
9
+ const id = (v) => typeof v === "string" ? v : v?.id;
10
+ export async function reconcileCreditPurchase(stripe, component, ctx, input) {
11
+ return creditCall(async () => {
12
+ const terms = creditPurchaseTerms(input), startedAt = Date.now();
13
+ let source = await findCreditPurchase(component, ctx, input);
14
+ if (!source.row.creditGrantId) {
15
+ await observeCreditPurchase(stripe, component, ctx, input);
16
+ source = await findCreditPurchase(component, ctx, input);
17
+ }
18
+ const purchase = source.row;
19
+ if (!purchase.creditGrantId || !purchase.paymentIntentId)
20
+ return {
21
+ status: "unavailable",
22
+ reason: "credit_purchase_not_ready",
23
+ retryable: true,
24
+ };
25
+ await verifyCreditRealm(stripe, terms, false);
26
+ const payment = await stripe.paymentIntents.retrieve(purchase.paymentIntentId, { expand: ["latest_charge"] });
27
+ paymentIdentity(payment, terms, purchase.key, purchase.paymentIntentId);
28
+ try {
29
+ creditRequire(verifiedCreditPayment(payment, terms), "Original credit payment not successful");
30
+ }
31
+ catch (error) {
32
+ if (!(error instanceof UsageCreditRecoveryError))
33
+ throw error;
34
+ await runMutationOrThrow(ctx, componentRef(component, "usageCredits/mutations/freezePurchase"), {
35
+ key: purchase.key,
36
+ paymentIntentId: purchase.paymentIntentId,
37
+ reason: error.reason,
38
+ refundedAmount: typeof payment.latest_charge === "object"
39
+ ? payment.latest_charge?.amount_refunded
40
+ : undefined,
41
+ });
42
+ }
43
+ const nativeGrant = await stripe.billing.creditGrants.retrieve(purchase.creditGrantId);
44
+ creditRequire(nativeGrant.id === purchase.creditGrantId &&
45
+ nativeGrant.customer_account === terms.scope.customerAccount &&
46
+ nativeGrant.livemode === terms.scope.livemode &&
47
+ nativeGrant.metadata?.bsUsageCredit === purchase.key &&
48
+ nativeGrant.amount.monetary?.value === terms.amount &&
49
+ nativeGrant.amount.monetary.currency ===
50
+ terms.binding.plan.rate.currency &&
51
+ nativeGrant.applicability_config.scope.prices?.length === 1 &&
52
+ nativeGrant.applicability_config.scope.prices[0].id ===
53
+ terms.binding.stripePriceId, "Original native credit grant identity mismatch");
54
+ const [summary, transactions] = await Promise.all([
55
+ stripe.billing.creditBalanceSummaries.retrieve({
56
+ customer_account: terms.scope.customerAccount,
57
+ filter: { type: "credit_grant", credit_grant: purchase.creditGrantId },
58
+ }),
59
+ stripe.billing.creditBalanceTransactions.list({
60
+ customer_account: terms.scope.customerAccount,
61
+ credit_grant: purchase.creditGrantId,
62
+ limit: 100,
63
+ }),
64
+ ]);
65
+ creditRequire(summary.livemode === terms.scope.livemode &&
66
+ summary.customer_account === terms.scope.customerAccount &&
67
+ id(summary.customer) === terms.binding.stripeCustomerId &&
68
+ summary.balances.length === 1, "Native credit summary scope mismatch");
69
+ const row = summary.balances[0], ledger = row.ledger_balance.monetary, available = row.available_balance.monetary;
70
+ creditRequire(ledger &&
71
+ available &&
72
+ ledger.currency === terms.binding.plan.rate.currency &&
73
+ available.currency === ledger.currency, "Native credit summary currency mismatch");
74
+ let granted = 0, applied = 0, expired = 0, voided = 0, reinstated = 0;
75
+ let invoicesVerified = true;
76
+ const normalized = [];
77
+ const invoiceProofBudget = transactions.data.filter((t) => t.debit?.type === "credits_applied")
78
+ .length <= 10;
79
+ for (const tx of transactions.data) {
80
+ creditRequire(id(tx.credit_grant) === purchase.creditGrantId &&
81
+ tx.livemode === terms.scope.livemode &&
82
+ tx.object === "billing.credit_balance_transaction", "Native credit transaction identity mismatch");
83
+ const entry = tx.type === "credit"
84
+ ? tx.credit
85
+ : tx.type === "debit"
86
+ ? tx.debit
87
+ : null;
88
+ const amount = entry?.amount.monetary;
89
+ creditRequire(entry &&
90
+ amount &&
91
+ amount.currency === ledger.currency &&
92
+ Number.isSafeInteger(amount.value) &&
93
+ amount.value >= 0, "Native credit transaction amount unsupported");
94
+ const kind = entry.type;
95
+ let invoiceId = null, invoiceLineId = null;
96
+ if (kind === "credits_granted")
97
+ granted += amount.value;
98
+ else if (kind === "credits_applied") {
99
+ applied += amount.value;
100
+ invoiceId = id(tx.debit?.credits_applied?.invoice) ?? null;
101
+ invoiceLineId = tx.debit?.credits_applied?.invoice_line_item ?? null;
102
+ if (!invoiceProofBudget ||
103
+ !(await verifyCreditInvoice(stripe, component, ctx, terms, tx)))
104
+ invoicesVerified = false;
105
+ }
106
+ else if (kind === "credits_expired")
107
+ expired += amount.value;
108
+ else if (kind === "credits_voided")
109
+ voided += amount.value;
110
+ else if (kind === "credits_application_invoice_voided") {
111
+ reinstated += amount.value;
112
+ invoicesVerified = false;
113
+ invoiceId =
114
+ id(tx.credit?.credits_application_invoice_voided?.invoice) ?? null;
115
+ invoiceLineId =
116
+ tx.credit?.credits_application_invoice_voided?.invoice_line_item ??
117
+ null;
118
+ }
119
+ else
120
+ creditRequire(false, "Unsupported native credit transaction type");
121
+ normalized.push({
122
+ id: tx.id,
123
+ kind,
124
+ amount: amount.value,
125
+ invoiceId,
126
+ invoiceLineId,
127
+ });
128
+ }
129
+ const proof = creditNativeObservation.parse({
130
+ creditGrantId: purchase.creditGrantId,
131
+ paymentIntentId: purchase.paymentIntentId,
132
+ currency: ledger.currency,
133
+ ledgerAmount: ledger.value,
134
+ availableAmount: available.value,
135
+ granted,
136
+ applied,
137
+ expired,
138
+ voided,
139
+ reinstated,
140
+ invoicesVerified,
141
+ complete: !transactions.has_more,
142
+ transactions: normalized,
143
+ });
144
+ const resultJson = (await runMutationOrThrow(ctx, componentRef(component, "usageCredits/mutations/saveObservation"), {
145
+ inputJson: JSON.stringify(input),
146
+ proofJson: JSON.stringify(proof),
147
+ startedAt,
148
+ }));
149
+ const result = JSON.parse(resultJson);
150
+ return {
151
+ status: "available",
152
+ observedAt: Math.floor(startedAt / 1000),
153
+ value: result,
154
+ };
155
+ });
156
+ }
157
+ //# sourceMappingURL=creditReconciliation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditReconciliation.js","sourceRoot":"","sources":["../../../src/client/usage/creditReconciliation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ import { type PreparedUsageRecord, type UsageScope } from "./records.js";
2
+ import { type UsagePlan } from "./contracts.js";
3
+ export declare class UsageCreditError extends Error {
4
+ readonly code: "unsupported_scope" | "incompatible_terms" | "insufficient_credits" | "reconciliation_required" | "unknown_create_outcome" | "provider_unavailable";
5
+ constructor(code: "unsupported_scope" | "incompatible_terms" | "insufficient_credits" | "reconciliation_required" | "unknown_create_outcome" | "provider_unavailable", message: string);
6
+ }
7
+ export type UsageCreditBinding = {
8
+ scope: UsageScope;
9
+ binding: Omit<PreparedUsageRecord["binding"], "apiVersion"> & {
10
+ apiVersion?: string;
11
+ };
12
+ };
13
+ export type UsageCreditPurchaseOptions = UsageCreditBinding & {
14
+ purchaseId: string;
15
+ quantity: string;
16
+ ownership: "issuer";
17
+ rollover: "retain_original_terms";
18
+ expiresAt?: number;
19
+ };
20
+ /** Quantity accounting is price-specific. No monetary wallet or currency conversion. */
21
+ export declare function creditCost(plan: UsagePlan, scaledQuantity: string): number;
22
+ export declare function creditBinding(input: UsageCreditBinding): {
23
+ scope: {
24
+ stripeAccountId: string;
25
+ customerAccount: string;
26
+ meterId: string;
27
+ livemode: boolean;
28
+ };
29
+ binding: Omit<{
30
+ stripeCustomerId: string;
31
+ stripePriceId: string;
32
+ eventName: string;
33
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
34
+ plan: unknown;
35
+ }, "plan"> & {
36
+ plan: UsagePlan;
37
+ };
38
+ };
39
+ export declare function creditPurchaseTerms(input: unknown): {
40
+ purchaseId: string;
41
+ ownership: "issuer";
42
+ rollover: "retain_original_terms";
43
+ expiresAt?: number | undefined;
44
+ scope: {
45
+ stripeAccountId: string;
46
+ customerAccount: string;
47
+ meterId: string;
48
+ livemode: boolean;
49
+ };
50
+ binding: Omit<{
51
+ stripeCustomerId: string;
52
+ stripePriceId: string;
53
+ eventName: string;
54
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
55
+ plan: unknown;
56
+ }, "plan"> & {
57
+ plan: UsagePlan;
58
+ };
59
+ quantity: string;
60
+ scaledQuantity: string;
61
+ amount: number;
62
+ };
63
+ export type UsageCreditPurchaseTerms = ReturnType<typeof creditPurchaseTerms>;
64
+ export type UsageCreditBalance = {
65
+ availableQuantity: string;
66
+ reservedQuantity: string;
67
+ consumedQuantity: string;
68
+ expiredQuantity: string;
69
+ frozenQuantity: string;
70
+ precision: number;
71
+ currency: string;
72
+ unit: string;
73
+ status: "available" | "held";
74
+ cashCollection: "none";
75
+ };
76
+ export type UsageCreditPurchase = {
77
+ purchaseId: string;
78
+ state: "pending" | "ready" | "frozen" | "canceled";
79
+ paymentIntentId: string | null;
80
+ creditGrantId: string | null;
81
+ quantity: string;
82
+ amount: number;
83
+ currency: string;
84
+ };
85
+ export declare class UsageCreditRecoveryError extends UsageCreditError {
86
+ readonly reason: "payment_refunded" | "payment_disputed";
87
+ constructor(reason: "payment_refunded" | "payment_disputed");
88
+ }
89
+ //# sourceMappingURL=creditTerms.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditTerms.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditTerms.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpE,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,IAAI,EACT,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,sBAAsB;IAP5B,YACW,IAAI,EACT,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,sBAAsB,EAC1B,OAAO,EAAE,MAAM,EAIhB;CACF;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,GAAG;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAeF,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAqB1E;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;EAWtD;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;EAwBjD;AACD,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC9E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,wBAAyB,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB;IAApE,YAAqB,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,EAKnE;CACF"}
@@ -0,0 +1,76 @@
1
+ import { z } from "zod";
2
+ import { prepareUsageRecord, } from "./records.js";
3
+ import { parseUsageQuantity } from "./contracts.js";
4
+ export class UsageCreditError extends Error {
5
+ code;
6
+ constructor(code, message) {
7
+ super(message);
8
+ this.code = code;
9
+ this.name = "UsageCreditError";
10
+ }
11
+ }
12
+ const options = z.strictObject({
13
+ scope: z.unknown(),
14
+ binding: z.unknown(),
15
+ purchaseId: z.string().min(1).max(100),
16
+ quantity: z.string().max(25),
17
+ ownership: z.literal("issuer"),
18
+ rollover: z.literal("retain_original_terms"),
19
+ expiresAt: z
20
+ .number()
21
+ .int()
22
+ .positive()
23
+ .max(Number.MAX_SAFE_INTEGER)
24
+ .optional(),
25
+ });
26
+ /** Quantity accounting is price-specific. No monetary wallet or currency conversion. */
27
+ export function creditCost(plan, scaledQuantity) {
28
+ if (plan.model !== "prepaid" || !/^\d{1,18}$/.test(scaledQuantity))
29
+ throw new UsageCreditError("incompatible_terms", "Original prepaid terms required");
30
+ const [whole, fraction = ""] = plan.rate.unitAmountDecimal.split(".");
31
+ const numerator = BigInt(whole + fraction) * BigInt(scaledQuantity);
32
+ const denominator = 10n ** BigInt(fraction.length + plan.unit.precision);
33
+ if (numerator <= 0n || numerator % denominator !== 0n)
34
+ throw new UsageCreditError("incompatible_terms", "Prepaid consumption requires whole minor currency units");
35
+ const amount = numerator / denominator;
36
+ if (amount > 99999999n)
37
+ throw new UsageCreditError("incompatible_terms", "Prepaid backing exceeds native payment bound");
38
+ return Number(amount);
39
+ }
40
+ export function creditBinding(input) {
41
+ const { scope, binding } = prepareUsageRecord({
42
+ scope: input.scope,
43
+ binding: input.binding,
44
+ sourceEventId: "credit",
45
+ quantity: "0",
46
+ occurredAt: 0,
47
+ });
48
+ if (binding.plan.model !== "prepaid")
49
+ throw new UsageCreditError("incompatible_terms", "Prepaid plan required");
50
+ return { scope, binding };
51
+ }
52
+ export function creditPurchaseTerms(input) {
53
+ if (input &&
54
+ typeof input === "object" &&
55
+ "ownership" in input &&
56
+ input.ownership !== "issuer")
57
+ throw new UsageCreditError("unsupported_scope", "Native credits support only the issuer's own services");
58
+ const parsed = options.parse(input);
59
+ const original = creditBinding(parsed);
60
+ const quantity = parseUsageQuantity(parsed.quantity, original.binding.plan.unit.precision);
61
+ return {
62
+ ...parsed,
63
+ ...original,
64
+ quantity: quantity.quantity,
65
+ scaledQuantity: quantity.scaledQuantity,
66
+ amount: creditCost(original.binding.plan, quantity.scaledQuantity),
67
+ };
68
+ }
69
+ export class UsageCreditRecoveryError extends UsageCreditError {
70
+ reason;
71
+ constructor(reason) {
72
+ super("reconciliation_required", "Credit payment refund or dispute requires recovery");
73
+ this.reason = reason;
74
+ }
75
+ }
76
+ //# sourceMappingURL=creditTerms.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditTerms.js","sourceRoot":"","sources":["../../../src/client/usage/creditTerms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,kBAAkB,GAGnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAkB,MAAM,gBAAgB,CAAC;AACpE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAE9B,IAAI;IADf,YACW,IAMiB,EAC1B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;oBATN,IAAI;QAUb,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAcD,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IAC5C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;SAC5B,QAAQ,EAAE;CACd,CAAC,CAAC;AACH,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,cAAsB;IAChE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC;QAChE,MAAM,IAAI,gBAAgB,CACxB,oBAAoB,EACpB,iCAAiC,CAClC,CAAC;IACJ,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzE,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,GAAG,WAAW,KAAK,EAAE;QACnD,MAAM,IAAI,gBAAgB,CACxB,oBAAoB,EACpB,yDAAyD,CAC1D,CAAC;IACJ,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IACvC,IAAI,MAAM,GAAG,SAAS;QACpB,MAAM,IAAI,gBAAgB,CACxB,oBAAoB,EACpB,8CAA8C,CAC/C,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC;QAC5C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,aAAa,EAAE,QAAQ;QACvB,QAAQ,EAAE,GAAG;QACb,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS;QAClC,MAAM,IAAI,gBAAgB,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAC;IAC5E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,WAAW,IAAI,KAAK;QACpB,KAAK,CAAC,SAAS,KAAK,QAAQ;QAE5B,MAAM,IAAI,gBAAgB,CACxB,mBAAmB,EACnB,uDAAuD,CACxD,CAAC;IACJ,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAoC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,kBAAkB,CACjC,MAAM,CAAC,QAAQ,EACf,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CACrC,CAAC;IACF,OAAO;QACL,GAAG,MAAM;QACT,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;KACnE,CAAC;AACJ,CAAC;AAwBD,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IACvC,MAAM;IAA3B,YAAqB,MAA+C;QAClE,KAAK,CACH,yBAAyB,EACzB,oDAAoD,CACrD,CAAC;sBAJiB,MAAM;IAK3B,CAAC;CACF"}
@@ -0,0 +1,101 @@
1
+ export declare function creditFixture(): {
2
+ t: ReturnType<typeof import("../setup.test.js").initConvexTest>;
3
+ component: import("../helpers.js").Component;
4
+ stripe: import("stripe").Stripe;
5
+ httpClient: import("stripe").Stripe.HttpClient;
6
+ calls: {
7
+ path: string;
8
+ method: string;
9
+ body: URLSearchParams;
10
+ key: string | null;
11
+ }[];
12
+ state: {
13
+ paid: boolean;
14
+ nativeApplied: number;
15
+ nativeAvailable: number | undefined;
16
+ applyAtExpire: boolean;
17
+ nativeExpired: boolean;
18
+ incomplete: boolean;
19
+ canceled: boolean;
20
+ refunded: boolean;
21
+ failGrant: boolean;
22
+ wrongPayer: boolean;
23
+ paymentId: string;
24
+ grant: Record<string, unknown> | undefined;
25
+ metadata: Record<string, string>;
26
+ };
27
+ purchase: {
28
+ scope: {
29
+ stripeAccountId: string;
30
+ customerAccount: string;
31
+ meterId: string;
32
+ livemode: boolean;
33
+ };
34
+ binding: {
35
+ stripeCustomerId: string;
36
+ stripePriceId: string;
37
+ eventName: string;
38
+ plan: {
39
+ key: string;
40
+ version: string;
41
+ model: "prepaid";
42
+ unit: {
43
+ name: string;
44
+ precision: number;
45
+ };
46
+ rate: {
47
+ currency: string;
48
+ unitAmountDecimal: string;
49
+ };
50
+ insufficientBalance: "reject";
51
+ };
52
+ };
53
+ purchaseId: string;
54
+ quantity: string;
55
+ ownership: "issuer";
56
+ rollover: "retain_original_terms";
57
+ };
58
+ ready: () => Promise<{
59
+ subscriptionId: string;
60
+ status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
61
+ currency: string;
62
+ billingMode: "flexible";
63
+ collection: {
64
+ method: "charge_automatically" | "send_invoice";
65
+ daysUntilDue: number | null;
66
+ defaultPaymentMethod: string | null;
67
+ };
68
+ cancelAtPeriodEnd: boolean;
69
+ cancelAt: number | null;
70
+ items: {
71
+ id: string;
72
+ stripePriceId: string;
73
+ meterId: string | null;
74
+ period: {
75
+ start: number;
76
+ end: number;
77
+ };
78
+ quantity: string | null;
79
+ unitAmountDecimal: string | null;
80
+ }[];
81
+ bindings: {
82
+ scope: {
83
+ stripeAccountId: string;
84
+ customerAccount: string;
85
+ meterId: string;
86
+ livemode: boolean;
87
+ };
88
+ binding: Omit<{
89
+ stripeCustomerId: string;
90
+ stripePriceId: string;
91
+ eventName: string;
92
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
93
+ plan: unknown;
94
+ }, "plan"> & {
95
+ plan: import("./contracts.js").UsagePlan;
96
+ };
97
+ subscription: import("./boundaries.js").UsageSubscriptionBinding;
98
+ }[];
99
+ }>;
100
+ };
101
+ //# sourceMappingURL=creditTransport.fixtures.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditTransport.fixtures.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditTransport.fixtures.ts"],"names":[],"mappings":"AASA,wBAAgB,aAAa;;;;;;cAInB,MAAM;gBACJ,MAAM;cACR,eAAe;aAChB,MAAM,GAAG,IAAI;;;;;yBAKY,MAAM,GAAG,SAAS;;;;;;;;;eAS5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;kBACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;gBAkOlC,GAAG;gBACH,OAAO;gBACP,KAAK,EAAE,SAAS;gBAChB,IAAI;oBAAI,IAAI;oBAAU,SAAS;;gBAC/B,IAAI;oBAAI,QAAQ;oBAAS,iBAAiB;;gBAC1C,mBAAmB,EAAE,QAAQ;;;;;mBAQtB,QAAQ;kBACT,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpC"}