@fantastic.dev/better-stripe 0.54.0 → 0.56.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 (282) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +3 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +264 -8
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +132 -4
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +264 -8
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +132 -4
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +9 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +1 -0
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/usage/catalogPrices.d.ts +2 -0
  16. package/dist/client/usage/catalogPrices.d.ts.map +1 -1
  17. package/dist/client/usage/catalogPrices.js +15 -0
  18. package/dist/client/usage/catalogPrices.js.map +1 -1
  19. package/dist/client/usage/client.d.ts +2 -2
  20. package/dist/client/usage/client.d.ts.map +1 -1
  21. package/dist/client/usage/client.js +2 -2
  22. package/dist/client/usage/client.js.map +1 -1
  23. package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
  24. package/dist/client/usage/deliveryProvider.js +26 -1
  25. package/dist/client/usage/deliveryProvider.js.map +1 -1
  26. package/dist/client/usage/index.d.ts +9 -0
  27. package/dist/client/usage/index.d.ts.map +1 -1
  28. package/dist/client/usage/index.js +1 -0
  29. package/dist/client/usage/index.js.map +1 -1
  30. package/dist/client/usage/invoiceObservation.d.ts +38 -0
  31. package/dist/client/usage/invoiceObservation.d.ts.map +1 -0
  32. package/dist/client/usage/invoiceObservation.js +157 -0
  33. package/dist/client/usage/invoiceObservation.js.map +1 -0
  34. package/dist/client/usage/observationClient.d.ts +83 -0
  35. package/dist/client/usage/observationClient.d.ts.map +1 -0
  36. package/dist/client/usage/observationClient.js +157 -0
  37. package/dist/client/usage/observationClient.js.map +1 -0
  38. package/dist/client/usage/observationTypes.d.ts +63 -0
  39. package/dist/client/usage/observationTypes.d.ts.map +1 -0
  40. package/dist/client/usage/observationTypes.js +59 -0
  41. package/dist/client/usage/observationTypes.js.map +1 -0
  42. package/dist/client/usage/providerObservation.d.ts +4 -0
  43. package/dist/client/usage/providerObservation.d.ts.map +1 -0
  44. package/dist/client/usage/providerObservation.js +96 -0
  45. package/dist/client/usage/providerObservation.js.map +1 -0
  46. package/dist/client/usage/reconciliation.d.ts +12 -0
  47. package/dist/client/usage/reconciliation.d.ts.map +1 -0
  48. package/dist/client/usage/reconciliation.js +48 -0
  49. package/dist/client/usage/reconciliation.js.map +1 -0
  50. package/dist/client/usage/subscription.fixtures.d.ts +118 -0
  51. package/dist/client/usage/subscription.fixtures.d.ts.map +1 -0
  52. package/dist/client/usage/subscription.fixtures.js +84 -0
  53. package/dist/client/usage/subscription.fixtures.js.map +1 -0
  54. package/dist/client/usage/subscriptionAbandonment.d.ts +8 -0
  55. package/dist/client/usage/subscriptionAbandonment.d.ts.map +1 -0
  56. package/dist/client/usage/subscriptionAbandonment.js +82 -0
  57. package/dist/client/usage/subscriptionAbandonment.js.map +1 -0
  58. package/dist/client/usage/subscriptionCancellation.d.ts +9 -0
  59. package/dist/client/usage/subscriptionCancellation.d.ts.map +1 -0
  60. package/dist/client/usage/subscriptionCancellation.js +39 -0
  61. package/dist/client/usage/subscriptionCancellation.js.map +1 -0
  62. package/dist/client/usage/subscriptionCheckout.d.ts +52 -0
  63. package/dist/client/usage/subscriptionCheckout.d.ts.map +1 -0
  64. package/dist/client/usage/subscriptionCheckout.js +94 -0
  65. package/dist/client/usage/subscriptionCheckout.js.map +1 -0
  66. package/dist/client/usage/subscriptionClient.d.ts +267 -0
  67. package/dist/client/usage/subscriptionClient.d.ts.map +1 -0
  68. package/dist/client/usage/subscriptionClient.js +93 -0
  69. package/dist/client/usage/subscriptionClient.js.map +1 -0
  70. package/dist/client/usage/subscriptionErrors.d.ts +5 -0
  71. package/dist/client/usage/subscriptionErrors.d.ts.map +1 -0
  72. package/dist/client/usage/subscriptionErrors.js +9 -0
  73. package/dist/client/usage/subscriptionErrors.js.map +1 -0
  74. package/dist/client/usage/subscriptionInvoiceSchema.d.ts +203 -0
  75. package/dist/client/usage/subscriptionInvoiceSchema.d.ts.map +1 -0
  76. package/dist/client/usage/subscriptionInvoiceSchema.js +108 -0
  77. package/dist/client/usage/subscriptionInvoiceSchema.js.map +1 -0
  78. package/dist/client/usage/subscriptionLifecycle.d.ts +80 -0
  79. package/dist/client/usage/subscriptionLifecycle.d.ts.map +1 -0
  80. package/dist/client/usage/subscriptionLifecycle.js +87 -0
  81. package/dist/client/usage/subscriptionLifecycle.js.map +1 -0
  82. package/dist/client/usage/subscriptionProvider.d.ts +111 -0
  83. package/dist/client/usage/subscriptionProvider.d.ts.map +1 -0
  84. package/dist/client/usage/subscriptionProvider.js +147 -0
  85. package/dist/client/usage/subscriptionProvider.js.map +1 -0
  86. package/dist/client/usage/subscriptionTerms.d.ts +161 -0
  87. package/dist/client/usage/subscriptionTerms.d.ts.map +1 -0
  88. package/dist/client/usage/subscriptionTerms.js +242 -0
  89. package/dist/client/usage/subscriptionTerms.js.map +1 -0
  90. package/dist/client/usage/subscriptionTransport.fixtures.d.ts +25 -0
  91. package/dist/client/usage/subscriptionTransport.fixtures.d.ts.map +1 -0
  92. package/dist/client/usage/subscriptionTransport.fixtures.js +203 -0
  93. package/dist/client/usage/subscriptionTransport.fixtures.js.map +1 -0
  94. package/dist/client/usage/summary.d.ts +50 -0
  95. package/dist/client/usage/summary.d.ts.map +1 -0
  96. package/dist/client/usage/summary.js +110 -0
  97. package/dist/client/usage/summary.js.map +1 -0
  98. package/dist/client/webhooks/processors.d.ts.map +1 -1
  99. package/dist/client/webhooks/processors.js +2 -0
  100. package/dist/client/webhooks/processors.js.map +1 -1
  101. package/dist/client/webhooks/usageSubscriptions.d.ts +5 -0
  102. package/dist/client/webhooks/usageSubscriptions.d.ts.map +1 -0
  103. package/dist/client/webhooks/usageSubscriptions.js +54 -0
  104. package/dist/client/webhooks/usageSubscriptions.js.map +1 -0
  105. package/dist/component/_generated/api.d.ts +22 -0
  106. package/dist/component/_generated/api.d.ts.map +1 -1
  107. package/dist/component/_generated/api.js.map +1 -1
  108. package/dist/component/_generated/component.d.ts +255 -5
  109. package/dist/component/_generated/component.d.ts.map +1 -1
  110. package/dist/component/accountClosure/mutations.d.ts.map +1 -1
  111. package/dist/component/accountClosure/mutations.js +10 -0
  112. package/dist/component/accountClosure/mutations.js.map +1 -1
  113. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  114. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  115. package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
  116. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  117. package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
  118. package/dist/component/earnings/triggers.d.ts +296 -22
  119. package/dist/component/earnings/triggers.d.ts.map +1 -1
  120. package/dist/component/payoutRelease/queries.d.ts +2 -2
  121. package/dist/component/payoutRelease/queries.d.ts.map +1 -1
  122. package/dist/component/refundHistory/queries.d.ts +1 -1
  123. package/dist/component/schema.d.ts +132 -4
  124. package/dist/component/schema.js +8 -0
  125. package/dist/component/schema.js.map +1 -1
  126. package/dist/component/usage/mutations.d.ts.map +1 -1
  127. package/dist/component/usage/mutations.js +5 -0
  128. package/dist/component/usage/mutations.js.map +1 -1
  129. package/dist/component/usage/queries.d.ts +2 -0
  130. package/dist/component/usage/queries.d.ts.map +1 -1
  131. package/dist/component/usage/schema.d.ts +21 -9
  132. package/dist/component/usage/schema.d.ts.map +1 -1
  133. package/dist/component/usage/schema.js +5 -1
  134. package/dist/component/usage/schema.js.map +1 -1
  135. package/dist/component/usageDelivery/fields.d.ts +4 -2
  136. package/dist/component/usageDelivery/fields.d.ts.map +1 -1
  137. package/dist/component/usageDelivery/fields.js +3 -1
  138. package/dist/component/usageDelivery/fields.js.map +1 -1
  139. package/dist/component/usageDelivery/helpers.d.ts +5 -3
  140. package/dist/component/usageDelivery/helpers.d.ts.map +1 -1
  141. package/dist/component/usageDelivery/mutations.d.ts +3 -3
  142. package/dist/component/usageDelivery/mutations.d.ts.map +1 -1
  143. package/dist/component/usageDelivery/mutations.js +8 -1
  144. package/dist/component/usageDelivery/mutations.js.map +1 -1
  145. package/dist/component/usageDelivery/queries.d.ts +19 -3
  146. package/dist/component/usageDelivery/queries.d.ts.map +1 -1
  147. package/dist/component/usageDelivery/queries.js +20 -3
  148. package/dist/component/usageDelivery/queries.js.map +1 -1
  149. package/dist/component/usageDelivery/schema.d.ts +2 -2
  150. package/dist/component/usageDelivery/steps.d.ts +1 -1
  151. package/dist/component/usageDelivery/steps.d.ts.map +1 -1
  152. package/dist/component/usageDelivery/steps.js +20 -2
  153. package/dist/component/usageDelivery/steps.js.map +1 -1
  154. package/dist/component/usageObservations/helpers.d.ts +38 -0
  155. package/dist/component/usageObservations/helpers.d.ts.map +1 -0
  156. package/dist/component/usageObservations/helpers.js +80 -0
  157. package/dist/component/usageObservations/helpers.js.map +1 -0
  158. package/dist/component/usageObservations/history.d.ts +6 -0
  159. package/dist/component/usageObservations/history.d.ts.map +1 -0
  160. package/dist/component/usageObservations/history.js +29 -0
  161. package/dist/component/usageObservations/history.js.map +1 -0
  162. package/dist/component/usageObservations/mutations.d.ts +6 -0
  163. package/dist/component/usageObservations/mutations.d.ts.map +1 -0
  164. package/dist/component/usageObservations/mutations.js +39 -0
  165. package/dist/component/usageObservations/mutations.js.map +1 -0
  166. package/dist/component/usageObservations/queries.d.ts +78 -0
  167. package/dist/component/usageObservations/queries.d.ts.map +1 -0
  168. package/dist/component/usageObservations/queries.js +131 -0
  169. package/dist/component/usageObservations/queries.js.map +1 -0
  170. package/dist/component/usageObservations/schema.d.ts +72 -0
  171. package/dist/component/usageObservations/schema.d.ts.map +1 -0
  172. package/dist/component/usageObservations/schema.js +29 -0
  173. package/dist/component/usageObservations/schema.js.map +1 -0
  174. package/dist/component/usageSubscriptions/abandonment.d.ts +4 -0
  175. package/dist/component/usageSubscriptions/abandonment.d.ts.map +1 -0
  176. package/dist/component/usageSubscriptions/abandonment.js +59 -0
  177. package/dist/component/usageSubscriptions/abandonment.js.map +1 -0
  178. package/dist/component/usageSubscriptions/acceptance.d.ts +11 -0
  179. package/dist/component/usageSubscriptions/acceptance.d.ts.map +1 -0
  180. package/dist/component/usageSubscriptions/acceptance.js +38 -0
  181. package/dist/component/usageSubscriptions/acceptance.js.map +1 -0
  182. package/dist/component/usageSubscriptions/helpers.d.ts +39 -0
  183. package/dist/component/usageSubscriptions/helpers.d.ts.map +1 -0
  184. package/dist/component/usageSubscriptions/helpers.js +28 -0
  185. package/dist/component/usageSubscriptions/helpers.js.map +1 -0
  186. package/dist/component/usageSubscriptions/history.d.ts +46 -0
  187. package/dist/component/usageSubscriptions/history.d.ts.map +1 -0
  188. package/dist/component/usageSubscriptions/history.js +46 -0
  189. package/dist/component/usageSubscriptions/history.js.map +1 -0
  190. package/dist/component/usageSubscriptions/mutations.d.ts +64 -0
  191. package/dist/component/usageSubscriptions/mutations.d.ts.map +1 -0
  192. package/dist/component/usageSubscriptions/mutations.js +252 -0
  193. package/dist/component/usageSubscriptions/mutations.js.map +1 -0
  194. package/dist/component/usageSubscriptions/queries.d.ts +81 -0
  195. package/dist/component/usageSubscriptions/queries.d.ts.map +1 -0
  196. package/dist/component/usageSubscriptions/queries.js +70 -0
  197. package/dist/component/usageSubscriptions/queries.js.map +1 -0
  198. package/dist/component/usageSubscriptions/retirement.d.ts +4 -0
  199. package/dist/component/usageSubscriptions/retirement.d.ts.map +1 -0
  200. package/dist/component/usageSubscriptions/retirement.js +80 -0
  201. package/dist/component/usageSubscriptions/retirement.js.map +1 -0
  202. package/dist/component/usageSubscriptions/schema.d.ts +191 -0
  203. package/dist/component/usageSubscriptions/schema.d.ts.map +1 -0
  204. package/dist/component/usageSubscriptions/schema.js +69 -0
  205. package/dist/component/usageSubscriptions/schema.js.map +1 -0
  206. package/dist/test.d.ts +6 -0
  207. package/dist/test.d.ts.map +1 -0
  208. package/dist/test.js +15 -0
  209. package/dist/test.js.map +1 -0
  210. package/docs/README.md +4 -0
  211. package/docs/evidence/native-metering/clock-finalization-run.json +129 -0
  212. package/docs/evidence/native-metering/clock-lag-run.json +111 -0
  213. package/docs/evidence/native-metering/paid-run.json +107 -0
  214. package/docs/evidence/native-metering/promotional-run.json +103 -0
  215. package/docs/metered-usage.md +14 -0
  216. package/docs/metering-setup.md +7 -1
  217. package/docs/usage-observations.md +152 -0
  218. package/docs/usage-subscriptions.md +278 -0
  219. package/package.json +5 -2
  220. package/src/client/index.ts +26 -0
  221. package/src/client/usage/catalogPrices.ts +21 -0
  222. package/src/client/usage/client.ts +2 -2
  223. package/src/client/usage/deliveryProvider.test.ts +70 -1
  224. package/src/client/usage/deliveryProvider.ts +43 -2
  225. package/src/client/usage/index.ts +27 -0
  226. package/src/client/usage/invoiceObservation.test.ts +195 -0
  227. package/src/client/usage/invoiceObservation.ts +203 -0
  228. package/src/client/usage/observationClient.ts +233 -0
  229. package/src/client/usage/observationTypes.ts +101 -0
  230. package/src/client/usage/providerObservation.test.ts +207 -0
  231. package/src/client/usage/providerObservation.ts +124 -0
  232. package/src/client/usage/reconciliation.test.ts +117 -0
  233. package/src/client/usage/reconciliation.ts +86 -0
  234. package/src/client/usage/subscription.fixtures.ts +84 -0
  235. package/src/client/usage/subscriptionAbandonment.test.ts +124 -0
  236. package/src/client/usage/subscriptionAbandonment.ts +116 -0
  237. package/src/client/usage/subscriptionCancellation.ts +90 -0
  238. package/src/client/usage/subscriptionCheckout.test.ts +31 -0
  239. package/src/client/usage/subscriptionCheckout.ts +152 -0
  240. package/src/client/usage/subscriptionClient.test.ts +316 -0
  241. package/src/client/usage/subscriptionClient.ts +204 -0
  242. package/src/client/usage/subscriptionErrors.ts +14 -0
  243. package/src/client/usage/subscriptionInvoiceSchema.ts +116 -0
  244. package/src/client/usage/subscriptionLifecycle.ts +165 -0
  245. package/src/client/usage/subscriptionProvider.test.ts +48 -0
  246. package/src/client/usage/subscriptionProvider.ts +247 -0
  247. package/src/client/usage/subscriptionTerms.test.ts +158 -0
  248. package/src/client/usage/subscriptionTerms.ts +294 -0
  249. package/src/client/usage/subscriptionTransport.fixtures.ts +241 -0
  250. package/src/client/usage/summary.test.ts +222 -0
  251. package/src/client/usage/summary.ts +188 -0
  252. package/src/client/webhooks/processors.ts +2 -0
  253. package/src/client/webhooks/usageSubscriptions.test.ts +162 -0
  254. package/src/client/webhooks/usageSubscriptions.ts +81 -0
  255. package/src/component/_generated/api.ts +22 -0
  256. package/src/component/_generated/component.ts +335 -0
  257. package/src/component/accountClosure/mutations.ts +12 -0
  258. package/src/component/schema.ts +16 -0
  259. package/src/component/usage/mutations.ts +5 -0
  260. package/src/component/usage/schema.ts +5 -1
  261. package/src/component/usageDelivery/fields.ts +3 -0
  262. package/src/component/usageDelivery/mutations.ts +26 -1
  263. package/src/component/usageDelivery/queries.ts +30 -3
  264. package/src/component/usageDelivery/steps.ts +61 -2
  265. package/src/component/usageObservations/helpers.ts +95 -0
  266. package/src/component/usageObservations/history.test.ts +87 -0
  267. package/src/component/usageObservations/history.ts +39 -0
  268. package/src/component/usageObservations/mutations.ts +39 -0
  269. package/src/component/usageObservations/queries.test.ts +162 -0
  270. package/src/component/usageObservations/queries.ts +145 -0
  271. package/src/component/usageObservations/schema.ts +40 -0
  272. package/src/component/usageSubscriptions/abandonment.ts +80 -0
  273. package/src/component/usageSubscriptions/acceptance.test.ts +122 -0
  274. package/src/component/usageSubscriptions/acceptance.ts +66 -0
  275. package/src/component/usageSubscriptions/helpers.ts +33 -0
  276. package/src/component/usageSubscriptions/history.test.ts +69 -0
  277. package/src/component/usageSubscriptions/history.ts +68 -0
  278. package/src/component/usageSubscriptions/mutations.test.ts +205 -0
  279. package/src/component/usageSubscriptions/mutations.ts +275 -0
  280. package/src/component/usageSubscriptions/queries.ts +78 -0
  281. package/src/component/usageSubscriptions/retirement.ts +105 -0
  282. package/src/component/usageSubscriptions/schema.ts +73 -0
@@ -0,0 +1,203 @@
1
+ import { z } from "zod";
2
+ export declare const managedInvoiceObservationSchema: z.ZodUnion<readonly [z.ZodObject<{
3
+ status: z.ZodEnum<{
4
+ unavailable: "unavailable";
5
+ unsupported: "unsupported";
6
+ }>;
7
+ reason: z.ZodEnum<{
8
+ ambiguous_invoice_items: "ambiguous_invoice_items";
9
+ invoice_binding_mismatch: "invoice_binding_mismatch";
10
+ invoice_history_incomplete: "invoice_history_incomplete";
11
+ invoice_unavailable: "invoice_unavailable";
12
+ metered_lines_not_observed: "metered_lines_not_observed";
13
+ provider_binding_mismatch: "provider_binding_mismatch";
14
+ unsupported_scope: "unsupported_scope";
15
+ }>;
16
+ retryable: z.ZodBoolean;
17
+ }, z.core.$strict>, z.ZodObject<{
18
+ status: z.ZodLiteral<"available">;
19
+ observedAt: z.ZodNumber;
20
+ value: z.ZodObject<{
21
+ kind: z.ZodLiteral<"invoice">;
22
+ invoiceId: z.ZodString;
23
+ status: z.ZodEnum<{
24
+ draft: "draft";
25
+ open: "open";
26
+ paid: "paid";
27
+ uncollectible: "uncollectible";
28
+ void: "void";
29
+ }>;
30
+ finalized: z.ZodBoolean;
31
+ amountDue: z.ZodString;
32
+ amountPaid: z.ZodString;
33
+ total: z.ZodString;
34
+ currency: z.ZodString;
35
+ linesComplete: z.ZodBoolean;
36
+ paymentEvidence: z.ZodLiteral<"not_resolved">;
37
+ meterAmount: z.ZodUnion<readonly [z.ZodObject<{
38
+ status: z.ZodEnum<{
39
+ unavailable: "unavailable";
40
+ unsupported: "unsupported";
41
+ }>;
42
+ reason: z.ZodEnum<{
43
+ ambiguous_invoice_items: "ambiguous_invoice_items";
44
+ invoice_binding_mismatch: "invoice_binding_mismatch";
45
+ invoice_history_incomplete: "invoice_history_incomplete";
46
+ invoice_unavailable: "invoice_unavailable";
47
+ metered_lines_not_observed: "metered_lines_not_observed";
48
+ provider_binding_mismatch: "provider_binding_mismatch";
49
+ unsupported_scope: "unsupported_scope";
50
+ }>;
51
+ retryable: z.ZodBoolean;
52
+ }, z.core.$strict>, z.ZodObject<{
53
+ status: z.ZodLiteral<"available">;
54
+ observedAt: z.ZodNumber;
55
+ value: z.ZodObject<{
56
+ amount: z.ZodString;
57
+ currency: z.ZodString;
58
+ }, z.core.$strict>;
59
+ }, z.core.$strict>]>;
60
+ lines: z.ZodArray<z.ZodObject<{
61
+ lineId: z.ZodString;
62
+ stripePriceId: z.ZodString;
63
+ subscriptionItemId: z.ZodString;
64
+ amount: z.ZodString;
65
+ currency: z.ZodString;
66
+ quantity: z.ZodNullable<z.ZodString>;
67
+ providerQuantityDecimal: z.ZodNullable<z.ZodString>;
68
+ unitAmountDecimal: z.ZodNullable<z.ZodString>;
69
+ creditAppliedAmount: z.ZodString;
70
+ nativePeriod: z.ZodObject<{
71
+ start: z.ZodNumber;
72
+ end: z.ZodNumber;
73
+ }, z.core.$strict>;
74
+ proration: z.ZodBoolean;
75
+ }, z.core.$strict>>;
76
+ }, z.core.$strict>;
77
+ }, z.core.$strict>]>;
78
+ export declare const managedInvoiceSchema: z.ZodArray<z.ZodObject<{
79
+ meterId: z.ZodString;
80
+ subscriptionItemId: z.ZodString;
81
+ observation: z.ZodUnion<readonly [z.ZodObject<{
82
+ status: z.ZodEnum<{
83
+ unavailable: "unavailable";
84
+ unsupported: "unsupported";
85
+ }>;
86
+ reason: z.ZodEnum<{
87
+ ambiguous_invoice_items: "ambiguous_invoice_items";
88
+ invoice_binding_mismatch: "invoice_binding_mismatch";
89
+ invoice_history_incomplete: "invoice_history_incomplete";
90
+ invoice_unavailable: "invoice_unavailable";
91
+ metered_lines_not_observed: "metered_lines_not_observed";
92
+ provider_binding_mismatch: "provider_binding_mismatch";
93
+ unsupported_scope: "unsupported_scope";
94
+ }>;
95
+ retryable: z.ZodBoolean;
96
+ }, z.core.$strict>, z.ZodObject<{
97
+ status: z.ZodLiteral<"available">;
98
+ observedAt: z.ZodNumber;
99
+ value: z.ZodObject<{
100
+ kind: z.ZodLiteral<"invoice">;
101
+ invoiceId: z.ZodString;
102
+ status: z.ZodEnum<{
103
+ draft: "draft";
104
+ open: "open";
105
+ paid: "paid";
106
+ uncollectible: "uncollectible";
107
+ void: "void";
108
+ }>;
109
+ finalized: z.ZodBoolean;
110
+ amountDue: z.ZodString;
111
+ amountPaid: z.ZodString;
112
+ total: z.ZodString;
113
+ currency: z.ZodString;
114
+ linesComplete: z.ZodBoolean;
115
+ paymentEvidence: z.ZodLiteral<"not_resolved">;
116
+ meterAmount: z.ZodUnion<readonly [z.ZodObject<{
117
+ status: z.ZodEnum<{
118
+ unavailable: "unavailable";
119
+ unsupported: "unsupported";
120
+ }>;
121
+ reason: z.ZodEnum<{
122
+ ambiguous_invoice_items: "ambiguous_invoice_items";
123
+ invoice_binding_mismatch: "invoice_binding_mismatch";
124
+ invoice_history_incomplete: "invoice_history_incomplete";
125
+ invoice_unavailable: "invoice_unavailable";
126
+ metered_lines_not_observed: "metered_lines_not_observed";
127
+ provider_binding_mismatch: "provider_binding_mismatch";
128
+ unsupported_scope: "unsupported_scope";
129
+ }>;
130
+ retryable: z.ZodBoolean;
131
+ }, z.core.$strict>, z.ZodObject<{
132
+ status: z.ZodLiteral<"available">;
133
+ observedAt: z.ZodNumber;
134
+ value: z.ZodObject<{
135
+ amount: z.ZodString;
136
+ currency: z.ZodString;
137
+ }, z.core.$strict>;
138
+ }, z.core.$strict>]>;
139
+ lines: z.ZodArray<z.ZodObject<{
140
+ lineId: z.ZodString;
141
+ stripePriceId: z.ZodString;
142
+ subscriptionItemId: z.ZodString;
143
+ amount: z.ZodString;
144
+ currency: z.ZodString;
145
+ quantity: z.ZodNullable<z.ZodString>;
146
+ providerQuantityDecimal: z.ZodNullable<z.ZodString>;
147
+ unitAmountDecimal: z.ZodNullable<z.ZodString>;
148
+ creditAppliedAmount: z.ZodString;
149
+ nativePeriod: z.ZodObject<{
150
+ start: z.ZodNumber;
151
+ end: z.ZodNumber;
152
+ }, z.core.$strict>;
153
+ proration: z.ZodBoolean;
154
+ }, z.core.$strict>>;
155
+ }, z.core.$strict>;
156
+ }, z.core.$strict>]>;
157
+ }, z.core.$strict>>;
158
+ export type UsageSubscriptionInvoice = z.infer<typeof managedInvoiceSchema>;
159
+ export declare const retirementProof: z.ZodObject<{
160
+ invoiceId: z.ZodString;
161
+ stripeAccountId: z.ZodString;
162
+ customerAccount: z.ZodString;
163
+ stripeCustomerId: z.ZodString;
164
+ livemode: z.ZodBoolean;
165
+ subscriptionId: z.ZodString;
166
+ status: z.ZodEnum<{
167
+ open: "open";
168
+ paid: "paid";
169
+ uncollectible: "uncollectible";
170
+ }>;
171
+ finalizedAt: z.ZodNumber;
172
+ billingReason: z.ZodLiteral<"subscription_cycle">;
173
+ periodEnd: z.ZodNumber;
174
+ }, z.core.$strict>;
175
+ export declare const abandonmentProof: z.ZodDiscriminatedUnion<[z.ZodObject<{
176
+ stripeAccountId: z.ZodString;
177
+ customerAccount: z.ZodString;
178
+ stripeCustomerId: z.ZodString;
179
+ livemode: z.ZodBoolean;
180
+ nativeId: z.ZodString;
181
+ kind: z.ZodLiteral<"checkout">;
182
+ status: z.ZodLiteral<"expired">;
183
+ subscription: z.ZodNull;
184
+ paymentIntent: z.ZodNull;
185
+ setupIntent: z.ZodNull;
186
+ paymentStatus: z.ZodEnum<{
187
+ no_payment_required: "no_payment_required";
188
+ unpaid: "unpaid";
189
+ }>;
190
+ }, z.core.$strict>, z.ZodObject<{
191
+ stripeAccountId: z.ZodString;
192
+ customerAccount: z.ZodString;
193
+ stripeCustomerId: z.ZodString;
194
+ livemode: z.ZodBoolean;
195
+ nativeId: z.ZodString;
196
+ kind: z.ZodLiteral<"subscription">;
197
+ status: z.ZodLiteral<"incomplete_expired">;
198
+ invoiceId: z.ZodString;
199
+ invoiceStatus: z.ZodLiteral<"void">;
200
+ invoiceAmountPaid: z.ZodLiteral<"0">;
201
+ billingReason: z.ZodLiteral<"subscription_create">;
202
+ }, z.core.$strict>], "kind">;
203
+ //# sourceMappingURL=subscriptionInvoiceSchema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionInvoiceSchema.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscriptionInvoiceSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAoC1C,CAAC;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBASvB,CAAC;AACX,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;kBAW1B,CAAC;AASH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAmB3B,CAAC"}
@@ -0,0 +1,108 @@
1
+ import { z } from "zod";
2
+ const id = z.string().min(1).max(100), seconds = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
3
+ const integer = z.string().regex(/^-?\d{1,30}$/), decimal = z.string().regex(/^\d{1,30}(\.\d{1,18})?$/);
4
+ const currency = z.string().regex(/^[a-z]{3}$/);
5
+ const unavailable = z.strictObject({
6
+ status: z.enum(["unavailable", "unsupported"]),
7
+ reason: z.enum([
8
+ "provider_binding_mismatch",
9
+ "invoice_binding_mismatch",
10
+ "invoice_unavailable",
11
+ "unsupported_scope",
12
+ "invoice_history_incomplete",
13
+ "ambiguous_invoice_items",
14
+ "metered_lines_not_observed",
15
+ ]),
16
+ retryable: z.boolean(),
17
+ });
18
+ const meterAmount = z.union([
19
+ unavailable,
20
+ z.strictObject({
21
+ status: z.literal("available"),
22
+ observedAt: seconds,
23
+ value: z.strictObject({ amount: integer, currency }),
24
+ }),
25
+ ]);
26
+ export const managedInvoiceObservationSchema = z.union([
27
+ unavailable,
28
+ z.strictObject({
29
+ status: z.literal("available"),
30
+ observedAt: seconds,
31
+ value: z.strictObject({
32
+ kind: z.literal("invoice"),
33
+ invoiceId: id,
34
+ status: z.enum(["draft", "open", "paid", "void", "uncollectible"]),
35
+ finalized: z.boolean(),
36
+ amountDue: integer,
37
+ amountPaid: integer,
38
+ total: integer,
39
+ currency,
40
+ linesComplete: z.boolean(),
41
+ paymentEvidence: z.literal("not_resolved"),
42
+ meterAmount,
43
+ lines: z
44
+ .array(z.strictObject({
45
+ lineId: id,
46
+ stripePriceId: id,
47
+ subscriptionItemId: id,
48
+ amount: integer,
49
+ currency,
50
+ quantity: decimal.nullable(),
51
+ providerQuantityDecimal: decimal.nullable(),
52
+ unitAmountDecimal: decimal.nullable(),
53
+ creditAppliedAmount: integer,
54
+ nativePeriod: z.strictObject({ start: seconds, end: seconds }),
55
+ proration: z.boolean(),
56
+ }))
57
+ .max(100),
58
+ }),
59
+ }),
60
+ ]);
61
+ export const managedInvoiceSchema = z
62
+ .array(z.strictObject({
63
+ meterId: id,
64
+ subscriptionItemId: id,
65
+ observation: managedInvoiceObservationSchema,
66
+ }))
67
+ .min(1)
68
+ .max(10);
69
+ export const retirementProof = z.strictObject({
70
+ invoiceId: id,
71
+ stripeAccountId: id,
72
+ customerAccount: id,
73
+ stripeCustomerId: id,
74
+ livemode: z.boolean(),
75
+ subscriptionId: id,
76
+ status: z.enum(["open", "paid", "uncollectible"]),
77
+ finalizedAt: seconds,
78
+ billingReason: z.literal("subscription_cycle"),
79
+ periodEnd: seconds,
80
+ });
81
+ const abandonmentCommon = {
82
+ stripeAccountId: id,
83
+ customerAccount: id,
84
+ stripeCustomerId: id,
85
+ livemode: z.boolean(),
86
+ nativeId: id,
87
+ };
88
+ export const abandonmentProof = z.discriminatedUnion("kind", [
89
+ z.strictObject({
90
+ ...abandonmentCommon,
91
+ kind: z.literal("checkout"),
92
+ status: z.literal("expired"),
93
+ subscription: z.null(),
94
+ paymentIntent: z.null(),
95
+ setupIntent: z.null(),
96
+ paymentStatus: z.enum(["unpaid", "no_payment_required"]),
97
+ }),
98
+ z.strictObject({
99
+ ...abandonmentCommon,
100
+ kind: z.literal("subscription"),
101
+ status: z.literal("incomplete_expired"),
102
+ invoiceId: id,
103
+ invoiceStatus: z.literal("void"),
104
+ invoiceAmountPaid: z.literal("0"),
105
+ billingReason: z.literal("subscription_create"),
106
+ }),
107
+ ]);
108
+ //# sourceMappingURL=subscriptionInvoiceSchema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionInvoiceSchema.js","sourceRoot":"","sources":["../../../src/client/usage/subscriptionInvoiceSchema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,80 @@
1
+ import type Stripe from "stripe";
2
+ import type { Component, RunCtx } from "../helpers.js";
3
+ import type { Doc } from "../../component/_generated/dataModel.js";
4
+ import { type UsageSubscriptionInvoice } from "./subscriptionInvoiceSchema.js";
5
+ export type UsageSubscriptionRef = {
6
+ scope: {
7
+ stripeAccountId: string;
8
+ customerAccount: string;
9
+ livemode: boolean;
10
+ };
11
+ requestId: string;
12
+ };
13
+ export declare function getSubscriptionIntent(component: Component, ctx: RunCtx, input: UsageSubscriptionRef): Promise<{
14
+ _creationTime: number;
15
+ _id: import("convex/values").GenericId<"usageSubscriptionIntents">;
16
+ abandonedId?: string | undefined;
17
+ checkoutId?: string | undefined;
18
+ controlKey?: string | undefined;
19
+ firstAttemptAt: number;
20
+ historyCount?: number | undefined;
21
+ key: string;
22
+ method: "checkout" | "direct";
23
+ providerId?: string | undefined;
24
+ retiredAt?: number | undefined;
25
+ retirementInvoiceId?: string | undefined;
26
+ scopeKey: string;
27
+ startedAt?: number | undefined;
28
+ termsJson: string;
29
+ viewJson?: string | undefined;
30
+ }>;
31
+ export declare function refreshManagedSubscription(stripe: Stripe, component: Component, ctx: RunCtx, row: Doc<"usageSubscriptionIntents">): Promise<{
32
+ subscriptionId: string;
33
+ status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
34
+ currency: string;
35
+ billingMode: "flexible";
36
+ collection: {
37
+ method: "charge_automatically" | "send_invoice";
38
+ daysUntilDue: number | null;
39
+ defaultPaymentMethod: string | null;
40
+ };
41
+ cancelAtPeriodEnd: boolean;
42
+ cancelAt: number | null;
43
+ items: {
44
+ id: string;
45
+ stripePriceId: string;
46
+ meterId: string | null;
47
+ period: {
48
+ start: number;
49
+ end: number;
50
+ };
51
+ quantity: string | null;
52
+ unitAmountDecimal: string | null;
53
+ }[];
54
+ bindings: {
55
+ scope: {
56
+ stripeAccountId: string;
57
+ customerAccount: string;
58
+ meterId: string;
59
+ livemode: boolean;
60
+ };
61
+ binding: Omit<{
62
+ stripeCustomerId: string;
63
+ stripePriceId: string;
64
+ eventName: string;
65
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
66
+ plan: unknown;
67
+ }, "plan"> & {
68
+ plan: import("./contracts.js").UsagePlan;
69
+ };
70
+ subscription: import("./boundaries.js").UsageSubscriptionBinding;
71
+ }[];
72
+ }>;
73
+ export declare function observeManagedInvoice(stripe: Stripe, component: Component, ctx: RunCtx, row: Doc<"usageSubscriptionIntents">, invoiceId: string): Promise<UsageSubscriptionInvoice>;
74
+ export declare function retireManagedSubscription(stripe: Stripe, component: Component, ctx: RunCtx, row: Doc<"usageSubscriptionIntents">, invoiceId: string): Promise<{
75
+ retired: true;
76
+ invoiceId: string;
77
+ creditTreatment: "retain_original_terms";
78
+ billingReconciliation: "required";
79
+ }>;
80
+ //# sourceMappingURL=subscriptionLifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionLifecycle.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscriptionLifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AAanE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,gCAAgC,CAAC;AACxC,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,oBAAoB;;;;;;;;;;;;;;;;;GAa5B;AACD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,CAAC,0BAA0B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmBrC;AACD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,CAAC,0BAA0B,CAAC,EACpC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,wBAAwB,CAAC,CA+BnC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,CAAC,0BAA0B,CAAC,EACpC,SAAS,EAAE,MAAM;;;qBA6CI,uBAAuB;2BACjB,UAAU;GAGtC"}
@@ -0,0 +1,87 @@
1
+ import { retirementProof } from "./subscriptionInvoiceSchema.js";
2
+ import { runMutationOrThrow } from "../helpers.js";
3
+ import { componentRef } from "../webhooks/helpers.js";
4
+ import { subscriptionScopeSchema, subscriptionTerms, } from "./subscriptionTerms.js";
5
+ import { saveSubscription, subscriptionCall, UsageSubscriptionError, verifySubscriptionRealm, } from "./subscriptionProvider.js";
6
+ import { observeUsageInvoice } from "./invoiceObservation.js";
7
+ import { managedInvoiceSchema, } from "./subscriptionInvoiceSchema.js";
8
+ export async function getSubscriptionIntent(component, ctx, input) {
9
+ const scope = subscriptionScopeSchema.parse(input.scope);
10
+ const row = (await ctx.runQuery(componentRef(component, "usageSubscriptions/queries/get"), { scope, requestId: input.requestId }));
11
+ if (!row)
12
+ throw new UsageSubscriptionError("incompatible_terms", "Managed subscription scope unavailable");
13
+ return row;
14
+ }
15
+ export async function refreshManagedSubscription(stripe, component, ctx, row) {
16
+ const terms = subscriptionTerms(JSON.parse(row.termsJson)), startedAt = Date.now();
17
+ return subscriptionCall(async () => {
18
+ if (!row.providerId)
19
+ throw new UsageSubscriptionError("incompatible_terms", "Managed subscription not yet observed");
20
+ await verifySubscriptionRealm(stripe, terms);
21
+ const sub = await stripe.subscriptions.retrieve(row.providerId);
22
+ if (sub.id !== row.providerId)
23
+ throw new UsageSubscriptionError("incompatible_terms", "Pinned subscription identity changed");
24
+ return saveSubscription(component, ctx, row.key, sub, terms, startedAt);
25
+ });
26
+ }
27
+ export async function observeManagedInvoice(stripe, component, ctx, row, invoiceId) {
28
+ const startedAt = Date.now();
29
+ return subscriptionCall(async () => {
30
+ // Historical terms come from the retained snapshot, never the current price.
31
+ const view = row.viewJson
32
+ ? JSON.parse(row.viewJson)
33
+ : await refreshManagedSubscription(stripe, component, ctx, row);
34
+ const observations = [];
35
+ for (const source of view.bindings)
36
+ observations.push({
37
+ meterId: source.scope.meterId,
38
+ subscriptionItemId: source.subscription.subscriptionItemId,
39
+ observation: await observeUsageInvoice(stripe, { ...source, period: source.subscription.period }, invoiceId),
40
+ });
41
+ const parsed = managedInvoiceSchema.parse(observations);
42
+ await runMutationOrThrow(ctx, componentRef(component, "usageSubscriptions/mutations/saveInvoice"), {
43
+ key: row.key,
44
+ invoiceId,
45
+ observationsJson: JSON.stringify(parsed),
46
+ startedAt,
47
+ });
48
+ return parsed;
49
+ });
50
+ }
51
+ export async function retireManagedSubscription(stripe, component, ctx, row, invoiceId) {
52
+ return subscriptionCall(async () => {
53
+ const view = await refreshManagedSubscription(stripe, component, ctx, row);
54
+ if (view.status !== "canceled")
55
+ throw new UsageSubscriptionError("incompatible_terms", "Retirement requires native period-end cancellation");
56
+ const terms = subscriptionTerms(JSON.parse(row.termsJson)), first = terms.meters[0];
57
+ const invoice = await stripe.invoices.retrieve(invoiceId);
58
+ const proof = retirementProof.parse({
59
+ invoiceId: invoice.id,
60
+ stripeAccountId: first.scope.stripeAccountId,
61
+ customerAccount: invoice.customer_account,
62
+ stripeCustomerId: typeof invoice.customer === "string"
63
+ ? invoice.customer
64
+ : invoice.customer?.id,
65
+ livemode: invoice.livemode,
66
+ subscriptionId: typeof invoice.parent?.subscription_details?.subscription === "string"
67
+ ? invoice.parent.subscription_details.subscription
68
+ : invoice.parent?.subscription_details?.subscription?.id,
69
+ status: invoice.status,
70
+ finalizedAt: invoice.status_transitions?.finalized_at,
71
+ billingReason: invoice.billing_reason,
72
+ periodEnd: invoice.period_end,
73
+ });
74
+ if (invoice.id !== invoiceId)
75
+ throw new UsageSubscriptionError("incompatible_terms", "Native retirement invoice identity mismatch");
76
+ const current = { ...row, viewJson: JSON.stringify(view) };
77
+ await observeManagedInvoice(stripe, component, ctx, current, invoiceId);
78
+ await runMutationOrThrow(ctx, componentRef(component, "usageSubscriptions/mutations/retire"), { key: row.key, proofJson: JSON.stringify(proof) });
79
+ return {
80
+ retired: true,
81
+ invoiceId,
82
+ creditTreatment: "retain_original_terms",
83
+ billingReconciliation: "required",
84
+ };
85
+ });
86
+ }
87
+ //# sourceMappingURL=subscriptionLifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionLifecycle.js","sourceRoot":"","sources":["../../../src/client/usage/subscriptionLifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,111 @@
1
+ import type Stripe from "stripe";
2
+ import type { Component, RunCtx } from "../helpers.js";
3
+ import { type UsageSubscriptionTerms, type UsageSubscriptionOptions } from "./subscriptionTerms.js";
4
+ export { UsageSubscriptionError } from "./subscriptionErrors.js";
5
+ export declare function subscriptionCall<T>(fn: () => Promise<T>): Promise<T>;
6
+ export declare function verifySubscriptionRealm(stripe: Stripe, terms: UsageSubscriptionTerms): Promise<void>;
7
+ export declare function verifySubscriptionPrices(stripe: Stripe, terms: UsageSubscriptionTerms): Promise<void>;
8
+ export declare function discoverSubscription(stripe: Stripe, terms: UsageSubscriptionTerms, key: string): Promise<Stripe.Subscription | undefined>;
9
+ export declare function saveSubscription(component: Component, ctx: RunCtx, key: string, native: Stripe.Subscription, terms: UsageSubscriptionTerms, startedAt: number): Promise<{
10
+ subscriptionId: string;
11
+ status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
12
+ currency: string;
13
+ billingMode: "flexible";
14
+ collection: {
15
+ method: "charge_automatically" | "send_invoice";
16
+ daysUntilDue: number | null;
17
+ defaultPaymentMethod: string | null;
18
+ };
19
+ cancelAtPeriodEnd: boolean;
20
+ cancelAt: number | null;
21
+ items: {
22
+ id: string;
23
+ stripePriceId: string;
24
+ meterId: string | null;
25
+ period: {
26
+ start: number;
27
+ end: number;
28
+ };
29
+ quantity: string | null;
30
+ unitAmountDecimal: string | null;
31
+ }[];
32
+ bindings: {
33
+ scope: {
34
+ stripeAccountId: string;
35
+ customerAccount: string;
36
+ meterId: string;
37
+ livemode: boolean;
38
+ };
39
+ binding: Omit<{
40
+ stripeCustomerId: string;
41
+ stripePriceId: string;
42
+ eventName: string;
43
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
44
+ plan: unknown;
45
+ }, "plan"> & {
46
+ plan: import("./contracts.js").UsagePlan;
47
+ };
48
+ subscription: import("./boundaries.js").UsageSubscriptionBinding;
49
+ }[];
50
+ }>;
51
+ export declare function prepareSubscription(component: Component, ctx: RunCtx, terms: UsageSubscriptionTerms, method: "direct" | "checkout"): Promise<{
52
+ _creationTime: number;
53
+ _id: import("convex/values").GenericId<"usageSubscriptionIntents">;
54
+ abandonedId?: string | undefined;
55
+ checkoutId?: string | undefined;
56
+ controlKey?: string | undefined;
57
+ firstAttemptAt: number;
58
+ historyCount?: number | undefined;
59
+ key: string;
60
+ method: "checkout" | "direct";
61
+ providerId?: string | undefined;
62
+ retiredAt?: number | undefined;
63
+ retirementInvoiceId?: string | undefined;
64
+ scopeKey: string;
65
+ startedAt?: number | undefined;
66
+ termsJson: string;
67
+ viewJson?: string | undefined;
68
+ }>;
69
+ export declare function ensureManagedSubscription(stripe: Stripe, component: Component, ctx: RunCtx, input: UsageSubscriptionOptions): Promise<{
70
+ subscriptionId: string;
71
+ status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
72
+ currency: string;
73
+ billingMode: "flexible";
74
+ collection: {
75
+ method: "charge_automatically" | "send_invoice";
76
+ daysUntilDue: number | null;
77
+ defaultPaymentMethod: string | null;
78
+ };
79
+ cancelAtPeriodEnd: boolean;
80
+ cancelAt: number | null;
81
+ items: {
82
+ id: string;
83
+ stripePriceId: string;
84
+ meterId: string | null;
85
+ period: {
86
+ start: number;
87
+ end: number;
88
+ };
89
+ quantity: string | null;
90
+ unitAmountDecimal: string | null;
91
+ }[];
92
+ bindings: {
93
+ scope: {
94
+ stripeAccountId: string;
95
+ customerAccount: string;
96
+ meterId: string;
97
+ livemode: boolean;
98
+ };
99
+ binding: Omit<{
100
+ stripeCustomerId: string;
101
+ stripePriceId: string;
102
+ eventName: string;
103
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
104
+ plan: unknown;
105
+ }, "plan"> & {
106
+ plan: import("./contracts.js").UsagePlan;
107
+ };
108
+ subscription: import("./boundaries.js").UsageSubscriptionBinding;
109
+ }[];
110
+ }>;
111
+ //# sourceMappingURL=subscriptionProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionProvider.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscriptionProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMvD,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAkB1E;AACD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,sBAAsB,iBAkB9B;AACD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,sBAAsB,iBA4C9B;AACD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,MAAM,4CAsDZ;AACD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,YAAY,EAC3B,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAUlB;AACD,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,QAAQ,GAAG,UAAU;;;;;;;;;;;;;;;;;GAO9B;AACD,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDhC"}