@bigcommerce/checkout-sdk 1.743.1 → 1.744.0

package/dist/checkout-sdk.d.ts

@@ -1132,6 +1132,26 @@ declare interface BigCommercePaymentsFastlanePaymentInitializeOptions {
     styles?: PayPalFastlaneStylesOption;
 }
 
+/**
+ * A set of options that are required to initialize the shipping step of
+ * checkout in order to support BigCommercePayments  Fastlane.
+ */
+declare interface BigCommercePaymentsFastlaneShippingInitializeOptions {
+    /**
+     * Is a stylisation options for customizing BigCommercePayments Fastlane components
+     *
+     * Note: the styles for all BigCommercePayments Fastlane strategies should be the same,
+     * because they will be provided to fastlane library only for the first strategy initialization
+     * no matter what strategy was initialised first
+     */
+    styles?: PayPalFastlaneStylesOption;
+    /**
+     * Is a callback that shows BigCommercePayments Fastlane popup with customer addresses
+     * when get triggered
+     */
+    onPayPalFastlaneAddressChange?: (showPayPalFastlaneAddressSelector: () => Promise<CustomerAddress_2 | undefined>) => void;
+}
+
 declare interface BigCommercePaymentsFieldsStyleOptions {
     variables?: {
         fontFamily?: string;
@@ -5131,6 +5151,19 @@ declare interface CreditCardPlaceHolder {
     encryptedSecurityCode: string;
 }
 
+/**
+ * This object is used to pass custom fonts when creating an [Elements](https://stripe.com/docs/js/elements_object/create) object.
+ */
+declare interface CssFontSource {
+    /**
+     * A relative or absolute URL pointing to a CSS file with [@font-face](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face) definitions, for example:
+     * `https://fonts.googleapis.com/css?family=Open+Sans`
+     * Note that if you are using a [content security policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy) (CSP),
+     * [additional directives](https://stripe.com/docs/security#content-security-policy) may be necessary.
+     */
+    cssSrc: string;
+}
+
 declare interface CssProperties {
     background?: string;
     caretColor?: string;
@@ -5188,6 +5221,37 @@ declare interface CustomError extends Error {
     subtype?: string;
 }
 
+/**
+ * This object is used to pass custom fonts when creating an [Elements](https://stripe.com/docs/js/elements_object/create) object.
+ */
+declare interface CustomFontSource {
+    /**
+     * The name to give the font.
+     */
+    family: string;
+    /**
+     * A valid [src](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/src) value pointing to your
+     * custom font file. This is usually (though not always) a link to a file with a .woff , .otf, or .svg suffix.
+     */
+    src: string;
+    /**
+     * A valid [font-display](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display) value.
+     */
+    display?: string;
+    /**
+     * One of normal, italic, oblique. Defaults to normal.
+     */
+    style?: string;
+    /**
+     * A valid [unicode-range](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/unicode-range) value.
+     */
+    unicodeRange?: string;
+    /**
+     * A valid [font-weight](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight). Note that this is a string, not a number.
+     */
+    weight?: string;
+}
+
 declare interface CustomItem {
     id: string;
     listPrice: number;
@@ -8308,6 +8372,11 @@ declare interface ShippingInitializeOptions<T = {}> extends ShippingRequestOptio
      * when using PayPal Commerce Fastlane.
      */
     paypalcommercefastlane?: PayPalCommerceFastlaneShippingInitializeOptions;
+    /**
+     * The options that are required to initialize the shipping step of checkout
+     * when using BigCommercePayments Fastlane.
+     */
+    bigcommerce_payments_fastlane?: BigCommercePaymentsFastlaneShippingInitializeOptions;
 }
 
 declare interface ShippingOption {
@@ -8574,6 +8643,18 @@ declare class StoredCardHostedFormService {
     deinitialize(): void;
 }
 
+/**
+ * All available options are here https://stripe.com/docs/stripe-js/appearance-api#supported-css-properties
+ */
+declare interface StripeAppearanceOptions {
+    variables?: Record<string, StripeAppearanceValues>;
+    rules?: Record<string, Record<string, StripeAppearanceValues>>;
+}
+
+declare type StripeAppearanceValues = string | string[] | number | undefined;
+
+declare type StripeCustomFont = CssFontSource | CustomFontSource;
+
 declare interface StripeCustomerEvent extends StripeEvent {
     collapsed?: boolean;
     authenticated: boolean;
@@ -8773,9 +8854,13 @@ declare interface StripeOCSPaymentInitializeOptions {
      */
     layout?: Record<string, string | number | boolean>;
     /**
-     * Checkout styles from store theme
+     * Stripe OCS appearance options for styling the accordion.
      */
-    style?: Record<string, StripeUPEAppearanceValues>;
+    appearance?: StripeAppearanceOptions;
+    /**
+     * Stripe OCS fonts options for styling the accordion.
+     */
+    fonts?: StripeCustomFont[];
     onError?(error?: Error): void;
     render(): void;
     initStripeElementUpdateTrigger?(updateTriggerFn: (payload: StripeElementUpdateOptions) => void): void;
@@ -8809,8 +8894,6 @@ declare interface StripeShippingEvent extends StripeEvent {
     };
 }
 
-declare type StripeUPEAppearanceValues = string | string[] | number | undefined;
-
 declare interface StripeUPECustomerInitializeOptions {
     /**
      * The ID of a container which the stripe iframe should be inserted.
@@ -8874,7 +8957,7 @@ declare interface StripeUPEPaymentInitializeOptions {
     /**
      * Checkout styles from store theme
      */
-    style?: Record<string, StripeUPEAppearanceValues>;
+    style?: Record<string, StripeAppearanceValues>;
     onError?(error?: Error): void;
     render(): void;
     initStripeElementUpdateTrigger?(updateTriggerFn: (payload: StripeElementUpdateOptions) => void): void;