@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,302 @@
1
+ import type Stripe from "stripe";
2
+
3
+ import type { DisputeStatus } from "../../component/connect/validators.js";
4
+ import { throwStripeError } from "../errors.js";
5
+ import type { Component, RunCtx } from "../helpers.js";
6
+ import type {
7
+ StripeComponentDispute,
8
+ StripeComponentPayment,
9
+ } from "../types.js";
10
+ import { componentRef } from "../webhooks/helpers.js";
11
+ import { type RefundActor, isRefundAuthorized } from "./refundActor.js";
12
+
13
+ export type { RefundActor } from "./refundActor.js";
14
+
15
+ // =============================================================================
16
+ // Dispute methods
17
+ //
18
+ // Disputes are created by Stripe (never by the app); the app responds by
19
+ // submitting evidence or accepting (closing) the dispute. Component DB state
20
+ // is synced from `charge.dispute.*` webhooks — these writes return only an ack.
21
+ // =============================================================================
22
+
23
+ export async function getDisputeByStripeId(
24
+ component: Component,
25
+ ctx: RunCtx,
26
+ opts: { stripeDisputeId: string },
27
+ ): Promise<StripeComponentDispute | null> {
28
+ return (await ctx.runQuery(
29
+ componentRef(component, "connect/queries/getDisputeByStripeId"),
30
+ opts,
31
+ )) as StripeComponentDispute | null;
32
+ }
33
+
34
+ /**
35
+ * Read a dispute and attach its evidence-submission countdown (BTS-31) — the
36
+ * one-call surface a seller UI needs: `evidenceDueBy` plus days-remaining /
37
+ * overdue. Returns null if the dispute isn't found.
38
+ */
39
+ export async function getDisputeWithCountdown(
40
+ component: Component,
41
+ ctx: RunCtx,
42
+ opts: { stripeDisputeId: string; now?: Date },
43
+ ): Promise<
44
+ | (StripeComponentDispute & {
45
+ countdown: ReturnType<typeof disputeEvidenceCountdown>;
46
+ })
47
+ | null
48
+ > {
49
+ const dispute = await getDisputeByStripeId(component, ctx, {
50
+ stripeDisputeId: opts.stripeDisputeId,
51
+ });
52
+ if (!dispute) return null;
53
+ return {
54
+ ...dispute,
55
+ countdown: disputeEvidenceCountdown(dispute.evidenceDueBy, opts.now),
56
+ };
57
+ }
58
+
59
+ export async function listDisputes(
60
+ component: Component,
61
+ ctx: RunCtx,
62
+ opts?: {
63
+ stripeAccountId?: string;
64
+ stripePaymentIntentId?: string;
65
+ status?: DisputeStatus;
66
+ limit?: number;
67
+ },
68
+ ): Promise<StripeComponentDispute[]> {
69
+ const { stripeAccountId, ...rest } = opts ?? {};
70
+ return (await ctx.runQuery(
71
+ componentRef(component, "connect/queries/listDisputes"),
72
+ {
73
+ ...rest,
74
+ ...(stripeAccountId !== undefined ? { accountId: stripeAccountId } : {}),
75
+ },
76
+ )) as StripeComponentDispute[];
77
+ }
78
+
79
+ /**
80
+ * Submit or stage dispute evidence.
81
+ *
82
+ * ⚠️ Stripe's dispute-update `submit` parameter is documented as DEFAULTING TO
83
+ * TRUE, and submission is effectively one-shot and affects the dispute
84
+ * outcome. To avoid that trap, this method **never omits `submit`**: every
85
+ * call sends an explicit `submit: false` unless the caller passes
86
+ * `submit: true` to finalize and send the response to the bank (BTS-61,
87
+ * BTS-72). So no `updateDispute` call — evidence, metadata, or both — can
88
+ * ever implicitly submit staged evidence.
89
+ *
90
+ * Verified against the Stripe API (test mode, 2026-07-03): an update carrying
91
+ * `evidence` with no `submit` key IS submitted (the documented default), while
92
+ * a metadata-only update with no `submit` key does NOT submit previously
93
+ * staged evidence — and `submit: false` is accepted alongside any update,
94
+ * including on a dispute whose evidence was already submitted (no state
95
+ * change). We still send it explicitly rather than lean on the undocumented
96
+ * metadata-only leniency.
97
+ *
98
+ * Actor scoping (BTS-107): pass `actor` to gate WHO may act on the dispute,
99
+ * mirroring {@link createRefund}. A platform admin may act on any dispute; a
100
+ * seller may act only on a dispute whose sale was routed to their own account.
101
+ * Enforced BEFORE the Stripe call, so an unauthorized submit never reaches the
102
+ * bank. Omit `actor` to preserve the pre-BTS-107 unrestricted behavior.
103
+ */
104
+ export async function updateDispute(
105
+ stripe: Stripe,
106
+ component: Component,
107
+ ctx: RunCtx,
108
+ opts: {
109
+ stripeDisputeId: string;
110
+ evidence?: Stripe.DisputeUpdateParams.Evidence;
111
+ metadata?: Record<string, string>;
112
+ submit?: boolean;
113
+ stripeAccountId?: string;
114
+ /**
115
+ * Who is initiating the dispute action (BTS-107). Mirrors {@link RefundActor}:
116
+ * a platform admin (`{ type: "admin" }`) may act on any dispute; a seller
117
+ * (`{ type: "seller", accountId }`) may act only on a dispute for a sale
118
+ * routed to their own account (the destination-charge seller or the split
119
+ * sale's `store` leg). Omit for platform-initiated (unrestricted) actions.
120
+ */
121
+ actor?: RefundActor;
122
+ },
123
+ ): Promise<{ success: true }> {
124
+ // Actor scoping (BTS-107): enforce BEFORE the Stripe call, so an unauthorized
125
+ // seller can never submit evidence to the bank on another account's dispute.
126
+ await assertDisputeAuthorized(component, ctx, opts);
127
+
128
+ // Stage-by-default, on EVERY call: an omitted `submit` must never inherit
129
+ // Stripe's server-side default (documented true). BTS-61 covered the
130
+ // evidence path; BTS-72 extends it to metadata-only updates, so no request
131
+ // shape can implicitly submit staged evidence.
132
+ const submit = opts.submit ?? false;
133
+ try {
134
+ await stripe.disputes.update(
135
+ opts.stripeDisputeId,
136
+ {
137
+ ...(opts.evidence ? { evidence: opts.evidence } : {}),
138
+ ...(opts.metadata ? { metadata: opts.metadata } : {}),
139
+ submit,
140
+ },
141
+ opts.stripeAccountId
142
+ ? { stripeAccount: opts.stripeAccountId }
143
+ : undefined,
144
+ );
145
+ return { success: true };
146
+ } catch (err) {
147
+ throwStripeError("DISPUTE_UPDATE_FAILED", "Failed to update dispute", err);
148
+ }
149
+ }
150
+
151
+ /**
152
+ * Accept a dispute (concede the chargeback). Irreversible.
153
+ *
154
+ * Actor scoping (BTS-107): pass `actor` to gate WHO may concede, mirroring
155
+ * {@link updateDispute} and {@link createRefund}. Enforced BEFORE the Stripe
156
+ * call — conceding is irreversible, so an unauthorized seller must never be
157
+ * able to concede another account's dispute. Omit `actor` for the pre-BTS-107
158
+ * unrestricted behavior.
159
+ */
160
+ export async function closeDispute(
161
+ stripe: Stripe,
162
+ component: Component,
163
+ ctx: RunCtx,
164
+ opts: {
165
+ stripeDisputeId: string;
166
+ stripeAccountId?: string;
167
+ /** See {@link updateDispute}'s `actor` (BTS-107). Omit for unrestricted. */
168
+ actor?: RefundActor;
169
+ },
170
+ ): Promise<{ success: true }> {
171
+ // Actor scoping (BTS-107): enforce BEFORE the (irreversible) concede.
172
+ await assertDisputeAuthorized(component, ctx, opts);
173
+
174
+ try {
175
+ await stripe.disputes.close(
176
+ opts.stripeDisputeId,
177
+ {},
178
+ opts.stripeAccountId
179
+ ? { stripeAccount: opts.stripeAccountId }
180
+ : undefined,
181
+ );
182
+ return { success: true };
183
+ } catch (err) {
184
+ throwStripeError("DISPUTE_UPDATE_FAILED", "Failed to close dispute", err);
185
+ }
186
+ }
187
+
188
+ /**
189
+ * Enforce dispute-action actor scoping (BTS-107). Resolves the dispute from the
190
+ * component's `disputes` ledger, then the `payments` row it links to (via the
191
+ * dispute's `stripePaymentIntentId`), and rejects a seller-initiated action
192
+ * unless that seller is the sale's merchant — the destination-charge seller or
193
+ * the split sale's `store` leg. Reuses {@link isRefundAuthorized} so refunds
194
+ * and dispute actions can never drift on who owns a sale. Fails closed: a
195
+ * missing dispute, an unlinked dispute (no PaymentIntent), or a missing payment
196
+ * denies a seller rather than allowing them. No-ops for admin / omitted actors.
197
+ */
198
+ async function assertDisputeAuthorized(
199
+ component: Component,
200
+ ctx: RunCtx,
201
+ opts: { stripeDisputeId: string; actor?: RefundActor },
202
+ ): Promise<void> {
203
+ const { actor } = opts;
204
+ if (!actor || actor.type === "admin") return; // unrestricted
205
+
206
+ const dispute = await getDisputeByStripeId(component, ctx, {
207
+ stripeDisputeId: opts.stripeDisputeId,
208
+ });
209
+ if (!dispute) {
210
+ throwStripeError(
211
+ "DISPUTE_UNAUTHORIZED",
212
+ `Dispute action not authorized: no dispute found for ${opts.stripeDisputeId} to verify sale ownership`,
213
+ );
214
+ }
215
+
216
+ // The dispute row is keyed to its sale by PaymentIntent — the same key that
217
+ // keys the payments ledger. A dispute with no linked PaymentIntent (legacy
218
+ // charge-only) can't be verified, so a seller is denied (fail closed).
219
+ const piId = dispute.stripePaymentIntentId;
220
+ if (!piId) {
221
+ throwStripeError(
222
+ "DISPUTE_UNAUTHORIZED",
223
+ `Dispute action not authorized: dispute ${opts.stripeDisputeId} has no linked PaymentIntent to verify sale ownership`,
224
+ );
225
+ }
226
+
227
+ const payment = (await ctx.runQuery(
228
+ componentRef(component, "connect/queries/getPaymentByStripeId"),
229
+ { stripePaymentIntentId: piId },
230
+ )) as StripeComponentPayment | null;
231
+ if (!payment) {
232
+ throwStripeError(
233
+ "DISPUTE_UNAUTHORIZED",
234
+ `Dispute action not authorized: no payment found for ${piId} to verify sale ownership`,
235
+ );
236
+ }
237
+
238
+ if (
239
+ !isRefundAuthorized(actor, {
240
+ destinationAccountId: payment.destinationAccountId,
241
+ splitRecipients: payment.splitRecipients,
242
+ })
243
+ ) {
244
+ throwStripeError(
245
+ "DISPUTE_UNAUTHORIZED",
246
+ `Dispute action not authorized: seller ${actor.accountId} may not act on a dispute for a sale routed to another account`,
247
+ );
248
+ }
249
+ }
250
+
251
+ /**
252
+ * Map Skool-style evidence categories to Stripe dispute evidence fields (BTS-31),
253
+ * so a seller's UI can collect plain-language fields. Unset categories are
254
+ * omitted. Pass the result as `evidence` to {@link updateDispute}.
255
+ */
256
+ export function buildDisputeEvidence(input: {
257
+ /** What the buyer purchased (Stripe: product_description). */
258
+ productDescription?: string;
259
+ /** The buyer's usage/access record (Stripe: access_activity_log). */
260
+ accessActivity?: string;
261
+ /** Off-platform context / anything else (Stripe: uncategorized_text). */
262
+ additionalInfo?: string;
263
+ /** Communications with the buyer (Stripe: customer_communication). */
264
+ customerCommunication?: string;
265
+ }): import("stripe").Stripe.DisputeUpdateParams.Evidence {
266
+ return {
267
+ ...(input.productDescription
268
+ ? { product_description: input.productDescription }
269
+ : {}),
270
+ ...(input.accessActivity
271
+ ? { access_activity_log: input.accessActivity }
272
+ : {}),
273
+ ...(input.additionalInfo
274
+ ? { uncategorized_text: input.additionalInfo }
275
+ : {}),
276
+ ...(input.customerCommunication
277
+ ? { customer_communication: input.customerCommunication }
278
+ : {}),
279
+ };
280
+ }
281
+
282
+ /**
283
+ * Compute the evidence-submission countdown for a dispute (BTS-31) from the
284
+ * stored `evidenceDueBy` (ISO). Returns whole days remaining (rounded up) and an
285
+ * overdue flag for the seller's UI. `daysRemaining` is undefined when there's no
286
+ * due date.
287
+ */
288
+ export function disputeEvidenceCountdown(
289
+ evidenceDueBy: string | undefined,
290
+ now: Date = new Date(),
291
+ ): { dueBy?: string; daysRemaining?: number; isOverdue: boolean } {
292
+ if (!evidenceDueBy) return { dueBy: undefined, isOverdue: false };
293
+ const dueMs = new Date(evidenceDueBy).getTime();
294
+ // A malformed/legacy value parses to NaN — fall back cleanly, not NaN days.
295
+ if (Number.isNaN(dueMs)) return { dueBy: undefined, isOverdue: false };
296
+ const diffMs = dueMs - now.getTime();
297
+ return {
298
+ dueBy: evidenceDueBy,
299
+ daysRemaining: Math.ceil(diffMs / 86_400_000),
300
+ isOverdue: diffMs < 0,
301
+ };
302
+ }
@@ -0,0 +1,83 @@
1
+ import type Stripe from "stripe";
2
+ import { describe, expect, it } from "vitest";
3
+
4
+ import {
5
+ getPaymentMethodCard,
6
+ getPaymentMethodOwner,
7
+ } from "./paymentMethodUtils.js";
8
+
9
+ describe("getPaymentMethodOwner", () => {
10
+ it("returns customer_account when present (V2)", () => {
11
+ const pm = { customer_account: "acct_v2_123" } as Stripe.PaymentMethod;
12
+ expect(getPaymentMethodOwner(pm)).toBe("acct_v2_123");
13
+ });
14
+
15
+ it("returns string customer when no customer_account", () => {
16
+ const pm = {
17
+ customer: "cus_legacy_123",
18
+ customer_account: null,
19
+ } as unknown as Stripe.PaymentMethod;
20
+ expect(getPaymentMethodOwner(pm)).toBe("cus_legacy_123");
21
+ });
22
+
23
+ it("returns customer.id for expanded customer object", () => {
24
+ const pm = {
25
+ customer: { id: "cus_expanded" },
26
+ customer_account: null,
27
+ } as unknown as Stripe.PaymentMethod;
28
+ expect(getPaymentMethodOwner(pm)).toBe("cus_expanded");
29
+ });
30
+
31
+ it("returns null when no owner info", () => {
32
+ const pm = {
33
+ customer: null,
34
+ customer_account: null,
35
+ } as unknown as Stripe.PaymentMethod;
36
+ expect(getPaymentMethodOwner(pm)).toBeNull();
37
+ });
38
+ });
39
+
40
+ describe("getPaymentMethodCard", () => {
41
+ it("extracts card data", () => {
42
+ const pm = {
43
+ card: {
44
+ brand: "visa",
45
+ last4: "4242",
46
+ exp_month: 12,
47
+ exp_year: 2030,
48
+ },
49
+ } as unknown as Stripe.PaymentMethod;
50
+
51
+ const card = getPaymentMethodCard(pm);
52
+ expect(card).toEqual({
53
+ brand: "visa",
54
+ last4: "4242",
55
+ expMonth: 12,
56
+ expYear: 2030,
57
+ });
58
+ });
59
+
60
+ it("returns undefined when no card", () => {
61
+ const pm = { card: null } as unknown as Stripe.PaymentMethod;
62
+ expect(getPaymentMethodCard(pm)).toBeUndefined();
63
+ });
64
+
65
+ it("handles missing card fields with defaults", () => {
66
+ const pm = {
67
+ card: {
68
+ brand: null,
69
+ last4: null,
70
+ exp_month: null,
71
+ exp_year: null,
72
+ },
73
+ } as unknown as Stripe.PaymentMethod;
74
+
75
+ const card = getPaymentMethodCard(pm);
76
+ expect(card).toEqual({
77
+ brand: "",
78
+ last4: "",
79
+ expMonth: 0,
80
+ expYear: 0,
81
+ });
82
+ });
83
+ });
@@ -0,0 +1,28 @@
1
+ import type Stripe from "stripe";
2
+
3
+ import { resolveOwnerAccount } from "../utils/owner.js";
4
+
5
+ /**
6
+ * Return the owner of a payment method, checking V2 `customer_account` first,
7
+ * then falling back to the legacy `customer` field.
8
+ */
9
+ export function getPaymentMethodOwner(pm: Stripe.PaymentMethod): string | null {
10
+ return resolveOwnerAccount(pm);
11
+ }
12
+
13
+ /**
14
+ * Extract a normalized card object from a payment method.
15
+ * Returns undefined if the method has no card data.
16
+ */
17
+ export function getPaymentMethodCard(method: Stripe.PaymentMethod) {
18
+ if (!method.card) {
19
+ return undefined;
20
+ }
21
+
22
+ return {
23
+ brand: method.card.brand ?? "",
24
+ last4: method.card.last4 ?? "",
25
+ expMonth: method.card.exp_month ?? 0,
26
+ expYear: method.card.exp_year ?? 0,
27
+ };
28
+ }
@@ -0,0 +1,66 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+
3
+ import type { RunCtx } from "../helpers.js";
4
+ import {
5
+ attachPaymentMethod,
6
+ detachPaymentMethod,
7
+ listPaymentMethods,
8
+ } from "./paymentMethods.js";
9
+
10
+ function makeStripe() {
11
+ return {
12
+ paymentMethods: {
13
+ attach: vi.fn().mockResolvedValue({}),
14
+ detach: vi.fn().mockResolvedValue({}),
15
+ list: vi.fn().mockResolvedValue({ data: [{ id: "pm_1" }] }),
16
+ },
17
+ };
18
+ }
19
+ const asStripe = (s: ReturnType<typeof makeStripe>) =>
20
+ s as unknown as Parameters<typeof listPaymentMethods>[0];
21
+ const ctx = {} as RunCtx;
22
+
23
+ /**
24
+ * BTS-19: a buyer's payment profile lives on their V2 `customer_account`, not on
25
+ * any store. These tests pin that payment methods are keyed to the account
26
+ * (`customer_account`), so the same saved card is reusable across every seller
27
+ * checkout regardless of the transfer destination.
28
+ */
29
+ describe("payment methods are keyed to the customer_account (BTS-19 reuse)", () => {
30
+ it("attaches a payment method to the customer_account, not a store", async () => {
31
+ const stripe = makeStripe();
32
+ await attachPaymentMethod(asStripe(stripe), ctx, {
33
+ paymentMethodId: "pm_1",
34
+ stripeCustomerId: "acct_buyer",
35
+ });
36
+ expect(stripe.paymentMethods.attach).toHaveBeenCalledWith("pm_1", {
37
+ customer_account: "acct_buyer",
38
+ });
39
+ });
40
+
41
+ it("lists the same account-level methods regardless of store", async () => {
42
+ const stripe = makeStripe();
43
+ const a = await listPaymentMethods(asStripe(stripe), ctx, {
44
+ stripeCustomerId: "acct_buyer",
45
+ });
46
+ const b = await listPaymentMethods(asStripe(stripe), ctx, {
47
+ stripeCustomerId: "acct_buyer",
48
+ });
49
+ // Both lookups query by customer_account — no store/destination scoping.
50
+ expect(stripe.paymentMethods.list).toHaveBeenNthCalledWith(1, {
51
+ customer_account: "acct_buyer",
52
+ type: "card",
53
+ });
54
+ expect(stripe.paymentMethods.list).toHaveBeenNthCalledWith(2, {
55
+ customer_account: "acct_buyer",
56
+ type: "card",
57
+ });
58
+ expect(a).toEqual(b);
59
+ });
60
+
61
+ it("detaches a payment method by id", async () => {
62
+ const stripe = makeStripe();
63
+ await detachPaymentMethod(asStripe(stripe), ctx, { paymentMethodId: "pm_1" });
64
+ expect(stripe.paymentMethods.detach).toHaveBeenCalledWith("pm_1");
65
+ });
66
+ });
@@ -0,0 +1,55 @@
1
+ import type Stripe from "stripe";
2
+
3
+ import type { RunCtx } from "../helpers.js";
4
+ import { throwStripeError } from "../errors.js";
5
+
6
+ // =============================================================================
7
+ // Payment Method methods
8
+ // =============================================================================
9
+
10
+ export async function listPaymentMethods(
11
+ stripe: Stripe,
12
+ _ctx: RunCtx,
13
+ opts: { stripeCustomerId: string; type?: string },
14
+ ) {
15
+ const methods = await stripe.paymentMethods.list({
16
+ customer_account: opts.stripeCustomerId,
17
+ type: (opts.type as Stripe.PaymentMethodListParams.Type) ?? "card",
18
+ });
19
+ return methods.data;
20
+ }
21
+
22
+ export async function getPaymentMethod(
23
+ stripe: Stripe,
24
+ _ctx: RunCtx,
25
+ opts: { paymentMethodId: string },
26
+ ) {
27
+ return await stripe.paymentMethods.retrieve(opts.paymentMethodId);
28
+ }
29
+
30
+ export async function attachPaymentMethod(
31
+ stripe: Stripe,
32
+ _ctx: RunCtx,
33
+ opts: { paymentMethodId: string; stripeCustomerId: string },
34
+ ) {
35
+ await stripe.paymentMethods.attach(opts.paymentMethodId, {
36
+ customer_account: opts.stripeCustomerId,
37
+ });
38
+ return { success: true };
39
+ }
40
+
41
+ export async function detachPaymentMethod(
42
+ stripe: Stripe,
43
+ _ctx: RunCtx,
44
+ opts: { paymentMethodId: string },
45
+ ) {
46
+ return await stripe.paymentMethods.detach(opts.paymentMethodId);
47
+ }
48
+
49
+ export async function setDefaultPaymentMethod(
50
+ _stripe: Stripe,
51
+ _ctx: RunCtx,
52
+ _opts: { stripeAccountId: string; paymentMethodId: string },
53
+ ) {
54
+ throwStripeError("PAYMENT_METHOD_FAILED", "[better-stripe] setDefaultPaymentMethod is not yet implemented for V2 Accounts. Use createBillingPortalSession() to let users manage payment methods.");
55
+ }
@@ -0,0 +1,132 @@
1
+ // @vitest-environment edge-runtime
2
+ /**
3
+ * Tests for getAccountBalance (BTS-65): a per-account balance read that wraps
4
+ * `stripe.balance.retrieve` with `Stripe-Account` header scoping and pairs
5
+ * Stripe's separate `available` / `pending` currency lists into one
6
+ * `{ available, pending, currency }` entry per currency (minor units) — the
7
+ * shape the headless `PayoutSchedule` component's `balance` prop consumes.
8
+ */
9
+ import type Stripe from "stripe";
10
+ import { describe, expect, it, vi } from "vitest";
11
+
12
+ import type { RunCtx } from "../helpers.js";
13
+ import { createPayout, getAccountBalance } from "./payouts.js";
14
+
15
+ /** A Stripe stub whose balance.retrieve resolves the given balance object. */
16
+ function makeStripe(balance: {
17
+ available: { amount: number; currency: string }[];
18
+ pending: { amount: number; currency: string }[];
19
+ }) {
20
+ return {
21
+ balance: {
22
+ retrieve: vi.fn().mockResolvedValue({ object: "balance", ...balance }),
23
+ },
24
+ payouts: {
25
+ create: vi.fn().mockResolvedValue({ id: "po_1" }),
26
+ },
27
+ };
28
+ }
29
+ const asStripe = (s: ReturnType<typeof makeStripe>) => s as unknown as Stripe;
30
+ const noCtx = {} as RunCtx;
31
+
32
+ describe("getAccountBalance (BTS-65)", () => {
33
+ it("scopes the balance read to the connected account via the Stripe-Account header", async () => {
34
+ const stripe = makeStripe({
35
+ available: [{ amount: 12550, currency: "usd" }],
36
+ pending: [{ amount: 4300, currency: "usd" }],
37
+ });
38
+
39
+ await getAccountBalance(asStripe(stripe), {
40
+ stripeAccountId: "acct_seller",
41
+ });
42
+
43
+ expect(stripe.balance.retrieve).toHaveBeenCalledWith(undefined, {
44
+ stripeAccount: "acct_seller",
45
+ });
46
+ });
47
+
48
+ it("pairs available and pending by currency into one entry per currency", async () => {
49
+ const stripe = makeStripe({
50
+ available: [{ amount: 12550, currency: "usd" }],
51
+ pending: [{ amount: 4300, currency: "usd" }],
52
+ });
53
+
54
+ const balances = await getAccountBalance(asStripe(stripe), {
55
+ stripeAccountId: "acct_seller",
56
+ });
57
+
58
+ expect(balances).toEqual([
59
+ { available: 12550, pending: 4300, currency: "usd" },
60
+ ]);
61
+ });
62
+
63
+ it("returns one entry per currency for a multi-currency account", async () => {
64
+ const stripe = makeStripe({
65
+ available: [
66
+ { amount: 12550, currency: "usd" },
67
+ { amount: 900, currency: "eur" },
68
+ ],
69
+ pending: [
70
+ { amount: 4300, currency: "usd" },
71
+ { amount: 100, currency: "eur" },
72
+ ],
73
+ });
74
+
75
+ const balances = await getAccountBalance(asStripe(stripe), {
76
+ stripeAccountId: "acct_seller",
77
+ });
78
+
79
+ expect(balances).toEqual([
80
+ { available: 12550, pending: 4300, currency: "usd" },
81
+ { available: 900, pending: 100, currency: "eur" },
82
+ ]);
83
+ });
84
+
85
+ it("defaults the missing side to 0 when a currency appears in only one list", async () => {
86
+ const stripe = makeStripe({
87
+ available: [{ amount: 12550, currency: "usd" }],
88
+ // Pending carries a currency that has no available funds yet.
89
+ pending: [{ amount: 700, currency: "gbp" }],
90
+ });
91
+
92
+ const balances = await getAccountBalance(asStripe(stripe), {
93
+ stripeAccountId: "acct_seller",
94
+ });
95
+
96
+ expect(balances).toEqual([
97
+ { available: 12550, pending: 0, currency: "usd" },
98
+ { available: 0, pending: 700, currency: "gbp" },
99
+ ]);
100
+ });
101
+
102
+ it("returns an empty array for an account with no balance", async () => {
103
+ const stripe = makeStripe({ available: [], pending: [] });
104
+
105
+ const balances = await getAccountBalance(asStripe(stripe), {
106
+ stripeAccountId: "acct_seller",
107
+ });
108
+
109
+ expect(balances).toEqual([]);
110
+ });
111
+ });
112
+
113
+ describe("createPayout (BTS-100)", () => {
114
+ it("passes the supplied idempotency key to the Stripe payout create call", async () => {
115
+ const stripe = makeStripe({ available: [], pending: [] });
116
+
117
+ await createPayout(asStripe(stripe), noCtx, {
118
+ stripeAccountId: "acct_seller",
119
+ amount: 12500,
120
+ currency: "usd",
121
+ idempotencyKey: "bs_payout_run_1",
122
+ });
123
+
124
+ expect(stripe.payouts.create).toHaveBeenCalledWith(
125
+ { amount: 12500, currency: "usd", metadata: undefined },
126
+ {
127
+ stripeAccount: "acct_seller",
128
+ idempotencyKey: "bs_payout_run_1",
129
+ },
130
+ );
131
+ });
132
+ });