@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,920 @@
1
+ // @vitest-environment edge-runtime
2
+ /**
3
+ * BTS-63 — transfer-reversal race reproductions.
4
+ *
5
+ * Integration tests: the REAL client orchestration (reverseTransfers /
6
+ * reverseTransfersForRefund) runs against the REAL component ledger
7
+ * (convex-test), with a fake Stripe that models the documented idempotency
8
+ * semantics (docs.stripe.com/api/idempotent_requests):
9
+ * - same key + identical params → cached replay, no money moves
10
+ * - same key + different params → hard idempotency_error
11
+ * - network failure → nothing cached; a retry executes fresh
12
+ *
13
+ * The fake also gates createReversal so tests can pin the exact interleaving
14
+ * (read → compute → Stripe call → record) that produces each race.
15
+ */
16
+ import { convexTest } from "convex-test";
17
+ import { describe, expect, it, vi } from "vitest";
18
+
19
+ import type { Component, RunCtx } from "../client/helpers.js";
20
+ import {
21
+ listWedgedReversalClaims,
22
+ reclaimReversalClaim,
23
+ reverseTransfers,
24
+ reverseTransfersForRefund,
25
+ } from "../client/connect/transfers.js";
26
+ import { api } from "./_generated/api.js";
27
+ import schema from "./schema.js";
28
+
29
+ const modules = import.meta.glob("./**/*.*s");
30
+
31
+ const TO_REF = Symbol.for("toReferencePath");
32
+
33
+ /**
34
+ * Component mock whose every node carries the accumulated reference path, so
35
+ * componentRef() resolves any function path without enumerating them here.
36
+ */
37
+ function proxyComponent(base = "betterStripe"): Component {
38
+ return new Proxy(
39
+ {},
40
+ {
41
+ get(_target, prop) {
42
+ if (prop === TO_REF) return base;
43
+ if (typeof prop !== "string") return undefined;
44
+ return proxyComponent(`${base}/${prop}`);
45
+ },
46
+ },
47
+ ) as unknown as Component;
48
+ }
49
+
50
+ /** Map a componentRef result onto the generated api for convex-test. */
51
+ function refToApi(refObj: unknown): unknown {
52
+ const path = (refObj as Record<symbol, string>)[TO_REF].replace(
53
+ /^betterStripe\//,
54
+ "",
55
+ );
56
+ return path
57
+ .split("/")
58
+ .reduce(
59
+ (node, seg) => (node as Record<string, unknown>)[seg],
60
+ api as unknown,
61
+ );
62
+ }
63
+
64
+ /** RunCtx whose runQuery/runMutation execute against a convex-test instance. */
65
+ function makeCtx(t: ReturnType<typeof convexTest>): RunCtx {
66
+ const query = t.query as unknown as (
67
+ ref: unknown,
68
+ args: unknown,
69
+ ) => Promise<unknown>;
70
+ const mutation = t.mutation as unknown as (
71
+ ref: unknown,
72
+ args: unknown,
73
+ ) => Promise<unknown>;
74
+ return {
75
+ runQuery: (ref: unknown, args: unknown) => query(refToApi(ref), args),
76
+ runMutation: (ref: unknown, args: unknown) => mutation(refToApi(ref), args),
77
+ } as unknown as RunCtx;
78
+ }
79
+
80
+ /**
81
+ * Fake Stripe transfers API with real idempotency semantics plus a gate that
82
+ * lets a test hold calls in flight to force a specific interleaving.
83
+ */
84
+ function makeRacingStripe() {
85
+ const keys = new Map<string, { params: string; response: unknown }>();
86
+ const totals = new Map<string, number>();
87
+ const failOnce = new Set<string>();
88
+ let gateOpen = true;
89
+ let waiters: (() => void)[] = [];
90
+ let blockedCount = 0;
91
+
92
+ const stripe = {
93
+ transfers: {
94
+ createReversal: vi.fn(
95
+ async (
96
+ transferId: string,
97
+ params: { amount: number },
98
+ opts?: { idempotencyKey?: string },
99
+ ) => {
100
+ if (!gateOpen) {
101
+ blockedCount++;
102
+ await new Promise<void>((res) => waiters.push(res));
103
+ }
104
+ if (failOnce.has(transferId)) {
105
+ failOnce.delete(transferId);
106
+ // Connection-level failure: Stripe caches nothing, so a retry
107
+ // with the same key executes fresh.
108
+ throw new Error(`stripe: network error reversing ${transferId}`);
109
+ }
110
+ const key = opts?.idempotencyKey;
111
+ const paramStr = JSON.stringify(params);
112
+ if (key) {
113
+ const seen = keys.get(key);
114
+ if (seen) {
115
+ if (seen.params !== paramStr) {
116
+ throw new Error(
117
+ `stripe: idempotency_error — key ${key} reused with different params`,
118
+ );
119
+ }
120
+ return seen.response; // cached replay — no money moves
121
+ }
122
+ }
123
+ totals.set(transferId, (totals.get(transferId) ?? 0) + params.amount);
124
+ const response = { id: `trr_${keys.size}_${transferId}` };
125
+ if (key) keys.set(key, { params: paramStr, response });
126
+ return response;
127
+ },
128
+ ),
129
+ retrieve: vi.fn(async (transferId: string) => ({
130
+ id: transferId,
131
+ amount_reversed: totals.get(transferId) ?? 0,
132
+ })),
133
+ },
134
+ failNextCallFor: (transferId: string) => failOnce.add(transferId),
135
+ closeGate: () => {
136
+ gateOpen = false;
137
+ },
138
+ openGate: () => {
139
+ gateOpen = true;
140
+ const w = waiters;
141
+ waiters = [];
142
+ blockedCount = 0;
143
+ w.forEach((res) => res());
144
+ },
145
+ blocked: () => blockedCount,
146
+ total: (transferId: string) => totals.get(transferId) ?? 0,
147
+ };
148
+ return stripe;
149
+ }
150
+
151
+ const asStripe = (s: ReturnType<typeof makeRacingStripe>) =>
152
+ s as unknown as Parameters<typeof reverseTransfers>[0];
153
+
154
+ async function waitFor(cond: () => boolean, label: string): Promise<void> {
155
+ for (let i = 0; i < 400; i++) {
156
+ if (cond()) return;
157
+ await new Promise((r) => setTimeout(r, 5));
158
+ }
159
+ throw new Error(`timed out waiting for ${label}`);
160
+ }
161
+
162
+ async function seedLeg(
163
+ t: ReturnType<typeof convexTest>,
164
+ args: { stripeTransferId: string; sourceChargeId: string; amount: number },
165
+ ) {
166
+ await t.mutation(api.connect.mutations.upsertTransfer, {
167
+ ...args,
168
+ destinationAccountId: `acct_${args.stripeTransferId}`,
169
+ currency: "usd",
170
+ role: "store" as const,
171
+ status: "paid" as const,
172
+ });
173
+ }
174
+
175
+ describe("BTS-102 — amount-mode reclaims the full requested total, byte-identical on replay", () => {
176
+ type Slice = { stripeTransferId: string; from: number; to: number };
177
+ const reversed = (slices: { from: number; to: number }[]) =>
178
+ slices.reduce((s, sl) => s + (sl.to - sl.from), 0);
179
+ const geom = (slices: Slice[]): Slice[] =>
180
+ slices.map((s) => ({
181
+ stripeTransferId: s.stripeTransferId,
182
+ from: s.from,
183
+ to: s.to,
184
+ }));
185
+
186
+ it("a 33/33/34 clawback of 10 claims exactly 10 (no dropped residue), and a redelivery replays it byte-for-byte", async () => {
187
+ const t = convexTest(schema, modules);
188
+
189
+ // Three legs whose pro-rata shares of 10 each round DOWN (3.3/3.3/3.4):
190
+ // independent rounding claims 3+3+3=9 and the leftover cent is lost.
191
+ await seedLeg(t, {
192
+ stripeTransferId: "tr_t1",
193
+ sourceChargeId: "ch_thirds",
194
+ amount: 33,
195
+ });
196
+ await seedLeg(t, {
197
+ stripeTransferId: "tr_t2",
198
+ sourceChargeId: "ch_thirds",
199
+ amount: 33,
200
+ });
201
+ await seedLeg(t, {
202
+ stripeTransferId: "tr_t3",
203
+ sourceChargeId: "ch_thirds",
204
+ amount: 34,
205
+ });
206
+
207
+ // Fresh claim: the recorded plan must reclaim the full 10.
208
+ const fresh = await t.mutation(api.connect.mutations.claimReversalSlices, {
209
+ operationId: "dp_thirds",
210
+ sourceChargeId: "ch_thirds",
211
+ mode: { kind: "amount", amount: 10 },
212
+ });
213
+ expect(fresh.replay).toBe(false);
214
+ expect(reversed(fresh.slices)).toBe(10);
215
+
216
+ // The stored op is the PERMANENT, replayed-forever record — it too must
217
+ // carry the full 10, not a short plan.
218
+ const op = await t.query(api.connect.queries.getReversalOp, {
219
+ operationId: "dp_thirds",
220
+ });
221
+ expect(op).not.toBeNull();
222
+ expect(reversed(op!.slices)).toBe(10);
223
+
224
+ // Redelivery under the same operationId replays the recorded slices verbatim
225
+ // — byte-identical geometry, still summing to 10.
226
+ const replay = await t.mutation(api.connect.mutations.claimReversalSlices, {
227
+ operationId: "dp_thirds",
228
+ sourceChargeId: "ch_thirds",
229
+ mode: { kind: "amount", amount: 10 },
230
+ });
231
+ expect(replay.replay).toBe(true);
232
+ expect(geom(replay.slices)).toEqual(geom(fresh.slices));
233
+ expect(reversed(replay.slices)).toBe(10);
234
+ });
235
+ });
236
+
237
+ describe("BTS-63 race 1 — refund path: concurrent DISTINCT refunds must not double-reverse", () => {
238
+ it("two refunds computing the same target from the same pre-write state reverse it once", async () => {
239
+ const t = convexTest(schema, modules);
240
+ const ctx = makeCtx(t);
241
+ const component = proxyComponent();
242
+ const stripe = makeRacingStripe();
243
+
244
+ // Charge 10000, single split leg of 7000.
245
+ await seedLeg(t, {
246
+ stripeTransferId: "tr_store",
247
+ sourceChargeId: "ch_race",
248
+ amount: 7000,
249
+ });
250
+
251
+ // Refunds A and B (2000 each) land back-to-back: both refund.created
252
+ // handlers fresh-read the charge and see cumulative amount_refunded=4000,
253
+ // so both compute the same cumulative target round(7000 × 0.4) = 2800.
254
+ const opts = {
255
+ sourceChargeId: "ch_race",
256
+ chargeAmount: 10000,
257
+ amountRefunded: 4000,
258
+ };
259
+
260
+ // Hold Stripe calls so both handlers pass their read-and-compute step
261
+ // before either records anything.
262
+ stripe.closeGate();
263
+ const pA = reverseTransfersForRefund(asStripe(stripe), component, ctx, {
264
+ ...opts,
265
+ refundId: "re_A",
266
+ });
267
+ await waitFor(() => stripe.blocked() >= 1, "refund A to reach Stripe");
268
+
269
+ let bSettled = false;
270
+ const pB = reverseTransfersForRefund(asStripe(stripe), component, ctx, {
271
+ ...opts,
272
+ refundId: "re_B",
273
+ }).finally(() => {
274
+ bSettled = true;
275
+ });
276
+ // B either reaches Stripe too (the racy pre-fix behavior) or finishes
277
+ // without a Stripe call (the fixed behavior — its claim comes back empty).
278
+ await waitFor(
279
+ () => stripe.blocked() >= 2 || bSettled,
280
+ "refund B to reach Stripe or settle",
281
+ );
282
+
283
+ stripe.openGate();
284
+ await Promise.all([pA, pB]);
285
+
286
+ // 40% of the 7000 leg is 2800 — reversed exactly once across both refunds.
287
+ expect(stripe.total("tr_store")).toBe(2800);
288
+
289
+ // And the ledger mirrors what actually moved on Stripe.
290
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
291
+ sourceChargeId: "ch_race",
292
+ });
293
+ expect(rows[0]!.reversedAmount).toBe(2800);
294
+ expect(rows[0]!.reversedAmount).toBe(stripe.total("tr_store"));
295
+ });
296
+ });
297
+
298
+ describe("BTS-63 race 2 — dispute path: retry after partial success must converge", () => {
299
+ const DISPUTE = { sourceChargeId: "ch_dp", amount: 4500, operationId: "dp_1" };
300
+
301
+ async function seedDisputeLegs(t: ReturnType<typeof convexTest>) {
302
+ await seedLeg(t, {
303
+ stripeTransferId: "tr_s1",
304
+ sourceChargeId: "ch_dp",
305
+ amount: 8000,
306
+ });
307
+ await seedLeg(t, {
308
+ stripeTransferId: "tr_s2",
309
+ sourceChargeId: "ch_dp",
310
+ amount: 1000,
311
+ });
312
+ }
313
+
314
+ it("a redelivery after the second leg failed does not double-record the first leg", async () => {
315
+ const t = convexTest(schema, modules);
316
+ const ctx = makeCtx(t);
317
+ const component = proxyComponent();
318
+ const stripe = makeRacingStripe();
319
+ await seedDisputeLegs(t);
320
+
321
+ // First delivery: leg 1 (pro-rata 4000) reverses and records, leg 2's
322
+ // Stripe call dies → the event fails and Stripe redelivers.
323
+ stripe.failNextCallFor("tr_s2");
324
+ await expect(
325
+ reverseTransfers(asStripe(stripe), component, ctx, DISPUTE),
326
+ ).rejects.toThrow(/network error/);
327
+ expect(stripe.total("tr_s1")).toBe(4000);
328
+
329
+ // Redelivery: must finish the job — leg 2 gets its 500 — without
330
+ // re-reversing or double-recording leg 1.
331
+ await reverseTransfers(asStripe(stripe), component, ctx, DISPUTE);
332
+
333
+ expect(stripe.total("tr_s1")).toBe(4000);
334
+ expect(stripe.total("tr_s2")).toBe(500);
335
+
336
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
337
+ sourceChargeId: "ch_dp",
338
+ });
339
+ const byId = new Map(rows.map((r) => [r.stripeTransferId, r]));
340
+ // Pre-fix, the replayed leg-1 call re-records cumulatively: 4000 → 8000.
341
+ expect(byId.get("tr_s1")!.reversedAmount).toBe(4000);
342
+ expect(byId.get("tr_s2")!.reversedAmount).toBe(500);
343
+ });
344
+
345
+ it("a redelivery after an interleaved reversal must not reuse a key with different params", async () => {
346
+ const t = convexTest(schema, modules);
347
+ const ctx = makeCtx(t);
348
+ const component = proxyComponent();
349
+ const stripe = makeRacingStripe();
350
+ await seedDisputeLegs(t);
351
+
352
+ // First delivery: leg 1 reverses 4000 and records; leg 2 fails.
353
+ stripe.failNextCallFor("tr_s2");
354
+ await expect(
355
+ reverseTransfers(asStripe(stripe), component, ctx, DISPUTE),
356
+ ).rejects.toThrow(/network error/);
357
+
358
+ // Between deliveries a refund clawback confirms more reversal on leg 1,
359
+ // shrinking its un-reversed remainder from 4000 to 2000.
360
+ await t.mutation(api.connect.mutations.recordTransferReversal, {
361
+ stripeTransferId: "tr_s1",
362
+ reversedAmount: 6000,
363
+ });
364
+
365
+ // Redelivery: pre-fix this recomputes leg 1's amount as min(4000, 2000)
366
+ // = 2000 and re-sends it under the already-used bs_rev_dp_1_tr_s1 key —
367
+ // Stripe rejects same-key-different-params and the event retries forever.
368
+ await reverseTransfers(asStripe(stripe), component, ctx, DISPUTE);
369
+
370
+ // Leg 1's share was already executed on the first delivery; only leg 2
371
+ // still had money to move.
372
+ expect(stripe.total("tr_s1")).toBe(4000);
373
+ expect(stripe.total("tr_s2")).toBe(500);
374
+ });
375
+ });
376
+
377
+ describe("BTS-63 race 3 — a transiently-failed operation must not be leapfrogged by a sibling", () => {
378
+ // The hole-leapfrog regression (independent PR #61 review, BLOCKER 1): an
379
+ // operation claims a slice, its Stripe call fails transiently, and a SIBLING
380
+ // operation claims the next slice and confirms past the hole. The failed
381
+ // operation's retry then sees `confirmed >= to` and silently skips — its
382
+ // money never moves, the ledger overstates the reversal, and the
383
+ // claimed>confirmed marker is erased. The executor must refuse to run a
384
+ // slice whose predecessor claim is unexecuted, so events retry until the
385
+ // hole is filled and every claimed slice eventually moves.
386
+
387
+ it("refund path: R1 fails once, R2 lands, R1 retries — every claimed slice still moves", async () => {
388
+ const t = convexTest(schema, modules);
389
+ const ctx = makeCtx(t);
390
+ const component = proxyComponent();
391
+ const stripe = makeRacingStripe();
392
+
393
+ await seedLeg(t, {
394
+ stripeTransferId: "tr_leap",
395
+ sourceChargeId: "ch_leap",
396
+ amount: 7000,
397
+ });
398
+
399
+ // R1 (cumulative refunded 4000/10000 → target 2800) claims [0,2800) but
400
+ // its Stripe call dies on a transient network error → the event retries.
401
+ stripe.failNextCallFor("tr_leap");
402
+ const r1 = () =>
403
+ reverseTransfersForRefund(asStripe(stripe), component, ctx, {
404
+ sourceChargeId: "ch_leap",
405
+ refundId: "re_A",
406
+ chargeAmount: 10000,
407
+ amountRefunded: 4000,
408
+ });
409
+ await expect(r1()).rejects.toThrow(/network error/);
410
+ expect(stripe.total("tr_leap")).toBe(0);
411
+
412
+ // R2 (cumulative refunded 8000 → target 5600) lands before R1's retry and
413
+ // claims [2800,5600). It must NOT execute past R1's unexecuted hole —
414
+ // pre-gate it did, confirming the ledger to 5600 with only 2800 moved.
415
+ const r2 = () =>
416
+ reverseTransfersForRefund(asStripe(stripe), component, ctx, {
417
+ sourceChargeId: "ch_leap",
418
+ refundId: "re_B",
419
+ chargeAmount: 10000,
420
+ amountRefunded: 8000,
421
+ });
422
+ await r2().catch(() => {}); // blocked (fixed) or leapfrogs (the bug)
423
+
424
+ // At-least-once delivery: both events retry until they succeed.
425
+ await r1();
426
+ await r2();
427
+
428
+ // 80% of the 7000 leg = 5600 actually reversed at Stripe, and the ledger
429
+ // mirrors what actually moved — no silent lost clawback.
430
+ expect(stripe.total("tr_leap")).toBe(5600);
431
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
432
+ sourceChargeId: "ch_leap",
433
+ });
434
+ expect(rows[0]!.reversedAmount).toBe(stripe.total("tr_leap"));
435
+ });
436
+
437
+ it("dispute path: the clawback fails once, a refund confirms past it, the redelivery still claws back", async () => {
438
+ const t = convexTest(schema, modules);
439
+ const ctx = makeCtx(t);
440
+ const component = proxyComponent();
441
+ const stripe = makeRacingStripe();
442
+
443
+ await seedLeg(t, {
444
+ stripeTransferId: "tr_lp2",
445
+ sourceChargeId: "ch_lp2",
446
+ amount: 8000,
447
+ });
448
+
449
+ // Dispute clawback (amount 4000) claims [0,4000); its Stripe call dies.
450
+ stripe.failNextCallFor("tr_lp2");
451
+ const clawback = () =>
452
+ reverseTransfers(asStripe(stripe), component, ctx, {
453
+ sourceChargeId: "ch_lp2",
454
+ amount: 4000,
455
+ operationId: "dp_leap",
456
+ });
457
+ await expect(clawback()).rejects.toThrow(/network error/);
458
+
459
+ // A refund (6000/10000 → target 4800) claims [4000,4800) behind the hole.
460
+ const refund = () =>
461
+ reverseTransfersForRefund(asStripe(stripe), component, ctx, {
462
+ sourceChargeId: "ch_lp2",
463
+ refundId: "re_C",
464
+ chargeAmount: 10000,
465
+ amountRefunded: 6000,
466
+ });
467
+ await refund().catch(() => {});
468
+
469
+ // Both events retry until they succeed.
470
+ await clawback();
471
+ await refund();
472
+
473
+ expect(stripe.total("tr_lp2")).toBe(4800);
474
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
475
+ sourceChargeId: "ch_lp2",
476
+ });
477
+ expect(rows[0]!.reversedAmount).toBe(stripe.total("tr_lp2"));
478
+ });
479
+ });
480
+
481
+ describe("BTS-74 — reclaim/expiry of dead reversal claims", () => {
482
+ const DAY = 24 * 60 * 60 * 1000;
483
+
484
+ // A permanently-dead claim: an operation claims a slice, its Stripe call
485
+ // dies, and — unlike the transient case (race 3) — its webhook event is never
486
+ // redelivered (Stripe's ~72h retries exhaust). The claim frontier then sits
487
+ // ahead of the confirmed reversedAmount forever, and any successor operation
488
+ // that claimed behind the hole blocks on `predecessor claim unexecuted`.
489
+
490
+ it("re-executes a dead claim, filling the hole so a blocked successor can proceed", async () => {
491
+ const t = convexTest(schema, modules);
492
+ const ctx = makeCtx(t);
493
+ const component = proxyComponent();
494
+ const stripe = makeRacingStripe();
495
+
496
+ await seedLeg(t, {
497
+ stripeTransferId: "tr_dead",
498
+ sourceChargeId: "ch_dead",
499
+ amount: 7000,
500
+ });
501
+
502
+ // D1 (dispute clawback, amount 2800) claims [0,2800); its Stripe call dies
503
+ // and the event is NEVER redelivered — a permanently-dead claim.
504
+ stripe.failNextCallFor("tr_dead");
505
+ await expect(
506
+ reverseTransfers(asStripe(stripe), component, ctx, {
507
+ sourceChargeId: "ch_dead",
508
+ amount: 2800,
509
+ operationId: "dp_dead",
510
+ }),
511
+ ).rejects.toThrow(/network error/);
512
+ expect(stripe.total("tr_dead")).toBe(0);
513
+
514
+ // A refund (target 5600) claims [2800,5600) behind the hole and BLOCKS —
515
+ // its predecessor's claim is unexecuted.
516
+ await expect(
517
+ reverseTransfersForRefund(asStripe(stripe), component, ctx, {
518
+ sourceChargeId: "ch_dead",
519
+ refundId: "re_after",
520
+ chargeAmount: 10000,
521
+ amountRefunded: 8000,
522
+ }),
523
+ ).rejects.toThrow(/predecessor claim unexecuted/);
524
+
525
+ // Ops reclaim: re-execute the dead claim (default remedy). It replays the
526
+ // recorded slice under the same idempotency key and actually moves the money.
527
+ const res = await reclaimReversalClaim(asStripe(stripe), component, ctx, {
528
+ operationId: "dp_dead",
529
+ });
530
+ expect(res.mode).toBe("reexecute");
531
+ expect(stripe.total("tr_dead")).toBe(2800);
532
+
533
+ // The successor refund now proceeds — the hole is filled.
534
+ await reverseTransfersForRefund(asStripe(stripe), component, ctx, {
535
+ sourceChargeId: "ch_dead",
536
+ refundId: "re_after",
537
+ chargeAmount: 10000,
538
+ amountRefunded: 8000,
539
+ });
540
+ expect(stripe.total("tr_dead")).toBe(5600);
541
+
542
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
543
+ sourceChargeId: "ch_dead",
544
+ });
545
+ expect(rows[0]!.reversedAmount).toBe(5600);
546
+ // No longer wedged.
547
+ const wedged = await listWedgedReversalClaims(component, ctx);
548
+ expect(wedged).toHaveLength(0);
549
+ });
550
+
551
+ it("lists a wedged leg (claimed > reversed) with its blocking op record", async () => {
552
+ const t = convexTest(schema, modules);
553
+ const ctx = makeCtx(t);
554
+ const component = proxyComponent();
555
+ const stripe = makeRacingStripe();
556
+
557
+ await seedLeg(t, {
558
+ stripeTransferId: "tr_wedge",
559
+ sourceChargeId: "ch_wedge",
560
+ amount: 5000,
561
+ });
562
+
563
+ stripe.failNextCallFor("tr_wedge");
564
+ await expect(
565
+ reverseTransfers(asStripe(stripe), component, ctx, {
566
+ sourceChargeId: "ch_wedge",
567
+ amount: 2000,
568
+ operationId: "dp_wedge",
569
+ }),
570
+ ).rejects.toThrow(/network error/);
571
+
572
+ const wedged = await listWedgedReversalClaims(component, ctx);
573
+ expect(wedged).toHaveLength(1);
574
+ expect(wedged[0]!.stripeTransferId).toBe("tr_wedge");
575
+ expect(wedged[0]!.reversedAmount).toBe(0);
576
+ expect(wedged[0]!.reversalClaimedAmount).toBe(2000);
577
+ expect(wedged[0]!.blockingOps).toEqual([
578
+ { operationId: "dp_wedge", from: 0, to: 2000 },
579
+ ]);
580
+ });
581
+
582
+ it("releases a dead frontier claim after the idempotency window once live Stripe confirms no money moved", async () => {
583
+ const t = convexTest(schema, modules);
584
+ const ctx = makeCtx(t);
585
+ const component = proxyComponent();
586
+ const stripe = makeRacingStripe();
587
+
588
+ await seedLeg(t, {
589
+ stripeTransferId: "tr_rel",
590
+ sourceChargeId: "ch_rel",
591
+ amount: 6000,
592
+ });
593
+
594
+ stripe.failNextCallFor("tr_rel");
595
+ await expect(
596
+ reverseTransfers(asStripe(stripe), component, ctx, {
597
+ sourceChargeId: "ch_rel",
598
+ amount: 3000,
599
+ operationId: "dp_rel",
600
+ }),
601
+ ).rejects.toThrow(/network error/);
602
+
603
+ // Release: past the >24h idempotency window, and live Stripe shows the
604
+ // transfer's amount_reversed is still 0 — the money never moved.
605
+ const res = await reclaimReversalClaim(asStripe(stripe), component, ctx, {
606
+ operationId: "dp_rel",
607
+ mode: "release",
608
+ minAgeMs: DAY,
609
+ now: Date.now() + 2 * DAY,
610
+ });
611
+ expect(res.mode).toBe("release");
612
+ if (res.mode === "release") expect(res.released).toBe(true);
613
+
614
+ // The op record is gone and the claim frontier rewound to the confirmed
615
+ // amount, so a fresh operation can claim the released capacity from 0.
616
+ const op = await t.query(api.connect.queries.getReversalOp, {
617
+ operationId: "dp_rel",
618
+ });
619
+ expect(op).toBeNull();
620
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
621
+ sourceChargeId: "ch_rel",
622
+ });
623
+ expect(rows[0]!.reversalClaimedAmount ?? 0).toBe(0);
624
+
625
+ const fresh = await reverseTransfers(asStripe(stripe), component, ctx, {
626
+ sourceChargeId: "ch_rel",
627
+ amount: 3000,
628
+ operationId: "dp_fresh",
629
+ });
630
+ expect(fresh.reversals[0]!.amount).toBe(3000);
631
+ expect(stripe.total("tr_rel")).toBe(3000);
632
+ });
633
+
634
+ it("refuses to release a still-live claim inside the idempotency window (money may be in flight)", async () => {
635
+ const t = convexTest(schema, modules);
636
+ const ctx = makeCtx(t);
637
+ const component = proxyComponent();
638
+ const stripe = makeRacingStripe();
639
+
640
+ await seedLeg(t, {
641
+ stripeTransferId: "tr_live",
642
+ sourceChargeId: "ch_live",
643
+ amount: 6000,
644
+ });
645
+
646
+ stripe.failNextCallFor("tr_live");
647
+ await expect(
648
+ reverseTransfers(asStripe(stripe), component, ctx, {
649
+ sourceChargeId: "ch_live",
650
+ amount: 3000,
651
+ operationId: "dp_live",
652
+ }),
653
+ ).rejects.toThrow(/network error/);
654
+
655
+ // Only ~1 minute old: still within the idempotency window, so a retry could
656
+ // still fire the reversal. Release must refuse.
657
+ await expect(
658
+ reclaimReversalClaim(asStripe(stripe), component, ctx, {
659
+ operationId: "dp_live",
660
+ mode: "release",
661
+ minAgeMs: DAY,
662
+ now: Date.now() + 60_000,
663
+ }),
664
+ ).rejects.toThrow(/idempotency window|too recent/i);
665
+
666
+ // The claim is untouched — still wedged, still recorded.
667
+ const wedged = await listWedgedReversalClaims(component, ctx);
668
+ expect(wedged).toHaveLength(1);
669
+ const op = await t.query(api.connect.queries.getReversalOp, {
670
+ operationId: "dp_live",
671
+ });
672
+ expect(op).not.toBeNull();
673
+ });
674
+
675
+ it("refuses to release when live Stripe shows the money already moved", async () => {
676
+ const t = convexTest(schema, modules);
677
+ const ctx = makeCtx(t);
678
+ const component = proxyComponent();
679
+ const stripe = makeRacingStripe();
680
+
681
+ await seedLeg(t, {
682
+ stripeTransferId: "tr_moved",
683
+ sourceChargeId: "ch_moved",
684
+ amount: 6000,
685
+ });
686
+
687
+ // The claim's money DID move at Stripe, but the ledger confirm was lost
688
+ // (crash between createReversal and recordTransferReversal): the op row and
689
+ // the claim frontier exist, but amount_reversed already covers the slice.
690
+ stripe.failNextCallFor("tr_moved");
691
+ await expect(
692
+ reverseTransfers(asStripe(stripe), component, ctx, {
693
+ sourceChargeId: "ch_moved",
694
+ amount: 3000,
695
+ operationId: "dp_moved",
696
+ }),
697
+ ).rejects.toThrow(/network error/);
698
+ // Simulate the money having actually moved out of band.
699
+ await stripe.transfers.createReversal(
700
+ "tr_moved",
701
+ { amount: 3000 },
702
+ { idempotencyKey: "out_of_band" },
703
+ );
704
+ expect(stripe.total("tr_moved")).toBe(3000);
705
+
706
+ // Release must refuse — releasing here would rewind a claim whose money is
707
+ // gone, permanently understating the ledger. Re-execution (which records
708
+ // the already-moved money) is the correct remedy.
709
+ await expect(
710
+ reclaimReversalClaim(asStripe(stripe), component, ctx, {
711
+ operationId: "dp_moved",
712
+ mode: "release",
713
+ minAgeMs: DAY,
714
+ now: Date.now() + 2 * DAY,
715
+ }),
716
+ ).rejects.toThrow(/already moved|money moved/i);
717
+ });
718
+ });
719
+
720
+ describe("BTS-79 — releaseReversalClaim: multi-leg all-or-nothing atomicity", () => {
721
+ const DAY = 24 * 60 * 60 * 1000;
722
+
723
+ /**
724
+ * Seeds two legs under one charge and creates ONE dead reversal op whose
725
+ * plan spans both: with leg amounts 100/300 and a claim of `amount: 398`,
726
+ * `computeReversalSlices`'s pro-rata rounding claims leg A FULLY (100 of
727
+ * 100 — its prorata share rounds up to its cap) while leg B is left
728
+ * PARTIAL (298 of 300, capped by the remaining budget). Both legs'
729
+ * Stripe calls die (network error), so neither leg's money actually moves
730
+ * — the op is a permanently-dead claim, same shape as the BTS-74 tests
731
+ * above, but with two legs instead of one.
732
+ *
733
+ * This shared base state is valid-and-releasable for BOTH legs as-is; each
734
+ * test below invalidates leg B in exactly one way (one of the three throw
735
+ * branches in `releaseReversalClaim`, mutations.ts ~527-545) and asserts
736
+ * that the *entire* release is refused and *neither* leg's row nor the op
737
+ * row changed even one field — true all-or-nothing.
738
+ */
739
+ async function seedMixedOp(
740
+ stripe: ReturnType<typeof makeRacingStripe>,
741
+ t: ReturnType<typeof convexTest>,
742
+ ctx: RunCtx,
743
+ component: Component,
744
+ tag: string,
745
+ ) {
746
+ const chargeId = `ch_mix_${tag}`;
747
+ const legA = `tr_mixA_${tag}`;
748
+ const legB = `tr_mixB_${tag}`;
749
+ const operationId = `dp_mix_${tag}`;
750
+
751
+ await seedLeg(t, {
752
+ stripeTransferId: legA,
753
+ sourceChargeId: chargeId,
754
+ amount: 100,
755
+ });
756
+ await seedLeg(t, {
757
+ stripeTransferId: legB,
758
+ sourceChargeId: chargeId,
759
+ amount: 300,
760
+ });
761
+
762
+ // Only leg A's call needs to fail: it is processed first (rows come back
763
+ // in seed order), so its network error aborts the executor loop before
764
+ // leg B's Stripe call is ever attempted — leg B's `failNextCallFor` flag
765
+ // would otherwise sit unconsumed and misfire on a later, unrelated call.
766
+ stripe.failNextCallFor(legA);
767
+ await expect(
768
+ reverseTransfers(asStripe(stripe), component, ctx, {
769
+ sourceChargeId: chargeId,
770
+ amount: 398,
771
+ operationId,
772
+ }),
773
+ ).rejects.toThrow(/network error/);
774
+ expect(stripe.total(legA)).toBe(0);
775
+ expect(stripe.total(legB)).toBe(0);
776
+
777
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
778
+ sourceChargeId: chargeId,
779
+ });
780
+ const byId = new Map(rows.map((r) => [r.stripeTransferId, r]));
781
+ expect(byId.get(legA)!.reversalClaimedAmount).toBe(100);
782
+ expect(byId.get(legB)!.reversalClaimedAmount).toBe(298);
783
+
784
+ return { chargeId, legA, legB, operationId };
785
+ }
786
+
787
+ async function snapshot(
788
+ t: ReturnType<typeof convexTest>,
789
+ chargeId: string,
790
+ operationId: string,
791
+ ) {
792
+ const rows = await t.query(api.connect.queries.listTransfersByCharge, {
793
+ sourceChargeId: chargeId,
794
+ });
795
+ const op = await t.query(api.connect.queries.getReversalOp, {
796
+ operationId,
797
+ });
798
+ return { rows, op };
799
+ }
800
+
801
+ it("leg A valid + leg B's claim frontier moved past this op's slice (mutations.ts ~527-533) — refuses, rewinds neither leg", async () => {
802
+ const t = convexTest(schema, modules);
803
+ const ctx = makeCtx(t);
804
+ const component = proxyComponent();
805
+ const stripe = makeRacingStripe();
806
+ const { chargeId, legB, operationId } = await seedMixedOp(
807
+ stripe,
808
+ t,
809
+ ctx,
810
+ component,
811
+ "frontier",
812
+ );
813
+
814
+ // A successor operation claims further capacity on the same charge. Leg A
815
+ // is already fully claimed, so its take is capped at 0 by ANY mode
816
+ // (`leg.amount - from` = 0) — it is untouched. Leg B still has 2 left, so
817
+ // this advances its frontier from 298 to 299, past dp_mix_frontier's
818
+ // recorded slice.to=298 for leg B. This is a pure claim (no Stripe call),
819
+ // exactly what a real concurrent operation would do.
820
+ await t.mutation(api.connect.mutations.claimReversalSlices, {
821
+ operationId: "dp_successor_frontier",
822
+ sourceChargeId: chargeId,
823
+ mode: { kind: "amount", amount: 1 },
824
+ });
825
+ const afterSuccessor = await t.query(
826
+ api.connect.queries.listTransfersByCharge,
827
+ { sourceChargeId: chargeId },
828
+ );
829
+ expect(
830
+ afterSuccessor.find((r) => r.stripeTransferId === legB)!
831
+ .reversalClaimedAmount,
832
+ ).toBe(299);
833
+
834
+ const before = await snapshot(t, chargeId, operationId);
835
+
836
+ await expect(
837
+ reclaimReversalClaim(asStripe(stripe), component, ctx, {
838
+ operationId,
839
+ mode: "release",
840
+ minAgeMs: DAY,
841
+ now: Date.now() + 2 * DAY,
842
+ }),
843
+ ).rejects.toThrow(/claim frontier .* moved past/);
844
+
845
+ // Byte-for-byte unchanged from right before the release attempt — leg A's
846
+ // (valid) row was never patched either, proving the abort happens before
847
+ // ANY leg is written, not just before the invalid one.
848
+ const after = await snapshot(t, chargeId, operationId);
849
+ expect(after).toEqual(before);
850
+ });
851
+
852
+ it("leg A valid + leg B missing from `verified` (mutations.ts ~534-539) — refuses, rewinds neither leg", async () => {
853
+ const t = convexTest(schema, modules);
854
+ const ctx = makeCtx(t);
855
+ const component = proxyComponent();
856
+ const stripe = makeRacingStripe();
857
+ const { chargeId, legA, operationId } = await seedMixedOp(
858
+ stripe,
859
+ t,
860
+ ctx,
861
+ component,
862
+ "missing",
863
+ );
864
+
865
+ const before = await snapshot(t, chargeId, operationId);
866
+
867
+ // Only reachable by calling the mutation directly: `reclaimReversalClaim`
868
+ // always fetches live Stripe state for every unique leg in the op, so a
869
+ // caller going through the public client can never omit one. Drive the
870
+ // component mutation straight to prove the mutation itself still refuses
871
+ // when handed an incomplete `verified` array (e.g. a buggy caller).
872
+ await expect(
873
+ t.mutation(api.connect.mutations.releaseReversalClaim, {
874
+ operationId,
875
+ verified: [{ stripeTransferId: legA, amountReversed: 0 }],
876
+ }),
877
+ ).rejects.toThrow(/missing live amount_reversed/);
878
+
879
+ const after = await snapshot(t, chargeId, operationId);
880
+ expect(after).toEqual(before);
881
+ });
882
+
883
+ it("leg A valid + leg B's money already moved (mutations.ts ~540-545) — refuses, rewinds neither leg", async () => {
884
+ const t = convexTest(schema, modules);
885
+ const ctx = makeCtx(t);
886
+ const component = proxyComponent();
887
+ const stripe = makeRacingStripe();
888
+ const { chargeId, legB, operationId } = await seedMixedOp(
889
+ stripe,
890
+ t,
891
+ ctx,
892
+ component,
893
+ "moved",
894
+ );
895
+
896
+ // Leg B's money actually moved out of band (mirrors the single-leg
897
+ // BTS-74 "already moved" test above) — live amount_reversed now exceeds
898
+ // this op's slice.from for leg B, while leg A is untouched and valid.
899
+ await stripe.transfers.createReversal(
900
+ legB,
901
+ { amount: 50 },
902
+ { idempotencyKey: "oob_mix_moved" },
903
+ );
904
+ expect(stripe.total(legB)).toBe(50);
905
+
906
+ const before = await snapshot(t, chargeId, operationId);
907
+
908
+ await expect(
909
+ reclaimReversalClaim(asStripe(stripe), component, ctx, {
910
+ operationId,
911
+ mode: "release",
912
+ minAgeMs: DAY,
913
+ now: Date.now() + 2 * DAY,
914
+ }),
915
+ ).rejects.toThrow(/already moved/);
916
+
917
+ const after = await snapshot(t, chargeId, operationId);
918
+ expect(after).toEqual(before);
919
+ });
920
+ });