@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,268 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
SplitRecipient,
|
|
3
|
+
SplitRecipientRole,
|
|
4
|
+
} from "../../component/lib/fees.js";
|
|
5
|
+
import type {
|
|
6
|
+
FeeOverride,
|
|
7
|
+
FeeTier,
|
|
8
|
+
PlatformFeeConfig,
|
|
9
|
+
} from "../types/options.js";
|
|
10
|
+
|
|
11
|
+
function assert(condition: boolean, message: string): void {
|
|
12
|
+
if (!condition) {
|
|
13
|
+
throw new Error(`Invalid platformFee config: ${message}`);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
function validatePercent(percent: number, ctx: string): void {
|
|
18
|
+
assert(
|
|
19
|
+
Number.isFinite(percent) && percent >= 0 && percent <= 100,
|
|
20
|
+
`${ctx} percent must be a number between 0 and 100 (got ${percent})`,
|
|
21
|
+
);
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
function validateFixed(fixed: number | undefined, ctx: string): void {
|
|
25
|
+
if (fixed !== undefined) {
|
|
26
|
+
assert(
|
|
27
|
+
Number.isInteger(fixed) && fixed >= 0,
|
|
28
|
+
`${ctx} fixed must be a non-negative integer in minor units (got ${fixed})`,
|
|
29
|
+
);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Validate a {@link PlatformFeeConfig} at construction time. Throws on:
|
|
35
|
+
* percent out of 0–100, negative fixed, or a tier schedule that is empty,
|
|
36
|
+
* out of range, non-ascending/overlapping, or has a non-final catch-all.
|
|
37
|
+
*/
|
|
38
|
+
export function validatePlatformFee(config: PlatformFeeConfig): void {
|
|
39
|
+
validatePercent(config.percent, "base");
|
|
40
|
+
validateFixed(config.fixed, "base");
|
|
41
|
+
|
|
42
|
+
const { tiers } = config;
|
|
43
|
+
if (tiers !== undefined) {
|
|
44
|
+
assert(tiers.length > 0, "tiers must be non-empty when provided");
|
|
45
|
+
let prevUpper = 0;
|
|
46
|
+
tiers.forEach((tier, i) => {
|
|
47
|
+
validatePercent(tier.percent, `tier ${i}`);
|
|
48
|
+
validateFixed(tier.fixed, `tier ${i}`);
|
|
49
|
+
const isLast = i === tiers.length - 1;
|
|
50
|
+
if (tier.upTo === null) {
|
|
51
|
+
assert(
|
|
52
|
+
isLast,
|
|
53
|
+
"a null upTo (catch-all) is only allowed as the last tier",
|
|
54
|
+
);
|
|
55
|
+
} else {
|
|
56
|
+
assert(
|
|
57
|
+
Number.isInteger(tier.upTo) && tier.upTo > 0,
|
|
58
|
+
`tier ${i} upTo must be a positive integer in minor units or null`,
|
|
59
|
+
);
|
|
60
|
+
assert(
|
|
61
|
+
tier.upTo > prevUpper,
|
|
62
|
+
`tier ${i} upTo must be strictly greater than the previous tier (tiers must be ascending and non-overlapping)`,
|
|
63
|
+
);
|
|
64
|
+
prevUpper = tier.upTo;
|
|
65
|
+
}
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Resolve which fee config applies for a charge. Precedence: per-call override
|
|
72
|
+
* → global default. (Per-product / per-seller sources slot in here later.)
|
|
73
|
+
* Returns `undefined` when no fee is configured at any level.
|
|
74
|
+
*/
|
|
75
|
+
export function resolveFeeConfig(
|
|
76
|
+
defaultConfig?: PlatformFeeConfig,
|
|
77
|
+
override?: FeeOverride,
|
|
78
|
+
): PlatformFeeConfig | undefined {
|
|
79
|
+
const resolved = override ?? defaultConfig;
|
|
80
|
+
// A per-call override bypasses the constructor's validation, so re-validate
|
|
81
|
+
// the effective config here to enforce the same contract everywhere.
|
|
82
|
+
if (resolved !== undefined) {
|
|
83
|
+
validatePlatformFee(resolved);
|
|
84
|
+
}
|
|
85
|
+
return resolved;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* True when a fee is a flat percentage that Stripe's `application_fee_percent`
|
|
90
|
+
* can express directly (no fixed surcharge, no tiers). Percent+fixed/tiered
|
|
91
|
+
* fees must be computed per charge/invoice instead.
|
|
92
|
+
*/
|
|
93
|
+
export function isPercentOnlyFee(config: PlatformFeeConfig): boolean {
|
|
94
|
+
return !config.fixed && (!config.tiers || config.tiers.length === 0);
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/** The platform fee computed for a specific charge amount. */
|
|
98
|
+
export type FeeBreakdown = {
|
|
99
|
+
/** Fee in minor units (never greater than the charge amount). */
|
|
100
|
+
feeAmount: number;
|
|
101
|
+
/** Percentage actually applied (from the matched tier, or the base). */
|
|
102
|
+
percentApplied: number;
|
|
103
|
+
/** Fixed surcharge actually applied, in minor units. */
|
|
104
|
+
fixedApplied: number;
|
|
105
|
+
/** The tier that matched, when a tiered schedule was used. */
|
|
106
|
+
tier?: FeeTier;
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Compute the platform fee for a charge `amount` (minor units) under `config`.
|
|
111
|
+
*
|
|
112
|
+
* - Tiered: picks the first tier whose inclusive `upTo` covers the amount
|
|
113
|
+
* (final `upTo: null` is the catch-all); otherwise uses the base percent/fixed.
|
|
114
|
+
* - `feeAmount = round(amount * percent / 100) + fixed`, **rounded half-up** to
|
|
115
|
+
* whole minor units, and **capped at `amount`** (the fee can never exceed the
|
|
116
|
+
* charge).
|
|
117
|
+
* - Returns a zero fee for non-positive amounts (e.g. a trial with no charge).
|
|
118
|
+
*
|
|
119
|
+
* Assumes `amount` and the config's minor-unit fields share one currency.
|
|
120
|
+
* Validate `config` (see {@link validatePlatformFee}) before calling.
|
|
121
|
+
*/
|
|
122
|
+
export function computeFee(
|
|
123
|
+
amount: number,
|
|
124
|
+
config: PlatformFeeConfig,
|
|
125
|
+
): FeeBreakdown {
|
|
126
|
+
if (!(amount > 0)) {
|
|
127
|
+
return { feeAmount: 0, percentApplied: 0, fixedApplied: 0 };
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
let percent = config.percent;
|
|
131
|
+
let fixed = config.fixed ?? 0;
|
|
132
|
+
let tier: FeeTier | undefined;
|
|
133
|
+
if (config.tiers) {
|
|
134
|
+
tier = config.tiers.find((t) => t.upTo === null || amount <= t.upTo);
|
|
135
|
+
if (tier) {
|
|
136
|
+
percent = tier.percent;
|
|
137
|
+
fixed = tier.fixed ?? 0;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
// Math.round is half-up for the non-negative values we deal with here.
|
|
142
|
+
const percentAmount = Math.round((amount * percent) / 100);
|
|
143
|
+
const feeAmount = Math.min(percentAmount + fixed, amount);
|
|
144
|
+
// When the fee hits the amount cap, only the portion of `fixed` that actually
|
|
145
|
+
// fits is collected, so report the capped surcharge for a consistent breakdown.
|
|
146
|
+
const fixedApplied = Math.max(0, feeAmount - percentAmount);
|
|
147
|
+
|
|
148
|
+
return { feeAmount, percentApplied: percent, fixedApplied, tier };
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/** One leg of a computed split (a Stripe Transfer to create). */
|
|
152
|
+
export type SplitTransfer = {
|
|
153
|
+
destinationAccountId: string;
|
|
154
|
+
role: SplitRecipientRole;
|
|
155
|
+
amount: number;
|
|
156
|
+
};
|
|
157
|
+
|
|
158
|
+
/** Result of splitting a charge across recipients via transfer math (BTS-23). */
|
|
159
|
+
export type SplitResult = {
|
|
160
|
+
transfers: SplitTransfer[];
|
|
161
|
+
/** The platform's configured cut (via the fee resolver). */
|
|
162
|
+
platformFee: number;
|
|
163
|
+
/** What the platform actually keeps = amount − sum(transfers) (≥ platformFee). */
|
|
164
|
+
platformRetained: number;
|
|
165
|
+
};
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Compute a multi-recipient split for the **separate charges & transfers** path.
|
|
169
|
+
*
|
|
170
|
+
* The platform's fee is computed via the resolver ({@link computeFee}); each
|
|
171
|
+
* recipient gets a fixed `amount` (minor units) or a `percent` of the gross
|
|
172
|
+
* `amount`; the platform keeps the remainder. This path **never** uses a Stripe
|
|
173
|
+
* `application_fee` — the cut is realized purely by transferring less than was
|
|
174
|
+
* charged (the result intentionally carries no `applicationFee*` field).
|
|
175
|
+
*
|
|
176
|
+
* Throws if the transfers plus the platform fee would exceed the charge, so the
|
|
177
|
+
* platform is always left with at least its configured cut. Any rounding
|
|
178
|
+
* remainder stays with the platform (deterministic): `sum(transfers) +
|
|
179
|
+
* platformRetained === amount`.
|
|
180
|
+
*/
|
|
181
|
+
export function computeSplit(
|
|
182
|
+
amount: number,
|
|
183
|
+
feeConfig: PlatformFeeConfig | undefined,
|
|
184
|
+
recipients: SplitRecipient[],
|
|
185
|
+
): SplitResult {
|
|
186
|
+
if (!(amount > 0)) {
|
|
187
|
+
return { transfers: [], platformFee: 0, platformRetained: 0 };
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
const platformFee = feeConfig ? computeFee(amount, feeConfig).feeAmount : 0;
|
|
191
|
+
|
|
192
|
+
const transfers: SplitTransfer[] = recipients.map((r) => {
|
|
193
|
+
const amt =
|
|
194
|
+
r.amount !== undefined
|
|
195
|
+
? r.amount
|
|
196
|
+
: r.percent !== undefined
|
|
197
|
+
? Math.round((amount * r.percent) / 100)
|
|
198
|
+
: 0;
|
|
199
|
+
if (!Number.isFinite(amt) || amt < 0) {
|
|
200
|
+
throw new Error(
|
|
201
|
+
`Invalid split amount for ${r.destinationAccountId}: ${amt}`,
|
|
202
|
+
);
|
|
203
|
+
}
|
|
204
|
+
return { destinationAccountId: r.destinationAccountId, role: r.role, amount: amt };
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
const sumTransfers = transfers.reduce((s, t) => s + t.amount, 0);
|
|
208
|
+
if (sumTransfers + platformFee > amount) {
|
|
209
|
+
throw new Error(
|
|
210
|
+
`Split transfers (${sumTransfers}) + platform fee (${platformFee}) exceed the charge amount (${amount}).`,
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
return { transfers, platformFee, platformRetained: amount - sumTransfers };
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Structural validation for a multi-recipient split (BTS-21), independent of the
|
|
219
|
+
* charge amount (which varies per invoice for subscriptions). Throws on: empty
|
|
220
|
+
* split, a recipient missing a destination, a recipient that sets neither or
|
|
221
|
+
* both of amount/percent, out-of-range values, or percents summing over 100.
|
|
222
|
+
* The amount-vs-charge check happens at execution time in {@link computeSplit}.
|
|
223
|
+
*/
|
|
224
|
+
export function validateSplit(recipients: SplitRecipient[]): void {
|
|
225
|
+
if (!Array.isArray(recipients) || recipients.length === 0) {
|
|
226
|
+
throw new Error("split must have at least one recipient");
|
|
227
|
+
}
|
|
228
|
+
let percentSum = 0;
|
|
229
|
+
const seenKeys = new Set<string>();
|
|
230
|
+
for (const r of recipients) {
|
|
231
|
+
if (!r.destinationAccountId) {
|
|
232
|
+
throw new Error("split recipient is missing destinationAccountId");
|
|
233
|
+
}
|
|
234
|
+
// (destinationAccountId, role) is the transfer idempotency key, so duplicate
|
|
235
|
+
// legs would collide/skip in the engine — reject them up front.
|
|
236
|
+
const key = `${r.destinationAccountId}:${r.role}`;
|
|
237
|
+
if (seenKeys.has(key)) {
|
|
238
|
+
throw new Error(
|
|
239
|
+
`duplicate split leg for ${r.destinationAccountId} (role ${r.role}); each destination+role must be unique`,
|
|
240
|
+
);
|
|
241
|
+
}
|
|
242
|
+
seenKeys.add(key);
|
|
243
|
+
const hasAmount = r.amount !== undefined;
|
|
244
|
+
const hasPercent = r.percent !== undefined;
|
|
245
|
+
if (hasAmount === hasPercent) {
|
|
246
|
+
throw new Error(
|
|
247
|
+
`split recipient ${r.destinationAccountId} must set exactly one of amount or percent`,
|
|
248
|
+
);
|
|
249
|
+
}
|
|
250
|
+
if (hasAmount && (!Number.isInteger(r.amount) || (r.amount as number) < 0)) {
|
|
251
|
+
throw new Error(
|
|
252
|
+
`split recipient ${r.destinationAccountId} amount must be a non-negative integer (minor units)`,
|
|
253
|
+
);
|
|
254
|
+
}
|
|
255
|
+
if (hasPercent) {
|
|
256
|
+
const p = r.percent as number;
|
|
257
|
+
if (!Number.isFinite(p) || p < 0 || p > 100) {
|
|
258
|
+
throw new Error(
|
|
259
|
+
`split recipient ${r.destinationAccountId} percent must be between 0 and 100`,
|
|
260
|
+
);
|
|
261
|
+
}
|
|
262
|
+
percentSum += p;
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
if (percentSum > 100) {
|
|
266
|
+
throw new Error(`split percents sum to ${percentSum}, which exceeds 100`);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tests for BetterStripe error utilities — throwStripeError and isBetterStripeError.
|
|
3
|
+
*/
|
|
4
|
+
import { ConvexError } from "convex/values";
|
|
5
|
+
import { describe, expect, it } from "vitest";
|
|
6
|
+
|
|
7
|
+
import { isBetterStripeError, throwStripeError } from "./errors";
|
|
8
|
+
|
|
9
|
+
describe("throwStripeError", () => {
|
|
10
|
+
it("throws ConvexError with code and message", () => {
|
|
11
|
+
expect(() =>
|
|
12
|
+
throwStripeError("ACCOUNT_NOT_FOUND", "Account does not exist"),
|
|
13
|
+
).toThrowError(ConvexError);
|
|
14
|
+
|
|
15
|
+
try {
|
|
16
|
+
throwStripeError("ACCOUNT_NOT_FOUND", "Account does not exist");
|
|
17
|
+
expect.unreachable("should have thrown");
|
|
18
|
+
} catch (error) {
|
|
19
|
+
const data = (error as ConvexError<{ code: string; message: string }>)
|
|
20
|
+
.data;
|
|
21
|
+
expect(data.code).toBe("ACCOUNT_NOT_FOUND");
|
|
22
|
+
expect(data.message).toBe("Account does not exist");
|
|
23
|
+
}
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
it("includes stripeError when provided", () => {
|
|
27
|
+
let caught: unknown;
|
|
28
|
+
try {
|
|
29
|
+
throwStripeError("STRIPE_API_ERROR", "Stripe call failed", {
|
|
30
|
+
type: "card_error",
|
|
31
|
+
code: "card_declined",
|
|
32
|
+
message: "Your card was declined.",
|
|
33
|
+
});
|
|
34
|
+
expect.unreachable("should have thrown");
|
|
35
|
+
} catch (error) {
|
|
36
|
+
caught = error;
|
|
37
|
+
}
|
|
38
|
+
const data = (
|
|
39
|
+
caught as ConvexError<{
|
|
40
|
+
stripeError: { type: string; code: string; message: string };
|
|
41
|
+
}>
|
|
42
|
+
).data;
|
|
43
|
+
expect(data.stripeError).toEqual({
|
|
44
|
+
type: "card_error",
|
|
45
|
+
code: "card_declined",
|
|
46
|
+
message: "Your card was declined.",
|
|
47
|
+
});
|
|
48
|
+
});
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
describe("isBetterStripeError", () => {
|
|
52
|
+
it("returns true for BetterStripe errors", () => {
|
|
53
|
+
let caught: unknown;
|
|
54
|
+
try {
|
|
55
|
+
throwStripeError("PRODUCT_NOT_FOUND", "Missing product");
|
|
56
|
+
expect.unreachable("should have thrown");
|
|
57
|
+
} catch (error) {
|
|
58
|
+
caught = error;
|
|
59
|
+
}
|
|
60
|
+
expect(isBetterStripeError(caught)).toBe(true);
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
it("returns false for regular errors", () => {
|
|
64
|
+
expect(isBetterStripeError(new Error("plain error"))).toBe(false);
|
|
65
|
+
});
|
|
66
|
+
});
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { ConvexError } from "convex/values";
|
|
2
|
+
|
|
3
|
+
export type BetterStripeErrorCode =
|
|
4
|
+
| "ACCOUNT_NOT_FOUND"
|
|
5
|
+
| "ACCOUNT_CREATE_FAILED"
|
|
6
|
+
| "PRODUCT_NOT_FOUND"
|
|
7
|
+
| "PRICE_NOT_FOUND"
|
|
8
|
+
| "SUBSCRIPTION_NOT_FOUND"
|
|
9
|
+
| "SUBSCRIPTION_UPDATE_FAILED"
|
|
10
|
+
| "REFUND_CREATE_FAILED"
|
|
11
|
+
| "REFUND_UNAUTHORIZED"
|
|
12
|
+
| "DISPUTE_UPDATE_FAILED"
|
|
13
|
+
| "DISPUTE_UNAUTHORIZED"
|
|
14
|
+
| "CHECKOUT_CREATE_FAILED"
|
|
15
|
+
| "CHECKOUT_NOT_FOUND"
|
|
16
|
+
| "PAYMENT_METHOD_FAILED"
|
|
17
|
+
| "WEBHOOK_VERIFICATION_FAILED"
|
|
18
|
+
| "WEBHOOK_DUPLICATE_EVENT"
|
|
19
|
+
| "STRIPE_API_ERROR"
|
|
20
|
+
| "TEST_ENV_REQUIRED"
|
|
21
|
+
| "INVALID_CONFIGURATION";
|
|
22
|
+
|
|
23
|
+
export interface BetterStripeError {
|
|
24
|
+
code: BetterStripeErrorCode;
|
|
25
|
+
message: string;
|
|
26
|
+
stripeError?: {
|
|
27
|
+
type: string;
|
|
28
|
+
code?: string;
|
|
29
|
+
message: string;
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Throw a structured ConvexError with a BetterStripe error code.
|
|
35
|
+
* These serialize correctly across Convex action/mutation boundaries.
|
|
36
|
+
*/
|
|
37
|
+
export function throwStripeError(
|
|
38
|
+
code: BetterStripeErrorCode,
|
|
39
|
+
message: string,
|
|
40
|
+
stripeError?: unknown,
|
|
41
|
+
): never {
|
|
42
|
+
const errorData: BetterStripeError = { code, message };
|
|
43
|
+
|
|
44
|
+
if (stripeError && typeof stripeError === "object" && "type" in stripeError) {
|
|
45
|
+
const se = stripeError as { type: string; code?: string; message: string };
|
|
46
|
+
errorData.stripeError = {
|
|
47
|
+
type: se.type,
|
|
48
|
+
code: se.code,
|
|
49
|
+
message: se.message,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
// Cast required: ConvexError constructor expects `Value` (which requires an index signature),
|
|
54
|
+
// but BetterStripeError is a concrete interface without one. The convex package's constructor
|
|
55
|
+
// typing forces this double cast.
|
|
56
|
+
throw new ConvexError(errorData as unknown as string);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Type guard to check if a caught error is a BetterStripeError.
|
|
61
|
+
*/
|
|
62
|
+
export function isBetterStripeError(error: unknown): boolean {
|
|
63
|
+
return (
|
|
64
|
+
error instanceof ConvexError &&
|
|
65
|
+
typeof error.data === "object" &&
|
|
66
|
+
error.data !== null &&
|
|
67
|
+
"code" in error.data &&
|
|
68
|
+
"message" in error.data
|
|
69
|
+
);
|
|
70
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { describe, expect, it, vi } from "vitest";
|
|
2
|
+
|
|
3
|
+
import { STRIPE_API_VERSION } from "./constants.js";
|
|
4
|
+
import { epochToIso, getStripeClient, runMutationOrThrow } from "./helpers.js";
|
|
5
|
+
|
|
6
|
+
describe("STRIPE_API_VERSION", () => {
|
|
7
|
+
it("is a dahlia API version", () => {
|
|
8
|
+
expect(STRIPE_API_VERSION).toMatch(/\.dahlia$/);
|
|
9
|
+
});
|
|
10
|
+
});
|
|
11
|
+
|
|
12
|
+
describe("epochToIso", () => {
|
|
13
|
+
it("converts epoch seconds to ISO string", () => {
|
|
14
|
+
expect(epochToIso(1704067200)).toBe("2024-01-01T00:00:00.000Z");
|
|
15
|
+
});
|
|
16
|
+
|
|
17
|
+
it("returns undefined for null", () => {
|
|
18
|
+
expect(epochToIso(null)).toBeUndefined();
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
it("returns undefined for undefined", () => {
|
|
22
|
+
expect(epochToIso(undefined)).toBeUndefined();
|
|
23
|
+
});
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
describe("getStripeClient", () => {
|
|
27
|
+
it("returns a Stripe instance", () => {
|
|
28
|
+
const client = getStripeClient("sk_test_xxx");
|
|
29
|
+
expect(client).toBeDefined();
|
|
30
|
+
expect(typeof client.checkout).toBe("object");
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
it("caches instances by secret key and API version", () => {
|
|
34
|
+
// Same key and version should return the same cached instance
|
|
35
|
+
const client1 = getStripeClient("sk_test_abc");
|
|
36
|
+
const client2 = getStripeClient("sk_test_abc");
|
|
37
|
+
expect(client1).toBe(client2);
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
it("caches instances separately by API version", () => {
|
|
41
|
+
// Same key but different versions should return different instances
|
|
42
|
+
const client1 = getStripeClient("sk_test_def", "2026-05-27.dahlia");
|
|
43
|
+
const client2 = getStripeClient("sk_test_def", "2026-01-01.dahlia");
|
|
44
|
+
expect(client1).not.toBe(client2);
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
it("caches instances separately by secret key", () => {
|
|
48
|
+
// Different keys should return different instances
|
|
49
|
+
const client1 = getStripeClient("sk_test_key1");
|
|
50
|
+
const client2 = getStripeClient("sk_test_key2");
|
|
51
|
+
expect(client1).not.toBe(client2);
|
|
52
|
+
});
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
describe("runMutationOrThrow", () => {
|
|
56
|
+
it("throws when runMutation is not available", async () => {
|
|
57
|
+
const ctx = { runQuery: vi.fn() };
|
|
58
|
+
const ref = {} as any;
|
|
59
|
+
await expect(runMutationOrThrow(ctx, ref, {})).rejects.toThrow(
|
|
60
|
+
"runMutation",
|
|
61
|
+
);
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
it("calls runMutation and returns result", async () => {
|
|
65
|
+
const ctx = {
|
|
66
|
+
runQuery: vi.fn(),
|
|
67
|
+
runMutation: vi.fn().mockResolvedValue("result"),
|
|
68
|
+
};
|
|
69
|
+
const ref = {} as any;
|
|
70
|
+
const result = await runMutationOrThrow(ctx, ref, { foo: "bar" });
|
|
71
|
+
expect(result).toBe("result");
|
|
72
|
+
expect(ctx.runMutation).toHaveBeenCalledWith(ref, { foo: "bar" });
|
|
73
|
+
});
|
|
74
|
+
});
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
FunctionReference,
|
|
3
|
+
FunctionReturnType,
|
|
4
|
+
OptionalRestArgs,
|
|
5
|
+
} from "convex/server";
|
|
6
|
+
import Stripe from "stripe";
|
|
7
|
+
|
|
8
|
+
import type { ComponentApi } from "../component/_generated/component.js";
|
|
9
|
+
import { STRIPE_API_VERSION } from "./constants.js";
|
|
10
|
+
import type { StripeApiVersion } from "./stripe-types.js";
|
|
11
|
+
|
|
12
|
+
/** The component API type — use this instead of `any` for the component param */
|
|
13
|
+
export type Component = ComponentApi;
|
|
14
|
+
|
|
15
|
+
// =============================================================================
|
|
16
|
+
// RunCtx type — mirrors Convex's GenericActionCtx/GenericMutationCtx shape
|
|
17
|
+
// =============================================================================
|
|
18
|
+
|
|
19
|
+
export type RunCtx = {
|
|
20
|
+
runQuery: <Query extends FunctionReference<"query", "public" | "internal">>(
|
|
21
|
+
query: Query,
|
|
22
|
+
...args: OptionalRestArgs<Query>
|
|
23
|
+
) => Promise<FunctionReturnType<Query>>;
|
|
24
|
+
runMutation?: <
|
|
25
|
+
Mutation extends FunctionReference<"mutation", "public" | "internal">,
|
|
26
|
+
>(
|
|
27
|
+
mutation: Mutation,
|
|
28
|
+
...args: OptionalRestArgs<Mutation>
|
|
29
|
+
) => Promise<FunctionReturnType<Mutation>>;
|
|
30
|
+
};
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Keyed cache for Stripe SDK instances.
|
|
34
|
+
* Safe for tests and mixed environments — different keys get different clients.
|
|
35
|
+
*
|
|
36
|
+
* NOTE: This cache is unbounded and persists for the process lifetime.
|
|
37
|
+
* In practice, a BetterStripe instance typically uses 1 key.
|
|
38
|
+
* API key rotation requires a process restart to pick up new keys.
|
|
39
|
+
*/
|
|
40
|
+
const _clients = new Map<string, Stripe>();
|
|
41
|
+
|
|
42
|
+
export function getStripeClient(
|
|
43
|
+
secretKey: string,
|
|
44
|
+
apiVersion?: string,
|
|
45
|
+
): Stripe {
|
|
46
|
+
const version = (apiVersion as StripeApiVersion) || STRIPE_API_VERSION;
|
|
47
|
+
const cacheKey = `${secretKey}:${version}`;
|
|
48
|
+
let client = _clients.get(cacheKey);
|
|
49
|
+
if (!client) {
|
|
50
|
+
client = new Stripe(secretKey, {
|
|
51
|
+
apiVersion: version,
|
|
52
|
+
});
|
|
53
|
+
_clients.set(cacheKey, client);
|
|
54
|
+
}
|
|
55
|
+
return client;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function epochToIso(
|
|
59
|
+
epoch: number | null | undefined,
|
|
60
|
+
): string | undefined {
|
|
61
|
+
if (epoch == null) return undefined;
|
|
62
|
+
return new Date(epoch * 1000).toISOString();
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* The `bs*` metadata namespace is reserved for better-stripe's internal webhook
|
|
67
|
+
* markers (e.g. `bsChargeType`, `bsSplit`, `bsFeeConfig`, `bsFeeMode`). Strip it
|
|
68
|
+
* from caller-supplied metadata so a caller can't forge instructions that the
|
|
69
|
+
* webhook engine would act on (e.g. trigger split transfers without routing).
|
|
70
|
+
*/
|
|
71
|
+
export function stripReservedMetadata(
|
|
72
|
+
metadata: Record<string, string> | undefined,
|
|
73
|
+
): Record<string, string> {
|
|
74
|
+
if (!metadata) return {};
|
|
75
|
+
return Object.fromEntries(
|
|
76
|
+
Object.entries(metadata).filter(([k]) => !k.startsWith("bs")),
|
|
77
|
+
);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export async function runMutationOrThrow<
|
|
81
|
+
Mutation extends FunctionReference<"mutation", "public" | "internal">,
|
|
82
|
+
>(
|
|
83
|
+
ctx: RunCtx,
|
|
84
|
+
ref: Mutation,
|
|
85
|
+
args: Mutation["_args"],
|
|
86
|
+
): Promise<FunctionReturnType<Mutation>> {
|
|
87
|
+
if (!ctx.runMutation) {
|
|
88
|
+
throw new Error(
|
|
89
|
+
"This BetterStripe method requires a Convex ctx with runMutation.",
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
return (await ctx.runMutation(ref, args)) as FunctionReturnType<Mutation>;
|
|
94
|
+
}
|