@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,932 @@
1
+ import { createSplitTransfers, reinstateTransfers, reverseTransfers, reverseTransfersForRefund, } from "../connect/transfers.js";
2
+ import { validateStatementDescriptorSuffix } from "../core/descriptors.js";
3
+ import { computeFee } from "../core/fees.js";
4
+ import { resolveOwnerAccount } from "../utils/owner.js";
5
+ import { componentRef, deriveTrialFields, dispatchUpsert, epochToIso, extractIdentifiers, } from "./helpers.js";
6
+ // =============================================================================
7
+ // EVENT PROCESSOR
8
+ // =============================================================================
9
+ export async function processEvent(whCtx, event) {
10
+ // Stripe guarantees the object type matches event.type, so these casts are safe.
11
+ const obj = event.data.object;
12
+ switch (event.type) {
13
+ case "product.created":
14
+ case "product.updated":
15
+ await handleProductEvent(whCtx, obj);
16
+ break;
17
+ case "price.created":
18
+ case "price.updated":
19
+ await handlePriceEvent(whCtx, obj);
20
+ break;
21
+ case "customer.subscription.created":
22
+ case "customer.subscription.updated":
23
+ case "customer.subscription.trial_will_end":
24
+ await upsertSubscriptionFromStripe(whCtx, obj, "subscriptionUpserted");
25
+ break;
26
+ case "customer.subscription.deleted":
27
+ await upsertSubscriptionFromStripe(whCtx, obj, "subscriptionDeleted");
28
+ break;
29
+ case "checkout.session.completed":
30
+ await handleCheckoutEvent(whCtx, obj);
31
+ break;
32
+ case "invoice.created":
33
+ // Apply a per-invoice fixed/tier platform fee before finalization, then
34
+ // record the invoice. Percent-only fees use application_fee_percent on the
35
+ // subscription and don't need this.
36
+ await applyPerInvoiceFee(whCtx, obj);
37
+ // Per-store statement descriptor for destination-charge subscriptions
38
+ // (BTS-32) — set before finalization so the charge carries it.
39
+ await applyStatementDescriptor(whCtx, obj);
40
+ await upsertInvoiceFromStripe(whCtx, obj);
41
+ break;
42
+ case "invoice.paid":
43
+ await upsertInvoiceFromStripe(whCtx, obj);
44
+ // Collect the fixed/tier platform fee the per-invoice path (BTS-51) misses
45
+ // on a subscription's synchronously-finalized FIRST invoice (BTS-68).
46
+ await applyFirstInvoiceFee(whCtx, obj);
47
+ // Fan funds to split recipients each billing cycle for a separate-charges
48
+ // subscription (BTS-52).
49
+ await handleInvoiceSplitTransfers(whCtx, obj);
50
+ break;
51
+ case "invoice.finalized":
52
+ case "invoice.payment_failed":
53
+ await upsertInvoiceFromStripe(whCtx, obj);
54
+ break;
55
+ case "payment_intent.succeeded": {
56
+ const pi = obj;
57
+ // Collect a deferred fixed/tier fee first so the payments row can carry
58
+ // feeCollectedAmount in the same write (BTS-60).
59
+ const perChargeFee = await applyPerChargeFee(whCtx, pi);
60
+ await upsertPaymentFromStripe(whCtx, pi, perChargeFee);
61
+ // Fan funds out to split recipients for a separate-charges sale.
62
+ await handleSplitTransfers(whCtx, pi);
63
+ break;
64
+ }
65
+ case "payment_intent.payment_failed":
66
+ case "payment_intent.canceled":
67
+ await upsertPaymentFromStripe(whCtx, obj);
68
+ break;
69
+ case "payout.created":
70
+ case "payout.updated":
71
+ case "payout.paid":
72
+ case "payout.failed":
73
+ await handlePayoutEvent(whCtx, obj);
74
+ break;
75
+ case "refund.created":
76
+ case "refund.updated":
77
+ case "refund.failed":
78
+ await handleRefundEvent(whCtx, obj);
79
+ break;
80
+ case "application_fee.refunded":
81
+ // Keep feeCollectedAmount/feeRefundedAmount accurate on the linked
82
+ // payment (BTS-34, folded in from BTS-51).
83
+ await handleApplicationFeeRefunded(whCtx, obj);
84
+ break;
85
+ case "charge.dispute.created":
86
+ case "charge.dispute.updated":
87
+ case "charge.dispute.closed":
88
+ case "charge.dispute.funds_withdrawn":
89
+ case "charge.dispute.funds_reinstated":
90
+ await handleDisputeEvent(whCtx, obj, event.type.replace("charge.dispute.", ""));
91
+ break;
92
+ default:
93
+ console.info(`[better-stripe] Unhandled event type: ${event.type}`);
94
+ }
95
+ }
96
+ async function handleProductEvent(whCtx, product) {
97
+ const productAccount = product.account;
98
+ await dispatchUpsert(whCtx, "productUpserted", {
99
+ stripeProductId: product.id,
100
+ accountId: typeof productAccount === "string" ? productAccount : undefined,
101
+ name: product.name,
102
+ description: product.description ?? undefined,
103
+ active: product.active,
104
+ metadata: product.metadata ?? undefined,
105
+ });
106
+ }
107
+ async function handlePriceEvent(whCtx, price) {
108
+ const { ctx, component, stripe } = whCtx;
109
+ const stripeProductId = typeof price.product === "string"
110
+ ? price.product
111
+ : (price.product?.id ?? "");
112
+ let internalProduct = (await ctx.runQuery(componentRef(component, "products/queries/getProductByStripeId"), { stripeProductId }));
113
+ if (!internalProduct && stripeProductId) {
114
+ try {
115
+ const stripeProduct = await stripe.products.retrieve(stripeProductId);
116
+ await ctx.runMutation(componentRef(component, "products/mutations/upsertProduct"), {
117
+ stripeProductId: stripeProduct.id,
118
+ name: stripeProduct.name,
119
+ description: stripeProduct.description ?? undefined,
120
+ active: stripeProduct.active,
121
+ metadata: stripeProduct.metadata ?? undefined,
122
+ });
123
+ internalProduct = (await ctx.runQuery(componentRef(component, "products/queries/getProductByStripeId"), { stripeProductId }));
124
+ }
125
+ catch (err) {
126
+ console.warn(`[better-stripe] Could not auto-create product ${stripeProductId}:`, err);
127
+ }
128
+ }
129
+ if (!internalProduct) {
130
+ console.warn(`[better-stripe] Skipping price ${price.id}: product ${stripeProductId} not found`);
131
+ return;
132
+ }
133
+ await dispatchUpsert(whCtx, "priceUpserted", {
134
+ stripePriceId: price.id,
135
+ productId: internalProduct._id,
136
+ stripeProductId,
137
+ nickname: price.nickname ?? undefined,
138
+ unitAmount: price.unit_amount ?? 0,
139
+ currency: price.currency,
140
+ active: price.active,
141
+ type: price.type,
142
+ interval: price.recurring?.interval,
143
+ intervalCount: price.recurring?.interval_count ?? undefined,
144
+ metadata: price.metadata ?? undefined,
145
+ });
146
+ }
147
+ async function upsertSubscriptionFromStripe(whCtx, subscription, dispatcherName) {
148
+ const { userId, orgId } = extractIdentifiers(subscription.metadata);
149
+ const trial = deriveTrialFields(subscription);
150
+ const firstItem = subscription.items?.data?.[0];
151
+ const priceId = firstItem?.price?.id ?? undefined;
152
+ const periodStart = firstItem?.current_period_start ?? undefined;
153
+ const periodEnd = firstItem?.current_period_end ?? undefined;
154
+ // Prefer the V2 `customer_account` (acct_…) over the legacy `customer`
155
+ // (cus_…) so V2 customer-configured accounts are attributed correctly.
156
+ const accountId = resolveOwnerAccount(subscription) ?? undefined;
157
+ await dispatchUpsert(whCtx, dispatcherName, {
158
+ stripeSubscriptionId: subscription.id,
159
+ accountId,
160
+ userId,
161
+ orgId,
162
+ status: subscription.status,
163
+ priceId,
164
+ quantity: firstItem?.quantity ?? undefined,
165
+ currentPeriodStart: epochToIso(periodStart),
166
+ currentPeriodEnd: epochToIso(periodEnd),
167
+ cancelAtPeriodEnd: subscription.cancel_at_period_end,
168
+ canceledAt: epochToIso(subscription.canceled_at),
169
+ isTrialing: trial.isTrialing,
170
+ trialStart: trial.trialStart,
171
+ trialEnd: trial.trialEnd,
172
+ metadata: subscription.metadata ?? undefined,
173
+ });
174
+ }
175
+ async function handleCheckoutEvent(whCtx, session) {
176
+ const { ctx, component } = whCtx;
177
+ const { userId, orgId } = extractIdentifiers(session.metadata);
178
+ const lineItems = session.line_items?.data;
179
+ const priceId = lineItems?.[0]?.price?.id;
180
+ let mergedMetadata = session.metadata ?? undefined;
181
+ try {
182
+ const existing = (await ctx.runQuery(componentRef(component, "billing/queries/getCheckoutSessionByStripeId"), { stripeSessionId: session.id }));
183
+ if (existing?.metadata) {
184
+ mergedMetadata = {
185
+ ...(existing.metadata ?? {}),
186
+ ...(session.metadata ?? {}),
187
+ };
188
+ }
189
+ }
190
+ catch {
191
+ // First time seeing this session
192
+ }
193
+ await dispatchUpsert(whCtx, "checkoutSessionUpserted", {
194
+ stripeSessionId: session.id,
195
+ userId,
196
+ orgId,
197
+ accountId: resolveOwnerAccount(session) ?? undefined,
198
+ mode: (session.mode ?? "payment"),
199
+ status: (session.status ?? "open"),
200
+ clientSecret: session.client_secret ?? undefined,
201
+ url: session.url ?? undefined,
202
+ priceId,
203
+ metadata: mergedMetadata,
204
+ });
205
+ }
206
+ /**
207
+ * Fee/transfer fields (BTS-11) captured off a PaymentIntent for denormalization
208
+ * onto the `payments` row. Returns `{}` when the charge carried no fee/transfer.
209
+ */
210
+ function feeRoutingFromPaymentIntent(pi) {
211
+ const dest = pi.transfer_data?.destination;
212
+ const destinationAccountId = typeof dest === "string" ? dest : dest?.id;
213
+ const fee = pi.application_fee_amount ?? undefined;
214
+ if (!destinationAccountId && fee === undefined)
215
+ return {};
216
+ return {
217
+ chargeType: "destination",
218
+ ...(destinationAccountId ? { destinationAccountId } : {}),
219
+ ...(fee !== undefined
220
+ ? { applicationFeeAmount: fee, feeCollectedAmount: fee }
221
+ : {}),
222
+ };
223
+ }
224
+ /**
225
+ * Apply a fixed/tier platform fee to a subscription invoice before it finalizes
226
+ * (BTS-51). Percent-only fees ride on the subscription's `application_fee_percent`
227
+ * and skip this; fixed/tier fees can't be expressed that way, so BTS-15/BTS-17
228
+ * flag the subscription with `bsFeeMode=per_invoice` + `bsFeeConfig`. Here we
229
+ * read that flag off the subscription, compute the exact fee from the invoice
230
+ * amount, and set `application_fee_amount` on the draft invoice. Idempotent via
231
+ * a `bsFeeApplied` invoice-metadata marker; failures never crash the webhook.
232
+ */
233
+ async function applyPerInvoiceFee(whCtx, invoice) {
234
+ try {
235
+ if (!invoice.id)
236
+ return;
237
+ if (invoice.metadata?.bsFeeApplied)
238
+ return; // already applied
239
+ const parentSub = invoice.parent?.subscription_details?.subscription;
240
+ const subId = typeof parentSub === "string" ? parentSub : (parentSub?.id ?? undefined);
241
+ if (!subId)
242
+ return;
243
+ const sub = await whCtx.stripe.subscriptions.retrieve(subId);
244
+ const meta = (sub.metadata ?? {});
245
+ if (meta.bsFeeMode !== "per_invoice" || !meta.bsFeeConfig)
246
+ return;
247
+ let config;
248
+ try {
249
+ config = JSON.parse(meta.bsFeeConfig);
250
+ }
251
+ catch {
252
+ return; // malformed marker — nothing safe to apply
253
+ }
254
+ const fee = computeFee(invoice.amount_due, config).feeAmount;
255
+ // A shape-invalid config (e.g. non-numeric percent) yields NaN; never send
256
+ // a non-finite application_fee_amount to Stripe.
257
+ if (!Number.isFinite(fee) || fee <= 0)
258
+ return;
259
+ await whCtx.stripe.invoices.update(invoice.id, {
260
+ application_fee_amount: fee,
261
+ metadata: { ...(invoice.metadata ?? {}), bsFeeApplied: "1" },
262
+ });
263
+ }
264
+ catch (err) {
265
+ // Never let fee application break webhook processing; Stripe will retry the
266
+ // event, and a missed fixed-fee invoice can be reconciled out of band.
267
+ console.error("[better-stripe] applyPerInvoiceFee failed:", err);
268
+ }
269
+ }
270
+ /**
271
+ * Set the per-store statement descriptor on a subscription invoice before it
272
+ * finalizes (BTS-32). Destination-charge subscriptions can't carry a suffix
273
+ * directly, so BTS-15/BTS-17 stash the resolved suffix as a
274
+ * `bsStatementDescriptor` subscription-metadata marker; for card charges
275
+ * Stripe renders the invoice's `statement_descriptor` as the dynamic suffix
276
+ * after the platform's shortened descriptor. Idempotent: an invoice whose
277
+ * descriptor is already set (by us on a retry, or by the app) is left alone.
278
+ *
279
+ * FIRST-INVOICE HANDOFF (BTS-67) — this invoice-time path can't reach the FIRST
280
+ * invoice: direct `charge_automatically` subscriptions (and Checkout
281
+ * subscription mode) finalize and pay invoice #1 synchronously at creation,
282
+ * before this `invoice.created` handler runs, so by the time we'd call
283
+ * `invoices.update` the charge already exists. That first charge is instead
284
+ * covered by the **product-level** `statement_descriptor` set at product
285
+ * create/update (BTS-67, `resolveProductStatementDescriptor`): per Stripe's
286
+ * precedence (Invoice → Product → default) the product descriptor applies to
287
+ * every cycle including the first. This per-invoice path still owns LATER
288
+ * invoices and the invoice-level override (which wins over the product), and
289
+ * remains the only mechanism for products created before a store set its
290
+ * descriptor. The two are complementary, not redundant.
291
+ *
292
+ * Failure contract: descriptor application is cosmetic, so failures are
293
+ * swallowed (logged) rather than failing the event — a missed descriptor
294
+ * self-heals on the NEXT billing cycle's invoice and must never block fee
295
+ * application or invoice recording. This is honest: once the event ends
296
+ * `processed`, THIS invoice's descriptor is not retried.
297
+ */
298
+ async function applyStatementDescriptor(whCtx, invoice) {
299
+ try {
300
+ if (!invoice.id)
301
+ return;
302
+ if (invoice.statement_descriptor)
303
+ return; // already set — never overwrite
304
+ const parentSub = invoice.parent?.subscription_details?.subscription;
305
+ const subId = typeof parentSub === "string" ? parentSub : (parentSub?.id ?? undefined);
306
+ if (!subId)
307
+ return;
308
+ const sub = await whCtx.stripe.subscriptions.retrieve(subId);
309
+ const marker = (sub.metadata ?? {})["bsStatementDescriptor"];
310
+ if (!marker)
311
+ return;
312
+ // Defensive: the marker was validated when stored, but webhooks never
313
+ // trust round-tripped metadata enough to forward a rule-breaking value.
314
+ let suffix;
315
+ try {
316
+ suffix = validateStatementDescriptorSuffix(marker);
317
+ }
318
+ catch {
319
+ console.error(`[better-stripe] applyStatementDescriptor: invalid bsStatementDescriptor on ${subId}; skipping`);
320
+ return;
321
+ }
322
+ await whCtx.stripe.invoices.update(invoice.id, {
323
+ statement_descriptor: suffix,
324
+ });
325
+ }
326
+ catch (err) {
327
+ console.error("[better-stripe] applyStatementDescriptor failed:", err);
328
+ }
329
+ }
330
+ /**
331
+ * Collect the fixed/tier platform fee that {@link applyPerInvoiceFee} (BTS-51)
332
+ * silently misses on a subscription's FIRST invoice (BTS-68).
333
+ *
334
+ * Stripe finalizes the first invoice of a `charge_automatically` subscription
335
+ * (and pays the first invoice of a Checkout subscription-mode session)
336
+ * synchronously at creation — it is already `open` by the time `invoice.created`
337
+ * is processed, so the `invoices.update({ application_fee_amount })` that the
338
+ * per-invoice path relies on is rejected (monetary values are uneditable once an
339
+ * invoice finalizes) and the fee is never collected. Renewal invoices are fine:
340
+ * they get Stripe's ~1h draft window, so the per-invoice path applies the fee
341
+ * there.
342
+ *
343
+ * Here — at `invoice.paid`, when the charge and its automatic transfer exist —
344
+ * we realize the missed fee the way Stripe settles application fees on
345
+ * destination charges (and the way BTS-60's per_charge path does): a partial
346
+ * reversal of the destination transfer, sized from the amount actually paid.
347
+ *
348
+ * No double-collection: an invoice whose fee the draft path already applied
349
+ * carries `application_fee_amount`/`bsFeeApplied`, and is skipped — so every
350
+ * renewal (and any invoice that did get its draft window) is untouched.
351
+ * Percent-only subscriptions never reach here (they use
352
+ * `application_fee_percent`); one-time per_charge charges have no invoice.
353
+ * Idempotent via a fresh-invoice `bsFeeCollected` marker plus a deterministic
354
+ * Stripe idempotency key.
355
+ *
356
+ * Failure contract (matching {@link applyPerChargeFee}, NOT the swallow-all of
357
+ * {@link applyPerInvoiceFee}): genuine collection failures (a retrieve/reversal/
358
+ * mark API error, or a paid invoice with no resolvable charge) PROPAGATE so the
359
+ * event is marked `failed` and Stripe retries — a swallowed error would 200 and
360
+ * lose the fee forever. Benign skips a retry can't fix (unflagged subscription,
361
+ * already collected, zero amount, malformed config, no destination transfer)
362
+ * return undefined without throwing.
363
+ *
364
+ * Documented limitation: the fee is recorded on the invoice (`bsFeeAmount`
365
+ * marker) and via the reversal, but — unlike the per_charge path — it is not
366
+ * denormalized onto the `payments` row for the first invoice's PaymentIntent.
367
+ */
368
+ async function applyFirstInvoiceFee(whCtx, invoice) {
369
+ if (!invoice.id)
370
+ return undefined;
371
+ // No money settled → no charge/transfer to reverse (trial, 100%-off, credit).
372
+ if (!(invoice.amount_paid > 0))
373
+ return undefined;
374
+ const parentSub = invoice.parent?.subscription_details?.subscription;
375
+ const subId = typeof parentSub === "string" ? parentSub : (parentSub?.id ?? undefined);
376
+ if (!subId)
377
+ return undefined; // not a subscription invoice
378
+ const sub = await whCtx.stripe.subscriptions.retrieve(subId);
379
+ const subMeta = (sub?.metadata ?? {});
380
+ if (subMeta.bsFeeMode !== "per_invoice" || !subMeta.bsFeeConfig) {
381
+ return undefined;
382
+ }
383
+ // The event payload is a stale snapshot on retries; read fresh so the
384
+ // already-collected guard and our idempotency marker are authoritative.
385
+ const fresh = await whCtx.stripe.invoices.retrieve(invoice.id);
386
+ const freshMeta = (fresh.metadata ?? {});
387
+ // The draft-window path already collected this invoice's fee (every renewal,
388
+ // plus any invoice that got its ~1h draft window): Stripe kept the
389
+ // application_fee_amount and marked bsFeeApplied — the two are set atomically,
390
+ // so either signal means "already collected". Checking Stripe's own field
391
+ // (not just our marker) is the authoritative double-collection guard; the SDK
392
+ // doesn't type it on the Invoice object, hence the narrow read.
393
+ const alreadyOnInvoice = fresh.application_fee_amount;
394
+ if (freshMeta.bsFeeApplied || alreadyOnInvoice != null) {
395
+ return undefined;
396
+ }
397
+ // Our own reversal already ran on a prior delivery (idempotency across retries
398
+ // beyond Stripe's idempotency-key window).
399
+ if (freshMeta.bsFeeCollected) {
400
+ const prior = Number(freshMeta.bsFeeAmount);
401
+ return Number.isFinite(prior) && prior > 0 ? prior : undefined;
402
+ }
403
+ let config;
404
+ try {
405
+ config = JSON.parse(subMeta.bsFeeConfig);
406
+ }
407
+ catch {
408
+ return undefined; // malformed marker — a retry can't fix it
409
+ }
410
+ const fee = computeFee(fresh.amount_paid, config).feeAmount;
411
+ // A shape-invalid config yields NaN; never send a non-finite reversal.
412
+ if (!Number.isFinite(fee) || fee <= 0)
413
+ return undefined;
414
+ // Resolve the charge that paid this invoice and its automatic destination
415
+ // transfer (same resolution as the recurring split path).
416
+ const payments = await whCtx.stripe.invoicePayments.list({
417
+ invoice: invoice.id,
418
+ limit: 1,
419
+ });
420
+ const payment = payments.data?.[0]?.payment;
421
+ let chargeId;
422
+ if (payment?.charge) {
423
+ chargeId =
424
+ typeof payment.charge === "string" ? payment.charge : payment.charge.id;
425
+ }
426
+ else if (payment?.payment_intent) {
427
+ const piId = typeof payment.payment_intent === "string"
428
+ ? payment.payment_intent
429
+ : payment.payment_intent.id;
430
+ const pi = await whCtx.stripe.paymentIntents.retrieve(piId);
431
+ chargeId =
432
+ typeof pi.latest_charge === "string"
433
+ ? pi.latest_charge
434
+ : (pi.latest_charge?.id ?? undefined);
435
+ }
436
+ if (!chargeId) {
437
+ // A paid invoice should have a charge; its absence may be propagation lag, so
438
+ // throw to retry rather than silently skip the fee.
439
+ throw new Error(`First-invoice fee: paid invoice ${invoice.id} for per_invoice subscription ${subId} has no resolvable charge`);
440
+ }
441
+ const charge = await whCtx.stripe.charges.retrieve(chargeId);
442
+ const transferId = typeof charge.transfer === "string"
443
+ ? charge.transfer
444
+ : (charge.transfer?.id ?? undefined);
445
+ if (!transferId) {
446
+ // A per_invoice sub is a destination charge, so the charge should carry an
447
+ // automatic transfer. Its absence is a config anomaly, not a transient
448
+ // fault — rethrowing would loop the event `failed` forever. Log and skip.
449
+ console.error(`[better-stripe] applyFirstInvoiceFee: invoice ${invoice.id} charge ${chargeId} has no destination transfer to reverse`);
450
+ return undefined;
451
+ }
452
+ // BTS-69: adopt an existing reversal we already created for THIS invoice as the
453
+ // idempotency source of truth, rather than trusting the live-recomputed amount.
454
+ // The `bsFeeCollected` marker write below can fail AFTER the reversal succeeds;
455
+ // if `bsFeeConfig` is then edited and a retry lands past Stripe's ≤24h
456
+ // idempotency-key window, a recomputed (drifted) amount would create a SECOND
457
+ // reversal — double collection. The reversal's own `bsFeeFor:<invoiceId>` tag
458
+ // survives both the marker-write failure and the key TTL, so finding it means
459
+ // "already collected": re-record the marker with the actually-reversed amount
460
+ // and return without reversing again.
461
+ const priorReversals = await whCtx.stripe.transfers.listReversals(transferId, {
462
+ limit: 100,
463
+ });
464
+ const adopted = priorReversals.data.find((r) => r.metadata?.bsFeeFor === invoice.id);
465
+ if (adopted) {
466
+ await whCtx.stripe.invoices.update(invoice.id, {
467
+ metadata: {
468
+ ...freshMeta,
469
+ bsFeeCollected: "1",
470
+ bsFeeAmount: String(adopted.amount),
471
+ },
472
+ });
473
+ return adopted.amount;
474
+ }
475
+ await whCtx.stripe.transfers.createReversal(transferId, { amount: fee, metadata: { bsFeeFor: invoice.id } }, { idempotencyKey: `bs_infee_${invoice.id}` });
476
+ // Invoice metadata is editable post-finalization (only monetary values lock),
477
+ // so the marker records that the missed fee is now collected. A mark failure
478
+ // after a successful reversal propagates: the retry replays the reversal
479
+ // against the same idempotency key (no second money movement) then completes
480
+ // the mark.
481
+ await whCtx.stripe.invoices.update(invoice.id, {
482
+ metadata: { ...freshMeta, bsFeeCollected: "1", bsFeeAmount: String(fee) },
483
+ });
484
+ return fee;
485
+ }
486
+ /**
487
+ * Collect a deferred platform fee for a one-time destination charge (BTS-60).
488
+ * When the final amount is unknowable at session creation (discounts, custom
489
+ * amounts), checkout flags the PaymentIntent with `bsFeeMode=per_charge` +
490
+ * `bsFeeConfig`. An `application_fee_amount` can't be attached after the PI
491
+ * succeeds, so the fee is realized the way Stripe itself settles application
492
+ * fees on destination charges — by pulling funds back from the connected
493
+ * account: a partial reversal of the automatic transfer, sized from the amount
494
+ * actually charged (never the session's list amount). Idempotent via a
495
+ * `bsFeeCollected` marker read off a freshly-retrieved PI (the event payload is
496
+ * a stale snapshot on retries) plus a deterministic Stripe idempotency key.
497
+ *
498
+ * Failure contract: genuine collection failures (a retrieve/reversal/mark API
499
+ * error) PROPAGATE, so the handler marks the event `failed` and Stripe retries
500
+ * — a swallowed error would 200 and mark the event `processed` (terminal),
501
+ * silently losing the fee forever. Re-runs converge: the fresh-PI marker skips
502
+ * completed collections, the idempotency key replays an unmarked reversal
503
+ * without moving money twice (inputs are immutable post-success, so the params
504
+ * are identical), and the downstream payment upsert / split engine are
505
+ * idempotent. Benign skips a retry can't fix (unflagged PI, malformed config,
506
+ * zero fee, no destination transfer) return undefined without throwing.
507
+ *
508
+ * Documented limitations (both shared with the up-front and per_invoice
509
+ * paths): a fee config's `fixed`/tier bounds are minor units in the session's
510
+ * assumed currency — they are not converted if the charge settles in another
511
+ * currency; and an app that injects `transfer_data.amount` via
512
+ * `sessionOverrides` while relying on per_charge deferral could make the fee
513
+ * exceed the transfer's remainder, which fails the reversal (→ retry/alert)
514
+ * rather than over-reversing.
515
+ *
516
+ * Returns the fee collected — now or on a prior delivery — so the caller can
517
+ * denormalize `feeCollectedAmount` onto the payments row.
518
+ */
519
+ async function applyPerChargeFee(whCtx, paymentIntent) {
520
+ if (paymentIntent.status !== "succeeded")
521
+ return undefined;
522
+ const meta = (paymentIntent.metadata ?? {});
523
+ if (meta.bsFeeMode !== "per_charge" || !meta.bsFeeConfig)
524
+ return undefined;
525
+ const fresh = await whCtx.stripe.paymentIntents.retrieve(paymentIntent.id);
526
+ const freshMeta = (fresh.metadata ?? {});
527
+ if (freshMeta.bsFeeCollected) {
528
+ const prior = Number(freshMeta.bsFeeAmount);
529
+ return Number.isFinite(prior) && prior > 0 ? prior : undefined;
530
+ }
531
+ let config;
532
+ try {
533
+ config = JSON.parse(freshMeta.bsFeeConfig ?? meta.bsFeeConfig);
534
+ }
535
+ catch {
536
+ return undefined; // malformed marker — a retry can't fix it
537
+ }
538
+ const amount = fresh.amount_received ?? paymentIntent.amount;
539
+ const fee = computeFee(amount, config).feeAmount;
540
+ // A shape-invalid config yields NaN; never send a non-finite reversal.
541
+ if (!Number.isFinite(fee) || fee <= 0)
542
+ return undefined;
543
+ // Resolve the automatic transfer `transfer_data` created on the charge.
544
+ const chargeId = typeof fresh.latest_charge === "string"
545
+ ? fresh.latest_charge
546
+ : (fresh.latest_charge?.id ?? undefined);
547
+ if (!chargeId)
548
+ return undefined;
549
+ const charge = await whCtx.stripe.charges.retrieve(chargeId);
550
+ const transferId = typeof charge.transfer === "string"
551
+ ? charge.transfer
552
+ : (charge.transfer?.id ?? undefined);
553
+ if (!transferId) {
554
+ // Config anomaly, not a transient fault — rethrowing would loop the event
555
+ // `failed` forever. Log and record the sale without a fee.
556
+ console.error(`[better-stripe] applyPerChargeFee: per_charge PI ${paymentIntent.id} has no destination transfer to reverse`);
557
+ return undefined;
558
+ }
559
+ await whCtx.stripe.transfers.createReversal(transferId, { amount: fee, metadata: { bsFeeFor: paymentIntent.id } }, { idempotencyKey: `bs_pcfee_${paymentIntent.id}` });
560
+ // A mark failure after a successful reversal also propagates: the retry
561
+ // replays the reversal against the same idempotency key (no second money
562
+ // movement) and then completes the mark + payments-row denormalization.
563
+ await whCtx.stripe.paymentIntents.update(paymentIntent.id, {
564
+ metadata: { ...freshMeta, bsFeeCollected: "1", bsFeeAmount: String(fee) },
565
+ });
566
+ return fee;
567
+ }
568
+ async function upsertInvoiceFromStripe(whCtx, invoice) {
569
+ const { userId, orgId } = extractIdentifiers(invoice.metadata);
570
+ const parentSub = invoice.parent?.subscription_details?.subscription;
571
+ const subscriptionId = typeof parentSub === "string" ? parentSub : (parentSub?.id ?? undefined);
572
+ await dispatchUpsert(whCtx, "invoiceUpserted", {
573
+ stripeInvoiceId: invoice.id,
574
+ userId,
575
+ orgId,
576
+ accountId: resolveOwnerAccount(invoice) ?? undefined,
577
+ subscriptionId,
578
+ status: invoice.status ?? "draft",
579
+ currency: invoice.currency,
580
+ amountDue: invoice.amount_due,
581
+ amountPaid: invoice.amount_paid,
582
+ hostedInvoiceUrl: invoice.hosted_invoice_url ?? undefined,
583
+ invoicePdf: invoice.invoice_pdf ?? undefined,
584
+ periodStart: epochToIso(invoice.period_start),
585
+ periodEnd: epochToIso(invoice.period_end),
586
+ // Smart-retry dunning (BTS-33): surface Stripe's retry schedule so a
587
+ // dunning hook can tell the buyer when the next attempt lands.
588
+ nextPaymentAttempt: epochToIso(invoice.next_payment_attempt),
589
+ attemptCount: invoice.attempt_count ?? undefined,
590
+ metadata: invoice.metadata ?? undefined,
591
+ });
592
+ }
593
+ /**
594
+ * Drive the split transfer engine (BTS-22) for a separate-charges sale. When a
595
+ * PaymentIntent created with `bsChargeType=separate` succeeds, parse the split
596
+ * (and platform fee) from its metadata and fan funds out to each recipient via
597
+ * `source_transaction` on the resulting charge. Errors propagate so Stripe
598
+ * retries; the engine's idempotency keys make retries safe.
599
+ */
600
+ async function handleSplitTransfers(whCtx, paymentIntent) {
601
+ if (paymentIntent.status !== "succeeded")
602
+ return;
603
+ const meta = (paymentIntent.metadata ?? {});
604
+ // Not a split sale — nothing to do.
605
+ if (meta.bsChargeType !== "separate" || !meta.bsSplit)
606
+ return;
607
+ // From here the PI IS a separate-charges sale, so a missing charge or
608
+ // malformed split is a real failure: throw so the webhook returns 500 and
609
+ // Stripe retries (visible + recoverable) rather than silently skipping payouts.
610
+ const sourceChargeId = typeof paymentIntent.latest_charge === "string"
611
+ ? paymentIntent.latest_charge
612
+ : (paymentIntent.latest_charge?.id ?? undefined);
613
+ if (!sourceChargeId) {
614
+ throw new Error(`Split-transfer sale ${paymentIntent.id} succeeded without a latest_charge; cannot create transfers`);
615
+ }
616
+ let split;
617
+ let feeConfig;
618
+ try {
619
+ split = JSON.parse(meta.bsSplit);
620
+ feeConfig = meta.bsFeeConfig
621
+ ? JSON.parse(meta.bsFeeConfig)
622
+ : undefined;
623
+ }
624
+ catch (err) {
625
+ throw new Error(`Split-transfer sale ${paymentIntent.id} has malformed bsSplit/bsFeeConfig metadata: ${String(err)}`);
626
+ }
627
+ await createSplitTransfers(whCtx.stripe, whCtx.component, whCtx.ctx, {
628
+ sourceChargeId,
629
+ amount: paymentIntent.amount,
630
+ currency: paymentIntent.currency,
631
+ split,
632
+ feeConfig,
633
+ paymentId: paymentIntent.id,
634
+ });
635
+ }
636
+ /**
637
+ * Drive the split transfer engine for a **recurring** separate-charges sale
638
+ * (BTS-52). On each `invoice.paid` for a subscription flagged
639
+ * `bsChargeType=separate` (markers live on the subscription), resolve this
640
+ * invoice's charge and fan funds out to the recipients — so an affiliate-referred
641
+ * subscription splits every billing cycle. Each cycle has a distinct charge, so
642
+ * the ledger keys per-charge and cycles don't collide. Errors propagate so
643
+ * Stripe retries; the engine's idempotency keeps retries safe.
644
+ */
645
+ async function handleInvoiceSplitTransfers(whCtx, invoice) {
646
+ // Nothing to split when no money was collected (e.g. 100%-off coupon, account
647
+ // credit, or proration). Skip before any charge resolution so a zero-amount
648
+ // invoice — which has no charge — can't throw and force endless retries.
649
+ if (!(invoice.amount_paid > 0))
650
+ return;
651
+ const parentSub = invoice.parent?.subscription_details?.subscription;
652
+ const subId = typeof parentSub === "string" ? parentSub : (parentSub?.id ?? undefined);
653
+ if (!subId)
654
+ return; // not a subscription invoice
655
+ const sub = await whCtx.stripe.subscriptions.retrieve(subId);
656
+ const meta = (sub?.metadata ?? {});
657
+ if (meta.bsChargeType !== "separate" || !meta.bsSplit)
658
+ return;
659
+ let split;
660
+ let feeConfig;
661
+ try {
662
+ split = JSON.parse(meta.bsSplit);
663
+ feeConfig = meta.bsFeeConfig
664
+ ? JSON.parse(meta.bsFeeConfig)
665
+ : undefined;
666
+ }
667
+ catch (err) {
668
+ throw new Error(`Subscription ${subId} has malformed bsSplit/bsFeeConfig metadata: ${String(err)}`);
669
+ }
670
+ // Resolve the charge that paid this invoice (source_transaction for transfers).
671
+ const payments = await whCtx.stripe.invoicePayments.list({
672
+ invoice: invoice.id,
673
+ limit: 1,
674
+ });
675
+ const payment = payments.data?.[0]?.payment;
676
+ let chargeId;
677
+ if (payment?.charge) {
678
+ chargeId =
679
+ typeof payment.charge === "string" ? payment.charge : payment.charge.id;
680
+ }
681
+ else if (payment?.payment_intent) {
682
+ const piId = typeof payment.payment_intent === "string"
683
+ ? payment.payment_intent
684
+ : payment.payment_intent.id;
685
+ const pi = await whCtx.stripe.paymentIntents.retrieve(piId);
686
+ chargeId =
687
+ typeof pi.latest_charge === "string"
688
+ ? pi.latest_charge
689
+ : (pi.latest_charge?.id ?? undefined);
690
+ }
691
+ if (!chargeId) {
692
+ throw new Error(`Paid invoice ${invoice.id} for split subscription ${subId} has no resolvable charge; cannot create transfers`);
693
+ }
694
+ await createSplitTransfers(whCtx.stripe, whCtx.component, whCtx.ctx, {
695
+ sourceChargeId: chargeId,
696
+ amount: invoice.amount_paid,
697
+ currency: invoice.currency,
698
+ split,
699
+ feeConfig,
700
+ });
701
+ }
702
+ async function upsertPaymentFromStripe(whCtx, paymentIntent, perChargeFee) {
703
+ const { userId, orgId } = extractIdentifiers(paymentIntent.metadata);
704
+ const statusMap = {
705
+ succeeded: "succeeded",
706
+ canceled: "canceled",
707
+ processing: "processing",
708
+ requires_action: "requires_action",
709
+ requires_confirmation: "requires_action",
710
+ requires_payment_method: "requires_action",
711
+ requires_capture: "requires_action",
712
+ };
713
+ const status = (statusMap[paymentIntent.status] ?? "failed");
714
+ await dispatchUpsert(whCtx, "paymentUpserted", {
715
+ stripePaymentIntentId: paymentIntent.id,
716
+ userId,
717
+ orgId,
718
+ accountId: resolveOwnerAccount(paymentIntent) ?? undefined,
719
+ amount: paymentIntent.amount,
720
+ currency: paymentIntent.currency,
721
+ status,
722
+ // Only a succeeded intent actually collected the fee. Failed/canceled
723
+ // intents can still carry transfer_data/application_fee_amount, so don't
724
+ // persist fee/routing for them.
725
+ ...(paymentIntent.status === "succeeded"
726
+ ? feeRoutingFromPaymentIntent(paymentIntent)
727
+ : {}),
728
+ // A per-charge fee is collected via transfer reversal (BTS-60), so it never
729
+ // appears as application_fee_amount on the intent — merge it in directly.
730
+ ...(perChargeFee !== undefined ? { feeCollectedAmount: perChargeFee } : {}),
731
+ metadata: paymentIntent.metadata ?? undefined,
732
+ });
733
+ }
734
+ async function handlePayoutEvent(whCtx, payout) {
735
+ await dispatchUpsert(whCtx, "payoutUpserted", {
736
+ stripePayoutId: payout.id,
737
+ accountId: typeof payout.destination === "string"
738
+ ? payout.destination
739
+ : (payout.destination?.id ?? ""),
740
+ amount: payout.amount,
741
+ currency: payout.currency,
742
+ status: payout.status,
743
+ arrivalDate: epochToIso(payout.arrival_date),
744
+ method: payout.method ?? undefined,
745
+ metadata: payout.metadata ?? undefined,
746
+ });
747
+ }
748
+ // Stripe types Refund.status as `string | null`; clamp to the documented union.
749
+ const REFUND_STATUSES = new Set([
750
+ "pending",
751
+ "requires_action",
752
+ "succeeded",
753
+ "failed",
754
+ "canceled",
755
+ ]);
756
+ const REFUND_REASONS = new Set([
757
+ "duplicate",
758
+ "fraudulent",
759
+ "requested_by_customer",
760
+ "expired_uncaptured_charge",
761
+ ]);
762
+ async function handleRefundEvent(whCtx, refund) {
763
+ const paymentIntentId = typeof refund.payment_intent === "string"
764
+ ? refund.payment_intent
765
+ : (refund.payment_intent?.id ?? undefined);
766
+ const chargeId = typeof refund.charge === "string"
767
+ ? refund.charge
768
+ : (refund.charge?.id ?? undefined);
769
+ const status = refund.status && REFUND_STATUSES.has(refund.status)
770
+ ? refund.status
771
+ : "pending";
772
+ const reason = refund.reason && REFUND_REASONS.has(refund.reason)
773
+ ? refund.reason
774
+ : undefined;
775
+ await dispatchUpsert(whCtx, "refundUpserted", {
776
+ stripeRefundId: refund.id,
777
+ stripePaymentIntentId: paymentIntentId,
778
+ stripeChargeId: chargeId,
779
+ amount: refund.amount,
780
+ currency: refund.currency,
781
+ status,
782
+ reason,
783
+ failureReason: refund.failure_reason ?? undefined,
784
+ metadata: refund.metadata ?? undefined,
785
+ });
786
+ // Split-sale clawback (BTS-34): when a separate-charges sale is refunded,
787
+ // pull the refunded share back from each recipient pro-rata. Only ledger
788
+ // legs identify a split sale — destination-charge auto-transfers are not in
789
+ // the ledger and are handled by Stripe-native `reverse_transfer` at refund
790
+ // creation. Runs on `refund.updated` too so a pending→succeeded refund
791
+ // (e.g. ACH) still claws back. Errors propagate → event `failed` → Stripe
792
+ // retries; `reverseTransfersForRefund`'s delta-to-target math makes the
793
+ // re-run converge without double-reversing.
794
+ if (status !== "succeeded" || !chargeId)
795
+ return;
796
+ const legs = ((await whCtx.ctx.runQuery(componentRef(whCtx.component, "connect/queries/listTransfersByCharge"), { sourceChargeId: chargeId })) ?? []);
797
+ if (legs.length === 0)
798
+ return; // not a split sale
799
+ // Fresh charge read for the authoritative cumulative amount_refunded.
800
+ const charge = await whCtx.stripe.charges.retrieve(chargeId);
801
+ await reverseTransfersForRefund(whCtx.stripe, whCtx.component, whCtx.ctx, {
802
+ sourceChargeId: chargeId,
803
+ refundId: refund.id,
804
+ chargeAmount: charge.amount,
805
+ amountRefunded: charge.amount_refunded ?? refund.amount,
806
+ });
807
+ }
808
+ /**
809
+ * Denormalize fee-refund state from `application_fee.refunded` (BTS-34, folded
810
+ * in from BTS-51): set the linked payment's `feeRefundedAmount` and correct
811
+ * `feeCollectedAmount` to the net fee kept. Values are Stripe's ABSOLUTE
812
+ * cumulative totals — this handler never increments, so event redeliveries and
813
+ * `createRefund(refundApplicationFee: true)`-triggered duplicates can't
814
+ * double-count. Benign skips (no charge, no payment intent, no payment row)
815
+ * return quietly; lookup/mutation failures propagate so the event retries.
816
+ */
817
+ async function handleApplicationFeeRefunded(whCtx, fee) {
818
+ const chargeId = typeof fee.charge === "string" ? fee.charge : (fee.charge?.id ?? undefined);
819
+ if (!chargeId)
820
+ return;
821
+ const charge = await whCtx.stripe.charges.retrieve(chargeId);
822
+ const paymentIntentId = typeof charge.payment_intent === "string"
823
+ ? charge.payment_intent
824
+ : (charge.payment_intent?.id ?? undefined);
825
+ if (!paymentIntentId)
826
+ return;
827
+ await whCtx.ctx.runMutation(componentRef(whCtx.component, "connect/mutations/recordPaymentFeeRefund"), {
828
+ stripePaymentIntentId: paymentIntentId,
829
+ feeCollectedAmount: Math.max(0, fee.amount - fee.amount_refunded),
830
+ feeRefundedAmount: fee.amount_refunded,
831
+ });
832
+ }
833
+ async function handleDisputeEvent(whCtx, dispute, lastEvent) {
834
+ const paymentIntentId = typeof dispute.payment_intent === "string"
835
+ ? dispute.payment_intent
836
+ : (dispute.payment_intent?.id ?? undefined);
837
+ const chargeId = typeof dispute.charge === "string"
838
+ ? dispute.charge
839
+ : (dispute.charge?.id ?? undefined);
840
+ // Capture the statement descriptor the buyer saw (dispute context) from the
841
+ // charge — the Dispute object doesn't carry it. Only on `created`, and
842
+ // best-effort: this is optional metadata, so a transient charge-lookup failure
843
+ // must never abort the critical dispute side effects (upsert, clawback, cancel).
844
+ let statementDescriptor;
845
+ if (lastEvent === "created" && chargeId) {
846
+ try {
847
+ const charge = await whCtx.stripe.charges.retrieve(chargeId);
848
+ statementDescriptor =
849
+ charge?.calculated_statement_descriptor ??
850
+ charge?.statement_descriptor ??
851
+ undefined;
852
+ }
853
+ catch {
854
+ // leave undefined; the descriptor is non-essential context
855
+ }
856
+ }
857
+ await dispatchUpsert(whCtx, "disputeUpserted", {
858
+ stripeDisputeId: dispute.id,
859
+ stripePaymentIntentId: paymentIntentId,
860
+ stripeChargeId: chargeId,
861
+ amount: dispute.amount,
862
+ currency: dispute.currency,
863
+ // Stripe.Dispute.Status is exactly the component's disputeStatusValidator union.
864
+ status: dispute.status,
865
+ reason: dispute.reason,
866
+ isChargeRefundable: dispute.is_charge_refundable,
867
+ evidenceDueBy: epochToIso(dispute.evidence_details?.due_by ?? undefined),
868
+ ...(statementDescriptor ? { statementDescriptor } : {}),
869
+ lastEvent,
870
+ metadata: dispute.metadata ?? undefined,
871
+ });
872
+ // Clawback (BTS-27): when a dispute is first opened, reverse the transfers
873
+ // funded by the disputed charge pro-rata to the disputed amount, so recipients
874
+ // bear their share (losses_collector=application leaves the platform with the
875
+ // rest). Idempotent via the dispute id; reinstated by BTS-29 if the dispute is
876
+ // won. Only on `created` — other dispute events don't move funds here.
877
+ if (lastEvent === "created" && chargeId) {
878
+ await reverseTransfers(whCtx.stripe, whCtx.component, whCtx.ctx, {
879
+ sourceChargeId: chargeId,
880
+ amount: dispute.amount,
881
+ operationId: dispute.id,
882
+ });
883
+ }
884
+ // Reinstatement (BTS-29): when the dispute is won (or funds are explicitly
885
+ // reinstated), pay recipients back the amounts clawed back on `created`.
886
+ const isWon = lastEvent === "funds_reinstated" ||
887
+ (lastEvent === "closed" && dispute.status === "won");
888
+ if (isWon && chargeId) {
889
+ await reinstateTransfers(whCtx.stripe, whCtx.component, whCtx.ctx, {
890
+ sourceChargeId: chargeId,
891
+ operationId: dispute.id,
892
+ currency: dispute.currency,
893
+ });
894
+ }
895
+ // Auto-cancel the disputed subscription (BTS-28, default on). Resolve the
896
+ // subscription from the dispute's PaymentIntent (invoice payment → invoice →
897
+ // subscription) and cancel it. The resulting subscription.updated/deleted
898
+ // webhook fires the app's subscription trigger to revoke access (Skool model:
899
+ // cancel now, remove at cycle end).
900
+ if (lastEvent === "created" && whCtx.config?.autoCancelOnDispute !== false) {
901
+ await cancelDisputedSubscription(whCtx, dispute);
902
+ }
903
+ }
904
+ async function cancelDisputedSubscription(whCtx, dispute) {
905
+ const piId = typeof dispute.payment_intent === "string"
906
+ ? dispute.payment_intent
907
+ : (dispute.payment_intent?.id ?? undefined);
908
+ if (!piId)
909
+ return;
910
+ const payments = await whCtx.stripe.invoicePayments.list({
911
+ payment: { type: "payment_intent", payment_intent: piId },
912
+ limit: 1,
913
+ });
914
+ const invoiceRef = payments.data?.[0]?.invoice;
915
+ const invoiceId = typeof invoiceRef === "string" ? invoiceRef : (invoiceRef?.id ?? undefined);
916
+ if (!invoiceId)
917
+ return; // not a subscription invoice charge
918
+ const invoice = await whCtx.stripe.invoices.retrieve(invoiceId);
919
+ const parentSub = invoice.parent?.subscription_details?.subscription;
920
+ const subId = typeof parentSub === "string" ? parentSub : (parentSub?.id ?? undefined);
921
+ if (!subId)
922
+ return;
923
+ // Stable idempotency key so a webhook retry can't double-write the cancel.
924
+ const idempotency = { idempotencyKey: `bs_dispute_cancel_${dispute.id}` };
925
+ if (whCtx.config?.cancelDisputedSubscriptionImmediately) {
926
+ await whCtx.stripe.subscriptions.cancel(subId, undefined, idempotency);
927
+ }
928
+ else {
929
+ await whCtx.stripe.subscriptions.update(subId, { cancel_at_period_end: true }, idempotency);
930
+ }
931
+ }
932
+ //# sourceMappingURL=processors.js.map