@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,572 @@
1
+ import type Stripe from "stripe";
2
+
3
+ import type { SplitRecipient } from "../../component/lib/fees.js";
4
+ import { computeSplit, type SplitResult } from "../core/fees.js";
5
+ import type { Component, RunCtx } from "../helpers.js";
6
+ import { runMutationOrThrow } from "../helpers.js";
7
+ import type { PlatformFeeConfig } from "../types.js";
8
+ import { componentRef } from "../webhooks/helpers.js";
9
+
10
+ type LedgerTransfer = {
11
+ stripeTransferId: string;
12
+ amount: number;
13
+ reversedAmount?: number;
14
+ reversalClaimedAmount?: number;
15
+ destinationAccountId?: string;
16
+ role?: string;
17
+ currency?: string;
18
+ };
19
+
20
+ type ClaimedSlice = {
21
+ stripeTransferId: string;
22
+ /** Cumulative reversed amount this slice starts from. */
23
+ from: number;
24
+ /** Cumulative reversed amount this slice raises the leg to. */
25
+ to: number;
26
+ /** The leg's confirmed `reversedAmount` at claim time. */
27
+ confirmed: number;
28
+ };
29
+
30
+ type ReversalClaim = { replay: boolean; slices: ClaimedSlice[] };
31
+
32
+ /**
33
+ * Execute the slices an operation claimed via `claimReversalSlices` (BTS-63).
34
+ * The claim already reserved this money atomically, so all that's left is
35
+ * moving it: one `bs_rev_<operationId>_<transferId>` reversal per slice, then
36
+ * confirming the new cumulative total in the ledger. A replayed claim always
37
+ * re-sends byte-identical params under the same key, which Stripe answers
38
+ * from its idempotency cache without moving money twice.
39
+ *
40
+ * Because Stripe prunes idempotency keys after ~24h (and a crash can land
41
+ * between the Stripe call and the ledger confirm), a replay first checks the
42
+ * transfer's live `amount_reversed`: if the slice's money already moved, it
43
+ * just confirms the ledger instead of re-sending the reversal.
44
+ *
45
+ * A slice only executes once every predecessor slice on its leg is confirmed
46
+ * (`confirmed ≥ from`). Without that gate, a sibling operation landing behind
47
+ * a transiently-failed claim would execute and confirm PAST the hole; the
48
+ * failed operation's retry would then see `confirmed ≥ to` and silently skip
49
+ * — its money would never move while the ledger says it did. Throwing instead
50
+ * fails this operation's webhook event, and at-least-once delivery retries
51
+ * both operations until the predecessor fills its hole and each claimed slice
52
+ * has actually moved. The ledger's `reversedAmount` therefore always covers a
53
+ * solid, hole-free prefix of the reversed axis — which is exactly what makes
54
+ * the `confirmed`/`amount_reversed` checks above sound.
55
+ */
56
+ async function executeClaimedSlices(
57
+ stripe: Stripe,
58
+ component: Component,
59
+ ctx: RunCtx,
60
+ operationId: string,
61
+ claim: ReversalClaim,
62
+ ): Promise<{ reversals: { stripeTransferId: string; amount: number }[] }> {
63
+ const reversals: { stripeTransferId: string; amount: number }[] = [];
64
+ for (const slice of claim.slices) {
65
+ if (slice.confirmed >= slice.to) continue; // executed and recorded already
66
+
67
+ if (slice.confirmed < slice.from) {
68
+ throw new Error(
69
+ `reversal slice [${slice.from},${slice.to}) on ${slice.stripeTransferId} ` +
70
+ `blocked: predecessor claim unexecuted (confirmed=${slice.confirmed})`,
71
+ );
72
+ }
73
+
74
+ if (claim.replay) {
75
+ const transfer = await stripe.transfers.retrieve(slice.stripeTransferId);
76
+ if ((transfer.amount_reversed ?? 0) >= slice.to) {
77
+ // The money moved on a previous attempt that died before confirming.
78
+ await runMutationOrThrow(
79
+ ctx,
80
+ componentRef(component, "connect/mutations/recordTransferReversal"),
81
+ { stripeTransferId: slice.stripeTransferId, reversedAmount: slice.to },
82
+ );
83
+ continue;
84
+ }
85
+ }
86
+
87
+ const amount = slice.to - slice.from;
88
+ await stripe.transfers.createReversal(
89
+ slice.stripeTransferId,
90
+ { amount },
91
+ { idempotencyKey: `bs_rev_${operationId}_${slice.stripeTransferId}` },
92
+ );
93
+ await runMutationOrThrow(
94
+ ctx,
95
+ componentRef(component, "connect/mutations/recordTransferReversal"),
96
+ { stripeTransferId: slice.stripeTransferId, reversedAmount: slice.to },
97
+ );
98
+ reversals.push({ stripeTransferId: slice.stripeTransferId, amount });
99
+ }
100
+ return { reversals };
101
+ }
102
+
103
+ /** A wedged reversal claim surfaced by {@link listWedgedReversalClaims}. */
104
+ export type WedgedReversalClaim = {
105
+ stripeTransferId: string;
106
+ sourceChargeId?: string;
107
+ amount: number;
108
+ reversedAmount: number;
109
+ reversalClaimedAmount: number;
110
+ blockingOps: { operationId: string; from: number; to: number }[];
111
+ };
112
+
113
+ type ReversalOpRecord = {
114
+ operationId: string;
115
+ sourceChargeId: string;
116
+ slices: { stripeTransferId: string; from: number; to: number }[];
117
+ _creationTime: number;
118
+ };
119
+
120
+ /** Stripe prunes idempotency keys after ~24h; a release must wait past this. */
121
+ const REVERSAL_IDEMPOTENCY_WINDOW_MS = 24 * 60 * 60 * 1000;
122
+
123
+ /**
124
+ * List "wedged" reversal legs (BTS-74): legs whose claim frontier
125
+ * (`reversalClaimedAmount`) is stuck ahead of the confirmed `reversedAmount`
126
+ * because the operation that claimed the gap died permanently (its webhook
127
+ * exhausted Stripe's retries and never confirmed). Each entry carries the ops
128
+ * holding the unexecuted slice that blocks every successor on that leg — feed an
129
+ * `operationId` into {@link reclaimReversalClaim} to resolve it.
130
+ *
131
+ * An ops/admin diagnostic: it scans the ledger (see the component query for the
132
+ * exactness/loudness contract), so treat it as a maintenance tool, not a hot path.
133
+ */
134
+ export async function listWedgedReversalClaims(
135
+ component: Component,
136
+ ctx: RunCtx,
137
+ ): Promise<WedgedReversalClaim[]> {
138
+ return (await ctx.runQuery(
139
+ componentRef(component, "connect/queries/listWedgedReversalClaims"),
140
+ {},
141
+ )) as WedgedReversalClaim[];
142
+ }
143
+
144
+ /**
145
+ * Resolve a permanently-dead reversal claim (BTS-74) so it stops blocking
146
+ * successors on the same leg. Two remedies:
147
+ *
148
+ * - **`reexecute`** (default, always safe): replay the op's recorded slices —
149
+ * byte-identical Stripe params under the original `bs_rev_<opId>_<transferId>`
150
+ * idempotency keys — moving any money that never moved and recording any that
151
+ * moved-but-wasn't-confirmed. This FILLS the hole, so blocked successors
152
+ * proceed. Prefer this: it can't double-reverse (same keys) and needs no
153
+ * live-Stripe assumptions.
154
+ * - **`release`**: abandon the claim entirely — rewind each leg's frontier to
155
+ * the pre-claim amount and delete the op record, freeing the reserved
156
+ * capacity. Only safe when the money truly never moved, so it is gated on
157
+ * BOTH (a) the op being older than `minAgeMs` (default ~24h, past Stripe's
158
+ * idempotency-key window, so no cached retry can still fire it) AND (b) live
159
+ * Stripe `amount_reversed ≤ slice.from` on every leg. The component mutation
160
+ * additionally refuses if a successor already claimed past this op's slice
161
+ * (releasing would strand it — re-execute instead).
162
+ *
163
+ * `now` is injectable for testing the age gate; it defaults to `Date.now()`.
164
+ */
165
+ export async function reclaimReversalClaim(
166
+ stripe: Stripe,
167
+ component: Component,
168
+ ctx: RunCtx,
169
+ opts: {
170
+ operationId: string;
171
+ mode?: "reexecute" | "release";
172
+ minAgeMs?: number;
173
+ now?: number;
174
+ },
175
+ ): Promise<
176
+ | {
177
+ mode: "reexecute";
178
+ reversals: { stripeTransferId: string; amount: number }[];
179
+ }
180
+ | {
181
+ mode: "release";
182
+ released: boolean;
183
+ rewound: { stripeTransferId: string; to: number }[];
184
+ }
185
+ > {
186
+ const op = (await ctx.runQuery(
187
+ componentRef(component, "connect/queries/getReversalOp"),
188
+ { operationId: opts.operationId },
189
+ )) as ReversalOpRecord | null;
190
+ if (!op) {
191
+ throw new Error(
192
+ `reclaimReversalClaim: no reversal op ${opts.operationId} to reclaim`,
193
+ );
194
+ }
195
+
196
+ if ((opts.mode ?? "reexecute") === "reexecute") {
197
+ // Build the replay claim DIRECTLY from the recorded op — never recompute.
198
+ // Annotate each recorded slice with its leg's CURRENT confirmed
199
+ // `reversedAmount`, then run executeClaimedSlices: it moves any money that
200
+ // never moved and records any that moved-but-wasn't-confirmed, all under the
201
+ // original `bs_rev_<opId>_<transferId>` keys (so it can't double-reverse).
202
+ // Reading the op straight from the record avoids the frontier-recompute path
203
+ // in claimReversalSlices, which would issue a fresh FULL claim if the op row
204
+ // were concurrently released.
205
+ const slices: ClaimedSlice[] = [];
206
+ for (const s of op.slices) {
207
+ const leg = (await ctx.runQuery(
208
+ componentRef(component, "connect/queries/getTransferByStripeId"),
209
+ { stripeTransferId: s.stripeTransferId },
210
+ )) as { reversedAmount?: number } | null;
211
+ slices.push({ ...s, confirmed: leg?.reversedAmount ?? 0 });
212
+ }
213
+ const { reversals } = await executeClaimedSlices(
214
+ stripe,
215
+ component,
216
+ ctx,
217
+ op.operationId,
218
+ { replay: true, slices },
219
+ );
220
+ return { mode: "reexecute", reversals };
221
+ }
222
+
223
+ // release: age-gate against the idempotency window, then verify live Stripe.
224
+ const minAgeMs = opts.minAgeMs ?? REVERSAL_IDEMPOTENCY_WINDOW_MS;
225
+ const now = opts.now ?? Date.now();
226
+ if (now - op._creationTime < minAgeMs) {
227
+ throw new Error(
228
+ `reclaimReversalClaim: op ${op.operationId} is too recent to release ` +
229
+ `(within the ~24h idempotency window); re-execute instead, or wait`,
230
+ );
231
+ }
232
+ const legIds = [...new Set(op.slices.map((s) => s.stripeTransferId))];
233
+ const verified: { stripeTransferId: string; amountReversed: number }[] = [];
234
+ for (const id of legIds) {
235
+ const transfer = await stripe.transfers.retrieve(id);
236
+ verified.push({
237
+ stripeTransferId: id,
238
+ amountReversed: transfer.amount_reversed ?? 0,
239
+ });
240
+ }
241
+ const res = (await runMutationOrThrow(
242
+ ctx,
243
+ componentRef(component, "connect/mutations/releaseReversalClaim"),
244
+ { operationId: op.operationId, verified },
245
+ )) as { released: boolean; rewound: { stripeTransferId: string; to: number }[] };
246
+ return { mode: "release", ...res };
247
+ }
248
+
249
+ /**
250
+ * Reverse the transfers funded by a charge (BTS-25), the primitive used by
251
+ * dispute clawback (M4) and refunds (M5).
252
+ *
253
+ * Reversal sizing, per transfer (exactly one of `percent`/`amount`, or neither):
254
+ * - `percent` — reverse that percentage of each transfer's original amount.
255
+ * - `amount` — reverse this total across all transfers, pro-rata by size,
256
+ * budget-capped so the sum never exceeds `amount`. Rounding
257
+ * residue is redistributed to legs with headroom (BTS-102), so
258
+ * the reversed total is exactly `min(amount, total headroom)`.
259
+ * - neither — full reversal.
260
+ *
261
+ * Always capped at each transfer's un-reversed remainder, so a fully-reversed
262
+ * transfer is skipped.
263
+ *
264
+ * Pass `operationId` (e.g. a dispute/refund id) to make the operation safe
265
+ * under at-least-once webhook delivery AND concurrent siblings (BTS-63): the
266
+ * amounts are claimed atomically in `claimReversalSlices` before any money
267
+ * moves, and every retry replays the originally claimed amounts byte-for-byte
268
+ * under the same `bs_rev_<operationId>_<transferId>` idempotency keys. Without
269
+ * an `operationId` the call is a direct, one-shot reversal with no idempotency
270
+ * protection. The ledger's cumulative `reversedAmount`/`reversalStatus` is
271
+ * updated via `recordTransferReversal`.
272
+ */
273
+ export async function reverseTransfers(
274
+ stripe: Stripe,
275
+ component: Component,
276
+ ctx: RunCtx,
277
+ opts: {
278
+ sourceChargeId: string;
279
+ percent?: number;
280
+ amount?: number;
281
+ operationId?: string;
282
+ },
283
+ ): Promise<{ reversals: { stripeTransferId: string; amount: number }[] }> {
284
+ if (opts.percent !== undefined && opts.amount !== undefined) {
285
+ throw new Error("reverseTransfers: pass at most one of percent or amount");
286
+ }
287
+ if (
288
+ opts.percent !== undefined &&
289
+ (!Number.isFinite(opts.percent) || opts.percent < 0 || opts.percent > 100)
290
+ ) {
291
+ throw new Error("reverseTransfers: percent must be between 0 and 100");
292
+ }
293
+ if (
294
+ opts.amount !== undefined &&
295
+ (!Number.isInteger(opts.amount) || opts.amount < 0)
296
+ ) {
297
+ throw new Error("reverseTransfers: amount must be a non-negative integer");
298
+ }
299
+
300
+ if (opts.operationId) {
301
+ const claim = (await runMutationOrThrow(
302
+ ctx,
303
+ componentRef(component, "connect/mutations/claimReversalSlices"),
304
+ {
305
+ operationId: opts.operationId,
306
+ sourceChargeId: opts.sourceChargeId,
307
+ mode:
308
+ opts.percent !== undefined
309
+ ? { kind: "percent" as const, percent: opts.percent }
310
+ : opts.amount !== undefined
311
+ ? { kind: "amount" as const, amount: opts.amount }
312
+ : { kind: "full" as const },
313
+ },
314
+ )) as ReversalClaim;
315
+ return executeClaimedSlices(stripe, component, ctx, opts.operationId, claim);
316
+ }
317
+
318
+ // Legacy one-shot path (no operationId): size against the claim frontier so
319
+ // a direct call can't double-take money a claimed-but-unexecuted operation
320
+ // already reserved.
321
+ const transfers = ((await ctx.runQuery(
322
+ componentRef(component, "connect/queries/listTransfersByCharge"),
323
+ { sourceChargeId: opts.sourceChargeId },
324
+ )) ?? []) as LedgerTransfer[];
325
+
326
+ const total = transfers.reduce((s, t) => s + t.amount, 0);
327
+ // For the `amount` mode, track the remaining budget so rounding can never
328
+ // reverse more than the caller asked for.
329
+ let amountBudget = opts.amount;
330
+ const reversals: { stripeTransferId: string; amount: number }[] = [];
331
+
332
+ for (const t of transfers) {
333
+ const already = Math.max(t.reversedAmount ?? 0, t.reversalClaimedAmount ?? 0);
334
+ const remaining = t.amount - already;
335
+ if (remaining <= 0) continue; // already fully reversed — idempotent
336
+
337
+ let reversalAmt: number;
338
+ if (opts.percent !== undefined) {
339
+ reversalAmt = Math.round((t.amount * opts.percent) / 100);
340
+ } else if (amountBudget !== undefined) {
341
+ const prorata = total > 0 ? Math.round((opts.amount! * t.amount) / total) : 0;
342
+ reversalAmt = Math.min(prorata, amountBudget);
343
+ } else {
344
+ reversalAmt = remaining; // full reversal
345
+ }
346
+ reversalAmt = Math.min(reversalAmt, remaining);
347
+ if (reversalAmt <= 0) continue;
348
+ if (amountBudget !== undefined) amountBudget -= reversalAmt;
349
+
350
+ await stripe.transfers.createReversal(
351
+ t.stripeTransferId,
352
+ { amount: reversalAmt },
353
+ undefined,
354
+ );
355
+ await runMutationOrThrow(
356
+ ctx,
357
+ componentRef(component, "connect/mutations/recordTransferReversal"),
358
+ { stripeTransferId: t.stripeTransferId, reversedAmount: already + reversalAmt },
359
+ );
360
+ reversals.push({ stripeTransferId: t.stripeTransferId, amount: reversalAmt });
361
+ }
362
+
363
+ return { reversals };
364
+ }
365
+
366
+ /**
367
+ * Reverse a split sale's transfers pro-rata to the cumulatively refunded
368
+ * amount (BTS-34) — the refund counterpart of the dispute clawback. Every leg
369
+ * converges on a cumulative reversal TARGET, `round(leg × amountRefunded /
370
+ * chargeAmount)`, and only the delta above the ledger's recorded
371
+ * `reversedAmount` is reversed. Delta-to-target (rather than percent-of-
372
+ * original like {@link reverseTransfers}) is what makes at-least-once webhook
373
+ * delivery safe here: a redelivery whose reversals were recorded computes a
374
+ * zero delta and skips, while a retry after an unrecorded reversal re-sends
375
+ * the IDENTICAL params against the same `bs_rev_<refundId>_<transferId>`
376
+ * idempotency key, which Stripe replays without moving money twice. Multiple
377
+ * partial refunds each raise the target and reverse only their increment.
378
+ * Sales with no ledger legs (non-split) reverse nothing.
379
+ *
380
+ * The delta is claimed atomically in `claimReversalSlices` BEFORE the Stripe
381
+ * call (BTS-63): two DISTINCT refunds processed concurrently serialize on the
382
+ * claim, so they can never both reverse the same target slice — the second
383
+ * claim comes back empty (or with only its own increment).
384
+ */
385
+ export async function reverseTransfersForRefund(
386
+ stripe: Stripe,
387
+ component: Component,
388
+ ctx: RunCtx,
389
+ opts: {
390
+ sourceChargeId: string;
391
+ refundId: string;
392
+ /** The original charge amount (minor units). */
393
+ chargeAmount: number;
394
+ /** Stripe's cumulative `charge.amount_refunded`, including this refund. */
395
+ amountRefunded: number;
396
+ },
397
+ ): Promise<{ reversals: { stripeTransferId: string; amount: number }[] }> {
398
+ if (!(opts.chargeAmount > 0) || !(opts.amountRefunded > 0)) {
399
+ return { reversals: [] };
400
+ }
401
+
402
+ const claim = (await runMutationOrThrow(
403
+ ctx,
404
+ componentRef(component, "connect/mutations/claimReversalSlices"),
405
+ {
406
+ operationId: opts.refundId,
407
+ sourceChargeId: opts.sourceChargeId,
408
+ mode: {
409
+ kind: "fraction" as const,
410
+ chargeAmount: opts.chargeAmount,
411
+ amountRefunded: opts.amountRefunded,
412
+ },
413
+ },
414
+ )) as ReversalClaim;
415
+ return executeClaimedSlices(stripe, component, ctx, opts.refundId, claim);
416
+ }
417
+
418
+ /**
419
+ * Webhook-driven split transfer engine (BTS-22). After a charge succeeds for a
420
+ * separate-charges sale, fan funds out to each split recipient: compute the
421
+ * amounts ({@link computeSplit}), create one Stripe `Transfer` per recipient
422
+ * with `source_transaction` linkage, and record each in the ledger. The platform
423
+ * keeps the remainder (`result.platformRetained`, always ≥ 0). No
424
+ * `application_fee` is used on this path.
425
+ */
426
+ export async function createSplitTransfers(
427
+ stripe: Stripe,
428
+ component: Component,
429
+ ctx: RunCtx,
430
+ opts: {
431
+ sourceChargeId: string;
432
+ amount: number;
433
+ currency: string;
434
+ split: SplitRecipient[];
435
+ feeConfig?: PlatformFeeConfig;
436
+ paymentId?: string;
437
+ },
438
+ ): Promise<SplitResult> {
439
+ const result = computeSplit(opts.amount, opts.feeConfig, opts.split);
440
+
441
+ // Ledger-level idempotency (BTS-24): skip any (charge, destination, role) leg
442
+ // already recorded, so a webhook retry — even after a partial run — never
443
+ // double-transfers. Complements the deterministic Stripe idempotency key.
444
+ const existing = ((await ctx.runQuery(
445
+ componentRef(component, "connect/queries/listTransfersByCharge"),
446
+ { sourceChargeId: opts.sourceChargeId },
447
+ )) ?? []) as LedgerTransfer[];
448
+ const done = new Set(
449
+ existing.map((t) => `${t.destinationAccountId}:${t.role ?? ""}`),
450
+ );
451
+
452
+ for (const t of result.transfers) {
453
+ if (t.amount <= 0) continue;
454
+ if (done.has(`${t.destinationAccountId}:${t.role}`)) continue;
455
+ const transfer = await stripe.transfers.create(
456
+ {
457
+ amount: t.amount,
458
+ currency: opts.currency,
459
+ destination: t.destinationAccountId,
460
+ source_transaction: opts.sourceChargeId,
461
+ metadata: { bsRole: t.role, bsSourceCharge: opts.sourceChargeId },
462
+ },
463
+ // Deterministic key so a webhook retry can't double-transfer (BTS-24).
464
+ { idempotencyKey: `bs_split_${opts.sourceChargeId}_${t.destinationAccountId}_${t.role}` },
465
+ );
466
+ await runMutationOrThrow(
467
+ ctx,
468
+ componentRef(component, "connect/mutations/upsertTransfer"),
469
+ {
470
+ stripeTransferId: transfer.id,
471
+ sourceChargeId: opts.sourceChargeId,
472
+ destinationAccountId: t.destinationAccountId,
473
+ amount: t.amount,
474
+ currency: opts.currency,
475
+ role: t.role,
476
+ status: "paid" as const,
477
+ paymentId: opts.paymentId,
478
+ },
479
+ );
480
+ }
481
+
482
+ return result;
483
+ }
484
+
485
+ /**
486
+ * Re-create transfers for amounts previously reversed by a dispute clawback,
487
+ * when the dispute is won (BTS-29). Stripe reversals are permanent, so winning
488
+ * means paying recipients again from the platform balance (Stripe has credited
489
+ * the disputed funds back). Idempotent via `operationId` (the dispute id) so a
490
+ * `closed`+`funds_reinstated` double-fire won't double-pay. Records each fresh
491
+ * transfer in the ledger.
492
+ */
493
+ export async function reinstateTransfers(
494
+ stripe: Stripe,
495
+ component: Component,
496
+ ctx: RunCtx,
497
+ opts: { sourceChargeId: string; operationId: string; currency: string },
498
+ ): Promise<{ reinstated: { destinationAccountId: string; amount: number }[] }> {
499
+ const transfers = ((await ctx.runQuery(
500
+ componentRef(component, "connect/queries/listTransfersByCharge"),
501
+ { sourceChargeId: opts.sourceChargeId },
502
+ )) ?? []) as LedgerTransfer[];
503
+
504
+ const reinstated: { destinationAccountId: string; amount: number }[] = [];
505
+ for (const t of transfers) {
506
+ const amount = t.reversedAmount ?? 0;
507
+ if (amount <= 0) continue; // nothing was clawed back from this leg
508
+ // Use the original leg's currency; fall back to the dispute currency for
509
+ // legacy rows that predate the stored currency — never assume USD.
510
+ const currency = t.currency ?? opts.currency;
511
+ const created = await stripe.transfers.create(
512
+ {
513
+ amount,
514
+ currency,
515
+ destination: t.destinationAccountId!,
516
+ metadata: { bsRole: t.role ?? "", bsReinstateOf: opts.sourceChargeId },
517
+ },
518
+ {
519
+ idempotencyKey: `bs_reinstate_${opts.operationId}_${t.destinationAccountId}_${t.role ?? ""}`,
520
+ },
521
+ );
522
+ await runMutationOrThrow(
523
+ ctx,
524
+ componentRef(component, "connect/mutations/upsertTransfer"),
525
+ {
526
+ stripeTransferId: created.id,
527
+ sourceChargeId: opts.sourceChargeId,
528
+ destinationAccountId: t.destinationAccountId!,
529
+ amount,
530
+ currency,
531
+ role: t.role as "store" | "affiliate" | "other" | undefined,
532
+ status: "paid" as const,
533
+ // Audit-only payout, not an original split leg (kept out of
534
+ // listTransfersByCharge so it can't be re-reversed).
535
+ reinstatement: true,
536
+ },
537
+ );
538
+ reinstated.push({ destinationAccountId: t.destinationAccountId!, amount });
539
+ }
540
+ return { reinstated };
541
+ }
542
+
543
+ /**
544
+ * The original split legs of one sale (`listTransfersByCharge` excludes
545
+ * reinstatement rows), for the `useSplitBreakdown` hook / per-sale breakdown
546
+ * UIs. Read-only passthrough to the component query.
547
+ */
548
+ export async function listTransfersByCharge(
549
+ component: Component,
550
+ ctx: RunCtx,
551
+ opts: { sourceChargeId: string; limit?: number },
552
+ ) {
553
+ return ctx.runQuery(
554
+ componentRef(component, "connect/queries/listTransfersByCharge"),
555
+ opts,
556
+ );
557
+ }
558
+
559
+ /**
560
+ * A recipient's transfer ledger (the earnings view — includes reinstatements),
561
+ * for the `useEarnings` hook. Read-only passthrough to the component query.
562
+ */
563
+ export async function listTransfersByAccount(
564
+ component: Component,
565
+ ctx: RunCtx,
566
+ opts: { destinationAccountId: string; limit?: number },
567
+ ) {
568
+ return ctx.runQuery(
569
+ componentRef(component, "connect/queries/listTransfersByAccount"),
570
+ opts,
571
+ );
572
+ }
@@ -0,0 +1,15 @@
1
+ import type { StripeApiVersion } from "./stripe-types.js";
2
+
3
+ /**
4
+ * The single source of truth for the Stripe API version this library targets.
5
+ *
6
+ * Bump this in ONE place when upgrading the Stripe SDK. It is typed as
7
+ * {@link StripeApiVersion} — a literal derived from the installed SDK's own
8
+ * constructor signature — so a value that drifts from the SDK fails to
9
+ * compile and points you straight back here.
10
+ *
11
+ * Note: changing this is a behavioral/breaking change for the Convex
12
+ * component (it pins every Stripe client it creates), so it warrants a
13
+ * component release and changelog entry.
14
+ */
15
+ export const STRIPE_API_VERSION: StripeApiVersion = "2026-05-27.dahlia";