@stripe/stripe-js 8.6.1 → 8.6.4

package/dist/index.js

@@ -2,6 +2,22 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+function _typeof(obj) {
+  "@babel/helpers - typeof";
+
+  if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") {
+    _typeof = function (obj) {
+      return typeof obj;
+    };
+  } else {
+    _typeof = function (obj) {
+      return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
+    };
+  }
+
+  return _typeof(obj);
+}
+
 var RELEASE_TRAIN = 'clover';
 
 var runtimeVersionToUrlVersion = function runtimeVersionToUrlVersion(version) {
@@ -55,7 +71,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "8.6.1",
+    version: "8.6.4",
     startTime: startTime
   });
 };
@@ -145,13 +161,18 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   }
 
   var pk = args[0];
+
+  if (typeof pk !== 'string') {
+    throw new Error("Expected publishable key to be of type string, got type ".concat(_typeof(pk), " instead."));
+  }
+
   var isTestKey = pk.match(/^pk_test/); // @ts-expect-error this is not publicly typed
 
   var version = runtimeVersionToUrlVersion(maybeStripe.version);
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.4", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/index.mjs

@@ -1,3 +1,19 @@
+function _typeof(obj) {
+  "@babel/helpers - typeof";
+
+  if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") {
+    _typeof = function (obj) {
+      return typeof obj;
+    };
+  } else {
+    _typeof = function (obj) {
+      return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
+    };
+  }
+
+  return _typeof(obj);
+}
+
 var RELEASE_TRAIN = 'clover';
 
 var runtimeVersionToUrlVersion = function runtimeVersionToUrlVersion(version) {
@@ -51,7 +67,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "8.6.1",
+    version: "8.6.4",
     startTime: startTime
   });
 };
@@ -141,13 +157,18 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   }
 
   var pk = args[0];
+
+  if (typeof pk !== 'string') {
+    throw new Error("Expected publishable key to be of type string, got type ".concat(_typeof(pk), " instead."));
+  }
+
   var isTestKey = pk.match(/^pk_test/); // @ts-expect-error this is not publicly typed
 
   var version = runtimeVersionToUrlVersion(maybeStripe.version);
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.4", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/pure.js

@@ -71,7 +71,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "8.6.1",
+    version: "8.6.4",
     startTime: startTime
   });
 };
@@ -161,13 +161,18 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   }
 
   var pk = args[0];
+
+  if (typeof pk !== 'string') {
+    throw new Error("Expected publishable key to be of type string, got type ".concat(_typeof(pk), " instead."));
+  }
+
   var isTestKey = pk.match(/^pk_test/); // @ts-expect-error this is not publicly typed
 
   var version = runtimeVersionToUrlVersion(maybeStripe.version);
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.4", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/pure.mjs

@@ -67,7 +67,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "8.6.1",
+    version: "8.6.4",
     startTime: startTime
   });
 };
@@ -157,13 +157,18 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   }
 
   var pk = args[0];
+
+  if (typeof pk !== 'string') {
+    throw new Error("Expected publishable key to be of type string, got type ".concat(_typeof(pk), " instead."));
+  }
+
   var isTestKey = pk.match(/^pk_test/); // @ts-expect-error this is not publicly typed
 
   var version = runtimeVersionToUrlVersion(maybeStripe.version);
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("8.6.4", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/stripe-js/checkout.d.mts

@@ -36,9 +36,12 @@ export interface StripeCheckoutElementsOptions {
 export interface StripeCheckoutOptions {
   clientSecret: Promise<string> | string;
   elementsOptions?: StripeCheckoutElementsOptions;
+  adaptivePricing?: {allowed?: boolean};
   defaultValues?: {
     billingAddress?: StripeCheckoutContact;
     shippingAddress?: StripeCheckoutContact;
+    email?: string;
+    phoneNumber?: string;
   };
 }
 
@@ -361,6 +364,38 @@ export type StripeCheckoutAddressElementOptions = {
   };
 };
 
+/**
+ * Wallet button theme options for PaymentFormElement.
+ */
+export type PaymentFormWalletButtonTheme = {
+  applePay?: 'black' | 'white' | 'white-outline';
+  googlePay?: 'black' | 'white';
+  paypal?: 'gold' | 'blue' | 'silver' | 'white' | 'black';
+  klarna?: 'dark' | 'light' | 'outlined';
+};
+
+export type StripeCheckoutPaymentFormElementOptions = {
+  /**
+   * The layout of the PaymentFormElement.
+   */
+  layout?: 'expanded' | 'compact';
+
+  /**
+   * An array of saved addresses to display in the PaymentFormElement.
+   */
+  contacts?: ContactOption[];
+
+  /**
+   * Wallet configuration options.
+   */
+  wallets?: {
+    /**
+     * Button theme options for wallet payment methods.
+     */
+    buttonTheme?: PaymentFormWalletButtonTheme;
+  };
+};
+
 export type StripeCheckoutExpressCheckoutElementOptions = {
   buttonHeight: StripeExpressCheckoutElementOptions['buttonHeight'];
   buttonTheme: StripeExpressCheckoutElementOptions['buttonTheme'];
@@ -634,7 +669,9 @@ export interface StripeCheckout {
     options?: StripeCheckoutPaymentElementOptions
   ): StripePaymentElement;
   /* Requires beta access: Contact [Stripe support](https://support.stripe.com/) for more information. */
-  createPaymentFormElement(): StripePaymentFormElement;
+  createPaymentFormElement(
+    options?: StripeCheckoutPaymentFormElementOptions
+  ): StripePaymentFormElement;
   createBillingAddressElement(
     options?: StripeCheckoutAddressElementOptions
   ): StripeAddressElement;

package/dist/stripe-js/checkout.d.ts

@@ -36,9 +36,12 @@ export interface StripeCheckoutElementsOptions {
 export interface StripeCheckoutOptions {
   clientSecret: Promise<string> | string;
   elementsOptions?: StripeCheckoutElementsOptions;
+  adaptivePricing?: {allowed?: boolean};
   defaultValues?: {
     billingAddress?: StripeCheckoutContact;
     shippingAddress?: StripeCheckoutContact;
+    email?: string;
+    phoneNumber?: string;
   };
 }
 
@@ -361,6 +364,38 @@ export type StripeCheckoutAddressElementOptions = {
   };
 };
 
+/**
+ * Wallet button theme options for PaymentFormElement.
+ */
+export type PaymentFormWalletButtonTheme = {
+  applePay?: 'black' | 'white' | 'white-outline';
+  googlePay?: 'black' | 'white';
+  paypal?: 'gold' | 'blue' | 'silver' | 'white' | 'black';
+  klarna?: 'dark' | 'light' | 'outlined';
+};
+
+export type StripeCheckoutPaymentFormElementOptions = {
+  /**
+   * The layout of the PaymentFormElement.
+   */
+  layout?: 'expanded' | 'compact';
+
+  /**
+   * An array of saved addresses to display in the PaymentFormElement.
+   */
+  contacts?: ContactOption[];
+
+  /**
+   * Wallet configuration options.
+   */
+  wallets?: {
+    /**
+     * Button theme options for wallet payment methods.
+     */
+    buttonTheme?: PaymentFormWalletButtonTheme;
+  };
+};
+
 export type StripeCheckoutExpressCheckoutElementOptions = {
   buttonHeight: StripeExpressCheckoutElementOptions['buttonHeight'];
   buttonTheme: StripeExpressCheckoutElementOptions['buttonTheme'];
@@ -634,7 +669,9 @@ export interface StripeCheckout {
     options?: StripeCheckoutPaymentElementOptions
   ): StripePaymentElement;
   /* Requires beta access: Contact [Stripe support](https://support.stripe.com/) for more information. */
-  createPaymentFormElement(): StripePaymentFormElement;
+  createPaymentFormElement(
+    options?: StripeCheckoutPaymentFormElementOptions
+  ): StripePaymentFormElement;
   createBillingAddressElement(
     options?: StripeCheckoutAddressElementOptions
   ): StripeAddressElement;

package/dist/stripe-js/elements/index.d.mts

@@ -16,4 +16,3 @@ export * from './payment';
 export * from './shipping-address';
 export * from './issuing';
 export * from './tax-id';
-export * from './payment-form';

package/dist/stripe-js/elements/index.d.ts

@@ -16,4 +16,3 @@ export * from './payment';
 export * from './shipping-address';
 export * from './issuing';
 export * from './tax-id';
-export * from './payment-form';

package/dist/stripe-js/elements/payment-form.d.mts

@@ -1,5 +1,108 @@
 import {StripeError} from '../stripe';
 import {StripeElementBase} from './base';
+import {StripeExpressCheckoutElementConfirmEvent} from './express-checkout';
+
+/**
+ * Address type used in PaymentFormElement change events.
+ */
+export type PaymentFormAddress = {
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  state?: string | null;
+  postal_code?: string | null;
+  country?: string | null;
+};
+
+/**
+ * The change event payload for the PaymentFormElement.
+ */
+export interface StripePaymentFormElementChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'paymentForm';
+
+  /**
+   * Whether all required fields in the PaymentFormElement are complete.
+   */
+  complete: boolean;
+
+  /**
+   * Whether the PaymentFormElement is currently empty.
+   */
+  empty: boolean;
+
+  /**
+   * An object containing the current form values.
+   */
+  value: {
+    customerDetails: {
+      email: string;
+    };
+    shippingOption?: {
+      id: string;
+      displayName: string;
+      amount: string;
+    };
+    shippingAddress?: PaymentFormAddress;
+    billingAddress?: PaymentFormAddress;
+    tax?: {
+      businessName: string;
+      taxId: string;
+      taxIdType: string;
+      externalTaxIdType: string;
+    };
+    customFields?: Record<string, string | number>;
+    payment?: {
+      collapsed: boolean;
+      type: string;
+      country?: string | null;
+      billingDetails?: {
+        address?: {
+          country?: string;
+          postal_code?: string;
+        };
+      } | null;
+      payment_method?: {
+        id: string;
+        type: string;
+        billing_details: {
+          address: PaymentFormAddress;
+          name: string | null;
+          email: string | null;
+          phone: string | null;
+        };
+      } | null;
+      savePaymentMethod?: boolean;
+    };
+  };
+}
+
+/**
+ * Confirm event when user completes via Express Checkout (Apple Pay, Google Pay, etc.)
+ */
+interface StripePaymentFormExpressCheckoutConfirmEvent
+  extends StripeExpressCheckoutElementConfirmEvent {
+  source: 'payment-form-ece';
+}
+
+/**
+ * Confirm event when user clicks the Pay button.
+ * paymentMethodType is the selected payment method (e.g., 'card', 'sepa_debit')
+ * or null if payment collection is not needed.
+ */
+interface StripePaymentFormPayButtonConfirmEvent {
+  source: 'payment-form-pay-button';
+  paymentMethodType: string | null;
+}
+
+/**
+ * The confirm event payload for the PaymentFormElement.
+ */
+export type StripePaymentFormElementConfirmEvent =
+  | StripePaymentFormExpressCheckoutConfirmEvent
+  | StripePaymentFormPayButtonConfirmEvent;
 
 export type StripePaymentFormElement = StripeElementBase & {
   /**
@@ -18,6 +121,54 @@ export type StripePaymentFormElement = StripeElementBase & {
     handler?: (event: {elementType: 'paymentForm'}) => any
   ): StripePaymentFormElement;
 
+  /**
+   * Triggered when the element gains focus.
+   */
+  on(
+    eventType: 'focus',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'focus',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'focus',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the element loses focus.
+   */
+  on(
+    eventType: 'blur',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'blur',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'blur',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the escape key is pressed within the element.
+   */
+  on(
+    eventType: 'escape',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'escape',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'escape',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
   /**
    * Triggered when the element fails to load.
    */
@@ -33,4 +184,57 @@ export type StripePaymentFormElement = StripeElementBase & {
     eventType: 'loaderror',
     handler?: (event: {elementType: 'paymentForm'; error: StripeError}) => any
   ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the element's value changes.
+   */
+  on(
+    eventType: 'change',
+    handler: (event: StripePaymentFormElementChangeEvent) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'change',
+    handler: (event: StripePaymentFormElementChangeEvent) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'change',
+    handler?: (event: StripePaymentFormElementChangeEvent) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when a buyer authorizes a payment within a supported payment method.
+   */
+  on(
+    eventType: 'confirm',
+    handler: (event: StripePaymentFormElementConfirmEvent) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'confirm',
+    handler: (event: StripePaymentFormElementConfirmEvent) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'confirm',
+    handler?: (event: StripePaymentFormElementConfirmEvent) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the payment interface is dismissed (e.g., a buyer closes the payment interface).
+   */
+  on(
+    eventType: 'cancel',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'cancel',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'cancel',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Retrieves the current form values from the PaymentFormElement.
+   */
+  getValue(): Promise<StripePaymentFormElementChangeEvent>;
 };

package/dist/stripe-js/elements/payment-form.d.ts

@@ -1,5 +1,108 @@
 import {StripeError} from '../stripe';
 import {StripeElementBase} from './base';
+import {StripeExpressCheckoutElementConfirmEvent} from './express-checkout';
+
+/**
+ * Address type used in PaymentFormElement change events.
+ */
+export type PaymentFormAddress = {
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  state?: string | null;
+  postal_code?: string | null;
+  country?: string | null;
+};
+
+/**
+ * The change event payload for the PaymentFormElement.
+ */
+export interface StripePaymentFormElementChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'paymentForm';
+
+  /**
+   * Whether all required fields in the PaymentFormElement are complete.
+   */
+  complete: boolean;
+
+  /**
+   * Whether the PaymentFormElement is currently empty.
+   */
+  empty: boolean;
+
+  /**
+   * An object containing the current form values.
+   */
+  value: {
+    customerDetails: {
+      email: string;
+    };
+    shippingOption?: {
+      id: string;
+      displayName: string;
+      amount: string;
+    };
+    shippingAddress?: PaymentFormAddress;
+    billingAddress?: PaymentFormAddress;
+    tax?: {
+      businessName: string;
+      taxId: string;
+      taxIdType: string;
+      externalTaxIdType: string;
+    };
+    customFields?: Record<string, string | number>;
+    payment?: {
+      collapsed: boolean;
+      type: string;
+      country?: string | null;
+      billingDetails?: {
+        address?: {
+          country?: string;
+          postal_code?: string;
+        };
+      } | null;
+      payment_method?: {
+        id: string;
+        type: string;
+        billing_details: {
+          address: PaymentFormAddress;
+          name: string | null;
+          email: string | null;
+          phone: string | null;
+        };
+      } | null;
+      savePaymentMethod?: boolean;
+    };
+  };
+}
+
+/**
+ * Confirm event when user completes via Express Checkout (Apple Pay, Google Pay, etc.)
+ */
+interface StripePaymentFormExpressCheckoutConfirmEvent
+  extends StripeExpressCheckoutElementConfirmEvent {
+  source: 'payment-form-ece';
+}
+
+/**
+ * Confirm event when user clicks the Pay button.
+ * paymentMethodType is the selected payment method (e.g., 'card', 'sepa_debit')
+ * or null if payment collection is not needed.
+ */
+interface StripePaymentFormPayButtonConfirmEvent {
+  source: 'payment-form-pay-button';
+  paymentMethodType: string | null;
+}
+
+/**
+ * The confirm event payload for the PaymentFormElement.
+ */
+export type StripePaymentFormElementConfirmEvent =
+  | StripePaymentFormExpressCheckoutConfirmEvent
+  | StripePaymentFormPayButtonConfirmEvent;
 
 export type StripePaymentFormElement = StripeElementBase & {
   /**
@@ -18,6 +121,54 @@ export type StripePaymentFormElement = StripeElementBase & {
     handler?: (event: {elementType: 'paymentForm'}) => any
   ): StripePaymentFormElement;
 
+  /**
+   * Triggered when the element gains focus.
+   */
+  on(
+    eventType: 'focus',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'focus',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'focus',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the element loses focus.
+   */
+  on(
+    eventType: 'blur',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'blur',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'blur',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the escape key is pressed within the element.
+   */
+  on(
+    eventType: 'escape',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'escape',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'escape',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
   /**
    * Triggered when the element fails to load.
    */
@@ -33,4 +184,57 @@ export type StripePaymentFormElement = StripeElementBase & {
     eventType: 'loaderror',
     handler?: (event: {elementType: 'paymentForm'; error: StripeError}) => any
   ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the element's value changes.
+   */
+  on(
+    eventType: 'change',
+    handler: (event: StripePaymentFormElementChangeEvent) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'change',
+    handler: (event: StripePaymentFormElementChangeEvent) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'change',
+    handler?: (event: StripePaymentFormElementChangeEvent) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when a buyer authorizes a payment within a supported payment method.
+   */
+  on(
+    eventType: 'confirm',
+    handler: (event: StripePaymentFormElementConfirmEvent) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'confirm',
+    handler: (event: StripePaymentFormElementConfirmEvent) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'confirm',
+    handler?: (event: StripePaymentFormElementConfirmEvent) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Triggered when the payment interface is dismissed (e.g., a buyer closes the payment interface).
+   */
+  on(
+    eventType: 'cancel',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  once(
+    eventType: 'cancel',
+    handler: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+  off(
+    eventType: 'cancel',
+    handler?: (event: {elementType: 'paymentForm'}) => any
+  ): StripePaymentFormElement;
+
+  /**
+   * Retrieves the current form values from the PaymentFormElement.
+   */
+  getValue(): Promise<StripePaymentFormElementChangeEvent>;
 };

package/dist/stripe-js/elements-group.d.mts

@@ -715,6 +715,13 @@ interface BaseStripeElementsOptions {
    * @docs https://docs.stripe.com/js/elements_object/create#stripe_elements-options-syncAddressCheckbox
    */
   syncAddressCheckbox?: 'billing' | 'shipping' | 'none';
+
+  /**
+   * Allows PaymentMethods to be created from the Elements instance.
+   *
+   * @docs https://docs.stripe.com/js/elements_object/create#stripe_elements-options-paymentMethodCreation
+   */
+  paymentMethodCreation?: 'manual';
 }
 
 export interface StripeElementsOptionsClientSecret
@@ -827,11 +834,6 @@ interface StripeElementsOptionsModeBase extends BaseStripeElementsOptions {
    */
   payment_method_configuration?: string;
 
-  /**
-   * Allows PaymentMethods to be created from the Elements instance.
-   */
-  paymentMethodCreation?: 'manual';
-
   /**
    * Additional payment-method-specific options for configuring Payment Element behavior.
    *

package/dist/stripe-js/elements-group.d.ts

@@ -715,6 +715,13 @@ interface BaseStripeElementsOptions {
    * @docs https://docs.stripe.com/js/elements_object/create#stripe_elements-options-syncAddressCheckbox
    */
   syncAddressCheckbox?: 'billing' | 'shipping' | 'none';
+
+  /**
+   * Allows PaymentMethods to be created from the Elements instance.
+   *
+   * @docs https://docs.stripe.com/js/elements_object/create#stripe_elements-options-paymentMethodCreation
+   */
+  paymentMethodCreation?: 'manual';
 }
 
 export interface StripeElementsOptionsClientSecret
@@ -827,11 +834,6 @@ interface StripeElementsOptionsModeBase extends BaseStripeElementsOptions {
    */
   payment_method_configuration?: string;
 
-  /**
-   * Allows PaymentMethods to be created from the Elements instance.
-   */
-  paymentMethodCreation?: 'manual';
-
   /**
    * Additional payment-method-specific options for configuring Payment Element behavior.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-js",
-  "version": "8.6.1",
+  "version": "8.6.4",
   "description": "Stripe.js loading utility",
   "repository": "github:stripe/stripe-js",
   "main": "lib/index.js",

package/src/shared.ts

@@ -169,6 +169,13 @@ export const initStripe = (
   }
 
   const pk = args[0];
+
+  if (typeof pk !== 'string') {
+    throw new Error(
+      `Expected publishable key to be of type string, got type ${typeof pk} instead.`
+    );
+  }
+
   const isTestKey = pk.match(/^pk_test/);
 
   // @ts-expect-error this is not publicly typed