@stripe/stripe-js 4.2.0 → 4.3.0

package/dist/api/payment-methods.d.mts

@@ -150,6 +150,21 @@ export namespace PaymentMethod {
      */
     last4: string;
 
+    /**
+     * Contains information about card networks that can be used to process the payment.
+     */
+    networks: {
+      /**
+       * The preferred network for co-branded cards.
+       */
+      preferred: string | null;
+
+      /**
+       * All available networks for the card.
+       */
+      available: string[];
+    } | null;
+
     /**
      * Contains details on how this Card maybe be used for 3D Secure authentication.
      */

package/dist/api/payment-methods.d.ts

@@ -150,6 +150,21 @@ export namespace PaymentMethod {
      */
     last4: string;
 
+    /**
+     * Contains information about card networks that can be used to process the payment.
+     */
+    networks: {
+      /**
+       * The preferred network for co-branded cards.
+       */
+      preferred: string | null;
+
+      /**
+       * All available networks for the card.
+       */
+      available: string[];
+    } | null;
+
     /**
      * Contains details on how this Card maybe be used for 3D Secure authentication.
      */

package/dist/index.js

@@ -42,7 +42,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.1.0",
+    version: "4.2.0",
     startTime: startTime
   });
 };

package/dist/index.mjs

@@ -38,7 +38,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.1.0",
+    version: "4.2.0",
     startTime: startTime
   });
 };

package/dist/pure.js

@@ -58,7 +58,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.1.0",
+    version: "4.2.0",
     startTime: startTime
   });
 };

package/dist/pure.mjs

@@ -54,7 +54,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.1.0",
+    version: "4.2.0",
     startTime: startTime
   });
 };

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

@@ -259,3 +259,7 @@ export interface StripeAddressElementChangeEvent {
     phone?: string;
   };
 }
+
+export interface StripeAddressElementGetElementOptions {
+  mode: AddressMode;
+}

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

@@ -259,3 +259,7 @@ export interface StripeAddressElementChangeEvent {
     phone?: string;
   };
 }
+
+export interface StripeAddressElementGetElementOptions {
+  mode: AddressMode;
+}

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

@@ -47,6 +47,7 @@ import {
   StripeIssuingCardCopyButtonElementOptions,
   StripeExpressCheckoutElement,
   StripeExpressCheckoutElementOptions,
+  StripeAddressElementGetElementOptions,
 } from './elements';
 import {StripeError} from './stripe';
 
@@ -84,7 +85,10 @@ export interface StripeElements {
   /**
    * Looks up a previously created `Element` by its type.
    */
-  getElement(elementType: 'address'): StripeAddressElement | null;
+  getElement(
+    elementType: 'address',
+    options?: StripeAddressElementGetElementOptions
+  ): StripeAddressElement | null;
 
   /////////////////////////////
   /// paymentMethodMessaging

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

@@ -47,6 +47,7 @@ import {
   StripeIssuingCardCopyButtonElementOptions,
   StripeExpressCheckoutElement,
   StripeExpressCheckoutElementOptions,
+  StripeAddressElementGetElementOptions,
 } from './elements';
 import {StripeError} from './stripe';
 
@@ -84,7 +85,10 @@ export interface StripeElements {
   /**
    * Looks up a previously created `Element` by its type.
    */
-  getElement(elementType: 'address'): StripeAddressElement | null;
+  getElement(
+    elementType: 'address',
+    options?: StripeAddressElementGetElementOptions
+  ): StripeAddressElement | null;
 
   /////////////////////////////
   /// paymentMethodMessaging

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

@@ -1,3 +1,26 @@
+export type StripeEmbeddedCheckoutAddress = {
+  country: string;
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  postal_code?: string | null;
+  state?: string | null;
+};
+
+export type StripeEmbeddedCheckoutShippingDetails = {
+  name: string;
+  address: StripeEmbeddedCheckoutAddress;
+};
+
+export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
+  checkoutSessionId: string;
+  shippingDetails: StripeEmbeddedCheckoutShippingDetails;
+};
+
+export type ResultAction =
+  | {type: 'accept'}
+  | {type: 'reject'; errorMessage?: string};
+
 export interface StripeEmbeddedCheckoutOptions {
   /**
    * The client secret of the [Checkout Session](https://stripe.com/docs/api/checkout/sessions).
@@ -13,6 +36,15 @@ export interface StripeEmbeddedCheckoutOptions {
    * You can use it to unmount Embedded Checkout and render a custom success UI.
    */
   onComplete?: () => void;
+  /**
+   * onShippingDetailsChange is called when the customer completes the shipping details form.
+   *
+   * The callback is required when [permissions.update.shipping_details](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-shipping_details) is set to `server_only`.
+   * For a step-by-step guide on using this callback to customize shipping options during checkout, see [Customize Shipping Options](https://docs.stripe.com/payments/checkout/custom-shipping-options).
+   */
+  onShippingDetailsChange?: (
+    event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

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

@@ -1,3 +1,26 @@
+export type StripeEmbeddedCheckoutAddress = {
+  country: string;
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  postal_code?: string | null;
+  state?: string | null;
+};
+
+export type StripeEmbeddedCheckoutShippingDetails = {
+  name: string;
+  address: StripeEmbeddedCheckoutAddress;
+};
+
+export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
+  checkoutSessionId: string;
+  shippingDetails: StripeEmbeddedCheckoutShippingDetails;
+};
+
+export type ResultAction =
+  | {type: 'accept'}
+  | {type: 'reject'; errorMessage?: string};
+
 export interface StripeEmbeddedCheckoutOptions {
   /**
    * The client secret of the [Checkout Session](https://stripe.com/docs/api/checkout/sessions).
@@ -13,6 +36,15 @@ export interface StripeEmbeddedCheckoutOptions {
    * You can use it to unmount Embedded Checkout and render a custom success UI.
    */
   onComplete?: () => void;
+  /**
+   * onShippingDetailsChange is called when the customer completes the shipping details form.
+   *
+   * The callback is required when [permissions.update.shipping_details](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-shipping_details) is set to `server_only`.
+   * For a step-by-step guide on using this callback to customize shipping options during checkout, see [Customize Shipping Options](https://docs.stripe.com/payments/checkout/custom-shipping-options).
+   */
+  onShippingDetailsChange?: (
+    event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

package/package.json

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