@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,277 @@
1
+ import type Stripe from "stripe";
2
+
3
+ import type { Component } from "../helpers.js";
4
+ export { getStripeClient } from "../helpers.js";
5
+ import type { WebhookActionCtx } from "../types.js";
6
+ import type { TriggerDispatcherName } from "../types/triggers.js";
7
+
8
+ const TO_REFERENCE_PATH = Symbol.for("toReferencePath");
9
+
10
+ // =============================================================================
11
+ // COMPONENT FUNCTION MAP
12
+ // =============================================================================
13
+
14
+ const COMPONENT_FUNCTION_MAP: Record<string, string> = {
15
+ // Core
16
+ getAccount: "core/queries/getAccount",
17
+ getAccountByStripeId: "core/queries/getAccountByStripeId",
18
+ getAccountByUserId: "core/queries/getAccountByUserId",
19
+ getAccountByOrgId: "core/queries/getAccountByOrgId",
20
+ getAccountOnboardingStatus: "core/queries/getAccountOnboardingStatus",
21
+ getPublishableKey: "core/queries/getPublishableKey",
22
+ getStripeMode: "core/queries/getStripeMode",
23
+ upsertAccount: "core/mutations/upsertAccount",
24
+ upsertAccountInternal: "core/mutations/upsertAccountInternal",
25
+ deleteAccountByStripeId: "core/mutations/deleteAccountByStripeId",
26
+ clearAllTables: "core/mutations/clearAllTables",
27
+ // Products
28
+ getProduct: "products/queries/getProduct",
29
+ getProductByStripeId: "products/queries/getProductByStripeId",
30
+ listProducts: "products/queries/listProducts",
31
+ getPrice: "products/queries/getPrice",
32
+ getPriceByStripeId: "products/queries/getPriceByStripeId",
33
+ listPrices: "products/queries/listPrices",
34
+ listPricesByProduct: "products/queries/listPricesByProduct",
35
+ upsertProduct: "products/mutations/upsertProduct",
36
+ upsertPrice: "products/mutations/upsertPrice",
37
+ // Billing
38
+ getSubscription: "billing/queries/getSubscription",
39
+ getSubscriptionByStripeId: "billing/queries/getSubscriptionByStripeId",
40
+ listSubscriptions: "billing/queries/listSubscriptions",
41
+ listSubscriptionsByUser: "billing/queries/listSubscriptionsByUser",
42
+ listSubscriptionsByOrg: "billing/queries/listSubscriptionsByOrg",
43
+ getActiveSubscription: "billing/queries/getActiveSubscription",
44
+ getTrialStatus: "billing/queries/getTrialStatus",
45
+ getCheckoutSession: "billing/queries/getCheckoutSession",
46
+ getCheckoutSessionByStripeId: "billing/queries/getCheckoutSessionByStripeId",
47
+ listCheckoutSessionsByUser: "billing/queries/listCheckoutSessionsByUser",
48
+ getInvoiceByStripeId: "billing/queries/getInvoiceByStripeId",
49
+ listInvoices: "billing/queries/listInvoices",
50
+ upsertSubscription: "billing/mutations/upsertSubscription",
51
+ upsertCheckoutSession: "billing/mutations/upsertCheckoutSession",
52
+ upsertInvoice: "billing/mutations/upsertInvoice",
53
+ // Connect
54
+ getPaymentByStripeId: "connect/queries/getPaymentByStripeId",
55
+ getPayout: "connect/queries/getPayout",
56
+ getPayoutByStripeId: "connect/queries/getPayoutByStripeId",
57
+ listPayouts: "connect/queries/listPayouts",
58
+ upsertPayment: "connect/mutations/upsertPayment",
59
+ upsertPayout: "connect/mutations/upsertPayout",
60
+ getRefundByStripeId: "connect/queries/getRefundByStripeId",
61
+ listRefunds: "connect/queries/listRefunds",
62
+ upsertRefund: "connect/mutations/upsertRefund",
63
+ getDisputeByStripeId: "connect/queries/getDisputeByStripeId",
64
+ listDisputes: "connect/queries/listDisputes",
65
+ upsertDispute: "connect/mutations/upsertDispute",
66
+ // Webhooks
67
+ getWebhookEvent: "webhooks/queries/getWebhookEvent",
68
+ insertWebhookEvent: "webhooks/mutations/insertWebhookEvent",
69
+ markWebhookEventProcessed: "webhooks/mutations/markWebhookEventProcessed",
70
+ markWebhookEventFailed: "webhooks/mutations/markWebhookEventFailed",
71
+ markWebhookEventIgnored: "webhooks/mutations/markWebhookEventIgnored",
72
+ };
73
+
74
+ // =============================================================================
75
+ // HELPERS
76
+ // =============================================================================
77
+
78
+ export function epochToIso(
79
+ epoch: number | null | undefined,
80
+ ): string | undefined {
81
+ if (epoch == null) return undefined;
82
+ return new Date(epoch * 1000).toISOString();
83
+ }
84
+
85
+ export function deriveTrialFields(subscription: Stripe.Subscription): {
86
+ isTrialing: boolean;
87
+ trialStart: string | undefined;
88
+ trialEnd: string | undefined;
89
+ } {
90
+ return {
91
+ isTrialing: subscription.status === "trialing",
92
+ trialStart: epochToIso(subscription.trial_start),
93
+ trialEnd: epochToIso(subscription.trial_end),
94
+ };
95
+ }
96
+
97
+ /**
98
+ * Extracts userId and orgId from Stripe object metadata.
99
+ *
100
+ * Returns userId `""` when the Stripe object has no userId metadata
101
+ * (e.g. created in the Stripe Dashboard). `""` rows are stored but
102
+ * never matched by user-scoped queries.
103
+ */
104
+ export function extractIdentifiers(
105
+ metadata: Record<string, string> | null | undefined,
106
+ ): { userId: string; orgId: string | undefined } {
107
+ return {
108
+ userId: metadata?.userId ?? metadata?.user_id ?? "",
109
+ orgId: metadata?.orgId ?? metadata?.org_id ?? undefined,
110
+ };
111
+ }
112
+
113
+ export function jsonResponse(
114
+ data: Record<string, unknown>,
115
+ status: number,
116
+ ): Response {
117
+ return new Response(JSON.stringify(data), {
118
+ status,
119
+ headers: { "Content-Type": "application/json" },
120
+ });
121
+ }
122
+
123
+ /**
124
+ * Resolve a component function reference by export name.
125
+ *
126
+ * Uses an anchor ref from the component to derive the base path prefix,
127
+ * then looks up the function's new domain path from COMPONENT_FUNCTION_MAP.
128
+ */
129
+ export function getComponentRef(
130
+ component: Component,
131
+ _moduleName: string,
132
+ exportName: string,
133
+ ) {
134
+ // Try direct property access on the component proxy first
135
+ // (handles both old flat paths and new nested paths)
136
+ const parts = COMPONENT_FUNCTION_MAP[exportName]?.split("/") ?? [];
137
+ if (parts.length > 0) {
138
+ let ref: any = component;
139
+ for (const part of parts) {
140
+ ref = ref?.[part];
141
+ if (!ref) break;
142
+ }
143
+ if (ref?.[TO_REFERENCE_PATH]) return ref;
144
+ }
145
+
146
+ // Construct synthetic ref from an anchor
147
+ const anchor = findAnchorRef(component);
148
+ if (!anchor) {
149
+ throw new Error(
150
+ `[better-stripe] Cannot resolve component ref for ${exportName}: ` +
151
+ `no anchor ref available on component.`,
152
+ );
153
+ }
154
+
155
+ const anchorPath: string = anchor[TO_REFERENCE_PATH];
156
+ // Extract the component prefix (e.g. 'betterStripe')
157
+ const basePath = anchorPath.split("/")[0];
158
+
159
+ const mappedPath = COMPONENT_FUNCTION_MAP[exportName];
160
+ if (mappedPath) {
161
+ return { [TO_REFERENCE_PATH]: `${basePath}/${mappedPath}` } as any;
162
+ }
163
+
164
+ // Fallback: assume same module
165
+ const modulePrefix = anchorPath.replace(/\/[^/]+$/, "");
166
+ return { [TO_REFERENCE_PATH]: `${modulePrefix}/${exportName}` } as any;
167
+ }
168
+
169
+ /**
170
+ * Generic helper to resolve a component function by its full domain path.
171
+ * Example: componentRef(component, 'core/queries/getAccount')
172
+ */
173
+ export function componentRef(component: Component, path: string) {
174
+ // Try direct property access
175
+ const parts = path.split("/");
176
+
177
+ let ref: any = component;
178
+ for (const part of parts) {
179
+ ref = ref?.[part];
180
+ if (!ref) break;
181
+ }
182
+ if (ref?.[TO_REFERENCE_PATH]) return ref;
183
+
184
+ // Construct synthetic ref from anchor
185
+ const anchor = findAnchorRef(component);
186
+ if (!anchor?.[TO_REFERENCE_PATH]) {
187
+ throw new Error(`[better-stripe] Cannot resolve component path: ${path}`);
188
+ }
189
+ const anchorPath: string = anchor[TO_REFERENCE_PATH];
190
+ const basePath = anchorPath.split("/")[0];
191
+ return { [TO_REFERENCE_PATH]: `${basePath}/${path}` } as any;
192
+ }
193
+
194
+ /**
195
+ * Component upsert mutation path for each trigger dispatcher. Single source
196
+ * of truth shared by `dispatchUpsert` (direct-mutation fallback) and
197
+ * `webhookHandlers()`'s dispatcher specs — keeps the pairing in sync by
198
+ * construction.
199
+ */
200
+ export const DISPATCHER_UPSERT_PATHS: Record<TriggerDispatcherName, string> = {
201
+ accountUpserted: "core/mutations/upsertAccountInternal",
202
+ productUpserted: "products/mutations/upsertProduct",
203
+ priceUpserted: "products/mutations/upsertPrice",
204
+ subscriptionUpserted: "billing/mutations/upsertSubscription",
205
+ subscriptionDeleted: "billing/mutations/upsertSubscription",
206
+ checkoutSessionUpserted: "billing/mutations/upsertCheckoutSession",
207
+ invoiceUpserted: "billing/mutations/upsertInvoice",
208
+ paymentUpserted: "connect/mutations/upsertPayment",
209
+ payoutUpserted: "connect/mutations/upsertPayout",
210
+ refundUpserted: "connect/mutations/upsertRefund",
211
+ disputeUpserted: "connect/mutations/upsertDispute",
212
+ };
213
+
214
+ /**
215
+ * Run a domain upsert. When the app registered the `webhooks` handler pair,
216
+ * route through `syncWebhook` so the sync trigger runs in the same transaction
217
+ * as the component write. Otherwise call the component mutation directly.
218
+ */
219
+ export async function dispatchUpsert(
220
+ whCtx: WebhookContext,
221
+ dispatcherName: TriggerDispatcherName,
222
+ data: Record<string, unknown>,
223
+ ): Promise<void> {
224
+ const refs = whCtx.config?.webhooks;
225
+ if (refs) {
226
+ await whCtx.ctx.runMutation(refs.syncWebhook, {
227
+ dispatcher: dispatcherName,
228
+ data,
229
+ });
230
+ } else {
231
+ await whCtx.ctx.runMutation(
232
+ componentRef(whCtx.component, DISPATCHER_UPSERT_PATHS[dispatcherName]),
233
+ data,
234
+ );
235
+ }
236
+ }
237
+
238
+ function findAnchorRef(component: Component): any {
239
+ const comp = component as any;
240
+ // Try new paths first, then old
241
+ const candidates = [
242
+ comp?.core?.queries?.getAccount,
243
+ comp?.public?.getAccount,
244
+ ];
245
+ for (const c of candidates) {
246
+ if (c?.[TO_REFERENCE_PATH]) return c;
247
+ }
248
+ // Walk the component to find any ref
249
+ for (const key of Object.keys(comp ?? {})) {
250
+ const mod = comp[key];
251
+ if (!mod || typeof mod !== "object") continue;
252
+ for (const fn of Object.keys(mod)) {
253
+ if (mod[fn]?.[TO_REFERENCE_PATH]) return mod[fn];
254
+ }
255
+ // Check nested (e.g. core.queries.getAccount)
256
+ for (const subKey of Object.keys(mod)) {
257
+ const sub = mod[subKey];
258
+ if (!sub || typeof sub !== "object") continue;
259
+ for (const fn of Object.keys(sub)) {
260
+ if (sub[fn]?.[TO_REFERENCE_PATH]) return sub[fn];
261
+ }
262
+ }
263
+ }
264
+ return null;
265
+ }
266
+
267
+ // =============================================================================
268
+ // TYPES
269
+ // =============================================================================
270
+
271
+ export type WebhookContext = {
272
+ ctx: WebhookActionCtx;
273
+ component: Component;
274
+ config?: import("../types.js").RegisterRoutesConfig;
275
+ stripe: Stripe;
276
+ webhookSecret: string;
277
+ };
@@ -0,0 +1,111 @@
1
+ /**
2
+ * Tests for `scheduleAsyncHook` — the post-commit async-hook scheduler that maps
3
+ * a Stripe event type to at most one app hook, fetches the just-committed
4
+ * component doc, and schedules the app's `asyncWebhook` action with it.
5
+ *
6
+ * BTS-33 focus: `invoice.payment_failed` must schedule an INVOICE-level
7
+ * payment-failed hook (`afterInvoicePaymentFailed`) so an app can react to a
8
+ * failed subscription cycle (dunning). Before BTS-33 this event upserted the
9
+ * invoice but fired no hook — the gap this suite pins shut.
10
+ */
11
+ import { type Mock, beforeEach, describe, expect, it, vi } from "vitest";
12
+
13
+ import type { Component } from "../helpers.js";
14
+ import type { WebhookContext } from "./helpers.js";
15
+ import { scheduleAsyncHook } from "./hooks.js";
16
+
17
+ const TO_REF = Symbol.for("toReferencePath");
18
+ const ref = (path: string) => ({ [TO_REF]: `betterStripe/${path}` });
19
+
20
+ const ASYNC_WEBHOOK_REF = ref("stripe/asyncWebhook");
21
+
22
+ function makeComponent(): Component {
23
+ return {
24
+ billing: {
25
+ queries: {
26
+ getInvoiceByStripeId: ref("billing/queries/getInvoiceByStripeId"),
27
+ },
28
+ },
29
+ } as unknown as Component;
30
+ }
31
+
32
+ function makeWhCtx(opts?: {
33
+ doc?: unknown;
34
+ withScheduler?: boolean;
35
+ withRefs?: boolean;
36
+ }): WebhookContext & {
37
+ ctx: { runQuery: Mock; scheduler: { runAfter: Mock } | undefined };
38
+ } {
39
+ const runAfter = vi.fn().mockResolvedValue(undefined);
40
+ return {
41
+ ctx: {
42
+ runQuery: vi.fn().mockResolvedValue(opts?.doc ?? null),
43
+ scheduler:
44
+ opts?.withScheduler === false ? undefined : { runAfter },
45
+ },
46
+ component: makeComponent(),
47
+ stripe: {} as never,
48
+ webhookSecret: "whsec_test",
49
+ config:
50
+ opts?.withRefs === false
51
+ ? {}
52
+ : ({ webhooks: { asyncWebhook: ASYNC_WEBHOOK_REF } } as never),
53
+ } as unknown as WebhookContext & {
54
+ ctx: { runQuery: Mock; scheduler: { runAfter: Mock } | undefined };
55
+ };
56
+ }
57
+
58
+ const invoiceDoc = {
59
+ _id: "invoices_1",
60
+ stripeInvoiceId: "in_failed",
61
+ status: "open",
62
+ nextPaymentAttempt: "2030-02-01T00:00:00.000Z",
63
+ attemptCount: 1,
64
+ };
65
+
66
+ beforeEach(() => {
67
+ vi.spyOn(console, "warn").mockImplementation(() => {});
68
+ vi.spyOn(console, "error").mockImplementation(() => {});
69
+ });
70
+
71
+ describe("scheduleAsyncHook — invoice.payment_failed (BTS-33)", () => {
72
+ it("schedules afterInvoicePaymentFailed with the committed invoice doc", async () => {
73
+ const whCtx = makeWhCtx({ doc: invoiceDoc });
74
+
75
+ await scheduleAsyncHook(whCtx, "invoice.payment_failed", "in_failed");
76
+
77
+ // Fetched the committed invoice by its Stripe id.
78
+ expect(whCtx.ctx.runQuery).toHaveBeenCalledWith(
79
+ expect.objectContaining({
80
+ [TO_REF]: "betterStripe/billing/queries/getInvoiceByStripeId",
81
+ }),
82
+ { stripeInvoiceId: "in_failed" },
83
+ );
84
+ // Scheduled the invoice-level payment-failed hook with that doc.
85
+ const runAfter = whCtx.ctx.scheduler!.runAfter;
86
+ expect(runAfter).toHaveBeenCalledWith(0, ASYNC_WEBHOOK_REF, {
87
+ hook: "afterInvoicePaymentFailed",
88
+ doc: invoiceDoc,
89
+ });
90
+ });
91
+
92
+ it("does not schedule when the invoice is not yet committed", async () => {
93
+ const whCtx = makeWhCtx({ doc: null });
94
+
95
+ await scheduleAsyncHook(whCtx, "invoice.payment_failed", "in_failed");
96
+
97
+ expect(whCtx.ctx.scheduler!.runAfter).not.toHaveBeenCalled();
98
+ });
99
+
100
+ it("still maps invoice.paid to afterInvoicePaid (unchanged)", async () => {
101
+ const whCtx = makeWhCtx({ doc: { _id: "invoices_2" } });
102
+
103
+ await scheduleAsyncHook(whCtx, "invoice.paid", "in_paid");
104
+
105
+ expect(whCtx.ctx.scheduler!.runAfter).toHaveBeenCalledWith(
106
+ 0,
107
+ ASYNC_WEBHOOK_REF,
108
+ expect.objectContaining({ hook: "afterInvoicePaid" }),
109
+ );
110
+ });
111
+ });
@@ -0,0 +1,177 @@
1
+ import type {
2
+ RegisterRoutesConfig,
3
+ StripeWebhookEvent,
4
+ WebhookActionCtx,
5
+ } from "../types.js";
6
+ import type { AsyncHookName } from "../types/triggers.js";
7
+ import { type WebhookContext, componentRef } from "./helpers.js";
8
+
9
+ // =============================================================================
10
+ // HOOK RUNNER
11
+ // =============================================================================
12
+
13
+ export async function runHooks(
14
+ ctx: WebhookActionCtx,
15
+ config: RegisterRoutesConfig | undefined,
16
+ event: StripeWebhookEvent,
17
+ ): Promise<void> {
18
+ if (config?.onEvent) {
19
+ try {
20
+ await config.onEvent(ctx, event);
21
+ } catch (error) {
22
+ console.error(
23
+ `[better-stripe] onEvent hook error for ${event.type}:`,
24
+ error,
25
+ );
26
+ }
27
+ }
28
+
29
+ const handler = config?.events?.[event.type];
30
+ if (handler) {
31
+ try {
32
+ await handler(ctx, event);
33
+ } catch (error) {
34
+ console.error(
35
+ `[better-stripe] Event hook error for ${event.type}:`,
36
+ error,
37
+ );
38
+ }
39
+ }
40
+ }
41
+
42
+ // =============================================================================
43
+ // ASYNC HOOK SCHEDULER
44
+ // =============================================================================
45
+
46
+ type HookSpec = {
47
+ hook: AsyncHookName;
48
+ /** Component query path used to fetch the committed doc. */
49
+ getter: string;
50
+ /** Argument name the getter expects the Stripe object id under. */
51
+ idArg: string;
52
+ };
53
+
54
+ /** V1 event type → async hook + component query to fetch the committed doc. */
55
+ const HOOK_EVENT_MAP: Record<string, HookSpec> = {
56
+ "checkout.session.completed": {
57
+ hook: "afterCheckoutCompleted",
58
+ getter: "billing/queries/getCheckoutSessionByStripeId",
59
+ idArg: "stripeSessionId",
60
+ },
61
+ "customer.subscription.created": {
62
+ hook: "afterSubscriptionUpdated",
63
+ getter: "billing/queries/getSubscriptionByStripeId",
64
+ idArg: "stripeSubscriptionId",
65
+ },
66
+ "customer.subscription.updated": {
67
+ hook: "afterSubscriptionUpdated",
68
+ getter: "billing/queries/getSubscriptionByStripeId",
69
+ idArg: "stripeSubscriptionId",
70
+ },
71
+ "customer.subscription.deleted": {
72
+ hook: "afterSubscriptionCanceled",
73
+ getter: "billing/queries/getSubscriptionByStripeId",
74
+ idArg: "stripeSubscriptionId",
75
+ },
76
+ "customer.subscription.trial_will_end": {
77
+ hook: "afterTrialEnding",
78
+ getter: "billing/queries/getSubscriptionByStripeId",
79
+ idArg: "stripeSubscriptionId",
80
+ },
81
+ "invoice.paid": {
82
+ hook: "afterInvoicePaid",
83
+ getter: "billing/queries/getInvoiceByStripeId",
84
+ idArg: "stripeInvoiceId",
85
+ },
86
+ // BTS-33: a failed subscription-cycle charge. Distinct from the PI-level
87
+ // `payment_intent.payment_failed` (afterPaymentFailed) — this is the invoice
88
+ // that dunning acts on, carrying the smart-retry schedule on the doc.
89
+ "invoice.payment_failed": {
90
+ hook: "afterInvoicePaymentFailed",
91
+ getter: "billing/queries/getInvoiceByStripeId",
92
+ idArg: "stripeInvoiceId",
93
+ },
94
+ "payment_intent.succeeded": {
95
+ hook: "afterPaymentSucceeded",
96
+ getter: "connect/queries/getPaymentByStripeId",
97
+ idArg: "stripePaymentIntentId",
98
+ },
99
+ "payment_intent.payment_failed": {
100
+ hook: "afterPaymentFailed",
101
+ getter: "connect/queries/getPaymentByStripeId",
102
+ idArg: "stripePaymentIntentId",
103
+ },
104
+ "payout.paid": {
105
+ hook: "afterPayoutCompleted",
106
+ getter: "connect/queries/getPayoutByStripeId",
107
+ idArg: "stripePayoutId",
108
+ },
109
+ "refund.created": {
110
+ hook: "afterRefundCreated",
111
+ getter: "connect/queries/getRefundByStripeId",
112
+ idArg: "stripeRefundId",
113
+ },
114
+ "charge.dispute.created": {
115
+ hook: "afterDisputeCreated",
116
+ getter: "connect/queries/getDisputeByStripeId",
117
+ idArg: "stripeDisputeId",
118
+ },
119
+ "charge.dispute.closed": {
120
+ hook: "afterDisputeClosed",
121
+ getter: "connect/queries/getDisputeByStripeId",
122
+ idArg: "stripeDisputeId",
123
+ },
124
+ };
125
+
126
+ /**
127
+ * All `v2.core.account*` events (account, account_person, account_link)
128
+ * resolve to the connected account, so they all schedule afterAccountUpdated.
129
+ */
130
+ const V2_ACCOUNT_HOOK: HookSpec = {
131
+ hook: "afterAccountUpdated",
132
+ getter: "core/queries/getAccountByStripeId",
133
+ idArg: "stripeAccountId",
134
+ };
135
+
136
+ /**
137
+ * Schedule the app's async hook for this event, if configured.
138
+ * Each event maps to at most one hook, so at most one function is scheduled.
139
+ * Runs after the component write committed and the ledger row is marked
140
+ * processed — failures are logged, never thrown.
141
+ */
142
+ export async function scheduleAsyncHook(
143
+ whCtx: WebhookContext,
144
+ eventType: string,
145
+ stripeObjectId: string | null | undefined,
146
+ ): Promise<void> {
147
+ const spec = eventType.startsWith("v2.core.account")
148
+ ? V2_ACCOUNT_HOOK
149
+ : HOOK_EVENT_MAP[eventType];
150
+ if (!spec || !stripeObjectId) return;
151
+
152
+ const refs = whCtx.config?.webhooks;
153
+ if (!refs) return;
154
+
155
+ const scheduler = whCtx.ctx.scheduler;
156
+ if (!scheduler) {
157
+ console.warn(
158
+ `[better-stripe] Async hook ${spec.hook} configured but ctx.scheduler unavailable — hook skipped`,
159
+ );
160
+ return;
161
+ }
162
+
163
+ try {
164
+ const doc = (await whCtx.ctx.runQuery(
165
+ componentRef(whCtx.component, spec.getter),
166
+ { [spec.idArg]: stripeObjectId },
167
+ )) as Record<string, unknown> | null;
168
+ if (doc) {
169
+ await scheduler.runAfter(0, refs.asyncWebhook, { hook: spec.hook, doc });
170
+ }
171
+ } catch (error) {
172
+ console.error(
173
+ `[better-stripe] Failed to schedule async hook for ${eventType}:`,
174
+ error,
175
+ );
176
+ }
177
+ }
@@ -0,0 +1,51 @@
1
+ import { httpActionGeneric } from "convex/server";
2
+ import type { HttpRouter } from "convex/server";
3
+
4
+ import type { Component } from "../helpers.js";
5
+ import type { RegisterRoutesConfig, WebhookActionCtx } from "../types.js";
6
+ import { handleWebhookRequest } from "./handler.js";
7
+
8
+ // Re-export sub-modules for direct access
9
+ export { handleWebhookRequest } from "./handler.js";
10
+ export { runHooks } from "./hooks.js";
11
+ export { processEvent } from "./processors.js";
12
+ export { handleV2Event, verifyV2Event } from "./v2.js";
13
+
14
+ // =============================================================================
15
+ // WEBHOOK REGISTRATION
16
+ // =============================================================================
17
+
18
+ /**
19
+ * Register Stripe webhook HTTP route.
20
+ * Standalone function following @convex-dev/stripe convention.
21
+ *
22
+ * Usage:
23
+ * ```typescript
24
+ * import { registerRoutes } from '@fantastic.dev/better-stripe';
25
+ * registerRoutes(http, components.betterStripe, {
26
+ * webhookPath: '/stripe/webhook',
27
+ * stripeSecretKey: process.env.STRIPE_SECRET_KEY,
28
+ * webhookSecret: process.env.STRIPE_WEBHOOK_SECRET,
29
+ * });
30
+ * ```
31
+ */
32
+ export function registerRoutes(
33
+ http: HttpRouter,
34
+ component: Component,
35
+ config?: RegisterRoutesConfig,
36
+ ) {
37
+ const path = config?.webhookPath ?? "/stripe/webhook";
38
+
39
+ http.route({
40
+ path,
41
+ method: "POST",
42
+ handler: httpActionGeneric(async (ctx, request) => {
43
+ return handleWebhookRequest(
44
+ ctx as WebhookActionCtx,
45
+ request,
46
+ component,
47
+ config,
48
+ );
49
+ }),
50
+ });
51
+ }