@stripe/stripe-js 1.35.0 → 1.37.0

package/dist/pure.esm.js

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

package/dist/pure.js

@@ -58,7 +58,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "1.35.0",
+    version: "1.37.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.35.0",
+    version: "1.37.0",
     startTime: startTime
   });
 };

package/dist/stripe.js

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

package/package.json

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

package/types/api/tokens.d.ts

@@ -1,3 +1,4 @@
+import {Omit} from '../utils';
 import {Card} from './cards';
 import {BankAccount} from './bank-accounts';
 import {JapanAddressParam, MetadataParam} from './shared';
@@ -46,6 +47,10 @@ export interface Token {
   used: boolean;
 }
 
+export type BankAccountToken = Omit<Token, 'card'> & {
+  bank_account: BankAccount;
+};
+
 export namespace TokenCreateParams {
   export interface Account {
     /**

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

@@ -0,0 +1,244 @@
+import {StripeElementBase, StripeElementChangeEvent} from './base';
+import {StripeError} from '../stripe';
+
+export type StripeAddressElement = StripeElementBase & {
+  /**
+   * The change event is triggered when the `Element`'s value changes.
+   */
+  on(
+    eventType: 'change',
+    handler: (event: StripeAddressElementChangeEvent) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'change',
+    handler: (event: StripeAddressElementChangeEvent) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'change',
+    handler?: (event: StripeAddressElementChangeEvent) => any
+  ): StripeAddressElement;
+
+  /**
+   * Triggered when the element is fully rendered and can accept `element.focus` calls.
+   */
+  on(
+    eventType: 'ready',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'ready',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'ready',
+    handler?: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+
+  /**
+   * Triggered when the element gains focus.
+   */
+  on(
+    eventType: 'focus',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'focus',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'focus',
+    handler?: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+
+  /**
+   * Triggered when the element loses focus.
+   */
+  on(
+    eventType: 'blur',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'blur',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'blur',
+    handler?: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+
+  /**
+   * Triggered when the escape key is pressed within the element.
+   */
+  on(
+    eventType: 'escape',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'escape',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'escape',
+    handler?: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {elementType: 'address'; error: StripeError}) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {elementType: 'address'; error: StripeError}) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {elementType: 'address'; error: StripeError}) => any
+  ): StripeAddressElement;
+
+  /**
+   * Triggered when the loader UI is mounted to the DOM and ready to be displayed.
+   */
+  on(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  once(
+    eventType: 'loaderstart',
+    handler: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+  off(
+    eventType: 'loaderstart',
+    handler?: (event: {elementType: 'address'}) => any
+  ): StripeAddressElement;
+
+  /**
+   * Updates the options the `AddressElement` was initialized with.
+   * Updates are merged into the existing configuration.
+   */
+  update(options: Partial<StripeAddressElementOptions>): StripeAddressElement;
+};
+
+export interface ContactOption {
+  name: string;
+  phone?: string;
+  address: {
+    line1: string;
+    line2?: string;
+    city: string;
+    state: string;
+    postal_code: string;
+    country: string;
+  };
+}
+
+export type AddressMode = 'shipping' | 'billing';
+
+export interface StripeAddressElementOptions {
+  /**
+   * Control which mode the AddressElement will be used for.
+   */
+  mode: AddressMode;
+
+  /**
+   * An array of two-letter ISO country codes representing which countries
+   * are displayed in the AddressElement.
+   */
+  allowedCountries?: string[] | null;
+
+  /**
+   * Control autocomplete settings in the AddressElement.
+   */
+  autocomplete?:
+    | {mode: 'automatic'}
+    | {mode: 'disabled'}
+    | {mode: 'google_maps_api'; apiKey: string};
+
+  /**
+   * Whether or not AddressElement accepts PO boxes
+   */
+  blockPoBox?: boolean;
+
+  /**
+   * An array of saved addresses.
+   */
+  contacts?: ContactOption[];
+
+  /**
+   * Default value for AddressElement fields
+   */
+  defaultValues?: {
+    name?: string | null;
+    address?: {
+      line1?: string | null;
+      line2?: string | null;
+      city?: string | null;
+      state?: string | null;
+      postal_code?: string | null;
+      country: string;
+    };
+    phone?: string | null;
+  };
+
+  /**
+   * Control which additional fields to display in the AddressElement.
+   */
+  fields?: {
+    phone?: 'always' | 'never' | 'auto';
+  };
+
+  /**
+   * Specify validation rules for the above additional fields.
+   */
+  validation?: {
+    phone?: {
+      required: 'always' | 'never' | 'auto';
+    };
+  };
+}
+
+export interface StripeAddressElementChangeEvent
+  extends StripeElementChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'address';
+
+  /**
+   * The mode of the AddressElement that emitted this event.
+   */
+  elementMode: AddressMode;
+
+  /**
+   * Whether or not the AddressElement is currently empty.
+   */
+  empty: boolean;
+
+  /**
+   * Whether or not the AddressElement is complete.
+   */
+  complete: boolean;
+
+  /**
+   * Whether or not the address is new.
+   */
+  isNewAddress: boolean;
+
+  /**
+   * An object containing the current address.
+   */
+  value: {
+    name: string;
+    address: {
+      line1: string;
+      line2: string | null;
+      city: string;
+      state: string;
+      postal_code: string;
+      country: string;
+    };
+    phone?: string;
+  };
+}

package/types/stripe-js/elements/card-number.d.ts

@@ -86,6 +86,22 @@ export type StripeCardNumberElement = StripeElementBase & {
     handler?: (event: {elementType: 'cardNumber'}) => any
   ): StripeCardNumberElement;
 
+  /**
+   * Triggered when there is a change to the available networks the provided card can run on.
+   */
+  on(
+    eventType: 'networkschange',
+    handler: (event: {elementType: 'cardNumber'}) => any
+  ): StripeCardNumberElement;
+  once(
+    eventType: 'networkschange',
+    handler: (event: {elementType: 'cardNumber'}) => any
+  ): StripeCardNumberElement;
+  off(
+    eventType: 'networkschange',
+    handler?: (event: {elementType: 'cardNumber'}) => any
+  ): StripeCardNumberElement;
+
   /**
    * Updates the options the `CardNumberElement` was initialized with.
    * Updates are merged into the existing configuration.

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

@@ -86,6 +86,22 @@ export type StripeCardElement = StripeElementBase & {
     handler?: (event: {elementType: 'card'}) => any
   ): StripeCardElement;
 
+  /**
+   * Triggered when there is a change to the available networks the provided card can run on.
+   */
+  on(
+    eventType: 'networkschange',
+    handler: (event: {elementType: 'card'}) => any
+  ): StripeCardElement;
+  once(
+    eventType: 'networkschange',
+    handler: (event: {elementType: 'card'}) => any
+  ): StripeCardElement;
+  off(
+    eventType: 'networkschange',
+    handler?: (event: {elementType: 'card'}) => any
+  ): StripeCardElement;
+
   /**
    * Updates the options the `CardElement` was initialized with.
    * Updates are merged into the existing configuration.

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

@@ -1,3 +1,4 @@
+export * from './address';
 export * from './affirm-message';
 export * from './afterpay-clearpay-message';
 export * from './au-bank-account';

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

@@ -159,11 +159,6 @@ export interface StripeShippingAddressElementOptions {
     phone?: string | null;
   };
 
-  /**
-   * Whether or not ShippingAddressElement provides autocomplete suggestions
-   */
-  disableAutocomplete?: boolean;
-
   /**
    * Control which additional fields to display in the shippingAddress Element.
    */
@@ -199,7 +194,7 @@ export interface StripeShippingAddressElementChangeEvent
   complete: boolean;
 
   /**
-   * Whether or not the the shipping address is new.
+   * Whether or not the shipping address is new.
    */
   isNewAddress: boolean;
 

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

@@ -1,4 +1,6 @@
 import {
+  StripeAddressElement,
+  StripeAddressElementOptions,
   StripeShippingAddressElement,
   StripeShippingAddressElementOptions,
   StripePaymentRequestButtonElement,
@@ -46,6 +48,29 @@ export interface StripeElements {
    */
   fetchUpdates(): Promise<{error?: {message: string; status?: string}}>;
 
+  /////////////////////////////
+  /// address
+  /////////////////////////////
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   *
+   * Creates a `AddressElement`.
+   */
+  create(
+    elementType: 'address',
+    options: StripeAddressElementOptions
+  ): StripeAddressElement;
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   *
+   * Looks up a previously created `Element` by its type.
+   */
+  getElement(elementType: 'address'): StripeAddressElement | null;
+
   /////////////////////////////
   /// affirmMessage
   /////////////////////////////
@@ -329,9 +354,13 @@ export interface StripeElements {
     elementType: 'paymentRequestButton'
   ): StripePaymentRequestButtonElement | null;
 
+  /////////////////////////////
+  /// shippingAddress
+  /////////////////////////////
+
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   * @deprecated
+   * Use `Address` element instead.
    *
    * Creates a `ShippingAddressElement`.
    */
@@ -341,8 +370,8 @@ export interface StripeElements {
   ): StripeShippingAddressElement;
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   * @deprecated
+   * Use `Address` element instead.
    *
    * Looks up a previously created `Element` by its type.
    */
@@ -352,6 +381,7 @@ export interface StripeElements {
 }
 
 export type StripeElementType =
+  | 'address'
   | 'affirmMessage'
   | 'afterpayClearpayMessage'
   | 'auBankAccount'

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

@@ -7,10 +7,9 @@ import * as elements from './elements';
 import * as financialConnections from './financial-connections';
 
 import {StripeElements, StripeElementsOptions} from './elements-group';
-import {RedirectToCheckoutOptions} from './checkout';
+import {CheckoutLocale, RedirectToCheckoutOptions} from './checkout';
 import {PaymentRequestOptions, PaymentRequest} from './payment-request';
 import {StripeElement, StripeElementLocale} from './elements-group';
-import {CheckoutLocale} from './checkout';
 
 export interface Stripe {
   /////////////////////////////
@@ -508,6 +507,14 @@ export interface Stripe {
     data?: paymentIntents.VerifyMicrodepositsForPaymentData
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use stripe.createRadarSession to create a [Radar Session](https://stripe.com/docs/radar/radar-session) in your checkout flow or when saving card details.
+   * A Radar Session is a snapshot of the browser metadata and device details that helps Radar make more accurate predictions on your payments.
+   * This metadata includes information like IP address, browser, screen or device information, and other device characteristics.
+   * By using Radar Sessions, you can capture critical fraud information without tokenizing on Stripe.
+   */
+  createRadarSession(): Promise<RadarSessionPayload>;
+
   /**
    * Use `stripe.collectBankAccountForPayment` in the [Accept a payment flow](https://stripe.com/docs/payments/ach-debit/accept-a-payment) for the [ACH Direct Debit](https://stripe.com/docs/payments/ach-debit)
    * payment method to collect the customer’s bank account in your payment form.
@@ -1044,7 +1051,7 @@ export type FinancialConnectionsSessionResult =
 export type CollectBankAccountTokenResult =
   | {
       financialConnectionsSession: api.FinancialConnectionsSession;
-      token: string;
+      token: api.BankAccountToken;
       error?: undefined;
     }
   | {
@@ -1053,6 +1060,14 @@ export type CollectBankAccountTokenResult =
       error: StripeError;
     };
 
+/* A Radar Session is a snapshot of the browser metadata and device details that helps Radar make more accurate predictions on your payments. 
+  This metadata includes information like IP address, browser, screen or device information, and other device characteristics. 
+  You can find more details about how Radar uses this data by reading about how Radar performs [advanced fraud detection](https://stripe.com/docs/disputes/prevention/advanced-fraud-detection).
+  */
+export type RadarSessionPayload =
+  | {radarSession: Record<any, any>; error?: undefined}
+  | {radarSession?: undefined; error: StripeError};
+
 export interface WrapperLibrary {
   /**
    * Your library’s name, maximum length is 30