@stripe/stripe-js 1.31.0 → 1.34.0

package/dist/pure.esm.js

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

package/dist/pure.js

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

package/dist/stripe.esm.js

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

package/dist/stripe.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-js",
-  "version": "1.31.0",
+  "version": "1.34.0",
   "description": "Stripe.js loading utility",
   "main": "dist/stripe.js",
   "module": "dist/stripe.esm.js",

package/types/api/financial-connections.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The Financial Connections Session object
+ */
+export interface FinancialConnectionsSession {
+  /**
+   * Unique identifier for the object.
+   */
+  id: string;
+
+  /**
+   * List of accounts collected by the Session
+   */
+  accounts: FinancialConnectionsSession.Account[];
+
+  /**
+   * Filters applied to the Session
+   */
+  filters?: FinancialConnectionsSession.Filters;
+
+  /**
+   * List of data permissions requested in the Session
+   */
+  permissions?: FinancialConnectionsSession.Permission[];
+
+  /**
+   * For webview integrations only. The user will be redirected to this URL to return to your app.
+   */
+  return_url?: string;
+}
+
+export namespace FinancialConnectionsSession {
+  /**
+   * The Financial Connections Account object
+   */
+  export interface Account {
+    /**
+     * Unique identifier for the object.
+     */
+    id: string;
+
+    /**
+     * String representing the object's type. `'linked_account'` is present for backwards-compatibility.
+     */
+    object: 'linked_account' | 'financial_connections.account';
+
+    /**
+     * The type of the account.
+     */
+    category: string;
+
+    /**
+     * A human-readable name that has been assigned to this account, either by the account holder or by the institution.
+     */
+    display_name: string;
+
+    /**
+     * The name of the institution that holds this account.
+     */
+    institution_name: string;
+
+    /**
+     * The last 4 digits of the account number. If present, this will be 4 numeric characters.
+     */
+    last4: string | null;
+  }
+
+  /**
+   * Filters to restrict the kinds of accounts to collect.
+   */
+  export interface Filters {
+    /**
+     * List of countries from which to collect accounts.
+     */
+    countries?: string[];
+  }
+
+  /**
+   * Data features to which access can be requested
+   */
+  export type Permission =
+    | 'payment_method'
+    | 'balances'
+    | 'transactions'
+    | 'ownership'
+    | 'account_numbers';
+}

package/types/api/index.d.ts

@@ -8,3 +8,4 @@ export * from './tokens';
 export * from './bank-accounts';
 export * from './cards';
 export * from './verification-sessions';
+export * from './financial-connections';

package/types/stripe-js/elements/link-authentication.d.ts

@@ -1,4 +1,5 @@
 import {StripeElementBase, StripeElementChangeEvent} from './base';
+import {StripeError} from '../stripe';
 
 export type StripeLinkAuthenticationElement = StripeElementBase & {
   /**
@@ -80,6 +81,47 @@ export type StripeLinkAuthenticationElement = StripeElementBase & {
     eventType: 'escape',
     handler?: (event: {elementType: 'linkAuthentication'}) => any
   ): StripeLinkAuthenticationElement;
+
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'linkAuthentication';
+      error: StripeError;
+    }) => any
+  ): StripeLinkAuthenticationElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'linkAuthentication';
+      error: StripeError;
+    }) => any
+  ): StripeLinkAuthenticationElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {
+      elementType: 'linkAuthentication';
+      error: StripeError;
+    }) => any
+  ): StripeLinkAuthenticationElement;
+
+  /**
+   * Triggered when the loader UI is mounted to the DOM and ready to be displayed.
+   */
+  on(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'linkAuthentication'}) => any
+  ): StripeLinkAuthenticationElement;
+  once(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'linkAuthentication'}) => any
+  ): StripeLinkAuthenticationElement;
+  off(
+    eventType: 'loaderstart',
+    handler?: (event: {elementType: 'linkAuthentication'}) => any
+  ): StripeLinkAuthenticationElement;
 };
 
 export interface StripeLinkAuthenticationElementOptions {

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

@@ -98,6 +98,22 @@ export type StripePaymentElement = StripeElementBase & {
     handler?: (event: {elementType: 'payment'; error: StripeError}) => any
   ): StripePaymentElement;
 
+  /**
+   * Triggered when the loader UI is mounted to the DOM and ready to be displayed.
+   */
+  on(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'payment'}) => any
+  ): StripePaymentElement;
+  once(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'payment'}) => any
+  ): StripePaymentElement;
+  off(
+    eventType: 'loaderstart',
+    handler?: (event: {elementType: 'payment'}) => any
+  ): StripePaymentElement;
+
   /**
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
@@ -110,6 +126,22 @@ export type StripePaymentElement = StripeElementBase & {
   collapse(): StripePaymentElement;
 };
 
+export interface DefaultValuesOption {
+  billingDetails?: {
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: {
+      country?: string;
+      postal_code?: string;
+      state?: string;
+      city?: string;
+      line1?: string;
+      line2?: string;
+    };
+  };
+}
+
 export type FieldOption = 'auto' | 'never';
 
 export interface FieldsOption {
@@ -152,6 +184,11 @@ export interface WalletsOption {
 }
 
 export interface StripePaymentElementOptions {
+  /**
+   * Provide initial customer information that will be displayed in the Payment Element.
+   */
+  defaultValues?: DefaultValuesOption;
+
   /**
    * Override the business name displayed in the Payment Element.
    * By default the PaymentElement will use your Stripe account or business name.

package/types/stripe-js/elements/shipping-address.d.ts

@@ -1,4 +1,5 @@
 import {StripeElementBase, StripeElementChangeEvent} from './base';
+import {StripeError} from '../stripe';
 
 export type StripeShippingAddressElement = StripeElementBase & {
   /**
@@ -80,6 +81,47 @@ export type StripeShippingAddressElement = StripeElementBase & {
     eventType: 'escape',
     handler?: (event: {elementType: 'shippingAddress'}) => any
   ): StripeShippingAddressElement;
+
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'shippingAddress';
+      error: StripeError;
+    }) => any
+  ): StripeShippingAddressElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'shippingAddress';
+      error: StripeError;
+    }) => any
+  ): StripeShippingAddressElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {
+      elementType: 'shippingAddress';
+      error: StripeError;
+    }) => any
+  ): StripeShippingAddressElement;
+
+  /**
+   * Triggered when the loader UI is mounted to the DOM and ready to be displayed.
+   */
+  on(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'shippingAddress'}) => any
+  ): StripeShippingAddressElement;
+  once(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'shippingAddress'}) => any
+  ): StripeShippingAddressElement;
+  off(
+    eventType: 'loaderstart',
+    handler?: (event: {elementType: 'shippingAddress'}) => any
+  ): StripeShippingAddressElement;
 };
 
 export interface StripeShippingAddressElementOptions {
@@ -143,7 +185,7 @@ export interface StripeShippingAddressElementChangeEvent
     name: string;
     address: {
       line1: string;
-      line2: string;
+      line2: string | null;
       city: string;
       state: string;
       postal_code: string;

package/types/stripe-js/financial-connections.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Data to be sent with a `stripe.collectFinancialConnectionsAccounts` request.
+ */
+export interface CollectFinancialConnectionsAccountsOptions {
+  /**
+   * The client secret of the [Financial Connections Session](https://stripe.com/docs/api/financial_connections/session).
+   */
+  clientSecret: string;
+}
+
+/**
+ * Data to be sent with a `stripe.collectBankAccountToken` request.
+ */
+export interface CollectBankAccountTokenOptions {
+  /**
+   * The client secret of the [Financial Connections Session](https://stripe.com/docs/api/financial_connections/session).
+   */
+  clientSecret: string;
+}

package/types/stripe-js/setup-intents.d.ts

@@ -187,6 +187,11 @@ export interface VerifyMicrodepositsForSetupData {
    * An array of two positive integers, in cents, equal to the values of the microdeposits sent to the bank account.
    */
   amounts?: Array<number>;
+
+  /**
+   * A six-character code starting with SM present in the microdeposit sent to the bank account.
+   */
+  descriptor_code?: string;
 }
 
 export interface ConfirmUsBankAccountSetupData

package/types/stripe-js/stripe.d.ts

@@ -4,6 +4,7 @@ import * as setupIntents from './setup-intents';
 import * as orders from './orders';
 import * as tokens from './token-and-sources';
 import * as elements from './elements';
+import * as financialConnections from './financial-connections';
 
 import {StripeElements, StripeElementsOptions} from './elements-group';
 import {RedirectToCheckoutOptions} from './checkout';
@@ -975,6 +976,29 @@ export interface Stripe {
    * * @docs https://stripe.com/docs/js/identity/modal
    */
   verifyIdentity(clientSecret: string): Promise<VerificationSessionResult>;
+
+  /////////////////////////////
+  /// Financial Connections
+  ///
+  /////////////////////////////
+
+  /**
+   * Use `stripe.collectFinancialConnectionsAccounts` to display a [Financial Connections](https://stripe.com/docs/financial-connections) modal that lets you securely collect financial accounts.
+   *
+   * * @docs https://stripe.com/docs/js/financial_connections/collect_financial_connections_accounts
+   */
+  collectFinancialConnectionsAccounts(
+    options: financialConnections.CollectFinancialConnectionsAccountsOptions
+  ): Promise<FinancialConnectionsSessionResult>;
+
+  /**
+   * Use `stripe.collectBankAccountToken` to display a [Financial Connections](https://stripe.com/docs/financial-connections) modal that lets you securely collect a [Bank Account Token](https://stripe.com/docs/api/tokens/object).
+   *
+   * * @docs https://stripe.com/docs/js/financial_connections/collect_bank_account_token
+   */
+  collectBankAccountToken(
+    options: financialConnections.CollectBankAccountTokenOptions
+  ): Promise<CollectBankAccountTokenResult>;
 }
 
 export type PaymentIntentResult =
@@ -1010,6 +1034,25 @@ export type VerificationSessionResult =
   | {verificationSession: api.VerificationSession; error?: undefined}
   | {verificationSession?: undefined; error: StripeError};
 
+export type FinancialConnectionsSessionResult =
+  | {
+      financialConnectionsSession: api.FinancialConnectionsSession;
+      error?: undefined;
+    }
+  | {financialConnectionsSession: undefined; error: StripeError};
+
+export type CollectBankAccountTokenResult =
+  | {
+      financialConnectionsSession: api.FinancialConnectionsSession;
+      token: string;
+      error?: undefined;
+    }
+  | {
+      financialConnectionsSession: undefined;
+      token: undefined;
+      error: StripeError;
+    };
+
 export interface WrapperLibrary {
   /**
    * Your library’s name, maximum length is 30