@fantastic.dev/better-stripe 0.58.0 → 0.60.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 (294) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +3 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +888 -62
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +428 -15
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +856 -30
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +444 -31
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +4 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/paymentSource/resolver.d.ts +12 -1
  14. package/dist/client/paymentSource/resolver.d.ts.map +1 -1
  15. package/dist/client/paymentSource/resolver.fixtures.d.ts +220 -0
  16. package/dist/client/paymentSource/resolver.fixtures.d.ts.map +1 -0
  17. package/dist/client/paymentSource/resolver.fixtures.js +189 -0
  18. package/dist/client/paymentSource/resolver.fixtures.js.map +1 -0
  19. package/dist/client/paymentSource/resolver.js +28 -3
  20. package/dist/client/paymentSource/resolver.js.map +1 -1
  21. package/dist/client/settlement/execution.d.ts +25 -0
  22. package/dist/client/settlement/execution.d.ts.map +1 -1
  23. package/dist/client/settlement/execution.js +2 -0
  24. package/dist/client/settlement/execution.js.map +1 -1
  25. package/dist/client/usage/allowanceClient.d.ts +1 -1
  26. package/dist/client/usage/catalogPrices.d.ts +1 -1
  27. package/dist/client/usage/catalogPrices.d.ts.map +1 -1
  28. package/dist/client/usage/catalogPrices.js +4 -4
  29. package/dist/client/usage/catalogPrices.js.map +1 -1
  30. package/dist/client/usage/client.d.ts +2 -2
  31. package/dist/client/usage/client.d.ts.map +1 -1
  32. package/dist/client/usage/client.js +2 -2
  33. package/dist/client/usage/client.js.map +1 -1
  34. package/dist/client/usage/correctionClient.d.ts +33 -0
  35. package/dist/client/usage/correctionClient.d.ts.map +1 -0
  36. package/dist/client/usage/correctionClient.js +27 -0
  37. package/dist/client/usage/correctionClient.js.map +1 -0
  38. package/dist/client/usage/correctionEligibility.d.ts +4 -0
  39. package/dist/client/usage/correctionEligibility.d.ts.map +1 -0
  40. package/dist/client/usage/correctionEligibility.js +7 -0
  41. package/dist/client/usage/correctionEligibility.js.map +1 -0
  42. package/dist/client/usage/correctionInvoice.d.ts +9 -0
  43. package/dist/client/usage/correctionInvoice.d.ts.map +1 -0
  44. package/dist/client/usage/correctionInvoice.js +218 -0
  45. package/dist/client/usage/correctionInvoice.js.map +1 -0
  46. package/dist/client/usage/correctionInvoiceProof.d.ts +29 -0
  47. package/dist/client/usage/correctionInvoiceProof.d.ts.map +1 -0
  48. package/dist/client/usage/correctionInvoiceProof.js +41 -0
  49. package/dist/client/usage/correctionInvoiceProof.js.map +1 -0
  50. package/dist/client/usage/correctionProofs.d.ts +36 -0
  51. package/dist/client/usage/correctionProofs.d.ts.map +1 -0
  52. package/dist/client/usage/correctionProofs.js +41 -0
  53. package/dist/client/usage/correctionProofs.js.map +1 -0
  54. package/dist/client/usage/correctionProvider.d.ts +6 -0
  55. package/dist/client/usage/correctionProvider.d.ts.map +1 -0
  56. package/dist/client/usage/correctionProvider.js +243 -0
  57. package/dist/client/usage/correctionProvider.js.map +1 -0
  58. package/dist/client/usage/correctionRead.d.ts +27 -0
  59. package/dist/client/usage/correctionRead.d.ts.map +1 -0
  60. package/dist/client/usage/correctionRead.js +36 -0
  61. package/dist/client/usage/correctionRead.js.map +1 -0
  62. package/dist/client/usage/correctionTerms.d.ts +64 -0
  63. package/dist/client/usage/correctionTerms.d.ts.map +1 -0
  64. package/dist/client/usage/correctionTerms.js +65 -0
  65. package/dist/client/usage/correctionTerms.js.map +1 -0
  66. package/dist/client/usage/correctionTransport.fixtures.d.ts +37 -0
  67. package/dist/client/usage/correctionTransport.fixtures.d.ts.map +1 -0
  68. package/dist/client/usage/correctionTransport.fixtures.js +322 -0
  69. package/dist/client/usage/correctionTransport.fixtures.js.map +1 -0
  70. package/dist/client/usage/creditClient.d.ts +1 -1
  71. package/dist/client/usage/creditRevenue.d.ts +22 -0
  72. package/dist/client/usage/creditRevenue.d.ts.map +1 -0
  73. package/dist/client/usage/creditRevenue.js +118 -0
  74. package/dist/client/usage/creditRevenue.js.map +1 -0
  75. package/dist/client/usage/creditSettlement.d.ts +29 -0
  76. package/dist/client/usage/creditSettlement.d.ts.map +1 -0
  77. package/dist/client/usage/creditSettlement.fixtures.d.ts +215 -0
  78. package/dist/client/usage/creditSettlement.fixtures.d.ts.map +1 -0
  79. package/dist/client/usage/creditSettlement.fixtures.js +59 -0
  80. package/dist/client/usage/creditSettlement.fixtures.js.map +1 -0
  81. package/dist/client/usage/creditSettlement.js +70 -0
  82. package/dist/client/usage/creditSettlement.js.map +1 -0
  83. package/dist/client/usage/creditTransport.fixtures.d.ts +7 -1
  84. package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -1
  85. package/dist/client/usage/creditTransport.fixtures.js +25 -4
  86. package/dist/client/usage/creditTransport.fixtures.js.map +1 -1
  87. package/dist/client/usage/index.d.ts +6 -0
  88. package/dist/client/usage/index.d.ts.map +1 -1
  89. package/dist/client/usage/invoiceSale.d.ts +22 -0
  90. package/dist/client/usage/invoiceSale.d.ts.map +1 -0
  91. package/dist/client/usage/invoiceSale.fixtures.d.ts +285 -0
  92. package/dist/client/usage/invoiceSale.fixtures.d.ts.map +1 -0
  93. package/dist/client/usage/invoiceSale.fixtures.js +104 -0
  94. package/dist/client/usage/invoiceSale.fixtures.js.map +1 -0
  95. package/dist/client/usage/invoiceSale.js +117 -0
  96. package/dist/client/usage/invoiceSale.js.map +1 -0
  97. package/dist/client/usage/observationClient.d.ts +20 -0
  98. package/dist/client/usage/observationClient.d.ts.map +1 -1
  99. package/dist/client/usage/observationClient.js +20 -6
  100. package/dist/client/usage/observationClient.js.map +1 -1
  101. package/dist/client/usage/records.d.ts +1 -1
  102. package/dist/client/usage/records.d.ts.map +1 -1
  103. package/dist/client/usage/records.js.map +1 -1
  104. package/dist/client/usage/settlement.d.ts +32 -0
  105. package/dist/client/usage/settlement.d.ts.map +1 -0
  106. package/dist/client/usage/settlement.js +60 -0
  107. package/dist/client/usage/settlement.js.map +1 -0
  108. package/dist/client/usage/settlementClient.d.ts +51 -0
  109. package/dist/client/usage/settlementClient.d.ts.map +1 -0
  110. package/dist/client/usage/settlementClient.js +35 -0
  111. package/dist/client/usage/settlementClient.js.map +1 -0
  112. package/dist/client/usage/summary.d.ts +3 -0
  113. package/dist/client/usage/summary.d.ts.map +1 -1
  114. package/dist/client/usage/summary.js +9 -4
  115. package/dist/client/usage/summary.js.map +1 -1
  116. package/dist/client/usageExports.d.ts +2 -0
  117. package/dist/client/usageExports.d.ts.map +1 -1
  118. package/dist/component/_generated/api.d.ts +12 -0
  119. package/dist/component/_generated/api.d.ts.map +1 -1
  120. package/dist/component/_generated/api.js.map +1 -1
  121. package/dist/component/_generated/component.d.ts +380 -14
  122. package/dist/component/_generated/component.d.ts.map +1 -1
  123. package/dist/component/accountClosure/mutations.d.ts.map +1 -1
  124. package/dist/component/accountClosure/mutations.js +13 -0
  125. package/dist/component/accountClosure/mutations.js.map +1 -1
  126. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  127. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  128. package/dist/component/earnings/triggers.d.ts +368 -32
  129. package/dist/component/earnings/triggers.d.ts.map +1 -1
  130. package/dist/component/financialObservations/settlementHelpers.d.ts.map +1 -1
  131. package/dist/component/financialObservations/settlementHelpers.js +2 -0
  132. package/dist/component/financialObservations/settlementHelpers.js.map +1 -1
  133. package/dist/component/recoveryWorkflow/helpers.d.ts +25 -0
  134. package/dist/component/recoveryWorkflow/helpers.d.ts.map +1 -1
  135. package/dist/component/recoveryWorkflow/mutations.d.ts +25 -0
  136. package/dist/component/recoveryWorkflow/mutations.d.ts.map +1 -1
  137. package/dist/component/recoveryWorkflow/queries.d.ts +50 -0
  138. package/dist/component/recoveryWorkflow/queries.d.ts.map +1 -1
  139. package/dist/component/recoveryWorkflow/schema.d.ts +566 -10
  140. package/dist/component/recoveryWorkflow/schema.d.ts.map +1 -1
  141. package/dist/component/schema.d.ts +428 -15
  142. package/dist/component/schema.js +4 -0
  143. package/dist/component/schema.js.map +1 -1
  144. package/dist/component/settlement/mutations.d.ts +50 -0
  145. package/dist/component/settlement/mutations.d.ts.map +1 -1
  146. package/dist/component/settlement/mutations.js +8 -1
  147. package/dist/component/settlement/mutations.js.map +1 -1
  148. package/dist/component/settlement/queries.d.ts +25 -0
  149. package/dist/component/settlement/queries.d.ts.map +1 -1
  150. package/dist/component/settlement/schema.d.ts +128 -1
  151. package/dist/component/settlement/schema.d.ts.map +1 -1
  152. package/dist/component/settlement/schema.js +22 -0
  153. package/dist/component/settlement/schema.js.map +1 -1
  154. package/dist/component/usage/queries.d.ts +2 -2
  155. package/dist/component/usage/schema.d.ts +18 -13
  156. package/dist/component/usage/schema.d.ts.map +1 -1
  157. package/dist/component/usage/schema.js +2 -1
  158. package/dist/component/usage/schema.js.map +1 -1
  159. package/dist/component/usageAllowance/queries.d.ts +1 -1
  160. package/dist/component/usageAllowance/queries.d.ts.map +1 -1
  161. package/dist/component/usageAllowance/queries.js +10 -1
  162. package/dist/component/usageAllowance/queries.js.map +1 -1
  163. package/dist/component/usageAllowance/schema.d.ts +5 -5
  164. package/dist/component/usageAllowance/schema.d.ts.map +1 -1
  165. package/dist/component/usageAllowance/schema.js +1 -1
  166. package/dist/component/usageAllowance/schema.js.map +1 -1
  167. package/dist/component/usageCorrections/accounting.d.ts +5 -0
  168. package/dist/component/usageCorrections/accounting.d.ts.map +1 -0
  169. package/dist/component/usageCorrections/accounting.js +55 -0
  170. package/dist/component/usageCorrections/accounting.js.map +1 -0
  171. package/dist/component/usageCorrections/cancellation.d.ts +6 -0
  172. package/dist/component/usageCorrections/cancellation.d.ts.map +1 -0
  173. package/dist/component/usageCorrections/cancellation.js +29 -0
  174. package/dist/component/usageCorrections/cancellation.js.map +1 -0
  175. package/dist/component/usageCorrections/helpers.d.ts +60 -0
  176. package/dist/component/usageCorrections/helpers.d.ts.map +1 -0
  177. package/dist/component/usageCorrections/helpers.js +52 -0
  178. package/dist/component/usageCorrections/helpers.js.map +1 -0
  179. package/dist/component/usageCorrections/invoice.d.ts +38 -0
  180. package/dist/component/usageCorrections/invoice.d.ts.map +1 -0
  181. package/dist/component/usageCorrections/invoice.js +82 -0
  182. package/dist/component/usageCorrections/invoice.js.map +1 -0
  183. package/dist/component/usageCorrections/mutations.d.ts +121 -0
  184. package/dist/component/usageCorrections/mutations.d.ts.map +1 -0
  185. package/dist/component/usageCorrections/mutations.js +256 -0
  186. package/dist/component/usageCorrections/mutations.js.map +1 -0
  187. package/dist/component/usageCorrections/queries.d.ts +115 -0
  188. package/dist/component/usageCorrections/queries.d.ts.map +1 -0
  189. package/dist/component/usageCorrections/queries.js +84 -0
  190. package/dist/component/usageCorrections/queries.js.map +1 -0
  191. package/dist/component/usageCorrections/schema.d.ts +248 -0
  192. package/dist/component/usageCorrections/schema.d.ts.map +1 -0
  193. package/dist/component/usageCorrections/schema.js +74 -0
  194. package/dist/component/usageCorrections/schema.js.map +1 -0
  195. package/dist/component/usageCredits/queries.d.ts +1 -1
  196. package/dist/component/usageCredits/queries.d.ts.map +1 -1
  197. package/dist/component/usageCredits/queries.js +6 -0
  198. package/dist/component/usageCredits/queries.js.map +1 -1
  199. package/dist/component/usageCredits/schema.d.ts +5 -5
  200. package/dist/component/usageCredits/schema.d.ts.map +1 -1
  201. package/dist/component/usageCredits/schema.js +1 -1
  202. package/dist/component/usageCredits/schema.js.map +1 -1
  203. package/dist/component/usageDelivery/fields.d.ts +2 -2
  204. package/dist/component/usageDelivery/fields.d.ts.map +1 -1
  205. package/dist/component/usageDelivery/fields.js +1 -1
  206. package/dist/component/usageDelivery/fields.js.map +1 -1
  207. package/dist/component/usageDelivery/helpers.d.ts +7 -6
  208. package/dist/component/usageDelivery/helpers.d.ts.map +1 -1
  209. package/dist/component/usageDelivery/mutations.d.ts +6 -6
  210. package/dist/component/usageDelivery/mutations.d.ts.map +1 -1
  211. package/dist/component/usageDelivery/mutations.js +9 -1
  212. package/dist/component/usageDelivery/mutations.js.map +1 -1
  213. package/dist/component/usageDelivery/queries.d.ts +8 -6
  214. package/dist/component/usageDelivery/queries.d.ts.map +1 -1
  215. package/dist/component/usageDelivery/schema.d.ts +4 -4
  216. package/dist/component/usageDelivery/steps.d.ts +2 -2
  217. package/dist/component/usageDelivery/steps.js +1 -1
  218. package/dist/component/usageDelivery/steps.js.map +1 -1
  219. package/dist/component/usageObservations/queries.d.ts.map +1 -1
  220. package/dist/component/usageObservations/queries.js +4 -2
  221. package/dist/component/usageObservations/queries.js.map +1 -1
  222. package/dist/component/usageSubscriptions/retirement.d.ts.map +1 -1
  223. package/dist/component/usageSubscriptions/retirement.js +24 -2
  224. package/dist/component/usageSubscriptions/retirement.js.map +1 -1
  225. package/docs/README.md +4 -0
  226. package/docs/settlement.md +4 -0
  227. package/docs/usage-corrections.md +249 -0
  228. package/docs/usage-limits.md +1 -1
  229. package/docs/usage-settlement.md +162 -0
  230. package/package.json +3 -1
  231. package/src/client/index.ts +9 -0
  232. package/src/client/paymentSource/resolver.fixtures.ts +216 -0
  233. package/src/client/paymentSource/resolver.test.ts +11 -207
  234. package/src/client/paymentSource/resolver.ts +54 -2
  235. package/src/client/settlement/execution.ts +24 -0
  236. package/src/client/usage/catalogPrices.ts +4 -2
  237. package/src/client/usage/client.ts +2 -2
  238. package/src/client/usage/correctionClient.test.ts +153 -0
  239. package/src/client/usage/correctionClient.ts +62 -0
  240. package/src/client/usage/correctionCredits.test.ts +156 -0
  241. package/src/client/usage/correctionEligibility.ts +14 -0
  242. package/src/client/usage/correctionInvoice.test.ts +127 -0
  243. package/src/client/usage/correctionInvoice.ts +269 -0
  244. package/src/client/usage/correctionInvoiceProof.ts +40 -0
  245. package/src/client/usage/correctionProofs.ts +40 -0
  246. package/src/client/usage/correctionProvider.ts +326 -0
  247. package/src/client/usage/correctionRead.ts +73 -0
  248. package/src/client/usage/correctionRecovery.test.ts +113 -0
  249. package/src/client/usage/correctionTerms.ts +98 -0
  250. package/src/client/usage/correctionTransport.fixtures.ts +372 -0
  251. package/src/client/usage/creditRevenue.test.ts +105 -0
  252. package/src/client/usage/creditRevenue.ts +163 -0
  253. package/src/client/usage/creditSettlement.fixtures.ts +70 -0
  254. package/src/client/usage/creditSettlement.test.ts +66 -0
  255. package/src/client/usage/creditSettlement.ts +94 -0
  256. package/src/client/usage/creditSettlementRecovery.test.ts +173 -0
  257. package/src/client/usage/creditTransport.fixtures.ts +29 -4
  258. package/src/client/usage/index.ts +20 -0
  259. package/src/client/usage/invoiceSale.fixtures.ts +103 -0
  260. package/src/client/usage/invoiceSale.test.ts +184 -0
  261. package/src/client/usage/invoiceSale.ts +155 -0
  262. package/src/client/usage/observationClient.ts +20 -6
  263. package/src/client/usage/records.ts +7 -1
  264. package/src/client/usage/settlement.test.ts +179 -0
  265. package/src/client/usage/settlement.ts +81 -0
  266. package/src/client/usage/settlementClient.ts +84 -0
  267. package/src/client/usage/summary.ts +12 -4
  268. package/src/client/usageExports.ts +11 -0
  269. package/src/component/_generated/api.ts +12 -0
  270. package/src/component/_generated/component.ts +440 -2
  271. package/src/component/accountClosure/mutations.ts +17 -0
  272. package/src/component/financialObservations/settlementHelpers.ts +2 -0
  273. package/src/component/schema.ts +8 -0
  274. package/src/component/settlement/mutations.ts +10 -1
  275. package/src/component/settlement/schema.ts +26 -0
  276. package/src/component/settlement/settlement-claims.test.ts +54 -0
  277. package/src/component/usage/schema.ts +2 -0
  278. package/src/component/usageAllowance/queries.ts +8 -1
  279. package/src/component/usageAllowance/schema.ts +1 -0
  280. package/src/component/usageCorrections/accounting.ts +79 -0
  281. package/src/component/usageCorrections/cancellation.ts +32 -0
  282. package/src/component/usageCorrections/corrections.test.ts +389 -0
  283. package/src/component/usageCorrections/helpers.ts +57 -0
  284. package/src/component/usageCorrections/invoice.ts +103 -0
  285. package/src/component/usageCorrections/mutations.ts +278 -0
  286. package/src/component/usageCorrections/queries.ts +94 -0
  287. package/src/component/usageCorrections/schema.ts +90 -0
  288. package/src/component/usageCredits/queries.ts +4 -0
  289. package/src/component/usageCredits/schema.ts +1 -0
  290. package/src/component/usageDelivery/fields.ts +1 -0
  291. package/src/component/usageDelivery/mutations.ts +8 -3
  292. package/src/component/usageDelivery/steps.ts +1 -1
  293. package/src/component/usageObservations/queries.ts +5 -2
  294. package/src/component/usageSubscriptions/retirement.ts +31 -2
@@ -0,0 +1,65 @@
1
+ import { invoiceCorrectionProof } from "./correctionInvoiceProof.js";
2
+ import { z } from "zod";
3
+ import { scopeSchema } from "./records.js";
4
+ export const correctionRequest = z.strictObject({
5
+ scope: scopeSchema,
6
+ eventId: z.string().min(1).max(100),
7
+ correctionId: z.string().min(1).max(100),
8
+ actor: z.string().min(1).max(200),
9
+ reason: z.string().min(1).max(500),
10
+ operation: z.literal("cancel"),
11
+ quantity: z.string().optional(),
12
+ });
13
+ export const correctionState = z.enum([
14
+ "requested",
15
+ "provider_accepted",
16
+ "confirmed",
17
+ "held",
18
+ "unsupported",
19
+ "invoice_adjustment_required",
20
+ ]);
21
+ export function correctionView(row) {
22
+ const request = correctionRequest.parse(JSON.parse(row.inputJson));
23
+ const invoiceAdjustment = row.adjustmentJson
24
+ ? invoiceCorrectionProof.parse(JSON.parse(row.adjustmentJson))
25
+ : null;
26
+ if (invoiceAdjustment && row.nativeCreditNoteStatus)
27
+ invoiceAdjustment.creditNoteStatus = row.nativeCreditNoteStatus;
28
+ return {
29
+ cashCollection: "none",
30
+ invoiceAdjustment,
31
+ observedAt: row.observedAt ?? row.firstAttemptAt,
32
+ nativeCreditNoteStatus: row.nativeCreditNoteStatus ?? null,
33
+ resolution: row.resolution ?? "event_cancellation",
34
+ correctionId: row.correctionId,
35
+ eventId: row.eventId,
36
+ sourceEventId: JSON.parse(row.recordJson).sourceEventId,
37
+ state: row.state,
38
+ reason: row.reason,
39
+ actor: request.actor,
40
+ requestedReason: request.reason,
41
+ quantity: row.quantity,
42
+ nativeAdjustmentId: row.nativeAdjustmentId ?? null,
43
+ nativeStatus: row.nativeStatus ?? null,
44
+ invoiceId: row.invoiceId ?? null,
45
+ creditNoteId: row.creditNoteId ?? null,
46
+ refundId: row.refundId ?? null,
47
+ cashConsequence: row.cashConsequence,
48
+ restoredQuantity: row.restoredQuantity,
49
+ };
50
+ }
51
+ export const invoiceCorrectionOptions = z.strictObject({
52
+ scope: scopeSchema,
53
+ eventId: z.string().min(1).max(100),
54
+ correctionId: z.string().min(1).max(100),
55
+ invoiceId: z
56
+ .string()
57
+ .regex(/^in_[a-zA-Z0-9]+$/)
58
+ .max(100),
59
+ creditNoteId: z
60
+ .string()
61
+ .regex(/^cn_[a-zA-Z0-9]+$/)
62
+ .max(100),
63
+ amount: z.number().int().positive().max(99999999),
64
+ });
65
+ //# sourceMappingURL=correctionTerms.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"correctionTerms.js","sourceRoot":"","sources":["../../../src/client/usage/correctionTerms.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { UsageDeliveryProviderOptions } from "./deliveryProvider.js";
2
+ import type { UsageCorrectionOptions } from "./correctionTerms.js";
3
+ import type { UsageReceipt } from "./boundaries.js";
4
+ import type { UsageSubscriptionView } from "./subscriptionTerms.js";
5
+ import { BetterStripe } from "../index.js";
6
+ import { fixture } from "./subscriptionTransport.fixtures.js";
7
+ type CorrectionState = {
8
+ status: string;
9
+ missingEvidence: boolean;
10
+ advanceAtInvoiceRead: number;
11
+ failFirstAdjustment: boolean;
12
+ invalidCash: boolean;
13
+ paidAdjustment: boolean;
14
+ refundSucceeded: boolean;
15
+ voidedNote: boolean;
16
+ truncatedNote: boolean;
17
+ foreignLine: boolean;
18
+ finalizeOnAdjust: boolean;
19
+ finalized: boolean;
20
+ creditNoteAmount: number;
21
+ foreignNote: boolean;
22
+ };
23
+ export declare function setupCorrection(withAllowance?: boolean, periodEnd?: number): Promise<{
24
+ f: ReturnType<typeof fixture>;
25
+ client: BetterStripe;
26
+ options: UsageDeliveryProviderOptions;
27
+ correction: UsageCorrectionOptions;
28
+ receipt: UsageReceipt;
29
+ calls: Array<{
30
+ body: URLSearchParams;
31
+ key: string | null;
32
+ }>;
33
+ state: CorrectionState;
34
+ original: UsageSubscriptionView["bindings"][number];
35
+ }>;
36
+ export {};
37
+ //# sourceMappingURL=correctionTransport.fixtures.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"correctionTransport.fixtures.d.ts","sourceRoot":"","sources":["../../../src/client/usage/correctionTransport.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAKpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAM9D,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AACF,wBAAsB,eAAe,CACnC,aAAa,UAAQ,EACrB,SAAS,SAAO,GACf,OAAO,CAAC;IACT,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,4BAA4B,CAAC;IACtC,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;CACrD,CAAC,CAsUD"}
@@ -0,0 +1,322 @@
1
+ import { internalMutationGeneric } from "convex/server";
2
+ import { v } from "convex/values";
3
+ import { schema, modules } from "../../test.js";
4
+ import { vi } from "vitest";
5
+ import { BetterStripe } from "../index.js";
6
+ import { componentRef } from "../webhooks/helpers.js";
7
+ import { fixture } from "./subscriptionTransport.fixtures.js";
8
+ import { request } from "./subscription.fixtures.js";
9
+ const response = (value) => new Response(JSON.stringify(value), {
10
+ headers: { "content-type": "application/json" },
11
+ });
12
+ export async function setupCorrection(withAllowance = false, periodEnd = 1200) {
13
+ vi.useFakeTimers();
14
+ vi.setSystemTime(700000);
15
+ const state = {
16
+ advanceAtInvoiceRead: 0,
17
+ status: "pending",
18
+ missingEvidence: false,
19
+ failFirstAdjustment: false,
20
+ invalidCash: false,
21
+ paidAdjustment: false,
22
+ refundSucceeded: true,
23
+ voidedNote: false,
24
+ truncatedNote: false,
25
+ foreignLine: false,
26
+ finalizeOnAdjust: false,
27
+ finalized: false,
28
+ creditNoteAmount: 4,
29
+ foreignNote: false,
30
+ };
31
+ const calls = [];
32
+ const f = fixture(false, false, async (input, init) => {
33
+ const path = new URL(input).pathname;
34
+ if (path === "/v1/credit_notes/cn_fix")
35
+ return response({
36
+ id: "cn_fix",
37
+ object: "credit_note",
38
+ livemode: false,
39
+ customer_account: state.foreignNote ? "acct_other" : "acct_buyer",
40
+ customer: "cus_buyer",
41
+ invoice: "in_usage",
42
+ currency: "usd",
43
+ status: state.voidedNote ? "void" : "issued",
44
+ amount: state.creditNoteAmount,
45
+ total: state.creditNoteAmount,
46
+ subtotal: state.creditNoteAmount,
47
+ discount_amount: 0,
48
+ amount_shipping: 0,
49
+ total_taxes: state.missingEvidence ? undefined : [],
50
+ pre_payment_amount: state.paidAdjustment ? 0 : state.creditNoteAmount,
51
+ post_payment_amount: state.paidAdjustment ? state.creditNoteAmount : 0,
52
+ customer_balance_transaction: null,
53
+ out_of_band_amount: 0,
54
+ refunds: state.paidAdjustment
55
+ ? [
56
+ {
57
+ type: "refund",
58
+ refund: "re_fix",
59
+ amount_refunded: state.creditNoteAmount,
60
+ },
61
+ ]
62
+ : [],
63
+ pretax_credit_amounts: [],
64
+ lines: {
65
+ has_more: state.truncatedNote,
66
+ data: [
67
+ {
68
+ id: "cnli_fix",
69
+ type: "invoice_line_item",
70
+ invoice_line_item: "il_usage",
71
+ amount: state.creditNoteAmount,
72
+ livemode: false,
73
+ discount_amount: 0,
74
+ taxes: [],
75
+ pretax_credit_amounts: [],
76
+ },
77
+ ],
78
+ },
79
+ });
80
+ if (path === "/v1/invoices/in_usage")
81
+ return response({
82
+ id: "in_usage",
83
+ object: "invoice",
84
+ livemode: false,
85
+ customer_account: "acct_buyer",
86
+ customer: "cus_buyer",
87
+ currency: "usd",
88
+ status: state.paidAdjustment ? "paid" : "open",
89
+ status_transitions: { finalized_at: 701 },
90
+ parent: {
91
+ type: "subscription_details",
92
+ subscription_details: { subscription: "sub_calls" },
93
+ },
94
+ lines: {
95
+ has_more: false,
96
+ data: [
97
+ {
98
+ id: "il_usage",
99
+ amount: 12,
100
+ currency: "usd",
101
+ pricing: {
102
+ price_details: {
103
+ price: state.foreignLine ? "price_other" : "price_calls",
104
+ },
105
+ },
106
+ period: { start: 600, end: periodEnd },
107
+ parent: {
108
+ subscription_item_details: {
109
+ subscription_item: "si_calls",
110
+ subscription: "sub_calls",
111
+ proration: false,
112
+ },
113
+ },
114
+ quantity_decimal: state.missingEvidence ? undefined : "6",
115
+ pretax_credit_amounts: [],
116
+ discount_amounts: [],
117
+ taxes: [],
118
+ },
119
+ ],
120
+ },
121
+ });
122
+ if (path === "/v1/refunds/re_fix")
123
+ return response({
124
+ id: "re_fix",
125
+ object: "refund",
126
+ status: state.refundSucceeded ? "succeeded" : "pending",
127
+ amount: state.creditNoteAmount,
128
+ currency: "usd",
129
+ payment_intent: "pi_invoice",
130
+ charge: "ch_invoice",
131
+ });
132
+ if (path === "/v1/payment_intents/pi_invoice")
133
+ return response({
134
+ id: "pi_invoice",
135
+ object: "payment_intent",
136
+ livemode: false,
137
+ customer_account: "acct_buyer",
138
+ customer: "cus_buyer",
139
+ status: "succeeded",
140
+ currency: "usd",
141
+ amount: 12,
142
+ amount_received: 12,
143
+ latest_charge: "ch_invoice",
144
+ });
145
+ if (path === "/v1/charges/ch_invoice")
146
+ return response({
147
+ id: "ch_invoice",
148
+ object: "charge",
149
+ payment_intent: "pi_invoice",
150
+ livemode: false,
151
+ customer: "cus_buyer",
152
+ currency: "usd",
153
+ paid: true,
154
+ captured: true,
155
+ status: "succeeded",
156
+ disputed: false,
157
+ amount: 12,
158
+ amount_captured: state.invalidCash ? 12.5 : 12,
159
+ amount_refunded: state.creditNoteAmount,
160
+ });
161
+ if (path === "/v1/invoice_payments")
162
+ return response({
163
+ has_more: false,
164
+ data: [
165
+ {
166
+ id: "inpay_usage",
167
+ object: "invoice_payment",
168
+ amount_requested: 12,
169
+ invoice: "in_usage",
170
+ status: "paid",
171
+ currency: "usd",
172
+ amount_paid: 12,
173
+ payment: { type: "payment_intent", payment_intent: "pi_invoice" },
174
+ },
175
+ ],
176
+ });
177
+ if (path === "/v1/invoices") {
178
+ if (state.advanceAtInvoiceRead) {
179
+ vi.advanceTimersByTime(state.advanceAtInvoiceRead);
180
+ state.advanceAtInvoiceRead = 0;
181
+ }
182
+ return response({
183
+ data: state.finalized
184
+ ? [
185
+ {
186
+ id: "in_usage",
187
+ livemode: false,
188
+ customer_account: "acct_buyer",
189
+ customer: "cus_buyer",
190
+ status: "open",
191
+ currency: "usd",
192
+ parent: {
193
+ type: "subscription_details",
194
+ subscription_details: { subscription: "sub_calls" },
195
+ },
196
+ status_transitions: { finalized_at: 701 },
197
+ lines: {
198
+ has_more: false,
199
+ data: [
200
+ {
201
+ pricing: { price_details: { price: "price_calls" } },
202
+ period: { start: 600, end: periodEnd },
203
+ quantity_decimal: state.missingEvidence ? undefined : "6",
204
+ },
205
+ ],
206
+ },
207
+ },
208
+ ]
209
+ : [],
210
+ has_more: false,
211
+ });
212
+ }
213
+ if (path === "/v1/billing/meter_event_adjustments") {
214
+ if (state.finalizeOnAdjust)
215
+ state.finalized = true;
216
+ const body = new URLSearchParams(String(init?.body));
217
+ calls.push({
218
+ body,
219
+ key: new Headers(init?.headers).get("idempotency-key"),
220
+ });
221
+ if (state.failFirstAdjustment) {
222
+ state.failFirstAdjustment = false;
223
+ throw new Error("private provider response sk_test_private");
224
+ }
225
+ return response({
226
+ object: "billing.meter_event_adjustment",
227
+ livemode: false,
228
+ status: state.status,
229
+ event_name: "calls",
230
+ type: "cancel",
231
+ cancel: { identifier: body.get("cancel[identifier]") },
232
+ });
233
+ }
234
+ return undefined;
235
+ });
236
+ f.t.registerComponent("betterStripe", schema, {
237
+ ...modules,
238
+ "./component/testSetup.ts": () => Promise.resolve({
239
+ delivered: internalMutationGeneric({
240
+ args: { eventId: v.id("usageEvents") },
241
+ returns: v.null(),
242
+ handler: async (ctx, args) => {
243
+ const row = await ctx.db
244
+ .query("usageOutbox")
245
+ .withIndex("by_event", (q) => q.eq("eventId", args.eventId))
246
+ .unique();
247
+ await ctx.db.patch(row._id, {
248
+ state: "provider_accepted",
249
+ attempts: 1,
250
+ firstSendAt: 700,
251
+ definitionVersion: 1,
252
+ receipt: { identifier: row.providerIdentifier, created: 700 },
253
+ });
254
+ return null;
255
+ },
256
+ }),
257
+ }),
258
+ });
259
+ const client = new BetterStripe(f.component), options = {
260
+ stripeSecretKey: "sk_test_subscription",
261
+ httpClient: f.httpClient,
262
+ };
263
+ let managed = await f.t.action((ctx) => client.usage.ensureSubscription(ctx, request, options));
264
+ if (periodEnd !== 1200) {
265
+ for (const item of f.state.native.items.data)
266
+ item.current_period_end = periodEnd;
267
+ managed = await f.t.action((ctx) => client.usage.observeSubscription(ctx, {
268
+ scope: {
269
+ stripeAccountId: "acct_platform",
270
+ customerAccount: "acct_buyer",
271
+ livemode: false,
272
+ },
273
+ requestId: request.requestId,
274
+ }, options));
275
+ }
276
+ const original = managed.bindings[0];
277
+ if (withAllowance)
278
+ await f.t.action((ctx) => client.usage.configureAllowance(ctx, {
279
+ ...original,
280
+ expectedRevision: 0,
281
+ policy: {
282
+ reset: "billing_period",
283
+ rollover: "none",
284
+ entitled: true,
285
+ overage: "allow",
286
+ limit: { mode: "hard", quantity: "12" },
287
+ },
288
+ }));
289
+ const event = {
290
+ scope: original.scope,
291
+ binding: original.binding,
292
+ sourceEventId: "work1",
293
+ quantity: "6",
294
+ occurredAt: 700,
295
+ };
296
+ const reservation = withAllowance
297
+ ? await f.t.action((ctx) => client.usage.reserveAllowance(ctx, {
298
+ event,
299
+ subscription: original.subscription,
300
+ }))
301
+ : null;
302
+ const receipt = await f.t.action((ctx) => client.usage.record(ctx, {
303
+ event,
304
+ subscription: original.subscription,
305
+ ...(reservation && reservation.state !== "denied"
306
+ ? { reservationId: reservation.reservationId }
307
+ : {}),
308
+ }));
309
+ await f.t.action((ctx) => ctx.runMutation(componentRef(f.component, "testSetup/delivered"), {
310
+ eventId: receipt.eventId,
311
+ }));
312
+ const correction = {
313
+ scope: original.scope,
314
+ eventId: receipt.eventId,
315
+ correctionId: "fix1",
316
+ actor: "operator1",
317
+ reason: "duplicate activity",
318
+ operation: "cancel",
319
+ };
320
+ return { f, client, options, correction, receipt, calls, state, original };
321
+ }
322
+ //# sourceMappingURL=correctionTransport.fixtures.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"correctionTransport.fixtures.js","sourceRoot":"","sources":["../../../src/client/usage/correctionTransport.fixtures.ts"],"names":[],"mappings":"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"}
@@ -63,7 +63,7 @@ export declare class UsageCreditClient extends UsageSubscriptionClient {
63
63
  at: number;
64
64
  evidenceJson: string;
65
65
  fingerprint: string;
66
- kind: "closure" | "commit" | "grant" | "observation" | "payment" | "purchase" | "recovery" | "release" | "reservation";
66
+ kind: "closure" | "commit" | "correction" | "grant" | "observation" | "payment" | "purchase" | "recovery" | "release" | "reservation";
67
67
  purchaseKey?: string | undefined;
68
68
  sourceKey: string;
69
69
  }[];
@@ -0,0 +1,22 @@
1
+ import type Stripe from "stripe";
2
+ import type { Component, RunCtx } from "../helpers.js";
3
+ import type { FinancialOutcome } from "../financialOutcomes/contracts.js";
4
+ import type { UsageCreditPurchaseOptions } from "./creditTerms.js";
5
+ export type UsageCreditRevenue = {
6
+ purchaseId: string;
7
+ paymentIntentId: string;
8
+ chargeId: string;
9
+ creditGrantId: string;
10
+ stripeAccountId: string;
11
+ customerAccount: string;
12
+ livemode: boolean;
13
+ stripePriceId: string;
14
+ stripeProductId: string;
15
+ gross: number;
16
+ processingFee: number;
17
+ currency: string;
18
+ ownership: "issuer";
19
+ };
20
+ /** Original issuer-service revenue only. Credit consumption never creates a second sale. */
21
+ export declare function getCreditPurchaseRevenue(stripe: Stripe, component: Component, ctx: RunCtx, input: UsageCreditPurchaseOptions): Promise<FinancialOutcome<UsageCreditRevenue>>;
22
+ //# sourceMappingURL=creditRevenue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditRevenue.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditRevenue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAUnE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;CACrB,CAAC;AACF,4FAA4F;AAC5F,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CA+H/C"}
@@ -0,0 +1,118 @@
1
+ import { verifyPinnedUsagePrice } from "./catalogPrices.js";
2
+ import { UsageCreditRecoveryError } from "./creditTerms.js";
3
+ import { findCreditPurchase } from "./creditRead.js";
4
+ import { verifyCreditRealm, paymentIdentity, verifiedCreditPayment, } from "./creditNative.js";
5
+ import { paymentCreditProof } from "./creditProofs.js";
6
+ import { saleAmountFailure } from "../paymentSource/economics.js";
7
+ /** Original issuer-service revenue only. Credit consumption never creates a second sale. */
8
+ export async function getCreditPurchaseRevenue(stripe, component, ctx, input) {
9
+ try {
10
+ const { row, terms } = await findCreditPurchase(component, ctx, input);
11
+ if (row.state === "frozen" || row.state === "canceled")
12
+ return {
13
+ status: "rejected",
14
+ reason: "payment_not_payable",
15
+ retryable: false,
16
+ };
17
+ if (row.state !== "ready" ||
18
+ !row.paymentIntentId ||
19
+ !row.paymentProofJson ||
20
+ !row.creditGrantId)
21
+ return {
22
+ status: "not_ready",
23
+ reason: "provider_pending",
24
+ retryable: true,
25
+ };
26
+ await verifyCreditRealm(stripe, terms, false);
27
+ const [payment, price] = await Promise.all([
28
+ stripe.paymentIntents.retrieve(row.paymentIntentId, {
29
+ expand: ["latest_charge.balance_transaction"],
30
+ }),
31
+ stripe.prices.retrieve(terms.binding.stripePriceId, {
32
+ expand: ["tiers"],
33
+ }),
34
+ ]);
35
+ paymentIdentity(payment, terms, row.key, row.paymentIntentId);
36
+ const proof = verifiedCreditPayment(payment, terms), retained = paymentCreditProof.parse(JSON.parse(row.paymentProofJson));
37
+ if (!proof ||
38
+ proof.chargeId !== retained.chargeId ||
39
+ price.id !== terms.binding.stripePriceId)
40
+ return {
41
+ status: "conflict",
42
+ reason: "identity_changed",
43
+ retryable: false,
44
+ };
45
+ verifyPinnedUsagePrice(price, {
46
+ stripeAccountId: terms.scope.stripeAccountId,
47
+ livemode: terms.scope.livemode,
48
+ }, terms.binding.plan, terms.scope.meterId, false);
49
+ const charge = payment.latest_charge;
50
+ if (!charge || typeof charge === "string")
51
+ return {
52
+ status: "not_ready",
53
+ reason: "provider_pending",
54
+ retryable: true,
55
+ };
56
+ const customerId = (value) => typeof value === "string" ? value : value?.id;
57
+ if (customerId(payment.customer) !== terms.binding.stripeCustomerId ||
58
+ customerId(charge.customer) !== terms.binding.stripeCustomerId ||
59
+ charge.transfer)
60
+ return {
61
+ status: "conflict",
62
+ reason: "identity_changed",
63
+ retryable: false,
64
+ };
65
+ const balanceRef = charge.balance_transaction;
66
+ if (!balanceRef)
67
+ return { status: "not_ready", reason: "fee_pending", retryable: true };
68
+ const balance = typeof balanceRef === "string"
69
+ ? await stripe.balanceTransactions.retrieve(balanceRef)
70
+ : balanceRef;
71
+ const sourceId = typeof balance.source === "string" ? balance.source : balance.source?.id;
72
+ if ((typeof balanceRef === "string" && balance.id !== balanceRef) ||
73
+ balance.object !== "balance_transaction" ||
74
+ sourceId !== charge.id ||
75
+ saleAmountFailure(payment, charge, balance) ||
76
+ balance.amount !== terms.amount ||
77
+ balance.net !== balance.amount - balance.fee ||
78
+ !Number.isSafeInteger(balance.amount) ||
79
+ !Number.isSafeInteger(balance.net))
80
+ return {
81
+ status: "rejected",
82
+ reason: "unsupported_source",
83
+ retryable: false,
84
+ };
85
+ return {
86
+ status: "ready",
87
+ value: {
88
+ purchaseId: terms.purchaseId,
89
+ paymentIntentId: proof.paymentIntentId,
90
+ chargeId: proof.chargeId,
91
+ creditGrantId: row.creditGrantId,
92
+ stripeAccountId: terms.scope.stripeAccountId,
93
+ customerAccount: terms.scope.customerAccount,
94
+ livemode: terms.scope.livemode,
95
+ stripePriceId: price.id,
96
+ stripeProductId: typeof price.product === "string" ? price.product : price.product.id,
97
+ gross: terms.amount,
98
+ processingFee: balance.fee,
99
+ currency: payment.currency,
100
+ ownership: "issuer",
101
+ },
102
+ };
103
+ }
104
+ catch (error) {
105
+ if (error instanceof UsageCreditRecoveryError)
106
+ return {
107
+ status: "rejected",
108
+ reason: "payment_not_payable",
109
+ retryable: false,
110
+ };
111
+ return {
112
+ status: "unknown",
113
+ reason: "provider_outcome_unknown",
114
+ retryable: false,
115
+ };
116
+ }
117
+ }
118
+ //# sourceMappingURL=creditRevenue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditRevenue.js","sourceRoot":"","sources":["../../../src/client/usage/creditRevenue.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import type Stripe from "stripe";
2
+ import type { Component, RunCtx } from "../helpers.js";
3
+ import type { UsageCreditPurchaseOptions } from "./creditTerms.js";
4
+ import type { SaleAllocationOptions } from "../settlement/allocation.js";
5
+ export type UsageCreditSettlementOptions = UsageCreditPurchaseOptions & {
6
+ policy: {
7
+ affiliate?: SaleAllocationOptions["affiliate"];
8
+ feeBasisPoints?: number;
9
+ };
10
+ };
11
+ /** Retain issuer revenue; an authorized affiliate is paid from the original purchase only. No reseller redemption. */
12
+ export declare function settleCreditPurchase(stripe: Stripe, component: Component, ctx: RunCtx, input: UsageCreditSettlementOptions): Promise<{
13
+ status: "not_ready";
14
+ reason: "fee_pending" | "history_incomplete" | "provider_pending";
15
+ retryable: true;
16
+ } | {
17
+ status: "conflict";
18
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
19
+ retryable: false;
20
+ } | {
21
+ status: "rejected";
22
+ reason: "currency_mismatch" | "invalid_scope" | "payment_not_payable" | "policy_invalid" | "unsupported_source";
23
+ retryable: false;
24
+ } | {
25
+ status: "unknown";
26
+ reason: "history_incomplete" | "provider_outcome_unknown";
27
+ retryable: false;
28
+ } | import("../index.js").SettlementResult>;
29
+ //# sourceMappingURL=creditSettlement.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditSettlement.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditSettlement.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,GAAG;IACtE,MAAM,EAAE;QACN,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAgBF,sHAAsH;AACtH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,4BAA4B;;;;;;;;;;;;;;;;4CAyDpC"}