@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 @@
1
+ {"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/component/usageObservations/history.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAgB,EAChB,OAA0B,EAC1B,KAAiC,EACjC,OAAe,EACf,QAAgB,EAChB,OAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACpC,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAClD;SACA,MAAM,EAAE,CAAC;IACZ,IAAI,KAAK;QAAE,OAAO;IAClB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;SACxB,KAAK,CAAC,aAAa,CAAC;SACpB,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SACtD,MAAM,EAAE,CAAC;IACZ,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE;QAC1C,OAAO;QACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ;QACR,OAAO;QACP,KAAK;QACL,QAAQ;QACR,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACzC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/E,CAAC"}
@@ -0,0 +1,6 @@
1
+ export declare const save: import("convex/server").RegisteredMutation<"public", {
2
+ observationJson: string;
3
+ sourceJson: string;
4
+ startedAt: number;
5
+ }, Promise<null>>;
6
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/mutations.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI;;;;iBAmCf,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { mutation } from "../_generated/server.js";
2
+ import { v } from "convex/values";
3
+ import { source, observation } from "./helpers.js";
4
+ export const save = mutation({
5
+ args: {
6
+ sourceJson: v.string(),
7
+ observationJson: v.string(),
8
+ startedAt: v.number(),
9
+ },
10
+ returns: v.null(),
11
+ handler: async (ctx, args) => {
12
+ if (!Number.isSafeInteger(args.startedAt) ||
13
+ args.startedAt < 0 ||
14
+ args.startedAt > Date.now() + 300000)
15
+ throw new Error("Invalid observation start time");
16
+ const binding = await source(args.sourceJson), observationJson = observation(args.observationJson, binding.opts);
17
+ const prior = await ctx.db
18
+ .query("usageProviderObservations")
19
+ .withIndex("by_key", (q) => q.eq("key", binding.key))
20
+ .unique();
21
+ if (prior && prior.sourceJson !== binding.sourceJson)
22
+ throw new Error("Usage observation binding conflict");
23
+ if (prior && prior.startedAt > args.startedAt)
24
+ return null;
25
+ const fields = {
26
+ key: binding.key,
27
+ scopeKey: binding.scopeKey,
28
+ sourceJson: binding.sourceJson,
29
+ observationJson,
30
+ startedAt: args.startedAt,
31
+ };
32
+ if (prior)
33
+ await ctx.db.patch("usageProviderObservations", prior._id, fields);
34
+ else
35
+ await ctx.db.insert("usageProviderObservations", fields);
36
+ return null;
37
+ },
38
+ });
39
+ //# sourceMappingURL=mutations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/usageObservations/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC;YACrC,IAAI,CAAC,SAAS,GAAG,CAAC;YAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM;YAEpC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAC3C,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;aACvB,KAAK,CAAC,2BAA2B,CAAC;aAClC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;aACpD,MAAM,EAAE,CAAC;QACZ,IAAI,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;YAClD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3D,MAAM,MAAM,GAAG;YACb,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,eAAe;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QACF,IAAI,KAAK;YACP,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;;YAChE,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,78 @@
1
+ export declare const summary: import("convex/server").RegisteredQuery<"public", {
2
+ maxRecords: number;
3
+ period: {
4
+ end: number;
5
+ start: number;
6
+ };
7
+ scope: {
8
+ customerAccount: string;
9
+ livemode: boolean;
10
+ meterId: string;
11
+ stripeAccountId: string;
12
+ };
13
+ }, Promise<string>>;
14
+ export declare const cached: import("convex/server").RegisteredQuery<"public", {
15
+ sourceJson: string;
16
+ }, Promise<string | null>>;
17
+ export declare const deliveryHistory: import("convex/server").RegisteredQuery<"public", {
18
+ eventId: import("convex/values").GenericId<"usageEvents">;
19
+ paginationOpts: {
20
+ id?: number;
21
+ endCursor?: string | null;
22
+ maximumRowsRead?: number;
23
+ maximumBytesRead?: number;
24
+ numItems: number;
25
+ cursor: string | null;
26
+ };
27
+ scope: {
28
+ customerAccount: string;
29
+ livemode: boolean;
30
+ meterId: string;
31
+ stripeAccountId: string;
32
+ };
33
+ }, Promise<{
34
+ page: {
35
+ _creationTime: number;
36
+ _id: import("convex/values").GenericId<"usageDeliveryHistory">;
37
+ attempt: number;
38
+ created?: number | undefined;
39
+ eventId: import("convex/values").GenericId<"usageEvents">;
40
+ identity: string;
41
+ phase: "accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired";
42
+ recordedAt: number;
43
+ scopeKey: string;
44
+ sequence: number;
45
+ }[];
46
+ isDone: boolean;
47
+ continueCursor: import("convex/server").Cursor;
48
+ splitCursor?: import("convex/server").Cursor | null;
49
+ pageStatus?: "SplitRecommended" | "SplitRequired" | null;
50
+ legacyHistoryMissing: boolean;
51
+ }>>;
52
+ export declare const validationHistory: import("convex/server").RegisteredQuery<"public", {
53
+ eventId: import("convex/values").GenericId<"usageEvents">;
54
+ paginationOpts: {
55
+ id?: number;
56
+ endCursor?: string | null;
57
+ maximumRowsRead?: number;
58
+ maximumBytesRead?: number;
59
+ numItems: number;
60
+ cursor: string | null;
61
+ };
62
+ scope: {
63
+ customerAccount: string;
64
+ livemode: boolean;
65
+ meterId: string;
66
+ stripeAccountId: string;
67
+ };
68
+ }, Promise<import("convex/server").PaginationResult<{
69
+ _creationTime: number;
70
+ _id: import("convex/values").GenericId<"usageDeliveryErrors">;
71
+ code: "archived_meter" | "meter_event_customer_not_found" | "meter_event_dimension_count_too_high" | "meter_event_invalid_value" | "meter_event_no_customer_defined" | "meter_event_value_not_found" | "no_meter" | "timestamp_in_future" | "timestamp_too_far_in_past";
72
+ dedupe: string;
73
+ eventId: import("convex/values").GenericId<"usageEvents">;
74
+ observedAt: number;
75
+ providerEventId: string;
76
+ scopeKey: string;
77
+ }>>>;
78
+ //# sourceMappingURL=queries.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/queries.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,OAAO;;;;;;;;;;;;mBAsDlB,CAAC;AAEH,eAAO,MAAM,MAAM;;0BAejB,CAAC;AAUH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4B1B,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;IAgB5B,CAAC"}
@@ -0,0 +1,131 @@
1
+ import { paginationOptsValidator, paginationResultValidator, } from "convex/server";
2
+ import { paginator } from "convex-helpers/server/pagination";
3
+ import schema from "../schema.js";
4
+ import { refFields } from "../usageDelivery/schema.js";
5
+ import { read } from "../usageDelivery/helpers.js";
6
+ import { historyDoc } from "./schema.js";
7
+ import { errorDoc } from "../usageDelivery/fields.js";
8
+ import { source } from "./helpers.js";
9
+ import { query } from "../_generated/server.js";
10
+ import { v } from "convex/values";
11
+ import { scopeValidator } from "../usage/schema.js";
12
+ import { scopeKey, subscriptionSnapshot } from "../usage/helpers.js";
13
+ import { validateUsagePageRequest } from "../../client/usage/boundaries.js";
14
+ import { summarizeUsageRecords } from "../../client/usage/summary.js";
15
+ export const summary = query({
16
+ args: {
17
+ scope: scopeValidator,
18
+ period: v.object({ start: v.number(), end: v.number() }),
19
+ maxRecords: v.number(),
20
+ },
21
+ returns: v.string(),
22
+ handler: async (ctx, args) => {
23
+ const key = scopeKey(args.scope);
24
+ validateUsagePageRequest({ period: args.period, limit: 1, cursor: null });
25
+ if (!Number.isInteger(args.maxRecords) ||
26
+ args.maxRecords < 1 ||
27
+ args.maxRecords > 500)
28
+ throw new Error("Usage summary read budget must be 1–500");
29
+ const rows = await ctx.db
30
+ .query("usageEvents")
31
+ .withIndex("by_scope_time", (q) => q
32
+ .eq("scopeKey", key)
33
+ .gte("occurredAt", args.period.start)
34
+ .lt("occurredAt", args.period.end))
35
+ .take(args.maxRecords + 1);
36
+ const views = await Promise.all(rows.slice(0, args.maxRecords).map(async (event) => {
37
+ const [outbox, error] = await Promise.all([
38
+ ctx.db
39
+ .query("usageOutbox")
40
+ .withIndex("by_event", (q) => q.eq("eventId", event._id))
41
+ .unique(),
42
+ ctx.db
43
+ .query("usageDeliveryErrors")
44
+ .withIndex("by_event", (q) => q.eq("eventId", event._id))
45
+ .first(),
46
+ ]);
47
+ if (!outbox)
48
+ throw new Error("Usage outbox invariant violated");
49
+ return {
50
+ record: JSON.parse(event.recordJson),
51
+ subscription: subscriptionSnapshot(event.subscriptionJson),
52
+ delivery: outbox.state,
53
+ hasValidationError: error !== null,
54
+ };
55
+ }));
56
+ return JSON.stringify(summarizeUsageRecords(views, {
57
+ period: args.period,
58
+ observedAt: Math.floor(Date.now() / 1000),
59
+ complete: rows.length <= args.maxRecords,
60
+ }));
61
+ },
62
+ });
63
+ export const cached = query({
64
+ args: { sourceJson: v.string() },
65
+ returns: v.union(v.string(), v.null()),
66
+ handler: async (ctx, args) => {
67
+ const binding = await source(args.sourceJson);
68
+ const row = await ctx.db
69
+ .query("usageProviderObservations")
70
+ .withIndex("by_key", (q) => q.eq("key", binding.key))
71
+ .unique();
72
+ return row &&
73
+ row.scopeKey === binding.scopeKey &&
74
+ row.sourceJson === binding.sourceJson
75
+ ? row.observationJson
76
+ : null;
77
+ },
78
+ });
79
+ function validate(numItems, cursor) {
80
+ validateUsagePageRequest({
81
+ period: { start: 0, end: 1 },
82
+ limit: numItems,
83
+ cursor,
84
+ });
85
+ }
86
+ const paginated = paginationResultValidator(historyDoc);
87
+ export const deliveryHistory = query({
88
+ args: { ...refFields, paginationOpts: paginationOptsValidator },
89
+ returns: v.object({ ...paginated.fields, legacyHistoryMissing: v.boolean() }),
90
+ handler: async (ctx, args) => {
91
+ const { outbox } = await read(ctx, args);
92
+ validate(args.paginationOpts.numItems, args.paginationOpts.cursor);
93
+ const [page, first] = await Promise.all([
94
+ paginator(ctx.db, schema)
95
+ .query("usageDeliveryHistory")
96
+ .withIndex("by_event_sequence", (q) => q.eq("eventId", args.eventId))
97
+ .order("asc")
98
+ .paginate({
99
+ ...args.paginationOpts,
100
+ maximumRowsRead: 200,
101
+ maximumBytesRead: 1000000,
102
+ }),
103
+ ctx.db
104
+ .query("usageDeliveryHistory")
105
+ .withIndex("by_event_identity", (q) => q.eq("eventId", args.eventId).eq("identity", "started:1"))
106
+ .unique(),
107
+ ]);
108
+ return {
109
+ ...page,
110
+ legacyHistoryMissing: outbox.attempts > 0 && first === null,
111
+ };
112
+ },
113
+ });
114
+ export const validationHistory = query({
115
+ args: { ...refFields, paginationOpts: paginationOptsValidator },
116
+ returns: paginationResultValidator(errorDoc),
117
+ handler: async (ctx, args) => {
118
+ await read(ctx, args);
119
+ validate(args.paginationOpts.numItems, args.paginationOpts.cursor);
120
+ return paginator(ctx.db, schema)
121
+ .query("usageDeliveryErrors")
122
+ .withIndex("by_event", (q) => q.eq("eventId", args.eventId))
123
+ .order("desc")
124
+ .paginate({
125
+ ...args.paginationOpts,
126
+ maximumRowsRead: 200,
127
+ maximumBytesRead: 1000000,
128
+ });
129
+ },
130
+ });
131
+ //# sourceMappingURL=queries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/usageObservations/queries.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ export declare const observationsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
2
+ key: string;
3
+ observationJson: string;
4
+ scopeKey: string;
5
+ sourceJson: string;
6
+ startedAt: number;
7
+ }, {
8
+ key: import("convex/values").VString<string, "required">;
9
+ scopeKey: import("convex/values").VString<string, "required">;
10
+ sourceJson: import("convex/values").VString<string, "required">;
11
+ observationJson: import("convex/values").VString<string, "required">;
12
+ startedAt: import("convex/values").VFloat64<number, "required">;
13
+ }, "required", "key" | "observationJson" | "scopeKey" | "sourceJson" | "startedAt">, {
14
+ by_key: ["key", "_creationTime"];
15
+ }, {}, {}>;
16
+ export declare const historyPhase: import("convex/values").VUnion<"accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired", [import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"accepted", "required">, import("convex/values").VLiteral<"rate_limited", "required">, import("convex/values").VLiteral<"unavailable", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"held", "required">, import("convex/values").VLiteral<"resumed", "required">, import("convex/values").VLiteral<"window_expired", "required">, import("convex/values").VLiteral<"retry_exhausted", "required">], "required", never>;
17
+ export declare const historyFields: {
18
+ scopeKey: import("convex/values").VString<string, "required">;
19
+ eventId: import("convex/values").VId<import("convex/values").GenericId<"usageEvents">, "required">;
20
+ sequence: import("convex/values").VFloat64<number, "required">;
21
+ attempt: import("convex/values").VFloat64<number, "required">;
22
+ phase: import("convex/values").VUnion<"accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired", [import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"accepted", "required">, import("convex/values").VLiteral<"rate_limited", "required">, import("convex/values").VLiteral<"unavailable", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"held", "required">, import("convex/values").VLiteral<"resumed", "required">, import("convex/values").VLiteral<"window_expired", "required">, import("convex/values").VLiteral<"retry_exhausted", "required">], "required", never>;
23
+ identity: import("convex/values").VString<string, "required">;
24
+ recordedAt: import("convex/values").VFloat64<number, "required">;
25
+ created: import("convex/values").VFloat64<number | undefined, "optional">;
26
+ };
27
+ export declare const historyDoc: import("convex/values").VObject<{
28
+ _creationTime: number;
29
+ _id: import("convex/values").GenericId<"usageDeliveryHistory">;
30
+ attempt: number;
31
+ created?: number | undefined;
32
+ eventId: import("convex/values").GenericId<"usageEvents">;
33
+ identity: string;
34
+ phase: "accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired";
35
+ recordedAt: number;
36
+ scopeKey: string;
37
+ sequence: number;
38
+ }, {
39
+ scopeKey: import("convex/values").VString<string, "required">;
40
+ eventId: import("convex/values").VId<import("convex/values").GenericId<"usageEvents">, "required">;
41
+ sequence: import("convex/values").VFloat64<number, "required">;
42
+ attempt: import("convex/values").VFloat64<number, "required">;
43
+ phase: import("convex/values").VUnion<"accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired", [import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"accepted", "required">, import("convex/values").VLiteral<"rate_limited", "required">, import("convex/values").VLiteral<"unavailable", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"held", "required">, import("convex/values").VLiteral<"resumed", "required">, import("convex/values").VLiteral<"window_expired", "required">, import("convex/values").VLiteral<"retry_exhausted", "required">], "required", never>;
44
+ identity: import("convex/values").VString<string, "required">;
45
+ recordedAt: import("convex/values").VFloat64<number, "required">;
46
+ created: import("convex/values").VFloat64<number | undefined, "optional">;
47
+ _id: import("convex/values").VId<import("convex/values").GenericId<"usageDeliveryHistory">, "required">;
48
+ _creationTime: import("convex/values").VFloat64<number, "required">;
49
+ }, "required", "_creationTime" | "_id" | "attempt" | "created" | "eventId" | "identity" | "phase" | "recordedAt" | "scopeKey" | "sequence">;
50
+ export declare const historyTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
51
+ attempt: number;
52
+ created?: number | undefined;
53
+ eventId: import("convex/values").GenericId<"usageEvents">;
54
+ identity: string;
55
+ phase: "accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired";
56
+ recordedAt: number;
57
+ scopeKey: string;
58
+ sequence: number;
59
+ }, {
60
+ scopeKey: import("convex/values").VString<string, "required">;
61
+ eventId: import("convex/values").VId<import("convex/values").GenericId<"usageEvents">, "required">;
62
+ sequence: import("convex/values").VFloat64<number, "required">;
63
+ attempt: import("convex/values").VFloat64<number, "required">;
64
+ phase: import("convex/values").VUnion<"accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired", [import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"accepted", "required">, import("convex/values").VLiteral<"rate_limited", "required">, import("convex/values").VLiteral<"unavailable", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"held", "required">, import("convex/values").VLiteral<"resumed", "required">, import("convex/values").VLiteral<"window_expired", "required">, import("convex/values").VLiteral<"retry_exhausted", "required">], "required", never>;
65
+ identity: import("convex/values").VString<string, "required">;
66
+ recordedAt: import("convex/values").VFloat64<number, "required">;
67
+ created: import("convex/values").VFloat64<number | undefined, "optional">;
68
+ }, "required", "attempt" | "created" | "eventId" | "identity" | "phase" | "recordedAt" | "scopeKey" | "sequence">, {
69
+ by_event_identity: ["eventId", "identity", "_creationTime"];
70
+ by_event_sequence: ["eventId", "sequence", "_creationTime"];
71
+ }, {}, {}>;
72
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/usageObservations/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;UAMH,CAAC;AAE5B,eAAO,MAAM,YAAY,oxBAWxB,CAAC;AACF,eAAO,MAAM,aAAa;IACxB,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;IACL,QAAQ;IACR,UAAU;IACV,OAAO;CACR,CAAC;AACF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;2IAIrB,CAAC;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;UAE6B,CAAC"}
@@ -0,0 +1,29 @@
1
+ import { defineTable } from "convex/server";
2
+ import { v } from "convex/values";
3
+ export const observationsTable = defineTable({
4
+ key: v.string(),
5
+ scopeKey: v.string(),
6
+ sourceJson: v.string(),
7
+ observationJson: v.string(),
8
+ startedAt: v.number(),
9
+ }).index("by_key", ["key"]);
10
+ export const historyPhase = v.union(v.literal("started"), v.literal("accepted"), v.literal("rate_limited"), v.literal("unavailable"), v.literal("unknown"), v.literal("rejected"), v.literal("held"), v.literal("resumed"), v.literal("window_expired"), v.literal("retry_exhausted"));
11
+ export const historyFields = {
12
+ scopeKey: v.string(),
13
+ eventId: v.id("usageEvents"),
14
+ sequence: v.number(),
15
+ attempt: v.number(),
16
+ phase: historyPhase,
17
+ identity: v.string(),
18
+ recordedAt: v.number(),
19
+ created: v.optional(v.number()),
20
+ };
21
+ export const historyDoc = v.object({
22
+ _id: v.id("usageDeliveryHistory"),
23
+ _creationTime: v.number(),
24
+ ...historyFields,
25
+ });
26
+ export const historyTable = defineTable(historyFields)
27
+ .index("by_event_sequence", ["eventId", "sequence"])
28
+ .index("by_event_identity", ["eventId", "identity"]);
29
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/usageObservations/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CACjC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EACrB,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EACzB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EACxB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EACrB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACjB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAC3B,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAChC,CAAC;AACF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,GAAG,aAAa;CACjB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC;KACnD,KAAK,CAAC,mBAAmB,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;KACnD,KAAK,CAAC,mBAAmB,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { MutationCtx } from "../_generated/server.js";
2
+ import type { Doc } from "../_generated/dataModel.js";
3
+ export declare function abandonEnrollment(ctx: MutationCtx, intent: Doc<"usageSubscriptionIntents">, proofJson: string): Promise<void>;
4
+ //# sourceMappingURL=abandonment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"abandonment.d.ts","sourceRoot":"","sources":["../../../src/component/usageSubscriptions/abandonment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAKtD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,GAAG,CAAC,0BAA0B,CAAC,EACvC,SAAS,EAAE,MAAM,iBAsElB"}
@@ -0,0 +1,59 @@
1
+ import { abandonmentProof } from "../../client/usage/subscriptionInvoiceSchema.js";
2
+ import { jsonTerms } from "./helpers.js";
3
+ import { scopeKey } from "../usage/helpers.js";
4
+ import { appendSnapshot } from "./history.js";
5
+ export async function abandonEnrollment(ctx, intent, proofJson) {
6
+ if (new TextEncoder().encode(proofJson).length > 4096)
7
+ throw new Error("Abandonment evidence exceeds size limit");
8
+ const proof = abandonmentProof.parse(JSON.parse(proofJson)), { terms } = jsonTerms(intent.termsJson), first = terms.meters[0];
9
+ if (proof.stripeAccountId !== first.scope.stripeAccountId ||
10
+ proof.customerAccount !== first.scope.customerAccount ||
11
+ proof.stripeCustomerId !== first.binding.stripeCustomerId ||
12
+ proof.livemode !== first.scope.livemode ||
13
+ (proof.kind === "checkout"
14
+ ? intent.checkoutId !== proof.nativeId || intent.providerId !== undefined
15
+ : intent.providerId !== proof.nativeId))
16
+ throw new Error("Abandoned signup binding mismatch");
17
+ if (intent.retiredAt !== undefined) {
18
+ if (intent.abandonedId !== proof.nativeId)
19
+ throw new Error("Abandonment replay conflict");
20
+ return;
21
+ }
22
+ if (intent.controlKey)
23
+ throw new Error("Cancellation command is still pending");
24
+ for (const meter of terms.meters) {
25
+ const key = scopeKey(meter.scope);
26
+ const events = proof.kind === "subscription"
27
+ ? await ctx.db
28
+ .query("usageEvents")
29
+ .withIndex("by_scope_subscription", (q) => q.eq("scopeKey", key).eq("subscriptionId", proof.nativeId))
30
+ .take(1)
31
+ : [];
32
+ const reservations = await ctx.db
33
+ .query("usageReservations")
34
+ .withIndex("by_scope_state", (q) => q.eq("scopeKey", key).eq("state", "reserved"))
35
+ .take(1);
36
+ if (events.length || reservations.length)
37
+ throw new Error("Signup has usage or pending reservations");
38
+ }
39
+ await appendSnapshot(ctx, intent, "retirement", proof.nativeId, { abandonment: proof, creditTreatment: "retain_original_terms" }, Date.now());
40
+ for (const { scope, binding } of terms.meters) {
41
+ const key = JSON.stringify([
42
+ scope.stripeAccountId,
43
+ scope.livemode,
44
+ binding.stripeCustomerId,
45
+ scope.meterId,
46
+ ]);
47
+ const lock = await ctx.db
48
+ .query("usageSubscriptionLocks")
49
+ .withIndex("by_key", (q) => q.eq("key", key))
50
+ .unique();
51
+ if (lock?.intentKey === intent.key)
52
+ await ctx.db.delete("usageSubscriptionLocks", lock._id);
53
+ }
54
+ await ctx.db.patch("usageSubscriptionIntents", intent._id, {
55
+ retiredAt: Math.floor(Date.now() / 1000),
56
+ abandonedId: proof.nativeId,
57
+ });
58
+ }
59
+ //# sourceMappingURL=abandonment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"abandonment.js","sourceRoot":"","sources":["../../../src/component/usageSubscriptions/abandonment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { QueryCtx } from "../_generated/server.js";
2
+ import type { PreparedUsageRecord } from "../../client/usage/records.js";
3
+ import type { UsageSubscriptionBinding } from "../../client/usage/boundaries.js";
4
+ import type { UsageSubscriptionView } from "../../client/usage/subscriptionTerms.js";
5
+ /** Managed v1 closes new acceptance/sends 60 seconds before the native period. */
6
+ export declare function managedBillingPolicy(ctx: QueryCtx, record: PreparedUsageRecord, subscription: UsageSubscriptionBinding): Promise<{
7
+ cutoff: number;
8
+ collection: UsageSubscriptionView["collection"] | null;
9
+ } | null>;
10
+ export declare function managedBillingCutoff(ctx: QueryCtx, record: PreparedUsageRecord, subscription: UsageSubscriptionBinding): Promise<number | null>;
11
+ //# sourceMappingURL=acceptance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../../../src/component/usageSubscriptions/acceptance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACxD,GAAG,IAAI,CAAC,CA0CR;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB"}
@@ -0,0 +1,38 @@
1
+ import { convexToJson } from "convex/values";
2
+ /** Managed v1 closes new acceptance/sends 60 seconds before the native period. */
3
+ export async function managedBillingPolicy(ctx, record, subscription) {
4
+ const candidates = await ctx.db
5
+ .query("usageSubscriptionIntents")
6
+ .withIndex("by_provider", (q) => q.eq("providerId", subscription.subscriptionId))
7
+ .take(3);
8
+ const matched = candidates.filter((intent) => {
9
+ const scope = JSON.parse(intent.scopeKey);
10
+ return (scope.stripeAccountId === record.scope.stripeAccountId &&
11
+ scope.livemode === record.scope.livemode &&
12
+ scope.customerAccount === record.scope.customerAccount);
13
+ });
14
+ if (!matched.length)
15
+ return candidates.length >= 3 ? { cutoff: 0, collection: null } : null;
16
+ if (matched.length !== 1 ||
17
+ !matched[0].viewJson ||
18
+ matched[0].retiredAt !== undefined)
19
+ return { cutoff: 0, collection: null };
20
+ const view = JSON.parse(matched[0].viewJson);
21
+ const original = view.bindings.find((item) => item.scope.meterId === record.scope.meterId &&
22
+ item.subscription.subscriptionItemId === subscription.subscriptionItemId);
23
+ if (!view.collection ||
24
+ !original ||
25
+ view.status !== "active" ||
26
+ JSON.stringify(convexToJson(original.scope)) !==
27
+ JSON.stringify(convexToJson(record.scope)) ||
28
+ JSON.stringify(convexToJson(original.binding)) !==
29
+ JSON.stringify(convexToJson(record.binding)) ||
30
+ JSON.stringify(convexToJson(original.subscription)) !==
31
+ JSON.stringify(convexToJson(subscription)))
32
+ return { cutoff: 0, collection: null };
33
+ return { cutoff: subscription.period.end - 60, collection: view.collection };
34
+ }
35
+ export async function managedBillingCutoff(ctx, record, subscription) {
36
+ return ((await managedBillingPolicy(ctx, record, subscription))?.cutoff ?? null);
37
+ }
38
+ //# sourceMappingURL=acceptance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"acceptance.js","sourceRoot":"","sources":["../../../src/component/usageSubscriptions/acceptance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ export declare function jsonTerms(json: string): {
2
+ terms: {
3
+ requestId: string;
4
+ fixedPriceIds: string[];
5
+ collection: {
6
+ method: "send_invoice";
7
+ daysUntilDue: number;
8
+ } | {
9
+ method: "charge_automatically";
10
+ defaultPaymentMethod: string;
11
+ } | {
12
+ method: "checkout";
13
+ successUrl: string;
14
+ cancelUrl: string;
15
+ };
16
+ meters: {
17
+ scope: {
18
+ stripeAccountId: string;
19
+ customerAccount: string;
20
+ meterId: string;
21
+ livemode: boolean;
22
+ };
23
+ binding: Omit<{
24
+ stripeCustomerId: string;
25
+ stripePriceId: string;
26
+ eventName: string;
27
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
28
+ plan: unknown;
29
+ }, "plan"> & {
30
+ plan: import("../../client/usage/contracts.js").UsagePlan;
31
+ };
32
+ }[];
33
+ };
34
+ termsJson: string;
35
+ scopeKey: string;
36
+ };
37
+ export declare function intentKey(scope: unknown, requestId: string): Promise<string>;
38
+ export declare function observationStart(startedAt: number): void;
39
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/component/usageSubscriptions/helpers.ts"],"names":[],"mappings":"AAOA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrC;AACD,wBAAsB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAOhE;AACD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,QAOjD"}
@@ -0,0 +1,28 @@
1
+ import { convexToJson } from "convex/values";
2
+ import { canonicalFingerprint } from "../operationEvidence/canonical.js";
3
+ import { subscriptionScope, subscriptionScopeSchema, subscriptionTerms, } from "../../client/usage/subscriptionTerms.js";
4
+ export function jsonTerms(json) {
5
+ if (new TextEncoder().encode(json).length > 32768)
6
+ throw new Error("Subscription terms exceed size limit");
7
+ const terms = subscriptionTerms(JSON.parse(json));
8
+ return {
9
+ terms,
10
+ termsJson: JSON.stringify(convexToJson(terms)),
11
+ scopeKey: JSON.stringify(subscriptionScope(terms)),
12
+ };
13
+ }
14
+ export async function intentKey(scope, requestId) {
15
+ if (!requestId || requestId.length > 100)
16
+ throw new Error("Invalid subscription request identity");
17
+ return canonicalFingerprint([
18
+ subscriptionScopeSchema.parse(scope),
19
+ requestId,
20
+ ]);
21
+ }
22
+ export function observationStart(startedAt) {
23
+ if (!Number.isSafeInteger(startedAt) ||
24
+ startedAt < 0 ||
25
+ startedAt > Date.now() + 300000)
26
+ throw new Error("Invalid subscription observation time");
27
+ }
28
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/component/usageSubscriptions/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,KAAK;QAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,OAAO;QACL,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC9C,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;KACnD,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAc,EAAE,SAAiB;IAC/D,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG;QACtC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,OAAO,oBAAoB,CAAC;QAC1B,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC;QACpC,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAChC,SAAS,GAAG,CAAC;QACb,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM;QAE/B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC7D,CAAC"}