@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,1689 @@
1
+ // @vitest-environment edge-runtime
2
+ import { type Mock, beforeEach, describe, expect, it, vi } from "vitest";
3
+
4
+ import type {
5
+ RegisterRoutesConfig,
6
+ V2ThinEvent,
7
+ WebhookActionCtx,
8
+ } from "./types.js";
9
+ // ---------------------------------------------------------------------------
10
+ // Import after mocks are set up
11
+ // ---------------------------------------------------------------------------
12
+
13
+ // We can't call registerRoutes directly because it needs HttpRouter.
14
+ // Instead, import the module and extract handleWebhookRequest via registerRoutes.
15
+ import { registerRoutes } from "./webhooks.js";
16
+
17
+ // ---------------------------------------------------------------------------
18
+ // Mock Stripe SDK
19
+ // ---------------------------------------------------------------------------
20
+
21
+ const mockConstructEventAsync = vi.fn();
22
+ const mockParseEventNotification = vi.fn();
23
+ const mockParseEventNotificationAsync = vi.fn();
24
+ const mockAccountRetrieve = vi.fn();
25
+
26
+ vi.mock("stripe", () => {
27
+ return {
28
+ default: class StripeMock {
29
+ webhooks = { constructEventAsync: mockConstructEventAsync };
30
+ parseEventNotification = mockParseEventNotification;
31
+ parseEventNotificationAsync = mockParseEventNotificationAsync;
32
+ v2 = { core: { accounts: { retrieve: mockAccountRetrieve } } };
33
+ products = { retrieve: vi.fn() };
34
+ },
35
+ };
36
+ });
37
+
38
+ // Mock httpActionGeneric to capture the raw handler
39
+ let _capturedHandler:
40
+ | ((ctx: any, request: Request) => Promise<Response>)
41
+ | undefined;
42
+
43
+ vi.mock("convex/server", () => ({
44
+ httpActionGeneric: (fn: any) => fn,
45
+ }));
46
+
47
+ // ---------------------------------------------------------------------------
48
+ // Helpers
49
+ // ---------------------------------------------------------------------------
50
+
51
+ function createMockCtx(
52
+ overrides?: Partial<Omit<WebhookActionCtx, "scheduler">> & {
53
+ scheduler?: { runAfter: Mock };
54
+ },
55
+ ): WebhookActionCtx {
56
+ return {
57
+ runMutation: vi.fn().mockResolvedValue("inserted"),
58
+ runQuery: vi.fn().mockResolvedValue(null),
59
+ runAction: vi.fn().mockResolvedValue(null),
60
+ ...overrides,
61
+ } as WebhookActionCtx;
62
+ }
63
+
64
+ const TO_REFERENCE_PATH = Symbol.for("toReferencePath");
65
+
66
+ function makeRef(path: string) {
67
+ return { [TO_REFERENCE_PATH]: `betterStripe/${path}` };
68
+ }
69
+
70
+ function createMockComponent(): any {
71
+ return {
72
+ core: {
73
+ queries: {
74
+ getAccount: makeRef("core/queries/getAccount"),
75
+ getAccountByStripeId: makeRef("core/queries/getAccountByStripeId"),
76
+ getAccountByUserId: makeRef("core/queries/getAccountByUserId"),
77
+ },
78
+ mutations: {
79
+ upsertAccount: makeRef("core/mutations/upsertAccount"),
80
+ upsertAccountInternal: makeRef("core/mutations/upsertAccountInternal"),
81
+ },
82
+ },
83
+ products: {
84
+ queries: {
85
+ getProductByStripeId: makeRef("products/queries/getProductByStripeId"),
86
+ },
87
+ mutations: {
88
+ upsertProduct: makeRef("products/mutations/upsertProduct"),
89
+ upsertPrice: makeRef("products/mutations/upsertPrice"),
90
+ },
91
+ },
92
+ billing: {
93
+ queries: {
94
+ getCheckoutSessionByStripeId: makeRef(
95
+ "billing/queries/getCheckoutSessionByStripeId",
96
+ ),
97
+ getSubscriptionByStripeId: makeRef(
98
+ "billing/queries/getSubscriptionByStripeId",
99
+ ),
100
+ },
101
+ mutations: {
102
+ upsertSubscription: makeRef("billing/mutations/upsertSubscription"),
103
+ upsertCheckoutSession: makeRef(
104
+ "billing/mutations/upsertCheckoutSession",
105
+ ),
106
+ upsertInvoice: makeRef("billing/mutations/upsertInvoice"),
107
+ },
108
+ },
109
+ connect: {
110
+ queries: {
111
+ getRefundByStripeId: makeRef("connect/queries/getRefundByStripeId"),
112
+ getDisputeByStripeId: makeRef("connect/queries/getDisputeByStripeId"),
113
+ },
114
+ mutations: {
115
+ upsertPayment: makeRef("connect/mutations/upsertPayment"),
116
+ upsertPayout: makeRef("connect/mutations/upsertPayout"),
117
+ upsertRefund: makeRef("connect/mutations/upsertRefund"),
118
+ upsertDispute: makeRef("connect/mutations/upsertDispute"),
119
+ },
120
+ },
121
+ webhooks: {
122
+ mutations: {
123
+ insertWebhookEvent: makeRef("webhooks/mutations/insertWebhookEvent"),
124
+ markWebhookEventProcessed: makeRef(
125
+ "webhooks/mutations/markWebhookEventProcessed",
126
+ ),
127
+ markWebhookEventFailed: makeRef(
128
+ "webhooks/mutations/markWebhookEventFailed",
129
+ ),
130
+ },
131
+ },
132
+ };
133
+ }
134
+
135
+ function makeBaseConfig(
136
+ overrides?: Partial<RegisterRoutesConfig>,
137
+ ): RegisterRoutesConfig {
138
+ return {
139
+ stripeSecretKey: "sk_test_123",
140
+ webhookSecret: "whsec_test_123",
141
+ ...overrides,
142
+ };
143
+ }
144
+
145
+ function makeRequest(body: unknown, headers?: Record<string, string>): Request {
146
+ return new Request("https://example.com/stripe/webhook", {
147
+ method: "POST",
148
+ body: typeof body === "string" ? body : JSON.stringify(body),
149
+ headers: {
150
+ "stripe-signature": "test_sig_123",
151
+ "content-type": "application/json",
152
+ ...headers,
153
+ },
154
+ });
155
+ }
156
+
157
+ function makeV1Event(type: string, obj: Record<string, any> = {}): any {
158
+ return {
159
+ id: "evt_test_" + Math.random().toString(36).slice(2, 8),
160
+ type,
161
+ livemode: false,
162
+ data: { object: obj },
163
+ };
164
+ }
165
+
166
+ function makeV2ThinEvent(overrides?: Partial<V2ThinEvent>): V2ThinEvent {
167
+ return {
168
+ id: "evt_v2_test_" + Math.random().toString(36).slice(2, 8),
169
+ type: "v2.core.account.updated",
170
+ created: new Date().toISOString(),
171
+ livemode: false,
172
+ related_object: {
173
+ id: "acct_test_123",
174
+ type: "v2.core.account",
175
+ url: "/v2/core/accounts/acct_test_123",
176
+ },
177
+ ...overrides,
178
+ };
179
+ }
180
+
181
+ /**
182
+ * Capture the webhook handler by calling registerRoutes with a fake HttpRouter.
183
+ * Returns a function that calls the handler directly.
184
+ */
185
+ function _setupHandler(
186
+ config?: RegisterRoutesConfig,
187
+ ): (ctx: WebhookActionCtx, request: Request) => Promise<Response> {
188
+ let handler: any;
189
+ const fakeRouter = {
190
+ route: (opts: any) => {
191
+ handler = opts.handler;
192
+ },
193
+ };
194
+
195
+ registerRoutes(
196
+ fakeRouter as any,
197
+ createMockComponent(),
198
+ config ?? makeBaseConfig(),
199
+ );
200
+ return handler;
201
+ }
202
+
203
+ async function parseJson(response: Response): Promise<any> {
204
+ return JSON.parse(await response.text());
205
+ }
206
+
207
+ // ---------------------------------------------------------------------------
208
+ // Tests
209
+ // ---------------------------------------------------------------------------
210
+
211
+ describe("webhooks", () => {
212
+ let ctx: WebhookActionCtx;
213
+ let component: ReturnType<typeof createMockComponent>;
214
+ let handler: (ctx: WebhookActionCtx, request: Request) => Promise<Response>;
215
+
216
+ beforeEach(() => {
217
+ vi.clearAllMocks();
218
+ ctx = createMockCtx();
219
+ component = createMockComponent();
220
+
221
+ // Default: constructEventAsync returns a valid V1 event
222
+ mockConstructEventAsync.mockResolvedValue(
223
+ makeV1Event("product.created", {
224
+ id: "prod_123",
225
+ name: "Test",
226
+ active: true,
227
+ }),
228
+ );
229
+
230
+ // Set up the handler via registerRoutes, using a fresh component each time
231
+ let rawHandler: any;
232
+ const fakeRouter = {
233
+ route: (opts: any) => {
234
+ rawHandler = opts.handler;
235
+ },
236
+ };
237
+ registerRoutes(fakeRouter as any, component, makeBaseConfig());
238
+ handler = rawHandler;
239
+ });
240
+
241
+ // =========================================================================
242
+ // Signature & Parse
243
+ // =========================================================================
244
+
245
+ describe("Signature & Parse", () => {
246
+ it("returns 400 for missing stripe-signature header", async () => {
247
+ const request = new Request("https://example.com/stripe/webhook", {
248
+ method: "POST",
249
+ body: JSON.stringify({ type: "product.created" }),
250
+ headers: { "content-type": "application/json" },
251
+ // No stripe-signature header
252
+ });
253
+
254
+ const response = await handler(ctx, request);
255
+ expect(response.status).toBe(400);
256
+ const body = await parseJson(response);
257
+ expect(body.error).toMatch(/missing stripe-signature/i);
258
+ });
259
+
260
+ it("returns 400 for invalid JSON body", async () => {
261
+ const request = new Request("https://example.com/stripe/webhook", {
262
+ method: "POST",
263
+ body: "not-json{{{{",
264
+ headers: {
265
+ "stripe-signature": "test_sig",
266
+ "content-type": "application/json",
267
+ },
268
+ });
269
+
270
+ const response = await handler(ctx, request);
271
+ expect(response.status).toBe(400);
272
+ const body = await parseJson(response);
273
+ expect(body.error).toMatch(/invalid json/i);
274
+ });
275
+
276
+ it("returns 400 for failed signature verification", async () => {
277
+ mockConstructEventAsync.mockRejectedValue(
278
+ new Error("Signature verification failed"),
279
+ );
280
+
281
+ const request = makeRequest({ type: "product.created", id: "evt_123" });
282
+ const response = await handler(ctx, request);
283
+ expect(response.status).toBe(400);
284
+ const body = await parseJson(response);
285
+ expect(body.error).toMatch(/signature verification failed/i);
286
+ });
287
+ });
288
+
289
+ // =========================================================================
290
+ // Dedup
291
+ // =========================================================================
292
+
293
+ describe("Dedup", () => {
294
+ it("returns 200 for duplicate event (already processed)", async () => {
295
+ const event = makeV1Event("product.created", {
296
+ id: "prod_123",
297
+ name: "Test",
298
+ active: true,
299
+ });
300
+ mockConstructEventAsync.mockResolvedValue(event);
301
+ (ctx.runMutation as Mock).mockResolvedValueOnce("already_processed");
302
+
303
+ const request = makeRequest({ type: "product.created" });
304
+ const response = await handler(ctx, request);
305
+ expect(response.status).toBe(200);
306
+ const body = await parseJson(response);
307
+ expect(body.deduplicated).toBe(true);
308
+ });
309
+
310
+ it("returns 200 for duplicate event (currently processing)", async () => {
311
+ const event = makeV1Event("product.created", {
312
+ id: "prod_123",
313
+ name: "Test",
314
+ active: true,
315
+ });
316
+ mockConstructEventAsync.mockResolvedValue(event);
317
+ (ctx.runMutation as Mock).mockResolvedValueOnce("processing");
318
+
319
+ const request = makeRequest({ type: "product.created" });
320
+ const response = await handler(ctx, request);
321
+ expect(response.status).toBe(200);
322
+ const body = await parseJson(response);
323
+ expect(body.deduplicated).toBe(true);
324
+ });
325
+ });
326
+
327
+ // =========================================================================
328
+ // Happy path (V1)
329
+ // =========================================================================
330
+
331
+ describe("Happy path", () => {
332
+ it("calls processEvent for valid V1 events", async () => {
333
+ const event = makeV1Event("product.created", {
334
+ id: "prod_123",
335
+ name: "Test Product",
336
+ active: true,
337
+ description: null,
338
+ metadata: {},
339
+ });
340
+ mockConstructEventAsync.mockResolvedValue(event);
341
+
342
+ const request = makeRequest({ type: "product.created" });
343
+ const response = await handler(ctx, request);
344
+ expect(response.status).toBe(200);
345
+
346
+ // Verify upsertProduct was called
347
+ expect(ctx.runMutation).toHaveBeenCalledWith(
348
+ component.products.mutations.upsertProduct,
349
+ expect.objectContaining({
350
+ stripeProductId: "prod_123",
351
+ name: "Test Product",
352
+ active: true,
353
+ }),
354
+ );
355
+ });
356
+
357
+ it("returns 500 when processEvent throws", async () => {
358
+ const event = makeV1Event("product.created", {
359
+ id: "prod_123",
360
+ name: "Test",
361
+ active: true,
362
+ });
363
+ mockConstructEventAsync.mockResolvedValue(event);
364
+
365
+ // First call: insertWebhookEvent (success)
366
+ // Second call: upsertProduct (throws)
367
+ (ctx.runMutation as Mock)
368
+ .mockResolvedValueOnce("inserted") // insertWebhookEvent
369
+ .mockRejectedValueOnce(new Error("DB write failed")); // upsertProduct
370
+
371
+ const request = makeRequest({ type: "product.created" });
372
+ const response = await handler(ctx, request);
373
+ expect(response.status).toBe(500);
374
+ const body = await parseJson(response);
375
+ expect(body.error).toMatch(/sync processing failed/i);
376
+ });
377
+
378
+ it("marks event as failed in ledger on error", async () => {
379
+ const event = makeV1Event("product.created", {
380
+ id: "prod_123",
381
+ name: "Test",
382
+ active: true,
383
+ });
384
+ mockConstructEventAsync.mockResolvedValue(event);
385
+
386
+ (ctx.runMutation as Mock)
387
+ .mockResolvedValueOnce("inserted") // insertWebhookEvent
388
+ .mockRejectedValueOnce(new Error("DB write failed")) // upsertProduct
389
+ .mockResolvedValueOnce(undefined); // markWebhookEventFailed
390
+
391
+ const request = makeRequest({ type: "product.created" });
392
+ await handler(ctx, request);
393
+
394
+ expect(ctx.runMutation).toHaveBeenCalledWith(
395
+ component.webhooks.mutations.markWebhookEventFailed,
396
+ expect.objectContaining({
397
+ stripeEventId: event.id,
398
+ error: "DB write failed",
399
+ }),
400
+ );
401
+ });
402
+
403
+ it("reprocesses a previously failed event on Stripe retry", async () => {
404
+ const event = makeV1Event("product.created", {
405
+ id: "prod_retry",
406
+ name: "Retry Product",
407
+ active: true,
408
+ metadata: {},
409
+ });
410
+ mockConstructEventAsync.mockResolvedValue(event);
411
+
412
+ // --- First delivery: processor mutation rejects ---
413
+ (ctx.runMutation as Mock)
414
+ .mockResolvedValueOnce("inserted") // insertWebhookEvent
415
+ .mockRejectedValueOnce(new Error("trigger exploded")) // upsertProduct
416
+ .mockResolvedValueOnce(undefined); // markWebhookEventFailed
417
+
418
+ const first = await handler(
419
+ ctx,
420
+ makeRequest({ type: "product.created" }),
421
+ );
422
+ expect(first.status).toBe(500);
423
+ expect(ctx.runMutation).toHaveBeenCalledWith(
424
+ component.webhooks.mutations.markWebhookEventFailed,
425
+ expect.objectContaining({
426
+ stripeEventId: event.id,
427
+ error: "trigger exploded",
428
+ }),
429
+ );
430
+
431
+ // --- Second delivery of the SAME event id: insertWebhookEvent resets
432
+ // the failed ledger row and returns "inserted" again, so the handler
433
+ // must fully reprocess instead of deduplicating.
434
+ (ctx.runMutation as Mock).mockClear();
435
+ (ctx.runMutation as Mock).mockResolvedValue("inserted");
436
+
437
+ const second = await handler(
438
+ ctx,
439
+ makeRequest({ type: "product.created" }),
440
+ );
441
+ expect(second.status).toBe(200);
442
+ expect(JSON.parse(await second.text()).deduplicated).toBeUndefined();
443
+ expect(ctx.runMutation).toHaveBeenCalledWith(
444
+ component.products.mutations.upsertProduct,
445
+ expect.objectContaining({ stripeProductId: "prod_retry" }),
446
+ );
447
+ expect(ctx.runMutation).toHaveBeenCalledWith(
448
+ component.webhooks.mutations.markWebhookEventProcessed,
449
+ { stripeEventId: event.id },
450
+ );
451
+ });
452
+
453
+ it("runHooks error does not crash handler", async () => {
454
+ const event = makeV1Event("product.created", {
455
+ id: "prod_123",
456
+ name: "Test",
457
+ active: true,
458
+ metadata: {},
459
+ });
460
+ mockConstructEventAsync.mockResolvedValue(event);
461
+
462
+ // Re-register with hooks that throw
463
+ let rawHandler: any;
464
+ const fakeRouter = {
465
+ route: (opts: any) => {
466
+ rawHandler = opts.handler;
467
+ },
468
+ };
469
+ registerRoutes(fakeRouter as any, component, {
470
+ ...makeBaseConfig(),
471
+ onEvent: async () => {
472
+ throw new Error("Hook exploded");
473
+ },
474
+ });
475
+
476
+ const response = await rawHandler(
477
+ ctx,
478
+ makeRequest({ type: "product.created" }),
479
+ );
480
+ // Handler should still return 200 despite hook error
481
+ expect(response.status).toBe(200);
482
+ });
483
+ });
484
+
485
+ // =========================================================================
486
+ // V2 Events
487
+ // =========================================================================
488
+
489
+ describe("V2 Events", () => {
490
+ const v2Body = (event: V2ThinEvent) => JSON.stringify(event);
491
+
492
+ function makeV2Request(event: V2ThinEvent): Request {
493
+ return new Request("https://example.com/stripe/webhook", {
494
+ method: "POST",
495
+ body: v2Body(event),
496
+ headers: {
497
+ "stripe-signature": "test_sig_v2",
498
+ "content-type": "application/json",
499
+ },
500
+ });
501
+ }
502
+
503
+ function setupV2Mocks(accountOverrides?: Record<string, any>) {
504
+ const defaultAccount = {
505
+ id: "acct_test_123",
506
+ contact_email: "test@example.com",
507
+ identity: {
508
+ business_details: { registered_name: "Test Business" },
509
+ country: "US",
510
+ },
511
+ metadata: { userId: "user_123" },
512
+ requirements: {},
513
+ configuration: {
514
+ customer: { applied: true },
515
+ },
516
+ ...accountOverrides,
517
+ };
518
+ mockAccountRetrieve.mockResolvedValue(defaultAccount);
519
+ return defaultAccount;
520
+ }
521
+
522
+ it("verifies signature via parseEventNotificationAsync, not constructEventAsync", async () => {
523
+ // stripe-node v22+ throws if a thin payload is passed to
524
+ // webhooks.constructEventAsync ("Use stripe.parseEventNotificationAsync
525
+ // instead"), so the V2 path MUST use the thin-event API.
526
+ const thinEvent = makeV2ThinEvent();
527
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
528
+ setupV2Mocks();
529
+
530
+ const request = makeV2Request(thinEvent);
531
+ await handler(ctx, request);
532
+
533
+ expect(mockParseEventNotificationAsync).toHaveBeenCalledWith(
534
+ v2Body(thinEvent),
535
+ "test_sig_v2",
536
+ "whsec_test_123",
537
+ );
538
+ expect(mockConstructEventAsync).not.toHaveBeenCalled();
539
+ });
540
+
541
+ it("uses webhookSecretV2 for thin-event verification when configured", async () => {
542
+ const thinEvent = makeV2ThinEvent();
543
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
544
+ setupV2Mocks();
545
+
546
+ let rawHandler: any;
547
+ const fakeRouter = {
548
+ route: (opts: any) => {
549
+ rawHandler = opts.handler;
550
+ },
551
+ };
552
+ registerRoutes(fakeRouter as any, component, {
553
+ ...makeBaseConfig(),
554
+ webhookSecretV2: "whsec_v2_456",
555
+ });
556
+
557
+ await rawHandler(ctx, makeV2Request(thinEvent));
558
+
559
+ expect(mockParseEventNotificationAsync).toHaveBeenCalledWith(
560
+ v2Body(thinEvent),
561
+ "test_sig_v2",
562
+ "whsec_v2_456",
563
+ );
564
+ });
565
+
566
+ it("returns 400 when thin-event verification fails", async () => {
567
+ const thinEvent = makeV2ThinEvent();
568
+ mockParseEventNotificationAsync.mockRejectedValue(
569
+ new Error("No signatures found matching the expected signature"),
570
+ );
571
+
572
+ const request = makeV2Request(thinEvent);
573
+ const response = await handler(ctx, request);
574
+
575
+ expect(response.status).toBe(400);
576
+ const body = await parseJson(response);
577
+ expect(body.error).toMatch(/signature/i);
578
+ });
579
+
580
+ it("uses parsed body as verified event data", async () => {
581
+ const thinEvent = makeV2ThinEvent({ id: "evt_v2_parsed" });
582
+ mockParseEventNotificationAsync.mockResolvedValue({});
583
+ setupV2Mocks();
584
+
585
+ const request = makeV2Request(thinEvent);
586
+ await handler(ctx, request);
587
+
588
+ // The ledger should use the event ID from the parsed body
589
+ expect(ctx.runMutation).toHaveBeenCalledWith(
590
+ component.webhooks.mutations.insertWebhookEvent,
591
+ expect.objectContaining({
592
+ stripeEventId: "evt_v2_parsed",
593
+ }),
594
+ );
595
+ });
596
+
597
+ it("duplicate event returns 200", async () => {
598
+ const thinEvent = makeV2ThinEvent();
599
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
600
+ (ctx.runMutation as Mock).mockResolvedValueOnce("already_processed");
601
+
602
+ const request = makeV2Request(thinEvent);
603
+ const response = await handler(ctx, request);
604
+ expect(response.status).toBe(200);
605
+ const body = await parseJson(response);
606
+ expect(body.deduplicated).toBe(true);
607
+ });
608
+
609
+ it("calls upsertAccount mutation", async () => {
610
+ const thinEvent = makeV2ThinEvent();
611
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
612
+ setupV2Mocks();
613
+
614
+ const request = makeV2Request(thinEvent);
615
+ const response = await handler(ctx, request);
616
+ expect(response.status).toBe(200);
617
+
618
+ expect(ctx.runMutation).toHaveBeenCalledWith(
619
+ component.core.mutations.upsertAccountInternal,
620
+ expect.objectContaining({
621
+ stripeAccountId: "acct_test_123",
622
+ userId: "user_123",
623
+ email: "test@example.com",
624
+ name: "Test Business",
625
+ }),
626
+ );
627
+ });
628
+
629
+ it("calls onEvent hook", async () => {
630
+ const thinEvent = makeV2ThinEvent();
631
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
632
+ setupV2Mocks();
633
+
634
+ const onEvent = vi.fn().mockResolvedValue(undefined);
635
+
636
+ let rawHandler: any;
637
+ const fakeRouter = {
638
+ route: (opts: any) => {
639
+ rawHandler = opts.handler;
640
+ },
641
+ };
642
+ registerRoutes(fakeRouter as any, component, {
643
+ ...makeBaseConfig(),
644
+ onEvent,
645
+ });
646
+
647
+ const response = await rawHandler(ctx, makeV2Request(thinEvent));
648
+ expect(response.status).toBe(200);
649
+ expect(onEvent).toHaveBeenCalledWith(ctx, thinEvent);
650
+ });
651
+
652
+ it("calls typed event handler", async () => {
653
+ const thinEvent = makeV2ThinEvent({ type: "v2.core.account.updated" });
654
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
655
+ setupV2Mocks();
656
+
657
+ const typedHandler = vi.fn().mockResolvedValue(undefined);
658
+
659
+ let rawHandler: any;
660
+ const fakeRouter = {
661
+ route: (opts: any) => {
662
+ rawHandler = opts.handler;
663
+ },
664
+ };
665
+ registerRoutes(fakeRouter as any, component, {
666
+ ...makeBaseConfig(),
667
+ events: { "v2.core.account.updated": typedHandler },
668
+ });
669
+
670
+ const response = await rawHandler(ctx, makeV2Request(thinEvent));
671
+ expect(response.status).toBe(200);
672
+ expect(typedHandler).toHaveBeenCalledWith(ctx, thinEvent);
673
+ });
674
+
675
+ it("marks ledger failed on sync error", async () => {
676
+ const thinEvent = makeV2ThinEvent();
677
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
678
+ mockAccountRetrieve.mockRejectedValue(new Error("Stripe API down"));
679
+
680
+ (ctx.runMutation as Mock)
681
+ .mockResolvedValueOnce("inserted") // insertWebhookEvent
682
+ .mockResolvedValueOnce(undefined); // markWebhookEventFailed
683
+
684
+ const request = makeV2Request(thinEvent);
685
+ const response = await handler(ctx, request);
686
+ expect(response.status).toBe(500);
687
+
688
+ expect(ctx.runMutation).toHaveBeenCalledWith(
689
+ component.webhooks.mutations.markWebhookEventFailed,
690
+ expect.objectContaining({
691
+ stripeEventId: thinEvent.id,
692
+ error: "Stripe API down",
693
+ }),
694
+ );
695
+ });
696
+
697
+ it("marks ledger processed on success", async () => {
698
+ const thinEvent = makeV2ThinEvent();
699
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
700
+ setupV2Mocks();
701
+
702
+ const request = makeV2Request(thinEvent);
703
+ const response = await handler(ctx, request);
704
+ expect(response.status).toBe(200);
705
+
706
+ expect(ctx.runMutation).toHaveBeenCalledWith(
707
+ component.webhooks.mutations.markWebhookEventProcessed,
708
+ { stripeEventId: thinEvent.id },
709
+ );
710
+ });
711
+
712
+ it("derives pending onboarding status", async () => {
713
+ const thinEvent = makeV2ThinEvent();
714
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
715
+ setupV2Mocks({
716
+ requirements: {},
717
+ configuration: {},
718
+ });
719
+
720
+ const request = makeV2Request(thinEvent);
721
+ await handler(ctx, request);
722
+
723
+ expect(ctx.runMutation).toHaveBeenCalledWith(
724
+ component.core.mutations.upsertAccountInternal,
725
+ expect.objectContaining({
726
+ onboardingStatus: "pending",
727
+ }),
728
+ );
729
+ });
730
+
731
+ it("derives in_progress when requirements due", async () => {
732
+ const thinEvent = makeV2ThinEvent();
733
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
734
+ setupV2Mocks({
735
+ requirements: {
736
+ entries: [
737
+ {
738
+ description: "business_url",
739
+ awaiting_action_from: "user",
740
+ errors: [],
741
+ impact: { restricts_capabilities: [] },
742
+ minimum_deadline: { status: "currently_due" },
743
+ requested_reasons: [],
744
+ },
745
+ {
746
+ description: "tos_acceptance",
747
+ awaiting_action_from: "user",
748
+ errors: [],
749
+ impact: { restricts_capabilities: [] },
750
+ minimum_deadline: { status: "currently_due" },
751
+ requested_reasons: [],
752
+ },
753
+ ],
754
+ },
755
+ configuration: {},
756
+ });
757
+
758
+ const request = makeV2Request(thinEvent);
759
+ await handler(ctx, request);
760
+
761
+ expect(ctx.runMutation).toHaveBeenCalledWith(
762
+ component.core.mutations.upsertAccountInternal,
763
+ expect.objectContaining({
764
+ onboardingStatus: "in_progress",
765
+ }),
766
+ );
767
+ });
768
+
769
+ it("derives restricted when deadline is past_due", async () => {
770
+ const thinEvent = makeV2ThinEvent();
771
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
772
+ setupV2Mocks({
773
+ requirements: {
774
+ entries: [
775
+ {
776
+ description: "tos_acceptance",
777
+ awaiting_action_from: "user",
778
+ errors: [],
779
+ impact: { restricts_capabilities: [] },
780
+ minimum_deadline: { status: "currently_due" },
781
+ requested_reasons: [],
782
+ },
783
+ ],
784
+ summary: {
785
+ minimum_deadline: { status: "past_due" },
786
+ },
787
+ },
788
+ configuration: {},
789
+ });
790
+
791
+ const request = makeV2Request(thinEvent);
792
+ await handler(ctx, request);
793
+
794
+ expect(ctx.runMutation).toHaveBeenCalledWith(
795
+ component.core.mutations.upsertAccountInternal,
796
+ expect.objectContaining({
797
+ onboardingStatus: "restricted",
798
+ }),
799
+ );
800
+ });
801
+
802
+ it("derives complete when configurations applied", async () => {
803
+ const thinEvent = makeV2ThinEvent();
804
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
805
+ setupV2Mocks({
806
+ requirements: {},
807
+ configuration: {
808
+ customer: { applied: true },
809
+ merchant: { applied: true },
810
+ },
811
+ });
812
+
813
+ const request = makeV2Request(thinEvent);
814
+ await handler(ctx, request);
815
+
816
+ expect(ctx.runMutation).toHaveBeenCalledWith(
817
+ component.core.mutations.upsertAccountInternal,
818
+ expect.objectContaining({
819
+ onboardingStatus: "complete",
820
+ }),
821
+ );
822
+ });
823
+
824
+ it("persists missingRequirements array", async () => {
825
+ const thinEvent = makeV2ThinEvent();
826
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
827
+ setupV2Mocks({
828
+ requirements: {
829
+ entries: [
830
+ {
831
+ description: "business_url",
832
+ awaiting_action_from: "user",
833
+ errors: [],
834
+ impact: { restricts_capabilities: [] },
835
+ minimum_deadline: { status: "currently_due" },
836
+ requested_reasons: [],
837
+ },
838
+ {
839
+ description: "tos_acceptance",
840
+ awaiting_action_from: "user",
841
+ errors: [],
842
+ impact: { restricts_capabilities: [] },
843
+ minimum_deadline: { status: "past_due" },
844
+ requested_reasons: [],
845
+ },
846
+ {
847
+ description: "identity_document",
848
+ awaiting_action_from: "stripe",
849
+ errors: [],
850
+ impact: { restricts_capabilities: [] },
851
+ minimum_deadline: { status: "currently_due" },
852
+ requested_reasons: [],
853
+ },
854
+ ],
855
+ },
856
+ configuration: {},
857
+ });
858
+
859
+ const request = makeV2Request(thinEvent);
860
+ await handler(ctx, request);
861
+
862
+ expect(ctx.runMutation).toHaveBeenCalledWith(
863
+ component.core.mutations.upsertAccountInternal,
864
+ expect.objectContaining({
865
+ missingRequirements: expect.arrayContaining([
866
+ "business_url",
867
+ "tos_acceptance",
868
+ "identity_document",
869
+ ]),
870
+ }),
871
+ );
872
+ });
873
+ });
874
+
875
+ // =========================================================================
876
+ // Domain routing
877
+ // =========================================================================
878
+
879
+ describe("Domain routing", () => {
880
+ it("product events: upserts product via mutation", async () => {
881
+ const event = makeV1Event("product.updated", {
882
+ id: "prod_456",
883
+ name: "Updated Product",
884
+ description: "A description",
885
+ active: false,
886
+ metadata: { tier: "premium" },
887
+ });
888
+ mockConstructEventAsync.mockResolvedValue(event);
889
+
890
+ const request = makeRequest({ type: "product.updated" });
891
+ const response = await handler(ctx, request);
892
+ expect(response.status).toBe(200);
893
+
894
+ expect(ctx.runMutation).toHaveBeenCalledWith(
895
+ component.products.mutations.upsertProduct,
896
+ expect.objectContaining({
897
+ stripeProductId: "prod_456",
898
+ name: "Updated Product",
899
+ description: "A description",
900
+ active: false,
901
+ metadata: { tier: "premium" },
902
+ }),
903
+ );
904
+ });
905
+
906
+ it("subscription events: upserts with trial fields", async () => {
907
+ const trialStart = Math.floor(Date.now() / 1000);
908
+ const trialEnd = trialStart + 14 * 86400;
909
+ const event = makeV1Event("customer.subscription.created", {
910
+ id: "sub_123",
911
+ status: "trialing",
912
+ customer: "cus_abc",
913
+ cancel_at_period_end: false,
914
+ canceled_at: null,
915
+ trial_start: trialStart,
916
+ trial_end: trialEnd,
917
+ metadata: { userId: "user_42" },
918
+ items: {
919
+ data: [
920
+ {
921
+ price: { id: "price_123" },
922
+ quantity: 1,
923
+ current_period_start: trialStart,
924
+ current_period_end: trialEnd,
925
+ },
926
+ ],
927
+ },
928
+ });
929
+ mockConstructEventAsync.mockResolvedValue(event);
930
+
931
+ const request = makeRequest({ type: "customer.subscription.created" });
932
+ const response = await handler(ctx, request);
933
+ expect(response.status).toBe(200);
934
+
935
+ expect(ctx.runMutation).toHaveBeenCalledWith(
936
+ component.billing.mutations.upsertSubscription,
937
+ expect.objectContaining({
938
+ stripeSubscriptionId: "sub_123",
939
+ isTrialing: true,
940
+ trialStart: new Date(trialStart * 1000).toISOString(),
941
+ trialEnd: new Date(trialEnd * 1000).toISOString(),
942
+ userId: "user_42",
943
+ }),
944
+ );
945
+ });
946
+
947
+ it("checkout events: merges metadata", async () => {
948
+ const event = makeV1Event("checkout.session.completed", {
949
+ id: "cs_123",
950
+ mode: "subscription",
951
+ status: "complete",
952
+ customer: "cus_abc",
953
+ url: null,
954
+ metadata: { userId: "user_42", plan: "pro" },
955
+ });
956
+ mockConstructEventAsync.mockResolvedValue(event);
957
+
958
+ // Simulate existing session with old metadata
959
+ (ctx.runQuery as Mock).mockImplementation(
960
+ async (ref: any, _args: any) => {
961
+ if (
962
+ ref?.[TO_REFERENCE_PATH] ===
963
+ component.billing.queries.getCheckoutSessionByStripeId[
964
+ TO_REFERENCE_PATH
965
+ ]
966
+ ) {
967
+ return { metadata: { previousKey: "old_value" } };
968
+ }
969
+ return null;
970
+ },
971
+ );
972
+
973
+ const request = makeRequest({ type: "checkout.session.completed" });
974
+ const response = await handler(ctx, request);
975
+ expect(response.status).toBe(200);
976
+
977
+ expect(ctx.runMutation).toHaveBeenCalledWith(
978
+ component.billing.mutations.upsertCheckoutSession,
979
+ expect.objectContaining({
980
+ stripeSessionId: "cs_123",
981
+ metadata: expect.objectContaining({
982
+ previousKey: "old_value",
983
+ userId: "user_42",
984
+ plan: "pro",
985
+ }),
986
+ }),
987
+ );
988
+ });
989
+
990
+ it("trial_will_end events: upserts subscription with trial fields", async () => {
991
+ const trialStart = Math.floor(Date.now() / 1000) - 11 * 86400;
992
+ const trialEnd = trialStart + 14 * 86400;
993
+ const event = makeV1Event("customer.subscription.trial_will_end", {
994
+ id: "sub_trial_456",
995
+ status: "trialing",
996
+ customer: "cus_abc",
997
+ cancel_at_period_end: false,
998
+ canceled_at: null,
999
+ trial_start: trialStart,
1000
+ trial_end: trialEnd,
1001
+ metadata: { userId: "user_42" },
1002
+ items: {
1003
+ data: [
1004
+ {
1005
+ price: { id: "price_123" },
1006
+ quantity: 1,
1007
+ current_period_start: trialStart,
1008
+ current_period_end: trialEnd,
1009
+ },
1010
+ ],
1011
+ },
1012
+ });
1013
+ mockConstructEventAsync.mockResolvedValue(event);
1014
+
1015
+ const request = makeRequest({
1016
+ type: "customer.subscription.trial_will_end",
1017
+ });
1018
+ const response = await handler(ctx, request);
1019
+ expect(response.status).toBe(200);
1020
+
1021
+ expect(ctx.runMutation).toHaveBeenCalledWith(
1022
+ component.billing.mutations.upsertSubscription,
1023
+ expect.objectContaining({
1024
+ stripeSubscriptionId: "sub_trial_456",
1025
+ isTrialing: true,
1026
+ trialStart: new Date(trialStart * 1000).toISOString(),
1027
+ trialEnd: new Date(trialEnd * 1000).toISOString(),
1028
+ userId: "user_42",
1029
+ }),
1030
+ );
1031
+ });
1032
+
1033
+ it("refund events: upserts refund with payment intent + charge link", async () => {
1034
+ const event = makeV1Event("refund.created", {
1035
+ id: "re_123",
1036
+ payment_intent: "pi_abc",
1037
+ charge: "ch_xyz",
1038
+ amount: 500,
1039
+ currency: "usd",
1040
+ status: "succeeded",
1041
+ reason: "requested_by_customer",
1042
+ metadata: { note: "partial" },
1043
+ });
1044
+ mockConstructEventAsync.mockResolvedValue(event);
1045
+
1046
+ const request = makeRequest({ type: "refund.created" });
1047
+ const response = await handler(ctx, request);
1048
+ expect(response.status).toBe(200);
1049
+
1050
+ expect(ctx.runMutation).toHaveBeenCalledWith(
1051
+ component.connect.mutations.upsertRefund,
1052
+ expect.objectContaining({
1053
+ stripeRefundId: "re_123",
1054
+ stripePaymentIntentId: "pi_abc",
1055
+ stripeChargeId: "ch_xyz",
1056
+ amount: 500,
1057
+ currency: "usd",
1058
+ status: "succeeded",
1059
+ reason: "requested_by_customer",
1060
+ }),
1061
+ );
1062
+ });
1063
+
1064
+ it("refund events: clamps an unknown status to pending and drops unknown reason", async () => {
1065
+ const event = makeV1Event("refund.updated", {
1066
+ id: "re_456",
1067
+ payment_intent: "pi_abc",
1068
+ charge: "ch_xyz",
1069
+ amount: 500,
1070
+ currency: "usd",
1071
+ status: "weird_status",
1072
+ reason: "not_a_real_reason",
1073
+ });
1074
+ mockConstructEventAsync.mockResolvedValue(event);
1075
+
1076
+ const request = makeRequest({ type: "refund.updated" });
1077
+ await handler(ctx, request);
1078
+
1079
+ const call = (ctx.runMutation as Mock).mock.calls.find(
1080
+ ([ref]) =>
1081
+ ref?.[TO_REFERENCE_PATH] ===
1082
+ component.connect.mutations.upsertRefund[TO_REFERENCE_PATH],
1083
+ );
1084
+ expect(call?.[1]).toMatchObject({ status: "pending" });
1085
+ expect(call?.[1].reason).toBeUndefined();
1086
+ });
1087
+
1088
+ it("dispute events: upserts dispute and records the originating event suffix", async () => {
1089
+ const event = makeV1Event("charge.dispute.funds_withdrawn", {
1090
+ id: "dp_123",
1091
+ payment_intent: "pi_abc",
1092
+ charge: "ch_xyz",
1093
+ amount: 2000,
1094
+ currency: "usd",
1095
+ status: "needs_response",
1096
+ reason: "fraudulent",
1097
+ is_charge_refundable: true,
1098
+ metadata: {},
1099
+ });
1100
+ mockConstructEventAsync.mockResolvedValue(event);
1101
+
1102
+ const request = makeRequest({ type: "charge.dispute.funds_withdrawn" });
1103
+ const response = await handler(ctx, request);
1104
+ expect(response.status).toBe(200);
1105
+
1106
+ expect(ctx.runMutation).toHaveBeenCalledWith(
1107
+ component.connect.mutations.upsertDispute,
1108
+ expect.objectContaining({
1109
+ stripeDisputeId: "dp_123",
1110
+ stripePaymentIntentId: "pi_abc",
1111
+ stripeChargeId: "ch_xyz",
1112
+ amount: 2000,
1113
+ status: "needs_response",
1114
+ reason: "fraudulent",
1115
+ isChargeRefundable: true,
1116
+ lastEvent: "funds_withdrawn",
1117
+ }),
1118
+ );
1119
+ });
1120
+
1121
+ it("unhandled event type: logs and returns 200", async () => {
1122
+ const event = makeV1Event("some.unknown.event", { id: "obj_999" });
1123
+ mockConstructEventAsync.mockResolvedValue(event);
1124
+
1125
+ const consoleSpy = vi.spyOn(console, "info").mockImplementation(() => {});
1126
+
1127
+ const request = makeRequest({ type: "some.unknown.event" });
1128
+ const response = await handler(ctx, request);
1129
+ expect(response.status).toBe(200);
1130
+
1131
+ expect(consoleSpy).toHaveBeenCalledWith(
1132
+ expect.stringContaining("Unhandled event type: some.unknown.event"),
1133
+ );
1134
+ consoleSpy.mockRestore();
1135
+ });
1136
+ });
1137
+
1138
+ // =========================================================================
1139
+ // Trigger dispatchers
1140
+ // =========================================================================
1141
+
1142
+ describe("Trigger dispatchers", () => {
1143
+ /** App-side refs (e.g. internal.stripe.*) are NOT component refs. */
1144
+ function makeAppRef(path: string) {
1145
+ return { [TO_REFERENCE_PATH]: path };
1146
+ }
1147
+
1148
+ // The two webhook handler refs the app exports from `webhookHandlers()`.
1149
+ const syncWebhook = makeAppRef("app/stripe/syncWebhook");
1150
+ const asyncWebhook = makeAppRef("app/stripe/asyncWebhook");
1151
+ const webhookRefs = { syncWebhook, asyncWebhook };
1152
+
1153
+ function setupHandlerWithWebhooks(
1154
+ webhooks: Record<string, unknown>,
1155
+ ): (ctx: WebhookActionCtx, request: Request) => Promise<Response> {
1156
+ let rawHandler: any;
1157
+ const fakeRouter = {
1158
+ route: (opts: any) => {
1159
+ rawHandler = opts.handler;
1160
+ },
1161
+ };
1162
+ registerRoutes(fakeRouter as any, component, {
1163
+ ...makeBaseConfig(),
1164
+ webhooks: webhooks as any,
1165
+ });
1166
+ return rawHandler;
1167
+ }
1168
+
1169
+ function makeSubscriptionEvent(type: string): any {
1170
+ return makeV1Event(type, {
1171
+ id: "sub_777",
1172
+ status: "active",
1173
+ customer: "cus_abc",
1174
+ cancel_at_period_end: false,
1175
+ canceled_at: null,
1176
+ trial_start: null,
1177
+ trial_end: null,
1178
+ metadata: { userId: "user_42" },
1179
+ items: {
1180
+ data: [
1181
+ {
1182
+ price: { id: "price_123" },
1183
+ quantity: 1,
1184
+ current_period_start: 1700000000,
1185
+ current_period_end: 1702592000,
1186
+ },
1187
+ ],
1188
+ },
1189
+ });
1190
+ }
1191
+
1192
+ it("routes subscription upsert through syncWebhook (dispatcher: subscriptionUpserted)", async () => {
1193
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1194
+
1195
+ const event = makeSubscriptionEvent("customer.subscription.updated");
1196
+ mockConstructEventAsync.mockResolvedValue(event);
1197
+
1198
+ const response = await triggerHandler(
1199
+ ctx,
1200
+ makeRequest({ type: "customer.subscription.updated" }),
1201
+ );
1202
+ expect(response.status).toBe(200);
1203
+
1204
+ expect(ctx.runMutation).toHaveBeenCalledWith(syncWebhook, {
1205
+ dispatcher: "subscriptionUpserted",
1206
+ data: expect.objectContaining({
1207
+ stripeSubscriptionId: "sub_777",
1208
+ status: "active",
1209
+ userId: "user_42",
1210
+ priceId: "price_123",
1211
+ }),
1212
+ });
1213
+ expect(ctx.runMutation).not.toHaveBeenCalledWith(
1214
+ component.billing.mutations.upsertSubscription,
1215
+ expect.anything(),
1216
+ );
1217
+ });
1218
+
1219
+ it("falls back to direct component mutation without webhooks", async () => {
1220
+ const event = makeSubscriptionEvent("customer.subscription.updated");
1221
+ mockConstructEventAsync.mockResolvedValue(event);
1222
+
1223
+ const response = await handler(
1224
+ ctx,
1225
+ makeRequest({ type: "customer.subscription.updated" }),
1226
+ );
1227
+ expect(response.status).toBe(200);
1228
+
1229
+ expect(ctx.runMutation).toHaveBeenCalledWith(
1230
+ component.billing.mutations.upsertSubscription,
1231
+ expect.objectContaining({
1232
+ stripeSubscriptionId: "sub_777",
1233
+ status: "active",
1234
+ }),
1235
+ );
1236
+ });
1237
+
1238
+ it("routes subscription deletion through syncWebhook (dispatcher: subscriptionDeleted)", async () => {
1239
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1240
+
1241
+ const event = makeSubscriptionEvent("customer.subscription.deleted");
1242
+ mockConstructEventAsync.mockResolvedValue(event);
1243
+
1244
+ const response = await triggerHandler(
1245
+ ctx,
1246
+ makeRequest({ type: "customer.subscription.deleted" }),
1247
+ );
1248
+ expect(response.status).toBe(200);
1249
+
1250
+ expect(ctx.runMutation).toHaveBeenCalledWith(syncWebhook, {
1251
+ dispatcher: "subscriptionDeleted",
1252
+ data: expect.objectContaining({ stripeSubscriptionId: "sub_777" }),
1253
+ });
1254
+ expect(ctx.runMutation).not.toHaveBeenCalledWith(syncWebhook, {
1255
+ dispatcher: "subscriptionUpserted",
1256
+ data: expect.anything(),
1257
+ });
1258
+ expect(ctx.runMutation).not.toHaveBeenCalledWith(
1259
+ component.billing.mutations.upsertSubscription,
1260
+ expect.anything(),
1261
+ );
1262
+ });
1263
+
1264
+ it("routes V2 account upsert through syncWebhook (dispatcher: accountUpserted)", async () => {
1265
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1266
+
1267
+ const thinEvent = makeV2ThinEvent();
1268
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
1269
+ mockAccountRetrieve.mockResolvedValue({
1270
+ id: "acct_test_123",
1271
+ contact_email: "test@example.com",
1272
+ identity: {
1273
+ business_details: { registered_name: "Test Business" },
1274
+ country: "US",
1275
+ },
1276
+ metadata: { userId: "user_123" },
1277
+ requirements: {},
1278
+ configuration: { customer: { applied: true } },
1279
+ });
1280
+
1281
+ const response = await triggerHandler(ctx, makeRequest(thinEvent));
1282
+ expect(response.status).toBe(200);
1283
+
1284
+ expect(ctx.runMutation).toHaveBeenCalledWith(syncWebhook, {
1285
+ dispatcher: "accountUpserted",
1286
+ data: expect.objectContaining({
1287
+ stripeAccountId: "acct_test_123",
1288
+ userId: "user_123",
1289
+ email: "test@example.com",
1290
+ }),
1291
+ });
1292
+ expect(ctx.runMutation).not.toHaveBeenCalledWith(
1293
+ component.core.mutations.upsertAccountInternal,
1294
+ expect.anything(),
1295
+ );
1296
+ });
1297
+
1298
+ it("routes checkout upsert through syncWebhook (dispatcher: checkoutSessionUpserted)", async () => {
1299
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1300
+
1301
+ const event = makeV1Event("checkout.session.completed", {
1302
+ id: "cs_999",
1303
+ mode: "subscription",
1304
+ status: "complete",
1305
+ customer: "cus_abc",
1306
+ url: null,
1307
+ metadata: { userId: "user_42" },
1308
+ });
1309
+ mockConstructEventAsync.mockResolvedValue(event);
1310
+
1311
+ const response = await triggerHandler(
1312
+ ctx,
1313
+ makeRequest({ type: "checkout.session.completed" }),
1314
+ );
1315
+ expect(response.status).toBe(200);
1316
+
1317
+ expect(ctx.runMutation).toHaveBeenCalledWith(syncWebhook, {
1318
+ dispatcher: "checkoutSessionUpserted",
1319
+ data: expect.objectContaining({
1320
+ stripeSessionId: "cs_999",
1321
+ userId: "user_42",
1322
+ }),
1323
+ });
1324
+ expect(ctx.runMutation).not.toHaveBeenCalledWith(
1325
+ component.billing.mutations.upsertCheckoutSession,
1326
+ expect.anything(),
1327
+ );
1328
+ });
1329
+
1330
+ it("syncWebhook rejection returns 500 and marks the ledger row failed", async () => {
1331
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1332
+
1333
+ const event = makeSubscriptionEvent("customer.subscription.updated");
1334
+ mockConstructEventAsync.mockResolvedValue(event);
1335
+
1336
+ (ctx.runMutation as Mock)
1337
+ .mockResolvedValueOnce("inserted") // insertWebhookEvent
1338
+ .mockRejectedValueOnce(new Error("sync trigger threw")) // syncWebhook
1339
+ .mockResolvedValueOnce(undefined); // markWebhookEventFailed
1340
+
1341
+ const response = await triggerHandler(
1342
+ ctx,
1343
+ makeRequest({ type: "customer.subscription.updated" }),
1344
+ );
1345
+ expect(response.status).toBe(500);
1346
+
1347
+ expect(ctx.runMutation).toHaveBeenCalledWith(syncWebhook, {
1348
+ dispatcher: "subscriptionUpserted",
1349
+ data: expect.objectContaining({ stripeSubscriptionId: "sub_777" }),
1350
+ });
1351
+ expect(ctx.runMutation).toHaveBeenCalledWith(
1352
+ component.webhooks.mutations.markWebhookEventFailed,
1353
+ expect.objectContaining({
1354
+ stripeEventId: event.id,
1355
+ error: "sync trigger threw",
1356
+ }),
1357
+ );
1358
+ });
1359
+ });
1360
+
1361
+ // =========================================================================
1362
+ // Async hook scheduling
1363
+ // =========================================================================
1364
+
1365
+ describe("Async hook scheduling", () => {
1366
+ /** App-side refs (e.g. internal.stripe.*) are NOT component refs. */
1367
+ function makeAppRef(path: string) {
1368
+ return { [TO_REFERENCE_PATH]: path };
1369
+ }
1370
+
1371
+ // The two webhook handler refs the app exports from `webhookHandlers()`.
1372
+ const syncWebhook = makeAppRef("app/stripe/syncWebhook");
1373
+ const asyncWebhook = makeAppRef("app/stripe/asyncWebhook");
1374
+ const webhookRefs = { syncWebhook, asyncWebhook };
1375
+
1376
+ function setupHandlerWithWebhooks(
1377
+ webhooks: Record<string, unknown> | undefined,
1378
+ ): (ctx: WebhookActionCtx, request: Request) => Promise<Response> {
1379
+ let rawHandler: any;
1380
+ const fakeRouter = {
1381
+ route: (opts: any) => {
1382
+ rawHandler = opts.handler;
1383
+ },
1384
+ };
1385
+ registerRoutes(fakeRouter as any, component, {
1386
+ ...makeBaseConfig(),
1387
+ webhooks: webhooks as any,
1388
+ });
1389
+ return rawHandler;
1390
+ }
1391
+
1392
+ function makeCheckoutEvent(): any {
1393
+ return makeV1Event("checkout.session.completed", {
1394
+ id: "cs_hook_123",
1395
+ mode: "subscription",
1396
+ status: "complete",
1397
+ customer: "cus_abc",
1398
+ url: null,
1399
+ metadata: { userId: "user_42" },
1400
+ });
1401
+ }
1402
+
1403
+ function makeSubscriptionEvent(type: string): any {
1404
+ return makeV1Event(type, {
1405
+ id: "sub_hook_777",
1406
+ status: "canceled",
1407
+ customer: "cus_abc",
1408
+ cancel_at_period_end: false,
1409
+ canceled_at: 1700000000,
1410
+ trial_start: null,
1411
+ trial_end: null,
1412
+ metadata: { userId: "user_42" },
1413
+ items: {
1414
+ data: [
1415
+ {
1416
+ price: { id: "price_123" },
1417
+ quantity: 1,
1418
+ current_period_start: 1700000000,
1419
+ current_period_end: 1702592000,
1420
+ },
1421
+ ],
1422
+ },
1423
+ });
1424
+ }
1425
+
1426
+ it("checkout.session.completed schedules asyncWebhook (hook: afterCheckoutCompleted) with the committed doc", async () => {
1427
+ const runAfter = vi.fn().mockResolvedValue(undefined);
1428
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1429
+
1430
+ const sessionDoc = {
1431
+ _id: "doc_cs_1",
1432
+ stripeSessionId: "cs_hook_123",
1433
+ status: "complete",
1434
+ };
1435
+ (schedCtx.runQuery as Mock).mockResolvedValue(sessionDoc);
1436
+
1437
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1438
+ mockConstructEventAsync.mockResolvedValue(makeCheckoutEvent());
1439
+
1440
+ const response = await triggerHandler(
1441
+ schedCtx,
1442
+ makeRequest({ type: "checkout.session.completed" }),
1443
+ );
1444
+ expect(response.status).toBe(200);
1445
+
1446
+ expect(schedCtx.runQuery).toHaveBeenCalledWith(
1447
+ component.billing.queries.getCheckoutSessionByStripeId,
1448
+ { stripeSessionId: "cs_hook_123" },
1449
+ );
1450
+ expect(runAfter).toHaveBeenCalledWith(0, asyncWebhook, {
1451
+ hook: "afterCheckoutCompleted",
1452
+ doc: sessionDoc,
1453
+ });
1454
+ });
1455
+
1456
+ it("schedules the hook only after the ledger row is marked processed", async () => {
1457
+ const callOrder: string[] = [];
1458
+ const runAfter = vi.fn().mockImplementation(async () => {
1459
+ callOrder.push("runAfter");
1460
+ });
1461
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1462
+ (schedCtx.runQuery as Mock).mockResolvedValue({
1463
+ stripeSessionId: "cs_hook_123",
1464
+ });
1465
+ (schedCtx.runMutation as Mock).mockImplementation(async (ref: any) => {
1466
+ if (
1467
+ ref?.[TO_REFERENCE_PATH] ===
1468
+ component.webhooks.mutations.markWebhookEventProcessed[
1469
+ TO_REFERENCE_PATH
1470
+ ]
1471
+ ) {
1472
+ callOrder.push("markProcessed");
1473
+ }
1474
+ return "inserted";
1475
+ });
1476
+
1477
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1478
+ mockConstructEventAsync.mockResolvedValue(makeCheckoutEvent());
1479
+
1480
+ const response = await triggerHandler(
1481
+ schedCtx,
1482
+ makeRequest({ type: "checkout.session.completed" }),
1483
+ );
1484
+ expect(response.status).toBe(200);
1485
+ expect(callOrder).toEqual(["markProcessed", "runAfter"]);
1486
+ });
1487
+
1488
+ it("customer.subscription.deleted schedules afterSubscriptionCanceled, not afterSubscriptionUpdated", async () => {
1489
+ const runAfter = vi.fn().mockResolvedValue(undefined);
1490
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1491
+
1492
+ const subDoc = { _id: "doc_sub_1", stripeSubscriptionId: "sub_hook_777" };
1493
+ (schedCtx.runQuery as Mock).mockResolvedValue(subDoc);
1494
+
1495
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1496
+ mockConstructEventAsync.mockResolvedValue(
1497
+ makeSubscriptionEvent("customer.subscription.deleted"),
1498
+ );
1499
+
1500
+ const response = await triggerHandler(
1501
+ schedCtx,
1502
+ makeRequest({ type: "customer.subscription.deleted" }),
1503
+ );
1504
+ expect(response.status).toBe(200);
1505
+
1506
+ expect(schedCtx.runQuery).toHaveBeenCalledWith(
1507
+ component.billing.queries.getSubscriptionByStripeId,
1508
+ { stripeSubscriptionId: "sub_hook_777" },
1509
+ );
1510
+ expect(runAfter).toHaveBeenCalledWith(0, asyncWebhook, {
1511
+ hook: "afterSubscriptionCanceled",
1512
+ doc: subDoc,
1513
+ });
1514
+ expect(runAfter).not.toHaveBeenCalledWith(
1515
+ 0,
1516
+ asyncWebhook,
1517
+ expect.objectContaining({ hook: "afterSubscriptionUpdated" }),
1518
+ );
1519
+ });
1520
+
1521
+ it("customer.subscription.trial_will_end schedules afterTrialEnding with the subscription doc", async () => {
1522
+ const runAfter = vi.fn().mockResolvedValue(undefined);
1523
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1524
+
1525
+ const subDoc = {
1526
+ _id: "doc_sub_trial",
1527
+ stripeSubscriptionId: "sub_hook_777",
1528
+ isTrialing: true,
1529
+ };
1530
+ (schedCtx.runQuery as Mock).mockResolvedValue(subDoc);
1531
+
1532
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1533
+ mockConstructEventAsync.mockResolvedValue(
1534
+ makeSubscriptionEvent("customer.subscription.trial_will_end"),
1535
+ );
1536
+
1537
+ const response = await triggerHandler(
1538
+ schedCtx,
1539
+ makeRequest({ type: "customer.subscription.trial_will_end" }),
1540
+ );
1541
+ expect(response.status).toBe(200);
1542
+
1543
+ expect(schedCtx.runQuery).toHaveBeenCalledWith(
1544
+ component.billing.queries.getSubscriptionByStripeId,
1545
+ { stripeSubscriptionId: "sub_hook_777" },
1546
+ );
1547
+ expect(runAfter).toHaveBeenCalledWith(0, asyncWebhook, {
1548
+ hook: "afterTrialEnding",
1549
+ doc: subDoc,
1550
+ });
1551
+ });
1552
+
1553
+ it("no scheduler on ctx: warns, does not throw, still returns 200", async () => {
1554
+ const plainCtx = createMockCtx(); // no scheduler
1555
+ (plainCtx.runQuery as Mock).mockResolvedValue({
1556
+ stripeSessionId: "cs_hook_123",
1557
+ });
1558
+
1559
+ const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
1560
+
1561
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1562
+ mockConstructEventAsync.mockResolvedValue(makeCheckoutEvent());
1563
+
1564
+ const response = await triggerHandler(
1565
+ plainCtx,
1566
+ makeRequest({ type: "checkout.session.completed" }),
1567
+ );
1568
+ expect(response.status).toBe(200);
1569
+ expect(warnSpy).toHaveBeenCalledWith(
1570
+ expect.stringContaining(
1571
+ "Async hook afterCheckoutCompleted configured but ctx.scheduler unavailable",
1572
+ ),
1573
+ );
1574
+ warnSpy.mockRestore();
1575
+ });
1576
+
1577
+ it("no webhooks configured: does not schedule, returns 200", async () => {
1578
+ const runAfter = vi.fn().mockResolvedValue(undefined);
1579
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1580
+ (schedCtx.runQuery as Mock).mockResolvedValue({
1581
+ stripeSessionId: "cs_hook_123",
1582
+ });
1583
+
1584
+ // No webhooks pair -> async hooks are skipped entirely.
1585
+ const triggerHandler = setupHandlerWithWebhooks(undefined);
1586
+ mockConstructEventAsync.mockResolvedValue(makeCheckoutEvent());
1587
+
1588
+ const response = await triggerHandler(
1589
+ schedCtx,
1590
+ makeRequest({ type: "checkout.session.completed" }),
1591
+ );
1592
+ expect(response.status).toBe(200);
1593
+ expect(runAfter).not.toHaveBeenCalled();
1594
+ });
1595
+
1596
+ it("doc fetch returns null: no runAfter call, no throw", async () => {
1597
+ const runAfter = vi.fn().mockResolvedValue(undefined);
1598
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1599
+ // Default runQuery resolves null — doc not found
1600
+
1601
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1602
+ mockConstructEventAsync.mockResolvedValue(makeCheckoutEvent());
1603
+
1604
+ const response = await triggerHandler(
1605
+ schedCtx,
1606
+ makeRequest({ type: "checkout.session.completed" }),
1607
+ );
1608
+ expect(response.status).toBe(200);
1609
+ expect(runAfter).not.toHaveBeenCalled();
1610
+ });
1611
+
1612
+ it("V2 account event schedules afterAccountUpdated with the account doc", async () => {
1613
+ const runAfter = vi.fn().mockResolvedValue(undefined);
1614
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1615
+
1616
+ const accountDoc = {
1617
+ _id: "doc_acct_1",
1618
+ stripeAccountId: "acct_test_123",
1619
+ onboardingStatus: "complete",
1620
+ };
1621
+ (schedCtx.runQuery as Mock).mockResolvedValue(accountDoc);
1622
+
1623
+ const thinEvent = makeV2ThinEvent();
1624
+ mockParseEventNotificationAsync.mockResolvedValue(thinEvent);
1625
+ mockAccountRetrieve.mockResolvedValue({
1626
+ id: "acct_test_123",
1627
+ contact_email: "test@example.com",
1628
+ identity: {
1629
+ business_details: { registered_name: "Test Business" },
1630
+ country: "US",
1631
+ },
1632
+ metadata: { userId: "user_123" },
1633
+ requirements: {},
1634
+ configuration: { customer: { applied: true } },
1635
+ });
1636
+
1637
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1638
+
1639
+ const request = new Request("https://example.com/stripe/webhook", {
1640
+ method: "POST",
1641
+ body: JSON.stringify(thinEvent),
1642
+ headers: {
1643
+ "stripe-signature": "test_sig_v2",
1644
+ "content-type": "application/json",
1645
+ },
1646
+ });
1647
+ const response = await triggerHandler(schedCtx, request);
1648
+ expect(response.status).toBe(200);
1649
+
1650
+ expect(schedCtx.runQuery).toHaveBeenCalledWith(
1651
+ component.core.queries.getAccountByStripeId,
1652
+ { stripeAccountId: "acct_test_123" },
1653
+ );
1654
+ expect(runAfter).toHaveBeenCalledWith(0, asyncWebhook, {
1655
+ hook: "afterAccountUpdated",
1656
+ doc: accountDoc,
1657
+ });
1658
+ });
1659
+
1660
+ it("runAfter rejection is logged and the webhook still returns 200", async () => {
1661
+ const runAfter = vi
1662
+ .fn()
1663
+ .mockRejectedValue(new Error("scheduler exploded"));
1664
+ const schedCtx = createMockCtx({ scheduler: { runAfter } });
1665
+ (schedCtx.runQuery as Mock).mockResolvedValue({
1666
+ stripeSessionId: "cs_hook_123",
1667
+ });
1668
+
1669
+ const consoleSpy = vi
1670
+ .spyOn(console, "error")
1671
+ .mockImplementation(() => {});
1672
+
1673
+ const triggerHandler = setupHandlerWithWebhooks(webhookRefs);
1674
+ mockConstructEventAsync.mockResolvedValue(makeCheckoutEvent());
1675
+
1676
+ const response = await triggerHandler(
1677
+ schedCtx,
1678
+ makeRequest({ type: "checkout.session.completed" }),
1679
+ );
1680
+ expect(response.status).toBe(200);
1681
+ expect(runAfter).toHaveBeenCalled();
1682
+ expect(consoleSpy).toHaveBeenCalledWith(
1683
+ expect.stringContaining("Failed to schedule async hook"),
1684
+ expect.any(Error),
1685
+ );
1686
+ consoleSpy.mockRestore();
1687
+ });
1688
+ });
1689
+ });