@stripe/stripe-js 2.1.0 → 2.1.2

package/dist/pure.esm.js

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

package/dist/pure.js

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

package/dist/stripe.esm.js

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

package/dist/stripe.js

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

package/package.json

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

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

@@ -0,0 +1,216 @@
+import {
+  LayoutObject,
+  Layout,
+  TermsOption,
+  StripePaymentElement,
+} from './elements/payment';
+import {
+  AddressMode,
+  ContactOption,
+  StripeAddressElement,
+} from './elements/address';
+import {Appearance, CssFontSource, CustomFontSource} from './elements-group';
+
+/**
+ * Requires beta access:
+ * Contact [Stripe support](https://support.stripe.com/) for more information.
+ */
+
+/**
+ * StripeCustomCheckoutInitOptions
+ */
+export interface StripeCustomCheckoutElementsOptions {
+  appearance?: Appearance;
+  loader?: 'auto' | 'always' | 'never';
+  fonts?: Array<CssFontSource | CustomFontSource>;
+}
+
+export interface StripeCustomCheckoutOptions {
+  clientSecret: string;
+  elementsOptions?: StripeCustomCheckoutElementsOptions;
+}
+
+/**
+ * StripeCustomCheckoutActions
+ */
+
+export type StripeCustomCheckoutAddress = {
+  country: string | null;
+  line1: string | null;
+  line2?: string | null;
+  city: string | null;
+  postal_code: string | null;
+  state: string | null;
+};
+
+export type StripeCustomCheckoutShippingAddress = {
+  name?: string | null;
+  address: StripeCustomCheckoutAddress;
+};
+
+export type StripeCustomCheckoutBillingAddress = StripeCustomCheckoutShippingAddress;
+
+export interface StripeCustomCheckoutActions {
+  applyPromotionCode: (promotionCode: string) => Promise<void>;
+  removePromotionCode: () => Promise<void>;
+  updateShippingAddress: (
+    shippingAddress: StripeCustomCheckoutShippingAddress
+  ) => Promise<void>;
+  updateBillingAddress: (
+    billingAddress: StripeCustomCheckoutBillingAddress
+  ) => Promise<void>;
+  updatePhoneNumber: (phoneNumber: string) => void;
+  updateEmail: (email: string) => void;
+  updateLineItemQuantity: (args: {
+    lineItem: string;
+    quantity: number;
+  }) => Promise<void>;
+  updateShippingOption: (shippingOption: string) => Promise<void>;
+  confirm: (args?: {return_url?: string}) => Promise<void>;
+}
+
+/**
+ * StripeCustomCheckoutSession
+ */
+
+export type StripeCustomCheckoutTaxAmount = {
+  amount: number;
+  inclusive: boolean;
+  displayName: string;
+};
+
+export type StripeCustomCheckoutDiscountAmount = {
+  amount: number;
+  displayName: string;
+  promotionCode?: string | null;
+};
+
+export type StripeCustomCheckoutShipping = {
+  shippingOption: StripeCustomCheckoutShippingOption;
+  taxAmounts?: Array<StripeCustomCheckoutTaxAmount> | null;
+};
+
+export type StripeCustomCheckoutShippingOption = {
+  id: string;
+  amount: number;
+  currency: string;
+  displayName?: string | null;
+  deliveryEstimate?: StripeCustomCheckoutDeliveryEstimate | null;
+};
+
+export type StripeCustomCheckoutDeliveryEstimate = {
+  maximum?: StripeCustomCheckoutEstimate | null;
+  minimum?: StripeCustomCheckoutEstimate | null;
+};
+
+export type StripeCustomCheckoutEstimate = {
+  unit: 'business_day' | 'day' | 'hour' | 'week' | 'month';
+  value: number;
+};
+
+export type StripeCustomCheckoutLineItemDiscountAmount = {
+  amount: number;
+  promotionCode?: string | null;
+};
+
+export type StripeCustomCheckoutBillingInterval =
+  | 'day'
+  | 'month'
+  | 'week'
+  | 'year';
+
+export type StripeCustomCheckoutLineItem = {
+  id: string;
+  name: string;
+  amount: number;
+  unitAmount: number;
+  description?: string | null;
+  quantity: number;
+  discountAmounts?: Array<StripeCustomCheckoutLineItemDiscountAmount> | null;
+  recurring?: {
+    interval: StripeCustomCheckoutBillingInterval;
+    interval_count: number;
+  };
+};
+
+export type StripeCustomCheckoutTotalSummary = {
+  subtotal: number;
+  taxExclusive: number;
+  taxInclusive: number;
+  shippingRate: number;
+  discount: number;
+  total: number;
+};
+
+export type StripeCustomCheckoutConfirmationRequirement =
+  | 'phoneNumber'
+  | 'shippingAddress'
+  | 'billingAddress'
+  | 'paymentDetails'
+  | 'email';
+
+export interface StripeCustomCheckoutSession {
+  lineItems: Array<StripeCustomCheckoutLineItem>;
+  taxAmounts?: Array<StripeCustomCheckoutTaxAmount> | null;
+  discountAmounts?: Array<StripeCustomCheckoutDiscountAmount> | null;
+  currency: string;
+  shipping?: StripeCustomCheckoutShipping | null;
+  shippingOptions: Array<StripeCustomCheckoutShippingOption>;
+  shippingAddress?: StripeCustomCheckoutShippingAddress | null;
+  billingAddress?: StripeCustomCheckoutBillingAddress | null;
+  phoneNumber?: string | null;
+  email?: string | null;
+  total: StripeCustomCheckoutTotalSummary;
+  confirmationRequirements: StripeCustomCheckoutConfirmationRequirement[];
+  canConfirm: boolean;
+}
+
+/**
+ * StripeCustomCheckoutElements
+ */
+export type StripeCustomCheckoutPaymentElementOptions = {
+  layout?: Layout | LayoutObject;
+  paymentMethodOrder?: Array<string>;
+  readonly?: boolean;
+  terms?: TermsOption;
+};
+
+export type StripeCustomCheckoutAddressElementOptions = {
+  mode: AddressMode;
+  contacts?: ContactOption[];
+  display?: {
+    name?: 'full' | 'split' | 'organization';
+  };
+};
+
+export interface StripeCustomCheckoutElementsActions {
+  changeAppearance: (appearance: Appearance) => void;
+  getElement(elementType: 'payment'): StripePaymentElement | null;
+  getElement(
+    elementType: 'address',
+    mode: AddressMode
+  ): StripeAddressElement | null;
+  createElement(
+    elementType: 'payment',
+    options?: StripeCustomCheckoutPaymentElementOptions
+  ): StripePaymentElement;
+  createElement(
+    elementType: 'address',
+    options: StripeCustomCheckoutAddressElementOptions
+  ): StripeAddressElement;
+}
+
+/**
+ * StripeCustomCheckout
+ */
+export type StripeCustomCheckoutUpdateHandler = (
+  session: StripeCustomCheckoutSession
+) => void;
+
+export interface StripeCustomCheckout
+  extends StripeCustomCheckoutActions,
+    StripeCustomCheckoutSession,
+    StripeCustomCheckoutElementsActions {
+  session: () => StripeCustomCheckoutSession;
+  on: (event: 'change', handler: StripeCustomCheckoutUpdateHandler) => void;
+}

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

@@ -378,10 +378,7 @@ export interface StripeElements {
   /////////////////////////////
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
-   * Creates a `ExpressCheckoutElement`.
+   * Creates an `ExpressCheckoutElement`.
    */
   create(
     elementType: 'expressCheckout',
@@ -389,9 +386,6 @@ export interface StripeElements {
   ): StripeExpressCheckoutElement;
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
    * Looks up a previously created `Element` by its type.
    */
   getElement(

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

@@ -0,0 +1,30 @@
+export interface StripeEmbeddedCheckoutOptions {
+  /**
+   * The client secret of the [Checkout Session](https://stripe.com/docs/api/checkout/sessions).
+   */
+  clientSecret: string;
+  /**
+   * onComplete is called when the Checkout Session completes successfully.
+   * You can use it to unmount Embedded Checkout and render a custom success UI.
+   */
+  onComplete?: () => void;
+}
+
+export interface StripeEmbeddedCheckout {
+  /**
+   * The `embeddedCheckout.mount` method attaches your Embedded Checkout to the DOM.
+   * `mount` accepts either a CSS Selector (e.g., `'#checkout'`) or a DOM element.
+   */
+  mount(location: string | HTMLElement): void;
+  /**
+   * Unmounts Embedded Checkout from the DOM.
+   * Call `embeddedCheckout.mount` to re-attach it to the DOM.
+   */
+  unmount(): void;
+  /**
+   * Removes Embedded Checkout from the DOM and destroys it.
+   * Once destroyed it not be re-mounted to the DOM.
+   * Use this if you want to create a new Embedded Checkout instance.
+   */
+  destroy(): void;
+}

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

@@ -1,4 +1,6 @@
 export * from './checkout';
+export * from './custom-checkout';
+export * from './embedded-checkout';
 export * from './elements';
 export * from './elements-group';
 export * from './ephemeral-keys';

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

@@ -15,6 +15,14 @@ import {
 import {CheckoutLocale, RedirectToCheckoutOptions} from './checkout';
 import {PaymentRequestOptions, PaymentRequest} from './payment-request';
 import {StripeElement, StripeElementLocale} from './elements-group';
+import {
+  StripeCustomCheckoutOptions,
+  StripeCustomCheckout,
+} from './custom-checkout';
+import {
+  StripeEmbeddedCheckoutOptions,
+  StripeEmbeddedCheckout,
+} from './embedded-checkout';
 
 export interface Stripe {
   /////////////////////////////
@@ -1193,6 +1201,22 @@ export interface Stripe {
   createEphemeralKeyNonce(
     options: ephemeralKeys.EphemeralKeyNonceOptions
   ): Promise<EphemeralKeyNonceResult>;
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   */
+  initCustomCheckout(
+    options: StripeCustomCheckoutOptions
+  ): Promise<StripeCustomCheckout>;
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   */
+  initEmbeddedCheckout(
+    options: StripeEmbeddedCheckoutOptions
+  ): Promise<StripeEmbeddedCheckout>;
 }
 
 export type PaymentIntentResult =