@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,147 @@
1
+ import { runMutationOrThrow } from "../helpers.js";
2
+ import { componentRef } from "../webhooks/helpers.js";
3
+ import { verifyRealm, verifyMeter, UsageCatalogError } from "./catalogTypes.js";
4
+ import { verifyPinnedUsagePrice } from "./catalogPrices.js";
5
+ import { subscriptionTerms, subscriptionEvidence, subscriptionView, } from "./subscriptionTerms.js";
6
+ import { UsageSubscriptionError } from "./subscriptionErrors.js";
7
+ export { UsageSubscriptionError } from "./subscriptionErrors.js";
8
+ export async function subscriptionCall(fn) {
9
+ try {
10
+ return await fn();
11
+ }
12
+ catch (error) {
13
+ if (error instanceof UsageSubscriptionError)
14
+ throw error;
15
+ if (error instanceof UsageCatalogError &&
16
+ ["unsupported_scope", "incompatible_terms"].includes(error.code))
17
+ throw new UsageSubscriptionError(error.code, "Native usage subscription scope or pricing is unsupported");
18
+ throw new UsageSubscriptionError("provider_unavailable", "Native usage subscription unavailable");
19
+ }
20
+ }
21
+ export async function verifySubscriptionRealm(stripe, terms) {
22
+ const first = terms.meters[0];
23
+ await verifyRealm(stripe, {
24
+ stripeAccountId: first.scope.stripeAccountId,
25
+ livemode: first.scope.livemode,
26
+ });
27
+ const customer = await stripe.customers.retrieve(first.scope.customerAccount);
28
+ if (customer.deleted ||
29
+ customer.id !== first.binding.stripeCustomerId ||
30
+ customer.customer_account !== first.scope.customerAccount ||
31
+ customer.livemode !== first.scope.livemode)
32
+ throw new UsageSubscriptionError("unsupported_scope", "Native usage subscription payer mismatch");
33
+ }
34
+ export async function verifySubscriptionPrices(stripe, terms) {
35
+ for (const { scope, binding } of terms.meters) {
36
+ const [meter, price] = await Promise.all([
37
+ stripe.billing.meters.retrieve(scope.meterId),
38
+ stripe.prices.retrieve(binding.stripePriceId, { expand: ["tiers"] }),
39
+ ]);
40
+ if (meter.id !== scope.meterId || price.id !== binding.stripePriceId)
41
+ throw new UsageSubscriptionError("incompatible_terms", "Native usage subscription price mismatch");
42
+ verifyMeter(meter, {
43
+ scope,
44
+ plan: binding.plan,
45
+ eventName: binding.eventName,
46
+ displayName: meter.display_name,
47
+ });
48
+ verifyPinnedUsagePrice(price, { stripeAccountId: scope.stripeAccountId, livemode: scope.livemode }, binding.plan, scope.meterId);
49
+ }
50
+ for (const id of terms.fixedPriceIds) {
51
+ const price = await stripe.prices.retrieve(id);
52
+ if (price.id !== id ||
53
+ !price.active ||
54
+ price.livemode !== terms.meters[0].scope.livemode ||
55
+ price.currency !== terms.meters[0].binding.plan.rate.currency ||
56
+ price.recurring?.interval !== "month" ||
57
+ price.recurring.interval_count !== 1 ||
58
+ price.recurring.usage_type !== "licensed" ||
59
+ price.transform_quantity != null ||
60
+ price.billing_scheme !== "per_unit" ||
61
+ !Number.isSafeInteger(price.unit_amount))
62
+ throw new UsageSubscriptionError("incompatible_terms", "Native fixed subscription price is unsupported");
63
+ }
64
+ }
65
+ export async function discoverSubscription(stripe, terms, key) {
66
+ let cursor, found;
67
+ for (let page = 0; page < 10; page++) {
68
+ const result = await stripe.subscriptions.list({
69
+ customer_account: terms.meters[0].scope.customerAccount,
70
+ status: "all",
71
+ limit: 100,
72
+ ...(cursor ? { starting_after: cursor } : {}),
73
+ });
74
+ if (result.data.length > 100)
75
+ throw new UsageSubscriptionError("incompatible_terms", "Native subscription inventory exceeds page budget");
76
+ for (const sub of result.data) {
77
+ if (sub.customer_account !== terms.meters[0].scope.customerAccount ||
78
+ sub.livemode !== terms.meters[0].scope.livemode ||
79
+ sub.items.has_more)
80
+ throw new UsageSubscriptionError("incompatible_terms", "Native subscription inventory is incomplete or mismatched");
81
+ if (sub.metadata?.bsUsageIntent === key) {
82
+ if (found)
83
+ throw new UsageSubscriptionError("overlapping_enrollment", "Duplicate native usage subscription identity");
84
+ found = sub;
85
+ }
86
+ else if (!["canceled", "incomplete_expired"].includes(sub.status) &&
87
+ sub.items.data.some((item) => terms.meters.some((meter) => item.price.recurring?.meter === meter.scope.meterId)))
88
+ throw new UsageSubscriptionError("overlapping_enrollment", "Native customer/meter subscription overlap");
89
+ }
90
+ if (!result.has_more)
91
+ return found;
92
+ const next = result.data[result.data.length - 1]?.id;
93
+ if (!next || next === cursor)
94
+ break;
95
+ cursor = next;
96
+ }
97
+ throw new UsageSubscriptionError("incompatible_terms", "Native subscription inventory exceeds bounded history");
98
+ }
99
+ export async function saveSubscription(component, ctx, key, native, terms, startedAt) {
100
+ const evidence = subscriptionEvidence(native), view = subscriptionView(evidence, terms);
101
+ await runMutationOrThrow(ctx, componentRef(component, "usageSubscriptions/mutations/save"), { key, nativeJson: JSON.stringify(evidence), startedAt });
102
+ return view;
103
+ }
104
+ export async function prepareSubscription(component, ctx, terms, method) {
105
+ return runMutationOrThrow(ctx, componentRef(component, "usageSubscriptions/mutations/prepare"), { termsJson: JSON.stringify(terms), method });
106
+ }
107
+ export async function ensureManagedSubscription(stripe, component, ctx, input) {
108
+ const terms = subscriptionTerms(input), startedAt = Date.now();
109
+ return subscriptionCall(async () => {
110
+ if (terms.collection.method === "checkout")
111
+ throw new UsageSubscriptionError("incompatible_terms", "Use the managed Checkout API for Checkout collection");
112
+ await verifySubscriptionRealm(stripe, terms);
113
+ const row = await prepareSubscription(component, ctx, terms, "direct");
114
+ if (!row.providerId)
115
+ await verifySubscriptionPrices(stripe, terms);
116
+ let sub = row.providerId
117
+ ? await stripe.subscriptions.retrieve(row.providerId)
118
+ : await discoverSubscription(stripe, terms, row.key);
119
+ if (row.providerId && sub?.id !== row.providerId)
120
+ throw new UsageSubscriptionError("incompatible_terms", "Pinned subscription identity changed");
121
+ if (!sub) {
122
+ if (Date.now() / 1000 - row.firstAttemptAt >= 23 * 3600)
123
+ throw new UsageSubscriptionError("unknown_create_outcome", "Native subscription create requires reconciliation after safe retry window");
124
+ sub = await stripe.subscriptions.create({
125
+ customer_account: terms.meters[0].scope.customerAccount,
126
+ billing_mode: { type: "flexible" },
127
+ items: [
128
+ ...terms.meters.map((m) => ({ price: m.binding.stripePriceId })),
129
+ ...terms.fixedPriceIds.map((price) => ({ price, quantity: 1 })),
130
+ ],
131
+ ...(terms.collection.method === "send_invoice"
132
+ ? {
133
+ collection_method: "send_invoice",
134
+ days_until_due: terms.collection.daysUntilDue,
135
+ }
136
+ : {
137
+ collection_method: "charge_automatically",
138
+ default_payment_method: terms.collection.defaultPaymentMethod,
139
+ payment_behavior: "default_incomplete",
140
+ }),
141
+ metadata: { bsUsageIntent: row.key },
142
+ }, { idempotencyKey: `bs_usage_sub_${row.key}` });
143
+ }
144
+ return saveSubscription(component, ctx, row.key, sub, terms, startedAt);
145
+ });
146
+ }
147
+ //# sourceMappingURL=subscriptionProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionProvider.js","sourceRoot":"","sources":["../../../src/client/usage/subscriptionProvider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,161 @@
1
+ import { z } from "zod";
2
+ import { type PreparedUsageRecord, type UsageScope } from "./records.js";
3
+ import type { UsageSubscriptionBinding } from "./boundaries.js";
4
+ export type UsageSubscriptionOptions = {
5
+ requestId: string;
6
+ meters: Array<{
7
+ scope: UsageScope;
8
+ binding: Omit<PreparedUsageRecord["binding"], "apiVersion"> & {
9
+ apiVersion?: string;
10
+ };
11
+ }>;
12
+ fixedPriceIds?: string[];
13
+ collection: {
14
+ method: "send_invoice";
15
+ daysUntilDue: number;
16
+ } | {
17
+ method: "charge_automatically";
18
+ defaultPaymentMethod: string;
19
+ } | {
20
+ method: "checkout";
21
+ successUrl: string;
22
+ cancelUrl: string;
23
+ };
24
+ };
25
+ export declare function subscriptionTerms(input: unknown): {
26
+ requestId: string;
27
+ fixedPriceIds: string[];
28
+ collection: {
29
+ method: "send_invoice";
30
+ daysUntilDue: number;
31
+ } | {
32
+ method: "charge_automatically";
33
+ defaultPaymentMethod: string;
34
+ } | {
35
+ method: "checkout";
36
+ successUrl: string;
37
+ cancelUrl: string;
38
+ };
39
+ meters: {
40
+ scope: {
41
+ stripeAccountId: string;
42
+ customerAccount: string;
43
+ meterId: string;
44
+ livemode: boolean;
45
+ };
46
+ binding: Omit<{
47
+ stripeCustomerId: string;
48
+ stripePriceId: string;
49
+ eventName: string;
50
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
51
+ plan: unknown;
52
+ }, "plan"> & {
53
+ plan: import("./contracts.js").UsagePlan;
54
+ };
55
+ }[];
56
+ };
57
+ export type UsageSubscriptionTerms = ReturnType<typeof subscriptionTerms>;
58
+ export declare function subscriptionScope(terms: UsageSubscriptionTerms): {
59
+ stripeAccountId: string;
60
+ customerAccount: string;
61
+ livemode: boolean;
62
+ };
63
+ export declare const subscriptionScopeSchema: z.ZodObject<{
64
+ stripeAccountId: z.ZodString;
65
+ customerAccount: z.ZodString;
66
+ livemode: z.ZodBoolean;
67
+ }, z.core.$strict>;
68
+ export declare function subscriptionEvidence(input: unknown): {
69
+ id: string;
70
+ livemode: boolean;
71
+ customer_account: string;
72
+ customer: string | {
73
+ id: string;
74
+ };
75
+ status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
76
+ currency: string;
77
+ collection_method: "charge_automatically" | "send_invoice";
78
+ days_until_due: number | null;
79
+ default_payment_method: string | {
80
+ id: string;
81
+ } | null;
82
+ billing_mode: {
83
+ type: "classic" | "flexible";
84
+ };
85
+ cancel_at_period_end: boolean;
86
+ cancel_at: number | null;
87
+ items: {
88
+ has_more: false;
89
+ data: {
90
+ id: string;
91
+ current_period_start: number;
92
+ current_period_end: number;
93
+ quantity?: number | null | undefined;
94
+ price: {
95
+ id: string;
96
+ currency: string;
97
+ recurring: {
98
+ interval: "month";
99
+ interval_count: 1;
100
+ usage_type: "licensed" | "metered";
101
+ meter?: string | null | undefined;
102
+ };
103
+ unit_amount_decimal: string | null;
104
+ };
105
+ }[];
106
+ };
107
+ };
108
+ export declare function subscriptionView(input: unknown, terms: UsageSubscriptionTerms): {
109
+ subscriptionId: string;
110
+ status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
111
+ currency: string;
112
+ billingMode: "flexible";
113
+ collection: {
114
+ method: "charge_automatically" | "send_invoice";
115
+ daysUntilDue: number | null;
116
+ defaultPaymentMethod: string | null;
117
+ };
118
+ cancelAtPeriodEnd: boolean;
119
+ cancelAt: number | null;
120
+ items: {
121
+ id: string;
122
+ stripePriceId: string;
123
+ meterId: string | null;
124
+ period: {
125
+ start: number;
126
+ end: number;
127
+ };
128
+ quantity: string | null;
129
+ unitAmountDecimal: string | null;
130
+ }[];
131
+ bindings: {
132
+ scope: {
133
+ stripeAccountId: string;
134
+ customerAccount: string;
135
+ meterId: string;
136
+ livemode: boolean;
137
+ };
138
+ binding: Omit<{
139
+ stripeCustomerId: string;
140
+ stripePriceId: string;
141
+ eventName: string;
142
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
143
+ plan: unknown;
144
+ }, "plan"> & {
145
+ plan: import("./contracts.js").UsagePlan;
146
+ };
147
+ subscription: UsageSubscriptionBinding;
148
+ }[];
149
+ };
150
+ export type UsageSubscriptionView = ReturnType<typeof subscriptionView>;
151
+ export declare function closeoutPolicy(input: {
152
+ queued: number;
153
+ unknown: number;
154
+ reservations: number;
155
+ finalized: boolean;
156
+ }): {
157
+ ready: boolean;
158
+ reason: string;
159
+ paymentEvidence: "not_resolved";
160
+ };
161
+ //# sourceMappingURL=subscriptionTerms.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionTerms.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscriptionTerms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,UAAU,CAAC;QAClB,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,GAAG;YAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EACN;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAChD;QAAE,MAAM,EAAE,sBAAsB,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,GAChE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE,CAAC;AA8BF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC/C;AACD,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC1E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB;;;;EAG9D;AACD,eAAO,MAAM,uBAAuB;;;;kBAIlC,CAAC;AA0DH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBlD;AACD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,sBAAsB;;;;;;;;;;;;;;;;;YA2DvB,KAAK;YACL,GAAG;;;;;;;;;;;;;;;;;;;;;;;EAuCV;AACD,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;;;qBAeoB,cAAc;EAElC"}
@@ -0,0 +1,242 @@
1
+ import { z } from "zod";
2
+ import { prepareUsageRecord, } from "./records.js";
3
+ const id = (prefix) => z
4
+ .string()
5
+ .regex(new RegExp(`^${prefix}_[a-zA-Z0-9]+$`))
6
+ .max(100);
7
+ const seconds = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
8
+ const requestSchema = z.strictObject({
9
+ requestId: z.string().min(1).max(100),
10
+ meters: z
11
+ .array(z.strictObject({ scope: z.unknown(), binding: z.unknown() }))
12
+ .min(1)
13
+ .max(10),
14
+ fixedPriceIds: z.array(id("price")).max(10).default([]),
15
+ collection: z.discriminatedUnion("method", [
16
+ z.strictObject({
17
+ method: z.literal("send_invoice"),
18
+ daysUntilDue: z.number().int().min(1).max(365),
19
+ }),
20
+ z.strictObject({
21
+ method: z.literal("charge_automatically"),
22
+ defaultPaymentMethod: id("pm"),
23
+ }),
24
+ z.strictObject({
25
+ method: z.literal("checkout"),
26
+ successUrl: z.url({ protocol: /^https?$/ }).max(2048),
27
+ cancelUrl: z.url({ protocol: /^https?$/ }).max(2048),
28
+ }),
29
+ ]),
30
+ });
31
+ export function subscriptionTerms(input) {
32
+ const parsed = requestSchema.parse(input);
33
+ const meters = parsed.meters.map((meter) => {
34
+ const { scope, binding } = prepareUsageRecord({
35
+ ...meter,
36
+ sourceEventId: "subscription",
37
+ quantity: "0",
38
+ occurredAt: 0,
39
+ });
40
+ return { scope, binding };
41
+ });
42
+ const first = meters[0], prices = new Set(parsed.fixedPriceIds), meterIds = new Set();
43
+ if (prices.size !== parsed.fixedPriceIds.length)
44
+ throw new Error("Duplicate fixed price");
45
+ for (const meter of meters) {
46
+ if (meter.scope.stripeAccountId !== first.scope.stripeAccountId ||
47
+ meter.scope.livemode !== first.scope.livemode ||
48
+ meter.scope.customerAccount !== first.scope.customerAccount ||
49
+ meter.binding.stripeCustomerId !== first.binding.stripeCustomerId ||
50
+ meter.binding.apiVersion !== first.binding.apiVersion ||
51
+ meter.binding.plan.rate.currency !== first.binding.plan.rate.currency ||
52
+ prices.has(meter.binding.stripePriceId) ||
53
+ meterIds.has(meter.scope.meterId))
54
+ throw new Error("Incompatible or duplicate usage subscription bindings");
55
+ prices.add(meter.binding.stripePriceId);
56
+ meterIds.add(meter.scope.meterId);
57
+ }
58
+ return { ...parsed, meters };
59
+ }
60
+ export function subscriptionScope(terms) {
61
+ const { stripeAccountId, customerAccount, livemode } = terms.meters[0].scope;
62
+ return { stripeAccountId, customerAccount, livemode };
63
+ }
64
+ export const subscriptionScopeSchema = z.strictObject({
65
+ stripeAccountId: id("acct"),
66
+ customerAccount: id("acct"),
67
+ livemode: z.boolean(),
68
+ });
69
+ const nativeSchema = z.object({
70
+ id: id("sub"),
71
+ livemode: z.boolean(),
72
+ customer_account: id("acct"),
73
+ customer: z.union([id("cus"), z.object({ id: id("cus") })]),
74
+ status: z.enum([
75
+ "active",
76
+ "trialing",
77
+ "past_due",
78
+ "canceled",
79
+ "incomplete",
80
+ "incomplete_expired",
81
+ "unpaid",
82
+ "paused",
83
+ ]),
84
+ currency: z.string().regex(/^[a-z]{3}$/),
85
+ collection_method: z.enum(["send_invoice", "charge_automatically"]),
86
+ days_until_due: z.number().int().min(1).max(365).nullable().default(null),
87
+ default_payment_method: z
88
+ .union([id("pm"), z.object({ id: id("pm") })])
89
+ .nullable()
90
+ .default(null),
91
+ billing_mode: z.object({ type: z.enum(["classic", "flexible"]) }),
92
+ cancel_at_period_end: z.boolean(),
93
+ cancel_at: seconds.nullable().default(null),
94
+ items: z.object({
95
+ has_more: z.literal(false),
96
+ data: z
97
+ .array(z.object({
98
+ id: id("si"),
99
+ current_period_start: seconds,
100
+ current_period_end: seconds,
101
+ quantity: z
102
+ .number()
103
+ .int()
104
+ .nonnegative()
105
+ .max(Number.MAX_SAFE_INTEGER)
106
+ .nullable()
107
+ .optional(),
108
+ price: z.object({
109
+ id: id("price"),
110
+ currency: z.string(),
111
+ recurring: z.object({
112
+ interval: z.literal("month"),
113
+ interval_count: z.literal(1),
114
+ usage_type: z.enum(["metered", "licensed"]),
115
+ meter: z.string().nullable().optional(),
116
+ }),
117
+ unit_amount_decimal: z.unknown().optional(),
118
+ }),
119
+ }))
120
+ .min(1)
121
+ .max(20),
122
+ }),
123
+ });
124
+ export function subscriptionEvidence(input) {
125
+ const sub = nativeSchema.parse(input);
126
+ return {
127
+ ...sub,
128
+ items: {
129
+ ...sub.items,
130
+ data: sub.items.data.map((item) => {
131
+ const amount = item.price.unit_amount_decimal?.toString() ?? null;
132
+ if (amount !== null && !/^\d+(\.\d{1,12})?$/.test(amount))
133
+ throw new Error("Invalid native rate precision");
134
+ return {
135
+ ...item,
136
+ price: { ...item.price, unit_amount_decimal: amount },
137
+ };
138
+ }),
139
+ },
140
+ };
141
+ }
142
+ export function subscriptionView(input, terms) {
143
+ const sub = subscriptionEvidence(input), first = terms.meters[0];
144
+ const customer = typeof sub.customer === "string" ? sub.customer : sub.customer.id;
145
+ if (sub.customer_account !== first.scope.customerAccount ||
146
+ customer !== first.binding.stripeCustomerId ||
147
+ sub.livemode !== first.scope.livemode ||
148
+ sub.currency !== first.binding.plan.rate.currency ||
149
+ sub.billing_mode.type !== "flexible")
150
+ throw new Error("Native subscription scope or billing mode mismatch");
151
+ const defaultPaymentMethod = typeof sub.default_payment_method === "string"
152
+ ? sub.default_payment_method
153
+ : (sub.default_payment_method?.id ?? null);
154
+ if (terms.collection.method === "send_invoice"
155
+ ? sub.collection_method !== "send_invoice" ||
156
+ sub.days_until_due !== terms.collection.daysUntilDue
157
+ : sub.collection_method !== "charge_automatically" ||
158
+ (terms.collection.method === "charge_automatically" &&
159
+ defaultPaymentMethod !== terms.collection.defaultPaymentMethod))
160
+ throw new Error("Native subscription collection terms changed");
161
+ const expectedPrices = new Set([
162
+ ...terms.fixedPriceIds,
163
+ ...terms.meters.map((m) => m.binding.stripePriceId),
164
+ ]);
165
+ const seen = new Set();
166
+ const items = sub.items.data.map((item) => {
167
+ if (item.current_period_end <= item.current_period_start ||
168
+ !expectedPrices.has(item.price.id) ||
169
+ seen.has(item.price.id) ||
170
+ item.price.currency !== sub.currency)
171
+ throw new Error("Native subscription items changed or are incomplete");
172
+ seen.add(item.price.id);
173
+ const metered = terms.meters.find((m) => m.binding.stripePriceId === item.price.id);
174
+ if (metered
175
+ ? item.price.recurring.usage_type !== "metered" ||
176
+ item.price.recurring.meter !== metered.scope.meterId
177
+ : item.price.recurring.usage_type !== "licensed")
178
+ throw new Error("Native subscription meter mismatch");
179
+ const amount = item.price.unit_amount_decimal?.toString() ?? null;
180
+ if (amount !== null && !/^\d+(\.\d{1,12})?$/.test(amount))
181
+ throw new Error("Invalid native rate precision");
182
+ return {
183
+ id: item.id,
184
+ stripePriceId: item.price.id,
185
+ meterId: metered?.scope.meterId ?? null,
186
+ period: {
187
+ start: item.current_period_start,
188
+ end: item.current_period_end,
189
+ },
190
+ quantity: item.quantity === undefined || item.quantity === null
191
+ ? null
192
+ : String(item.quantity),
193
+ unitAmountDecimal: amount,
194
+ };
195
+ });
196
+ if (seen.size !== expectedPrices.size)
197
+ throw new Error("Native subscription has missing items");
198
+ const bindings = terms.meters.map((meter) => {
199
+ const item = items.find((i) => i.stripePriceId === meter.binding.stripePriceId);
200
+ const subscription = {
201
+ subscriptionId: sub.id,
202
+ subscriptionItemId: item.id,
203
+ stripePriceId: item.stripePriceId,
204
+ period: item.period,
205
+ interval: "month",
206
+ };
207
+ return { ...meter, subscription };
208
+ });
209
+ return {
210
+ subscriptionId: sub.id,
211
+ status: sub.status,
212
+ currency: sub.currency,
213
+ billingMode: sub.billing_mode.type,
214
+ collection: {
215
+ method: sub.collection_method,
216
+ daysUntilDue: sub.days_until_due,
217
+ defaultPaymentMethod,
218
+ },
219
+ cancelAtPeriodEnd: sub.cancel_at_period_end,
220
+ cancelAt: sub.cancel_at,
221
+ items,
222
+ bindings,
223
+ };
224
+ }
225
+ export function closeoutPolicy(input) {
226
+ for (const count of [input.queued, input.unknown, input.reservations])
227
+ if (!Number.isSafeInteger(count) || count < 0)
228
+ throw new Error("Invalid closeout counters");
229
+ const reason = input.queued || input.unknown
230
+ ? "pending_usage"
231
+ : input.reservations
232
+ ? "pending_reservations"
233
+ : !input.finalized
234
+ ? "invoice_not_finalized"
235
+ : "finalized_observation";
236
+ return {
237
+ ready: reason === "finalized_observation",
238
+ reason,
239
+ paymentEvidence: "not_resolved",
240
+ };
241
+ }
242
+ //# sourceMappingURL=subscriptionTerms.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionTerms.js","sourceRoot":"","sources":["../../../src/client/usage/subscriptionTerms.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import Stripe from "stripe";
2
+ import { initConvexTest } from "../setup.test.js";
3
+ import type { Component } from "../helpers.js";
4
+ import { nativeSubscription } from "./subscription.fixtures.js";
5
+ export declare function fixture(external?: boolean, failCreate?: boolean): {
6
+ t: ReturnType<typeof initConvexTest>;
7
+ component: Component;
8
+ stripe: Stripe;
9
+ httpClient: Stripe.HttpClient;
10
+ calls: Array<{
11
+ path: string;
12
+ method: string;
13
+ body: URLSearchParams;
14
+ key: string | null;
15
+ }>;
16
+ state: {
17
+ native?: ReturnType<typeof nativeSubscription> & {
18
+ metadata?: Record<string, string>;
19
+ };
20
+ session?: Record<string, unknown>;
21
+ missingNative?: boolean;
22
+ realmId?: string;
23
+ };
24
+ };
25
+ //# sourceMappingURL=subscriptionTransport.fixtures.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subscriptionTransport.fixtures.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscriptionTransport.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,wBAAgB,OAAO,CACrB,QAAQ,UAAQ,EAChB,UAAU,UAAQ,GACjB;IACD,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,eAAe,CAAC;QACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACpB,CAAC,CAAC;IACH,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAAG;YAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACnC,CAAC;QACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAoNA"}