stripe 22.2.0-alpha.2 → 22.2.0-alpha.4

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 22.2.0-alpha.4 - 2026-05-06
+* [#2699](https://github.com/stripe/stripe-node/pull/2699) Update generated code for private-preview
+  * Add support for new resource `PaymentLocation`
+  * Add support for `create`, `del`, `retrieve`, and `update` methods on resource `PaymentLocation`
+  * Add support for `protections` on `AccountCreateParams.capabilities.card_payments`, `AccountUpdateParams.capabilities.card_payments`, and `Capability`
+  * Add support for `gift_card` on `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.testHelpers.payment_method_data`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, and `SharedPayment.GrantedToken.payment_method_details`
+  * Add support for new value `gift_card` on enums `ConfirmationTokenCreateParams.testHelpers.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+  * ⚠️ Add support for new value `gift_card` on enums `ConfirmationToken.payment_method_preview.type`, `PaymentMethod.type`, and `SharedPayment.GrantedToken.payment_method_details.type`
+  * Add support for new value `gift_card` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+  * Add support for `metadata` on `DelegatedCheckout.RequestedSessionConfirmParams`
+  * Add support for `credited_items` on `InvoiceItem.proration_details`
+  * Add support for `network_lifecycle` on `Issuing.Dispute`
+  * Add support for new value `gift_card` on enums `PaymentIntentConfirmParams.excluded_payment_method_types`, `PaymentIntentCreateParams.excluded_payment_method_types`, `PaymentIntentUpdateParams.excluded_payment_method_types`, `SetupIntentCreateParams.excluded_payment_method_types`, and `SetupIntentUpdateParams.excluded_payment_method_types`
+  * ⚠️ Add support for new value `gift_card` on enums `PaymentIntent.excluded_payment_method_types` and `SetupIntent.excluded_payment_method_types`
+  * Add support for `status_details` on `Subscription`
+* [#2702](https://github.com/stripe/stripe-node/pull/2702) Add EventNotificationHandler (private preview)
+
+## 22.2.0-alpha.3 - 2026-04-28
+* [#2696](https://github.com/stripe/stripe-node/pull/2696) Update generated code for private-preview
+  * Add support for `debit_card` on `V2.Core.Account.configuration.card_creator.capabilities.consumer.lead`, `V2.Core.Account.identity.attestations.terms_of_service.card_creator.consumer.lead`, `V2.Core.AccountCreateParams.configuration.card_creator.capabilities.consumer.lead`, `V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.consumer.lead`, `V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.consumer.lead`, and `V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.consumer.lead`
+  * ⚠️ Add support for new value `consumer.lead.debit_card` on enums `V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability` and `V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability`
+  * ⚠️ Add support for new value `consumer.lead.debit_card` on enum `EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability`
+
 ## 22.2.0-alpha.2 - 2026-04-28
 * [#2695](https://github.com/stripe/stripe-node/pull/2695) Update generated code for private-preview
   * Add support for new resource `V2.Data.Analytics.MetricQueryResult`

package/OPENAPI_VERSION

@@ -1 +1 @@
-v2254
+v2256

package/README.md

@@ -3,7 +3,6 @@
 [![Version](https://img.shields.io/npm/v/stripe.svg)](https://www.npmjs.org/package/stripe)
 [![Build Status](https://github.com/stripe/stripe-node/actions/workflows/main.yml/badge.svg?branch=master)](https://github.com/stripe/stripe-node/actions?query=branch%3Amaster)
 [![Downloads](https://img.shields.io/npm/dm/stripe.svg)](https://www.npmjs.com/package/stripe)
-[![Try on RunKit](https://badge.runkitcdn.com/stripe.svg)](https://runkit.com/npm/stripe)
 
 > [!TIP]
 > Want to chat live with Stripe engineers? Join us on our [Discord server](https://stripe.com/go/discord/node).

package/VERSION

@@ -1 +1 @@
-22.2.0-alpha.2
+22.2.0-alpha.4

package/cjs/StripeEventNotificationHandler.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Stripe } from './stripe.core.js';
+import * as Events from './resources/V2/Core/Events.js';
+export interface UnhandledNotificationDetails {
+    isKnownEventType: boolean;
+}
+export type FallbackCallback = (event: Events.UnknownEventNotification, client: Stripe, details: UnhandledNotificationDetails) => Promise<void>;
+export declare class StripeEventNotificationHandler {
+    private client;
+    private webhookSecret;
+    private fallbackCallback;
+    private registeredHandlers;
+    private hasHandledEvent;
+    constructor(client: Stripe, webhookSecret: string, fallbackCallback: FallbackCallback);
+    on<T extends Stripe.V2.Core.EventNotification['type']>(type: T, callback: (event: Extract<Stripe.V2.Core.EventNotification, {
+        type: T;
+    }>, client: Stripe) => Promise<void>): this;
+    registeredEventTypes(): string[];
+    handle(rawBody: string | Buffer, signature: string | Buffer): Promise<void>;
+}

package/cjs/StripeEventNotificationHandler.js

@@ -0,0 +1,464 @@
+"use strict";
+// File copied from our code generator; changes here will be overwritten.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeEventNotificationHandler = void 0;
+// most languages can check if we have an UnknownEventNotification at runtime
+// but JS only has interfaces so we fall back to a string match to determine known events
+const KNOWN_EVENT_TYPES = new Set([
+    // event-types: The beginning of the section generated from our OpenAPI spec
+    'v1.account.application.authorized',
+    'v1.account.application.deauthorized',
+    'v1.account.external_account.created',
+    'v1.account.external_account.deleted',
+    'v1.account.external_account.updated',
+    'v1.account.updated',
+    'v1.account_signals[delinquency].created',
+    'v1.application_fee.created',
+    'v1.application_fee.refund.updated',
+    'v1.application_fee.refunded',
+    'v1.balance.available',
+    'v1.billing.alert.triggered',
+    'v1.billing.meter.error_report_triggered',
+    'v1.billing.meter.no_meter_found',
+    'v1.billing_portal.configuration.created',
+    'v1.billing_portal.configuration.updated',
+    'v1.billing_portal.session.created',
+    'v1.capability.updated',
+    'v1.cash_balance.funds_available',
+    'v1.charge.captured',
+    'v1.charge.dispute.closed',
+    'v1.charge.dispute.created',
+    'v1.charge.dispute.funds_reinstated',
+    'v1.charge.dispute.funds_withdrawn',
+    'v1.charge.dispute.updated',
+    'v1.charge.expired',
+    'v1.charge.failed',
+    'v1.charge.pending',
+    'v1.charge.refund.updated',
+    'v1.charge.refunded',
+    'v1.charge.succeeded',
+    'v1.charge.updated',
+    'v1.checkout.session.async_payment_failed',
+    'v1.checkout.session.async_payment_succeeded',
+    'v1.checkout.session.completed',
+    'v1.checkout.session.expired',
+    'v1.climate.order.canceled',
+    'v1.climate.order.created',
+    'v1.climate.order.delayed',
+    'v1.climate.order.delivered',
+    'v1.climate.order.product_substituted',
+    'v1.climate.product.created',
+    'v1.climate.product.pricing_updated',
+    'v1.coupon.created',
+    'v1.coupon.deleted',
+    'v1.coupon.updated',
+    'v1.credit_note.created',
+    'v1.credit_note.updated',
+    'v1.credit_note.voided',
+    'v1.customer.created',
+    'v1.customer.deleted',
+    'v1.customer.subscription.created',
+    'v1.customer.subscription.deleted',
+    'v1.customer.subscription.paused',
+    'v1.customer.subscription.pending_update_applied',
+    'v1.customer.subscription.pending_update_expired',
+    'v1.customer.subscription.resumed',
+    'v1.customer.subscription.trial_will_end',
+    'v1.customer.subscription.updated',
+    'v1.customer.tax_id.created',
+    'v1.customer.tax_id.deleted',
+    'v1.customer.tax_id.updated',
+    'v1.customer.updated',
+    'v1.customer_cash_balance_transaction.created',
+    'v1.entitlements.active_entitlement_summary.updated',
+    'v1.file.created',
+    'v1.financial_connections.account.created',
+    'v1.financial_connections.account.deactivated',
+    'v1.financial_connections.account.disconnected',
+    'v1.financial_connections.account.reactivated',
+    'v1.financial_connections.account.refreshed_balance',
+    'v1.financial_connections.account.refreshed_ownership',
+    'v1.financial_connections.account.refreshed_transactions',
+    'v1.identity.verification_session.canceled',
+    'v1.identity.verification_session.created',
+    'v1.identity.verification_session.processing',
+    'v1.identity.verification_session.redacted',
+    'v1.identity.verification_session.requires_input',
+    'v1.identity.verification_session.verified',
+    'v1.invoice.created',
+    'v1.invoice.deleted',
+    'v1.invoice.finalization_failed',
+    'v1.invoice.finalized',
+    'v1.invoice.marked_uncollectible',
+    'v1.invoice.overdue',
+    'v1.invoice.overpaid',
+    'v1.invoice.paid',
+    'v1.invoice.payment_action_required',
+    'v1.invoice.payment_failed',
+    'v1.invoice.payment_succeeded',
+    'v1.invoice.sent',
+    'v1.invoice.upcoming',
+    'v1.invoice.updated',
+    'v1.invoice.voided',
+    'v1.invoice.will_be_due',
+    'v1.invoice_payment.paid',
+    'v1.invoiceitem.created',
+    'v1.invoiceitem.deleted',
+    'v1.issuing_authorization.created',
+    'v1.issuing_authorization.request',
+    'v1.issuing_authorization.updated',
+    'v1.issuing_card.created',
+    'v1.issuing_card.updated',
+    'v1.issuing_cardholder.created',
+    'v1.issuing_cardholder.updated',
+    'v1.issuing_dispute.closed',
+    'v1.issuing_dispute.created',
+    'v1.issuing_dispute.funds_reinstated',
+    'v1.issuing_dispute.funds_rescinded',
+    'v1.issuing_dispute.submitted',
+    'v1.issuing_dispute.updated',
+    'v1.issuing_personalization_design.activated',
+    'v1.issuing_personalization_design.deactivated',
+    'v1.issuing_personalization_design.rejected',
+    'v1.issuing_personalization_design.updated',
+    'v1.issuing_token.created',
+    'v1.issuing_token.updated',
+    'v1.issuing_transaction.created',
+    'v1.issuing_transaction.purchase_details_receipt_updated',
+    'v1.issuing_transaction.updated',
+    'v1.mandate.updated',
+    'v1.payment_intent.amount_capturable_updated',
+    'v1.payment_intent.canceled',
+    'v1.payment_intent.created',
+    'v1.payment_intent.partially_funded',
+    'v1.payment_intent.payment_failed',
+    'v1.payment_intent.processing',
+    'v1.payment_intent.requires_action',
+    'v1.payment_intent.succeeded',
+    'v1.payment_link.created',
+    'v1.payment_link.updated',
+    'v1.payment_method.attached',
+    'v1.payment_method.automatically_updated',
+    'v1.payment_method.detached',
+    'v1.payment_method.updated',
+    'v1.payout.canceled',
+    'v1.payout.created',
+    'v1.payout.failed',
+    'v1.payout.paid',
+    'v1.payout.reconciliation_completed',
+    'v1.payout.updated',
+    'v1.person.created',
+    'v1.person.deleted',
+    'v1.person.updated',
+    'v1.plan.created',
+    'v1.plan.deleted',
+    'v1.plan.updated',
+    'v1.price.created',
+    'v1.price.deleted',
+    'v1.price.updated',
+    'v1.product.created',
+    'v1.product.deleted',
+    'v1.product.updated',
+    'v1.promotion_code.created',
+    'v1.promotion_code.updated',
+    'v1.quote.accepted',
+    'v1.quote.canceled',
+    'v1.quote.created',
+    'v1.quote.finalized',
+    'v1.radar.early_fraud_warning.created',
+    'v1.radar.early_fraud_warning.updated',
+    'v1.refund.created',
+    'v1.refund.failed',
+    'v1.refund.updated',
+    'v1.review.closed',
+    'v1.review.opened',
+    'v1.setup_intent.canceled',
+    'v1.setup_intent.created',
+    'v1.setup_intent.requires_action',
+    'v1.setup_intent.setup_failed',
+    'v1.setup_intent.succeeded',
+    'v1.sigma.scheduled_query_run.created',
+    'v1.source.canceled',
+    'v1.source.chargeable',
+    'v1.source.failed',
+    'v1.source.refund_attributes_required',
+    'v1.subscription_schedule.aborted',
+    'v1.subscription_schedule.canceled',
+    'v1.subscription_schedule.completed',
+    'v1.subscription_schedule.created',
+    'v1.subscription_schedule.expiring',
+    'v1.subscription_schedule.released',
+    'v1.subscription_schedule.updated',
+    'v1.tax.settings.updated',
+    'v1.tax_rate.created',
+    'v1.tax_rate.updated',
+    'v1.terminal.reader.action_failed',
+    'v1.terminal.reader.action_succeeded',
+    'v1.terminal.reader.action_updated',
+    'v1.test_helpers.test_clock.advancing',
+    'v1.test_helpers.test_clock.created',
+    'v1.test_helpers.test_clock.deleted',
+    'v1.test_helpers.test_clock.internal_failure',
+    'v1.test_helpers.test_clock.ready',
+    'v1.topup.canceled',
+    'v1.topup.created',
+    'v1.topup.failed',
+    'v1.topup.reversed',
+    'v1.topup.succeeded',
+    'v1.transfer.created',
+    'v1.transfer.reversed',
+    'v1.transfer.updated',
+    'v2.billing.cadence.billed',
+    'v2.billing.cadence.canceled',
+    'v2.billing.cadence.created',
+    'v2.billing.license_fee.created',
+    'v2.billing.license_fee.updated',
+    'v2.billing.license_fee_version.created',
+    'v2.billing.licensed_item.created',
+    'v2.billing.licensed_item.updated',
+    'v2.billing.metered_item.created',
+    'v2.billing.metered_item.updated',
+    'v2.billing.pricing_plan.created',
+    'v2.billing.pricing_plan.updated',
+    'v2.billing.pricing_plan_component.created',
+    'v2.billing.pricing_plan_component.updated',
+    'v2.billing.pricing_plan_subscription.collection_awaiting_customer_action',
+    'v2.billing.pricing_plan_subscription.collection_current',
+    'v2.billing.pricing_plan_subscription.collection_past_due',
+    'v2.billing.pricing_plan_subscription.collection_paused',
+    'v2.billing.pricing_plan_subscription.collection_unpaid',
+    'v2.billing.pricing_plan_subscription.servicing_activated',
+    'v2.billing.pricing_plan_subscription.servicing_canceled',
+    'v2.billing.pricing_plan_subscription.servicing_paused',
+    'v2.billing.pricing_plan_version.created',
+    'v2.billing.rate_card.created',
+    'v2.billing.rate_card.updated',
+    'v2.billing.rate_card_custom_pricing_unit_overage_rate.created',
+    'v2.billing.rate_card_rate.created',
+    'v2.billing.rate_card_subscription.activated',
+    'v2.billing.rate_card_subscription.canceled',
+    'v2.billing.rate_card_subscription.collection_awaiting_customer_action',
+    'v2.billing.rate_card_subscription.collection_current',
+    'v2.billing.rate_card_subscription.collection_past_due',
+    'v2.billing.rate_card_subscription.collection_paused',
+    'v2.billing.rate_card_subscription.collection_unpaid',
+    'v2.billing.rate_card_subscription.servicing_activated',
+    'v2.billing.rate_card_subscription.servicing_canceled',
+    'v2.billing.rate_card_subscription.servicing_paused',
+    'v2.billing.rate_card_version.created',
+    'v2.commerce.product_catalog.imports.failed',
+    'v2.commerce.product_catalog.imports.processing',
+    'v2.commerce.product_catalog.imports.succeeded',
+    'v2.commerce.product_catalog.imports.succeeded_with_errors',
+    'v2.core.account.closed',
+    'v2.core.account.created',
+    'v2.core.account.updated',
+    'v2.core.account[configuration.card_creator].capability_status_updated',
+    'v2.core.account[configuration.card_creator].updated',
+    'v2.core.account[configuration.customer].capability_status_updated',
+    'v2.core.account[configuration.customer].updated',
+    'v2.core.account[configuration.merchant].capability_status_updated',
+    'v2.core.account[configuration.merchant].updated',
+    'v2.core.account[configuration.recipient].capability_status_updated',
+    'v2.core.account[configuration.recipient].updated',
+    'v2.core.account[configuration.storer].capability_status_updated',
+    'v2.core.account[configuration.storer].updated',
+    'v2.core.account[defaults].updated',
+    'v2.core.account[future_requirements].updated',
+    'v2.core.account[identity].updated',
+    'v2.core.account[requirements].updated',
+    'v2.core.account_link.returned',
+    'v2.core.account_person.created',
+    'v2.core.account_person.deleted',
+    'v2.core.account_person.updated',
+    'v2.core.account_signals.fraudulent_website_ready',
+    'v2.core.approval_request.approved',
+    'v2.core.approval_request.canceled',
+    'v2.core.approval_request.created',
+    'v2.core.approval_request.expired',
+    'v2.core.approval_request.failed',
+    'v2.core.approval_request.rejected',
+    'v2.core.approval_request.succeeded',
+    'v2.core.batch_job.batch_failed',
+    'v2.core.batch_job.canceled',
+    'v2.core.batch_job.completed',
+    'v2.core.batch_job.created',
+    'v2.core.batch_job.ready_for_upload',
+    'v2.core.batch_job.timeout',
+    'v2.core.batch_job.updated',
+    'v2.core.batch_job.upload_timeout',
+    'v2.core.batch_job.validating',
+    'v2.core.batch_job.validation_failed',
+    'v2.core.claimable_sandbox.claimed',
+    'v2.core.claimable_sandbox.created',
+    'v2.core.claimable_sandbox.expired',
+    'v2.core.claimable_sandbox.expiring',
+    'v2.core.claimable_sandbox.updated',
+    'v2.core.event_destination.ping',
+    'v2.core.health.api_error.firing',
+    'v2.core.health.api_error.resolved',
+    'v2.core.health.api_latency.firing',
+    'v2.core.health.api_latency.resolved',
+    'v2.core.health.authorization_rate_drop.firing',
+    'v2.core.health.authorization_rate_drop.resolved',
+    'v2.core.health.event_generation_failure.resolved',
+    'v2.core.health.fraud_rate.increased',
+    'v2.core.health.issuing_authorization_request_errors.firing',
+    'v2.core.health.issuing_authorization_request_errors.resolved',
+    'v2.core.health.issuing_authorization_request_timeout.firing',
+    'v2.core.health.issuing_authorization_request_timeout.resolved',
+    'v2.core.health.meter_event_summaries_delayed.firing',
+    'v2.core.health.meter_event_summaries_delayed.resolved',
+    'v2.core.health.payment_method_error.firing',
+    'v2.core.health.payment_method_error.resolved',
+    'v2.core.health.sepa_debit_delayed.firing',
+    'v2.core.health.sepa_debit_delayed.resolved',
+    'v2.core.health.traffic_volume_drop.firing',
+    'v2.core.health.traffic_volume_drop.resolved',
+    'v2.core.health.webhook_latency.firing',
+    'v2.core.health.webhook_latency.resolved',
+    'v2.data.reporting.query_run.created',
+    'v2.data.reporting.query_run.failed',
+    'v2.data.reporting.query_run.succeeded',
+    'v2.data.reporting.query_run.updated',
+    'v2.extend.extension_run.failed',
+    'v2.extend.workflow_run.failed',
+    'v2.extend.workflow_run.started',
+    'v2.extend.workflow_run.succeeded',
+    'v2.iam.api_key.created',
+    'v2.iam.api_key.default_secret_revealed',
+    'v2.iam.api_key.expired',
+    'v2.iam.api_key.permissions_updated',
+    'v2.iam.api_key.rotated',
+    'v2.iam.api_key.updated',
+    'v2.iam.stripe_access_grant.approved',
+    'v2.iam.stripe_access_grant.canceled',
+    'v2.iam.stripe_access_grant.denied',
+    'v2.iam.stripe_access_grant.removed',
+    'v2.iam.stripe_access_grant.requested',
+    'v2.iam.stripe_access_grant.updated',
+    'v2.money_management.adjustment.created',
+    'v2.money_management.financial_account.created',
+    'v2.money_management.financial_account.updated',
+    'v2.money_management.financial_address.activated',
+    'v2.money_management.financial_address.failed',
+    'v2.money_management.inbound_transfer.available',
+    'v2.money_management.inbound_transfer.bank_debit_failed',
+    'v2.money_management.inbound_transfer.bank_debit_processing',
+    'v2.money_management.inbound_transfer.bank_debit_queued',
+    'v2.money_management.inbound_transfer.bank_debit_returned',
+    'v2.money_management.inbound_transfer.bank_debit_succeeded',
+    'v2.money_management.outbound_payment.canceled',
+    'v2.money_management.outbound_payment.created',
+    'v2.money_management.outbound_payment.failed',
+    'v2.money_management.outbound_payment.posted',
+    'v2.money_management.outbound_payment.returned',
+    'v2.money_management.outbound_payment.updated',
+    'v2.money_management.outbound_transfer.canceled',
+    'v2.money_management.outbound_transfer.created',
+    'v2.money_management.outbound_transfer.failed',
+    'v2.money_management.outbound_transfer.posted',
+    'v2.money_management.outbound_transfer.returned',
+    'v2.money_management.outbound_transfer.updated',
+    'v2.money_management.payout_method.created',
+    'v2.money_management.payout_method.updated',
+    'v2.money_management.received_credit.available',
+    'v2.money_management.received_credit.failed',
+    'v2.money_management.received_credit.returned',
+    'v2.money_management.received_credit.succeeded',
+    'v2.money_management.received_debit.canceled',
+    'v2.money_management.received_debit.failed',
+    'v2.money_management.received_debit.pending',
+    'v2.money_management.received_debit.succeeded',
+    'v2.money_management.received_debit.updated',
+    'v2.money_management.recipient_verification.created',
+    'v2.money_management.recipient_verification.updated',
+    'v2.money_management.transaction.created',
+    'v2.money_management.transaction.updated',
+    'v2.orchestrated_commerce.agreement.confirmed',
+    'v2.orchestrated_commerce.agreement.created',
+    'v2.orchestrated_commerce.agreement.partially_confirmed',
+    'v2.orchestrated_commerce.agreement.terminated',
+    'v2.payments.off_session_payment.attempt_failed',
+    'v2.payments.off_session_payment.attempt_started',
+    'v2.payments.off_session_payment.authorization_attempt_failed',
+    'v2.payments.off_session_payment.authorization_attempt_started',
+    'v2.payments.off_session_payment.canceled',
+    'v2.payments.off_session_payment.created',
+    'v2.payments.off_session_payment.failed',
+    'v2.payments.off_session_payment.paused',
+    'v2.payments.off_session_payment.requires_capture',
+    'v2.payments.off_session_payment.resumed',
+    'v2.payments.off_session_payment.succeeded',
+    'v2.payments.settlement_allocation_intent.canceled',
+    'v2.payments.settlement_allocation_intent.created',
+    'v2.payments.settlement_allocation_intent.errored',
+    'v2.payments.settlement_allocation_intent.funds_not_received',
+    'v2.payments.settlement_allocation_intent.matched',
+    'v2.payments.settlement_allocation_intent.not_found',
+    'v2.payments.settlement_allocation_intent.settled',
+    'v2.payments.settlement_allocation_intent.submitted',
+    'v2.payments.settlement_allocation_intent_split.canceled',
+    'v2.payments.settlement_allocation_intent_split.created',
+    'v2.payments.settlement_allocation_intent_split.settled',
+    'v2.reporting.report_run.created',
+    'v2.reporting.report_run.failed',
+    'v2.reporting.report_run.succeeded',
+    'v2.reporting.report_run.updated',
+    'v2.signals.account_signal.fraudulent_merchant_ready',
+    // event-types: The end of the section generated from our OpenAPI spec
+]);
+class StripeEventNotificationHandler {
+    // eslint-disable-next-line no-useless-constructor
+    constructor(client, webhookSecret, fallbackCallback) {
+        this.client = client;
+        this.webhookSecret = webhookSecret;
+        this.fallbackCallback = fallbackCallback;
+        this.registeredHandlers = {};
+        this.hasHandledEvent = false;
+    }
+    on(type, callback) {
+        if (this.hasHandledEvent) {
+            throw new Error('Cannot register new handlers after an event has been handled. This is indicative of a bug.');
+        }
+        // the matched types are validated by the type system
+        if (this.registeredHandlers[type]) {
+            throw new Error(`Handler already registered for event type: ${type}`);
+        }
+        this.registeredHandlers[type] = callback;
+        return this;
+    }
+    registeredEventTypes() {
+        const keys = Object.keys(this.registeredHandlers);
+        keys.sort();
+        return keys;
+    }
+    async handle(
+    // these types are duplicated in the manual types, so they're just here for internal use
+    rawBody, signature) {
+        // we're not worried about thread safety here because we expect callbacks will be registered synchronously on app startup
+        this.hasHandledEvent = true;
+        const event = this.client.parseEventNotification(rawBody, signature, this.webhookSecret);
+        // Create a new client with the event's context instead of modifying the shared client
+        // This ensures thread-safety when processing webhooks in parallel
+        // We create a shallow copy and override _api with a new object containing the event context
+        // This reuses expensive resources like httpClient (Flyweight pattern)
+        const eventClient = Object.create(Object.getPrototypeOf(this.client));
+        Object.assign(eventClient, this.client);
+        eventClient._api = {
+            ...this.client._api,
+            stripeContext: event.context,
+        };
+        const handler = this.registeredHandlers[event.type];
+        if (handler) {
+            return await handler(event, eventClient);
+        }
+        else {
+            return await this.fallbackCallback(event, eventClient, {
+                isKnownEventType: KNOWN_EVENT_TYPES.has(event.type),
+            });
+        }
+    }
+}
+exports.StripeEventNotificationHandler = StripeEventNotificationHandler;
+//# sourceMappingURL=StripeEventNotificationHandler.js.map

package/cjs/StripeEventNotificationHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeEventNotificationHandler.js","sourceRoot":"","sources":["../src/StripeEventNotificationHandler.ts"],"names":[],"mappings":"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"}

package/cjs/resources/Accounts.d.ts

@@ -2424,6 +2424,10 @@ export declare namespace AccountCreateParams {
             requested?: boolean;
         }
         interface CardPayments {
+            /**
+             * Protections to apply to this capability.
+             */
+            protections?: CardPayments.Protections;
             /**
              * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
              */
@@ -2795,6 +2799,22 @@ export declare namespace AccountCreateParams {
              */
             requested?: boolean;
         }
+        namespace CardPayments {
+            interface Protections {
+                /**
+                 * Protection for connected accounts migrating from another PSP.
+                 */
+                psp_migration: Protections.PspMigration;
+            }
+            namespace Protections {
+                interface PspMigration {
+                    /**
+                     * Passing true requests the protection.
+                     */
+                    requested: boolean;
+                }
+            }
+        }
     }
     namespace Company {
         interface DirectorshipDeclaration {
@@ -4332,6 +4352,10 @@ export declare namespace AccountUpdateParams {
             requested?: boolean;
         }
         interface CardPayments {
+            /**
+             * Protections to apply to this capability.
+             */
+            protections?: CardPayments.Protections;
             /**
              * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
              */
@@ -4703,6 +4727,22 @@ export declare namespace AccountUpdateParams {
              */
             requested?: boolean;
         }
+        namespace CardPayments {
+            interface Protections {
+                /**
+                 * Protection for connected accounts migrating from another PSP.
+                 */
+                psp_migration: Protections.PspMigration;
+            }
+            namespace Protections {
+                interface PspMigration {
+                    /**
+                     * Passing true requests the protection.
+                     */
+                    requested: boolean;
+                }
+            }
+        }
     }
     namespace Company {
         interface DirectorshipDeclaration {