@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,416 @@
1
+ import type Stripe from "stripe";
2
+
3
+ import type { SplitRecipient } from "../../component/lib/fees.js";
4
+ import { computeFee, isPercentOnlyFee, validateSplit } from "../core/fees.js";
5
+ import { throwStripeError } from "../errors.js";
6
+ import type { Component, RunCtx } from "../helpers.js";
7
+ import { runMutationOrThrow, stripReservedMetadata } from "../helpers.js";
8
+ import type { CheckoutSessionCreateParams } from "../stripe-types.js";
9
+ import type {
10
+ PlatformFeeConfig,
11
+ StripeComponentCheckoutSession,
12
+ } from "../types.js";
13
+ import { componentRef } from "../webhooks/helpers.js";
14
+
15
+ /**
16
+ * Derive the persisted fee/routing fields (BTS-11) from the FINAL Checkout
17
+ * Session request, reading the nested `subscription_data`/`payment_intent_data`
18
+ * that will actually be sent to Stripe. Deriving from the final request (rather
19
+ * than a pre-override draft) keeps the stored row consistent when callers pass
20
+ * `sessionOverrides` that replace those nested params.
21
+ */
22
+ function deriveFeeRow(params: CheckoutSessionCreateParams): {
23
+ chargeType?: "destination";
24
+ destinationAccountId?: string;
25
+ applicationFeePercent?: number;
26
+ applicationFeeAmount?: number;
27
+ } {
28
+ const dest = (d: unknown): string | undefined =>
29
+ typeof d === "string"
30
+ ? d
31
+ : ((d as { id?: string } | null | undefined)?.id ?? undefined);
32
+
33
+ if (params.mode === "subscription") {
34
+ const destination = dest(
35
+ params.subscription_data?.transfer_data?.destination,
36
+ );
37
+ if (!destination) return {};
38
+ const pct = params.subscription_data?.application_fee_percent;
39
+ return {
40
+ chargeType: "destination",
41
+ destinationAccountId: destination,
42
+ ...(pct !== undefined ? { applicationFeePercent: pct } : {}),
43
+ };
44
+ }
45
+ if (params.mode === "payment") {
46
+ const destination = dest(
47
+ params.payment_intent_data?.transfer_data?.destination,
48
+ );
49
+ if (!destination) return {};
50
+ const amt = params.payment_intent_data?.application_fee_amount;
51
+ return {
52
+ chargeType: "destination",
53
+ destinationAccountId: destination,
54
+ ...(amt !== undefined ? { applicationFeeAmount: amt } : {}),
55
+ };
56
+ }
57
+ return {};
58
+ }
59
+
60
+ /**
61
+ * Destination charges require the price to live on the PLATFORM account, not a
62
+ * connected account. Best-effort guard: if the price is in the component catalog
63
+ * and its product belongs to a connected account, throw a clear error before
64
+ * hitting Stripe. A price absent from the catalog is left to Stripe to validate.
65
+ */
66
+ async function assertPlatformPrice(
67
+ component: Component,
68
+ ctx: RunCtx,
69
+ stripePriceId: string,
70
+ ): Promise<void> {
71
+ const price = (await ctx.runQuery(
72
+ componentRef(component, "products/queries/getPriceByStripeId"),
73
+ { stripePriceId },
74
+ )) as { stripeProductId?: string } | null;
75
+ if (!price?.stripeProductId) return;
76
+
77
+ const product = (await ctx.runQuery(
78
+ componentRef(component, "products/queries/getProductByStripeId"),
79
+ { stripeProductId: price.stripeProductId },
80
+ )) as { accountId?: string } | null;
81
+
82
+ if (product?.accountId) {
83
+ throwStripeError(
84
+ "INVALID_CONFIGURATION",
85
+ `Price ${stripePriceId} belongs to connected account ${product.accountId}; destination charges require a platform-owned price.`,
86
+ );
87
+ }
88
+ }
89
+
90
+ // =============================================================================
91
+ // Checkout methods
92
+ // =============================================================================
93
+
94
+ export async function createCheckoutSession(
95
+ stripe: Stripe,
96
+ component: Component,
97
+ ctx: RunCtx,
98
+ opts: {
99
+ userId: string;
100
+ orgId?: string;
101
+ stripePriceId: string;
102
+ mode: "payment" | "subscription" | "setup";
103
+ uiMode?: "embedded" | "redirect";
104
+ quantity?: number;
105
+ returnUrl: string;
106
+ trialDays?: number;
107
+ accountId?: string;
108
+ customerEmail?: string;
109
+ /**
110
+ * The seller/recipient connected account funds are routed to (destination
111
+ * charge). Fees only apply when this is set.
112
+ */
113
+ destinationAccountId?: string;
114
+ /**
115
+ * Multiple recipients for one sale (store + affiliate[s]). With >1 recipient
116
+ * this routes via separate charges & transfers (no `application_fee`); the
117
+ * transfers are created by the webhook engine. A single-recipient split is
118
+ * treated as a destination charge. Takes precedence over `destinationAccountId`.
119
+ */
120
+ split?: SplitRecipient[];
121
+ /** Resolved platform fee config (the caller resolves override → default). */
122
+ feeConfig?: PlatformFeeConfig;
123
+ /**
124
+ * Charge total in minor units (one-time payment mode). When known, the
125
+ * fixed `application_fee_amount` is computed up front; otherwise the fee is
126
+ * deferred to the webhook.
127
+ */
128
+ amount?: number;
129
+ /**
130
+ * Platform-default statement-descriptor suffix (BTS-32), used when the
131
+ * destination account record carries no per-store suffix. The caller
132
+ * (BetterStripe) passes its validated configured default.
133
+ */
134
+ defaultStatementDescriptorSuffix?: string;
135
+ metadata?: Record<string, string>;
136
+ sessionOverrides?: Record<string, unknown>;
137
+ },
138
+ ) {
139
+ const uiMode = opts.uiMode ?? "embedded";
140
+
141
+ // Setup-mode sessions create no charge, so routing/fees are meaningless and
142
+ // would persist an unfunded `chargeType` the webhook engine can't act on.
143
+ if (
144
+ opts.mode === "setup" &&
145
+ (opts.split?.length || opts.destinationAccountId || opts.feeConfig)
146
+ ) {
147
+ throwStripeError(
148
+ "INVALID_CONFIGURATION",
149
+ "split/destinationAccountId/fee are not supported for setup-mode Checkout Sessions",
150
+ );
151
+ }
152
+
153
+ // Resolve the routing model. A `split` with >1 recipient uses separate charges
154
+ // & transfers (no application_fee; webhook engine creates the transfers); a
155
+ // single-recipient split is just a destination charge. `split` wins over
156
+ // `destinationAccountId`.
157
+ let isSeparate = false;
158
+ let destinationAccountId = opts.destinationAccountId;
159
+ if (opts.split && opts.split.length > 0) {
160
+ validateSplit(opts.split);
161
+ if (opts.split.length === 1) {
162
+ destinationAccountId = opts.split[0].destinationAccountId;
163
+ } else {
164
+ isSeparate = true;
165
+ }
166
+ }
167
+ // Metadata markers the webhook split engine reads to create the transfers.
168
+ // For subscriptions these live on the subscription and are consumed on each
169
+ // invoice.paid; for one-time payments they live on the PaymentIntent.
170
+ const separateMeta = isSeparate
171
+ ? {
172
+ bsChargeType: "separate",
173
+ bsSplit: JSON.stringify(opts.split),
174
+ ...(opts.feeConfig ? { bsFeeConfig: JSON.stringify(opts.feeConfig) } : {}),
175
+ }
176
+ : {};
177
+
178
+ // Strip the reserved `bs*` namespace from caller metadata so it can't forge
179
+ // webhook instructions (e.g. trigger split transfers without routing).
180
+ const metadata = {
181
+ ...stripReservedMetadata(opts.metadata),
182
+ userId: opts.userId,
183
+ ...(opts.orgId ? { orgId: opts.orgId } : {}),
184
+ };
185
+
186
+ // Per-store statement descriptor (BTS-32). Destination charges are platform
187
+ // charges (platform = merchant of record), so buyer recognition is
188
+ // suffix-based: the store's stored suffix, else the configured platform
189
+ // default. Resolved from the component account record at session creation.
190
+ let statementDescriptorSuffix: string | undefined;
191
+ if (destinationAccountId && !isSeparate && opts.mode !== "setup") {
192
+ const account = (await ctx.runQuery(
193
+ componentRef(component, "core/queries/getAccountByStripeId"),
194
+ { stripeAccountId: destinationAccountId },
195
+ )) as { statementDescriptor?: string } | null;
196
+ statementDescriptorSuffix =
197
+ account?.statementDescriptor ?? opts.defaultStatementDescriptorSuffix;
198
+ }
199
+
200
+ const sessionParams: CheckoutSessionCreateParams = {
201
+ mode: opts.mode,
202
+ line_items: [{ price: opts.stripePriceId, quantity: opts.quantity ?? 1 }],
203
+ metadata,
204
+ };
205
+
206
+ if (opts.mode === "subscription") {
207
+ const subscriptionData: CheckoutSessionCreateParams["subscription_data"] = {
208
+ metadata,
209
+ };
210
+ if (opts.trialDays) {
211
+ subscriptionData.trial_period_days = opts.trialDays;
212
+ }
213
+ if (isSeparate) {
214
+ // Separate charges & transfers: NO transfer_data / application_fee. The
215
+ // split is carried in metadata for the webhook engine to execute.
216
+ subscriptionData.metadata = { ...metadata, ...separateMeta };
217
+ } else if (destinationAccountId) {
218
+ // Single-recipient destination charge: route funds to the seller and take
219
+ // the platform's cut. Percent-only fees map to `application_fee_percent`;
220
+ // percent+fixed/tiered fees can't be expressed that way, so flag the
221
+ // subscription for per-invoice fee computation (handled by WEBHOOK_FEE).
222
+ subscriptionData.transfer_data = { destination: destinationAccountId };
223
+ if (opts.feeConfig) {
224
+ if (isPercentOnlyFee(opts.feeConfig)) {
225
+ subscriptionData.application_fee_percent = opts.feeConfig.percent;
226
+ } else {
227
+ subscriptionData.metadata = {
228
+ ...metadata,
229
+ bsFeeMode: "per_invoice",
230
+ bsFeeConfig: JSON.stringify(opts.feeConfig),
231
+ };
232
+ }
233
+ }
234
+ if (statementDescriptorSuffix) {
235
+ // Subscriptions can't carry a suffix directly; the invoice.created
236
+ // processor reads this marker and sets it on each invoice.
237
+ subscriptionData.metadata = {
238
+ ...(subscriptionData.metadata ?? metadata),
239
+ bsStatementDescriptor: statementDescriptorSuffix,
240
+ };
241
+ }
242
+ }
243
+ sessionParams.subscription_data = subscriptionData;
244
+ }
245
+
246
+ if (opts.mode === "payment") {
247
+ const paymentIntentData: CheckoutSessionCreateParams["payment_intent_data"] =
248
+ { metadata };
249
+ if (isSeparate) {
250
+ paymentIntentData.metadata = { ...metadata, ...separateMeta };
251
+ } else if (destinationAccountId) {
252
+ // Single-recipient destination charge for a one-time purchase. The platform
253
+ // fee is a fixed `application_fee_amount`: compute it when the amount is
254
+ // known; otherwise flag the PI with `bsFeeMode=per_charge` and the webhook
255
+ // collects it at payment_intent.succeeded via a partial reversal of the
256
+ // destination transfer, sized from the amount actually charged (BTS-60).
257
+ paymentIntentData.transfer_data = {
258
+ destination: destinationAccountId,
259
+ };
260
+ if (statementDescriptorSuffix) {
261
+ paymentIntentData.statement_descriptor_suffix =
262
+ statementDescriptorSuffix;
263
+ }
264
+ if (opts.feeConfig) {
265
+ if (opts.amount !== undefined) {
266
+ paymentIntentData.application_fee_amount = computeFee(
267
+ opts.amount,
268
+ opts.feeConfig,
269
+ ).feeAmount;
270
+ } else {
271
+ paymentIntentData.metadata = {
272
+ ...metadata,
273
+ bsFeeMode: "per_charge",
274
+ bsFeeConfig: JSON.stringify(opts.feeConfig),
275
+ };
276
+ }
277
+ }
278
+ }
279
+ sessionParams.payment_intent_data = paymentIntentData;
280
+ }
281
+
282
+ if (uiMode === "embedded") {
283
+ sessionParams.ui_mode = "embedded_page";
284
+ sessionParams.return_url = opts.returnUrl;
285
+ } else {
286
+ sessionParams.success_url = `${opts.returnUrl}?session_id={CHECKOUT_SESSION_ID}`;
287
+ sessionParams.cancel_url = opts.returnUrl;
288
+ }
289
+
290
+ if (opts.accountId) {
291
+ sessionParams.customer_account = opts.accountId;
292
+ } else if (opts.customerEmail) {
293
+ sessionParams.customer_email = opts.customerEmail;
294
+ }
295
+
296
+ // Merge overrides, then derive the persisted fee/routing row from the FINAL
297
+ // request — sessionOverrides can replace subscription_data/payment_intent_data
298
+ // wholesale, so the row must reflect what was actually sent to Stripe.
299
+ const finalSessionParams: CheckoutSessionCreateParams = {
300
+ ...sessionParams,
301
+ ...(opts.sessionOverrides as Partial<CheckoutSessionCreateParams>),
302
+ };
303
+ // Separate-charge sales persist the split + chargeType directly; single-recipient
304
+ // destination charges derive the row from the final transfer_data/fee.
305
+ const feeRow = isSeparate
306
+ ? { chargeType: "separate" as const, splitRecipients: opts.split }
307
+ : deriveFeeRow(finalSessionParams);
308
+
309
+ // Both destination and separate charges run on the platform account, so the
310
+ // price must be platform-owned. Validate the FINAL request (post-overrides) so
311
+ // callers can't inject transfer_data or swap line_items to bypass the check.
312
+ const finalPriceId = finalSessionParams.line_items?.[0]?.price;
313
+ if (
314
+ (isSeparate || feeRow.chargeType === "destination") &&
315
+ typeof finalPriceId === "string"
316
+ ) {
317
+ await assertPlatformPrice(component, ctx, finalPriceId);
318
+ }
319
+
320
+ const session = await stripe.checkout.sessions.create(finalSessionParams);
321
+
322
+ await runMutationOrThrow(
323
+ ctx,
324
+ componentRef(component, "billing/mutations/upsertCheckoutSession"),
325
+ {
326
+ stripeSessionId: session.id,
327
+ userId: opts.userId,
328
+ orgId: opts.orgId,
329
+ accountId: opts.accountId,
330
+ mode: finalSessionParams.mode,
331
+ status: (session.status ?? "open") as "open" | "complete" | "expired",
332
+ clientSecret: session.client_secret ?? undefined,
333
+ url: session.url ?? undefined,
334
+ priceId: opts.stripePriceId,
335
+ ...feeRow,
336
+ metadata,
337
+ },
338
+ );
339
+
340
+ return {
341
+ stripeSessionId: session.id,
342
+ clientSecret: session.client_secret ?? undefined,
343
+ url: session.url ?? undefined,
344
+ };
345
+ }
346
+
347
+ export async function getCheckoutSession(
348
+ component: Component,
349
+ ctx: RunCtx,
350
+ opts: { sessionId: string },
351
+ ): Promise<StripeComponentCheckoutSession | null> {
352
+ return (await ctx.runQuery(
353
+ componentRef(component, "billing/queries/getCheckoutSession"),
354
+ opts,
355
+ )) as StripeComponentCheckoutSession | null;
356
+ }
357
+
358
+ export async function getCheckoutSessionByStripeId(
359
+ component: Component,
360
+ ctx: RunCtx,
361
+ opts: { stripeSessionId: string },
362
+ ): Promise<StripeComponentCheckoutSession | null> {
363
+ return (await ctx.runQuery(
364
+ componentRef(component, "billing/queries/getCheckoutSessionByStripeId"),
365
+ opts,
366
+ )) as StripeComponentCheckoutSession | null;
367
+ }
368
+
369
+ export async function listCheckoutSessionsByUser(
370
+ component: Component,
371
+ ctx: RunCtx,
372
+ opts: { userId: string; status?: string },
373
+ ): Promise<StripeComponentCheckoutSession[]> {
374
+ return (await ctx.runQuery(
375
+ componentRef(component, "billing/queries/listCheckoutSessionsByUser"),
376
+ opts,
377
+ )) as StripeComponentCheckoutSession[];
378
+ }
379
+
380
+ export async function upsertCheckoutSession(
381
+ component: Component,
382
+ ctx: RunCtx,
383
+ opts: {
384
+ stripeSessionId: string;
385
+ userId: string;
386
+ orgId?: string;
387
+ accountId?: string;
388
+ mode: "payment" | "subscription" | "setup";
389
+ status: "open" | "complete" | "expired";
390
+ clientSecret?: string;
391
+ url?: string;
392
+ priceId?: string;
393
+ metadata?: Record<string, unknown>;
394
+ },
395
+ ) {
396
+ await runMutationOrThrow(
397
+ ctx,
398
+ componentRef(component, "billing/mutations/upsertCheckoutSession"),
399
+ opts,
400
+ );
401
+ return null;
402
+ }
403
+
404
+ export async function updateCheckoutSession(
405
+ stripe: Stripe,
406
+ _ctx: RunCtx,
407
+ opts: {
408
+ stripeSessionId: string;
409
+ metadata?: Record<string, string>;
410
+ },
411
+ ) {
412
+ const session = await stripe.checkout.sessions.update(opts.stripeSessionId, {
413
+ metadata: opts.metadata,
414
+ });
415
+ return session;
416
+ }
@@ -0,0 +1,237 @@
1
+ /**
2
+ * Tests for the invoice methods. These are thin wrappers over component
3
+ * queries/mutations and one Stripe SDK call, but each carries real behavior
4
+ * worth pinning: `listInvoices` renames `stripeAccountId` → `accountId` and
5
+ * only forwards it when defined; `listInvoicesByUser` forwards a single field;
6
+ * `upsertInvoice` routes through `runMutationOrThrow` (which guards on
7
+ * `ctx.runMutation`) and returns null; `getInvoice` queries by stripe id and
8
+ * passes through null; `getInvoiceFromStripe` delegates to the SDK. Tests
9
+ * assert the exact ref resolved, the exact params forwarded, and the returned
10
+ * shape for every branch.
11
+ */
12
+ import { describe, expect, it, vi } from "vitest";
13
+
14
+ import type { Component, RunCtx } from "../helpers.js";
15
+ import {
16
+ getInvoice,
17
+ getInvoiceFromStripe,
18
+ listInvoices,
19
+ listInvoicesByUser,
20
+ upsertInvoice,
21
+ } from "./invoices.js";
22
+
23
+ const TO_REF = Symbol.for("toReferencePath");
24
+
25
+ /** Component proxy exposing the billing invoice refs these functions resolve. */
26
+ function makeComponent(): Component {
27
+ const ref = (path: string) => ({ [TO_REF]: `betterStripe/${path}` });
28
+ return {
29
+ billing: {
30
+ queries: {
31
+ getInvoiceByStripeId: ref("billing/queries/getInvoiceByStripeId"),
32
+ listInvoices: ref("billing/queries/listInvoices"),
33
+ },
34
+ mutations: {
35
+ upsertInvoice: ref("billing/mutations/upsertInvoice"),
36
+ },
37
+ },
38
+ } as unknown as Component;
39
+ }
40
+
41
+ function refPath(component: Component, path: string): string {
42
+ const parts = path.split("/");
43
+ let node: any = component;
44
+ for (const part of parts) node = node?.[part];
45
+ return node[TO_REF];
46
+ }
47
+
48
+ function makeCtx(queryResult?: unknown) {
49
+ return {
50
+ runQuery: vi.fn().mockResolvedValue(queryResult),
51
+ runMutation: vi.fn().mockResolvedValue(undefined),
52
+ } as unknown as RunCtx & {
53
+ runQuery: ReturnType<typeof vi.fn>;
54
+ runMutation: ReturnType<typeof vi.fn>;
55
+ };
56
+ }
57
+
58
+ function makeStripe() {
59
+ return {
60
+ invoices: {
61
+ retrieve: vi.fn(),
62
+ },
63
+ };
64
+ }
65
+
66
+ const asStripe = (s: ReturnType<typeof makeStripe>) =>
67
+ s as unknown as Parameters<typeof getInvoiceFromStripe>[0];
68
+
69
+ describe("listInvoices", () => {
70
+ it("resolves the listInvoices query ref and defaults opts to an empty arg object", async () => {
71
+ const component = makeComponent();
72
+ const ctx = makeCtx([]);
73
+
74
+ const result = await listInvoices(component, ctx);
75
+
76
+ expect(result).toEqual([]);
77
+ const [ref, args] = ctx.runQuery.mock.calls[0];
78
+ expect(ref[TO_REF]).toBe(refPath(component, "billing/queries/listInvoices"));
79
+ expect(args).toEqual({});
80
+ });
81
+
82
+ it("renames stripeAccountId to accountId and forwards the other filters", async () => {
83
+ const rows = [{ stripeInvoiceId: "in_1" }];
84
+ const ctx = makeCtx(rows);
85
+
86
+ const result = await listInvoices(makeComponent(), ctx, {
87
+ stripeAccountId: "acct_123",
88
+ userId: "user_1",
89
+ subscriptionId: "sub_1",
90
+ status: "paid",
91
+ limit: 10,
92
+ });
93
+
94
+ expect(result).toBe(rows);
95
+ const [, args] = ctx.runQuery.mock.calls[0];
96
+ expect(args).toEqual({
97
+ userId: "user_1",
98
+ subscriptionId: "sub_1",
99
+ status: "paid",
100
+ limit: 10,
101
+ accountId: "acct_123",
102
+ });
103
+ // the original stripeAccountId key must not leak through
104
+ expect(args).not.toHaveProperty("stripeAccountId");
105
+ });
106
+
107
+ it("omits accountId entirely when stripeAccountId is undefined", async () => {
108
+ const ctx = makeCtx([]);
109
+
110
+ await listInvoices(makeComponent(), ctx, { userId: "user_2", limit: 5 });
111
+
112
+ const [, args] = ctx.runQuery.mock.calls[0];
113
+ expect(args).toEqual({ userId: "user_2", limit: 5 });
114
+ expect(args).not.toHaveProperty("accountId");
115
+ });
116
+ });
117
+
118
+ describe("listInvoicesByUser", () => {
119
+ it("queries listInvoices with only the userId and returns the rows", async () => {
120
+ const component = makeComponent();
121
+ const rows = [{ stripeInvoiceId: "in_2" }];
122
+ const ctx = makeCtx(rows);
123
+
124
+ const result = await listInvoicesByUser(component, ctx, { userId: "u_9" });
125
+
126
+ expect(result).toBe(rows);
127
+ const [ref, args] = ctx.runQuery.mock.calls[0];
128
+ expect(ref[TO_REF]).toBe(refPath(component, "billing/queries/listInvoices"));
129
+ expect(args).toEqual({ userId: "u_9" });
130
+ });
131
+ });
132
+
133
+ describe("upsertInvoice", () => {
134
+ const baseOpts = {
135
+ stripeInvoiceId: "in_3",
136
+ userId: "u_1",
137
+ status: "open" as const,
138
+ currency: "usd",
139
+ amountDue: 2000,
140
+ amountPaid: 0,
141
+ };
142
+
143
+ it("runs the upsert mutation with the full opts and returns null", async () => {
144
+ const component = makeComponent();
145
+ const ctx = makeCtx();
146
+
147
+ const result = await upsertInvoice(component, ctx, baseOpts);
148
+
149
+ expect(result).toBeNull();
150
+ const [ref, args] = ctx.runMutation.mock.calls[0];
151
+ expect(ref[TO_REF]).toBe(
152
+ refPath(component, "billing/mutations/upsertInvoice"),
153
+ );
154
+ expect(args).toEqual(baseOpts);
155
+ });
156
+
157
+ it("forwards every optional field verbatim to the mutation", async () => {
158
+ const ctx = makeCtx();
159
+ const opts = {
160
+ ...baseOpts,
161
+ orgId: "org_1",
162
+ accountId: "acct_1",
163
+ subscriptionId: "sub_1",
164
+ hostedInvoiceUrl: "https://stripe.test/inv",
165
+ invoicePdf: "https://stripe.test/inv.pdf",
166
+ periodStart: "2026-01-01T00:00:00.000Z",
167
+ periodEnd: "2026-02-01T00:00:00.000Z",
168
+ metadata: { tier: "pro" },
169
+ };
170
+
171
+ await upsertInvoice(makeComponent(), ctx, opts);
172
+
173
+ const [, args] = ctx.runMutation.mock.calls[0];
174
+ expect(args).toEqual(opts);
175
+ });
176
+
177
+ it("throws when ctx has no runMutation (runMutationOrThrow guard)", async () => {
178
+ const ctx = { runQuery: vi.fn() } as unknown as RunCtx;
179
+
180
+ await expect(
181
+ upsertInvoice(makeComponent(), ctx, baseOpts),
182
+ ).rejects.toThrow(/requires a Convex ctx with runMutation/);
183
+ });
184
+ });
185
+
186
+ describe("getInvoice", () => {
187
+ it("queries getInvoiceByStripeId and returns the matched row", async () => {
188
+ const component = makeComponent();
189
+ const row = { stripeInvoiceId: "in_4", status: "paid" };
190
+ const ctx = makeCtx(row);
191
+
192
+ const result = await getInvoice(component, ctx, { stripeInvoiceId: "in_4" });
193
+
194
+ expect(result).toBe(row);
195
+ const [ref, args] = ctx.runQuery.mock.calls[0];
196
+ expect(ref[TO_REF]).toBe(
197
+ refPath(component, "billing/queries/getInvoiceByStripeId"),
198
+ );
199
+ expect(args).toEqual({ stripeInvoiceId: "in_4" });
200
+ });
201
+
202
+ it("passes through null when no invoice matches", async () => {
203
+ const ctx = makeCtx(null);
204
+
205
+ const result = await getInvoice(makeComponent(), ctx, {
206
+ stripeInvoiceId: "in_missing",
207
+ });
208
+
209
+ expect(result).toBeNull();
210
+ });
211
+ });
212
+
213
+ describe("getInvoiceFromStripe", () => {
214
+ it("retrieves the invoice from the Stripe SDK and returns it", async () => {
215
+ const stripe = makeStripe();
216
+ const invoice = { id: "in_5", status: "paid" };
217
+ stripe.invoices.retrieve.mockResolvedValue(invoice);
218
+ const ctx = makeCtx();
219
+
220
+ const result = await getInvoiceFromStripe(asStripe(stripe), ctx, {
221
+ stripeInvoiceId: "in_5",
222
+ });
223
+
224
+ expect(result).toBe(invoice);
225
+ expect(stripe.invoices.retrieve).toHaveBeenCalledWith("in_5");
226
+ });
227
+
228
+ it("propagates errors thrown by the Stripe SDK", async () => {
229
+ const stripe = makeStripe();
230
+ stripe.invoices.retrieve.mockRejectedValue(new Error("no such invoice"));
231
+ const ctx = makeCtx();
232
+
233
+ await expect(
234
+ getInvoiceFromStripe(asStripe(stripe), ctx, { stripeInvoiceId: "in_x" }),
235
+ ).rejects.toThrow("no such invoice");
236
+ });
237
+ });