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