@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,1234 @@
1
+ /**
2
+ * Tests for the checkout-session methods. `createCheckoutSession` carries the
3
+ * real branching logic — embedded vs redirect ui_mode, the
4
+ * subscription/payment/setup mode-specific blocks, metadata + orgId assembly,
5
+ * the accountId-vs-customerEmail precedence, default quantity, sessionOverrides
6
+ * spreading, and the component upsert with its null-coalescing defaults — so it
7
+ * gets the most attention. The remaining functions are thin component/Stripe
8
+ * wrappers verified for param shape and pass-through.
9
+ */
10
+ import { describe, expect, it, vi } from "vitest";
11
+
12
+ import type { Component, RunCtx } from "../helpers.js";
13
+ import {
14
+ createCheckoutSession,
15
+ getCheckoutSession,
16
+ getCheckoutSessionByStripeId,
17
+ listCheckoutSessionsByUser,
18
+ updateCheckoutSession,
19
+ upsertCheckoutSession,
20
+ } from "./checkout.js";
21
+
22
+ const TO_REF = Symbol.for("toReferencePath");
23
+
24
+ /** Component proxy exposing the billing refs these functions resolve. */
25
+ function makeComponent(): Component {
26
+ const ref = (path: string) => ({ [TO_REF]: `betterStripe/${path}` });
27
+ return {
28
+ billing: {
29
+ queries: {
30
+ getCheckoutSession: ref("billing/queries/getCheckoutSession"),
31
+ getCheckoutSessionByStripeId: ref(
32
+ "billing/queries/getCheckoutSessionByStripeId",
33
+ ),
34
+ listCheckoutSessionsByUser: ref(
35
+ "billing/queries/listCheckoutSessionsByUser",
36
+ ),
37
+ },
38
+ mutations: {
39
+ upsertCheckoutSession: ref("billing/mutations/upsertCheckoutSession"),
40
+ },
41
+ },
42
+ products: {
43
+ queries: {
44
+ getPriceByStripeId: ref("products/queries/getPriceByStripeId"),
45
+ getProductByStripeId: ref("products/queries/getProductByStripeId"),
46
+ },
47
+ },
48
+ core: {
49
+ queries: {
50
+ getAccountByStripeId: ref("core/queries/getAccountByStripeId"),
51
+ },
52
+ },
53
+ } as unknown as Component;
54
+ }
55
+
56
+ /** Build a ctx whose runQuery routes by component ref path (for price validation). */
57
+ function routedCtx(routes: Record<string, unknown>) {
58
+ const runQuery = vi.fn(async (refObj: Record<symbol, string>) => {
59
+ const path = refObj[TO_REF].replace(/^betterStripe\//, "");
60
+ return routes[path] ?? null;
61
+ });
62
+ return {
63
+ runQuery,
64
+ runMutation: vi.fn().mockResolvedValue(undefined),
65
+ } as unknown as RunCtx & {
66
+ runQuery: ReturnType<typeof vi.fn>;
67
+ runMutation: ReturnType<typeof vi.fn>;
68
+ };
69
+ }
70
+
71
+ function makeCtx(queryResult?: unknown) {
72
+ return {
73
+ runQuery: vi.fn().mockResolvedValue(queryResult),
74
+ runMutation: vi.fn().mockResolvedValue(undefined),
75
+ } as unknown as RunCtx & {
76
+ runQuery: ReturnType<typeof vi.fn>;
77
+ runMutation: ReturnType<typeof vi.fn>;
78
+ };
79
+ }
80
+
81
+ function makeStripe() {
82
+ return {
83
+ checkout: {
84
+ sessions: {
85
+ create: vi.fn(),
86
+ update: vi.fn(),
87
+ },
88
+ },
89
+ };
90
+ }
91
+
92
+ const asStripe = (s: ReturnType<typeof makeStripe>) =>
93
+ s as unknown as Parameters<typeof createCheckoutSession>[0];
94
+
95
+ /** Default Stripe session response used when a test does not care about it. */
96
+ function sessionResponse(overrides: Record<string, unknown> = {}) {
97
+ return {
98
+ id: "cs_test_1",
99
+ status: "open",
100
+ client_secret: "cs_secret_1",
101
+ url: null,
102
+ ...overrides,
103
+ };
104
+ }
105
+
106
+ describe("createCheckoutSession", () => {
107
+ it("builds a subscription embedded session and upserts the resulting row", async () => {
108
+ const stripe = makeStripe();
109
+ stripe.checkout.sessions.create.mockResolvedValue(
110
+ sessionResponse({ id: "cs_sub", client_secret: "secret_sub", url: null }),
111
+ );
112
+ const ctx = makeCtx();
113
+
114
+ const result = await createCheckoutSession(
115
+ asStripe(stripe),
116
+ makeComponent(),
117
+ ctx,
118
+ {
119
+ userId: "user_1",
120
+ orgId: "org_1",
121
+ stripePriceId: "price_1",
122
+ mode: "subscription",
123
+ returnUrl: "https://app.test/return",
124
+ },
125
+ );
126
+
127
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
128
+ // metadata includes userId + orgId; line_items default quantity 1
129
+ expect(createArg.metadata).toEqual({ userId: "user_1", orgId: "org_1" });
130
+ expect(createArg.line_items).toEqual([{ price: "price_1", quantity: 1 }]);
131
+ expect(createArg.mode).toBe("subscription");
132
+ // subscription mode → subscription_data carries the same metadata
133
+ expect(createArg.subscription_data).toEqual({
134
+ metadata: { userId: "user_1", orgId: "org_1" },
135
+ });
136
+ expect(createArg.subscription_data.trial_period_days).toBeUndefined();
137
+ // no payment_intent_data for subscription mode
138
+ expect(createArg.payment_intent_data).toBeUndefined();
139
+ // embedded ui_mode is the default
140
+ expect(createArg.ui_mode).toBe("embedded_page");
141
+ expect(createArg.return_url).toBe("https://app.test/return");
142
+ expect(createArg.success_url).toBeUndefined();
143
+ expect(createArg.cancel_url).toBeUndefined();
144
+
145
+ // upsert mutation carries derived row
146
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
147
+ expect(upsertArgs).toMatchObject({
148
+ stripeSessionId: "cs_sub",
149
+ userId: "user_1",
150
+ orgId: "org_1",
151
+ mode: "subscription",
152
+ status: "open",
153
+ clientSecret: "secret_sub",
154
+ metadata: { userId: "user_1", orgId: "org_1" },
155
+ });
156
+ expect(upsertArgs.url).toBeUndefined();
157
+
158
+ expect(result).toEqual({
159
+ stripeSessionId: "cs_sub",
160
+ clientSecret: "secret_sub",
161
+ url: undefined,
162
+ });
163
+ });
164
+
165
+ it("adds trial_period_days to subscription_data when trialDays is set", async () => {
166
+ const stripe = makeStripe();
167
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
168
+ const ctx = makeCtx();
169
+
170
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
171
+ userId: "user_1",
172
+ stripePriceId: "price_1",
173
+ mode: "subscription",
174
+ returnUrl: "https://app.test/return",
175
+ trialDays: 14,
176
+ });
177
+
178
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
179
+ expect(createArg.subscription_data.trial_period_days).toBe(14);
180
+ });
181
+
182
+ it("omits orgId from metadata when not provided", async () => {
183
+ const stripe = makeStripe();
184
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
185
+ const ctx = makeCtx();
186
+
187
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
188
+ userId: "user_solo",
189
+ stripePriceId: "price_1",
190
+ mode: "subscription",
191
+ returnUrl: "https://app.test/return",
192
+ });
193
+
194
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
195
+ expect(createArg.metadata).toEqual({ userId: "user_solo" });
196
+ expect(createArg.metadata.orgId).toBeUndefined();
197
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
198
+ expect(upsertArgs.orgId).toBeUndefined();
199
+ });
200
+
201
+ it("merges caller metadata with the userId/orgId identifiers", async () => {
202
+ const stripe = makeStripe();
203
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
204
+ const ctx = makeCtx();
205
+
206
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
207
+ userId: "user_1",
208
+ orgId: "org_1",
209
+ stripePriceId: "price_1",
210
+ mode: "subscription",
211
+ returnUrl: "https://app.test/return",
212
+ metadata: { plan: "pro", source: "pricing-page" },
213
+ });
214
+
215
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
216
+ expect(createArg.metadata).toEqual({
217
+ plan: "pro",
218
+ source: "pricing-page",
219
+ userId: "user_1",
220
+ orgId: "org_1",
221
+ });
222
+ });
223
+
224
+ it("uses payment_intent_data and redirect urls for a payment redirect session", async () => {
225
+ const stripe = makeStripe();
226
+ stripe.checkout.sessions.create.mockResolvedValue(
227
+ sessionResponse({ id: "cs_pay" }),
228
+ );
229
+ const ctx = makeCtx();
230
+
231
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
232
+ userId: "user_1",
233
+ stripePriceId: "price_1",
234
+ mode: "payment",
235
+ uiMode: "redirect",
236
+ returnUrl: "https://app.test/done",
237
+ });
238
+
239
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
240
+ // payment mode → payment_intent_data; no subscription_data
241
+ expect(createArg.payment_intent_data).toEqual({
242
+ metadata: { userId: "user_1" },
243
+ });
244
+ expect(createArg.subscription_data).toBeUndefined();
245
+ // redirect ui_mode → success/cancel urls, no embedded fields
246
+ expect(createArg.ui_mode).toBeUndefined();
247
+ expect(createArg.return_url).toBeUndefined();
248
+ expect(createArg.success_url).toBe(
249
+ "https://app.test/done?session_id={CHECKOUT_SESSION_ID}",
250
+ );
251
+ expect(createArg.cancel_url).toBe("https://app.test/done");
252
+ });
253
+
254
+ it("emits neither subscription_data nor payment_intent_data for setup mode", async () => {
255
+ const stripe = makeStripe();
256
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
257
+ const ctx = makeCtx();
258
+
259
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
260
+ userId: "user_1",
261
+ stripePriceId: "price_1",
262
+ mode: "setup",
263
+ returnUrl: "https://app.test/return",
264
+ });
265
+
266
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
267
+ expect(createArg.subscription_data).toBeUndefined();
268
+ expect(createArg.payment_intent_data).toBeUndefined();
269
+ expect(createArg.mode).toBe("setup");
270
+ });
271
+
272
+ it("forwards an explicit quantity to line_items", async () => {
273
+ const stripe = makeStripe();
274
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
275
+ const ctx = makeCtx();
276
+
277
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
278
+ userId: "user_1",
279
+ stripePriceId: "price_seat",
280
+ mode: "subscription",
281
+ returnUrl: "https://app.test/return",
282
+ quantity: 5,
283
+ });
284
+
285
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
286
+ expect(createArg.line_items).toEqual([{ price: "price_seat", quantity: 5 }]);
287
+ });
288
+
289
+ it("sets customer_account when accountId is provided", async () => {
290
+ const stripe = makeStripe();
291
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
292
+ const ctx = makeCtx();
293
+
294
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
295
+ userId: "user_1",
296
+ stripePriceId: "price_1",
297
+ mode: "subscription",
298
+ returnUrl: "https://app.test/return",
299
+ accountId: "acct_123",
300
+ customerEmail: "ignored@test.com",
301
+ });
302
+
303
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
304
+ // accountId takes precedence over customerEmail
305
+ expect(createArg.customer_account).toBe("acct_123");
306
+ expect(createArg.customer_email).toBeUndefined();
307
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
308
+ expect(upsertArgs.accountId).toBe("acct_123");
309
+ });
310
+
311
+ it("falls back to customer_email when no accountId is given", async () => {
312
+ const stripe = makeStripe();
313
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
314
+ const ctx = makeCtx();
315
+
316
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
317
+ userId: "user_1",
318
+ stripePriceId: "price_1",
319
+ mode: "subscription",
320
+ returnUrl: "https://app.test/return",
321
+ customerEmail: "buyer@test.com",
322
+ });
323
+
324
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
325
+ expect(createArg.customer_email).toBe("buyer@test.com");
326
+ expect(createArg.customer_account).toBeUndefined();
327
+ });
328
+
329
+ it("sets neither customer field when both accountId and email are absent", async () => {
330
+ const stripe = makeStripe();
331
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
332
+ const ctx = makeCtx();
333
+
334
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
335
+ userId: "user_1",
336
+ stripePriceId: "price_1",
337
+ mode: "subscription",
338
+ returnUrl: "https://app.test/return",
339
+ });
340
+
341
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
342
+ expect(createArg.customer_account).toBeUndefined();
343
+ expect(createArg.customer_email).toBeUndefined();
344
+ });
345
+
346
+ it("spreads sessionOverrides over the computed params", async () => {
347
+ const stripe = makeStripe();
348
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
349
+ const ctx = makeCtx();
350
+
351
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
352
+ userId: "user_1",
353
+ stripePriceId: "price_1",
354
+ mode: "subscription",
355
+ returnUrl: "https://app.test/return",
356
+ sessionOverrides: {
357
+ allow_promotion_codes: true,
358
+ mode: "payment", // override wins over computed mode
359
+ },
360
+ });
361
+
362
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
363
+ expect(createArg.allow_promotion_codes).toBe(true);
364
+ expect(createArg.mode).toBe("payment");
365
+ });
366
+
367
+ it("defaults status to 'open' and url/clientSecret to undefined when Stripe returns nullish values", async () => {
368
+ const stripe = makeStripe();
369
+ stripe.checkout.sessions.create.mockResolvedValue({
370
+ id: "cs_minimal",
371
+ status: null,
372
+ client_secret: null,
373
+ url: null,
374
+ });
375
+ const ctx = makeCtx();
376
+
377
+ const result = await createCheckoutSession(
378
+ asStripe(stripe),
379
+ makeComponent(),
380
+ ctx,
381
+ {
382
+ userId: "user_1",
383
+ stripePriceId: "price_1",
384
+ mode: "subscription",
385
+ returnUrl: "https://app.test/return",
386
+ },
387
+ );
388
+
389
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
390
+ expect(upsertArgs.status).toBe("open");
391
+ expect(upsertArgs.clientSecret).toBeUndefined();
392
+ expect(upsertArgs.url).toBeUndefined();
393
+ expect(result).toEqual({
394
+ stripeSessionId: "cs_minimal",
395
+ clientSecret: undefined,
396
+ url: undefined,
397
+ });
398
+ });
399
+
400
+ it("propagates the redirect url returned by Stripe into the upsert and result", async () => {
401
+ const stripe = makeStripe();
402
+ stripe.checkout.sessions.create.mockResolvedValue(
403
+ sessionResponse({
404
+ id: "cs_redir",
405
+ status: "complete",
406
+ client_secret: null,
407
+ url: "https://checkout.stripe.com/c/pay/cs_redir",
408
+ }),
409
+ );
410
+ const ctx = makeCtx();
411
+
412
+ const result = await createCheckoutSession(
413
+ asStripe(stripe),
414
+ makeComponent(),
415
+ ctx,
416
+ {
417
+ userId: "user_1",
418
+ stripePriceId: "price_1",
419
+ mode: "payment",
420
+ uiMode: "redirect",
421
+ returnUrl: "https://app.test/done",
422
+ },
423
+ );
424
+
425
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
426
+ expect(upsertArgs.status).toBe("complete");
427
+ expect(upsertArgs.url).toBe("https://checkout.stripe.com/c/pay/cs_redir");
428
+ expect(result.url).toBe("https://checkout.stripe.com/c/pay/cs_redir");
429
+ expect(result.clientSecret).toBeUndefined();
430
+ });
431
+
432
+ it("persists the price id on the upserted checkout-session row", async () => {
433
+ const stripe = makeStripe();
434
+ stripe.checkout.sessions.create.mockResolvedValue(
435
+ sessionResponse({ id: "cs_priced" }),
436
+ );
437
+ const ctx = makeCtx();
438
+
439
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
440
+ userId: "user_1",
441
+ stripePriceId: "price_pro_monthly",
442
+ mode: "subscription",
443
+ returnUrl: "https://app.test/return",
444
+ });
445
+
446
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
447
+ expect(upsertArgs.priceId).toBe("price_pro_monthly");
448
+ });
449
+
450
+ it("targets the upsertCheckoutSession component ref", async () => {
451
+ const stripe = makeStripe();
452
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
453
+ const ctx = makeCtx();
454
+
455
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
456
+ userId: "user_1",
457
+ stripePriceId: "price_1",
458
+ mode: "subscription",
459
+ returnUrl: "https://app.test/return",
460
+ });
461
+
462
+ const [ref] = ctx.runMutation.mock.calls[0];
463
+ expect(ref).toEqual({
464
+ [TO_REF]: "betterStripe/billing/mutations/upsertCheckoutSession",
465
+ });
466
+ });
467
+
468
+ it("throws when ctx has no runMutation (runMutationOrThrow guard)", async () => {
469
+ const stripe = makeStripe();
470
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
471
+ const ctx = { runQuery: vi.fn() } as unknown as RunCtx;
472
+
473
+ await expect(
474
+ createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
475
+ userId: "user_1",
476
+ stripePriceId: "price_1",
477
+ mode: "subscription",
478
+ returnUrl: "https://app.test/return",
479
+ }),
480
+ ).rejects.toThrow(/requires a Convex ctx with runMutation/);
481
+ });
482
+ });
483
+
484
+ describe("createCheckoutSession — destination + fee (BTS-15, subscription)", () => {
485
+ it("routes a percent-only fee via transfer_data + application_fee_percent", async () => {
486
+ const stripe = makeStripe();
487
+ stripe.checkout.sessions.create.mockResolvedValue(
488
+ sessionResponse({ id: "cs_dest" }),
489
+ );
490
+ const ctx = makeCtx();
491
+
492
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
493
+ userId: "buyer_1",
494
+ stripePriceId: "price_1",
495
+ mode: "subscription",
496
+ returnUrl: "https://app.test/return",
497
+ accountId: "acct_buyer",
498
+ destinationAccountId: "acct_store",
499
+ feeConfig: { percent: 10 },
500
+ });
501
+
502
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
503
+ expect(createArg.subscription_data.transfer_data).toEqual({
504
+ destination: "acct_store",
505
+ });
506
+ expect(createArg.subscription_data.application_fee_percent).toBe(10);
507
+ expect(createArg.subscription_data.metadata.bsFeeMode).toBeUndefined();
508
+ expect(createArg.payment_method_types).toBeUndefined();
509
+
510
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
511
+ expect(upsertArgs).toMatchObject({
512
+ chargeType: "destination",
513
+ destinationAccountId: "acct_store",
514
+ applicationFeePercent: 10,
515
+ });
516
+ });
517
+
518
+ it("flags percent+fixed fees for per-invoice computation (no application_fee_percent)", async () => {
519
+ const stripe = makeStripe();
520
+ stripe.checkout.sessions.create.mockResolvedValue(
521
+ sessionResponse({ id: "cs_dest2" }),
522
+ );
523
+ const ctx = makeCtx();
524
+
525
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
526
+ userId: "buyer_1",
527
+ stripePriceId: "price_1",
528
+ mode: "subscription",
529
+ returnUrl: "https://app.test/return",
530
+ accountId: "acct_buyer",
531
+ destinationAccountId: "acct_store",
532
+ feeConfig: { percent: 2.9, fixed: 30 },
533
+ });
534
+
535
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
536
+ expect(createArg.subscription_data.transfer_data).toEqual({
537
+ destination: "acct_store",
538
+ });
539
+ expect(createArg.subscription_data.application_fee_percent).toBeUndefined();
540
+ expect(createArg.subscription_data.metadata.bsFeeMode).toBe("per_invoice");
541
+
542
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
543
+ expect(upsertArgs.chargeType).toBe("destination");
544
+ expect(upsertArgs.destinationAccountId).toBe("acct_store");
545
+ });
546
+
547
+ it("adds no transfer_data or fees without a destinationAccountId", async () => {
548
+ const stripe = makeStripe();
549
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
550
+ const ctx = makeCtx();
551
+
552
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
553
+ userId: "user_1",
554
+ stripePriceId: "price_1",
555
+ mode: "subscription",
556
+ returnUrl: "https://app.test/return",
557
+ feeConfig: { percent: 10 },
558
+ });
559
+
560
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
561
+ expect(createArg.subscription_data.transfer_data).toBeUndefined();
562
+ expect(createArg.subscription_data.application_fee_percent).toBeUndefined();
563
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
564
+ expect(upsertArgs.chargeType).toBeUndefined();
565
+ });
566
+
567
+ it("derives the persisted fee row from the FINAL request when sessionOverrides replace subscription_data", async () => {
568
+ const stripe = makeStripe();
569
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
570
+ const ctx = makeCtx();
571
+
572
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
573
+ userId: "buyer_1",
574
+ stripePriceId: "price_1",
575
+ mode: "subscription",
576
+ returnUrl: "https://app.test/return",
577
+ accountId: "acct_buyer",
578
+ destinationAccountId: "acct_store",
579
+ feeConfig: { percent: 10 },
580
+ // Override wholesale-replaces subscription_data, dropping transfer_data/fee.
581
+ sessionOverrides: { subscription_data: { metadata: {} } },
582
+ });
583
+
584
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
585
+ expect(createArg.subscription_data.transfer_data).toBeUndefined();
586
+ // Persisted row must reflect the actual request — no stale fee/routing.
587
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
588
+ expect(upsertArgs.chargeType).toBeUndefined();
589
+ expect(upsertArgs.destinationAccountId).toBeUndefined();
590
+ expect(upsertArgs.applicationFeePercent).toBeUndefined();
591
+ });
592
+ });
593
+
594
+ describe("createCheckoutSession — destination + fee (BTS-16, one-time payment)", () => {
595
+ it("computes application_fee_amount when the amount is known", async () => {
596
+ const stripe = makeStripe();
597
+ stripe.checkout.sessions.create.mockResolvedValue(
598
+ sessionResponse({ id: "cs_pay_fee" }),
599
+ );
600
+ const ctx = makeCtx();
601
+
602
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
603
+ userId: "buyer_1",
604
+ stripePriceId: "price_1",
605
+ mode: "payment",
606
+ returnUrl: "https://app.test/return",
607
+ accountId: "acct_buyer",
608
+ destinationAccountId: "acct_store",
609
+ feeConfig: { percent: 10, fixed: 30 },
610
+ amount: 10000, // round(10000*0.10) + 30 = 1030
611
+ });
612
+
613
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
614
+ expect(createArg.payment_intent_data.transfer_data).toEqual({
615
+ destination: "acct_store",
616
+ });
617
+ expect(createArg.payment_intent_data.application_fee_amount).toBe(1030);
618
+ expect(createArg.payment_intent_data.metadata.bsFeeMode).toBeUndefined();
619
+
620
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
621
+ expect(upsertArgs).toMatchObject({
622
+ chargeType: "destination",
623
+ destinationAccountId: "acct_store",
624
+ applicationFeeAmount: 1030,
625
+ });
626
+ });
627
+
628
+ it("defers to the webhook when the amount is unknown", async () => {
629
+ const stripe = makeStripe();
630
+ stripe.checkout.sessions.create.mockResolvedValue(
631
+ sessionResponse({ id: "cs_pay_defer" }),
632
+ );
633
+ const ctx = makeCtx();
634
+
635
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
636
+ userId: "buyer_1",
637
+ stripePriceId: "price_1",
638
+ mode: "payment",
639
+ returnUrl: "https://app.test/return",
640
+ accountId: "acct_buyer",
641
+ destinationAccountId: "acct_store",
642
+ feeConfig: { percent: 10 },
643
+ });
644
+
645
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
646
+ expect(createArg.payment_intent_data.transfer_data).toEqual({
647
+ destination: "acct_store",
648
+ });
649
+ expect(
650
+ createArg.payment_intent_data.application_fee_amount,
651
+ ).toBeUndefined();
652
+ expect(createArg.payment_intent_data.metadata.bsFeeMode).toBe("per_charge");
653
+ });
654
+
655
+ it("adds no transfer_data or fees without a destinationAccountId", async () => {
656
+ const stripe = makeStripe();
657
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
658
+ const ctx = makeCtx();
659
+
660
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
661
+ userId: "user_1",
662
+ stripePriceId: "price_1",
663
+ mode: "payment",
664
+ returnUrl: "https://app.test/return",
665
+ feeConfig: { percent: 10 },
666
+ amount: 10000,
667
+ });
668
+
669
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
670
+ expect(createArg.payment_intent_data).toEqual({
671
+ metadata: { userId: "user_1" },
672
+ });
673
+ });
674
+ });
675
+
676
+ describe("createCheckoutSession — N-recipient split (BTS-21)", () => {
677
+ it("routes a >1 split (payment mode) via separate charges (no transfer_data/application_fee)", async () => {
678
+ const stripe = makeStripe();
679
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
680
+ const ctx = makeCtx();
681
+ const split = [
682
+ { destinationAccountId: "acct_store", role: "store" as const, percent: 80 },
683
+ { destinationAccountId: "acct_aff", role: "affiliate" as const, percent: 5 },
684
+ ];
685
+
686
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
687
+ userId: "buyer_1",
688
+ stripePriceId: "price_1",
689
+ mode: "payment",
690
+ returnUrl: "https://app.test/return",
691
+ accountId: "acct_buyer",
692
+ split,
693
+ feeConfig: { percent: 10 },
694
+ });
695
+
696
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
697
+ expect(createArg.payment_intent_data.transfer_data).toBeUndefined();
698
+ expect(createArg.payment_intent_data.metadata.bsChargeType).toBe("separate");
699
+ expect(JSON.parse(createArg.payment_intent_data.metadata.bsSplit)).toHaveLength(2);
700
+
701
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
702
+ expect(upsertArgs.chargeType).toBe("separate");
703
+ expect(upsertArgs.splitRecipients).toHaveLength(2);
704
+ });
705
+
706
+ it("routes a >1 split on a subscription via separate charges (markers on subscription_data)", async () => {
707
+ const stripe = makeStripe();
708
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
709
+ const ctx = makeCtx();
710
+
711
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
712
+ userId: "buyer_1",
713
+ stripePriceId: "price_1",
714
+ mode: "subscription",
715
+ returnUrl: "https://app.test/return",
716
+ accountId: "acct_buyer",
717
+ split: [
718
+ { destinationAccountId: "acct_store", role: "store", percent: 80 },
719
+ { destinationAccountId: "acct_aff", role: "affiliate", percent: 5 },
720
+ ],
721
+ feeConfig: { percent: 10 },
722
+ });
723
+
724
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
725
+ expect(createArg.subscription_data.transfer_data).toBeUndefined();
726
+ expect(createArg.subscription_data.application_fee_percent).toBeUndefined();
727
+ expect(createArg.subscription_data.metadata.bsChargeType).toBe("separate");
728
+ expect(JSON.parse(createArg.subscription_data.metadata.bsSplit)).toHaveLength(2);
729
+
730
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
731
+ expect(upsertArgs.chargeType).toBe("separate");
732
+ expect(upsertArgs.splitRecipients).toHaveLength(2);
733
+ });
734
+
735
+ it("treats a single-recipient split as a destination charge", async () => {
736
+ const stripe = makeStripe();
737
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
738
+ const ctx = makeCtx();
739
+
740
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
741
+ userId: "buyer_1",
742
+ stripePriceId: "price_1",
743
+ mode: "subscription",
744
+ returnUrl: "https://app.test/return",
745
+ accountId: "acct_buyer",
746
+ split: [{ destinationAccountId: "acct_store", role: "store", percent: 90 }],
747
+ feeConfig: { percent: 10 },
748
+ });
749
+
750
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
751
+ expect(createArg.subscription_data.transfer_data).toEqual({
752
+ destination: "acct_store",
753
+ });
754
+ expect(createArg.subscription_data.application_fee_percent).toBe(10);
755
+ const [, upsertArgs] = ctx.runMutation.mock.calls[0];
756
+ expect(upsertArgs.chargeType).toBe("destination");
757
+ });
758
+
759
+ it("routes a >1 split in payment mode via separate charges", async () => {
760
+ const stripe = makeStripe();
761
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
762
+ const ctx = makeCtx();
763
+
764
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
765
+ userId: "buyer_1",
766
+ stripePriceId: "price_1",
767
+ mode: "payment",
768
+ returnUrl: "https://app.test/return",
769
+ accountId: "acct_buyer",
770
+ split: [
771
+ { destinationAccountId: "acct_store", role: "store", amount: 8000 },
772
+ { destinationAccountId: "acct_aff", role: "affiliate", amount: 1000 },
773
+ ],
774
+ });
775
+
776
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
777
+ expect(createArg.payment_intent_data.transfer_data).toBeUndefined();
778
+ expect(createArg.payment_intent_data.metadata.bsChargeType).toBe("separate");
779
+ });
780
+
781
+ it("rejects split/destination/fee in setup mode", async () => {
782
+ const stripe = makeStripe();
783
+ const ctx = makeCtx();
784
+
785
+ await expect(
786
+ createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
787
+ userId: "buyer_1",
788
+ stripePriceId: "price_1",
789
+ mode: "setup",
790
+ returnUrl: "https://app.test/return",
791
+ accountId: "acct_buyer",
792
+ split: [{ destinationAccountId: "acct_store", role: "store", amount: 100 }],
793
+ }),
794
+ ).rejects.toThrow(/setup/i);
795
+ expect(stripe.checkout.sessions.create).not.toHaveBeenCalled();
796
+ });
797
+
798
+ it("strips reserved bs* keys from caller metadata so they can't forge split instructions", async () => {
799
+ const stripe = makeStripe();
800
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
801
+ const ctx = makeCtx();
802
+
803
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
804
+ userId: "buyer_1",
805
+ stripePriceId: "price_1",
806
+ mode: "payment",
807
+ returnUrl: "https://app.test/return",
808
+ accountId: "acct_buyer",
809
+ // A non-split caller trying to forge webhook instructions.
810
+ metadata: {
811
+ bsChargeType: "separate",
812
+ bsSplit: '[{"destinationAccountId":"acct_evil","role":"store","amount":9999}]',
813
+ plan: "pro",
814
+ },
815
+ });
816
+
817
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
818
+ expect(createArg.metadata.bsChargeType).toBeUndefined();
819
+ expect(createArg.metadata.bsSplit).toBeUndefined();
820
+ expect(createArg.metadata.plan).toBe("pro"); // legit keys kept
821
+ expect(createArg.payment_intent_data.metadata.bsChargeType).toBeUndefined();
822
+ });
823
+
824
+ it("rejects a split whose percents exceed 100", async () => {
825
+ const stripe = makeStripe();
826
+ const ctx = makeCtx();
827
+
828
+ await expect(
829
+ createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
830
+ userId: "buyer_1",
831
+ stripePriceId: "price_1",
832
+ mode: "subscription",
833
+ returnUrl: "https://app.test/return",
834
+ accountId: "acct_buyer",
835
+ split: [
836
+ { destinationAccountId: "acct_store", role: "store", percent: 70 },
837
+ { destinationAccountId: "acct_aff", role: "affiliate", percent: 40 },
838
+ ],
839
+ }),
840
+ ).rejects.toThrow();
841
+ expect(stripe.checkout.sessions.create).not.toHaveBeenCalled();
842
+ });
843
+ });
844
+
845
+ describe("createCheckoutSession — price-on-platform validation (BTS-15)", () => {
846
+ it("rejects a destination charge whose price belongs to a connected account", async () => {
847
+ const stripe = makeStripe();
848
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
849
+ const ctx = routedCtx({
850
+ "products/queries/getPriceByStripeId": {
851
+ stripePriceId: "price_1",
852
+ stripeProductId: "prod_1",
853
+ },
854
+ "products/queries/getProductByStripeId": {
855
+ stripeProductId: "prod_1",
856
+ accountId: "acct_seller", // connected-account-owned → invalid
857
+ },
858
+ });
859
+
860
+ await expect(
861
+ createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
862
+ userId: "buyer_1",
863
+ stripePriceId: "price_1",
864
+ mode: "subscription",
865
+ returnUrl: "https://app.test/return",
866
+ accountId: "acct_buyer",
867
+ destinationAccountId: "acct_store",
868
+ feeConfig: { percent: 10 },
869
+ }),
870
+ ).rejects.toThrow(/platform/i);
871
+ expect(stripe.checkout.sessions.create).not.toHaveBeenCalled();
872
+ // The catalog lookups use the right ids (price → its product).
873
+ // The catalog lookups use the right ids (price → its product). Positions
874
+ // are not asserted: the BTS-32 statement-descriptor account lookup also
875
+ // runs during session creation.
876
+ expect(ctx.runQuery).toHaveBeenCalledWith(expect.any(Object), {
877
+ stripePriceId: "price_1",
878
+ });
879
+ expect(ctx.runQuery).toHaveBeenCalledWith(expect.any(Object), {
880
+ stripeProductId: "prod_1",
881
+ });
882
+ });
883
+
884
+ it("allows a destination charge for a platform-owned price", async () => {
885
+ const stripe = makeStripe();
886
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
887
+ const ctx = routedCtx({
888
+ "products/queries/getPriceByStripeId": {
889
+ stripePriceId: "price_1",
890
+ stripeProductId: "prod_1",
891
+ },
892
+ "products/queries/getProductByStripeId": {
893
+ stripeProductId: "prod_1",
894
+ // no accountId → platform-owned
895
+ },
896
+ });
897
+
898
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
899
+ userId: "buyer_1",
900
+ stripePriceId: "price_1",
901
+ mode: "subscription",
902
+ returnUrl: "https://app.test/return",
903
+ accountId: "acct_buyer",
904
+ destinationAccountId: "acct_store",
905
+ feeConfig: { percent: 10 },
906
+ });
907
+ // The catalog lookups use the right ids (price → its product). Positions
908
+ // are not asserted: the BTS-32 statement-descriptor account lookup also
909
+ // runs during session creation.
910
+ expect(ctx.runQuery).toHaveBeenCalledWith(expect.any(Object), {
911
+ stripePriceId: "price_1",
912
+ });
913
+ expect(ctx.runQuery).toHaveBeenCalledWith(expect.any(Object), {
914
+ stripeProductId: "prod_1",
915
+ });
916
+ expect(stripe.checkout.sessions.create).toHaveBeenCalled();
917
+ });
918
+
919
+ it("validates the FINAL request — sessionOverrides can't inject a destination to bypass the check", async () => {
920
+ const stripe = makeStripe();
921
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
922
+ const ctx = routedCtx({
923
+ "products/queries/getPriceByStripeId": {
924
+ stripePriceId: "price_1",
925
+ stripeProductId: "prod_1",
926
+ },
927
+ "products/queries/getProductByStripeId": {
928
+ stripeProductId: "prod_1",
929
+ accountId: "acct_seller", // connected-account-owned → invalid
930
+ },
931
+ });
932
+
933
+ await expect(
934
+ createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
935
+ userId: "buyer_1",
936
+ stripePriceId: "price_1",
937
+ mode: "subscription",
938
+ returnUrl: "https://app.test/return",
939
+ accountId: "acct_buyer",
940
+ // No destinationAccountId on opts — but overrides inject one.
941
+ sessionOverrides: {
942
+ subscription_data: { transfer_data: { destination: "acct_store" } },
943
+ },
944
+ }),
945
+ ).rejects.toThrow(/platform/i);
946
+ expect(stripe.checkout.sessions.create).not.toHaveBeenCalled();
947
+ });
948
+
949
+ it("skips validation when there is no destination (plain checkout)", async () => {
950
+ const stripe = makeStripe();
951
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
952
+ const ctx = makeCtx();
953
+
954
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
955
+ userId: "user_1",
956
+ stripePriceId: "price_1",
957
+ mode: "subscription",
958
+ returnUrl: "https://app.test/return",
959
+ });
960
+ // No price lookup performed for a non-destination checkout.
961
+ expect(ctx.runQuery).not.toHaveBeenCalled();
962
+ expect(stripe.checkout.sessions.create).toHaveBeenCalled();
963
+ });
964
+ });
965
+
966
+ describe("getCheckoutSession", () => {
967
+ it("queries by internal session id and returns the row", async () => {
968
+ const ctx = makeCtx({ stripeSessionId: "cs_1" });
969
+ const result = await getCheckoutSession(makeComponent(), ctx, {
970
+ sessionId: "internal_1",
971
+ });
972
+
973
+ expect(result).toEqual({ stripeSessionId: "cs_1" });
974
+ const [ref, args] = ctx.runQuery.mock.calls[0];
975
+ expect(ref).toEqual({
976
+ [TO_REF]: "betterStripe/billing/queries/getCheckoutSession",
977
+ });
978
+ expect(args).toEqual({ sessionId: "internal_1" });
979
+ });
980
+
981
+ it("returns null when the session does not exist", async () => {
982
+ const ctx = makeCtx(null);
983
+ const result = await getCheckoutSession(makeComponent(), ctx, {
984
+ sessionId: "missing",
985
+ });
986
+ expect(result).toBeNull();
987
+ });
988
+ });
989
+
990
+ describe("getCheckoutSessionByStripeId", () => {
991
+ it("queries by stripe session id and returns the row", async () => {
992
+ const ctx = makeCtx({ stripeSessionId: "cs_abc" });
993
+ const result = await getCheckoutSessionByStripeId(makeComponent(), ctx, {
994
+ stripeSessionId: "cs_abc",
995
+ });
996
+
997
+ expect(result).toEqual({ stripeSessionId: "cs_abc" });
998
+ const [ref, args] = ctx.runQuery.mock.calls[0];
999
+ expect(ref).toEqual({
1000
+ [TO_REF]: "betterStripe/billing/queries/getCheckoutSessionByStripeId",
1001
+ });
1002
+ expect(args).toEqual({ stripeSessionId: "cs_abc" });
1003
+ });
1004
+ });
1005
+
1006
+ describe("listCheckoutSessionsByUser", () => {
1007
+ it("forwards userId and optional status filter and returns the rows", async () => {
1008
+ const ctx = makeCtx([{ stripeSessionId: "cs_a" }, { stripeSessionId: "cs_b" }]);
1009
+ const result = await listCheckoutSessionsByUser(makeComponent(), ctx, {
1010
+ userId: "user_1",
1011
+ status: "complete",
1012
+ });
1013
+
1014
+ expect(result).toHaveLength(2);
1015
+ const [ref, args] = ctx.runQuery.mock.calls[0];
1016
+ expect(ref).toEqual({
1017
+ [TO_REF]: "betterStripe/billing/queries/listCheckoutSessionsByUser",
1018
+ });
1019
+ expect(args).toEqual({ userId: "user_1", status: "complete" });
1020
+ });
1021
+ });
1022
+
1023
+ describe("upsertCheckoutSession", () => {
1024
+ it("runs the upsert mutation with the given opts and returns null", async () => {
1025
+ const ctx = makeCtx();
1026
+ const result = await upsertCheckoutSession(makeComponent(), ctx, {
1027
+ stripeSessionId: "cs_up",
1028
+ userId: "user_1",
1029
+ mode: "payment",
1030
+ status: "complete",
1031
+ });
1032
+
1033
+ expect(result).toBeNull();
1034
+ const [ref, args] = ctx.runMutation.mock.calls[0];
1035
+ expect(ref).toEqual({
1036
+ [TO_REF]: "betterStripe/billing/mutations/upsertCheckoutSession",
1037
+ });
1038
+ expect(args).toEqual({
1039
+ stripeSessionId: "cs_up",
1040
+ userId: "user_1",
1041
+ mode: "payment",
1042
+ status: "complete",
1043
+ });
1044
+ });
1045
+
1046
+ it("throws when ctx has no runMutation", async () => {
1047
+ const ctx = { runQuery: vi.fn() } as unknown as RunCtx;
1048
+ await expect(
1049
+ upsertCheckoutSession(makeComponent(), ctx, {
1050
+ stripeSessionId: "cs_up",
1051
+ userId: "user_1",
1052
+ mode: "payment",
1053
+ status: "complete",
1054
+ }),
1055
+ ).rejects.toThrow(/requires a Convex ctx with runMutation/);
1056
+ });
1057
+ });
1058
+
1059
+ describe("updateCheckoutSession", () => {
1060
+ it("updates the Stripe session metadata and returns the session", async () => {
1061
+ const stripe = makeStripe();
1062
+ const updated = { id: "cs_u", metadata: { plan: "pro" } };
1063
+ stripe.checkout.sessions.update.mockResolvedValue(updated);
1064
+ const ctx = makeCtx();
1065
+
1066
+ const result = await updateCheckoutSession(asStripe(stripe), ctx, {
1067
+ stripeSessionId: "cs_u",
1068
+ metadata: { plan: "pro" },
1069
+ });
1070
+
1071
+ expect(stripe.checkout.sessions.update).toHaveBeenCalledWith("cs_u", {
1072
+ metadata: { plan: "pro" },
1073
+ });
1074
+ expect(result).toBe(updated);
1075
+ });
1076
+
1077
+ it("passes undefined metadata through when none is provided", async () => {
1078
+ const stripe = makeStripe();
1079
+ stripe.checkout.sessions.update.mockResolvedValue({ id: "cs_u2" });
1080
+ const ctx = makeCtx();
1081
+
1082
+ await updateCheckoutSession(asStripe(stripe), ctx, {
1083
+ stripeSessionId: "cs_u2",
1084
+ });
1085
+
1086
+ expect(stripe.checkout.sessions.update).toHaveBeenCalledWith("cs_u2", {
1087
+ metadata: undefined,
1088
+ });
1089
+ });
1090
+ });
1091
+
1092
+ describe("createCheckoutSession — per-store statement descriptor (BTS-32)", () => {
1093
+ const storeAccount = (statementDescriptor?: string) => ({
1094
+ _id: "doc_acct",
1095
+ stripeAccountId: "acct_store",
1096
+ userId: "seller_1",
1097
+ ...(statementDescriptor ? { statementDescriptor } : {}),
1098
+ });
1099
+
1100
+ it("payment mode: sets statement_descriptor_suffix from the store's account record", async () => {
1101
+ const stripe = makeStripe();
1102
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
1103
+ const ctx = routedCtx({
1104
+ "core/queries/getAccountByStripeId": storeAccount("MAYAS FITNESS"),
1105
+ });
1106
+
1107
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
1108
+ userId: "buyer_1",
1109
+ stripePriceId: "price_1",
1110
+ mode: "payment",
1111
+ returnUrl: "https://app.test/return",
1112
+ destinationAccountId: "acct_store",
1113
+ defaultStatementDescriptorSuffix: "PLATFORM DEF",
1114
+ });
1115
+
1116
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
1117
+ expect(createArg.payment_intent_data.statement_descriptor_suffix).toBe(
1118
+ "MAYAS FITNESS",
1119
+ );
1120
+ });
1121
+
1122
+ it("payment mode: falls back to the configured default when the store has no suffix", async () => {
1123
+ const stripe = makeStripe();
1124
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
1125
+ const ctx = routedCtx({
1126
+ "core/queries/getAccountByStripeId": storeAccount(undefined),
1127
+ });
1128
+
1129
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
1130
+ userId: "buyer_1",
1131
+ stripePriceId: "price_1",
1132
+ mode: "payment",
1133
+ returnUrl: "https://app.test/return",
1134
+ destinationAccountId: "acct_store",
1135
+ defaultStatementDescriptorSuffix: "PLATFORM DEF",
1136
+ });
1137
+
1138
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
1139
+ expect(createArg.payment_intent_data.statement_descriptor_suffix).toBe(
1140
+ "PLATFORM DEF",
1141
+ );
1142
+ });
1143
+
1144
+ it("payment mode: omits the suffix when neither store nor default has one", async () => {
1145
+ const stripe = makeStripe();
1146
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
1147
+ const ctx = routedCtx({
1148
+ "core/queries/getAccountByStripeId": storeAccount(undefined),
1149
+ });
1150
+
1151
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
1152
+ userId: "buyer_1",
1153
+ stripePriceId: "price_1",
1154
+ mode: "payment",
1155
+ returnUrl: "https://app.test/return",
1156
+ destinationAccountId: "acct_store",
1157
+ });
1158
+
1159
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
1160
+ expect(
1161
+ "statement_descriptor_suffix" in createArg.payment_intent_data,
1162
+ ).toBe(false);
1163
+ });
1164
+
1165
+ it("subscription mode: stashes bsStatementDescriptor for the invoice.created processor without clobbering fee markers", async () => {
1166
+ const stripe = makeStripe();
1167
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
1168
+ const ctx = routedCtx({
1169
+ "core/queries/getAccountByStripeId": storeAccount("MAYAS FITNESS"),
1170
+ });
1171
+
1172
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
1173
+ userId: "buyer_1",
1174
+ stripePriceId: "price_1",
1175
+ mode: "subscription",
1176
+ returnUrl: "https://app.test/return",
1177
+ destinationAccountId: "acct_store",
1178
+ feeConfig: { percent: 2.9, fixed: 30 },
1179
+ });
1180
+
1181
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
1182
+ // Both markers coexist: the per-invoice fee flag AND the descriptor stash.
1183
+ expect(createArg.subscription_data.metadata.bsFeeMode).toBe("per_invoice");
1184
+ expect(createArg.subscription_data.metadata.bsStatementDescriptor).toBe(
1185
+ "MAYAS FITNESS",
1186
+ );
1187
+ // Not a session/PI-level field in subscription mode.
1188
+ expect(createArg.payment_intent_data).toBeUndefined();
1189
+ });
1190
+
1191
+ it("does not look up accounts or set a suffix for non-destination sales", async () => {
1192
+ const stripe = makeStripe();
1193
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
1194
+ const ctx = routedCtx({});
1195
+
1196
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
1197
+ userId: "buyer_1",
1198
+ stripePriceId: "price_1",
1199
+ mode: "payment",
1200
+ returnUrl: "https://app.test/return",
1201
+ defaultStatementDescriptorSuffix: "PLATFORM DEF",
1202
+ });
1203
+
1204
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
1205
+ expect(
1206
+ createArg.payment_intent_data.statement_descriptor_suffix,
1207
+ ).toBeUndefined();
1208
+ const accountLookups = ctx.runQuery.mock.calls.filter((call: unknown[]) =>
1209
+ String((call[0] as Record<symbol, string>)[TO_REF]).includes(
1210
+ "getAccountByStripeId",
1211
+ ),
1212
+ );
1213
+ expect(accountLookups).toHaveLength(0);
1214
+ });
1215
+
1216
+ it("callers cannot forge bsStatementDescriptor via metadata (reserved namespace stripped)", async () => {
1217
+ const stripe = makeStripe();
1218
+ stripe.checkout.sessions.create.mockResolvedValue(sessionResponse());
1219
+ const ctx = routedCtx({});
1220
+
1221
+ await createCheckoutSession(asStripe(stripe), makeComponent(), ctx, {
1222
+ userId: "buyer_1",
1223
+ stripePriceId: "price_1",
1224
+ mode: "subscription",
1225
+ returnUrl: "https://app.test/return",
1226
+ metadata: { bsStatementDescriptor: "FORGED" },
1227
+ });
1228
+
1229
+ const createArg = stripe.checkout.sessions.create.mock.calls[0][0];
1230
+ expect(
1231
+ createArg.subscription_data.metadata.bsStatementDescriptor,
1232
+ ).toBeUndefined();
1233
+ });
1234
+ });