@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,1872 @@
1
+ import { internalActionGeneric, internalMutationGeneric } from "convex/server";
2
+ import { v } from "convex/values";
3
+ import Stripe from "stripe";
4
+
5
+ import type { ComponentApi } from "../component/_generated/component.js";
6
+ import type {
7
+ InvoiceStatus,
8
+ SubscriptionStatus,
9
+ } from "../component/billing/validators.js";
10
+ import type {
11
+ DisputeStatus,
12
+ PayoutStatus,
13
+ RefundStatus,
14
+ } from "../component/connect/validators.js";
15
+ import type { SplitRecipient } from "../component/lib/fees.js";
16
+ import * as checkoutImpl from "./billing/checkout.js";
17
+ import * as invoicesImpl from "./billing/invoices.js";
18
+ import * as subscriptionsImpl from "./billing/subscriptions.js";
19
+ import * as disputesImpl from "./connect/disputes.js";
20
+ import * as paymentMethodsImpl from "./connect/paymentMethods.js";
21
+ import * as payoutsImpl from "./connect/payouts.js";
22
+ import * as refundsImpl from "./connect/refunds.js";
23
+ import * as transfersImpl from "./connect/transfers.js";
24
+ import * as accountLinksImpl from "./core/accountLinks.js";
25
+ import * as accountsImpl from "./core/accounts.js";
26
+ import * as configImpl from "./core/config.js";
27
+ import { resolveFeeConfig, validatePlatformFee } from "./core/fees.js";
28
+ import { validateStatementDescriptorSuffix } from "./core/descriptors.js";
29
+ export { computeFee, computeSplit } from "./core/fees.js";
30
+ export type { FeeBreakdown, SplitResult, SplitTransfer } from "./core/fees.js";
31
+ export { groupSubscriptionsByStore } from "./billing/subscriptions.js";
32
+ export {
33
+ buildDisputeEvidence,
34
+ disputeEvidenceCountdown,
35
+ } from "./connect/disputes.js";
36
+ export type { RefundActor } from "./connect/refunds.js";
37
+ import type { RefundActor } from "./connect/refunds.js";
38
+ export type { AccountBalance } from "./connect/payouts.js";
39
+ export type { WedgedReversalClaim } from "./connect/transfers.js";
40
+ import type { Component, RunCtx } from "./helpers.js";
41
+ import { getStripeClient } from "./helpers.js";
42
+ import type {
43
+ V2AccountRetrieveInclude,
44
+ V2AccountUpdateParams,
45
+ } from "./stripe-types.js";
46
+ import { componentRef, DISPATCHER_UPSERT_PATHS } from "./webhooks/helpers.js";
47
+ import * as pricesImpl from "./products/prices.js";
48
+ import * as productsImpl from "./products/products.js";
49
+ import type {
50
+ AccountLinkWithStatus,
51
+ AsyncHookCtx,
52
+ AsyncHooks,
53
+ BetterStripeOptions,
54
+ FeeOverride,
55
+ PlatformFeeConfig,
56
+ StripeComponentAccount,
57
+ StripeComponentCheckoutSession,
58
+ StripeComponentDispute,
59
+ StripeComponentInvoice,
60
+ StripeComponentPayment,
61
+ StripeComponentPayout,
62
+ StripeComponentPrice,
63
+ StripeComponentProduct,
64
+ StripeComponentRefund,
65
+ StripeComponentSubscription,
66
+ SyncTriggerCtx,
67
+ SyncTriggers,
68
+ } from "./types.js";
69
+ import type { AsyncHookName, TriggerDispatcherName } from "./types/triggers.js";
70
+ import * as dataImpl from "./utils/data.js";
71
+ import type { StripeMode } from "./utils/stripeDashboardUrl.js";
72
+ import * as webhookEndpointsImpl from "./utils/webhookEndpoints.js";
73
+
74
+ // Re-export standalone webhook registration
75
+ export { registerRoutes } from "./webhooks.js";
76
+ export {
77
+ getStripeDashboardUrl,
78
+ isStripeTestMode,
79
+ STRIPE_DASHBOARD_BASE_URL,
80
+ StripeDashboardResourcePath,
81
+ } from "./utils/stripeDashboardUrl.js";
82
+
83
+ // Re-export payment method utilities
84
+ export {
85
+ getPaymentMethodCard,
86
+ getPaymentMethodOwner,
87
+ } from "./connect/paymentMethodUtils.js";
88
+
89
+ // Re-export webhook event constants and types
90
+ export {
91
+ ALL_BETTER_STRIPE_EVENTS,
92
+ BETTER_STRIPE_V2_WEBHOOK_EVENTS,
93
+ BETTER_STRIPE_WEBHOOK_EVENTS,
94
+ } from "./utils/webhookEndpoints.js";
95
+ export type {
96
+ BetterStripeV2WebhookEvent,
97
+ BetterStripeWebhookEvent,
98
+ } from "./utils/webhookEndpoints.js";
99
+
100
+ // Re-export types for consumers
101
+ export type {
102
+ BetterStripeOptions,
103
+ FeeOverride,
104
+ FeeTier,
105
+ PlatformFeeConfig,
106
+ RegisterRoutesConfig,
107
+ } from "./types.js";
108
+ export type {
109
+ StripeDashboardResourceType,
110
+ StripeMode,
111
+ } from "./utils/stripeDashboardUrl.js";
112
+ export type {
113
+ AccountLinkWithStatus,
114
+ AsyncHookCtx,
115
+ AsyncHooks,
116
+ PaymentMethodCard,
117
+ PaymentMethodLike,
118
+ StripeComponentAccount,
119
+ StripeComponentCheckoutSession,
120
+ StripeComponentDispute,
121
+ StripeComponentInvoice,
122
+ StripeComponentPayment,
123
+ StripeComponentPayout,
124
+ StripeComponentPrice,
125
+ StripeComponentProduct,
126
+ StripeComponentRefund,
127
+ StripeComponentSubscription,
128
+ StripeCountrySpecs,
129
+ StripeEventHandler,
130
+ StripeEventHandlers,
131
+ StripeV2Account,
132
+ StripeWebhookEvent,
133
+ SyncTriggerCtx,
134
+ SyncTriggers,
135
+ V2ThinEvent,
136
+ WebhookActionCtx,
137
+ } from "./types.js";
138
+
139
+ export type BetterStripeComponent = ComponentApi;
140
+
141
+ /** Deep-copy a platform fee config so stored/returned values can't be mutated. */
142
+ function clonePlatformFee(config: PlatformFeeConfig): PlatformFeeConfig {
143
+ return {
144
+ ...config,
145
+ tiers: config.tiers?.map((tier) => ({ ...tier })),
146
+ };
147
+ }
148
+
149
+ // =============================================================================
150
+ // BETTER STRIPE CLIENT
151
+ // =============================================================================
152
+
153
+ export class BetterStripe {
154
+ public component: Component;
155
+ private _apiKey?: string;
156
+ private _triggers?: SyncTriggers;
157
+ private _hooks?: AsyncHooks;
158
+ private _platformFee?: PlatformFeeConfig;
159
+ private _statementDescriptorSuffix?: string;
160
+
161
+ constructor(component: BetterStripeComponent, options?: BetterStripeOptions) {
162
+ this.component = component;
163
+ this._apiKey = options?.STRIPE_SECRET_KEY;
164
+ this._triggers = options?.triggers;
165
+ this._hooks = options?.hooks;
166
+ if (options?.platformFee !== undefined) {
167
+ validatePlatformFee(options.platformFee);
168
+ // Store a defensive copy so later mutation of the caller's object can't
169
+ // silently bypass validation or change runtime behavior.
170
+ this._platformFee = clonePlatformFee(options.platformFee);
171
+ }
172
+ if (options?.statementDescriptorSuffix !== undefined) {
173
+ this._statementDescriptorSuffix = validateStatementDescriptorSuffix(
174
+ options.statementDescriptorSuffix,
175
+ );
176
+ }
177
+ }
178
+
179
+ /**
180
+ * The configured default statement-descriptor suffix, if any — the fallback
181
+ * for destination charges to sellers without a per-store suffix (BTS-32).
182
+ */
183
+ get statementDescriptorSuffix(): string | undefined {
184
+ return this._statementDescriptorSuffix;
185
+ }
186
+
187
+ /** The configured default platform fee (the platform's take), if any. */
188
+ get platformFee(): PlatformFeeConfig | undefined {
189
+ return this._platformFee && clonePlatformFee(this._platformFee);
190
+ }
191
+
192
+ /**
193
+ * Resolve the effective fee config for a charge: per-call override → global
194
+ * default. The fee math itself is applied at charge time (M2).
195
+ */
196
+ resolveFee(override?: FeeOverride): PlatformFeeConfig | undefined {
197
+ const resolved = resolveFeeConfig(this._platformFee, override);
198
+ return resolved && clonePlatformFee(resolved);
199
+ }
200
+
201
+ get apiKey(): string {
202
+ const key = this._apiKey;
203
+ if (!key) {
204
+ throw new Error(
205
+ "STRIPE_SECRET_KEY is not set. Pass it via BetterStripe constructor options.",
206
+ );
207
+ }
208
+ return key;
209
+ }
210
+
211
+ private stripe(apiVersion?: string): Stripe {
212
+ return getStripeClient(this.apiKey, apiVersion);
213
+ }
214
+
215
+ // ============================================================================
216
+ // Static defaults (preserved for backwards compatibility)
217
+ // ============================================================================
218
+
219
+ static DEFAULT_ACCOUNT_CONFIGURATION =
220
+ accountsImpl.DEFAULT_ACCOUNT_CONFIGURATION;
221
+ static DEFAULT_ACCOUNT_DEFAULTS = accountsImpl.DEFAULT_ACCOUNT_DEFAULTS;
222
+ static DEFAULT_CUSTOMER_CONFIGURATION =
223
+ accountsImpl.DEFAULT_CUSTOMER_CONFIGURATION;
224
+
225
+ // ============================================================================
226
+ // ACCOUNT METHODS
227
+ // ============================================================================
228
+
229
+ async createAccount(
230
+ ctx: RunCtx,
231
+ opts: {
232
+ userId: string;
233
+ email?: string;
234
+ name?: string;
235
+ country?: string;
236
+ orgId?: string;
237
+ metadata?: Record<string, string>;
238
+ },
239
+ ) {
240
+ return accountsImpl.createAccount(this.stripe(), this.component, ctx, opts);
241
+ }
242
+
243
+ async createAccountWithOnboarding(
244
+ ctx: RunCtx,
245
+ opts: {
246
+ userId: string;
247
+ email?: string;
248
+ name?: string;
249
+ country: string;
250
+ orgId?: string;
251
+ metadata?: Record<string, string>;
252
+ refreshUrl: string;
253
+ returnUrl: string;
254
+ accountConfiguration?: Record<string, unknown>;
255
+ accountDefaults?: Record<string, unknown>;
256
+ dashboard?: "express" | "full" | "none";
257
+ },
258
+ ): Promise<{
259
+ stripeAccountId: string;
260
+ onboardingUrl: string;
261
+ }> {
262
+ return accountsImpl.createAccountWithOnboarding(
263
+ this.stripe(),
264
+ this.component,
265
+ ctx,
266
+ opts,
267
+ );
268
+ }
269
+
270
+ async getAccount(
271
+ ctx: RunCtx,
272
+ opts: { accountId: string },
273
+ ): Promise<StripeComponentAccount | null> {
274
+ return accountsImpl.getAccount(this.component, ctx, opts);
275
+ }
276
+
277
+ async getOrCreateAccount(
278
+ ctx: RunCtx,
279
+ opts: {
280
+ userId: string;
281
+ email?: string;
282
+ name?: string;
283
+ country?: string;
284
+ orgId?: string;
285
+ metadata?: Record<string, string>;
286
+ },
287
+ ) {
288
+ return accountsImpl.getOrCreateAccount(
289
+ this.stripe(),
290
+ this.component,
291
+ ctx,
292
+ opts,
293
+ );
294
+ }
295
+
296
+ async getAccountByUserId(
297
+ ctx: RunCtx,
298
+ opts: { userId: string },
299
+ ): Promise<StripeComponentAccount | null> {
300
+ return accountsImpl.getAccountByUserId(this.component, ctx, opts);
301
+ }
302
+
303
+ async getAccountByOrgId(
304
+ ctx: RunCtx,
305
+ opts: { orgId: string },
306
+ ): Promise<StripeComponentAccount | null> {
307
+ return accountsImpl.getAccountByOrgId(this.component, ctx, opts);
308
+ }
309
+
310
+ async getAccountByStripeId(
311
+ ctx: RunCtx,
312
+ opts: { stripeAccountId: string },
313
+ ): Promise<StripeComponentAccount | null> {
314
+ return accountsImpl.getAccountByStripeId(this.component, ctx, opts);
315
+ }
316
+
317
+ async getAccountOnboardingStatus(ctx: RunCtx, opts: { accountId: string }) {
318
+ return accountsImpl.getAccountOnboardingStatus(this.component, ctx, opts);
319
+ }
320
+
321
+ async upsertAccount(
322
+ ctx: RunCtx,
323
+ opts: {
324
+ stripeAccountId: string;
325
+ userId: string;
326
+ orgId?: string;
327
+ email?: string;
328
+ name?: string;
329
+ country?: string;
330
+ capabilities?: Record<string, unknown>;
331
+ requirements?: Record<string, unknown>;
332
+ configuration?: Record<string, unknown>;
333
+ onboardingStatus?: "pending" | "in_progress" | "complete" | "restricted";
334
+ missingRequirements?: string[];
335
+ metadata?: Record<string, unknown>;
336
+ },
337
+ ) {
338
+ return accountsImpl.upsertAccount(this.component, ctx, opts);
339
+ }
340
+
341
+ async updateAccount(
342
+ ctx: RunCtx,
343
+ opts: {
344
+ stripeAccountId: string;
345
+ email?: string;
346
+ name?: string;
347
+ metadata?: Record<string, string>;
348
+ },
349
+ ) {
350
+ return accountsImpl.updateAccount(this.stripe(), ctx, opts);
351
+ }
352
+
353
+ async getV2Account(
354
+ ctx: RunCtx,
355
+ opts: {
356
+ stripeAccountId: string;
357
+ include?: V2AccountRetrieveInclude[];
358
+ },
359
+ ) {
360
+ return accountsImpl.getV2Account(this.stripe(), ctx, opts);
361
+ }
362
+
363
+ async updateV2Account(
364
+ ctx: RunCtx,
365
+ opts: {
366
+ stripeAccountId: string;
367
+ updateParams: V2AccountUpdateParams;
368
+ },
369
+ ) {
370
+ return accountsImpl.updateV2Account(this.stripe(), ctx, opts);
371
+ }
372
+
373
+ async listStripeAccounts(ctx: RunCtx, opts?: { limit?: number }) {
374
+ return accountsImpl.listStripeAccounts(this.stripe(), ctx, opts);
375
+ }
376
+
377
+ async closeAccount(
378
+ ctx: RunCtx,
379
+ opts: { stripeAccountId: string },
380
+ ): Promise<{ closed: boolean }> {
381
+ return accountsImpl.closeAccount(this.stripe(), this.component, ctx, opts);
382
+ }
383
+
384
+ async restartAccountOnboarding(
385
+ ctx: RunCtx,
386
+ opts: { stripeAccountId: string },
387
+ ): Promise<{ closed: boolean }> {
388
+ return accountsImpl.restartAccountOnboarding(
389
+ this.stripe(),
390
+ this.component,
391
+ ctx,
392
+ opts,
393
+ );
394
+ }
395
+
396
+ /**
397
+ * Apply the V2 recipient configuration to an existing account, and record
398
+ * the applied configurations on the component account. The account must
399
+ * already exist in the component DB (e.g. from {@link createAccount}).
400
+ */
401
+ async addRecipientConfiguration(
402
+ ctx: RunCtx,
403
+ opts: { stripeAccountId: string },
404
+ ) {
405
+ return accountsImpl.addRecipientConfiguration(
406
+ this.stripe(),
407
+ this.component,
408
+ ctx,
409
+ opts,
410
+ );
411
+ }
412
+
413
+ /**
414
+ * Apply the V2 customer configuration to an existing account, making it
415
+ * billable (subscriptions, invoices, billing portal via `customer_account`),
416
+ * and record the applied configurations on the component account. The account
417
+ * must already exist in the component DB (e.g. from {@link createAccount}).
418
+ */
419
+ async addCustomerConfiguration(
420
+ ctx: RunCtx,
421
+ opts: { stripeAccountId: string },
422
+ ) {
423
+ return accountsImpl.addCustomerConfiguration(
424
+ this.stripe(),
425
+ this.component,
426
+ ctx,
427
+ opts,
428
+ );
429
+ }
430
+
431
+ /**
432
+ * Store (or clear, with `null`) a per-store statement-descriptor suffix on a
433
+ * seller's account record (BTS-32). Destination charges to that account then
434
+ * show `PLATFORMPREFIX* SUFFIX` on the buyer's card statement. Validated
435
+ * against Stripe's descriptor rules (max 22 chars, at least one letter, no
436
+ * < > \\ ' " *).
437
+ */
438
+ async setAccountStatementDescriptor(
439
+ ctx: RunCtx,
440
+ opts: { stripeAccountId: string; statementDescriptor: string | null },
441
+ ) {
442
+ return accountsImpl.setAccountStatementDescriptor(
443
+ this.component,
444
+ ctx,
445
+ opts,
446
+ );
447
+ }
448
+
449
+ /**
450
+ * Ensure a shopper has a V2 account with the `customer` configuration (create
451
+ * if needed), so they can be billed via `customer_account` and later add a
452
+ * merchant/recipient configuration on the same account. Idempotent.
453
+ */
454
+ async ensureCustomerAccount(
455
+ ctx: RunCtx,
456
+ opts: {
457
+ userId: string;
458
+ email?: string;
459
+ name?: string;
460
+ country?: string;
461
+ orgId?: string;
462
+ metadata?: Record<string, string>;
463
+ },
464
+ ) {
465
+ return accountsImpl.ensureCustomerAccount(
466
+ this.stripe(),
467
+ this.component,
468
+ ctx,
469
+ opts,
470
+ );
471
+ }
472
+
473
+ // ============================================================================
474
+ // PRODUCT METHODS
475
+ // ============================================================================
476
+
477
+ async createProduct(
478
+ ctx: RunCtx,
479
+ opts: {
480
+ name: string;
481
+ description?: string;
482
+ active?: boolean;
483
+ accountId?: string;
484
+ metadata?: Record<string, string>;
485
+ },
486
+ ) {
487
+ return productsImpl.createProduct(this.stripe(), this.component, ctx, {
488
+ ...opts,
489
+ // Stamp the per-store descriptor at create so it covers the first invoice
490
+ // charge (BTS-67); resolves the store's suffix, else this default.
491
+ defaultStatementDescriptorSuffix: this._statementDescriptorSuffix,
492
+ });
493
+ }
494
+
495
+ async updateProduct(
496
+ ctx: RunCtx,
497
+ opts: {
498
+ stripeProductId: string;
499
+ name?: string;
500
+ description?: string;
501
+ active?: boolean;
502
+ defaultPrice?: string | null;
503
+ metadata?: Record<string, string>;
504
+ },
505
+ ) {
506
+ return productsImpl.updateProduct(this.stripe(), this.component, ctx, {
507
+ ...opts,
508
+ defaultStatementDescriptorSuffix: this._statementDescriptorSuffix,
509
+ });
510
+ }
511
+
512
+ async deactivateProduct(ctx: RunCtx, opts: { stripeProductId: string }) {
513
+ return productsImpl.deactivateProduct(this.stripe(), ctx, opts);
514
+ }
515
+
516
+ async getProduct(
517
+ ctx: RunCtx,
518
+ opts: { productId: string },
519
+ ): Promise<StripeComponentProduct | null> {
520
+ return productsImpl.getProduct(this.component, ctx, opts);
521
+ }
522
+
523
+ async getProductByStripeId(
524
+ ctx: RunCtx,
525
+ opts: { stripeProductId: string },
526
+ ): Promise<StripeComponentProduct | null> {
527
+ return productsImpl.getProductByStripeId(this.component, ctx, opts);
528
+ }
529
+
530
+ async listProducts(
531
+ ctx: RunCtx,
532
+ opts?: { accountId?: string; active?: boolean; limit?: number },
533
+ ): Promise<StripeComponentProduct[]> {
534
+ return productsImpl.listProducts(this.component, ctx, opts);
535
+ }
536
+
537
+ async upsertProduct(
538
+ ctx: RunCtx,
539
+ opts: {
540
+ stripeProductId: string;
541
+ accountId?: string;
542
+ name: string;
543
+ description?: string;
544
+ active: boolean;
545
+ metadata?: Record<string, unknown>;
546
+ },
547
+ ) {
548
+ return productsImpl.upsertProduct(this.component, ctx, opts);
549
+ }
550
+
551
+ async listStripeProducts(
552
+ ctx: RunCtx,
553
+ opts?: { active?: boolean; limit?: number },
554
+ ) {
555
+ return productsImpl.listStripeProducts(this.stripe(), ctx, opts);
556
+ }
557
+
558
+ async deleteProduct(ctx: RunCtx, opts: { stripeProductId: string }) {
559
+ return productsImpl.deleteProduct(this.stripe(), ctx, opts);
560
+ }
561
+
562
+ // ============================================================================
563
+ // PRICE METHODS
564
+ // ============================================================================
565
+
566
+ async createPrice(
567
+ ctx: RunCtx,
568
+ opts: {
569
+ stripeProductId: string;
570
+ unitAmount: number;
571
+ currency?: string;
572
+ type: "one_time" | "recurring";
573
+ interval?: "day" | "week" | "month" | "year";
574
+ intervalCount?: number;
575
+ nickname?: string;
576
+ metadata?: Record<string, string>;
577
+ },
578
+ ) {
579
+ return pricesImpl.createPrice(this.stripe(), this.component, ctx, opts);
580
+ }
581
+
582
+ async updatePrice(
583
+ ctx: RunCtx,
584
+ opts: {
585
+ stripePriceId: string;
586
+ active?: boolean;
587
+ nickname?: string;
588
+ metadata?: Record<string, string>;
589
+ },
590
+ ) {
591
+ return pricesImpl.updatePrice(this.stripe(), ctx, opts);
592
+ }
593
+
594
+ async deactivatePrice(ctx: RunCtx, opts: { stripePriceId: string }) {
595
+ return pricesImpl.deactivatePrice(this.stripe(), ctx, opts);
596
+ }
597
+
598
+ async getPrice(
599
+ ctx: RunCtx,
600
+ opts: { priceId: string },
601
+ ): Promise<StripeComponentPrice | null> {
602
+ return pricesImpl.getPrice(this.component, ctx, opts);
603
+ }
604
+
605
+ async getPriceByStripeId(
606
+ ctx: RunCtx,
607
+ opts: { stripePriceId: string },
608
+ ): Promise<StripeComponentPrice | null> {
609
+ return pricesImpl.getPriceByStripeId(this.component, ctx, opts);
610
+ }
611
+
612
+ async listPrices(
613
+ ctx: RunCtx,
614
+ opts?: { productId?: string; active?: boolean; limit?: number },
615
+ ): Promise<StripeComponentPrice[]> {
616
+ return pricesImpl.listPrices(this.component, ctx, opts);
617
+ }
618
+
619
+ async listPricesByProduct(
620
+ ctx: RunCtx,
621
+ opts: { stripeProductId: string },
622
+ ): Promise<StripeComponentPrice[]> {
623
+ return pricesImpl.listPricesByProduct(this.component, ctx, opts);
624
+ }
625
+
626
+ async upsertPrice(
627
+ ctx: RunCtx,
628
+ opts: {
629
+ stripePriceId: string;
630
+ productId: string;
631
+ stripeProductId: string;
632
+ nickname?: string;
633
+ unitAmount: number;
634
+ currency: string;
635
+ active: boolean;
636
+ type: "one_time" | "recurring";
637
+ interval?: "day" | "week" | "month" | "year";
638
+ intervalCount?: number;
639
+ metadata?: Record<string, unknown>;
640
+ },
641
+ ) {
642
+ return pricesImpl.upsertPrice(this.component, ctx, opts);
643
+ }
644
+
645
+ async listStripePrices(
646
+ ctx: RunCtx,
647
+ opts?: { productId?: string; active?: boolean; limit?: number },
648
+ ) {
649
+ return pricesImpl.listStripePrices(this.stripe(), ctx, opts);
650
+ }
651
+
652
+ // ============================================================================
653
+ // CHECKOUT METHODS
654
+ // ============================================================================
655
+
656
+ async createCheckoutSession(
657
+ ctx: RunCtx,
658
+ opts: {
659
+ userId: string;
660
+ orgId?: string;
661
+ stripePriceId: string;
662
+ mode: "payment" | "subscription" | "setup";
663
+ uiMode?: "embedded" | "redirect";
664
+ quantity?: number;
665
+ returnUrl: string;
666
+ trialDays?: number;
667
+ accountId?: string;
668
+ customerEmail?: string;
669
+ /** Seller/recipient connected account to route funds to (destination charge). */
670
+ destinationAccountId?: string;
671
+ /** Multiple recipients (store + affiliate[s]); >1 routes via separate charges & transfers. */
672
+ split?: SplitRecipient[];
673
+ /** Per-call platform fee override; falls back to the configured default. */
674
+ fee?: FeeOverride;
675
+ /** Charge total (minor units) for one-time payment fee computation. */
676
+ amount?: number;
677
+ metadata?: Record<string, string>;
678
+ sessionOverrides?: Record<string, unknown>;
679
+ },
680
+ ) {
681
+ const { fee, ...rest } = opts;
682
+ return checkoutImpl.createCheckoutSession(this.stripe(), this.component, ctx, {
683
+ ...rest,
684
+ // Fees apply to destination or split sales; resolve override → default.
685
+ feeConfig:
686
+ opts.destinationAccountId || opts.split?.length
687
+ ? this.resolveFee(fee)
688
+ : undefined,
689
+ defaultStatementDescriptorSuffix: this._statementDescriptorSuffix,
690
+ });
691
+ }
692
+
693
+ async getCheckoutSession(
694
+ ctx: RunCtx,
695
+ opts: { sessionId: string },
696
+ ): Promise<StripeComponentCheckoutSession | null> {
697
+ return checkoutImpl.getCheckoutSession(this.component, ctx, opts);
698
+ }
699
+
700
+ async getCheckoutSessionByStripeId(
701
+ ctx: RunCtx,
702
+ opts: { stripeSessionId: string },
703
+ ): Promise<StripeComponentCheckoutSession | null> {
704
+ return checkoutImpl.getCheckoutSessionByStripeId(this.component, ctx, opts);
705
+ }
706
+
707
+ async listCheckoutSessionsByUser(
708
+ ctx: RunCtx,
709
+ opts: { userId: string; status?: string },
710
+ ): Promise<StripeComponentCheckoutSession[]> {
711
+ return checkoutImpl.listCheckoutSessionsByUser(this.component, ctx, opts);
712
+ }
713
+
714
+ async upsertCheckoutSession(
715
+ ctx: RunCtx,
716
+ opts: {
717
+ stripeSessionId: string;
718
+ userId: string;
719
+ orgId?: string;
720
+ accountId?: string;
721
+ mode: "payment" | "subscription" | "setup";
722
+ status: "open" | "complete" | "expired";
723
+ clientSecret?: string;
724
+ url?: string;
725
+ priceId?: string;
726
+ metadata?: Record<string, unknown>;
727
+ },
728
+ ) {
729
+ return checkoutImpl.upsertCheckoutSession(this.component, ctx, opts);
730
+ }
731
+
732
+ async updateCheckoutSession(
733
+ ctx: RunCtx,
734
+ opts: {
735
+ stripeSessionId: string;
736
+ metadata?: Record<string, string>;
737
+ },
738
+ ) {
739
+ return checkoutImpl.updateCheckoutSession(this.stripe(), ctx, opts);
740
+ }
741
+
742
+ // ============================================================================
743
+ // SUBSCRIPTION METHODS
744
+ // ============================================================================
745
+
746
+ /**
747
+ * Create a subscription directly for a V2 buyer (`customer_account`), off the
748
+ * checkout flow. With a `destinationAccountId` it routes funds to the seller
749
+ * and takes the platform fee (override → configured default).
750
+ */
751
+ async createSubscription(
752
+ ctx: RunCtx,
753
+ opts: {
754
+ userId: string;
755
+ orgId?: string;
756
+ customerAccount: string;
757
+ stripePriceId: string;
758
+ destinationAccountId?: string;
759
+ /** Multiple recipients (store + affiliate[s]); >1 routes via separate charges & transfers. */
760
+ split?: SplitRecipient[];
761
+ fee?: FeeOverride;
762
+ trialDays?: number;
763
+ metadata?: Record<string, string>;
764
+ /** Stripe idempotency key for retry-safe subscription creation. */
765
+ idempotencyKey?: string;
766
+ },
767
+ ) {
768
+ const { fee, ...rest } = opts;
769
+ return subscriptionsImpl.createSubscription(this.stripe(), this.component, ctx, {
770
+ ...rest,
771
+ feeConfig:
772
+ opts.destinationAccountId || opts.split?.length
773
+ ? this.resolveFee(fee)
774
+ : undefined,
775
+ defaultStatementDescriptorSuffix: this._statementDescriptorSuffix,
776
+ });
777
+ }
778
+
779
+ async getSubscription(
780
+ ctx: RunCtx,
781
+ opts: { subscriptionId: string },
782
+ ): Promise<StripeComponentSubscription | null> {
783
+ return subscriptionsImpl.getSubscription(this.component, ctx, opts);
784
+ }
785
+
786
+ async getSubscriptionByStripeId(
787
+ ctx: RunCtx,
788
+ opts: { stripeSubscriptionId: string },
789
+ ): Promise<StripeComponentSubscription | null> {
790
+ return subscriptionsImpl.getSubscriptionByStripeId(
791
+ this.component,
792
+ ctx,
793
+ opts,
794
+ );
795
+ }
796
+
797
+ async cancelSubscription(
798
+ ctx: RunCtx,
799
+ opts: { stripeSubscriptionId: string; cancelAtPeriodEnd?: boolean },
800
+ ) {
801
+ return subscriptionsImpl.cancelSubscription(this.stripe(), ctx, opts);
802
+ }
803
+
804
+ async reactivateSubscription(
805
+ ctx: RunCtx,
806
+ opts: { stripeSubscriptionId: string },
807
+ ) {
808
+ return subscriptionsImpl.reactivateSubscription(this.stripe(), ctx, opts);
809
+ }
810
+
811
+ async updateSubscriptionQuantity(
812
+ ctx: RunCtx,
813
+ opts: { stripeSubscriptionId: string; quantity: number },
814
+ ) {
815
+ return subscriptionsImpl.updateSubscriptionQuantity(
816
+ this.stripe(),
817
+ ctx,
818
+ opts,
819
+ );
820
+ }
821
+
822
+ async pauseSubscription(
823
+ ctx: RunCtx,
824
+ opts: {
825
+ stripeSubscriptionId: string;
826
+ behavior?: "keep_as_draft" | "mark_uncollectible" | "void";
827
+ resumesAt?: number;
828
+ },
829
+ ) {
830
+ return subscriptionsImpl.pauseSubscription(this.stripe(), ctx, opts);
831
+ }
832
+
833
+ async resumeSubscription(
834
+ ctx: RunCtx,
835
+ opts: { stripeSubscriptionId: string },
836
+ ) {
837
+ return subscriptionsImpl.resumeSubscription(this.stripe(), ctx, opts);
838
+ }
839
+
840
+ async updateSubscriptionPrice(
841
+ ctx: RunCtx,
842
+ opts: {
843
+ stripeSubscriptionId: string;
844
+ stripePriceId: string;
845
+ prorationBehavior?: "always_invoice" | "create_prorations" | "none";
846
+ },
847
+ ) {
848
+ return subscriptionsImpl.updateSubscriptionPrice(this.stripe(), ctx, opts);
849
+ }
850
+
851
+ async updateSubscriptionMetadata(
852
+ ctx: RunCtx,
853
+ opts: { stripeSubscriptionId: string; metadata: Record<string, string> },
854
+ ) {
855
+ return subscriptionsImpl.updateSubscriptionMetadata(
856
+ this.stripe(),
857
+ ctx,
858
+ opts,
859
+ );
860
+ }
861
+
862
+ async updateSubscriptionTrialEnd(
863
+ ctx: RunCtx,
864
+ opts: { stripeSubscriptionId: string; trialEnd: "now" | number },
865
+ ) {
866
+ return subscriptionsImpl.updateSubscriptionTrialEnd(
867
+ this.stripe(),
868
+ ctx,
869
+ opts,
870
+ );
871
+ }
872
+
873
+ async listSubscriptions(
874
+ ctx: RunCtx,
875
+ opts?: {
876
+ stripeAccountId?: string;
877
+ status?: SubscriptionStatus;
878
+ limit?: number;
879
+ },
880
+ ): Promise<StripeComponentSubscription[]> {
881
+ return subscriptionsImpl.listSubscriptions(this.component, ctx, opts);
882
+ }
883
+
884
+ async listStripeSubscriptions(
885
+ ctx: RunCtx,
886
+ opts?: {
887
+ status?: Stripe.SubscriptionListParams.Status;
888
+ limit?: number;
889
+ },
890
+ ) {
891
+ return subscriptionsImpl.listStripeSubscriptions(this.stripe(), ctx, opts);
892
+ }
893
+
894
+ async listSubscriptionsByUser(
895
+ ctx: RunCtx,
896
+ opts: { userId: string; status?: string },
897
+ ): Promise<StripeComponentSubscription[]> {
898
+ return subscriptionsImpl.listSubscriptionsByUser(this.component, ctx, opts);
899
+ }
900
+
901
+ async listSubscriptionsByOrg(
902
+ ctx: RunCtx,
903
+ opts: { orgId: string; status?: string },
904
+ ): Promise<StripeComponentSubscription[]> {
905
+ return subscriptionsImpl.listSubscriptionsByOrg(this.component, ctx, opts);
906
+ }
907
+
908
+ /** List a buyer's subscriptions scoped to one store (recipient account). */
909
+ async listSubscriptionsByUserAndStore(
910
+ ctx: RunCtx,
911
+ opts: { userId: string; destinationAccountId: string; status?: string },
912
+ ): Promise<StripeComponentSubscription[]> {
913
+ return subscriptionsImpl.listSubscriptionsByUserAndStore(
914
+ this.component,
915
+ ctx,
916
+ opts,
917
+ );
918
+ }
919
+
920
+ async getActiveSubscription(
921
+ ctx: RunCtx,
922
+ opts: { userId: string; orgId?: string; destinationAccountId?: string },
923
+ ): Promise<StripeComponentSubscription | null> {
924
+ return subscriptionsImpl.getActiveSubscription(this.component, ctx, opts);
925
+ }
926
+
927
+ async upsertSubscription(
928
+ ctx: RunCtx,
929
+ opts: {
930
+ stripeSubscriptionId: string;
931
+ accountId?: string;
932
+ userId: string;
933
+ orgId?: string;
934
+ status:
935
+ | "active"
936
+ | "trialing"
937
+ | "past_due"
938
+ | "canceled"
939
+ | "incomplete"
940
+ | "unpaid"
941
+ | "paused";
942
+ priceId?: string;
943
+ quantity?: number;
944
+ currentPeriodStart?: string;
945
+ currentPeriodEnd?: string;
946
+ cancelAtPeriodEnd: boolean;
947
+ canceledAt?: string;
948
+ isTrialing: boolean;
949
+ trialStart?: string;
950
+ trialEnd?: string;
951
+ metadata?: Record<string, unknown>;
952
+ },
953
+ ) {
954
+ return subscriptionsImpl.upsertSubscription(this.component, ctx, opts);
955
+ }
956
+
957
+ async getTrialStatus(ctx: RunCtx, opts: { subscriptionId: string }) {
958
+ return subscriptionsImpl.getTrialStatus(this.component, ctx, opts);
959
+ }
960
+
961
+ // ============================================================================
962
+ // INVOICE METHODS
963
+ // ============================================================================
964
+
965
+ async listInvoices(
966
+ ctx: RunCtx,
967
+ opts?: {
968
+ stripeAccountId?: string;
969
+ userId?: string;
970
+ subscriptionId?: string;
971
+ status?: string;
972
+ limit?: number;
973
+ },
974
+ ): Promise<StripeComponentInvoice[]> {
975
+ return invoicesImpl.listInvoices(this.component, ctx, opts);
976
+ }
977
+
978
+ async listInvoicesByUser(ctx: RunCtx, opts: { userId: string }) {
979
+ return invoicesImpl.listInvoicesByUser(this.component, ctx, opts);
980
+ }
981
+
982
+ async getInvoice(
983
+ ctx: RunCtx,
984
+ opts: { stripeInvoiceId: string },
985
+ ): Promise<StripeComponentInvoice | null> {
986
+ return invoicesImpl.getInvoice(this.component, ctx, opts);
987
+ }
988
+
989
+ async getInvoiceByStripeId(
990
+ ctx: RunCtx,
991
+ opts: { stripeInvoiceId: string },
992
+ ): Promise<StripeComponentInvoice | null> {
993
+ return invoicesImpl.getInvoice(this.component, ctx, opts);
994
+ }
995
+
996
+ async upsertInvoice(
997
+ ctx: RunCtx,
998
+ opts: {
999
+ stripeInvoiceId: string;
1000
+ userId: string;
1001
+ orgId?: string;
1002
+ accountId?: string;
1003
+ subscriptionId?: string;
1004
+ status: InvoiceStatus;
1005
+ currency: string;
1006
+ amountDue: number;
1007
+ amountPaid: number;
1008
+ hostedInvoiceUrl?: string;
1009
+ invoicePdf?: string;
1010
+ periodStart?: string;
1011
+ periodEnd?: string;
1012
+ metadata?: Record<string, unknown>;
1013
+ },
1014
+ ) {
1015
+ return invoicesImpl.upsertInvoice(this.component, ctx, opts);
1016
+ }
1017
+
1018
+ async getPublishableKey(ctx: RunCtx): Promise<string | null> {
1019
+ return configImpl.getPublishableKey(this.component, ctx);
1020
+ }
1021
+
1022
+ async getStripeMode(ctx: RunCtx): Promise<StripeMode> {
1023
+ return configImpl.getStripeMode(this.component, ctx);
1024
+ }
1025
+
1026
+ async getInvoiceFromStripe(ctx: RunCtx, opts: { stripeInvoiceId: string }) {
1027
+ return invoicesImpl.getInvoiceFromStripe(this.stripe(), ctx, opts);
1028
+ }
1029
+
1030
+ // ============================================================================
1031
+ // PAYMENT METHOD METHODS
1032
+ // ============================================================================
1033
+
1034
+ async listPaymentMethods(
1035
+ ctx: RunCtx,
1036
+ opts: { stripeCustomerId: string; type?: string },
1037
+ ) {
1038
+ return paymentMethodsImpl.listPaymentMethods(this.stripe(), ctx, opts);
1039
+ }
1040
+
1041
+ async getPaymentMethod(ctx: RunCtx, opts: { paymentMethodId: string }) {
1042
+ return paymentMethodsImpl.getPaymentMethod(this.stripe(), ctx, opts);
1043
+ }
1044
+
1045
+ async attachPaymentMethod(
1046
+ ctx: RunCtx,
1047
+ opts: { paymentMethodId: string; stripeCustomerId: string },
1048
+ ) {
1049
+ return paymentMethodsImpl.attachPaymentMethod(this.stripe(), ctx, opts);
1050
+ }
1051
+
1052
+ async detachPaymentMethod(ctx: RunCtx, opts: { paymentMethodId: string }) {
1053
+ return paymentMethodsImpl.detachPaymentMethod(this.stripe(), ctx, opts);
1054
+ }
1055
+
1056
+ async setDefaultPaymentMethod(
1057
+ ctx: RunCtx,
1058
+ opts: { stripeAccountId: string; paymentMethodId: string },
1059
+ ) {
1060
+ return paymentMethodsImpl.setDefaultPaymentMethod(this.stripe(), ctx, opts);
1061
+ }
1062
+
1063
+ // ============================================================================
1064
+ // ACCOUNT LINK METHODS
1065
+ // ============================================================================
1066
+
1067
+ async createAccountLink(
1068
+ ctx: RunCtx,
1069
+ opts: {
1070
+ stripeAccountId: string;
1071
+ refreshUrl: string;
1072
+ returnUrl: string;
1073
+ type: "account_onboarding" | "account_update";
1074
+ },
1075
+ ) {
1076
+ return accountLinksImpl.createAccountLink(this.stripe(), ctx, opts);
1077
+ }
1078
+
1079
+ async createV2AccountLink(
1080
+ ctx: RunCtx,
1081
+ opts: {
1082
+ stripeAccountId: string;
1083
+ type: "account_onboarding" | "account_update";
1084
+ refreshUrl: string;
1085
+ returnUrl: string;
1086
+ configurations?: string[];
1087
+ },
1088
+ ) {
1089
+ return accountLinksImpl.createV2AccountLink(this.stripe(), ctx, opts);
1090
+ }
1091
+
1092
+ async createAccountSession(
1093
+ ctx: RunCtx,
1094
+ opts: {
1095
+ stripeAccountId: string;
1096
+ components: Stripe.AccountSessionCreateParams.Components;
1097
+ },
1098
+ ) {
1099
+ return accountLinksImpl.createAccountSession(this.stripe(), ctx, opts);
1100
+ }
1101
+
1102
+ /**
1103
+ * Client secret for a seller's embedded disputes surface (disputes_list +
1104
+ * payment_disputes), so they can view and respond to their own disputes.
1105
+ */
1106
+ async createDisputeSession(ctx: RunCtx, opts: { stripeAccountId: string }) {
1107
+ return accountLinksImpl.createDisputeSession(this.stripe(), ctx, opts);
1108
+ }
1109
+
1110
+ async createLoginLink(ctx: RunCtx, opts: { stripeAccountId: string }) {
1111
+ return accountLinksImpl.createLoginLink(this.stripe(), ctx, opts);
1112
+ }
1113
+
1114
+ async getAccountLinkWithStatus(
1115
+ ctx: RunCtx,
1116
+ opts: {
1117
+ stripeAccountId: string;
1118
+ refreshUrl: string;
1119
+ returnUrl: string;
1120
+ },
1121
+ ): Promise<AccountLinkWithStatus> {
1122
+ return accountLinksImpl.getAccountLinkWithStatus(this.stripe(), ctx, opts);
1123
+ }
1124
+
1125
+ async createBillingPortalSession(
1126
+ ctx: RunCtx,
1127
+ opts: { stripeAccountId: string; returnUrl: string },
1128
+ ) {
1129
+ return accountLinksImpl.createBillingPortalSession(
1130
+ this.stripe(),
1131
+ ctx,
1132
+ opts,
1133
+ );
1134
+ }
1135
+
1136
+ async getCountrySpecs(ctx: RunCtx, opts: { countryCode: string }) {
1137
+ return accountLinksImpl.getCountrySpecs(this.stripe(), ctx, opts);
1138
+ }
1139
+
1140
+ // ============================================================================
1141
+ // PAYOUT METHODS
1142
+ // ============================================================================
1143
+
1144
+ async createPayout(
1145
+ ctx: RunCtx,
1146
+ opts: {
1147
+ stripeAccountId: string;
1148
+ amount: number;
1149
+ currency?: string;
1150
+ metadata?: Record<string, string>;
1151
+ /** Stripe idempotency key for retry-safe payout creation. */
1152
+ idempotencyKey?: string;
1153
+ },
1154
+ ) {
1155
+ return payoutsImpl.createPayout(this.stripe(), ctx, opts);
1156
+ }
1157
+
1158
+ /**
1159
+ * Reverse the transfers funded by a charge (pro-rata by `percent`, a total
1160
+ * `amount`, or in full). The reversal primitive behind dispute clawback and
1161
+ * refunds; idempotent and ledger-tracked.
1162
+ */
1163
+ async reverseTransfers(
1164
+ ctx: RunCtx,
1165
+ opts: {
1166
+ sourceChargeId: string;
1167
+ percent?: number;
1168
+ amount?: number;
1169
+ operationId?: string;
1170
+ },
1171
+ ) {
1172
+ return transfersImpl.reverseTransfers(this.stripe(), this.component, ctx, opts);
1173
+ }
1174
+
1175
+ /**
1176
+ * List "wedged" reversal legs (BTS-74): legs whose reversal claim frontier is
1177
+ * stuck ahead of the confirmed reversed amount because the claiming operation
1178
+ * died permanently, blocking every successor on that leg. An ops diagnostic;
1179
+ * feed a returned `operationId` into {@link reclaimReversalClaim} to resolve it.
1180
+ */
1181
+ async listWedgedReversalClaims(ctx: RunCtx) {
1182
+ return transfersImpl.listWedgedReversalClaims(this.component, ctx);
1183
+ }
1184
+
1185
+ /**
1186
+ * Resolve a permanently-dead reversal claim (BTS-74). `mode: "reexecute"`
1187
+ * (default) replays the recorded reversal under its original idempotency keys
1188
+ * to fill the hole and unblock successors; `mode: "release"` abandons the
1189
+ * claim after verifying (via the >24h idempotency window and live Stripe
1190
+ * `amount_reversed`) that the money never moved. Re-execution is the safe
1191
+ * default; release is for claims proven dead.
1192
+ */
1193
+ async reclaimReversalClaim(
1194
+ ctx: RunCtx,
1195
+ opts: {
1196
+ operationId: string;
1197
+ mode?: "reexecute" | "release";
1198
+ minAgeMs?: number;
1199
+ now?: number;
1200
+ },
1201
+ ) {
1202
+ return transfersImpl.reclaimReversalClaim(
1203
+ this.stripe(),
1204
+ this.component,
1205
+ ctx,
1206
+ opts,
1207
+ );
1208
+ }
1209
+
1210
+ /**
1211
+ * The original split legs of one sale (reinstatement rows excluded) — the
1212
+ * read behind the `useSplitBreakdown` hook / per-sale breakdown UIs.
1213
+ */
1214
+ async listTransfersByCharge(
1215
+ ctx: RunCtx,
1216
+ opts: { sourceChargeId: string; limit?: number },
1217
+ ) {
1218
+ return transfersImpl.listTransfersByCharge(this.component, ctx, opts);
1219
+ }
1220
+
1221
+ /**
1222
+ * A recipient's transfer ledger (the earnings view — includes reinstatements)
1223
+ * — the read behind the `useEarnings` hook.
1224
+ */
1225
+ async listTransfersByAccount(
1226
+ ctx: RunCtx,
1227
+ opts: { destinationAccountId: string; limit?: number },
1228
+ ) {
1229
+ return transfersImpl.listTransfersByAccount(this.component, ctx, opts);
1230
+ }
1231
+
1232
+ /**
1233
+ * Retrieve a connected account's balance (BTS-65), scoped to that account via
1234
+ * the `Stripe-Account` header. Returns one `AccountBalance`
1235
+ * (`{ available, pending, currency }`, minor units) per currency — each entry
1236
+ * feeds the headless `PayoutSchedule` component's `balance` prop directly.
1237
+ */
1238
+ async getAccountBalance(_ctx: RunCtx, opts: { stripeAccountId: string }) {
1239
+ return payoutsImpl.getAccountBalance(this.stripe(), opts);
1240
+ }
1241
+
1242
+ async getPayout(ctx: RunCtx, opts: { payoutId: string }) {
1243
+ return payoutsImpl.getPayout(this.component, ctx, opts);
1244
+ }
1245
+
1246
+ async listPayouts(
1247
+ ctx: RunCtx,
1248
+ opts?: { stripeAccountId?: string; status?: PayoutStatus; limit?: number },
1249
+ ) {
1250
+ return payoutsImpl.listPayouts(this.component, ctx, opts);
1251
+ }
1252
+
1253
+ // ============================================================================
1254
+ // REFUND METHODS
1255
+ // ============================================================================
1256
+
1257
+ /**
1258
+ * Issue a refund (BTS-34). `refundApplicationFee` and `reverseTransfer`
1259
+ * default true: the platform fee is returned and the destination transfer
1260
+ * reversed pro-rata (Stripe-native for partials) — each sent only when the
1261
+ * charge actually carries a fee / transfer. Split sales are clawed back by
1262
+ * the `refund.created` webhook's transfer math instead. A transfer already
1263
+ * partially reversed by the BTS-60 fee collection is safe to fully refund:
1264
+ * Stripe caps the reversal at the remainder instead of erroring (BTS-66,
1265
+ * live-verified). See {@link refundsImpl.createRefund}.
1266
+ */
1267
+ async createRefund(
1268
+ ctx: RunCtx,
1269
+ opts: {
1270
+ stripePaymentIntentId?: string;
1271
+ stripeChargeId?: string;
1272
+ amount?: number;
1273
+ reason?: "duplicate" | "fraudulent" | "requested_by_customer";
1274
+ metadata?: Record<string, string>;
1275
+ stripeAccountId?: string;
1276
+ refundApplicationFee?: boolean;
1277
+ reverseTransfer?: boolean;
1278
+ /** Stripe idempotency key for retry-safe refund creation. */
1279
+ idempotencyKey?: string;
1280
+ /**
1281
+ * Who is initiating the refund (BTS-35). A platform admin may refund any
1282
+ * sale; a seller may refund only sales routed to their own account. Omit
1283
+ * for platform-initiated (unrestricted) refunds.
1284
+ */
1285
+ actor?: RefundActor;
1286
+ },
1287
+ ): Promise<{ stripeRefundId: string }> {
1288
+ return refundsImpl.createRefund(this.stripe(), this.component, ctx, opts);
1289
+ }
1290
+
1291
+ async getRefundByStripeId(
1292
+ ctx: RunCtx,
1293
+ opts: { stripeRefundId: string },
1294
+ ): Promise<StripeComponentRefund | null> {
1295
+ return refundsImpl.getRefundByStripeId(this.component, ctx, opts);
1296
+ }
1297
+
1298
+ async listRefunds(
1299
+ ctx: RunCtx,
1300
+ opts?: {
1301
+ stripeAccountId?: string;
1302
+ stripePaymentIntentId?: string;
1303
+ status?: RefundStatus;
1304
+ limit?: number;
1305
+ },
1306
+ ): Promise<StripeComponentRefund[]> {
1307
+ return refundsImpl.listRefunds(this.component, ctx, opts);
1308
+ }
1309
+
1310
+ // ============================================================================
1311
+ // DISPUTE METHODS
1312
+ // ============================================================================
1313
+
1314
+ async getDisputeByStripeId(
1315
+ ctx: RunCtx,
1316
+ opts: { stripeDisputeId: string },
1317
+ ): Promise<StripeComponentDispute | null> {
1318
+ return disputesImpl.getDisputeByStripeId(this.component, ctx, opts);
1319
+ }
1320
+
1321
+ /**
1322
+ * Read a dispute with its evidence-submission countdown (evidenceDueBy +
1323
+ * days-remaining/overdue) — the seller UI's deadline surface (BTS-31).
1324
+ */
1325
+ async getDisputeWithCountdown(
1326
+ ctx: RunCtx,
1327
+ opts: { stripeDisputeId: string; now?: Date },
1328
+ ) {
1329
+ return disputesImpl.getDisputeWithCountdown(this.component, ctx, opts);
1330
+ }
1331
+
1332
+ async listDisputes(
1333
+ ctx: RunCtx,
1334
+ opts?: {
1335
+ stripeAccountId?: string;
1336
+ stripePaymentIntentId?: string;
1337
+ status?: DisputeStatus;
1338
+ limit?: number;
1339
+ },
1340
+ ): Promise<StripeComponentDispute[]> {
1341
+ return disputesImpl.listDisputes(this.component, ctx, opts);
1342
+ }
1343
+
1344
+ /**
1345
+ * Submit or stage dispute evidence. Stripe's `submit` defaults to TRUE, so
1346
+ * this method stages by default: EVERY call sends an explicit
1347
+ * `submit: false` — evidence-bearing or metadata-only — unless you pass
1348
+ * `submit: true` to submit to the bank (one-shot, outcome-affecting;
1349
+ * BTS-61, BTS-72). See {@link disputesImpl.updateDispute}.
1350
+ */
1351
+ async updateDispute(
1352
+ ctx: RunCtx,
1353
+ opts: {
1354
+ stripeDisputeId: string;
1355
+ evidence?: Stripe.DisputeUpdateParams.Evidence;
1356
+ metadata?: Record<string, string>;
1357
+ submit?: boolean;
1358
+ stripeAccountId?: string;
1359
+ /**
1360
+ * Who is acting on the dispute (BTS-107). A platform admin may act on any
1361
+ * dispute; a seller may act only on a dispute for a sale routed to their
1362
+ * own account. Omit for platform-initiated (unrestricted) actions.
1363
+ */
1364
+ actor?: RefundActor;
1365
+ },
1366
+ ): Promise<{ success: true }> {
1367
+ return disputesImpl.updateDispute(this.stripe(), this.component, ctx, opts);
1368
+ }
1369
+
1370
+ async closeDispute(
1371
+ ctx: RunCtx,
1372
+ opts: {
1373
+ stripeDisputeId: string;
1374
+ stripeAccountId?: string;
1375
+ /** See {@link updateDispute}'s `actor` (BTS-107). Omit for unrestricted. */
1376
+ actor?: RefundActor;
1377
+ },
1378
+ ): Promise<{ success: true }> {
1379
+ return disputesImpl.closeDispute(this.stripe(), this.component, ctx, opts);
1380
+ }
1381
+
1382
+ // ============================================================================
1383
+ // WEBHOOK ENDPOINT MANAGEMENT
1384
+ // ============================================================================
1385
+
1386
+ async listWebhookEndpoints(ctx: RunCtx, opts?: { limit?: number }) {
1387
+ return webhookEndpointsImpl.listWebhookEndpoints(this.stripe(), ctx, opts);
1388
+ }
1389
+
1390
+ async createWebhookEndpoint(
1391
+ ctx: RunCtx,
1392
+ opts: {
1393
+ url: string;
1394
+ description?: string;
1395
+ enabledEvents?: string[];
1396
+ },
1397
+ ): Promise<{ id: string; secret: string; url: string }> {
1398
+ return webhookEndpointsImpl.createWebhookEndpoint(this.stripe(), ctx, opts);
1399
+ }
1400
+
1401
+ async listEventDestinations(ctx: RunCtx, opts?: { limit?: number }) {
1402
+ return webhookEndpointsImpl.listEventDestinations(this.stripe(), ctx, opts);
1403
+ }
1404
+
1405
+ async setupEventDestination(
1406
+ ctx: RunCtx,
1407
+ opts: {
1408
+ url: string;
1409
+ name?: string;
1410
+ description?: string;
1411
+ enabledEvents?: string[];
1412
+ eventPayload?: "snapshot" | "thin";
1413
+ },
1414
+ ): Promise<{
1415
+ id: string;
1416
+ secret: string;
1417
+ url: string;
1418
+ enabledEvents: string[];
1419
+ created: boolean;
1420
+ }> {
1421
+ return webhookEndpointsImpl.setupEventDestination(this.stripe(), ctx, opts);
1422
+ }
1423
+
1424
+ // ============================================================================
1425
+ // WEBHOOK EVENT QUERIES
1426
+ // ============================================================================
1427
+
1428
+ async listWebhookEvents(
1429
+ ctx: RunCtx,
1430
+ opts?: { eventType?: string; status?: string; limit?: number },
1431
+ ) {
1432
+ return (await ctx.runQuery(
1433
+ componentRef(this.component, "webhooks/queries/listWebhookEvents"),
1434
+ opts ?? {},
1435
+ )) as Array<{
1436
+ _id: string;
1437
+ _creationTime: number;
1438
+ stripeEventId: string;
1439
+ eventType: string;
1440
+ livemode?: boolean;
1441
+ processedAt: number;
1442
+ status: "pending" | "processed" | "failed";
1443
+ lastError?: string;
1444
+ }>;
1445
+ }
1446
+
1447
+ // ============================================================================
1448
+ // DATA MANAGEMENT
1449
+ // ============================================================================
1450
+
1451
+ async clearAll(ctx: RunCtx): Promise<{ cleared: number; tables: string[] }> {
1452
+ return dataImpl.clearAll(this.component, ctx);
1453
+ }
1454
+
1455
+ // ============================================================================
1456
+ // SYNC METHODS
1457
+ // ============================================================================
1458
+
1459
+ async syncAllAccounts(ctx: RunCtx) {
1460
+ return accountsImpl.syncAllAccounts(this.stripe(), this.component, ctx);
1461
+ }
1462
+
1463
+ async syncAllProducts(ctx: RunCtx) {
1464
+ return productsImpl.syncAllProducts(this.stripe(), this.component, ctx);
1465
+ }
1466
+
1467
+ async syncAllSubscriptions(ctx: RunCtx) {
1468
+ return subscriptionsImpl.syncAllSubscriptions(
1469
+ this.stripe(),
1470
+ this.component,
1471
+ ctx,
1472
+ );
1473
+ }
1474
+
1475
+ // ============================================================================
1476
+ // WEBHOOK HANDLER EXPORT (BetterAuth-style)
1477
+ // ============================================================================
1478
+
1479
+ /**
1480
+ * Build the two webhook handler function definitions for the app to export
1481
+ * from a Convex module, e.g. in `convex/stripe.ts`:
1482
+ *
1483
+ * ```ts
1484
+ * export const { syncWebhook, asyncWebhook } = stripe.webhookHandlers();
1485
+ * ```
1486
+ *
1487
+ * then pass the module to `registerRoutes` as
1488
+ * `webhooks: internal.stripe` (no cast needed).
1489
+ *
1490
+ * Contract:
1491
+ * - `syncWebhook` is an internal mutation that routes by `dispatcher` and
1492
+ * performs the component table upsert AND the configured sync trigger in
1493
+ * the SAME transaction. A trigger that throws rolls back the upsert.
1494
+ * - `asyncWebhook` is an internal action, scheduled by the webhook handler
1495
+ * AFTER the upsert transaction commits, that routes by `hook` and runs the
1496
+ * configured async hook (best-effort side effects).
1497
+ */
1498
+ // NOTE: no explicit return annotation — the inferred type preserves the
1499
+ // `RegisteredMutation`/`RegisteredAction` brands so Convex codegen registers
1500
+ // the app's re-exported `syncWebhook`/`asyncWebhook` (annotating the return as
1501
+ // `WebhookHandlerRefs` would erase them to `FunctionReference` and drop the
1502
+ // functions from the generated `internal.<module>` API).
1503
+ webhookHandlers() {
1504
+ const component = this.component;
1505
+ const triggers = this._triggers;
1506
+ const hooks = this._hooks;
1507
+
1508
+ type DispatcherSpec = {
1509
+ /** Component query path used to read the doc before/after the upsert */
1510
+ getter: string;
1511
+ /** Query arg name for the Stripe id lookup */
1512
+ idArg: string;
1513
+ /** Field in `data` holding the Stripe id */
1514
+ idField: string;
1515
+ /** Component mutation path performing the upsert */
1516
+ upsert: string;
1517
+ };
1518
+
1519
+ /** Runs `dispatch` with the post-upsert doc (and pre-upsert doc, if any). */
1520
+ type Dispatch<T> = (
1521
+ ctx: SyncTriggerCtx,
1522
+ newDoc: T,
1523
+ oldDoc: T | null,
1524
+ ) => Promise<void>;
1525
+
1526
+ /**
1527
+ * Upsert a component doc and then run `dispatch` with the post-upsert doc
1528
+ * (and the pre-upsert doc, if any). When no `dispatch` is configured the
1529
+ * before/after doc reads are skipped and only the upsert runs.
1530
+ *
1531
+ * This is the extracted body of every old `triggersApi()` dispatcher,
1532
+ * keyed by name so a single `syncWebhook` mutation can run them all.
1533
+ */
1534
+ const runUpsertAndTrigger = async <T>(
1535
+ ctx: SyncTriggerCtx,
1536
+ name: string,
1537
+ spec: DispatcherSpec,
1538
+ dispatch: Dispatch<T> | undefined,
1539
+ record: Record<string, unknown>,
1540
+ ): Promise<void> => {
1541
+ const id = record[spec.idField];
1542
+ if (typeof id !== "string") {
1543
+ throw new Error(
1544
+ `[better-stripe] ${name}: missing ${spec.idField} in data`,
1545
+ );
1546
+ }
1547
+ if (!dispatch) {
1548
+ // No trigger configured — upsert only, skip the doc reads.
1549
+ await ctx.runMutation(componentRef(component, spec.upsert), record);
1550
+ return;
1551
+ }
1552
+ const lookup = { [spec.idArg]: id };
1553
+ const oldDoc = (await ctx.runQuery(
1554
+ componentRef(component, spec.getter),
1555
+ lookup,
1556
+ )) as T | null;
1557
+ await ctx.runMutation(componentRef(component, spec.upsert), record);
1558
+ const newDoc = (await ctx.runQuery(
1559
+ componentRef(component, spec.getter),
1560
+ lookup,
1561
+ )) as T | null;
1562
+ if (newDoc === null) {
1563
+ // Mutations read their own writes, so this cannot happen;
1564
+ // fail loudly if it ever does.
1565
+ throw new Error(
1566
+ `[better-stripe] ${name}: doc not found after upsert ` +
1567
+ `(${spec.idField}=${id})`,
1568
+ );
1569
+ }
1570
+ await dispatch(ctx, newDoc, oldDoc);
1571
+ };
1572
+
1573
+ /** Standard create/update split used by most dispatchers. */
1574
+ const splitCreateUpdate = <T>(
1575
+ onCreate?: (ctx: SyncTriggerCtx, doc: T) => Promise<void>,
1576
+ onUpdate?: (ctx: SyncTriggerCtx, newDoc: T, oldDoc: T) => Promise<void>,
1577
+ ): Dispatch<T> | undefined =>
1578
+ onCreate || onUpdate
1579
+ ? async (ctx, newDoc, oldDoc) => {
1580
+ if (oldDoc === null) {
1581
+ await onCreate?.(ctx, newDoc);
1582
+ } else {
1583
+ await onUpdate?.(ctx, newDoc, oldDoc);
1584
+ }
1585
+ }
1586
+ : undefined;
1587
+
1588
+ const onCheckoutCompleted = triggers?.checkoutSession?.onCompleted;
1589
+ const onSubscriptionDeleted = triggers?.subscription?.onDelete;
1590
+
1591
+ /**
1592
+ * One routing entry per dispatcher. `run` closes over the same spec +
1593
+ * dispatch wiring the old per-dispatcher mutations used, so `syncWebhook`
1594
+ * is a mechanical collapse — not a behavior change.
1595
+ */
1596
+ const SYNC: Record<
1597
+ TriggerDispatcherName,
1598
+ (ctx: SyncTriggerCtx, record: Record<string, unknown>) => Promise<void>
1599
+ > = {
1600
+ accountUpserted: (ctx, record) =>
1601
+ runUpsertAndTrigger<StripeComponentAccount>(
1602
+ ctx,
1603
+ "accountUpserted",
1604
+ {
1605
+ getter: "core/queries/getAccountByStripeId",
1606
+ idArg: "stripeAccountId",
1607
+ idField: "stripeAccountId",
1608
+ upsert: DISPATCHER_UPSERT_PATHS.accountUpserted,
1609
+ },
1610
+ splitCreateUpdate(
1611
+ triggers?.account?.onCreate,
1612
+ triggers?.account?.onUpdate,
1613
+ ),
1614
+ record,
1615
+ ),
1616
+ productUpserted: (ctx, record) =>
1617
+ runUpsertAndTrigger<StripeComponentProduct>(
1618
+ ctx,
1619
+ "productUpserted",
1620
+ {
1621
+ getter: "products/queries/getProductByStripeId",
1622
+ idArg: "stripeProductId",
1623
+ idField: "stripeProductId",
1624
+ upsert: DISPATCHER_UPSERT_PATHS.productUpserted,
1625
+ },
1626
+ splitCreateUpdate(
1627
+ triggers?.product?.onCreate,
1628
+ triggers?.product?.onUpdate,
1629
+ ),
1630
+ record,
1631
+ ),
1632
+ priceUpserted: (ctx, record) =>
1633
+ runUpsertAndTrigger<StripeComponentPrice>(
1634
+ ctx,
1635
+ "priceUpserted",
1636
+ {
1637
+ getter: "products/queries/getPriceByStripeId",
1638
+ idArg: "stripePriceId",
1639
+ idField: "stripePriceId",
1640
+ upsert: DISPATCHER_UPSERT_PATHS.priceUpserted,
1641
+ },
1642
+ splitCreateUpdate(
1643
+ triggers?.price?.onCreate,
1644
+ triggers?.price?.onUpdate,
1645
+ ),
1646
+ record,
1647
+ ),
1648
+ subscriptionUpserted: (ctx, record) =>
1649
+ runUpsertAndTrigger<StripeComponentSubscription>(
1650
+ ctx,
1651
+ "subscriptionUpserted",
1652
+ {
1653
+ getter: "billing/queries/getSubscriptionByStripeId",
1654
+ idArg: "stripeSubscriptionId",
1655
+ idField: "stripeSubscriptionId",
1656
+ upsert: DISPATCHER_UPSERT_PATHS.subscriptionUpserted,
1657
+ },
1658
+ splitCreateUpdate(
1659
+ triggers?.subscription?.onCreate,
1660
+ triggers?.subscription?.onUpdate,
1661
+ ),
1662
+ record,
1663
+ ),
1664
+ // Special case: marks the subscription canceled via upsert, then fires
1665
+ // onDelete with the resulting doc. No pre-upsert read is needed.
1666
+ subscriptionDeleted: async (ctx, record) => {
1667
+ const id = record.stripeSubscriptionId;
1668
+ if (typeof id !== "string") {
1669
+ throw new Error(
1670
+ "[better-stripe] subscriptionDeleted: missing stripeSubscriptionId in data",
1671
+ );
1672
+ }
1673
+ await ctx.runMutation(
1674
+ componentRef(component, DISPATCHER_UPSERT_PATHS.subscriptionDeleted),
1675
+ record,
1676
+ );
1677
+ if (!onSubscriptionDeleted) return;
1678
+ const doc = (await ctx.runQuery(
1679
+ componentRef(component, "billing/queries/getSubscriptionByStripeId"),
1680
+ { stripeSubscriptionId: id },
1681
+ )) as StripeComponentSubscription | null;
1682
+ if (doc === null) {
1683
+ // Mutations read their own writes, so this cannot happen;
1684
+ // fail loudly if it ever does.
1685
+ throw new Error(
1686
+ "[better-stripe] subscriptionDeleted: doc not found after " +
1687
+ `upsert (stripeSubscriptionId=${id})`,
1688
+ );
1689
+ }
1690
+ await onSubscriptionDeleted(ctx, doc);
1691
+ },
1692
+ checkoutSessionUpserted: (ctx, record) =>
1693
+ runUpsertAndTrigger<StripeComponentCheckoutSession>(
1694
+ ctx,
1695
+ "checkoutSessionUpserted",
1696
+ {
1697
+ getter: "billing/queries/getCheckoutSessionByStripeId",
1698
+ idArg: "stripeSessionId",
1699
+ idField: "stripeSessionId",
1700
+ upsert: DISPATCHER_UPSERT_PATHS.checkoutSessionUpserted,
1701
+ },
1702
+ onCheckoutCompleted
1703
+ ? async (innerCtx, newDoc, oldDoc) => {
1704
+ // Fire onCompleted exactly once: on the transition into
1705
+ // "complete".
1706
+ if (
1707
+ newDoc.status === "complete" &&
1708
+ oldDoc?.status !== "complete"
1709
+ ) {
1710
+ await onCheckoutCompleted(innerCtx, newDoc);
1711
+ }
1712
+ }
1713
+ : undefined,
1714
+ record,
1715
+ ),
1716
+ invoiceUpserted: (ctx, record) =>
1717
+ runUpsertAndTrigger<StripeComponentInvoice>(
1718
+ ctx,
1719
+ "invoiceUpserted",
1720
+ {
1721
+ getter: "billing/queries/getInvoiceByStripeId",
1722
+ idArg: "stripeInvoiceId",
1723
+ idField: "stripeInvoiceId",
1724
+ upsert: DISPATCHER_UPSERT_PATHS.invoiceUpserted,
1725
+ },
1726
+ splitCreateUpdate(
1727
+ triggers?.invoice?.onCreate,
1728
+ triggers?.invoice?.onUpdate,
1729
+ ),
1730
+ record,
1731
+ ),
1732
+ paymentUpserted: (ctx, record) =>
1733
+ runUpsertAndTrigger<StripeComponentPayment>(
1734
+ ctx,
1735
+ "paymentUpserted",
1736
+ {
1737
+ getter: "connect/queries/getPaymentByStripeId",
1738
+ idArg: "stripePaymentIntentId",
1739
+ idField: "stripePaymentIntentId",
1740
+ upsert: DISPATCHER_UPSERT_PATHS.paymentUpserted,
1741
+ },
1742
+ // SyncTriggers.payment has no onUpdate
1743
+ splitCreateUpdate(triggers?.payment?.onCreate, undefined),
1744
+ record,
1745
+ ),
1746
+ payoutUpserted: (ctx, record) =>
1747
+ runUpsertAndTrigger<StripeComponentPayout>(
1748
+ ctx,
1749
+ "payoutUpserted",
1750
+ {
1751
+ getter: "connect/queries/getPayoutByStripeId",
1752
+ idArg: "stripePayoutId",
1753
+ idField: "stripePayoutId",
1754
+ upsert: DISPATCHER_UPSERT_PATHS.payoutUpserted,
1755
+ },
1756
+ splitCreateUpdate(
1757
+ triggers?.payout?.onCreate,
1758
+ triggers?.payout?.onUpdate,
1759
+ ),
1760
+ record,
1761
+ ),
1762
+ refundUpserted: (ctx, record) =>
1763
+ runUpsertAndTrigger<StripeComponentRefund>(
1764
+ ctx,
1765
+ "refundUpserted",
1766
+ {
1767
+ getter: "connect/queries/getRefundByStripeId",
1768
+ idArg: "stripeRefundId",
1769
+ idField: "stripeRefundId",
1770
+ upsert: DISPATCHER_UPSERT_PATHS.refundUpserted,
1771
+ },
1772
+ splitCreateUpdate(
1773
+ triggers?.refund?.onCreate,
1774
+ triggers?.refund?.onUpdate,
1775
+ ),
1776
+ record,
1777
+ ),
1778
+ disputeUpserted: (ctx, record) =>
1779
+ runUpsertAndTrigger<StripeComponentDispute>(
1780
+ ctx,
1781
+ "disputeUpserted",
1782
+ {
1783
+ getter: "connect/queries/getDisputeByStripeId",
1784
+ idArg: "stripeDisputeId",
1785
+ idField: "stripeDisputeId",
1786
+ upsert: DISPATCHER_UPSERT_PATHS.disputeUpserted,
1787
+ },
1788
+ splitCreateUpdate(
1789
+ triggers?.dispute?.onCreate,
1790
+ triggers?.dispute?.onUpdate,
1791
+ ),
1792
+ record,
1793
+ ),
1794
+ };
1795
+
1796
+ /** One routing entry per async hook — identical mapping to the old API. */
1797
+ const ASYNC: Record<
1798
+ AsyncHookName,
1799
+ ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>) | undefined
1800
+ > = {
1801
+ afterAccountUpdated: hooks?.onAccountUpdated as
1802
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1803
+ | undefined,
1804
+ afterCheckoutCompleted: hooks?.onCheckoutCompleted as
1805
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1806
+ | undefined,
1807
+ afterSubscriptionUpdated: hooks?.onSubscriptionUpdated as
1808
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1809
+ | undefined,
1810
+ afterSubscriptionCanceled: hooks?.onSubscriptionCanceled as
1811
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1812
+ | undefined,
1813
+ afterTrialEnding: hooks?.onTrialEnding as
1814
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1815
+ | undefined,
1816
+ afterInvoicePaid: hooks?.onInvoicePaid as
1817
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1818
+ | undefined,
1819
+ afterInvoicePaymentFailed: hooks?.onInvoicePaymentFailed as
1820
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1821
+ | undefined,
1822
+ afterPaymentSucceeded: hooks?.onPaymentSucceeded as
1823
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1824
+ | undefined,
1825
+ afterPaymentFailed: hooks?.onPaymentFailed as
1826
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1827
+ | undefined,
1828
+ afterPayoutCompleted: hooks?.onPayoutCompleted as
1829
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1830
+ | undefined,
1831
+ afterRefundCreated: hooks?.onRefundCreated as
1832
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1833
+ | undefined,
1834
+ afterDisputeCreated: hooks?.onDisputeCreated as
1835
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1836
+ | undefined,
1837
+ afterDisputeClosed: hooks?.onDisputeClosed as
1838
+ | ((ctx: AsyncHookCtx, doc: unknown) => Promise<void>)
1839
+ | undefined,
1840
+ };
1841
+
1842
+ const syncWebhook = internalMutationGeneric({
1843
+ args: { dispatcher: v.string(), data: v.any() },
1844
+ returns: v.null(),
1845
+ handler: async (ctx, { dispatcher, data }) => {
1846
+ const run = SYNC[dispatcher as TriggerDispatcherName];
1847
+ if (!run) {
1848
+ throw new Error(`[better-stripe] unknown dispatcher: ${dispatcher}`);
1849
+ }
1850
+ await run(
1851
+ ctx as unknown as SyncTriggerCtx,
1852
+ data as Record<string, unknown>,
1853
+ );
1854
+ return null;
1855
+ },
1856
+ });
1857
+
1858
+ const asyncWebhook = internalActionGeneric({
1859
+ args: { hook: v.string(), doc: v.any() },
1860
+ returns: v.null(),
1861
+ handler: async (ctx, { hook, doc }) => {
1862
+ await ASYNC[hook as AsyncHookName]?.(
1863
+ ctx as unknown as AsyncHookCtx,
1864
+ doc,
1865
+ );
1866
+ return null;
1867
+ },
1868
+ });
1869
+
1870
+ return { syncWebhook, asyncWebhook };
1871
+ }
1872
+ }