@fantastic.dev/better-stripe 0.58.0 → 0.59.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 (198) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +1 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +238 -18
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +119 -9
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +238 -18
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +119 -9
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/usage/allowanceClient.d.ts +1 -1
  12. package/dist/client/usage/client.d.ts +2 -2
  13. package/dist/client/usage/client.d.ts.map +1 -1
  14. package/dist/client/usage/client.js +2 -2
  15. package/dist/client/usage/client.js.map +1 -1
  16. package/dist/client/usage/correctionClient.d.ts +33 -0
  17. package/dist/client/usage/correctionClient.d.ts.map +1 -0
  18. package/dist/client/usage/correctionClient.js +27 -0
  19. package/dist/client/usage/correctionClient.js.map +1 -0
  20. package/dist/client/usage/correctionEligibility.d.ts +4 -0
  21. package/dist/client/usage/correctionEligibility.d.ts.map +1 -0
  22. package/dist/client/usage/correctionEligibility.js +7 -0
  23. package/dist/client/usage/correctionEligibility.js.map +1 -0
  24. package/dist/client/usage/correctionInvoice.d.ts +9 -0
  25. package/dist/client/usage/correctionInvoice.d.ts.map +1 -0
  26. package/dist/client/usage/correctionInvoice.js +218 -0
  27. package/dist/client/usage/correctionInvoice.js.map +1 -0
  28. package/dist/client/usage/correctionInvoiceProof.d.ts +29 -0
  29. package/dist/client/usage/correctionInvoiceProof.d.ts.map +1 -0
  30. package/dist/client/usage/correctionInvoiceProof.js +41 -0
  31. package/dist/client/usage/correctionInvoiceProof.js.map +1 -0
  32. package/dist/client/usage/correctionProofs.d.ts +36 -0
  33. package/dist/client/usage/correctionProofs.d.ts.map +1 -0
  34. package/dist/client/usage/correctionProofs.js +41 -0
  35. package/dist/client/usage/correctionProofs.js.map +1 -0
  36. package/dist/client/usage/correctionProvider.d.ts +6 -0
  37. package/dist/client/usage/correctionProvider.d.ts.map +1 -0
  38. package/dist/client/usage/correctionProvider.js +243 -0
  39. package/dist/client/usage/correctionProvider.js.map +1 -0
  40. package/dist/client/usage/correctionRead.d.ts +27 -0
  41. package/dist/client/usage/correctionRead.d.ts.map +1 -0
  42. package/dist/client/usage/correctionRead.js +36 -0
  43. package/dist/client/usage/correctionRead.js.map +1 -0
  44. package/dist/client/usage/correctionTerms.d.ts +64 -0
  45. package/dist/client/usage/correctionTerms.d.ts.map +1 -0
  46. package/dist/client/usage/correctionTerms.js +65 -0
  47. package/dist/client/usage/correctionTerms.js.map +1 -0
  48. package/dist/client/usage/correctionTransport.fixtures.d.ts +37 -0
  49. package/dist/client/usage/correctionTransport.fixtures.d.ts.map +1 -0
  50. package/dist/client/usage/correctionTransport.fixtures.js +322 -0
  51. package/dist/client/usage/correctionTransport.fixtures.js.map +1 -0
  52. package/dist/client/usage/creditClient.d.ts +1 -1
  53. package/dist/client/usage/index.d.ts +2 -0
  54. package/dist/client/usage/index.d.ts.map +1 -1
  55. package/dist/client/usage/observationClient.d.ts +20 -0
  56. package/dist/client/usage/observationClient.d.ts.map +1 -1
  57. package/dist/client/usage/observationClient.js +20 -6
  58. package/dist/client/usage/observationClient.js.map +1 -1
  59. package/dist/client/usage/records.d.ts +1 -1
  60. package/dist/client/usage/records.d.ts.map +1 -1
  61. package/dist/client/usage/records.js.map +1 -1
  62. package/dist/client/usage/summary.d.ts +3 -0
  63. package/dist/client/usage/summary.d.ts.map +1 -1
  64. package/dist/client/usage/summary.js +9 -4
  65. package/dist/client/usage/summary.js.map +1 -1
  66. package/dist/client/usageExports.d.ts +2 -0
  67. package/dist/client/usageExports.d.ts.map +1 -1
  68. package/dist/component/_generated/api.d.ts +12 -0
  69. package/dist/component/_generated/api.d.ts.map +1 -1
  70. package/dist/component/_generated/api.js.map +1 -1
  71. package/dist/component/_generated/component.d.ts +255 -14
  72. package/dist/component/_generated/component.d.ts.map +1 -1
  73. package/dist/component/accountClosure/mutations.d.ts.map +1 -1
  74. package/dist/component/accountClosure/mutations.js +13 -0
  75. package/dist/component/accountClosure/mutations.js.map +1 -1
  76. package/dist/component/balanceFunding/mutations.d.ts +27 -27
  77. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  78. package/dist/component/earnings/triggers.d.ts +212 -26
  79. package/dist/component/earnings/triggers.d.ts.map +1 -1
  80. package/dist/component/schema.d.ts +119 -9
  81. package/dist/component/schema.js +4 -0
  82. package/dist/component/schema.js.map +1 -1
  83. package/dist/component/usage/queries.d.ts +2 -2
  84. package/dist/component/usage/schema.d.ts +18 -13
  85. package/dist/component/usage/schema.d.ts.map +1 -1
  86. package/dist/component/usage/schema.js +2 -1
  87. package/dist/component/usage/schema.js.map +1 -1
  88. package/dist/component/usageAllowance/queries.d.ts +1 -1
  89. package/dist/component/usageAllowance/queries.d.ts.map +1 -1
  90. package/dist/component/usageAllowance/queries.js +10 -1
  91. package/dist/component/usageAllowance/queries.js.map +1 -1
  92. package/dist/component/usageAllowance/schema.d.ts +5 -5
  93. package/dist/component/usageAllowance/schema.d.ts.map +1 -1
  94. package/dist/component/usageAllowance/schema.js +1 -1
  95. package/dist/component/usageAllowance/schema.js.map +1 -1
  96. package/dist/component/usageCorrections/accounting.d.ts +5 -0
  97. package/dist/component/usageCorrections/accounting.d.ts.map +1 -0
  98. package/dist/component/usageCorrections/accounting.js +55 -0
  99. package/dist/component/usageCorrections/accounting.js.map +1 -0
  100. package/dist/component/usageCorrections/cancellation.d.ts +6 -0
  101. package/dist/component/usageCorrections/cancellation.d.ts.map +1 -0
  102. package/dist/component/usageCorrections/cancellation.js +29 -0
  103. package/dist/component/usageCorrections/cancellation.js.map +1 -0
  104. package/dist/component/usageCorrections/helpers.d.ts +60 -0
  105. package/dist/component/usageCorrections/helpers.d.ts.map +1 -0
  106. package/dist/component/usageCorrections/helpers.js +52 -0
  107. package/dist/component/usageCorrections/helpers.js.map +1 -0
  108. package/dist/component/usageCorrections/invoice.d.ts +38 -0
  109. package/dist/component/usageCorrections/invoice.d.ts.map +1 -0
  110. package/dist/component/usageCorrections/invoice.js +82 -0
  111. package/dist/component/usageCorrections/invoice.js.map +1 -0
  112. package/dist/component/usageCorrections/mutations.d.ts +121 -0
  113. package/dist/component/usageCorrections/mutations.d.ts.map +1 -0
  114. package/dist/component/usageCorrections/mutations.js +256 -0
  115. package/dist/component/usageCorrections/mutations.js.map +1 -0
  116. package/dist/component/usageCorrections/queries.d.ts +115 -0
  117. package/dist/component/usageCorrections/queries.d.ts.map +1 -0
  118. package/dist/component/usageCorrections/queries.js +84 -0
  119. package/dist/component/usageCorrections/queries.js.map +1 -0
  120. package/dist/component/usageCorrections/schema.d.ts +248 -0
  121. package/dist/component/usageCorrections/schema.d.ts.map +1 -0
  122. package/dist/component/usageCorrections/schema.js +74 -0
  123. package/dist/component/usageCorrections/schema.js.map +1 -0
  124. package/dist/component/usageCredits/queries.d.ts +1 -1
  125. package/dist/component/usageCredits/queries.d.ts.map +1 -1
  126. package/dist/component/usageCredits/queries.js +6 -0
  127. package/dist/component/usageCredits/queries.js.map +1 -1
  128. package/dist/component/usageCredits/schema.d.ts +5 -5
  129. package/dist/component/usageCredits/schema.d.ts.map +1 -1
  130. package/dist/component/usageCredits/schema.js +1 -1
  131. package/dist/component/usageCredits/schema.js.map +1 -1
  132. package/dist/component/usageDelivery/fields.d.ts +2 -2
  133. package/dist/component/usageDelivery/fields.d.ts.map +1 -1
  134. package/dist/component/usageDelivery/fields.js +1 -1
  135. package/dist/component/usageDelivery/fields.js.map +1 -1
  136. package/dist/component/usageDelivery/helpers.d.ts +7 -6
  137. package/dist/component/usageDelivery/helpers.d.ts.map +1 -1
  138. package/dist/component/usageDelivery/mutations.d.ts +6 -6
  139. package/dist/component/usageDelivery/mutations.d.ts.map +1 -1
  140. package/dist/component/usageDelivery/mutations.js +9 -1
  141. package/dist/component/usageDelivery/mutations.js.map +1 -1
  142. package/dist/component/usageDelivery/queries.d.ts +8 -6
  143. package/dist/component/usageDelivery/queries.d.ts.map +1 -1
  144. package/dist/component/usageDelivery/schema.d.ts +4 -4
  145. package/dist/component/usageDelivery/steps.d.ts +2 -2
  146. package/dist/component/usageDelivery/steps.js +1 -1
  147. package/dist/component/usageDelivery/steps.js.map +1 -1
  148. package/dist/component/usageObservations/queries.d.ts.map +1 -1
  149. package/dist/component/usageObservations/queries.js +4 -2
  150. package/dist/component/usageObservations/queries.js.map +1 -1
  151. package/dist/component/usageSubscriptions/retirement.d.ts.map +1 -1
  152. package/dist/component/usageSubscriptions/retirement.js +24 -2
  153. package/dist/component/usageSubscriptions/retirement.js.map +1 -1
  154. package/docs/README.md +2 -0
  155. package/docs/usage-corrections.md +249 -0
  156. package/docs/usage-limits.md +1 -1
  157. package/package.json +2 -1
  158. package/src/client/usage/client.ts +2 -2
  159. package/src/client/usage/correctionClient.test.ts +153 -0
  160. package/src/client/usage/correctionClient.ts +62 -0
  161. package/src/client/usage/correctionCredits.test.ts +156 -0
  162. package/src/client/usage/correctionEligibility.ts +14 -0
  163. package/src/client/usage/correctionInvoice.test.ts +127 -0
  164. package/src/client/usage/correctionInvoice.ts +269 -0
  165. package/src/client/usage/correctionInvoiceProof.ts +40 -0
  166. package/src/client/usage/correctionProofs.ts +40 -0
  167. package/src/client/usage/correctionProvider.ts +326 -0
  168. package/src/client/usage/correctionRead.ts +73 -0
  169. package/src/client/usage/correctionRecovery.test.ts +113 -0
  170. package/src/client/usage/correctionTerms.ts +98 -0
  171. package/src/client/usage/correctionTransport.fixtures.ts +372 -0
  172. package/src/client/usage/index.ts +11 -0
  173. package/src/client/usage/observationClient.ts +20 -6
  174. package/src/client/usage/records.ts +7 -1
  175. package/src/client/usage/summary.ts +12 -4
  176. package/src/client/usageExports.ts +11 -0
  177. package/src/component/_generated/api.ts +12 -0
  178. package/src/component/_generated/component.ts +330 -2
  179. package/src/component/accountClosure/mutations.ts +17 -0
  180. package/src/component/schema.ts +8 -0
  181. package/src/component/usage/schema.ts +2 -0
  182. package/src/component/usageAllowance/queries.ts +8 -1
  183. package/src/component/usageAllowance/schema.ts +1 -0
  184. package/src/component/usageCorrections/accounting.ts +79 -0
  185. package/src/component/usageCorrections/cancellation.ts +32 -0
  186. package/src/component/usageCorrections/corrections.test.ts +389 -0
  187. package/src/component/usageCorrections/helpers.ts +57 -0
  188. package/src/component/usageCorrections/invoice.ts +103 -0
  189. package/src/component/usageCorrections/mutations.ts +278 -0
  190. package/src/component/usageCorrections/queries.ts +94 -0
  191. package/src/component/usageCorrections/schema.ts +90 -0
  192. package/src/component/usageCredits/queries.ts +4 -0
  193. package/src/component/usageCredits/schema.ts +1 -0
  194. package/src/component/usageDelivery/fields.ts +1 -0
  195. package/src/component/usageDelivery/mutations.ts +8 -3
  196. package/src/component/usageDelivery/steps.ts +1 -1
  197. package/src/component/usageObservations/queries.ts +5 -2
  198. package/src/component/usageSubscriptions/retirement.ts +31 -2
@@ -19,7 +19,7 @@ export const policiesTable = defineTable(fields)
19
19
  .index("by_scope_start", ["scopeKey", "start"]);
20
20
  export const historyFields = {
21
21
  key: v.string(),
22
- kind: v.union(v.literal("policy"), v.literal("reservation"), v.literal("commit"), v.literal("release")),
22
+ kind: v.union(v.literal("policy"), v.literal("reservation"), v.literal("commit"), v.literal("release"), v.literal("correction")),
23
23
  evidenceJson: v.string(),
24
24
  at: v.number(),
25
25
  };
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/usageAllowance/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC;AACF,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC;KAC7C,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;KACxB,KAAK,CAAC,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;KAChD,KAAK,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,KAAK,CACX,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EACnB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EACxB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EACnB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CACrB;IACD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC;AACF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,GAAG,aAAa;CACjB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/usageAllowance/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC;AACF,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC;KAC7C,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;KACxB,KAAK,CAAC,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;KAChD,KAAK,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,KAAK,CACX,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EACnB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EACxB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EACnB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CACxB;IACD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC;AACF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,GAAG,aAAa;CACjB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { MutationCtx } from "../_generated/server.js";
2
+ import type { Doc } from "../_generated/dataModel.js";
3
+ /** Called only for a full proven cancellation, in the same transaction as the terminal receipt. */
4
+ export declare function restore(ctx: MutationCtx, correction: Doc<"usageCorrections">, event: Doc<"usageEvents">): Promise<void>;
5
+ //# sourceMappingURL=accounting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accounting.d.ts","sourceRoot":"","sources":["../../../src/component/usageCorrections/accounting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAOtD,mGAAmG;AACnG,wBAAsB,OAAO,CAC3B,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,GAAG,CAAC,kBAAkB,CAAC,EACnC,KAAK,EAAE,GAAG,CAAC,aAAa,CAAC,iBAkE1B"}
@@ -0,0 +1,55 @@
1
+ import { creditAllocations } from "../usageCredits/reservations.js";
2
+ import { account, history as creditHistory } from "../usageCredits/helpers.js";
3
+ import { policyRow, history as allowanceHistory, } from "../usageAllowance/helpers.js";
4
+ /** Called only for a full proven cancellation, in the same transaction as the terminal receipt. */
5
+ export async function restore(ctx, correction, event) {
6
+ if (!event.reservationId)
7
+ return;
8
+ const reservation = await ctx.db.get("usageReservations", event.reservationId);
9
+ if (!reservation ||
10
+ reservation.state !== "committed" ||
11
+ reservation.eventId !== event._id ||
12
+ reservation.scopeKey !== correction.scopeKey ||
13
+ reservation.scaledQuantity !== correction.scaledQuantity)
14
+ throw new Error("Correction reservation provenance mismatch");
15
+ if (reservation.accountingKind === "allowance") {
16
+ const policy = await policyRow(ctx, reservation.accountKey);
17
+ if (!policy || BigInt(policy.consumed) < BigInt(correction.scaledQuantity))
18
+ throw new Error("Correction allowance backing unavailable");
19
+ await ctx.db.patch("usageAllowancePolicies", policy._id, {
20
+ consumed: (BigInt(policy.consumed) - BigInt(correction.scaledQuantity)).toString(),
21
+ });
22
+ await allowanceHistory(ctx, policy, "correction", {
23
+ correctionKey: correction.key,
24
+ eventId: event._id,
25
+ scaledQuantity: correction.scaledQuantity,
26
+ cashCollection: "none",
27
+ });
28
+ }
29
+ else if (reservation.accountingKind === "prepaid") {
30
+ const ledger = await account(ctx, reservation.accountKey);
31
+ if (ledger.closed || ledger.frozenReason)
32
+ throw new Error("Correction credit account requires reconciliation");
33
+ const allocations = creditAllocations.parse(JSON.parse(reservation.allocationsJson));
34
+ for (const allocation of allocations) {
35
+ const grant = await ctx.db.get("usageCreditGrants", allocation.grantId);
36
+ if (!grant ||
37
+ grant.accountKey !== ledger.key ||
38
+ grant.frozen ||
39
+ grant.nativeExpired ||
40
+ (grant.expiresAt !== null && grant.expiresAt <= Date.now() / 1000) ||
41
+ BigInt(grant.consumed) < BigInt(allocation.quantity))
42
+ throw new Error("Correction original credit backing unavailable");
43
+ await ctx.db.patch("usageCreditGrants", grant._id, {
44
+ consumed: (BigInt(grant.consumed) - BigInt(allocation.quantity)).toString(),
45
+ available: (BigInt(grant.available) + BigInt(allocation.quantity)).toString(),
46
+ });
47
+ }
48
+ await creditHistory(ctx, ledger.key, "correction", correction.key, {
49
+ eventId: event._id,
50
+ allocations,
51
+ cashCollection: "none",
52
+ });
53
+ }
54
+ }
55
+ //# sourceMappingURL=accounting.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accounting.js","sourceRoot":"","sources":["../../../src/component/usageCorrections/accounting.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { QueryCtx } from "../_generated/server.js";
2
+ import type { Doc } from "../_generated/dataModel.js";
3
+ /** Never treat an unproven terminal projection as canceled billable quantity. */
4
+ export declare function verifiedCancellation(ctx: QueryCtx, event: Doc<"usageEvents">, outbox: Doc<"usageOutbox"> | null): Promise<"confirmed" | "none" | "unverified">;
5
+ export declare const unresolvedCorrectionStates: readonly ["requested", "provider_accepted", "held", "invoice_adjustment_required"];
6
+ //# sourceMappingURL=cancellation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../../src/component/usageCorrections/cancellation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACtD,iFAAiF;AACjF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,GAAG,CAAC,aAAa,CAAC,EACzB,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,IAAI,gDAmBlC;AACD,eAAO,MAAM,0BAA0B,YACrC,WAAW,EACX,mBAAmB,EACnB,MAAM,EACN,6BAA6B,CACrB,CAAC"}
@@ -0,0 +1,29 @@
1
+ /** Never treat an unproven terminal projection as canceled billable quantity. */
2
+ export async function verifiedCancellation(ctx, event, outbox) {
3
+ if (outbox?.state !== "canceled")
4
+ return "none";
5
+ if (!outbox.correctionKey)
6
+ return "unverified";
7
+ const correction = await ctx.db
8
+ .query("usageCorrections")
9
+ .withIndex("by_key", (q) => q.eq("key", outbox.correctionKey))
10
+ .unique();
11
+ const record = JSON.parse(event.recordJson);
12
+ return correction?.state === "confirmed" &&
13
+ correction.resolution !== "invoice_credit" &&
14
+ correction.eventId === event._id &&
15
+ correction.scopeKey === event.scopeKey &&
16
+ correction.recordJson === event.recordJson &&
17
+ correction.subscriptionJson === event.subscriptionJson &&
18
+ correction.scaledQuantity === record.scaledQuantity &&
19
+ correction.restoredQuantity === record.quantity
20
+ ? "confirmed"
21
+ : "unverified";
22
+ }
23
+ export const unresolvedCorrectionStates = [
24
+ "requested",
25
+ "provider_accepted",
26
+ "held",
27
+ "invoice_adjustment_required",
28
+ ];
29
+ //# sourceMappingURL=cancellation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../../src/component/usageCorrections/cancellation.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAa,EACb,KAAyB,EACzB,MAAiC;IAEjC,IAAI,MAAM,EAAE,KAAK,KAAK,UAAU;QAAE,OAAO,MAAe,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,OAAO,YAAqB,CAAC;IACxD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,EAAE;SAC5B,KAAK,CAAC,kBAAkB,CAAC;SACzB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,aAAc,CAAC,CAAC;SAC9D,MAAM,EAAE,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,UAAU,EAAE,KAAK,KAAK,WAAW;QACtC,UAAU,CAAC,UAAU,KAAK,gBAAgB;QAC1C,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,GAAG;QAChC,UAAU,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QACtC,UAAU,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU;QAC1C,UAAU,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB;QACtD,UAAU,CAAC,cAAc,KAAK,MAAM,CAAC,cAAc;QACnD,UAAU,CAAC,gBAAgB,KAAK,MAAM,CAAC,QAAQ;QAC/C,CAAC,CAAE,WAAqB;QACxB,CAAC,CAAE,YAAsB,CAAC;AAC9B,CAAC;AACD,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW;IACX,mBAAmB;IACnB,MAAM;IACN,6BAA6B;CACrB,CAAC"}
@@ -0,0 +1,60 @@
1
+ import type { Value } from "convex/values";
2
+ import type { MutationCtx, QueryCtx } from "../_generated/server.js";
3
+ import type { Doc } from "../_generated/dataModel.js";
4
+ export declare const canonical: (value: Value) => string;
5
+ export declare function json(text: string): unknown;
6
+ export declare function input(text: string): Promise<{
7
+ request: {
8
+ scope: {
9
+ stripeAccountId: string;
10
+ customerAccount: string;
11
+ meterId: string;
12
+ livemode: boolean;
13
+ };
14
+ eventId: string;
15
+ correctionId: string;
16
+ actor: string;
17
+ reason: string;
18
+ operation: "cancel";
19
+ quantity?: string | undefined;
20
+ };
21
+ inputJson: string;
22
+ scopeKey: string;
23
+ key: string;
24
+ }>;
25
+ export declare function operation(ctx: QueryCtx, key: string): Promise<{
26
+ _creationTime: number;
27
+ _id: import("convex/values").GenericId<"usageCorrections">;
28
+ adjustmentJson?: string | undefined;
29
+ attempt: number;
30
+ attemptedAt?: number | undefined;
31
+ cashConsequence: "none" | "operator_resolution_required" | "verified_external_adjustment";
32
+ correctionId: string;
33
+ creditNoteId?: string | undefined;
34
+ customerAccount?: string | undefined;
35
+ eventId: import("convex/values").GenericId<"usageEvents">;
36
+ firstAttemptAt: number;
37
+ historyCount: number;
38
+ inputJson: string;
39
+ invoiceId?: string | undefined;
40
+ key: string;
41
+ leaseUntil?: number | undefined;
42
+ nativeAdjustmentId?: string | undefined;
43
+ nativeCreditNoteStatus?: "issued" | "void" | undefined;
44
+ nativeStatus?: "complete" | "pending" | undefined;
45
+ observedAt?: number | undefined;
46
+ quantity: string;
47
+ reason: string;
48
+ recordJson: string;
49
+ refundId?: string | undefined;
50
+ resolution?: "event_cancellation" | "invoice_credit" | undefined;
51
+ restoredQuantity: string;
52
+ scaledQuantity: string;
53
+ scopeKey: string;
54
+ state: "confirmed" | "held" | "invoice_adjustment_required" | "provider_accepted" | "requested" | "unsupported";
55
+ stripeAccountId?: string | undefined;
56
+ subscriptionJson: string;
57
+ }>;
58
+ export { correctionView as view } from "../../client/usage/correctionTerms.js";
59
+ export declare function history(ctx: MutationCtx, original: Doc<"usageCorrections">, evidence: Value): Promise<void>;
60
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/component/usageCorrections/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAItD,eAAO,MAAM,SAAS,UAAW,KAAK,WAAwC,CAAC;AAC/E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAGJ,OAAO,CACnC;AACD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;GAQvC;AACD,wBAAsB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOzD;AACD,OAAO,EAAE,cAAc,IAAI,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAC/E,wBAAsB,OAAO,CAC3B,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,GAAG,CAAC,kBAAkB,CAAC,EACjC,QAAQ,EAAE,KAAK,iBAsBhB"}
@@ -0,0 +1,52 @@
1
+ import { convexToJson } from "convex/values";
2
+ import { correctionRequest } from "../../client/usage/correctionTerms.js";
3
+ import { canonicalFingerprint } from "../operationEvidence/canonical.js";
4
+ import { scopeKey } from "../usage/helpers.js";
5
+ export const canonical = (value) => JSON.stringify(convexToJson(value));
6
+ export function json(text) {
7
+ if (new TextEncoder().encode(text).length > 8192)
8
+ throw new Error("Correction payload exceeds size limit");
9
+ return JSON.parse(text);
10
+ }
11
+ export async function input(text) {
12
+ const request = correctionRequest.parse(json(text));
13
+ return {
14
+ request,
15
+ inputJson: canonical(request),
16
+ scopeKey: scopeKey(request.scope),
17
+ key: await canonicalFingerprint([request.scope, request.correctionId]),
18
+ };
19
+ }
20
+ export async function operation(ctx, key) {
21
+ const row = await ctx.db
22
+ .query("usageCorrections")
23
+ .withIndex("by_key", (q) => q.eq("key", key))
24
+ .unique();
25
+ if (!row)
26
+ throw new Error("Usage correction unavailable");
27
+ return row;
28
+ }
29
+ export { correctionView as view } from "../../client/usage/correctionTerms.js";
30
+ export async function history(ctx, original, evidence) {
31
+ const row = await operation(ctx, original.key);
32
+ if (row.historyCount >= 1000)
33
+ throw new Error("Correction history quota exhausted");
34
+ await ctx.db.insert("usageCorrectionHistory", {
35
+ key: row.key,
36
+ scopeKey: row.scopeKey,
37
+ eventId: row.eventId,
38
+ sequence: row.historyCount + 1,
39
+ state: row.state,
40
+ reason: row.reason,
41
+ recordJson: row.recordJson,
42
+ subscriptionJson: row.subscriptionJson,
43
+ evidenceJson: canonical(evidence),
44
+ occurredAt: JSON.parse(row.recordJson).occurredAt,
45
+ at: Math.floor(Date.now() / 1000),
46
+ });
47
+ await ctx.db.patch("usageCorrections", row._id, {
48
+ historyCount: row.historyCount + 1,
49
+ observedAt: Math.floor(Date.now() / 1000),
50
+ });
51
+ }
52
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/component/usageCorrections/helpers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import type { MutationCtx } from "../_generated/server.js";
2
+ export declare function adoptInvoiceCorrection(ctx: MutationCtx, args: {
3
+ key: string;
4
+ proofJson: string;
5
+ }): Promise<{
6
+ _creationTime: number;
7
+ _id: import("convex/values").GenericId<"usageCorrections">;
8
+ adjustmentJson?: string | undefined;
9
+ attempt: number;
10
+ attemptedAt?: number | undefined;
11
+ cashConsequence: "none" | "operator_resolution_required" | "verified_external_adjustment";
12
+ correctionId: string;
13
+ creditNoteId?: string | undefined;
14
+ customerAccount?: string | undefined;
15
+ eventId: import("convex/values").GenericId<"usageEvents">;
16
+ firstAttemptAt: number;
17
+ historyCount: number;
18
+ inputJson: string;
19
+ invoiceId?: string | undefined;
20
+ key: string;
21
+ leaseUntil?: number | undefined;
22
+ nativeAdjustmentId?: string | undefined;
23
+ nativeCreditNoteStatus?: "issued" | "void" | undefined;
24
+ nativeStatus?: "complete" | "pending" | undefined;
25
+ observedAt?: number | undefined;
26
+ quantity: string;
27
+ reason: string;
28
+ recordJson: string;
29
+ refundId?: string | undefined;
30
+ resolution?: "event_cancellation" | "invoice_credit" | undefined;
31
+ restoredQuantity: string;
32
+ scaledQuantity: string;
33
+ scopeKey: string;
34
+ state: "confirmed" | "held" | "invoice_adjustment_required" | "provider_accepted" | "requested" | "unsupported";
35
+ stripeAccountId?: string | undefined;
36
+ subscriptionJson: string;
37
+ }>;
38
+ //# sourceMappingURL=invoice.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../../src/component/usageCorrections/invoice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+FzC"}
@@ -0,0 +1,82 @@
1
+ import { json, canonical, operation, history, view } from "./helpers.js";
2
+ import { invoiceCorrectionProof } from "../../client/usage/correctionInvoiceProof.js";
3
+ import { subscriptionSnapshot } from "../usage/helpers.js";
4
+ export async function adoptInvoiceCorrection(ctx, args) {
5
+ const row = await operation(ctx, args.key), proof = invoiceCorrectionProof.parse(json(args.proofJson)), proofJson = canonical({ ...proof, creditNoteStatus: "issued" });
6
+ if ((row.leaseUntil ?? 0) > Date.now() / 1000)
7
+ throw new Error("Active native correction attempt must finish before financial adoption");
8
+ const event = JSON.parse(row.recordJson), sub = subscriptionSnapshot(row.subscriptionJson);
9
+ if (proof.stripeAccountId !== event.scope.stripeAccountId ||
10
+ proof.livemode !== event.scope.livemode ||
11
+ proof.customerAccount !== event.scope.customerAccount ||
12
+ proof.stripeCustomerId !== event.binding.stripeCustomerId ||
13
+ proof.subscriptionId !== sub.subscriptionId ||
14
+ proof.subscriptionItemId !== sub.subscriptionItemId ||
15
+ proof.stripePriceId !== event.binding.stripePriceId ||
16
+ proof.period.start !== sub.period.start ||
17
+ proof.period.end !== sub.period.end ||
18
+ proof.currency !== event.binding.plan.rate.currency ||
19
+ proof.amount !== proof.prePaymentAmount + proof.postPaymentAmount ||
20
+ (proof.postPaymentAmount > 0 &&
21
+ (!proof.refundId || !proof.paymentIntentId || !proof.chargeId)))
22
+ throw new Error("Invoice correction provenance mismatch");
23
+ if (row.adjustmentJson) {
24
+ if (row.adjustmentJson !== proofJson)
25
+ throw new Error("Invoice adjustment replay conflict");
26
+ if (row.nativeCreditNoteStatus === "void" ||
27
+ row.nativeCreditNoteStatus === proof.creditNoteStatus)
28
+ return row;
29
+ }
30
+ if ((row.state === "confirmed" && !row.adjustmentJson) ||
31
+ event.binding.plan.model === "prepaid")
32
+ throw new Error("Invoice credit cannot restore native usage or prepaid units");
33
+ for (const source of [
34
+ proof.creditNoteId,
35
+ ...(proof.refundId ? [proof.refundId] : []),
36
+ ]) {
37
+ const key = canonical([
38
+ event.scope.stripeAccountId,
39
+ event.scope.livemode,
40
+ source,
41
+ ]);
42
+ const prior = await ctx.db
43
+ .query("usageCorrectionClaims")
44
+ .withIndex("by_key", (q) => q.eq("key", key))
45
+ .unique();
46
+ if (prior &&
47
+ (prior.operationKey !== row.key || prior.proofJson !== proofJson))
48
+ throw new Error("Native financial adjustment already claimed");
49
+ if (!prior)
50
+ await ctx.db.insert("usageCorrectionClaims", {
51
+ key,
52
+ operationKey: row.key,
53
+ proofJson,
54
+ });
55
+ }
56
+ await ctx.db.patch("usageCorrections", row._id, {
57
+ state: "confirmed",
58
+ resolution: "invoice_credit",
59
+ reason: proof.creditNoteStatus === "void"
60
+ ? "native_invoice_credit_voided"
61
+ : "verified_native_invoice_credit",
62
+ nativeCreditNoteStatus: proof.creditNoteStatus,
63
+ creditNoteId: proof.creditNoteId,
64
+ invoiceId: proof.invoiceId,
65
+ refundId: proof.refundId ?? undefined,
66
+ adjustmentJson: proofJson,
67
+ cashConsequence: proof.creditNoteStatus === "void"
68
+ ? "none"
69
+ : "verified_external_adjustment",
70
+ restoredQuantity: "0",
71
+ leaseUntil: 0,
72
+ });
73
+ const saved = await operation(ctx, row.key);
74
+ await history(ctx, saved, {
75
+ proof,
76
+ result: view(saved),
77
+ usageTreatment: "retain_original_consumption",
78
+ cashCollection: "none",
79
+ });
80
+ return operation(ctx, row.key);
81
+ }
82
+ //# sourceMappingURL=invoice.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoice.js","sourceRoot":"","sources":["../../../src/component/usageCorrections/invoice.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,121 @@
1
+ export declare const prepare: import("convex/server").RegisteredMutation<"public", {
2
+ inputJson: string;
3
+ }, Promise<{
4
+ _creationTime: number;
5
+ _id: import("convex/values").GenericId<"usageCorrections">;
6
+ adjustmentJson?: string | undefined;
7
+ attempt: number;
8
+ attemptedAt?: number | undefined;
9
+ cashConsequence: "none" | "operator_resolution_required" | "verified_external_adjustment";
10
+ correctionId: string;
11
+ creditNoteId?: string | undefined;
12
+ customerAccount?: string | undefined;
13
+ eventId: import("convex/values").GenericId<"usageEvents">;
14
+ firstAttemptAt: number;
15
+ historyCount: number;
16
+ inputJson: string;
17
+ invoiceId?: string | undefined;
18
+ key: string;
19
+ leaseUntil?: number | undefined;
20
+ nativeAdjustmentId?: string | undefined;
21
+ nativeCreditNoteStatus?: "issued" | "void" | undefined;
22
+ nativeStatus?: "complete" | "pending" | undefined;
23
+ observedAt?: number | undefined;
24
+ quantity: string;
25
+ reason: string;
26
+ recordJson: string;
27
+ refundId?: string | undefined;
28
+ resolution?: "event_cancellation" | "invoice_credit" | undefined;
29
+ restoredQuantity: string;
30
+ scaledQuantity: string;
31
+ scopeKey: string;
32
+ state: "confirmed" | "held" | "invoice_adjustment_required" | "provider_accepted" | "requested" | "unsupported";
33
+ stripeAccountId?: string | undefined;
34
+ subscriptionJson: string;
35
+ }>>;
36
+ export declare const claim: import("convex/server").RegisteredMutation<"public", {
37
+ key: string;
38
+ }, Promise<{
39
+ kind: "done";
40
+ attempt: number;
41
+ } | {
42
+ kind: "busy";
43
+ attempt: number;
44
+ } | {
45
+ kind: "ready";
46
+ attempt: number;
47
+ }>>;
48
+ export declare const save: import("convex/server").RegisteredMutation<"public", {
49
+ attempt: number;
50
+ key: string;
51
+ outcomeJson: string;
52
+ }, Promise<{
53
+ _creationTime: number;
54
+ _id: import("convex/values").GenericId<"usageCorrections">;
55
+ adjustmentJson?: string | undefined;
56
+ attempt: number;
57
+ attemptedAt?: number | undefined;
58
+ cashConsequence: "none" | "operator_resolution_required" | "verified_external_adjustment";
59
+ correctionId: string;
60
+ creditNoteId?: string | undefined;
61
+ customerAccount?: string | undefined;
62
+ eventId: import("convex/values").GenericId<"usageEvents">;
63
+ firstAttemptAt: number;
64
+ historyCount: number;
65
+ inputJson: string;
66
+ invoiceId?: string | undefined;
67
+ key: string;
68
+ leaseUntil?: number | undefined;
69
+ nativeAdjustmentId?: string | undefined;
70
+ nativeCreditNoteStatus?: "issued" | "void" | undefined;
71
+ nativeStatus?: "complete" | "pending" | undefined;
72
+ observedAt?: number | undefined;
73
+ quantity: string;
74
+ reason: string;
75
+ recordJson: string;
76
+ refundId?: string | undefined;
77
+ resolution?: "event_cancellation" | "invoice_credit" | undefined;
78
+ restoredQuantity: string;
79
+ scaledQuantity: string;
80
+ scopeKey: string;
81
+ state: "confirmed" | "held" | "invoice_adjustment_required" | "provider_accepted" | "requested" | "unsupported";
82
+ stripeAccountId?: string | undefined;
83
+ subscriptionJson: string;
84
+ }>>;
85
+ export declare const adopt: import("convex/server").RegisteredMutation<"public", {
86
+ key: string;
87
+ proofJson: string;
88
+ }, Promise<{
89
+ _creationTime: number;
90
+ _id: import("convex/values").GenericId<"usageCorrections">;
91
+ adjustmentJson?: string | undefined;
92
+ attempt: number;
93
+ attemptedAt?: number | undefined;
94
+ cashConsequence: "none" | "operator_resolution_required" | "verified_external_adjustment";
95
+ correctionId: string;
96
+ creditNoteId?: string | undefined;
97
+ customerAccount?: string | undefined;
98
+ eventId: import("convex/values").GenericId<"usageEvents">;
99
+ firstAttemptAt: number;
100
+ historyCount: number;
101
+ inputJson: string;
102
+ invoiceId?: string | undefined;
103
+ key: string;
104
+ leaseUntil?: number | undefined;
105
+ nativeAdjustmentId?: string | undefined;
106
+ nativeCreditNoteStatus?: "issued" | "void" | undefined;
107
+ nativeStatus?: "complete" | "pending" | undefined;
108
+ observedAt?: number | undefined;
109
+ quantity: string;
110
+ reason: string;
111
+ recordJson: string;
112
+ refundId?: string | undefined;
113
+ resolution?: "event_cancellation" | "invoice_credit" | undefined;
114
+ restoredQuantity: string;
115
+ scaledQuantity: string;
116
+ scopeKey: string;
117
+ state: "confirmed" | "held" | "invoice_adjustment_required" | "provider_accepted" | "requested" | "unsupported";
118
+ stripeAccountId?: string | undefined;
119
+ subscriptionJson: string;
120
+ }>>;
121
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/usageCorrections/mutations.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGlB,CAAC;AAEH,eAAO,MAAM,KAAK;;;UAiBG,MAAM;;;UAEN,MAAM;;;UAmCR,OAAO;;GAExB,CAAC;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGf,CAAC;AAEH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAIhB,CAAC"}