@stripe/stripe-js 4.7.0 → 4.8.0

package/dist/index.js

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

package/dist/index.mjs

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

package/dist/pure.js

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

package/dist/pure.mjs

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

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

@@ -116,6 +116,31 @@ export type StripePaymentElement = StripeElementBase & {
     handler?: (event: {elementType: 'payment'}) => any
   ): StripePaymentElement;
 
+  /**
+   * The change event is triggered when the `Element`'s value changes.
+   * Represents the details of a selected Card payment method.
+   */
+  on(
+    eventType: 'carddetailschange',
+    handler: (event: StripePaymentElementCardDetailsChangeEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is updated.
+   */
+  on(
+    eventType: 'savedpaymentmethodupdate',
+    handler: (event: StripePaymentElementSavedPaymentMethodUpdateEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is removed.
+   */
+  on(
+    eventType: 'savedpaymentmethodremove',
+    handler: (event: StripePaymentElementSavedPaymentMethodRemoveEvent) => any
+  ): StripePaymentElement;
+
   /**
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
@@ -158,6 +183,7 @@ export interface FieldsOption {
         phone?: FieldOption;
         address?:
           | FieldOption
+          | 'if_required'
           | {
               country?: FieldOption;
               postalCode?: FieldOption;
@@ -297,3 +323,112 @@ export interface StripePaymentElementChangeEvent {
     };
   };
 }
+
+type CardBrand =
+  | 'amex'
+  | 'diners'
+  | 'discover'
+  | 'eftpos_au'
+  | 'jcb'
+  | 'mastercard'
+  | 'unionpay'
+  | 'visa'
+  | 'unknown';
+type CardFunding = 'credit' | 'debit' | 'prepaid' | 'unknown';
+
+export interface StripePaymentElementCardDetailsChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the card details are loading.
+   */
+  loading: boolean;
+
+  /**
+   * The card details for the selected payment method.
+   * Undefined while loading and for non card payment methods.
+   */
+  details?: {
+    brands: CardBrand[] | null;
+    funding: CardFunding | null;
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodUpdateEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully updated.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method update fails.
+   */
+  error?: string;
+
+  /**
+   * The updated saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodRemoveEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully removed.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method removal fails.
+   */
+  error?: string;
+
+  /**
+   * The removed saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}

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

@@ -116,6 +116,31 @@ export type StripePaymentElement = StripeElementBase & {
     handler?: (event: {elementType: 'payment'}) => any
   ): StripePaymentElement;
 
+  /**
+   * The change event is triggered when the `Element`'s value changes.
+   * Represents the details of a selected Card payment method.
+   */
+  on(
+    eventType: 'carddetailschange',
+    handler: (event: StripePaymentElementCardDetailsChangeEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is updated.
+   */
+  on(
+    eventType: 'savedpaymentmethodupdate',
+    handler: (event: StripePaymentElementSavedPaymentMethodUpdateEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is removed.
+   */
+  on(
+    eventType: 'savedpaymentmethodremove',
+    handler: (event: StripePaymentElementSavedPaymentMethodRemoveEvent) => any
+  ): StripePaymentElement;
+
   /**
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
@@ -158,6 +183,7 @@ export interface FieldsOption {
         phone?: FieldOption;
         address?:
           | FieldOption
+          | 'if_required'
           | {
               country?: FieldOption;
               postalCode?: FieldOption;
@@ -297,3 +323,112 @@ export interface StripePaymentElementChangeEvent {
     };
   };
 }
+
+type CardBrand =
+  | 'amex'
+  | 'diners'
+  | 'discover'
+  | 'eftpos_au'
+  | 'jcb'
+  | 'mastercard'
+  | 'unionpay'
+  | 'visa'
+  | 'unknown';
+type CardFunding = 'credit' | 'debit' | 'prepaid' | 'unknown';
+
+export interface StripePaymentElementCardDetailsChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the card details are loading.
+   */
+  loading: boolean;
+
+  /**
+   * The card details for the selected payment method.
+   * Undefined while loading and for non card payment methods.
+   */
+  details?: {
+    brands: CardBrand[] | null;
+    funding: CardFunding | null;
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodUpdateEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully updated.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method update fails.
+   */
+  error?: string;
+
+  /**
+   * The updated saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodRemoveEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully removed.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method removal fails.
+   */
+  error?: string;
+
+  /**
+   * The removed saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}

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

@@ -17,6 +17,29 @@ export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
   shippingDetails: StripeEmbeddedCheckoutShippingDetails;
 };
 
+export type StripeEmbeddedCheckoutLineItem = {
+  id?: string;
+  quantity?: number;
+  price?: string;
+  display?: {
+    name?: string;
+    description?: string;
+    images?: string[];
+  };
+  pricingSpec?: {
+    unitAmount?: number;
+    unitAmountDecimal?: string;
+    currency?: string;
+    taxBehavior?: 'inclusive' | 'exclusive' | 'unspecified';
+    taxCode?: string;
+  };
+};
+
+export type StripeEmbeddedCheckoutLineItemsChangeEvent = {
+  checkoutSessionId: string;
+  lineItems: StripeEmbeddedCheckoutLineItem[];
+};
+
 export type ResultAction =
   | {type: 'accept'}
   | {type: 'reject'; errorMessage?: string};
@@ -45,6 +68,13 @@ export interface StripeEmbeddedCheckoutOptions {
   onShippingDetailsChange?: (
     event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
   ) => Promise<ResultAction>;
+  /**
+   * onLineItemsChange is called when the customer adds, removes, or modifies a line item.
+   * The callback is required when [permissions.update.line_items](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-line_items) is set to `server_only`.
+   */
+  onLineItemsChange?: (
+    event: StripeEmbeddedCheckoutLineItemsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

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

@@ -17,6 +17,29 @@ export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
   shippingDetails: StripeEmbeddedCheckoutShippingDetails;
 };
 
+export type StripeEmbeddedCheckoutLineItem = {
+  id?: string;
+  quantity?: number;
+  price?: string;
+  display?: {
+    name?: string;
+    description?: string;
+    images?: string[];
+  };
+  pricingSpec?: {
+    unitAmount?: number;
+    unitAmountDecimal?: string;
+    currency?: string;
+    taxBehavior?: 'inclusive' | 'exclusive' | 'unspecified';
+    taxCode?: string;
+  };
+};
+
+export type StripeEmbeddedCheckoutLineItemsChangeEvent = {
+  checkoutSessionId: string;
+  lineItems: StripeEmbeddedCheckoutLineItem[];
+};
+
 export type ResultAction =
   | {type: 'accept'}
   | {type: 'reject'; errorMessage?: string};
@@ -45,6 +68,13 @@ export interface StripeEmbeddedCheckoutOptions {
   onShippingDetailsChange?: (
     event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
   ) => Promise<ResultAction>;
+  /**
+   * onLineItemsChange is called when the customer adds, removes, or modifies a line item.
+   * The callback is required when [permissions.update.line_items](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-line_items) is set to `server_only`.
+   */
+  onLineItemsChange?: (
+    event: StripeEmbeddedCheckoutLineItemsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

package/package.json

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