@stripe/stripe-js 8.6.3 → 8.7.0

package/dist/index.js

@@ -71,7 +71,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "8.6.3",
+    version: "8.7.0",
     startTime: startTime
   });
 };
@@ -172,7 +172,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   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.3", " 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.7.0", " 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

@@ -67,7 +67,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "8.6.3",
+    version: "8.7.0",
     startTime: startTime
   });
 };
@@ -168,7 +168,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   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.3", " 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.7.0", " 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.3",
+    version: "8.7.0",
     startTime: startTime
   });
 };
@@ -172,7 +172,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   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.3", " 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.7.0", " 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.3",
+    version: "8.7.0",
     startTime: startTime
   });
 };
@@ -168,7 +168,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   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.3", " 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.7.0", " 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

@@ -31,14 +31,18 @@ export interface StripeCheckoutElementsOptions {
   loader?: 'auto' | 'always' | 'never';
   fonts?: Array<CssFontSource | CustomFontSource>;
   savedPaymentMethod?: SavedPaymentMethodOption;
+  syncAddressCheckbox?: 'billing' | 'shipping' | 'none';
 }
 
 export interface StripeCheckoutOptions {
   clientSecret: Promise<string> | string;
   elementsOptions?: StripeCheckoutElementsOptions;
+  adaptivePricing?: {allowed?: boolean};
   defaultValues?: {
     billingAddress?: StripeCheckoutContact;
     shippingAddress?: StripeCheckoutContact;
+    email?: string;
+    phoneNumber?: string;
   };
 }
 
@@ -361,6 +365,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 +670,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

@@ -31,14 +31,18 @@ export interface StripeCheckoutElementsOptions {
   loader?: 'auto' | 'always' | 'never';
   fonts?: Array<CssFontSource | CustomFontSource>;
   savedPaymentMethod?: SavedPaymentMethodOption;
+  syncAddressCheckbox?: 'billing' | 'shipping' | 'none';
 }
 
 export interface StripeCheckoutOptions {
   clientSecret: Promise<string> | string;
   elementsOptions?: StripeCheckoutElementsOptions;
+  adaptivePricing?: {allowed?: boolean};
   defaultValues?: {
     billingAddress?: StripeCheckoutContact;
     shippingAddress?: StripeCheckoutContact;
+    email?: string;
+    phoneNumber?: string;
   };
 }
 
@@ -361,6 +365,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 +670,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,114 @@
 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?: {
+      name: string;
+      address: PaymentFormAddress;
+    };
+    billingAddress?: {
+      name: string;
+      address: 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 +127,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 +190,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,114 @@
 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?: {
+      name: string;
+      address: PaymentFormAddress;
+    };
+    billingAddress?: {
+      name: string;
+      address: 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 +127,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 +190,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/package.json

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