@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,603 @@
1
+ // @vitest-environment edge-runtime
2
+ /**
3
+ * Tests for `BetterStripe.webhookHandlers()` — the two-function routing pair
4
+ * (`syncWebhook` / `asyncWebhook`) that replaced the 18-export `triggersApi()`.
5
+ *
6
+ * The routing mutation/action are invoked the same way the webhook handler
7
+ * invokes them: by their discriminator arg (`dispatcher` / `hook`). Registered
8
+ * Convex functions expose their raw handler via `_handler`.
9
+ */
10
+ import { beforeEach, describe, expect, it, vi } from "vitest";
11
+
12
+ import { BetterStripe } from "./index.js";
13
+ import { components as _components } from "./setup.test.js";
14
+ import type { SyncTriggers, TriggerDispatcherName } from "./types/triggers.js";
15
+
16
+ const components = _components;
17
+
18
+ // Registered Convex functions expose their raw handler via `_handler`
19
+ // (set by convex/server's registration impl) — invoke the routing functions
20
+ // that way.
21
+ const invokeHandler = (fn: unknown, ctx: unknown, args: unknown) =>
22
+ (fn as { _handler: (ctx: unknown, args: unknown) => Promise<null> })._handler(
23
+ ctx,
24
+ args,
25
+ );
26
+
27
+ // Component refs expose their function path via the toReferencePath symbol
28
+ // (e.g. "_reference/childComponent/betterStripe/billing/..."). Asserting on
29
+ // the path suffix catches typo'd dispatcher spec paths.
30
+ const refPath = (ref: unknown): string =>
31
+ (ref as Record<symbol, string>)[Symbol.for("toReferencePath")];
32
+
33
+ function createMockCtx() {
34
+ return {
35
+ runQuery: vi.fn(),
36
+ runMutation: vi.fn(),
37
+ runAction: vi.fn(),
38
+ };
39
+ }
40
+
41
+ describe("webhookHandlers()", () => {
42
+ let mockCtx: ReturnType<typeof createMockCtx>;
43
+
44
+ beforeEach(() => {
45
+ vi.clearAllMocks();
46
+ mockCtx = createMockCtx();
47
+ });
48
+
49
+ it("returns syncWebhook + asyncWebhook function definitions", () => {
50
+ const stripe = new BetterStripe(components.betterStripe, {
51
+ STRIPE_SECRET_KEY: "sk_test_x",
52
+ });
53
+ const handlers = stripe.webhookHandlers();
54
+ expect(handlers).toHaveProperty("syncWebhook");
55
+ expect(handlers).toHaveProperty("asyncWebhook");
56
+ expect(Object.keys(handlers)).toHaveLength(2);
57
+ });
58
+
59
+ // =========================================================================
60
+ // syncWebhook routing
61
+ // =========================================================================
62
+
63
+ describe("syncWebhook", () => {
64
+ // Standard upsert dispatchers: each maps to a component getter/upsert pair
65
+ // and supports the splitCreateUpdate create/update trigger split.
66
+ const standardUpsertDispatchers: Array<{
67
+ name: TriggerDispatcherName;
68
+ triggerKey: keyof SyncTriggers;
69
+ idField: string;
70
+ getterPath: RegExp;
71
+ upsertPath: RegExp;
72
+ hasUpdate: boolean;
73
+ }> = [
74
+ {
75
+ name: "accountUpserted",
76
+ triggerKey: "account",
77
+ idField: "stripeAccountId",
78
+ getterPath: /\/core\/queries\/getAccountByStripeId$/,
79
+ upsertPath: /\/core\/mutations\/upsertAccountInternal$/,
80
+ hasUpdate: true,
81
+ },
82
+ {
83
+ name: "productUpserted",
84
+ triggerKey: "product",
85
+ idField: "stripeProductId",
86
+ getterPath: /\/products\/queries\/getProductByStripeId$/,
87
+ upsertPath: /\/products\/mutations\/upsertProduct$/,
88
+ hasUpdate: true,
89
+ },
90
+ {
91
+ name: "priceUpserted",
92
+ triggerKey: "price",
93
+ idField: "stripePriceId",
94
+ getterPath: /\/products\/queries\/getPriceByStripeId$/,
95
+ upsertPath: /\/products\/mutations\/upsertPrice$/,
96
+ hasUpdate: true,
97
+ },
98
+ {
99
+ name: "subscriptionUpserted",
100
+ triggerKey: "subscription",
101
+ idField: "stripeSubscriptionId",
102
+ getterPath: /\/billing\/queries\/getSubscriptionByStripeId$/,
103
+ upsertPath: /\/billing\/mutations\/upsertSubscription$/,
104
+ hasUpdate: true,
105
+ },
106
+ {
107
+ name: "invoiceUpserted",
108
+ triggerKey: "invoice",
109
+ idField: "stripeInvoiceId",
110
+ getterPath: /\/billing\/queries\/getInvoiceByStripeId$/,
111
+ upsertPath: /\/billing\/mutations\/upsertInvoice$/,
112
+ hasUpdate: true,
113
+ },
114
+ {
115
+ name: "paymentUpserted",
116
+ triggerKey: "payment",
117
+ idField: "stripePaymentIntentId",
118
+ getterPath: /\/connect\/queries\/getPaymentByStripeId$/,
119
+ upsertPath: /\/connect\/mutations\/upsertPayment$/,
120
+ hasUpdate: false,
121
+ },
122
+ {
123
+ name: "payoutUpserted",
124
+ triggerKey: "payout",
125
+ idField: "stripePayoutId",
126
+ getterPath: /\/connect\/queries\/getPayoutByStripeId$/,
127
+ upsertPath: /\/connect\/mutations\/upsertPayout$/,
128
+ hasUpdate: true,
129
+ },
130
+ {
131
+ name: "refundUpserted",
132
+ triggerKey: "refund",
133
+ idField: "stripeRefundId",
134
+ getterPath: /\/connect\/queries\/getRefundByStripeId$/,
135
+ upsertPath: /\/connect\/mutations\/upsertRefund$/,
136
+ hasUpdate: true,
137
+ },
138
+ {
139
+ name: "disputeUpserted",
140
+ triggerKey: "dispute",
141
+ idField: "stripeDisputeId",
142
+ getterPath: /\/connect\/queries\/getDisputeByStripeId$/,
143
+ upsertPath: /\/connect\/mutations\/upsertDispute$/,
144
+ hasUpdate: true,
145
+ },
146
+ ];
147
+
148
+ describe("standard upsert dispatchers", () => {
149
+ it.each(standardUpsertDispatchers)(
150
+ "$name upserts and fires onCreate for a new doc, in one transaction",
151
+ async ({
152
+ name,
153
+ triggerKey,
154
+ idField,
155
+ getterPath,
156
+ upsertPath,
157
+ hasUpdate,
158
+ }) => {
159
+ const onCreate = vi.fn().mockResolvedValue(undefined);
160
+ const onUpdate = hasUpdate
161
+ ? vi.fn().mockResolvedValue(undefined)
162
+ : undefined;
163
+ const bs = new BetterStripe(components.betterStripe, {
164
+ STRIPE_SECRET_KEY: "sk_test_xxx",
165
+ triggers: { [triggerKey]: { onCreate, onUpdate } } as SyncTriggers,
166
+ });
167
+
168
+ const newDoc = { [idField]: "id_1", status: "active" };
169
+ mockCtx.runQuery
170
+ .mockResolvedValueOnce(null)
171
+ .mockResolvedValueOnce(newDoc);
172
+
173
+ const { syncWebhook } = bs.webhookHandlers();
174
+ await invokeHandler(syncWebhook, mockCtx, {
175
+ dispatcher: name,
176
+ data: newDoc,
177
+ });
178
+
179
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
180
+ const [upsertRef, upsertArgs] = mockCtx.runMutation.mock.calls[0];
181
+ expect(refPath(upsertRef)).toMatch(upsertPath);
182
+ expect(upsertArgs).toEqual(newDoc);
183
+
184
+ expect(mockCtx.runQuery).toHaveBeenCalledTimes(2);
185
+ for (const [getterRef, getterArgs] of mockCtx.runQuery.mock.calls) {
186
+ expect(refPath(getterRef)).toMatch(getterPath);
187
+ expect(getterArgs).toEqual({ [idField]: "id_1" });
188
+ }
189
+
190
+ expect(onCreate).toHaveBeenCalledTimes(1);
191
+ expect(onCreate).toHaveBeenCalledWith(mockCtx, newDoc);
192
+ if (hasUpdate) {
193
+ expect(onUpdate).not.toHaveBeenCalled();
194
+ }
195
+ },
196
+ );
197
+
198
+ it.each(standardUpsertDispatchers)(
199
+ "$name fires the update trigger (not onCreate) for an existing doc",
200
+ async ({
201
+ name,
202
+ triggerKey,
203
+ idField,
204
+ getterPath,
205
+ upsertPath,
206
+ hasUpdate,
207
+ }) => {
208
+ const onCreate = vi.fn().mockResolvedValue(undefined);
209
+ const onUpdate = hasUpdate
210
+ ? vi.fn().mockResolvedValue(undefined)
211
+ : undefined;
212
+ const bs = new BetterStripe(components.betterStripe, {
213
+ STRIPE_SECRET_KEY: "sk_test_xxx",
214
+ triggers: { [triggerKey]: { onCreate, onUpdate } } as SyncTriggers,
215
+ });
216
+
217
+ const oldDoc = { [idField]: "id_1", status: "old" };
218
+ const newDoc = { [idField]: "id_1", status: "new" };
219
+ mockCtx.runQuery
220
+ .mockResolvedValueOnce(oldDoc)
221
+ .mockResolvedValueOnce(newDoc);
222
+
223
+ const { syncWebhook } = bs.webhookHandlers();
224
+ await invokeHandler(syncWebhook, mockCtx, {
225
+ dispatcher: name,
226
+ data: newDoc,
227
+ });
228
+
229
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
230
+ const [upsertRef, upsertArgs] = mockCtx.runMutation.mock.calls[0];
231
+ expect(refPath(upsertRef)).toMatch(upsertPath);
232
+ expect(upsertArgs).toEqual(newDoc);
233
+
234
+ expect(mockCtx.runQuery).toHaveBeenCalledTimes(2);
235
+ for (const [getterRef, getterArgs] of mockCtx.runQuery.mock.calls) {
236
+ expect(refPath(getterRef)).toMatch(getterPath);
237
+ expect(getterArgs).toEqual({ [idField]: "id_1" });
238
+ }
239
+
240
+ expect(onCreate).not.toHaveBeenCalled();
241
+ if (hasUpdate) {
242
+ expect(onUpdate).toHaveBeenCalledTimes(1);
243
+ expect(onUpdate).toHaveBeenCalledWith(mockCtx, newDoc, oldDoc);
244
+ }
245
+ },
246
+ );
247
+ });
248
+
249
+ it("subscriptionUpserted upserts and fires onCreate for a new doc, in one transaction", async () => {
250
+ const onCreate = vi.fn().mockResolvedValue(undefined);
251
+ const onUpdate = vi.fn().mockResolvedValue(undefined);
252
+ const bs = new BetterStripe(components.betterStripe, {
253
+ STRIPE_SECRET_KEY: "sk_test_xxx",
254
+ triggers: { subscription: { onCreate, onUpdate } },
255
+ });
256
+
257
+ const newDoc = { stripeSubscriptionId: "sub_1", status: "active" };
258
+ mockCtx.runQuery
259
+ .mockResolvedValueOnce(null) // old doc lookup
260
+ .mockResolvedValueOnce(newDoc); // new doc lookup
261
+
262
+ const { syncWebhook } = bs.webhookHandlers();
263
+ await invokeHandler(syncWebhook, mockCtx, {
264
+ dispatcher: "subscriptionUpserted",
265
+ data: { stripeSubscriptionId: "sub_1", status: "active" },
266
+ });
267
+
268
+ // Component upsert performed exactly once, against the right function.
269
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
270
+ const [upsertRef, upsertArgs] = mockCtx.runMutation.mock.calls[0];
271
+ expect(refPath(upsertRef)).toMatch(
272
+ /\/billing\/mutations\/upsertSubscription$/,
273
+ );
274
+ expect(upsertArgs).toEqual({
275
+ stripeSubscriptionId: "sub_1",
276
+ status: "active",
277
+ });
278
+ // Both doc lookups hit the getter with the Stripe id from data.
279
+ expect(mockCtx.runQuery).toHaveBeenCalledTimes(2);
280
+ for (const [getterRef, getterArgs] of mockCtx.runQuery.mock.calls) {
281
+ expect(refPath(getterRef)).toMatch(
282
+ /\/billing\/queries\/getSubscriptionByStripeId$/,
283
+ );
284
+ expect(getterArgs).toEqual({ stripeSubscriptionId: "sub_1" });
285
+ }
286
+ // The sync trigger ran inside the same handler invocation (same txn).
287
+ expect(onCreate).toHaveBeenCalledTimes(1);
288
+ expect(onCreate).toHaveBeenCalledWith(mockCtx, newDoc);
289
+ expect(onUpdate).not.toHaveBeenCalled();
290
+ });
291
+
292
+ it("subscriptionUpserted fires onUpdate (not onCreate) for an existing doc", async () => {
293
+ const onCreate = vi.fn().mockResolvedValue(undefined);
294
+ const onUpdate = vi.fn().mockResolvedValue(undefined);
295
+ const bs = new BetterStripe(components.betterStripe, {
296
+ STRIPE_SECRET_KEY: "sk_test_xxx",
297
+ triggers: { subscription: { onCreate, onUpdate } },
298
+ });
299
+
300
+ const oldDoc = { stripeSubscriptionId: "sub_1", status: "trialing" };
301
+ const newDoc = { stripeSubscriptionId: "sub_1", status: "active" };
302
+ mockCtx.runQuery
303
+ .mockResolvedValueOnce(oldDoc)
304
+ .mockResolvedValueOnce(newDoc);
305
+
306
+ const { syncWebhook } = bs.webhookHandlers();
307
+ await invokeHandler(syncWebhook, mockCtx, {
308
+ dispatcher: "subscriptionUpserted",
309
+ data: { stripeSubscriptionId: "sub_1", status: "active" },
310
+ });
311
+
312
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
313
+ expect(onUpdate).toHaveBeenCalledTimes(1);
314
+ expect(onUpdate).toHaveBeenCalledWith(mockCtx, newDoc, oldDoc);
315
+ expect(onCreate).not.toHaveBeenCalled();
316
+ });
317
+
318
+ it("propagates a throwing sync trigger (so the upsert transaction rolls back)", async () => {
319
+ const onUpdate = vi.fn().mockRejectedValue(new Error("trigger boom"));
320
+ const bs = new BetterStripe(components.betterStripe, {
321
+ STRIPE_SECRET_KEY: "sk_test_xxx",
322
+ triggers: { subscription: { onUpdate } },
323
+ });
324
+ const { syncWebhook } = bs.webhookHandlers();
325
+
326
+ const oldDoc = { stripeSubscriptionId: "sub_1", status: "active" };
327
+ const newDoc = { stripeSubscriptionId: "sub_1", status: "past_due" };
328
+ mockCtx.runQuery
329
+ .mockResolvedValueOnce(oldDoc)
330
+ .mockResolvedValueOnce(newDoc);
331
+
332
+ // The throw must propagate out of the routing mutation. In a real Convex
333
+ // mutation this aborts the transaction, rolling back the component upsert
334
+ // — the contract that makes Stripe retry the webhook.
335
+ await expect(
336
+ invokeHandler(syncWebhook, mockCtx, {
337
+ dispatcher: "subscriptionUpserted",
338
+ data: { stripeSubscriptionId: "sub_1", status: "past_due" },
339
+ }),
340
+ ).rejects.toThrow("trigger boom");
341
+ expect(onUpdate).toHaveBeenCalledTimes(1);
342
+ });
343
+
344
+ it("checkoutSessionUpserted fires onCompleted on transition into 'complete'", async () => {
345
+ const onCompleted = vi.fn().mockResolvedValue(undefined);
346
+ const bs = new BetterStripe(components.betterStripe, {
347
+ STRIPE_SECRET_KEY: "sk_test_xxx",
348
+ triggers: { checkoutSession: { onCompleted } },
349
+ });
350
+ const { syncWebhook } = bs.webhookHandlers();
351
+
352
+ const newDoc = { stripeSessionId: "cs_1", status: "complete" };
353
+ mockCtx.runQuery
354
+ .mockResolvedValueOnce({ stripeSessionId: "cs_1", status: "open" })
355
+ .mockResolvedValueOnce(newDoc);
356
+
357
+ await invokeHandler(syncWebhook, mockCtx, {
358
+ dispatcher: "checkoutSessionUpserted",
359
+ data: { stripeSessionId: "cs_1", status: "complete" },
360
+ });
361
+
362
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
363
+ expect(refPath(mockCtx.runMutation.mock.calls[0][0])).toMatch(
364
+ /\/billing\/mutations\/upsertCheckoutSession$/,
365
+ );
366
+ expect(refPath(mockCtx.runQuery.mock.calls[0][0])).toMatch(
367
+ /\/billing\/queries\/getCheckoutSessionByStripeId$/,
368
+ );
369
+ expect(onCompleted).toHaveBeenCalledTimes(1);
370
+ expect(onCompleted).toHaveBeenCalledWith(mockCtx, newDoc);
371
+ });
372
+
373
+ it("checkoutSessionUpserted fires onCompleted when first seen already complete (null -> complete)", async () => {
374
+ const onCompleted = vi.fn().mockResolvedValue(undefined);
375
+ const bs = new BetterStripe(components.betterStripe, {
376
+ STRIPE_SECRET_KEY: "sk_test_xxx",
377
+ triggers: { checkoutSession: { onCompleted } },
378
+ });
379
+ const { syncWebhook } = bs.webhookHandlers();
380
+
381
+ const newDoc = { stripeSessionId: "cs_1", status: "complete" };
382
+ mockCtx.runQuery
383
+ .mockResolvedValueOnce(null) // no prior doc
384
+ .mockResolvedValueOnce(newDoc);
385
+
386
+ await invokeHandler(syncWebhook, mockCtx, {
387
+ dispatcher: "checkoutSessionUpserted",
388
+ data: { stripeSessionId: "cs_1", status: "complete" },
389
+ });
390
+
391
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
392
+ expect(onCompleted).toHaveBeenCalledTimes(1);
393
+ expect(onCompleted).toHaveBeenCalledWith(mockCtx, newDoc);
394
+ });
395
+
396
+ it("checkoutSessionUpserted does NOT re-fire onCompleted when already complete", async () => {
397
+ const onCompleted = vi.fn().mockResolvedValue(undefined);
398
+ const bs = new BetterStripe(components.betterStripe, {
399
+ STRIPE_SECRET_KEY: "sk_test_xxx",
400
+ triggers: { checkoutSession: { onCompleted } },
401
+ });
402
+ const { syncWebhook } = bs.webhookHandlers();
403
+
404
+ mockCtx.runQuery
405
+ .mockResolvedValueOnce({ stripeSessionId: "cs_1", status: "complete" })
406
+ .mockResolvedValueOnce({ stripeSessionId: "cs_1", status: "complete" });
407
+
408
+ await invokeHandler(syncWebhook, mockCtx, {
409
+ dispatcher: "checkoutSessionUpserted",
410
+ data: { stripeSessionId: "cs_1", status: "complete" },
411
+ });
412
+
413
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
414
+ expect(onCompleted).not.toHaveBeenCalled();
415
+ });
416
+
417
+ it("checkoutSessionUpserted does NOT fire onCompleted when new status is not 'complete'", async () => {
418
+ const onCompleted = vi.fn().mockResolvedValue(undefined);
419
+ const bs = new BetterStripe(components.betterStripe, {
420
+ STRIPE_SECRET_KEY: "sk_test_xxx",
421
+ triggers: { checkoutSession: { onCompleted } },
422
+ });
423
+ const { syncWebhook } = bs.webhookHandlers();
424
+
425
+ mockCtx.runQuery
426
+ .mockResolvedValueOnce(null)
427
+ .mockResolvedValueOnce({ stripeSessionId: "cs_1", status: "open" });
428
+
429
+ await invokeHandler(syncWebhook, mockCtx, {
430
+ dispatcher: "checkoutSessionUpserted",
431
+ data: { stripeSessionId: "cs_1", status: "open" },
432
+ });
433
+
434
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
435
+ expect(onCompleted).not.toHaveBeenCalled();
436
+ });
437
+
438
+ it("subscriptionDeleted upserts and fires subscription.onDelete with the fetched doc", async () => {
439
+ const onDelete = vi.fn().mockResolvedValue(undefined);
440
+ const bs = new BetterStripe(components.betterStripe, {
441
+ STRIPE_SECRET_KEY: "sk_test_xxx",
442
+ triggers: { subscription: { onDelete } },
443
+ });
444
+ const { syncWebhook } = bs.webhookHandlers();
445
+
446
+ const doc = { stripeSubscriptionId: "sub_1", status: "canceled" };
447
+ mockCtx.runQuery.mockResolvedValueOnce(doc);
448
+
449
+ await invokeHandler(syncWebhook, mockCtx, {
450
+ dispatcher: "subscriptionDeleted",
451
+ data: { stripeSubscriptionId: "sub_1", status: "canceled" },
452
+ });
453
+
454
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
455
+ const [upsertRef, upsertArgs] = mockCtx.runMutation.mock.calls[0];
456
+ expect(refPath(upsertRef)).toMatch(
457
+ /\/billing\/mutations\/upsertSubscription$/,
458
+ );
459
+ expect(upsertArgs).toEqual({
460
+ stripeSubscriptionId: "sub_1",
461
+ status: "canceled",
462
+ });
463
+ const [getterRef, getterArgs] = mockCtx.runQuery.mock.calls[0];
464
+ expect(refPath(getterRef)).toMatch(
465
+ /\/billing\/queries\/getSubscriptionByStripeId$/,
466
+ );
467
+ expect(getterArgs).toEqual({ stripeSubscriptionId: "sub_1" });
468
+ expect(onDelete).toHaveBeenCalledTimes(1);
469
+ expect(onDelete).toHaveBeenCalledWith(mockCtx, doc);
470
+ });
471
+
472
+ it("rejects with a clear error when the Stripe id field is missing from data", async () => {
473
+ const bs = new BetterStripe(components.betterStripe, {
474
+ STRIPE_SECRET_KEY: "sk_test_xxx",
475
+ triggers: { subscription: { onCreate: vi.fn() } },
476
+ });
477
+ const { syncWebhook } = bs.webhookHandlers();
478
+
479
+ await expect(
480
+ invokeHandler(syncWebhook, mockCtx, {
481
+ dispatcher: "subscriptionUpserted",
482
+ data: { status: "active" },
483
+ }),
484
+ ).rejects.toThrow(
485
+ "[better-stripe] subscriptionUpserted: missing stripeSubscriptionId in data",
486
+ );
487
+
488
+ // Nothing was written or read.
489
+ expect(mockCtx.runMutation).not.toHaveBeenCalled();
490
+ expect(mockCtx.runQuery).not.toHaveBeenCalled();
491
+ });
492
+
493
+ it("rejects with a clear error for an unknown dispatcher", async () => {
494
+ const bs = new BetterStripe(components.betterStripe, {
495
+ STRIPE_SECRET_KEY: "sk_test_xxx",
496
+ });
497
+ const { syncWebhook } = bs.webhookHandlers();
498
+
499
+ await expect(
500
+ invokeHandler(syncWebhook, mockCtx, {
501
+ dispatcher: "bogusDispatcher",
502
+ data: { stripeSubscriptionId: "sub_1" },
503
+ }),
504
+ ).rejects.toThrow("[better-stripe] unknown dispatcher: bogusDispatcher");
505
+ expect(mockCtx.runMutation).not.toHaveBeenCalled();
506
+ });
507
+
508
+ it("propagates trigger errors so the transaction rolls back", async () => {
509
+ const onCreate = vi.fn().mockRejectedValue(new Error("trigger boom"));
510
+ const bs = new BetterStripe(components.betterStripe, {
511
+ STRIPE_SECRET_KEY: "sk_test_xxx",
512
+ triggers: { subscription: { onCreate } },
513
+ });
514
+ const { syncWebhook } = bs.webhookHandlers();
515
+
516
+ mockCtx.runQuery
517
+ .mockResolvedValueOnce(null)
518
+ .mockResolvedValueOnce({ stripeSubscriptionId: "sub_1" });
519
+
520
+ // The upsert ran, then the trigger threw. Because both run in the same
521
+ // mutation handler, a throw aborts the whole invocation — Convex rolls
522
+ // back the upsert. We assert the handler rejects (the rollback signal).
523
+ await expect(
524
+ invokeHandler(syncWebhook, mockCtx, {
525
+ dispatcher: "subscriptionUpserted",
526
+ data: { stripeSubscriptionId: "sub_1" },
527
+ }),
528
+ ).rejects.toThrow("trigger boom");
529
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
530
+ });
531
+
532
+ it("performs the upsert without throwing when no triggers are configured", async () => {
533
+ const bs = new BetterStripe(components.betterStripe, {
534
+ STRIPE_SECRET_KEY: "sk_test_xxx",
535
+ });
536
+ const { syncWebhook } = bs.webhookHandlers();
537
+
538
+ await expect(
539
+ invokeHandler(syncWebhook, mockCtx, {
540
+ dispatcher: "subscriptionUpserted",
541
+ data: { stripeSubscriptionId: "sub_1" },
542
+ }),
543
+ ).resolves.toBeNull();
544
+
545
+ expect(mockCtx.runMutation).toHaveBeenCalledTimes(1);
546
+ // No trigger configured -> the before/after doc reads are skipped.
547
+ expect(mockCtx.runQuery).not.toHaveBeenCalled();
548
+ });
549
+ });
550
+
551
+ // =========================================================================
552
+ // asyncWebhook routing
553
+ // =========================================================================
554
+
555
+ describe("asyncWebhook", () => {
556
+ it("routes to the configured hook with (ctx, doc)", async () => {
557
+ const onCheckoutCompleted = vi.fn().mockResolvedValue(undefined);
558
+ const bs = new BetterStripe(components.betterStripe, {
559
+ STRIPE_SECRET_KEY: "sk_test_xxx",
560
+ hooks: { onCheckoutCompleted },
561
+ });
562
+ const { asyncWebhook } = bs.webhookHandlers();
563
+
564
+ const doc = { stripeSessionId: "cs_1", status: "complete" };
565
+ await invokeHandler(asyncWebhook, mockCtx, {
566
+ hook: "afterCheckoutCompleted",
567
+ doc,
568
+ });
569
+
570
+ expect(onCheckoutCompleted).toHaveBeenCalledTimes(1);
571
+ expect(onCheckoutCompleted).toHaveBeenCalledWith(mockCtx, doc);
572
+ });
573
+
574
+ it("resolves without error when no hook is configured", async () => {
575
+ const bs = new BetterStripe(components.betterStripe, {
576
+ STRIPE_SECRET_KEY: "sk_test_xxx",
577
+ });
578
+ const { asyncWebhook } = bs.webhookHandlers();
579
+
580
+ await expect(
581
+ invokeHandler(asyncWebhook, mockCtx, {
582
+ hook: "afterCheckoutCompleted",
583
+ doc: { stripeSessionId: "cs_1" },
584
+ }),
585
+ ).resolves.toBeNull();
586
+ });
587
+
588
+ it("resolves without error for an unknown hook name", async () => {
589
+ const bs = new BetterStripe(components.betterStripe, {
590
+ STRIPE_SECRET_KEY: "sk_test_xxx",
591
+ hooks: { onCheckoutCompleted: vi.fn() },
592
+ });
593
+ const { asyncWebhook } = bs.webhookHandlers();
594
+
595
+ await expect(
596
+ invokeHandler(asyncWebhook, mockCtx, {
597
+ hook: "bogusHook",
598
+ doc: {},
599
+ }),
600
+ ).resolves.toBeNull();
601
+ });
602
+ });
603
+ });