@fantastic.dev/better-stripe 0.4.0-bootstrap.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 (762) hide show
  1. package/CHANGELOG.md +318 -0
  2. package/README.md +1117 -0
  3. package/dist/client/billing/checkout.d.ts +75 -0
  4. package/dist/client/billing/checkout.d.ts.map +1 -0
  5. package/dist/client/billing/checkout.js +260 -0
  6. package/dist/client/billing/checkout.js.map +1 -0
  7. package/dist/client/billing/invoices.d.ts +37 -0
  8. package/dist/client/billing/invoices.d.ts.map +1 -0
  9. package/dist/client/billing/invoices.js +29 -0
  10. package/dist/client/billing/invoices.js.map +1 -0
  11. package/dist/client/billing/subscriptions.d.ts +179 -0
  12. package/dist/client/billing/subscriptions.d.ts.map +1 -0
  13. package/dist/client/billing/subscriptions.js +346 -0
  14. package/dist/client/billing/subscriptions.js.map +1 -0
  15. package/dist/client/connect/disputes.d.ts +112 -0
  16. package/dist/client/connect/disputes.d.ts.map +1 -0
  17. package/dist/client/connect/disputes.js +186 -0
  18. package/dist/client/connect/disputes.js.map +1 -0
  19. package/dist/client/connect/paymentMethodUtils.d.ts +17 -0
  20. package/dist/client/connect/paymentMethodUtils.d.ts.map +1 -0
  21. package/dist/client/connect/paymentMethodUtils.js +24 -0
  22. package/dist/client/connect/paymentMethodUtils.js.map +1 -0
  23. package/dist/client/connect/paymentMethods.d.ts +23 -0
  24. package/dist/client/connect/paymentMethods.d.ts.map +1 -0
  25. package/dist/client/connect/paymentMethods.js +27 -0
  26. package/dist/client/connect/paymentMethods.js.map +1 -0
  27. package/dist/client/connect/payouts.d.ts +47 -0
  28. package/dist/client/connect/payouts.d.ts.map +1 -0
  29. package/dist/client/connect/payouts.js +52 -0
  30. package/dist/client/connect/payouts.js.map +1 -0
  31. package/dist/client/connect/refundActor.d.ts +50 -0
  32. package/dist/client/connect/refundActor.d.ts.map +1 -0
  33. package/dist/client/connect/refundActor.js +17 -0
  34. package/dist/client/connect/refundActor.js.map +1 -0
  35. package/dist/client/connect/refunds.d.ts +75 -0
  36. package/dist/client/connect/refunds.d.ts.map +1 -0
  37. package/dist/client/connect/refunds.js +141 -0
  38. package/dist/client/connect/refunds.js.map +1 -0
  39. package/dist/client/connect/transfers.d.ts +189 -0
  40. package/dist/client/connect/transfers.d.ts.map +1 -0
  41. package/dist/client/connect/transfers.js +347 -0
  42. package/dist/client/connect/transfers.js.map +1 -0
  43. package/dist/client/constants.d.ts +15 -0
  44. package/dist/client/constants.d.ts.map +1 -0
  45. package/dist/client/constants.js +14 -0
  46. package/dist/client/constants.js.map +1 -0
  47. package/dist/client/core/accountLinks.d.ts +68 -0
  48. package/dist/client/core/accountLinks.d.ts.map +1 -0
  49. package/dist/client/core/accountLinks.js +131 -0
  50. package/dist/client/core/accountLinks.js.map +1 -0
  51. package/dist/client/core/accountStatus.d.ts +12 -0
  52. package/dist/client/core/accountStatus.d.ts.map +1 -0
  53. package/dist/client/core/accountStatus.js +56 -0
  54. package/dist/client/core/accountStatus.js.map +1 -0
  55. package/dist/client/core/accounts.d.ts +181 -0
  56. package/dist/client/core/accounts.d.ts.map +1 -0
  57. package/dist/client/core/accounts.js +359 -0
  58. package/dist/client/core/accounts.js.map +1 -0
  59. package/dist/client/core/config.d.ts +5 -0
  60. package/dist/client/core/config.d.ts.map +1 -0
  61. package/dist/client/core/config.js +11 -0
  62. package/dist/client/core/config.js.map +1 -0
  63. package/dist/client/core/descriptors.d.ts +24 -0
  64. package/dist/client/core/descriptors.d.ts.map +1 -0
  65. package/dist/client/core/descriptors.js +43 -0
  66. package/dist/client/core/descriptors.js.map +1 -0
  67. package/dist/client/core/fees.d.ts +83 -0
  68. package/dist/client/core/fees.d.ts.map +1 -0
  69. package/dist/client/core/fees.js +178 -0
  70. package/dist/client/core/fees.js.map +1 -0
  71. package/dist/client/errors.d.ts +20 -0
  72. package/dist/client/errors.d.ts.map +1 -0
  73. package/dist/client/errors.js +31 -0
  74. package/dist/client/errors.js.map +1 -0
  75. package/dist/client/helpers.d.ts +20 -0
  76. package/dist/client/helpers.d.ts.map +1 -0
  77. package/dist/client/helpers.js +46 -0
  78. package/dist/client/helpers.js.map +1 -0
  79. package/dist/client/index.d.ts +880 -0
  80. package/dist/client/index.d.ts.map +1 -0
  81. package/dist/client/index.js +791 -0
  82. package/dist/client/index.js.map +1 -0
  83. package/dist/client/products/prices.d.ts +61 -0
  84. package/dist/client/products/prices.d.ts.map +1 -0
  85. package/dist/client/products/prices.js +92 -0
  86. package/dist/client/products/prices.js.map +1 -0
  87. package/dist/client/products/products.d.ts +65 -0
  88. package/dist/client/products/products.d.ts.map +1 -0
  89. package/dist/client/products/products.js +186 -0
  90. package/dist/client/products/products.js.map +1 -0
  91. package/dist/client/stripe-types.d.ts +44 -0
  92. package/dist/client/stripe-types.d.ts.map +1 -0
  93. package/dist/client/stripe-types.js +2 -0
  94. package/dist/client/stripe-types.js.map +1 -0
  95. package/dist/client/types/documents.d.ts +195 -0
  96. package/dist/client/types/documents.d.ts.map +1 -0
  97. package/dist/client/types/documents.js +2 -0
  98. package/dist/client/types/documents.js.map +1 -0
  99. package/dist/client/types/events.d.ts +43 -0
  100. package/dist/client/types/events.d.ts.map +1 -0
  101. package/dist/client/types/events.js +2 -0
  102. package/dist/client/types/events.js.map +1 -0
  103. package/dist/client/types/index.d.ts +5 -0
  104. package/dist/client/types/index.d.ts.map +1 -0
  105. package/dist/client/types/index.js +2 -0
  106. package/dist/client/types/index.js.map +1 -0
  107. package/dist/client/types/options.d.ts +79 -0
  108. package/dist/client/types/options.d.ts.map +1 -0
  109. package/dist/client/types/options.js +2 -0
  110. package/dist/client/types/options.js.map +1 -0
  111. package/dist/client/types/triggers.d.ts +101 -0
  112. package/dist/client/types/triggers.d.ts.map +1 -0
  113. package/dist/client/types/triggers.js +2 -0
  114. package/dist/client/types/triggers.js.map +1 -0
  115. package/dist/client/types.d.ts +2 -0
  116. package/dist/client/types.d.ts.map +1 -0
  117. package/dist/client/types.js +2 -0
  118. package/dist/client/types.js.map +1 -0
  119. package/dist/client/utils/data.d.ts +10 -0
  120. package/dist/client/utils/data.d.ts.map +1 -0
  121. package/dist/client/utils/data.js +13 -0
  122. package/dist/client/utils/data.js.map +1 -0
  123. package/dist/client/utils/owner.d.ts +22 -0
  124. package/dist/client/utils/owner.d.ts.map +1 -0
  125. package/dist/client/utils/owner.js +20 -0
  126. package/dist/client/utils/owner.js.map +1 -0
  127. package/dist/client/utils/stripeDashboardUrl.d.ts +12 -0
  128. package/dist/client/utils/stripeDashboardUrl.d.ts.map +1 -0
  129. package/dist/client/utils/stripeDashboardUrl.js +39 -0
  130. package/dist/client/utils/stripeDashboardUrl.js.map +1 -0
  131. package/dist/client/utils/webhookEndpoints.d.ts +83 -0
  132. package/dist/client/utils/webhookEndpoints.d.ts.map +1 -0
  133. package/dist/client/utils/webhookEndpoints.js +185 -0
  134. package/dist/client/utils/webhookEndpoints.js.map +1 -0
  135. package/dist/client/webhooks/handler.d.ts +4 -0
  136. package/dist/client/webhooks/handler.d.ts.map +1 -0
  137. package/dist/client/webhooks/handler.js +170 -0
  138. package/dist/client/webhooks/handler.js.map +1 -0
  139. package/dist/client/webhooks/helpers.d.ts +56 -0
  140. package/dist/client/webhooks/helpers.d.ts.map +1 -0
  141. package/dist/client/webhooks/helpers.js +229 -0
  142. package/dist/client/webhooks/helpers.js.map +1 -0
  143. package/dist/client/webhooks/hooks.d.ts +11 -0
  144. package/dist/client/webhooks/hooks.d.ts.map +1 -0
  145. package/dist/client/webhooks/hooks.js +134 -0
  146. package/dist/client/webhooks/hooks.js.map +1 -0
  147. package/dist/client/webhooks/index.d.ts +23 -0
  148. package/dist/client/webhooks/index.d.ts.map +1 -0
  149. package/dist/client/webhooks/index.js +35 -0
  150. package/dist/client/webhooks/index.js.map +1 -0
  151. package/dist/client/webhooks/processors.d.ts +4 -0
  152. package/dist/client/webhooks/processors.d.ts.map +1 -0
  153. package/dist/client/webhooks/processors.js +932 -0
  154. package/dist/client/webhooks/processors.js.map +1 -0
  155. package/dist/client/webhooks/v2.d.ts +11 -0
  156. package/dist/client/webhooks/v2.d.ts.map +1 -0
  157. package/dist/client/webhooks/v2.js +94 -0
  158. package/dist/client/webhooks/v2.js.map +1 -0
  159. package/dist/client/webhooks.d.ts +2 -0
  160. package/dist/client/webhooks.d.ts.map +1 -0
  161. package/dist/client/webhooks.js +4 -0
  162. package/dist/client/webhooks.js.map +1 -0
  163. package/dist/component/_generated/component.d.ts +1262 -0
  164. package/dist/component/_generated/component.d.ts.map +1 -0
  165. package/dist/component/_generated/component.js +11 -0
  166. package/dist/component/_generated/component.js.map +1 -0
  167. package/dist/component/_generated/dataModel.d.ts +46 -0
  168. package/dist/component/_generated/dataModel.d.ts.map +1 -0
  169. package/dist/component/_generated/dataModel.js +11 -0
  170. package/dist/component/_generated/dataModel.js.map +1 -0
  171. package/dist/component/_generated/server.d.ts +129 -0
  172. package/dist/component/_generated/server.d.ts.map +1 -0
  173. package/dist/component/_generated/server.js +79 -0
  174. package/dist/component/_generated/server.js.map +1 -0
  175. package/dist/component/billing/mutations.d.ts +86 -0
  176. package/dist/component/billing/mutations.d.ts.map +1 -0
  177. package/dist/component/billing/mutations.js +131 -0
  178. package/dist/component/billing/mutations.js.map +1 -0
  179. package/dist/component/billing/queries.d.ts +425 -0
  180. package/dist/component/billing/queries.d.ts.map +1 -0
  181. package/dist/component/billing/queries.js +304 -0
  182. package/dist/component/billing/queries.js.map +1 -0
  183. package/dist/component/billing/schema.d.ts +228 -0
  184. package/dist/component/billing/schema.d.ts.map +1 -0
  185. package/dist/component/billing/schema.js +33 -0
  186. package/dist/component/billing/schema.js.map +1 -0
  187. package/dist/component/billing/validators.d.ts +364 -0
  188. package/dist/component/billing/validators.d.ts.map +1 -0
  189. package/dist/component/billing/validators.js +98 -0
  190. package/dist/component/billing/validators.js.map +1 -0
  191. package/dist/component/connect/mutations.d.ts +182 -0
  192. package/dist/component/connect/mutations.d.ts.map +1 -0
  193. package/dist/component/connect/mutations.js +480 -0
  194. package/dist/component/connect/mutations.js.map +1 -0
  195. package/dist/component/connect/queries.d.ts +347 -0
  196. package/dist/component/connect/queries.d.ts.map +1 -0
  197. package/dist/component/connect/queries.js +449 -0
  198. package/dist/component/connect/queries.js.map +1 -0
  199. package/dist/component/connect/schema.d.ts +258 -0
  200. package/dist/component/connect/schema.d.ts.map +1 -0
  201. package/dist/component/connect/schema.js +70 -0
  202. package/dist/component/connect/schema.js.map +1 -0
  203. package/dist/component/connect/validators.d.ts +468 -0
  204. package/dist/component/connect/validators.d.ts.map +1 -0
  205. package/dist/component/connect/validators.js +250 -0
  206. package/dist/component/connect/validators.js.map +1 -0
  207. package/dist/component/convex.config.d.ts +5 -0
  208. package/dist/component/convex.config.d.ts.map +1 -0
  209. package/dist/component/convex.config.js +17 -0
  210. package/dist/component/convex.config.js.map +1 -0
  211. package/dist/component/core/mutations.d.ts +52 -0
  212. package/dist/component/core/mutations.d.ts.map +1 -0
  213. package/dist/component/core/mutations.js +153 -0
  214. package/dist/component/core/mutations.js.map +1 -0
  215. package/dist/component/core/queries.d.ts +95 -0
  216. package/dist/component/core/queries.d.ts.map +1 -0
  217. package/dist/component/core/queries.js +86 -0
  218. package/dist/component/core/queries.js.map +1 -0
  219. package/dist/component/core/schema.d.ts +41 -0
  220. package/dist/component/core/schema.d.ts.map +1 -0
  221. package/dist/component/core/schema.js +12 -0
  222. package/dist/component/core/schema.js.map +1 -0
  223. package/dist/component/core/validators.d.ts +65 -0
  224. package/dist/component/core/validators.d.ts.map +1 -0
  225. package/dist/component/core/validators.js +35 -0
  226. package/dist/component/core/validators.js.map +1 -0
  227. package/dist/component/lib/fees.d.ts +74 -0
  228. package/dist/component/lib/fees.d.ts.map +1 -0
  229. package/dist/component/lib/fees.js +51 -0
  230. package/dist/component/lib/fees.js.map +1 -0
  231. package/dist/component/lib/idempotency.d.ts +9 -0
  232. package/dist/component/lib/idempotency.d.ts.map +1 -0
  233. package/dist/component/lib/idempotency.js +18 -0
  234. package/dist/component/lib/idempotency.js.map +1 -0
  235. package/dist/component/lib/reversals.d.ts +48 -0
  236. package/dist/component/lib/reversals.d.ts.map +1 -0
  237. package/dist/component/lib/reversals.js +79 -0
  238. package/dist/component/lib/reversals.js.map +1 -0
  239. package/dist/component/lib/stripeFactory.d.ts +7 -0
  240. package/dist/component/lib/stripeFactory.d.ts.map +1 -0
  241. package/dist/component/lib/stripeFactory.js +28 -0
  242. package/dist/component/lib/stripeFactory.js.map +1 -0
  243. package/dist/component/products/mutations.d.ts +22 -0
  244. package/dist/component/products/mutations.d.ts.map +1 -0
  245. package/dist/component/products/mutations.js +63 -0
  246. package/dist/component/products/mutations.js.map +1 -0
  247. package/dist/component/products/queries.d.ts +109 -0
  248. package/dist/component/products/queries.d.ts.map +1 -0
  249. package/dist/component/products/queries.js +122 -0
  250. package/dist/component/products/queries.js.map +1 -0
  251. package/dist/component/products/schema.d.ts +58 -0
  252. package/dist/component/products/schema.d.ts.map +1 -0
  253. package/dist/component/products/schema.js +20 -0
  254. package/dist/component/products/schema.js.map +1 -0
  255. package/dist/component/products/validators.d.ts +86 -0
  256. package/dist/component/products/validators.d.ts.map +1 -0
  257. package/dist/component/products/validators.js +47 -0
  258. package/dist/component/products/validators.js.map +1 -0
  259. package/dist/component/schema.d.ts +555 -0
  260. package/dist/component/schema.d.ts.map +1 -0
  261. package/dist/component/schema.js +28 -0
  262. package/dist/component/schema.js.map +1 -0
  263. package/dist/component/webhooks/mutations.d.ts +30 -0
  264. package/dist/component/webhooks/mutations.d.ts.map +1 -0
  265. package/dist/component/webhooks/mutations.js +124 -0
  266. package/dist/component/webhooks/mutations.js.map +1 -0
  267. package/dist/component/webhooks/queries.d.ts +35 -0
  268. package/dist/component/webhooks/queries.d.ts.map +1 -0
  269. package/dist/component/webhooks/queries.js +41 -0
  270. package/dist/component/webhooks/queries.js.map +1 -0
  271. package/dist/component/webhooks/schema.d.ts +22 -0
  272. package/dist/component/webhooks/schema.d.ts.map +1 -0
  273. package/dist/component/webhooks/schema.js +9 -0
  274. package/dist/component/webhooks/schema.js.map +1 -0
  275. package/dist/component/webhooks/validators.d.ts +37 -0
  276. package/dist/component/webhooks/validators.d.ts.map +1 -0
  277. package/dist/component/webhooks/validators.js +22 -0
  278. package/dist/component/webhooks/validators.js.map +1 -0
  279. package/dist/react/components/AccountCloseButton.d.ts +42 -0
  280. package/dist/react/components/AccountCloseButton.d.ts.map +1 -0
  281. package/dist/react/components/AccountCloseButton.js +33 -0
  282. package/dist/react/components/AccountCloseButton.js.map +1 -0
  283. package/dist/react/components/AccountCloseCard.d.ts +31 -0
  284. package/dist/react/components/AccountCloseCard.d.ts.map +1 -0
  285. package/dist/react/components/AccountCloseCard.js +22 -0
  286. package/dist/react/components/AccountCloseCard.js.map +1 -0
  287. package/dist/react/components/AccountCreateButton.d.ts +37 -0
  288. package/dist/react/components/AccountCreateButton.d.ts.map +1 -0
  289. package/dist/react/components/AccountCreateButton.js +30 -0
  290. package/dist/react/components/AccountCreateButton.js.map +1 -0
  291. package/dist/react/components/AccountCreateCard.d.ts +48 -0
  292. package/dist/react/components/AccountCreateCard.d.ts.map +1 -0
  293. package/dist/react/components/AccountCreateCard.js +29 -0
  294. package/dist/react/components/AccountCreateCard.js.map +1 -0
  295. package/dist/react/components/AccountLoginButton.d.ts +31 -0
  296. package/dist/react/components/AccountLoginButton.d.ts.map +1 -0
  297. package/dist/react/components/AccountLoginButton.js +31 -0
  298. package/dist/react/components/AccountLoginButton.js.map +1 -0
  299. package/dist/react/components/AccountLoginCard.d.ts +33 -0
  300. package/dist/react/components/AccountLoginCard.d.ts.map +1 -0
  301. package/dist/react/components/AccountLoginCard.js +19 -0
  302. package/dist/react/components/AccountLoginCard.js.map +1 -0
  303. package/dist/react/components/AccountOnboardingButton.d.ts +37 -0
  304. package/dist/react/components/AccountOnboardingButton.d.ts.map +1 -0
  305. package/dist/react/components/AccountOnboardingButton.js +30 -0
  306. package/dist/react/components/AccountOnboardingButton.js.map +1 -0
  307. package/dist/react/components/AccountOnboardingCard.d.ts +56 -0
  308. package/dist/react/components/AccountOnboardingCard.d.ts.map +1 -0
  309. package/dist/react/components/AccountOnboardingCard.js +36 -0
  310. package/dist/react/components/AccountOnboardingCard.js.map +1 -0
  311. package/dist/react/components/AddCardForm.d.ts +18 -0
  312. package/dist/react/components/AddCardForm.d.ts.map +1 -0
  313. package/dist/react/components/AddCardForm.js +49 -0
  314. package/dist/react/components/AddCardForm.js.map +1 -0
  315. package/dist/react/components/BillingPortalLink.d.ts +23 -0
  316. package/dist/react/components/BillingPortalLink.d.ts.map +1 -0
  317. package/dist/react/components/BillingPortalLink.js +55 -0
  318. package/dist/react/components/BillingPortalLink.js.map +1 -0
  319. package/dist/react/components/BuyerBillingView.d.ts +80 -0
  320. package/dist/react/components/BuyerBillingView.d.ts.map +1 -0
  321. package/dist/react/components/BuyerBillingView.js +44 -0
  322. package/dist/react/components/BuyerBillingView.js.map +1 -0
  323. package/dist/react/components/CheckoutSessionProvider.d.ts +34 -0
  324. package/dist/react/components/CheckoutSessionProvider.d.ts.map +1 -0
  325. package/dist/react/components/CheckoutSessionProvider.js +38 -0
  326. package/dist/react/components/CheckoutSessionProvider.js.map +1 -0
  327. package/dist/react/components/CheckoutSessionProviderWithKey.d.ts +36 -0
  328. package/dist/react/components/CheckoutSessionProviderWithKey.d.ts.map +1 -0
  329. package/dist/react/components/CheckoutSessionProviderWithKey.js +36 -0
  330. package/dist/react/components/CheckoutSessionProviderWithKey.js.map +1 -0
  331. package/dist/react/components/CheckoutStatus.d.ts +25 -0
  332. package/dist/react/components/CheckoutStatus.d.ts.map +1 -0
  333. package/dist/react/components/CheckoutStatus.js +22 -0
  334. package/dist/react/components/CheckoutStatus.js.map +1 -0
  335. package/dist/react/components/ConnectProvider.d.ts +29 -0
  336. package/dist/react/components/ConnectProvider.d.ts.map +1 -0
  337. package/dist/react/components/ConnectProvider.js +25 -0
  338. package/dist/react/components/ConnectProvider.js.map +1 -0
  339. package/dist/react/components/ConnectRequirements.d.ts +55 -0
  340. package/dist/react/components/ConnectRequirements.d.ts.map +1 -0
  341. package/dist/react/components/ConnectRequirements.js +58 -0
  342. package/dist/react/components/ConnectRequirements.js.map +1 -0
  343. package/dist/react/components/ConnectStatusBadge.d.ts +26 -0
  344. package/dist/react/components/ConnectStatusBadge.d.ts.map +1 -0
  345. package/dist/react/components/ConnectStatusBadge.js +20 -0
  346. package/dist/react/components/ConnectStatusBadge.js.map +1 -0
  347. package/dist/react/components/DeletePaymentMethodDialog.d.ts +25 -0
  348. package/dist/react/components/DeletePaymentMethodDialog.d.ts.map +1 -0
  349. package/dist/react/components/DeletePaymentMethodDialog.js +16 -0
  350. package/dist/react/components/DeletePaymentMethodDialog.js.map +1 -0
  351. package/dist/react/components/DisputeDetail.d.ts +42 -0
  352. package/dist/react/components/DisputeDetail.d.ts.map +1 -0
  353. package/dist/react/components/DisputeDetail.js +34 -0
  354. package/dist/react/components/DisputeDetail.js.map +1 -0
  355. package/dist/react/components/DisputesList.d.ts +42 -0
  356. package/dist/react/components/DisputesList.d.ts.map +1 -0
  357. package/dist/react/components/DisputesList.js +47 -0
  358. package/dist/react/components/DisputesList.js.map +1 -0
  359. package/dist/react/components/EarningsSummary.d.ts +53 -0
  360. package/dist/react/components/EarningsSummary.d.ts.map +1 -0
  361. package/dist/react/components/EarningsSummary.js +37 -0
  362. package/dist/react/components/EarningsSummary.js.map +1 -0
  363. package/dist/react/components/EmbeddedCheckout.d.ts +18 -0
  364. package/dist/react/components/EmbeddedCheckout.d.ts.map +1 -0
  365. package/dist/react/components/EmbeddedCheckout.js +17 -0
  366. package/dist/react/components/EmbeddedCheckout.js.map +1 -0
  367. package/dist/react/components/EmbeddedDisputes.d.ts +21 -0
  368. package/dist/react/components/EmbeddedDisputes.d.ts.map +1 -0
  369. package/dist/react/components/EmbeddedDisputes.js +17 -0
  370. package/dist/react/components/EmbeddedDisputes.js.map +1 -0
  371. package/dist/react/components/EvidenceForm.d.ts +63 -0
  372. package/dist/react/components/EvidenceForm.d.ts.map +1 -0
  373. package/dist/react/components/EvidenceForm.js +79 -0
  374. package/dist/react/components/EvidenceForm.js.map +1 -0
  375. package/dist/react/components/IntervalSelector.d.ts +20 -0
  376. package/dist/react/components/IntervalSelector.d.ts.map +1 -0
  377. package/dist/react/components/IntervalSelector.js +15 -0
  378. package/dist/react/components/IntervalSelector.js.map +1 -0
  379. package/dist/react/components/PaymentMethodActions.d.ts +27 -0
  380. package/dist/react/components/PaymentMethodActions.d.ts.map +1 -0
  381. package/dist/react/components/PaymentMethodActions.js +23 -0
  382. package/dist/react/components/PaymentMethodActions.js.map +1 -0
  383. package/dist/react/components/PaymentMethodsList.d.ts +32 -0
  384. package/dist/react/components/PaymentMethodsList.d.ts.map +1 -0
  385. package/dist/react/components/PaymentMethodsList.js +18 -0
  386. package/dist/react/components/PaymentMethodsList.js.map +1 -0
  387. package/dist/react/components/PayoutSchedule.d.ts +55 -0
  388. package/dist/react/components/PayoutSchedule.d.ts.map +1 -0
  389. package/dist/react/components/PayoutSchedule.js +51 -0
  390. package/dist/react/components/PayoutSchedule.js.map +1 -0
  391. package/dist/react/components/PriceBadge.d.ts +19 -0
  392. package/dist/react/components/PriceBadge.d.ts.map +1 -0
  393. package/dist/react/components/PriceBadge.js +25 -0
  394. package/dist/react/components/PriceBadge.js.map +1 -0
  395. package/dist/react/components/PriceCard.d.ts +34 -0
  396. package/dist/react/components/PriceCard.d.ts.map +1 -0
  397. package/dist/react/components/PriceCard.js +20 -0
  398. package/dist/react/components/PriceCard.js.map +1 -0
  399. package/dist/react/components/PricePicker.d.ts +28 -0
  400. package/dist/react/components/PricePicker.d.ts.map +1 -0
  401. package/dist/react/components/PricePicker.js +32 -0
  402. package/dist/react/components/PricePicker.js.map +1 -0
  403. package/dist/react/components/SplitBreakdown.d.ts +45 -0
  404. package/dist/react/components/SplitBreakdown.d.ts.map +1 -0
  405. package/dist/react/components/SplitBreakdown.js +48 -0
  406. package/dist/react/components/SplitBreakdown.js.map +1 -0
  407. package/dist/react/components/StripeProvider.d.ts +30 -0
  408. package/dist/react/components/StripeProvider.d.ts.map +1 -0
  409. package/dist/react/components/StripeProvider.js +38 -0
  410. package/dist/react/components/StripeProvider.js.map +1 -0
  411. package/dist/react/components/StripeProviderWithKey.d.ts +33 -0
  412. package/dist/react/components/StripeProviderWithKey.d.ts.map +1 -0
  413. package/dist/react/components/StripeProviderWithKey.js +44 -0
  414. package/dist/react/components/StripeProviderWithKey.js.map +1 -0
  415. package/dist/react/components/SubscriptionActions.d.ts +31 -0
  416. package/dist/react/components/SubscriptionActions.d.ts.map +1 -0
  417. package/dist/react/components/SubscriptionActions.js +30 -0
  418. package/dist/react/components/SubscriptionActions.js.map +1 -0
  419. package/dist/react/components/SubscriptionCard.d.ts +41 -0
  420. package/dist/react/components/SubscriptionCard.d.ts.map +1 -0
  421. package/dist/react/components/SubscriptionCard.js +18 -0
  422. package/dist/react/components/SubscriptionCard.js.map +1 -0
  423. package/dist/react/components/SubscriptionLineItems.d.ts +23 -0
  424. package/dist/react/components/SubscriptionLineItems.d.ts.map +1 -0
  425. package/dist/react/components/SubscriptionLineItems.js +20 -0
  426. package/dist/react/components/SubscriptionLineItems.js.map +1 -0
  427. package/dist/react/components/TrialAlert.d.ts +19 -0
  428. package/dist/react/components/TrialAlert.d.ts.map +1 -0
  429. package/dist/react/components/TrialAlert.js +16 -0
  430. package/dist/react/components/TrialAlert.js.map +1 -0
  431. package/dist/react/hooks/useAccount.d.ts +14 -0
  432. package/dist/react/hooks/useAccount.d.ts.map +1 -0
  433. package/dist/react/hooks/useAccount.js +18 -0
  434. package/dist/react/hooks/useAccount.js.map +1 -0
  435. package/dist/react/hooks/useAccountOnboarding.d.ts +15 -0
  436. package/dist/react/hooks/useAccountOnboarding.d.ts.map +1 -0
  437. package/dist/react/hooks/useAccountOnboarding.js +19 -0
  438. package/dist/react/hooks/useAccountOnboarding.js.map +1 -0
  439. package/dist/react/hooks/useCheckout.d.ts +14 -0
  440. package/dist/react/hooks/useCheckout.d.ts.map +1 -0
  441. package/dist/react/hooks/useCheckout.js +18 -0
  442. package/dist/react/hooks/useCheckout.js.map +1 -0
  443. package/dist/react/hooks/useCheckoutSession.d.ts +62 -0
  444. package/dist/react/hooks/useCheckoutSession.d.ts.map +1 -0
  445. package/dist/react/hooks/useCheckoutSession.js +68 -0
  446. package/dist/react/hooks/useCheckoutSession.js.map +1 -0
  447. package/dist/react/hooks/useConfirmPayment.d.ts +38 -0
  448. package/dist/react/hooks/useConfirmPayment.d.ts.map +1 -0
  449. package/dist/react/hooks/useConfirmPayment.js +91 -0
  450. package/dist/react/hooks/useConfirmPayment.js.map +1 -0
  451. package/dist/react/hooks/useDisputeWithCountdown.d.ts +25 -0
  452. package/dist/react/hooks/useDisputeWithCountdown.d.ts.map +1 -0
  453. package/dist/react/hooks/useDisputeWithCountdown.js +19 -0
  454. package/dist/react/hooks/useDisputeWithCountdown.js.map +1 -0
  455. package/dist/react/hooks/useDisputes.d.ts +14 -0
  456. package/dist/react/hooks/useDisputes.d.ts.map +1 -0
  457. package/dist/react/hooks/useDisputes.js +15 -0
  458. package/dist/react/hooks/useDisputes.js.map +1 -0
  459. package/dist/react/hooks/useEarnings.d.ts +92 -0
  460. package/dist/react/hooks/useEarnings.d.ts.map +1 -0
  461. package/dist/react/hooks/useEarnings.js +35 -0
  462. package/dist/react/hooks/useEarnings.js.map +1 -0
  463. package/dist/react/hooks/useInvoices.d.ts +11 -0
  464. package/dist/react/hooks/useInvoices.d.ts.map +1 -0
  465. package/dist/react/hooks/useInvoices.js +11 -0
  466. package/dist/react/hooks/useInvoices.js.map +1 -0
  467. package/dist/react/hooks/usePaymentMethodActions.d.ts +74 -0
  468. package/dist/react/hooks/usePaymentMethodActions.d.ts.map +1 -0
  469. package/dist/react/hooks/usePaymentMethodActions.js +156 -0
  470. package/dist/react/hooks/usePaymentMethodActions.js.map +1 -0
  471. package/dist/react/hooks/usePaymentMethods.d.ts +23 -0
  472. package/dist/react/hooks/usePaymentMethods.d.ts.map +1 -0
  473. package/dist/react/hooks/usePaymentMethods.js +18 -0
  474. package/dist/react/hooks/usePaymentMethods.js.map +1 -0
  475. package/dist/react/hooks/usePrices.d.ts +12 -0
  476. package/dist/react/hooks/usePrices.d.ts.map +1 -0
  477. package/dist/react/hooks/usePrices.js +16 -0
  478. package/dist/react/hooks/usePrices.js.map +1 -0
  479. package/dist/react/hooks/useProducts.d.ts +10 -0
  480. package/dist/react/hooks/useProducts.d.ts.map +1 -0
  481. package/dist/react/hooks/useProducts.js +11 -0
  482. package/dist/react/hooks/useProducts.js.map +1 -0
  483. package/dist/react/hooks/useSplitBreakdown.d.ts +58 -0
  484. package/dist/react/hooks/useSplitBreakdown.d.ts.map +1 -0
  485. package/dist/react/hooks/useSplitBreakdown.js +59 -0
  486. package/dist/react/hooks/useSplitBreakdown.js.map +1 -0
  487. package/dist/react/hooks/useStripeConfig.d.ts +14 -0
  488. package/dist/react/hooks/useStripeConfig.d.ts.map +1 -0
  489. package/dist/react/hooks/useStripeConfig.js +21 -0
  490. package/dist/react/hooks/useStripeConfig.js.map +1 -0
  491. package/dist/react/hooks/useStripeMode.d.ts +3 -0
  492. package/dist/react/hooks/useStripeMode.d.ts.map +1 -0
  493. package/dist/react/hooks/useStripeMode.js +6 -0
  494. package/dist/react/hooks/useStripeMode.js.map +1 -0
  495. package/dist/react/hooks/useStripePublishableKey.d.ts +2 -0
  496. package/dist/react/hooks/useStripePublishableKey.d.ts.map +1 -0
  497. package/dist/react/hooks/useStripePublishableKey.js +6 -0
  498. package/dist/react/hooks/useStripePublishableKey.js.map +1 -0
  499. package/dist/react/hooks/useSubscription.d.ts +17 -0
  500. package/dist/react/hooks/useSubscription.d.ts.map +1 -0
  501. package/dist/react/hooks/useSubscription.js +30 -0
  502. package/dist/react/hooks/useSubscription.js.map +1 -0
  503. package/dist/react/hooks/useSubscriptions.d.ts +11 -0
  504. package/dist/react/hooks/useSubscriptions.d.ts.map +1 -0
  505. package/dist/react/hooks/useSubscriptions.js +13 -0
  506. package/dist/react/hooks/useSubscriptions.js.map +1 -0
  507. package/dist/react/index.d.ts +108 -0
  508. package/dist/react/index.d.ts.map +1 -0
  509. package/dist/react/index.js +87 -0
  510. package/dist/react/index.js.map +1 -0
  511. package/dist/react/lib/connect-requirement-keys.d.ts +14 -0
  512. package/dist/react/lib/connect-requirement-keys.d.ts.map +1 -0
  513. package/dist/react/lib/connect-requirement-keys.js +57 -0
  514. package/dist/react/lib/connect-requirement-keys.js.map +1 -0
  515. package/dist/react/lib/price-helpers.d.ts +31 -0
  516. package/dist/react/lib/price-helpers.d.ts.map +1 -0
  517. package/dist/react/lib/price-helpers.js +46 -0
  518. package/dist/react/lib/price-helpers.js.map +1 -0
  519. package/dist/react/lib/stripe-element-styles.d.ts +91 -0
  520. package/dist/react/lib/stripe-element-styles.d.ts.map +1 -0
  521. package/dist/react/lib/stripe-element-styles.js +131 -0
  522. package/dist/react/lib/stripe-element-styles.js.map +1 -0
  523. package/dist/react/lib/subscription-helpers.d.ts +33 -0
  524. package/dist/react/lib/subscription-helpers.d.ts.map +1 -0
  525. package/dist/react/lib/subscription-helpers.js +47 -0
  526. package/dist/react/lib/subscription-helpers.js.map +1 -0
  527. package/dist/react/types.d.ts +20 -0
  528. package/dist/react/types.d.ts.map +1 -0
  529. package/dist/react/types.js +2 -0
  530. package/dist/react/types.js.map +1 -0
  531. package/dist/testing/assert-test-env.d.ts +6 -0
  532. package/dist/testing/assert-test-env.d.ts.map +1 -0
  533. package/dist/testing/assert-test-env.js +15 -0
  534. package/dist/testing/assert-test-env.js.map +1 -0
  535. package/dist/testing/fixtures.d.ts +38 -0
  536. package/dist/testing/fixtures.d.ts.map +1 -0
  537. package/dist/testing/fixtures.js +54 -0
  538. package/dist/testing/fixtures.js.map +1 -0
  539. package/dist/testing/index.d.ts +4 -0
  540. package/dist/testing/index.d.ts.map +1 -0
  541. package/dist/testing/index.js +4 -0
  542. package/dist/testing/index.js.map +1 -0
  543. package/dist/testing/mock-webhooks.d.ts +19 -0
  544. package/dist/testing/mock-webhooks.d.ts.map +1 -0
  545. package/dist/testing/mock-webhooks.js +81 -0
  546. package/dist/testing/mock-webhooks.js.map +1 -0
  547. package/package.json +131 -0
  548. package/src/client/billing/checkout.test.ts +1234 -0
  549. package/src/client/billing/checkout.ts +416 -0
  550. package/src/client/billing/invoices.test.ts +237 -0
  551. package/src/client/billing/invoices.ts +93 -0
  552. package/src/client/billing/subscriptions.test.ts +987 -0
  553. package/src/client/billing/subscriptions.ts +604 -0
  554. package/src/client/component-api-types.test.ts +137 -0
  555. package/src/client/connect/disputes.test.ts +487 -0
  556. package/src/client/connect/disputes.ts +302 -0
  557. package/src/client/connect/paymentMethodUtils.test.ts +83 -0
  558. package/src/client/connect/paymentMethodUtils.ts +28 -0
  559. package/src/client/connect/paymentMethods.test.ts +66 -0
  560. package/src/client/connect/paymentMethods.ts +55 -0
  561. package/src/client/connect/payouts.test.ts +132 -0
  562. package/src/client/connect/payouts.ts +105 -0
  563. package/src/client/connect/refundActor.test.ts +121 -0
  564. package/src/client/connect/refundActor.ts +60 -0
  565. package/src/client/connect/refunds.test.ts +341 -0
  566. package/src/client/connect/refunds.ts +256 -0
  567. package/src/client/connect/transfers.test.ts +492 -0
  568. package/src/client/connect/transfers.ts +572 -0
  569. package/src/client/constants.ts +15 -0
  570. package/src/client/core/accountLinks.test.ts +378 -0
  571. package/src/client/core/accountLinks.ts +211 -0
  572. package/src/client/core/accountStatus.test.ts +102 -0
  573. package/src/client/core/accountStatus.ts +91 -0
  574. package/src/client/core/accounts.test.ts +1496 -0
  575. package/src/client/core/accounts.ts +667 -0
  576. package/src/client/core/config.test.ts +68 -0
  577. package/src/client/core/config.ts +27 -0
  578. package/src/client/core/descriptors.test.ts +68 -0
  579. package/src/client/core/descriptors.ts +46 -0
  580. package/src/client/core/fees.test.ts +377 -0
  581. package/src/client/core/fees.ts +268 -0
  582. package/src/client/errors.test.ts +66 -0
  583. package/src/client/errors.ts +70 -0
  584. package/src/client/helpers.test.ts +74 -0
  585. package/src/client/helpers.ts +94 -0
  586. package/src/client/index.test.ts +1848 -0
  587. package/src/client/index.ts +1872 -0
  588. package/src/client/products/prices.test.ts +345 -0
  589. package/src/client/products/prices.ts +194 -0
  590. package/src/client/products/products.test.ts +476 -0
  591. package/src/client/products/products.ts +335 -0
  592. package/src/client/setup.test.ts +47 -0
  593. package/src/client/stripe-types.ts +108 -0
  594. package/src/client/types/documents.ts +245 -0
  595. package/src/client/types/events.ts +72 -0
  596. package/src/client/types/index.ts +43 -0
  597. package/src/client/types/options.ts +103 -0
  598. package/src/client/types/triggers.ts +293 -0
  599. package/src/client/types.ts +35 -0
  600. package/src/client/utils/data.test.ts +59 -0
  601. package/src/client/utils/data.ts +22 -0
  602. package/src/client/utils/owner.test.ts +35 -0
  603. package/src/client/utils/owner.ts +27 -0
  604. package/src/client/utils/stripeDashboardUrl.test.ts +71 -0
  605. package/src/client/utils/stripeDashboardUrl.ts +71 -0
  606. package/src/client/utils/webhookEndpoints.test.ts +454 -0
  607. package/src/client/utils/webhookEndpoints.ts +271 -0
  608. package/src/client/webhook-handlers.test.ts +603 -0
  609. package/src/client/webhooks/handler.test.ts +604 -0
  610. package/src/client/webhooks/handler.ts +256 -0
  611. package/src/client/webhooks/helpers.test.ts +330 -0
  612. package/src/client/webhooks/helpers.ts +277 -0
  613. package/src/client/webhooks/hooks.test.ts +111 -0
  614. package/src/client/webhooks/hooks.ts +177 -0
  615. package/src/client/webhooks/index.ts +51 -0
  616. package/src/client/webhooks/processors.test.ts +2392 -0
  617. package/src/client/webhooks/processors.ts +1166 -0
  618. package/src/client/webhooks/v2.test.ts +396 -0
  619. package/src/client/webhooks/v2.ts +124 -0
  620. package/src/client/webhooks.test.ts +1689 -0
  621. package/src/client/webhooks.ts +3 -0
  622. package/src/component/_generated/api.ts +86 -0
  623. package/src/component/_generated/component.ts +1758 -0
  624. package/src/component/_generated/dataModel.ts +60 -0
  625. package/src/component/_generated/server.ts +164 -0
  626. package/src/component/billing/mutations.ts +155 -0
  627. package/src/component/billing/queries.ts +378 -0
  628. package/src/component/billing/schema.ts +40 -0
  629. package/src/component/billing/validators.ts +137 -0
  630. package/src/component/config-queries.test.ts +47 -0
  631. package/src/component/connect/mutations.ts +624 -0
  632. package/src/component/connect/queries.ts +537 -0
  633. package/src/component/connect/schema.ts +90 -0
  634. package/src/component/connect/validators.ts +333 -0
  635. package/src/component/connect.test.ts +721 -0
  636. package/src/component/convex.config.ts +17 -0
  637. package/src/component/core/mutations.ts +182 -0
  638. package/src/component/core/queries.ts +100 -0
  639. package/src/component/core/schema.ts +13 -0
  640. package/src/component/core/validators.ts +55 -0
  641. package/src/component/earnings-totals.test.ts +196 -0
  642. package/src/component/fee-routing.test.ts +124 -0
  643. package/src/component/lib/fees.ts +64 -0
  644. package/src/component/lib/idempotency.test.ts +37 -0
  645. package/src/component/lib/idempotency.ts +20 -0
  646. package/src/component/lib/reversals.ts +113 -0
  647. package/src/component/lib/stripeFactory.ts +30 -0
  648. package/src/component/products/mutations.ts +73 -0
  649. package/src/component/products/queries.ts +149 -0
  650. package/src/component/products/schema.ts +22 -0
  651. package/src/component/products/validators.ts +63 -0
  652. package/src/component/public.test.ts +1858 -0
  653. package/src/component/reversal-races.test.ts +920 -0
  654. package/src/component/schema.ts +45 -0
  655. package/src/component/subscription-scoping.test.ts +118 -0
  656. package/src/component/transfers.test.ts +402 -0
  657. package/src/component/triggers.test.ts +359 -0
  658. package/src/component/webhooks/mutations.ts +151 -0
  659. package/src/component/webhooks/queries.ts +44 -0
  660. package/src/component/webhooks/schema.ts +10 -0
  661. package/src/component/webhooks/validators.ts +30 -0
  662. package/src/react/components/AccountCloseButton.tsx +91 -0
  663. package/src/react/components/AccountCloseCard.tsx +84 -0
  664. package/src/react/components/AccountCreateButton.tsx +83 -0
  665. package/src/react/components/AccountCreateCard.tsx +123 -0
  666. package/src/react/components/AccountLoginButton.tsx +69 -0
  667. package/src/react/components/AccountLoginCard.tsx +99 -0
  668. package/src/react/components/AccountOnboardingButton.tsx +83 -0
  669. package/src/react/components/AccountOnboardingCard.test.ts +27 -0
  670. package/src/react/components/AccountOnboardingCard.tsx +152 -0
  671. package/src/react/components/AddCardForm.tsx +80 -0
  672. package/src/react/components/BillingPortalLink.tsx +93 -0
  673. package/src/react/components/BuyerBillingView.render.test.tsx +207 -0
  674. package/src/react/components/BuyerBillingView.tsx +193 -0
  675. package/src/react/components/CheckoutSessionProvider.tsx +70 -0
  676. package/src/react/components/CheckoutSessionProviderWithKey.tsx +99 -0
  677. package/src/react/components/CheckoutStatus.tsx +71 -0
  678. package/src/react/components/ConnectProvider.tsx +58 -0
  679. package/src/react/components/ConnectRequirements.tsx +159 -0
  680. package/src/react/components/ConnectStatusBadge.tsx +60 -0
  681. package/src/react/components/DeletePaymentMethodDialog.tsx +61 -0
  682. package/src/react/components/DisputeDetail.render.test.tsx +143 -0
  683. package/src/react/components/DisputeDetail.tsx +111 -0
  684. package/src/react/components/DisputesList.render.test.tsx +244 -0
  685. package/src/react/components/DisputesList.tsx +120 -0
  686. package/src/react/components/EarningsSummary.render.test.tsx +153 -0
  687. package/src/react/components/EarningsSummary.tsx +131 -0
  688. package/src/react/components/EmbeddedCheckout.test.ts +25 -0
  689. package/src/react/components/EmbeddedCheckout.tsx +54 -0
  690. package/src/react/components/EmbeddedDisputes.render.test.tsx +142 -0
  691. package/src/react/components/EmbeddedDisputes.tsx +38 -0
  692. package/src/react/components/EvidenceForm.render.test.tsx +215 -0
  693. package/src/react/components/EvidenceForm.tsx +176 -0
  694. package/src/react/components/IntervalSelector.tsx +58 -0
  695. package/src/react/components/PaymentMethodActions.tsx +68 -0
  696. package/src/react/components/PaymentMethodsList.tsx +81 -0
  697. package/src/react/components/PayoutSchedule.render.test.tsx +178 -0
  698. package/src/react/components/PayoutSchedule.tsx +148 -0
  699. package/src/react/components/PriceBadge.render.test.tsx +134 -0
  700. package/src/react/components/PriceBadge.tsx +49 -0
  701. package/src/react/components/PriceCard.render.test.tsx +135 -0
  702. package/src/react/components/PriceCard.tsx +83 -0
  703. package/src/react/components/PricePicker.tsx +95 -0
  704. package/src/react/components/SplitBreakdown.render.test.tsx +168 -0
  705. package/src/react/components/SplitBreakdown.tsx +121 -0
  706. package/src/react/components/StripeProvider.test.ts +45 -0
  707. package/src/react/components/StripeProvider.tsx +80 -0
  708. package/src/react/components/StripeProviderWithKey.tsx +95 -0
  709. package/src/react/components/SubscriptionActions.tsx +79 -0
  710. package/src/react/components/SubscriptionCard.tsx +92 -0
  711. package/src/react/components/SubscriptionLineItems.tsx +62 -0
  712. package/src/react/components/TrialAlert.render.test.tsx +132 -0
  713. package/src/react/components/TrialAlert.tsx +44 -0
  714. package/src/react/hooks/skipSentinel.test.ts +85 -0
  715. package/src/react/hooks/useAccount.ts +28 -0
  716. package/src/react/hooks/useAccountOnboarding.test.ts +75 -0
  717. package/src/react/hooks/useAccountOnboarding.ts +35 -0
  718. package/src/react/hooks/useCheckout.ts +33 -0
  719. package/src/react/hooks/useCheckoutSession.ts +110 -0
  720. package/src/react/hooks/useConfirmPayment.ts +117 -0
  721. package/src/react/hooks/useDisputeWithCountdown.test.ts +90 -0
  722. package/src/react/hooks/useDisputeWithCountdown.ts +48 -0
  723. package/src/react/hooks/useDisputes.test.ts +75 -0
  724. package/src/react/hooks/useDisputes.ts +28 -0
  725. package/src/react/hooks/useEarnings.test.ts +159 -0
  726. package/src/react/hooks/useEarnings.ts +132 -0
  727. package/src/react/hooks/useInvoices.test.ts +79 -0
  728. package/src/react/hooks/useInvoices.ts +25 -0
  729. package/src/react/hooks/usePaymentMethodActions.ts +206 -0
  730. package/src/react/hooks/usePaymentMethods.ts +44 -0
  731. package/src/react/hooks/usePrices.ts +26 -0
  732. package/src/react/hooks/useProducts.test.ts +75 -0
  733. package/src/react/hooks/useProducts.ts +24 -0
  734. package/src/react/hooks/useSplitBreakdown.test.ts +151 -0
  735. package/src/react/hooks/useSplitBreakdown.ts +118 -0
  736. package/src/react/hooks/useStripeConfig.ts +31 -0
  737. package/src/react/hooks/useStripeMode.test.ts +49 -0
  738. package/src/react/hooks/useStripeMode.ts +9 -0
  739. package/src/react/hooks/useStripePublishableKey.test.ts +35 -0
  740. package/src/react/hooks/useStripePublishableKey.ts +9 -0
  741. package/src/react/hooks/useSubscription.ts +52 -0
  742. package/src/react/hooks/useSubscriptions.ts +33 -0
  743. package/src/react/index.payment-element.test.ts +41 -0
  744. package/src/react/index.test.ts +167 -0
  745. package/src/react/index.ts +279 -0
  746. package/src/react/lib/connect-requirement-keys.test.ts +73 -0
  747. package/src/react/lib/connect-requirement-keys.ts +66 -0
  748. package/src/react/lib/price-helpers.test.ts +199 -0
  749. package/src/react/lib/price-helpers.ts +68 -0
  750. package/src/react/lib/stripe-element-styles.test.ts +94 -0
  751. package/src/react/lib/stripe-element-styles.ts +178 -0
  752. package/src/react/lib/subscription-helpers.test.ts +127 -0
  753. package/src/react/lib/subscription-helpers.ts +64 -0
  754. package/src/react/types.ts +32 -0
  755. package/src/test.ts +5 -0
  756. package/src/testing/assert-test-env.test.ts +33 -0
  757. package/src/testing/assert-test-env.ts +20 -0
  758. package/src/testing/fixtures.ts +95 -0
  759. package/src/testing/index.ts +13 -0
  760. package/src/testing/mock-webhooks.test.ts +97 -0
  761. package/src/testing/mock-webhooks.ts +101 -0
  762. package/src/vite-env.d.ts +4 -0
@@ -0,0 +1,987 @@
1
+ /**
2
+ * Tests for the subscription methods. The interesting logic lives in the
3
+ * Stripe-mutating helpers — `cancelSubscription`'s cancel-now vs
4
+ * cancel-at-period-end branch, `updateSubscriptionQuantity`'s retrieve +
5
+ * no-items guard, and `syncAllSubscriptions`' per-record metadata extraction,
6
+ * customer-id normalisation, trial derivation, and error accumulation. The
7
+ * remaining functions are thin component query/mutation delegators verified
8
+ * for the exact ref + args they forward and the shape they return.
9
+ */
10
+ import { describe, expect, it, vi } from "vitest";
11
+
12
+ import type { Component, RunCtx } from "../helpers.js";
13
+ import {
14
+ cancelSubscription,
15
+ createSubscription,
16
+ getActiveSubscription,
17
+ groupSubscriptionsByStore,
18
+ getSubscription,
19
+ getSubscriptionByStripeId,
20
+ getTrialStatus,
21
+ listStripeSubscriptions,
22
+ listSubscriptions,
23
+ listSubscriptionsByOrg,
24
+ listSubscriptionsByUser,
25
+ reactivateSubscription,
26
+ syncAllSubscriptions,
27
+ updateSubscriptionQuantity,
28
+ upsertSubscription,
29
+ } from "./subscriptions.js";
30
+
31
+ const TO_REF = Symbol.for("toReferencePath");
32
+
33
+ /** Component proxy exposing the billing refs these functions resolve. */
34
+ function makeComponent(): Component {
35
+ const ref = (path: string) => ({ [TO_REF]: `betterStripe/${path}` });
36
+ return {
37
+ billing: {
38
+ queries: {
39
+ getSubscription: ref("billing/queries/getSubscription"),
40
+ getSubscriptionByStripeId: ref(
41
+ "billing/queries/getSubscriptionByStripeId",
42
+ ),
43
+ listSubscriptions: ref("billing/queries/listSubscriptions"),
44
+ listSubscriptionsByUser: ref("billing/queries/listSubscriptionsByUser"),
45
+ listSubscriptionsByOrg: ref("billing/queries/listSubscriptionsByOrg"),
46
+ getActiveSubscription: ref("billing/queries/getActiveSubscription"),
47
+ getTrialStatus: ref("billing/queries/getTrialStatus"),
48
+ },
49
+ mutations: {
50
+ upsertSubscription: ref("billing/mutations/upsertSubscription"),
51
+ },
52
+ },
53
+ } as unknown as Component;
54
+ }
55
+
56
+ function makeCtx(queryResult?: unknown) {
57
+ return {
58
+ runQuery: vi.fn().mockResolvedValue(queryResult),
59
+ runMutation: vi.fn().mockResolvedValue(undefined),
60
+ } as unknown as RunCtx & {
61
+ runQuery: ReturnType<typeof vi.fn>;
62
+ runMutation: ReturnType<typeof vi.fn>;
63
+ };
64
+ }
65
+
66
+ function makeStripe() {
67
+ return {
68
+ subscriptions: {
69
+ create: vi.fn(),
70
+ update: vi.fn(),
71
+ cancel: vi.fn(),
72
+ retrieve: vi.fn(),
73
+ list: vi.fn(),
74
+ },
75
+ subscriptionItems: {
76
+ update: vi.fn(),
77
+ },
78
+ };
79
+ }
80
+
81
+ const asStripe = (s: ReturnType<typeof makeStripe>) =>
82
+ s as unknown as Parameters<typeof cancelSubscription>[0];
83
+
84
+ /** Build an async-iterable Stripe list result over the given pages. */
85
+ function asyncIterable<T>(items: T[]) {
86
+ return {
87
+ async *[Symbol.asyncIterator]() {
88
+ for (const item of items) yield item;
89
+ },
90
+ };
91
+ }
92
+
93
+ /** Pull the ref's resolved reference path out of a runQuery/runMutation call. */
94
+ function refPath(call: unknown[]): string {
95
+ return (call[0] as Record<symbol, string>)[TO_REF];
96
+ }
97
+
98
+ // =============================================================================
99
+ // Read delegators
100
+ // =============================================================================
101
+
102
+ describe("getSubscription", () => {
103
+ it("queries getSubscription with the opts and returns the row", async () => {
104
+ const ctx = makeCtx({ stripeSubscriptionId: "sub_1" });
105
+ const result = await getSubscription(makeComponent(), ctx, {
106
+ subscriptionId: "internal_1",
107
+ });
108
+
109
+ expect(result).toEqual({ stripeSubscriptionId: "sub_1" });
110
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
111
+ "betterStripe/billing/queries/getSubscription",
112
+ );
113
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({ subscriptionId: "internal_1" });
114
+ });
115
+
116
+ it("returns null when the row is missing", async () => {
117
+ const ctx = makeCtx(null);
118
+ const result = await getSubscription(makeComponent(), ctx, {
119
+ subscriptionId: "missing",
120
+ });
121
+ expect(result).toBeNull();
122
+ });
123
+ });
124
+
125
+ describe("getSubscriptionByStripeId", () => {
126
+ it("queries getSubscriptionByStripeId and forwards the stripe id", async () => {
127
+ const ctx = makeCtx({ stripeSubscriptionId: "sub_x" });
128
+ const result = await getSubscriptionByStripeId(makeComponent(), ctx, {
129
+ stripeSubscriptionId: "sub_x",
130
+ });
131
+
132
+ expect(result).toEqual({ stripeSubscriptionId: "sub_x" });
133
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
134
+ "betterStripe/billing/queries/getSubscriptionByStripeId",
135
+ );
136
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({
137
+ stripeSubscriptionId: "sub_x",
138
+ });
139
+ });
140
+ });
141
+
142
+ describe("listSubscriptionsByUser", () => {
143
+ it("queries listSubscriptionsByUser and returns the rows", async () => {
144
+ const ctx = makeCtx([{ stripeSubscriptionId: "sub_a" }]);
145
+ const result = await listSubscriptionsByUser(makeComponent(), ctx, {
146
+ userId: "user_1",
147
+ status: "active",
148
+ });
149
+
150
+ expect(result).toHaveLength(1);
151
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
152
+ "betterStripe/billing/queries/listSubscriptionsByUser",
153
+ );
154
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({
155
+ userId: "user_1",
156
+ status: "active",
157
+ });
158
+ });
159
+ });
160
+
161
+ describe("listSubscriptionsByOrg", () => {
162
+ it("queries listSubscriptionsByOrg and forwards the org id", async () => {
163
+ const ctx = makeCtx([]);
164
+ await listSubscriptionsByOrg(makeComponent(), ctx, { orgId: "org_1" });
165
+
166
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
167
+ "betterStripe/billing/queries/listSubscriptionsByOrg",
168
+ );
169
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({ orgId: "org_1" });
170
+ });
171
+ });
172
+
173
+ describe("getActiveSubscription", () => {
174
+ it("queries getActiveSubscription and returns the row", async () => {
175
+ const ctx = makeCtx({ stripeSubscriptionId: "sub_active" });
176
+ const result = await getActiveSubscription(makeComponent(), ctx, {
177
+ userId: "user_1",
178
+ orgId: "org_1",
179
+ });
180
+
181
+ expect(result).toEqual({ stripeSubscriptionId: "sub_active" });
182
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
183
+ "betterStripe/billing/queries/getActiveSubscription",
184
+ );
185
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({
186
+ userId: "user_1",
187
+ orgId: "org_1",
188
+ });
189
+ });
190
+
191
+ it("returns null when there is no active subscription", async () => {
192
+ const ctx = makeCtx(null);
193
+ const result = await getActiveSubscription(makeComponent(), ctx, {
194
+ userId: "user_none",
195
+ });
196
+ expect(result).toBeNull();
197
+ });
198
+ });
199
+
200
+ describe("getTrialStatus", () => {
201
+ it("queries getTrialStatus and passes the subscription id through", async () => {
202
+ const ctx = makeCtx({ isTrialing: true });
203
+ const result = await getTrialStatus(makeComponent(), ctx, {
204
+ subscriptionId: "internal_1",
205
+ });
206
+
207
+ expect(result).toEqual({ isTrialing: true });
208
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
209
+ "betterStripe/billing/queries/getTrialStatus",
210
+ );
211
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({
212
+ subscriptionId: "internal_1",
213
+ });
214
+ });
215
+ });
216
+
217
+ describe("listSubscriptions", () => {
218
+ it("defaults opts to an empty arg object when called without opts", async () => {
219
+ const ctx = makeCtx([]);
220
+ await listSubscriptions(makeComponent(), ctx);
221
+
222
+ expect(refPath(ctx.runQuery.mock.calls[0])).toBe(
223
+ "betterStripe/billing/queries/listSubscriptions",
224
+ );
225
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({});
226
+ });
227
+
228
+ it("renames stripeAccountId to accountId and forwards remaining filters", async () => {
229
+ const ctx = makeCtx([{ stripeSubscriptionId: "sub_1" }]);
230
+ const result = await listSubscriptions(makeComponent(), ctx, {
231
+ stripeAccountId: "acct_1",
232
+ status: "active",
233
+ limit: 10,
234
+ });
235
+
236
+ expect(result).toHaveLength(1);
237
+ expect(ctx.runQuery.mock.calls[0][1]).toEqual({
238
+ accountId: "acct_1",
239
+ status: "active",
240
+ limit: 10,
241
+ });
242
+ });
243
+
244
+ it("omits accountId entirely when stripeAccountId is not provided", async () => {
245
+ const ctx = makeCtx([]);
246
+ await listSubscriptions(makeComponent(), ctx, { status: "canceled" });
247
+
248
+ const args = ctx.runQuery.mock.calls[0][1] as Record<string, unknown>;
249
+ expect(args).toEqual({ status: "canceled" });
250
+ expect("accountId" in args).toBe(false);
251
+ });
252
+ });
253
+
254
+ // =============================================================================
255
+ // Stripe-mutating helpers
256
+ // =============================================================================
257
+
258
+ describe("cancelSubscription", () => {
259
+ it("defaults to cancel-at-period-end (update, not cancel)", async () => {
260
+ const stripe = makeStripe();
261
+ stripe.subscriptions.update.mockResolvedValue({});
262
+ const ctx = makeCtx();
263
+
264
+ const result = await cancelSubscription(asStripe(stripe), ctx, {
265
+ stripeSubscriptionId: "sub_1",
266
+ });
267
+
268
+ expect(result).toEqual({ success: true });
269
+ expect(stripe.subscriptions.update).toHaveBeenCalledWith("sub_1", {
270
+ cancel_at_period_end: true,
271
+ });
272
+ expect(stripe.subscriptions.cancel).not.toHaveBeenCalled();
273
+ });
274
+
275
+ it("honours cancelAtPeriodEnd:true explicitly", async () => {
276
+ const stripe = makeStripe();
277
+ stripe.subscriptions.update.mockResolvedValue({});
278
+ const ctx = makeCtx();
279
+
280
+ await cancelSubscription(asStripe(stripe), ctx, {
281
+ stripeSubscriptionId: "sub_2",
282
+ cancelAtPeriodEnd: true,
283
+ });
284
+
285
+ expect(stripe.subscriptions.update).toHaveBeenCalledWith("sub_2", {
286
+ cancel_at_period_end: true,
287
+ });
288
+ expect(stripe.subscriptions.cancel).not.toHaveBeenCalled();
289
+ });
290
+
291
+ it("cancels immediately when cancelAtPeriodEnd is false", async () => {
292
+ const stripe = makeStripe();
293
+ stripe.subscriptions.cancel.mockResolvedValue({});
294
+ const ctx = makeCtx();
295
+
296
+ const result = await cancelSubscription(asStripe(stripe), ctx, {
297
+ stripeSubscriptionId: "sub_3",
298
+ cancelAtPeriodEnd: false,
299
+ });
300
+
301
+ expect(result).toEqual({ success: true });
302
+ expect(stripe.subscriptions.cancel).toHaveBeenCalledWith("sub_3");
303
+ expect(stripe.subscriptions.update).not.toHaveBeenCalled();
304
+ });
305
+ });
306
+
307
+ describe("reactivateSubscription", () => {
308
+ it("clears cancel_at_period_end and returns success", async () => {
309
+ const stripe = makeStripe();
310
+ stripe.subscriptions.update.mockResolvedValue({});
311
+ const ctx = makeCtx();
312
+
313
+ const result = await reactivateSubscription(asStripe(stripe), ctx, {
314
+ stripeSubscriptionId: "sub_1",
315
+ });
316
+
317
+ expect(result).toEqual({ success: true });
318
+ expect(stripe.subscriptions.update).toHaveBeenCalledWith("sub_1", {
319
+ cancel_at_period_end: false,
320
+ });
321
+ });
322
+ });
323
+
324
+ describe("updateSubscriptionQuantity", () => {
325
+ it("retrieves the subscription and updates the first item's quantity", async () => {
326
+ const stripe = makeStripe();
327
+ stripe.subscriptions.retrieve.mockResolvedValue({
328
+ items: { data: [{ id: "si_1" }, { id: "si_2" }] },
329
+ });
330
+ stripe.subscriptionItems.update.mockResolvedValue({});
331
+ const ctx = makeCtx();
332
+
333
+ const result = await updateSubscriptionQuantity(asStripe(stripe), ctx, {
334
+ stripeSubscriptionId: "sub_1",
335
+ quantity: 5,
336
+ });
337
+
338
+ expect(result).toEqual({ success: true });
339
+ expect(stripe.subscriptions.retrieve).toHaveBeenCalledWith("sub_1");
340
+ expect(stripe.subscriptionItems.update).toHaveBeenCalledWith("si_1", {
341
+ quantity: 5,
342
+ });
343
+ });
344
+
345
+ it("throws SUBSCRIPTION_UPDATE_FAILED when the subscription has no items", async () => {
346
+ const stripe = makeStripe();
347
+ stripe.subscriptions.retrieve.mockResolvedValue({
348
+ items: { data: [] },
349
+ });
350
+ const ctx = makeCtx();
351
+
352
+ await expect(
353
+ updateSubscriptionQuantity(asStripe(stripe), ctx, {
354
+ stripeSubscriptionId: "sub_empty",
355
+ quantity: 2,
356
+ }),
357
+ ).rejects.toMatchObject({ data: { code: "SUBSCRIPTION_UPDATE_FAILED" } });
358
+
359
+ expect(stripe.subscriptionItems.update).not.toHaveBeenCalled();
360
+ });
361
+
362
+ it("throws SUBSCRIPTION_UPDATE_FAILED when items is entirely absent", async () => {
363
+ const stripe = makeStripe();
364
+ stripe.subscriptions.retrieve.mockResolvedValue({});
365
+ const ctx = makeCtx();
366
+
367
+ await expect(
368
+ updateSubscriptionQuantity(asStripe(stripe), ctx, {
369
+ stripeSubscriptionId: "sub_noitems",
370
+ quantity: 3,
371
+ }),
372
+ ).rejects.toMatchObject({ data: { code: "SUBSCRIPTION_UPDATE_FAILED" } });
373
+ });
374
+ });
375
+
376
+ // =============================================================================
377
+ // listStripeSubscriptions (Stripe paginated iterator)
378
+ // =============================================================================
379
+
380
+ describe("listStripeSubscriptions", () => {
381
+ it("collects every subscription with default status 'all' and limit 100", async () => {
382
+ const stripe = makeStripe();
383
+ stripe.subscriptions.list.mockReturnValue(
384
+ asyncIterable([{ id: "sub_a" }, { id: "sub_b" }]),
385
+ );
386
+ const ctx = makeCtx();
387
+
388
+ const result = await listStripeSubscriptions(asStripe(stripe), ctx);
389
+
390
+ expect(result.map((s) => s.id)).toEqual(["sub_a", "sub_b"]);
391
+ expect(stripe.subscriptions.list).toHaveBeenCalledWith({
392
+ status: "all",
393
+ limit: 100,
394
+ });
395
+ });
396
+
397
+ it("forwards an explicit status and limit", async () => {
398
+ const stripe = makeStripe();
399
+ stripe.subscriptions.list.mockReturnValue(asyncIterable([]));
400
+ const ctx = makeCtx();
401
+
402
+ await listStripeSubscriptions(asStripe(stripe), ctx, {
403
+ status: "active",
404
+ limit: 25,
405
+ });
406
+
407
+ expect(stripe.subscriptions.list).toHaveBeenCalledWith({
408
+ status: "active",
409
+ limit: 25,
410
+ });
411
+ });
412
+
413
+ it("stops at `limit` instead of draining every page (BTS-101)", async () => {
414
+ const stripe = makeStripe();
415
+ let yielded = 0;
416
+ stripe.subscriptions.list.mockReturnValue({
417
+ async *[Symbol.asyncIterator]() {
418
+ for (const item of [
419
+ { id: "sub_a" },
420
+ { id: "sub_b" },
421
+ { id: "sub_c" },
422
+ { id: "sub_d" },
423
+ ]) {
424
+ yielded++;
425
+ yield item;
426
+ }
427
+ },
428
+ });
429
+ const ctx = makeCtx();
430
+
431
+ const result = await listStripeSubscriptions(asStripe(stripe), ctx, {
432
+ limit: 2,
433
+ });
434
+
435
+ expect(result.map((s) => s.id)).toEqual(["sub_a", "sub_b"]);
436
+ expect(yielded).toBe(2);
437
+ });
438
+ });
439
+
440
+ // =============================================================================
441
+ // upsertSubscription
442
+ // =============================================================================
443
+
444
+ describe("upsertSubscription", () => {
445
+ it("runs the upsert mutation with the opts and returns null", async () => {
446
+ const ctx = makeCtx();
447
+ const result = await upsertSubscription(makeComponent(), ctx, {
448
+ stripeSubscriptionId: "sub_1",
449
+ userId: "user_1",
450
+ status: "active",
451
+ cancelAtPeriodEnd: false,
452
+ isTrialing: false,
453
+ });
454
+
455
+ expect(result).toBeNull();
456
+ expect(refPath(ctx.runMutation.mock.calls[0])).toBe(
457
+ "betterStripe/billing/mutations/upsertSubscription",
458
+ );
459
+ expect(ctx.runMutation.mock.calls[0][1]).toMatchObject({
460
+ stripeSubscriptionId: "sub_1",
461
+ userId: "user_1",
462
+ status: "active",
463
+ });
464
+ });
465
+
466
+ it("throws when ctx has no runMutation (runMutationOrThrow guard)", async () => {
467
+ const ctx = { runQuery: vi.fn() } as unknown as RunCtx;
468
+
469
+ await expect(
470
+ upsertSubscription(makeComponent(), ctx, {
471
+ stripeSubscriptionId: "sub_1",
472
+ userId: "user_1",
473
+ status: "active",
474
+ cancelAtPeriodEnd: false,
475
+ isTrialing: false,
476
+ }),
477
+ ).rejects.toThrow(/requires a Convex ctx with runMutation/);
478
+ });
479
+ });
480
+
481
+ // =============================================================================
482
+ // syncAllSubscriptions
483
+ // =============================================================================
484
+
485
+ describe("syncAllSubscriptions", () => {
486
+ it("normalises metadata, customer, items, and trial fields into the upsert", async () => {
487
+ const stripe = makeStripe();
488
+ // current_period_start = 2021-01-01T00:00:00Z (epoch 1609459200)
489
+ // current_period_end = 2021-02-01T00:00:00Z (epoch 1612137600)
490
+ stripe.subscriptions.list.mockReturnValue(
491
+ asyncIterable([
492
+ {
493
+ id: "sub_1",
494
+ customer: { id: "cus_1" },
495
+ status: "trialing",
496
+ cancel_at_period_end: false,
497
+ canceled_at: null,
498
+ trial_start: 1609459200,
499
+ trial_end: 1612137600,
500
+ metadata: { userId: "user_1", orgId: "org_1" },
501
+ items: {
502
+ data: [
503
+ {
504
+ id: "si_1",
505
+ price: { id: "price_1" },
506
+ quantity: 3,
507
+ current_period_start: 1609459200,
508
+ current_period_end: 1612137600,
509
+ },
510
+ ],
511
+ },
512
+ },
513
+ ]),
514
+ );
515
+ const ctx = makeCtx();
516
+
517
+ const result = await syncAllSubscriptions(
518
+ asStripe(stripe),
519
+ makeComponent(),
520
+ ctx,
521
+ );
522
+
523
+ expect(result).toEqual({ synced: 1, errors: [], errorCount: 0 });
524
+
525
+ expect(refPath(ctx.runMutation.mock.calls[0])).toBe(
526
+ "betterStripe/billing/mutations/upsertSubscription",
527
+ );
528
+ expect(ctx.runMutation.mock.calls[0][1]).toEqual({
529
+ stripeSubscriptionId: "sub_1",
530
+ accountId: "cus_1",
531
+ userId: "user_1",
532
+ orgId: "org_1",
533
+ status: "trialing",
534
+ priceId: "price_1",
535
+ quantity: 3,
536
+ currentPeriodStart: "2021-01-01T00:00:00.000Z",
537
+ currentPeriodEnd: "2021-02-01T00:00:00.000Z",
538
+ cancelAtPeriodEnd: false,
539
+ canceledAt: undefined,
540
+ isTrialing: true,
541
+ trialStart: "2021-01-01T00:00:00.000Z",
542
+ trialEnd: "2021-02-01T00:00:00.000Z",
543
+ metadata: { userId: "user_1", orgId: "org_1" },
544
+ });
545
+ });
546
+
547
+ it("uses a string customer id directly and snake_case metadata keys", async () => {
548
+ const stripe = makeStripe();
549
+ stripe.subscriptions.list.mockReturnValue(
550
+ asyncIterable([
551
+ {
552
+ id: "sub_2",
553
+ customer: "cus_2",
554
+ status: "active",
555
+ cancel_at_period_end: true,
556
+ canceled_at: null,
557
+ trial_start: null,
558
+ trial_end: null,
559
+ metadata: { user_id: "user_2", org_id: "org_2" },
560
+ items: { data: [{ id: "si_2", price: { id: "price_2" }, quantity: 1 }] },
561
+ },
562
+ ]),
563
+ );
564
+ const ctx = makeCtx();
565
+
566
+ await syncAllSubscriptions(asStripe(stripe), makeComponent(), ctx);
567
+
568
+ expect(ctx.runMutation.mock.calls[0][1]).toMatchObject({
569
+ accountId: "cus_2",
570
+ userId: "user_2",
571
+ orgId: "org_2",
572
+ isTrialing: false,
573
+ trialStart: undefined,
574
+ trialEnd: undefined,
575
+ });
576
+ });
577
+
578
+ it("falls back to userId '' and undefined optionals when metadata/items are missing", async () => {
579
+ const stripe = makeStripe();
580
+ stripe.subscriptions.list.mockReturnValue(
581
+ asyncIterable([
582
+ {
583
+ id: "sub_3",
584
+ customer: null,
585
+ status: "active",
586
+ cancel_at_period_end: false,
587
+ canceled_at: null,
588
+ trial_start: null,
589
+ trial_end: null,
590
+ metadata: undefined,
591
+ items: { data: [] },
592
+ },
593
+ ]),
594
+ );
595
+ const ctx = makeCtx();
596
+
597
+ await syncAllSubscriptions(asStripe(stripe), makeComponent(), ctx);
598
+
599
+ expect(ctx.runMutation.mock.calls[0][1]).toMatchObject({
600
+ accountId: "",
601
+ userId: "",
602
+ orgId: undefined,
603
+ priceId: undefined,
604
+ quantity: undefined,
605
+ currentPeriodStart: undefined,
606
+ currentPeriodEnd: undefined,
607
+ metadata: undefined,
608
+ });
609
+ });
610
+
611
+ it("accumulates per-record errors and keeps syncing the rest", async () => {
612
+ const stripe = makeStripe();
613
+ stripe.subscriptions.list.mockReturnValue(
614
+ asyncIterable([
615
+ {
616
+ id: "sub_bad",
617
+ customer: "cus_bad",
618
+ status: "active",
619
+ cancel_at_period_end: false,
620
+ metadata: {},
621
+ items: { data: [] },
622
+ },
623
+ {
624
+ id: "sub_good",
625
+ customer: "cus_good",
626
+ status: "active",
627
+ cancel_at_period_end: false,
628
+ metadata: {},
629
+ items: { data: [] },
630
+ },
631
+ ]),
632
+ );
633
+ const ctx = makeCtx();
634
+ // First upsert throws, second succeeds.
635
+ ctx.runMutation
636
+ .mockRejectedValueOnce(new Error("boom"))
637
+ .mockResolvedValueOnce(undefined);
638
+
639
+ const result = await syncAllSubscriptions(
640
+ asStripe(stripe),
641
+ makeComponent(),
642
+ ctx,
643
+ );
644
+
645
+ expect(result.synced).toBe(1);
646
+ expect(result.errorCount).toBe(1);
647
+ expect(result.errors).toEqual(["Subscription sub_bad: boom"]);
648
+ });
649
+
650
+ it("labels a non-Error thrown value as 'Unknown error'", async () => {
651
+ const stripe = makeStripe();
652
+ stripe.subscriptions.list.mockReturnValue(
653
+ asyncIterable([
654
+ {
655
+ id: "sub_weird",
656
+ customer: "cus_weird",
657
+ status: "active",
658
+ cancel_at_period_end: false,
659
+ metadata: {},
660
+ items: { data: [] },
661
+ },
662
+ ]),
663
+ );
664
+ const ctx = makeCtx();
665
+ ctx.runMutation.mockRejectedValueOnce("not-an-error");
666
+
667
+ const result = await syncAllSubscriptions(
668
+ asStripe(stripe),
669
+ makeComponent(),
670
+ ctx,
671
+ );
672
+
673
+ expect(result).toEqual({
674
+ synced: 0,
675
+ errors: ["Subscription sub_weird: Unknown error"],
676
+ errorCount: 1,
677
+ });
678
+ });
679
+
680
+ it("returns a zero result for an empty subscription list", async () => {
681
+ const stripe = makeStripe();
682
+ stripe.subscriptions.list.mockReturnValue(asyncIterable([]));
683
+ const ctx = makeCtx();
684
+
685
+ const result = await syncAllSubscriptions(
686
+ asStripe(stripe),
687
+ makeComponent(),
688
+ ctx,
689
+ );
690
+
691
+ expect(result).toEqual({ synced: 0, errors: [], errorCount: 0 });
692
+ expect(ctx.runMutation).not.toHaveBeenCalled();
693
+ });
694
+ });
695
+
696
+ describe("createSubscription (BTS-17)", () => {
697
+ function createdSub(overrides: Record<string, unknown> = {}) {
698
+ return {
699
+ id: "sub_new",
700
+ status: "active",
701
+ cancel_at_period_end: false,
702
+ items: {
703
+ data: [
704
+ {
705
+ price: { id: "price_1" },
706
+ quantity: 1,
707
+ current_period_start: 1000,
708
+ current_period_end: 2000,
709
+ },
710
+ ],
711
+ },
712
+ metadata: { userId: "buyer_1" },
713
+ ...overrides,
714
+ };
715
+ }
716
+
717
+ it("creates a single-recipient subscription with destination + percent fee", async () => {
718
+ const stripe = makeStripe();
719
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
720
+ const ctx = makeCtx();
721
+
722
+ const result = await createSubscription(asStripe(stripe), makeComponent(), ctx, {
723
+ userId: "buyer_1",
724
+ customerAccount: "acct_buyer",
725
+ stripePriceId: "price_1",
726
+ destinationAccountId: "acct_store",
727
+ feeConfig: { percent: 10 },
728
+ });
729
+
730
+ const createArg = stripe.subscriptions.create.mock.calls[0][0];
731
+ expect(createArg.customer_account).toBe("acct_buyer");
732
+ expect(createArg.items).toEqual([{ price: "price_1" }]);
733
+ expect(createArg.transfer_data).toEqual({ destination: "acct_store" });
734
+ expect(createArg.application_fee_percent).toBe(10);
735
+ expect(createArg.payment_method_types).toBeUndefined();
736
+
737
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
738
+ expect(upsertArgs).toMatchObject({
739
+ stripeSubscriptionId: "sub_new",
740
+ accountId: "acct_buyer",
741
+ userId: "buyer_1",
742
+ status: "active",
743
+ chargeType: "destination",
744
+ destinationAccountId: "acct_store",
745
+ applicationFeePercent: 10,
746
+ });
747
+ expect(result).toEqual({ stripeSubscriptionId: "sub_new", status: "active" });
748
+ });
749
+
750
+ it("flags percent+fixed fees for per-invoice computation", async () => {
751
+ const stripe = makeStripe();
752
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
753
+ const ctx = makeCtx();
754
+
755
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
756
+ userId: "buyer_1",
757
+ customerAccount: "acct_buyer",
758
+ stripePriceId: "price_1",
759
+ destinationAccountId: "acct_store",
760
+ feeConfig: { percent: 2.9, fixed: 30 },
761
+ });
762
+
763
+ const createArg = stripe.subscriptions.create.mock.calls[0][0];
764
+ expect(createArg.transfer_data).toEqual({ destination: "acct_store" });
765
+ expect(createArg.application_fee_percent).toBeUndefined();
766
+ expect(createArg.metadata.bsFeeMode).toBe("per_invoice");
767
+ });
768
+
769
+ it("creates a plain subscription without destination/fee", async () => {
770
+ const stripe = makeStripe();
771
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
772
+ const ctx = makeCtx();
773
+
774
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
775
+ userId: "buyer_1",
776
+ customerAccount: "acct_buyer",
777
+ stripePriceId: "price_1",
778
+ });
779
+
780
+ const createArg = stripe.subscriptions.create.mock.calls[0][0];
781
+ expect(createArg.transfer_data).toBeUndefined();
782
+ expect(createArg.application_fee_percent).toBeUndefined();
783
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
784
+ expect(upsertArgs.chargeType).toBeUndefined();
785
+ });
786
+
787
+ it("passes the supplied idempotency key to the Stripe subscription create call", async () => {
788
+ const stripe = makeStripe();
789
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
790
+ const ctx = makeCtx();
791
+
792
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
793
+ userId: "buyer_1",
794
+ customerAccount: "acct_buyer",
795
+ stripePriceId: "price_1",
796
+ idempotencyKey: "bs_sub_buyer_1_price_1",
797
+ });
798
+
799
+ expect(stripe.subscriptions.create).toHaveBeenCalledWith(
800
+ expect.objectContaining({
801
+ customer_account: "acct_buyer",
802
+ items: [{ price: "price_1" }],
803
+ }),
804
+ { idempotencyKey: "bs_sub_buyer_1_price_1" },
805
+ );
806
+ });
807
+
808
+ it("routes a >1 split via separate charges (markers on subscription metadata)", async () => {
809
+ const stripe = makeStripe();
810
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
811
+ const ctx = makeCtx();
812
+
813
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
814
+ userId: "buyer_1",
815
+ customerAccount: "acct_buyer",
816
+ stripePriceId: "price_1",
817
+ split: [
818
+ { destinationAccountId: "acct_store", role: "store", percent: 80 },
819
+ { destinationAccountId: "acct_aff", role: "affiliate", percent: 5 },
820
+ ],
821
+ feeConfig: { percent: 10 },
822
+ });
823
+
824
+ const createArg = stripe.subscriptions.create.mock.calls[0][0];
825
+ expect(createArg.transfer_data).toBeUndefined();
826
+ expect(createArg.application_fee_percent).toBeUndefined();
827
+ expect(createArg.metadata.bsChargeType).toBe("separate");
828
+ expect(JSON.parse(createArg.metadata.bsSplit)).toHaveLength(2);
829
+
830
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
831
+ expect(upsertArgs.chargeType).toBe("separate");
832
+ expect(upsertArgs.splitRecipients).toHaveLength(2);
833
+ });
834
+
835
+ it("treats a single-recipient split as a destination charge", async () => {
836
+ const stripe = makeStripe();
837
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
838
+ const ctx = makeCtx();
839
+
840
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
841
+ userId: "buyer_1",
842
+ customerAccount: "acct_buyer",
843
+ stripePriceId: "price_1",
844
+ split: [{ destinationAccountId: "acct_store", role: "store", percent: 90 }],
845
+ feeConfig: { percent: 10 },
846
+ });
847
+
848
+ const createArg = stripe.subscriptions.create.mock.calls[0][0];
849
+ expect(createArg.transfer_data).toEqual({ destination: "acct_store" });
850
+ expect(createArg.application_fee_percent).toBe(10);
851
+ });
852
+
853
+ it("rejects feeConfig without a destinationAccountId", async () => {
854
+ const stripe = makeStripe();
855
+ const ctx = makeCtx();
856
+
857
+ await expect(
858
+ createSubscription(asStripe(stripe), makeComponent(), ctx, {
859
+ userId: "buyer_1",
860
+ customerAccount: "acct_buyer",
861
+ stripePriceId: "price_1",
862
+ feeConfig: { percent: 10 },
863
+ }),
864
+ ).rejects.toThrow(/destinationAccountId/);
865
+ expect(stripe.subscriptions.create).not.toHaveBeenCalled();
866
+ });
867
+
868
+ it("surfaces Stripe failures as structured errors", async () => {
869
+ const stripe = makeStripe();
870
+ stripe.subscriptions.create.mockRejectedValue(new Error("card_declined"));
871
+ const ctx = makeCtx();
872
+
873
+ await expect(
874
+ createSubscription(asStripe(stripe), makeComponent(), ctx, {
875
+ userId: "buyer_1",
876
+ customerAccount: "acct_buyer",
877
+ stripePriceId: "price_1",
878
+ }),
879
+ ).rejects.toThrow();
880
+ });
881
+ });
882
+
883
+ describe("groupSubscriptionsByStore (BTS-19)", () => {
884
+ it("groups a buyer's subscriptions by store, preserving first-seen order", () => {
885
+ const subs: { stripeSubscriptionId: string; destinationAccountId?: string }[] =
886
+ [
887
+ { stripeSubscriptionId: "s1", destinationAccountId: "store_a" },
888
+ { stripeSubscriptionId: "s2", destinationAccountId: "store_b" },
889
+ { stripeSubscriptionId: "s3", destinationAccountId: "store_a" },
890
+ { stripeSubscriptionId: "s4" }, // no store → platform-direct
891
+ ];
892
+
893
+ const grouped = groupSubscriptionsByStore(subs);
894
+
895
+ expect(grouped.map((g) => g.storeAccountId)).toEqual([
896
+ "store_a",
897
+ "store_b",
898
+ null,
899
+ ]);
900
+ expect(
901
+ grouped[0].subscriptions.map((s) => s.stripeSubscriptionId),
902
+ ).toEqual(["s1", "s3"]);
903
+ expect(grouped[1].subscriptions.map((s) => s.stripeSubscriptionId)).toEqual([
904
+ "s2",
905
+ ]);
906
+ expect(grouped[2].subscriptions.map((s) => s.stripeSubscriptionId)).toEqual([
907
+ "s4",
908
+ ]);
909
+ });
910
+
911
+ it("returns an empty array for no subscriptions", () => {
912
+ expect(groupSubscriptionsByStore([])).toEqual([]);
913
+ });
914
+ });
915
+
916
+ describe("createSubscription — per-store statement descriptor (BTS-32)", () => {
917
+ function createdSub() {
918
+ return {
919
+ id: "sub_sd",
920
+ status: "active",
921
+ cancel_at_period_end: false,
922
+ items: {
923
+ data: [
924
+ {
925
+ price: { id: "price_1" },
926
+ quantity: 1,
927
+ current_period_start: 1000,
928
+ current_period_end: 2000,
929
+ },
930
+ ],
931
+ },
932
+ metadata: { userId: "buyer_1" },
933
+ };
934
+ }
935
+
936
+ it("stashes bsStatementDescriptor from the store's account alongside per-invoice fee markers", async () => {
937
+ const stripe = makeStripe();
938
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
939
+ const ctx = makeCtx({ statementDescriptor: "MAYAS FITNESS" });
940
+
941
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
942
+ userId: "buyer_1",
943
+ customerAccount: "acct_buyer",
944
+ stripePriceId: "price_1",
945
+ destinationAccountId: "acct_store",
946
+ feeConfig: { percent: 2.9, fixed: 30 },
947
+ });
948
+
949
+ const params = stripe.subscriptions.create.mock.calls[0][0];
950
+ expect(params.metadata.bsStatementDescriptor).toBe("MAYAS FITNESS");
951
+ expect(params.metadata.bsFeeMode).toBe("per_invoice");
952
+ });
953
+
954
+ it("falls back to the provided platform default when the store has no suffix", async () => {
955
+ const stripe = makeStripe();
956
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
957
+ const ctx = makeCtx({}); // account record without statementDescriptor
958
+
959
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
960
+ userId: "buyer_1",
961
+ customerAccount: "acct_buyer",
962
+ stripePriceId: "price_1",
963
+ destinationAccountId: "acct_store",
964
+ defaultStatementDescriptorSuffix: "PLATFORM DEF",
965
+ });
966
+
967
+ const params = stripe.subscriptions.create.mock.calls[0][0];
968
+ expect(params.metadata.bsStatementDescriptor).toBe("PLATFORM DEF");
969
+ });
970
+
971
+ it("adds no marker and performs no account lookup without a destination", async () => {
972
+ const stripe = makeStripe();
973
+ stripe.subscriptions.create.mockResolvedValue(createdSub());
974
+ const ctx = makeCtx();
975
+
976
+ await createSubscription(asStripe(stripe), makeComponent(), ctx, {
977
+ userId: "buyer_1",
978
+ customerAccount: "acct_buyer",
979
+ stripePriceId: "price_1",
980
+ defaultStatementDescriptorSuffix: "PLATFORM DEF",
981
+ });
982
+
983
+ const params = stripe.subscriptions.create.mock.calls[0][0];
984
+ expect(params.metadata.bsStatementDescriptor).toBeUndefined();
985
+ expect(ctx.runQuery).not.toHaveBeenCalled();
986
+ });
987
+ });