@zonos/elements 1.3.201 → 1.3.203

package/dist/scripts/index.d.ts

@@ -68,6 +68,85 @@ declare class IframeService {
     }) => HTMLIFrameElement;
 }
 
+type CustomEventMap = {
+    legacyCheckoutError: string;
+    'zonos-checkout-success': {
+        message: string;
+    };
+};
+
+declare const _envClientSchema: z.ZodObject<{
+    NEXT_PUBLIC_FLAG_URL: z.ZodString;
+    NEXT_PUBLIC_RELEASE_DATE: z.ZodString;
+    NEXT_PUBLIC_ZONOS_API_KEY: z.ZodString;
+    NEXT_PUBLIC_ZONOS_CDNJS_CDN_URL: z.ZodString;
+    NEXT_PUBLIC_ZONOS_CDN_URL: z.ZodString;
+    NEXT_PUBLIC_ZONOS_CLOUDFLARE_URL: z.ZodString;
+    NEXT_PUBLIC_ZONOS_JS_DELIVR_CDN_URL: z.ZodString;
+    NEXT_PUBLIC_ZONOS_PACKAGE_VERSION: z.ZodString;
+    NEXT_PUBLIC_ZONOS_ROUTE_URL: z.ZodString;
+    NEXT_PUBLIC_ZONOS_UNPKG_CDN_URL: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    NEXT_PUBLIC_FLAG_URL: string;
+    NEXT_PUBLIC_RELEASE_DATE: string;
+    NEXT_PUBLIC_ZONOS_API_KEY: string;
+    NEXT_PUBLIC_ZONOS_CDNJS_CDN_URL: string;
+    NEXT_PUBLIC_ZONOS_CDN_URL: string;
+    NEXT_PUBLIC_ZONOS_CLOUDFLARE_URL: string;
+    NEXT_PUBLIC_ZONOS_JS_DELIVR_CDN_URL: string;
+    NEXT_PUBLIC_ZONOS_PACKAGE_VERSION: string;
+    NEXT_PUBLIC_ZONOS_ROUTE_URL: string;
+    NEXT_PUBLIC_ZONOS_UNPKG_CDN_URL: string;
+}, {
+    NEXT_PUBLIC_FLAG_URL: string;
+    NEXT_PUBLIC_RELEASE_DATE: string;
+    NEXT_PUBLIC_ZONOS_API_KEY: string;
+    NEXT_PUBLIC_ZONOS_CDNJS_CDN_URL: string;
+    NEXT_PUBLIC_ZONOS_CDN_URL: string;
+    NEXT_PUBLIC_ZONOS_CLOUDFLARE_URL: string;
+    NEXT_PUBLIC_ZONOS_JS_DELIVR_CDN_URL: string;
+    NEXT_PUBLIC_ZONOS_PACKAGE_VERSION: string;
+    NEXT_PUBLIC_ZONOS_ROUTE_URL: string;
+    NEXT_PUBLIC_ZONOS_UNPKG_CDN_URL: string;
+}>;
+interface Env extends z.infer<typeof _envClientSchema> {
+}
+
+/* eslint-disable no-relative-import-paths/no-relative-import-paths */
+
+declare global {
+  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
+  interface Document {
+    addEventListener<K extends keyof CustomEventMap>(
+      type: K,
+      listener: (this: Document, ev: CustomEvent<CustomEventMap[K]>) => void,
+    ): void;
+  }
+
+  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
+  interface Window {
+    Stripe?: StripeConstructor;
+    Zonos: Zonos;
+    /**
+     * A flag to determine if the current page is a BigCommerce page
+     */
+    bcConfig?: unknown;
+    /**
+     * This flag would be set to true if zonosQaUrl is present in the query params and preview script loadZonos.js is injected to DOM
+     */
+    isZonosPreview?: boolean;
+    /**
+     * A flag to determine if the current page is a BigCommerce page
+     */
+    stencilBootstrap?: unknown;
+  }
+
+  namespace NodeJS {
+    // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
+    interface ProcessEnv extends Env {}
+  }
+}
+
 declare const adjustmentSource: {
     readonly ApiRequest: "API_REQUEST";
     readonly PromoCode: "PROMO_CODE";
@@ -836,8 +915,8 @@ type CalculateLandedCostMutation = {
         deMinimis: Array<{
             formula: string;
             method: IncotermCode;
-            threshold: DeMinimisThreshold;
             note: string;
+            threshold: DeMinimisThreshold;
             type: DeMinimisType;
         }>;
         duties: Array<{
@@ -851,6 +930,10 @@ type CalculateLandedCostMutation = {
         id: string;
         landedCostGuaranteeCode: LandedCostGuaranteeCode;
         method: IncotermCode;
+        remittance: Array<{
+            amount: number;
+            description: string;
+        }>;
         shipmentRating: {
             id: string;
         };
@@ -1008,6 +1091,13 @@ type CartCheckoutWorkflowQuery = {
             }>;
             updatedAt: string;
             updatedBy: string;
+            varianceTestRegistrations: Array<{
+                testKey: string;
+                varianceAllocation: Array<{
+                    percentage: number;
+                    variantKey: string;
+                }>;
+            }> | null;
             visibilityStatus: CheckoutVisibilityStatus;
         };
         credentialTokenId: string;
@@ -1109,6 +1199,10 @@ type CheckoutSessionDetailsFragment = {
         taxes: number;
         total: number;
     };
+    varianceTestResults: Array<{
+        selectedVariantKey: string;
+        testKey: string;
+    }> | null;
 };
 type GetOrderQuery = {
     order: {
@@ -1222,6 +1316,167 @@ type GetOrderQuery = {
     } | null;
 };
 
+type TranslatedText = {
+    [key: string]: string;
+};
+type EnteredInfo = {
+    city: string;
+    country: CountryCode;
+    email: string;
+    line1: string;
+    line2: string;
+    name: string;
+    phone: string;
+    postal_code: string;
+    state: string;
+};
+type ValidateAddressFields = Omit<StripeAddressElementChangeEvent['value']['address'], 'country'> & {
+    name: string;
+};
+type TranslatedAddressObject = {
+    [key in keyof ValidateAddressFields]?: TranslatedText;
+};
+
+type SubmitEventData = {
+    billingAddress: Record<keyof TranslatedAddressObject, string> | null;
+    shippingAddress: Record<keyof TranslatedAddressObject, string>;
+};
+
+declare const colorPrefixes: readonly ["blue", "cyan", "green", "orange", "purple", "red", "gray", "glass"];
+declare const colorContrasts: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
+type ColorContrast = (typeof colorContrasts)[number];
+type ColorPrefix = (typeof colorPrefixes)[number];
+type Color = 'gray-0' | 'gray-50' | 'glass-0' | 'glass-50' | `${ColorPrefix}-${ColorContrast}` | 'gray-1000' | 'glass-1100' | 'glass-1200';
+declare const checkboxColorPrefix: readonly ["blue", "cyan", "green", "orange", "purple", "red", "gray"];
+type CheckboxColorPrefix = (typeof checkboxColorPrefix)[number];
+
+type BannerIntent = 'default' | 'error' | 'success' | 'warning' | 'info';
+
+declare const textOptions: {
+    readonly pageHeader: {
+        readonly label: "Page Header (3XL) · 34px (2.125rem)";
+        readonly size: "3xl";
+        readonly tag: "h2";
+        readonly weight: 900;
+    };
+    readonly secondaryPageHeader: {
+        readonly label: "Secondary Page Header (3XL) • 34px, 500 \"Medium\"";
+        readonly size: "3xl";
+        readonly tag: "h2";
+        readonly weight: 500;
+    };
+    readonly header: {
+        readonly label: "Header (2XL) · 28px (1.75rem)";
+        readonly size: "2xl";
+        readonly tag: "h3";
+        readonly weight: 700;
+    };
+    readonly descriptionHeader: {
+        readonly label: "Description Header (2XL) · 28px (1.75rem)";
+        readonly size: "2xl";
+        readonly tag: "h3";
+        readonly weight: 700;
+    };
+    readonly title: {
+        readonly label: "Title (XL) • 22px (1.375rem)";
+        readonly size: "xl";
+        readonly tag: "h4";
+        readonly weight: 600;
+    };
+    readonly boldSubheader: {
+        readonly label: "Bold Subheader (L) • 18px (1.125rem)";
+        readonly size: "l";
+        readonly tag: "h5";
+        readonly weight: 700;
+    };
+    readonly semiBoldSubheader: {
+        readonly label: "Semi Bold Subheader (L / H4) • 18px (1.125rem)";
+        readonly size: "l";
+        readonly tag: "h5";
+        readonly weight: 600;
+    };
+    readonly subheader: {
+        readonly label: "Subheader (L) • 18px (1.125rem)";
+        readonly size: "l";
+        readonly tag: "h5";
+        readonly weight: 500;
+    };
+    readonly boldLabel: {
+        readonly label: "Bold Label (Base) • 14px (.875rem)";
+        readonly size: "base";
+        readonly tag: "span";
+        readonly weight: 700;
+    };
+    readonly semiBoldLabel: {
+        readonly label: "Semi Bold Label (Base) • 14px (.875rem)";
+        readonly size: "base";
+        readonly tag: "span";
+        readonly weight: 600;
+    };
+    readonly label: {
+        readonly label: "Label (Base) • 14px (.875rem)";
+        readonly size: "base";
+        readonly tag: "span";
+        readonly weight: 500;
+    };
+    readonly body: {
+        readonly label: "Body (Base) • 14px (.875rem)";
+        readonly size: "base";
+        readonly tag: "span";
+        readonly weight: 400;
+    };
+    readonly smallHeader: {
+        readonly label: "Small header (S) • 12px (.75rem)";
+        readonly size: "s";
+        readonly tag: "span";
+        readonly weight: 600;
+    };
+    readonly caption: {
+        readonly label: "Caption (S) • 12px (.75rem)";
+        readonly size: "s";
+        readonly tag: "span";
+        readonly weight: 400;
+    };
+    readonly hintText: {
+        readonly label: "Hint text (XS) • 10px (.625rem)";
+        readonly size: "xs";
+        readonly tag: "span";
+        readonly weight: 400;
+    };
+};
+type TextOptions = typeof textOptions;
+type Size = TextOptions[keyof TextOptions]['size'];
+type Type = keyof TextOptions;
+type FontWeight = TextOptions[keyof TextOptions]['weight'];
+
+type CustomAddressErrors = {
+    city: string;
+    firstName: string;
+    lastName: string;
+    line1: string;
+    phone: string;
+    postalCode: string;
+    /**
+     * Toggle to indicate if the error message should be shown
+     */
+    showError: boolean;
+    state: string;
+};
+
+type StripeStoreContactOption = {
+    address: {
+        city: string;
+        country: string;
+        line1: string;
+        line2?: string;
+        postal_code: string;
+        state: string;
+    };
+    email: string;
+    name: string;
+    phone?: string;
+};
+
 type TabItem = {
     index: number;
     isDone: boolean;
@@ -1260,761 +1515,144 @@ type CartItem = {
     sku?: string;
 };
 
-type CalculateLandedCostAdjustmentInput = {
-    amount: number;
-    name?: string | null;
-    productId: string | null;
-    promoCode?: string | null;
-    sku: string | null;
-    type: LandedCostAdjustmentType;
-};
-type Extensions = {
-    [key: string]: unknown;
-} & {
-    rule?: {
-        description: string;
-        id: string;
-        name: string;
-    };
-    ruleMessageType?: 'CUSTOM' | 'DEFAULT';
-};
-type ApiError = {
-    extensions?: Extensions | null;
+type NotificationInit = {
     message: string;
-};
-type CalculateLandedCostRequest = {
-    billingAddress: {
-        addressLine1: string;
-        addressLine2?: string | undefined;
-        city: string;
-        country: CountryCode;
-        postalCode: string;
-        state: string;
-    };
-    billingContact: {
-        firstName: string;
-        lastName: string;
-        phone: string;
-    };
-    checkoutSessionId: string;
-    contact: {
-        companyName?: string;
-        email?: string;
-        firstName: string;
-        lastName: string;
-        phone: string;
-    };
     /**
-     * When this is set, the created quote will not be shown on the Quote List page in the Zonos Dashboard.
+     * Time in milliseconds
+     * @default 4000
      */
-    isTest?: boolean;
-    items: CartItem[];
-    landedCostAdjustments?: CalculateLandedCostAdjustmentInput[];
-    metadata?: {
-        key: string;
-        value: string;
-    }[];
+    timeout?: number;
     /**
-     * TaxId that the some destination countries require for the shipment.
+     * Type of notification
+     * @default 'success'
      */
-    shipToTaxId?: string;
-    shippingAddress: {
-        addressLine1: string;
-        addressLine2?: string | undefined;
-        city: string;
-        country: CountryCode;
-        postalCode: string;
-        state: string;
-    };
+    type?: 'error' | 'success' | 'warning';
 };
 
-type BuildLandedCostParams = {
-    billingAddress: CalculateLandedCostRequest['billingAddress'];
-    billingContact: CalculateLandedCostRequest['billingContact'];
-    checkoutSessionId: string;
-    contact: CalculateLandedCostRequest['contact'];
-    landedCostAdjustments?: CalculateLandedCostRequest['landedCostAdjustments'];
-    publicCredential: string;
-    shippingAddress: CalculateLandedCostRequest['shippingAddress'];
-    zonosApiRoute: string;
+declare const localeElementsSupportedLocationCodeEnum: {
+    readonly Ar: "ar";
+    readonly Da: "da";
+    readonly De: "de";
+    readonly En: "en";
+    readonly Es: "es";
+    readonly Fr: "fr";
+    readonly He: "he";
+    readonly Id: "id";
+    readonly It: "it";
+    readonly Ja: "ja";
+    readonly Ko: "ko";
+    readonly Nl: "nl";
+    readonly No: "no";
+    readonly Pl: "pl";
+    readonly Pt: "pt";
+    readonly Ru: "ru";
+    readonly Sv: "sv";
+    readonly Tr: "tr";
+    readonly Vi: "vi";
+    readonly Zh: "zh";
 };
-type BuildLandedCostResponse = (CalculateLandedCostMutation & {
-    errors: ApiError[];
-}) | null;
+type Locale_ElementsSupportedLocationCode_Enum = (typeof localeElementsSupportedLocationCodeEnum)[keyof typeof localeElementsSupportedLocationCodeEnum];
 
-type ZonosOrder = GetOrderQuery['order'];
+type ICountry = {
+    bigcommerceDisplayName?: string;
+    code: CountryCode;
+    currencyCode: string;
+    displayName: string;
+    languageCode: Locale_ElementsSupportedLocationCode_Enum;
+};
+type ICountryJson = {
+    [countryCode: string]: ICountry;
+};
 
-type BuildCardDetailParams = {
-    countryCode: CountryCode;
-    currencyCode: CurrencyCode;
+type Items = CheckItemRestrictionsMutation['itemRestrictionApply']['items'];
+type RestrictedItem = Items[number] & {
+    name?: string;
 };
-type PromiseOrValue<T> = T | Promise<T>;
-type PrefillAddress = {
-    customerAddress1: string;
-    customerAddress2?: string;
-    customerCity?: string;
-    /**
-     * If country is not provided, it will try to pull from query params `zCountry` or `country` or `customerCountry` in the URL or fallback to user's selected country
-     */
-    customerCountry?: string;
-    customerEmail: string;
-    customerName: string;
-    customerPhone: string;
-    customerState?: string;
-    customerZip: string;
+
+declare const restStateType: readonly ["Boxes", "Earth", "EmptyBox", "Lock", "PigBank", "Scribble", "Search", "Settings", "ShoppingCart", "SpilledCup", "Switch", "TaxId", "Truck", "Warning"];
+type RestStateType = (typeof restStateType)[number];
+
+type ShippingRichRadioItem = {
+    amount: number;
+    caption?: string;
+    label: string;
+    landedCostId: string;
+    method: IncotermCode;
+    price: string;
+    shipmentRatingId: string;
+    sublabel?: string;
+    value: string | number;
 };
-type CreateCartIdObject = {
-    cartId: string;
-    customerAuthenticationToken?: string;
-    shippingData?: PrefillAddress | null;
+
+type SpinnerColor = 'primary' | 'info' | 'success' | 'danger' | 'warning' | 'black' | 'white';
+
+type CountryFieldLabelStateLabel = 'Commune' | 'County' | 'County or sector' | 'Department' | 'Derzhava' | 'District' | 'Do/Si' | 'Island' | 'Municipality' | 'Oblast' | 'Parish' | 'Prefecture' | 'Province' | 'Region' | 'State' | 'State or Territory' | 'State or province' | 'Village';
+type CountryFieldLabelAddress1Label = 'Address line 1' | 'Address1' | 'Adresa vulytsi' | 'Street address' | 'Street or avenue' | 'Ulica';
+type CountryFieldLabelAddress2Label = '' | 'Address 2' | 'Address line 2' | 'Address2' | 'Sector' | 'Street address 2';
+type CountryFieldLabelAddress3Label = '' | 'Address line 3' | 'Address3' | 'CEDEX' | 'Street address 3';
+type CountryFieldLabelCityLabel = '' | 'Area' | 'City' | 'City/Town' | 'Emirate' | 'Gorod' | 'Locality' | 'Misto' | 'Town' | 'Town / City' | 'Town or city';
+type CountryFieldLabelZipLabel = '' | 'Code postal' | 'Indeks' | 'Kodepos' | 'Poshtovyy indeks' | 'Postal code' | 'Postcode' | 'ZIP code' | 'Zip';
+type ICountryFieldLabelRegion = {
+    interpayCode: string;
 };
-type CheckoutConfig = {
-    /**
-     * Validate address to allow specific character sets
-     * @default ALL
-     */
-    allowedCharacterSets?: 'ALL' | 'LATIN';
-    /**
-     * Enable settlement currencies to pay in USD
-     * @default LOCAL
-     */
-    allowedSettlementCurrencies: AllowedSettlementCurrencies;
-    /**
-     * Always trigger International Checkout with this selector regardless of shipping zone
-     */
-    alwaysTriggerInternationalCheckoutSelector?: string | null;
-    analyticsProviders: Array<{
-        status: AnalyticsProviderStatus;
-        type: AnalyticsProviderType;
-    }>;
+type CountryFields = {
+    address1Label: CountryFieldLabelAddress1Label;
+    address1Required: boolean;
+    address1Show: boolean;
+    address2Label: CountryFieldLabelAddress2Label;
+    address2Required: boolean;
+    address2Show: boolean;
+    address3Label: CountryFieldLabelAddress3Label;
+    address3Required: boolean;
+    address3Show: boolean;
+    cityLabel: CountryFieldLabelCityLabel;
+    cityRequired: boolean;
+    cityShow: boolean;
+    countryCode: CountryCode;
+    countryCodeLabel?: string;
+    displayName: string;
+    nameLabel: string;
+    phoneCode: number;
+    phoneFormat: string | null;
+    phonePlaceholder: string | null;
+    regions: Record<string, ICountryFieldLabelRegion> | null;
+    stateLabel: CountryFieldLabelStateLabel;
+    stateRequired: boolean;
+    stateShow: boolean;
+    zipFormat: string | null;
+    zipLabel: CountryFieldLabelZipLabel;
+    zipRegex: string | null;
+    zipRequired: boolean;
+    zipShow: boolean;
+};
+
+type GenericZonosSettings = {
     /**
-     * Time that payment will be captured after the order is placed. Can't be overridden in Zonos.init
+     * Country that should be enable the custom address fields in the checkout based on the country user is from.
      */
-    captureDelay?: number;
+    countryCustomAddressEnabled?: CountryCode[];
     /**
-     * @default DISABLED - when false, company fields would not show up in the checkout form
+     * List of countries and
      */
-    companyFieldsStatus: 'ENABLED' | 'DISABLED';
+    countryFields?: Record<CountryCode, CountryFields>;
     /**
-     * Duration (in seconds) for which the cart remains valid for checkout in hosted checkout.
-     * @default 3_600 (1 hour)
+     * URL of the hosted checkout.
      */
-    defaultCartExpiration?: number;
+    hostedCheckoutUrl?: string;
     /**
-     * @default false - when false, the place order button will be disabled until the script is loaded
-     * @note if set to true, the place order button will not be enabled or disabled
+     * Use custom address fields in the checkout based on the country user is from.
      */
-    disablePlaceOrderButtonActivation?: boolean;
-    externalPaymentMethods: Array<{
-        status: ExternalPaymentMethodStatus;
-        type: ExternalPaymentMethodType;
-    }> | null;
-    externalServiceTokens: {
-        token: string;
-        type: ExternalServiceTokenType;
-    }[];
+    shouldEnabledCustomAddress?: boolean;
     /**
-     * Test mode for checkout (sandbox or production)
-     * @default TEST
+     * Signed token for Google Places API iframe access.
      */
-    mode: Mode;
-    orderNotifications: {
-        abandonedCart: {
-            delay: number;
-            discountPercent: number;
-            status: {
-                active: NotificationActiveStatus;
-                sendCopiesTo: Array<string>;
-            };
-        };
-        orderCancelled: {
-            active: NotificationActiveStatus;
-            sendCopiesTo: Array<string>;
-        };
-        orderShipped: {
-            active: NotificationActiveStatus;
-            sendCopiesTo: Array<string>;
-        };
-    };
-    organization: string;
+    signedTokenGooglePlaces?: string;
     /**
-     * Place order button selector that only trigger International Checkout when shopper is in merchant's shipping zones
+     * List of countries that are allowed to use USD denominated cards for settlement.
      */
-    placeOrderButtonSelector: string | null;
-    /**
-     * @param subscriptionStatus subscription status for checkout, checkout only available if subscription status is ENABLED and visibility status is ENABLED
-     *
-     * **NOTE: this value can't be overridden in Zonos.init**
-     */
-    subscriptionStatus: CheckoutSubscriptionStatus;
-    successBehavior: CheckoutSuccessBehavior;
-    /**
-     * The success page action text for checkout.
-     * @note Default text supports translation automatically, but any custom text will not be translated.
-     */
-    successPageActionText?: string;
-    /**
-     * The success page subtitle text for checkout. Each item in the array will appear on a new line.
-     * @note Default text supports translation automatically, but any custom text will not be translated.
-     */
-    successPageSubtitleText?: string[];
-    /**
-     * The success page title text for checkout.
-     * @note Default text supports translation automatically, but any custom text will not be translated.
-     */
-    successPageTitleText?: string;
-    successRedirectUrl: string;
-    visibilityStatus: CheckoutVisibilityStatus;
-    /**
-     * Cart info callback for checkout (optional),
-     * @deprecated This is deprecated in favor of the new callback `createCartId`. The new API would only need the cart ID to retrieve cart data.
-     * @note will attempt to use cart data if available
-     * User can dispatch an event 'zonos--init-cart-info' to update the cart
-     * @example
-     * const initEvent = new CustomEvent<CartItem[]>('zonos--init-cart-info', {
-     *    detail: cartItems,
-     * });
-     * document.body.dispatchEvent(initEvent);
-     * @returns {object[]} - object with the the item info to be added to cart:
-     * - amount: number;
-     * - countryOfOrigin?: string;
-     * - currencyCode: string;
-     * - description?: string;
-     * - hsCode?: string;
-     * - imageUrl?: string;
-     * - name: string;
-     * - productId?: string;
-     * - quantity: number;
-     */
-    buildCartDetail?: (params: BuildCardDetailParams) => Promise<CartItem[]>;
-    /**
-     * Calculate landed cost callback for checkout (optional)
-     * @deprecated This is deprecated in favor of the new callback `createCartId`. When using the new callback, the cart details will be retrieved using the cart ID, so this callback would no longer be needed.
-     * @note will attempt to use cart data if available
-     */
-    buildLandedCost?: (params: BuildLandedCostParams) => Promise<BuildLandedCostResponse>;
-    /**
-     * A callback that returns the cart id from `cartCreate` mutation. You would use your cart data to call the `cartCreate` mutation and return the cart ID that was created.
-     * @note
-     * The mutation `cartCreate` should be called on the server side
-     * @returns string - Cart ID
-     */
-    createCartId?: () => PromiseOrValue<string | CreateCartIdObject>;
-    /**
-     * Callback trigger when the checkout is closed
-     */
-    onClose?: () => void;
-    /**
-     * This callback is optional. If provided, it will be called right before the payment is processed.
-     * @param items - The cart items.
-     * @returns {string | null} - The error message to display to the user. If the message is empty or null, the payment will proceed.
-     * @example
-     * onInventoryCheck: async ({ items }) => {
-     *   // Check if all items are available from the server. If the fetch is throwing an error, show a generic error message "Unable to check inventory. Please try again.".
-     *   const itemsInfo = await fetch('https://yourserver.com/api/get-available-items', {
-     *     method: 'POST',
-     *     body: JSON.stringify({ items }),
-     *   });
-     *   const items = await itemsInfo.json();
-     *   // Filter out unavailable items.
-     *   const unavailableItems = items.filter(item => !item.available);
-     *   if (unavailableItems.length) {
-     *     // Display an error message to the user.
-     *     return `The following items are not available: ${unavailableItems.map(item => item.name).join(', ')}`;
-     *   }
-     *   // Proceed with the payment if you return an empty string or null.
-     *   return '';
-     * }
-     */
-    onInventoryCheck?: (params: {
-        items: CartItem[];
-    }) => Promise<string | null>;
-    /**
-     * Callback trigger when payment succeeds
-     */
-    onOrderSuccess?: (props: {
-        zonosApiRoute: string;
-        zonosOrder: ZonosOrder;
-    }) => Promise<void>;
-};
-
-type CountryOverrideBehavior = 'URL_PARAM' | 'SESSION';
-type ShowForCountries = 'ALL' | 'ONLY_SHIPPABLE' | CountryCode[];
-type ShowCountryList = 'ALL' | 'ONLY_SHIPPABLE' | CountryCode[];
-type HelloConfig = {
-    anchorElementSelector: string;
-    cartUrlPattern: string | null;
-    /**
-     * The behavior to use when determining the country to use for the user.
-     * @default 'URL_PARAM'
-     */
-    countryOverrideBehavior?: CountryOverrideBehavior;
-    currencyBehavior: HelloCurrencyBehavior;
-    currencyElementSelector: string;
-    desktopLocation?: HelloMobileLocation | null;
-    excludedUrlPatterns: Array<string>;
-    homepageUrlPattern: string | null;
-    mobileLocation: HelloMobileLocation | null;
-    mode: Mode;
-    /**
-     * Position of floating hello if `anchorElementSelector` is not found after 3 seconds
-     *
-     * null: don't render if not found
-     *
-     * @default null
-     */
-    notFoundElementFallback: HelloMobileLocation | null;
-    organization: string;
-    peekMessageBehavior: HelloPeekMessageBehavior;
-    peekMessageDelay: number;
-    productAddToCartElementSelector: string | null;
-    productDescriptionElementSelector: string | null;
-    productDetailUrlPattern: string | null;
-    productListUrlPattern: string | null;
-    productTitleElementSelector: string | null;
-    restrictionBehavior: HelloRestrictionBehavior;
-    /**
-     * The countries to include in the country list dropdown of the Hello widget.
-     * @default ONLY_SHIPPABLE
-     */
-    showCountryList?: ShowCountryList;
-    /**
-     * The countries to show the widget for.
-     * @default ONLY_SHIPPABLE
-     */
-    showForCountries?: ShowForCountries;
-    visibilityStatus?: 'ENABLED' | 'DISABLED';
-    /**
-     * Callback function to run after the Hello widget has been initialized. This should be triggered only once when hello is attached to the DOM.
-     * **Note**: If hello is detached from the DOM and reattached, this callback will be called again.
-     * @param params - The parameters containing the country code and currency code that hello is initialized with.
-     */
-    onInitSuccess?: (params: {
-        countryCode: CountryCode;
-        currencyCode: CurrencyCode;
-    }) => Promise<void>;
-};
-
-type CountryFieldLabelStateLabel = 'Commune' | 'County' | 'County or sector' | 'Department' | 'Derzhava' | 'District' | 'Do/Si' | 'Island' | 'Municipality' | 'Oblast' | 'Parish' | 'Prefecture' | 'Province' | 'Region' | 'State' | 'State or Territory' | 'State or province' | 'Village';
-type CountryFieldLabelAddress1Label = 'Address line 1' | 'Address1' | 'Adresa vulytsi' | 'Street address' | 'Street or avenue' | 'Ulica';
-type CountryFieldLabelAddress2Label = '' | 'Address 2' | 'Address line 2' | 'Address2' | 'Sector' | 'Street address 2';
-type CountryFieldLabelAddress3Label = '' | 'Address line 3' | 'Address3' | 'CEDEX' | 'Street address 3';
-type CountryFieldLabelCityLabel = '' | 'Area' | 'City' | 'City/Town' | 'Emirate' | 'Gorod' | 'Locality' | 'Misto' | 'Town' | 'Town / City' | 'Town or city';
-type CountryFieldLabelZipLabel = '' | 'Code postal' | 'Indeks' | 'Kodepos' | 'Poshtovyy indeks' | 'Postal code' | 'Postcode' | 'ZIP code' | 'Zip';
-type ICountryFieldLabelRegion = {
-    interpayCode: string;
-};
-type CountryFields = {
-    address1Label: CountryFieldLabelAddress1Label;
-    address1Required: boolean;
-    address1Show: boolean;
-    address2Label: CountryFieldLabelAddress2Label;
-    address2Required: boolean;
-    address2Show: boolean;
-    address3Label: CountryFieldLabelAddress3Label;
-    address3Required: boolean;
-    address3Show: boolean;
-    cityLabel: CountryFieldLabelCityLabel;
-    cityRequired: boolean;
-    cityShow: boolean;
-    countryCode: CountryCode;
-    countryCodeLabel?: string;
-    displayName: string;
-    nameLabel: string;
-    phoneCode: number;
-    phoneFormat: string | null;
-    phonePlaceholder: string | null;
-    regions: Record<string, ICountryFieldLabelRegion> | null;
-    stateLabel: CountryFieldLabelStateLabel;
-    stateRequired: boolean;
-    stateShow: boolean;
-    zipFormat: string | null;
-    zipLabel: CountryFieldLabelZipLabel;
-    zipRegex: string | null;
-    zipRequired: boolean;
-    zipShow: boolean;
-};
-
-type GenericZonosSettings = {
-    /**
-     * Whether to enable company name input in the checkout.
-     */
-    companyNameInputEnabled?: boolean;
-    /**
-     * Country that should be enable the custom address fields in the checkout based on the country user is from.
-     */
-    countryCustomAddressEnabled?: CountryCode[];
-    /**
-     * List of countries and
-     */
-    countryFields?: Record<CountryCode, CountryFields>;
-    /**
-     * Use custom address fields in the checkout based on the country user is from.
-     */
-    shouldEnabledCustomAddress?: boolean;
-    /**
-     * Signed token for Google Places API iframe access.
-     */
-    signedTokenGooglePlaces?: string;
-    /**
-     * List of countries that are allowed to use USD denominated cards for settlement.
-     */
-    usdSettlementCountryEnabled?: CountryCode[];
-};
-
-type AppearanceConfig = {
-    colorPrimary?: string;
-    colorSecondary?: string;
-    fontFamily: string;
-    fontSize2XL?: number;
-    fontSize3XL?: number;
-    fontSizeBase?: number;
-    fontSizeInputLabel?: number;
-    fontSizeInputValue?: number;
-    fontSizeL?: number;
-    fontSizeS?: number;
-    fontSizeXL?: number;
-    fontSizeXS?: number;
-    logoUrl: string;
-    style: ElementsUiStyle;
-    theme: ElementsUiTheme;
-    zonosAttribution: ZonosAttribution | null;
-};
-
-declare const fallbackApiType: readonly ["cloudflare", "vercel"];
-type FallBackApiType = (typeof fallbackApiType)[number];
-
-type LogBulkLoadRequestPayload = {
-    data: {
-        apiType: FallBackApiType;
-        connectionType?: string;
-        href: string;
-        isHostedCheckout: boolean;
-        isMobile: boolean;
-        loadTimeBrowserApi: number;
-        loadTimeInternal: number;
-        loadTimeTotal: number;
-        metadata: Record<string, unknown>;
-        screenHeight: number;
-        screenWidth: number;
-        userAgent: string;
-    }[];
-    storeId: number;
-};
-
-type LoadTimeApiLogInfo = LogBulkLoadRequestPayload['data'][number];
-
-type CustomEventMap = {
-    legacyCheckoutError: string;
-    'zonos-checkout-success': {
-        message: string;
-    };
-};
-
-declare const _envClientSchema: z.ZodObject<{
-    NEXT_PUBLIC_FLAG_URL: z.ZodString;
-    NEXT_PUBLIC_RELEASE_DATE: z.ZodString;
-    NEXT_PUBLIC_ZONOS_API_KEY: z.ZodString;
-    NEXT_PUBLIC_ZONOS_CDNJS_CDN_URL: z.ZodString;
-    NEXT_PUBLIC_ZONOS_CDN_URL: z.ZodString;
-    NEXT_PUBLIC_ZONOS_CLOUDFLARE_URL: z.ZodString;
-    NEXT_PUBLIC_ZONOS_JS_DELIVR_CDN_URL: z.ZodString;
-    NEXT_PUBLIC_ZONOS_PACKAGE_VERSION: z.ZodString;
-    NEXT_PUBLIC_ZONOS_ROUTE_URL: z.ZodString;
-    NEXT_PUBLIC_ZONOS_UNPKG_CDN_URL: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    NEXT_PUBLIC_FLAG_URL: string;
-    NEXT_PUBLIC_RELEASE_DATE: string;
-    NEXT_PUBLIC_ZONOS_API_KEY: string;
-    NEXT_PUBLIC_ZONOS_CDNJS_CDN_URL: string;
-    NEXT_PUBLIC_ZONOS_CDN_URL: string;
-    NEXT_PUBLIC_ZONOS_CLOUDFLARE_URL: string;
-    NEXT_PUBLIC_ZONOS_JS_DELIVR_CDN_URL: string;
-    NEXT_PUBLIC_ZONOS_PACKAGE_VERSION: string;
-    NEXT_PUBLIC_ZONOS_ROUTE_URL: string;
-    NEXT_PUBLIC_ZONOS_UNPKG_CDN_URL: string;
-}, {
-    NEXT_PUBLIC_FLAG_URL: string;
-    NEXT_PUBLIC_RELEASE_DATE: string;
-    NEXT_PUBLIC_ZONOS_API_KEY: string;
-    NEXT_PUBLIC_ZONOS_CDNJS_CDN_URL: string;
-    NEXT_PUBLIC_ZONOS_CDN_URL: string;
-    NEXT_PUBLIC_ZONOS_CLOUDFLARE_URL: string;
-    NEXT_PUBLIC_ZONOS_JS_DELIVR_CDN_URL: string;
-    NEXT_PUBLIC_ZONOS_PACKAGE_VERSION: string;
-    NEXT_PUBLIC_ZONOS_ROUTE_URL: string;
-    NEXT_PUBLIC_ZONOS_UNPKG_CDN_URL: string;
-}>;
-interface Env extends z.infer<typeof _envClientSchema> {
-}
-
-/* eslint-disable no-relative-import-paths/no-relative-import-paths */
-
-declare global {
-  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
-  interface Document {
-    addEventListener<K extends keyof CustomEventMap>(
-      type: K,
-      listener: (this: Document, ev: CustomEvent<CustomEventMap[K]>) => void,
-    ): void;
-  }
-
-  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
-  interface Window {
-    Stripe?: StripeConstructor;
-    Zonos: Zonos;
-    /**
-     * A flag to determine if the current page is a BigCommerce page
-     */
-    bcConfig?: unknown;
-    /**
-     * This flag would be set to true if zonosQaUrl is present in the query params and preview script loadZonos.js is injected to DOM
-     */
-    isZonosPreview?: boolean;
-    /**
-     * A flag to determine if the current page is a BigCommerce page
-     */
-    stencilBootstrap?: unknown;
-  }
-
-  namespace NodeJS {
-    // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
-    interface ProcessEnv extends Env {}
-  }
-}
-
-type TranslatedText = {
-    [key: string]: string;
-};
-type EnteredInfo = {
-    city: string;
-    country: CountryCode;
-    email: string;
-    line1: string;
-    line2: string;
-    name: string;
-    phone: string;
-    postal_code: string;
-    state: string;
-};
-type ValidateAddressFields = Omit<StripeAddressElementChangeEvent['value']['address'], 'country'> & {
-    name: string;
-};
-type TranslatedAddressObject = {
-    [key in keyof ValidateAddressFields]?: TranslatedText;
-};
-
-type SubmitEventData = {
-    billingAddress: Record<keyof TranslatedAddressObject, string> | null;
-    shippingAddress: Record<keyof TranslatedAddressObject, string>;
-};
-
-declare const colorPrefixes: readonly ["blue", "cyan", "green", "orange", "purple", "red", "gray", "glass"];
-declare const colorContrasts: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
-type ColorContrast = (typeof colorContrasts)[number];
-type ColorPrefix = (typeof colorPrefixes)[number];
-type Color = 'gray-0' | 'gray-50' | 'glass-0' | 'glass-50' | `${ColorPrefix}-${ColorContrast}` | 'gray-1000' | 'glass-1100' | 'glass-1200';
-declare const checkboxColorPrefix: readonly ["blue", "cyan", "green", "orange", "purple", "red", "gray"];
-type CheckboxColorPrefix = (typeof checkboxColorPrefix)[number];
-
-type BannerIntent = 'default' | 'error' | 'success' | 'warning' | 'info';
-
-declare const textOptions: {
-    readonly pageHeader: {
-        readonly label: "Page Header (3XL) · 34px (2.125rem)";
-        readonly size: "3xl";
-        readonly tag: "h2";
-        readonly weight: 900;
-    };
-    readonly secondaryPageHeader: {
-        readonly label: "Secondary Page Header (3XL) • 34px, 500 \"Medium\"";
-        readonly size: "3xl";
-        readonly tag: "h2";
-        readonly weight: 500;
-    };
-    readonly header: {
-        readonly label: "Header (2XL) · 28px (1.75rem)";
-        readonly size: "2xl";
-        readonly tag: "h3";
-        readonly weight: 700;
-    };
-    readonly descriptionHeader: {
-        readonly label: "Description Header (2XL) · 28px (1.75rem)";
-        readonly size: "2xl";
-        readonly tag: "h3";
-        readonly weight: 700;
-    };
-    readonly title: {
-        readonly label: "Title (XL) • 22px (1.375rem)";
-        readonly size: "xl";
-        readonly tag: "h4";
-        readonly weight: 600;
-    };
-    readonly boldSubheader: {
-        readonly label: "Bold Subheader (L) • 18px (1.125rem)";
-        readonly size: "l";
-        readonly tag: "h5";
-        readonly weight: 700;
-    };
-    readonly semiBoldSubheader: {
-        readonly label: "Semi Bold Subheader (L / H4) • 18px (1.125rem)";
-        readonly size: "l";
-        readonly tag: "h5";
-        readonly weight: 600;
-    };
-    readonly subheader: {
-        readonly label: "Subheader (L) • 18px (1.125rem)";
-        readonly size: "l";
-        readonly tag: "h5";
-        readonly weight: 500;
-    };
-    readonly boldLabel: {
-        readonly label: "Bold Label (Base) • 14px (.875rem)";
-        readonly size: "base";
-        readonly tag: "span";
-        readonly weight: 700;
-    };
-    readonly semiBoldLabel: {
-        readonly label: "Semi Bold Label (Base) • 14px (.875rem)";
-        readonly size: "base";
-        readonly tag: "span";
-        readonly weight: 600;
-    };
-    readonly label: {
-        readonly label: "Label (Base) • 14px (.875rem)";
-        readonly size: "base";
-        readonly tag: "span";
-        readonly weight: 500;
-    };
-    readonly body: {
-        readonly label: "Body (Base) • 14px (.875rem)";
-        readonly size: "base";
-        readonly tag: "span";
-        readonly weight: 400;
-    };
-    readonly smallHeader: {
-        readonly label: "Small header (S) • 12px (.75rem)";
-        readonly size: "s";
-        readonly tag: "span";
-        readonly weight: 600;
-    };
-    readonly caption: {
-        readonly label: "Caption (S) • 12px (.75rem)";
-        readonly size: "s";
-        readonly tag: "span";
-        readonly weight: 400;
-    };
-    readonly hintText: {
-        readonly label: "Hint text (XS) • 10px (.625rem)";
-        readonly size: "xs";
-        readonly tag: "span";
-        readonly weight: 400;
-    };
-};
-type TextOptions = typeof textOptions;
-type Size = TextOptions[keyof TextOptions]['size'];
-type Type = keyof TextOptions;
-type FontWeight = TextOptions[keyof TextOptions]['weight'];
-
-type CustomAddressErrors = {
-    city: string;
-    firstName: string;
-    lastName: string;
-    line1: string;
-    phone: string;
-    postalCode: string;
-    /**
-     * Toggle to indicate if the error message should be shown
-     */
-    showError: boolean;
-    state: string;
-};
-
-type StripeStoreContactOption = {
-    address: {
-        city: string;
-        country: string;
-        line1: string;
-        line2?: string;
-        postal_code: string;
-        state: string;
-    };
-    email: string;
-    name: string;
-    phone?: string;
-};
-
-type NotificationInit = {
-    message: string;
-    /**
-     * Time in milliseconds
-     * @default 4000
-     */
-    timeout?: number;
-    /**
-     * Type of notification
-     * @default 'success'
-     */
-    type?: 'error' | 'success' | 'warning';
-};
-
-declare const localeElementsSupportedLocationCodeEnum: {
-    readonly Ar: "ar";
-    readonly Da: "da";
-    readonly De: "de";
-    readonly En: "en";
-    readonly Es: "es";
-    readonly Fr: "fr";
-    readonly He: "he";
-    readonly Id: "id";
-    readonly It: "it";
-    readonly Ja: "ja";
-    readonly Ko: "ko";
-    readonly Nl: "nl";
-    readonly No: "no";
-    readonly Pl: "pl";
-    readonly Pt: "pt";
-    readonly Ru: "ru";
-    readonly Sv: "sv";
-    readonly Tr: "tr";
-    readonly Vi: "vi";
-    readonly Zh: "zh";
-};
-type Locale_ElementsSupportedLocationCode_Enum = (typeof localeElementsSupportedLocationCodeEnum)[keyof typeof localeElementsSupportedLocationCodeEnum];
-
-type ICountry = {
-    bigcommerceDisplayName?: string;
-    code: CountryCode;
-    currencyCode: string;
-    displayName: string;
-    languageCode: Locale_ElementsSupportedLocationCode_Enum;
-};
-type ICountryJson = {
-    [countryCode: string]: ICountry;
-};
-
-type Items = CheckItemRestrictionsMutation['itemRestrictionApply']['items'];
-type RestrictedItem = Items[number] & {
-    name?: string;
-};
-
-declare const restStateType: readonly ["Boxes", "Earth", "EmptyBox", "Lock", "PigBank", "Scribble", "Search", "Settings", "ShoppingCart", "SpilledCup", "Switch", "TaxId", "Truck", "Warning"];
-type RestStateType = (typeof restStateType)[number];
-
-type ShippingRichRadioItem = {
-    amount: number;
-    caption?: string;
-    label: string;
-    landedCostId: string;
-    method: IncotermCode;
-    price: string;
-    shipmentRatingId: string;
-    sublabel?: string;
-    value: string | number;
+    usdSettlementCountryEnabled?: CountryCode[];
 };
 
-type SpinnerColor = 'primary' | 'info' | 'success' | 'danger' | 'warning' | 'black' | 'white';
-
 type ToggleItem<TValue> = {
     isDisabled?: boolean;
     label: string;
@@ -2908,6 +2546,27 @@ declare namespace Components {
          */
         "titleText": string;
     }
+    interface ZonosLoadingOverlay {
+        /**
+          * Whether or not the overlay is open
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * Spinner size (optional, default 40)
+         */
+        "size": number;
+        /**
+          * Spinner color (optional)
+         */
+        "spinnerColor"?: | 'primary'
+    | 'info'
+    | 'success'
+    | 'danger'
+    | 'warning'
+    | 'black'
+    | 'white';
+    }
     interface ZonosLogo {
         /**
           * Theme to change the color of the logo
@@ -3750,6 +3409,12 @@ declare global {
         prototype: HTMLZonosLinkAuthenticationElement;
         new (): HTMLZonosLinkAuthenticationElement;
     };
+    interface HTMLZonosLoadingOverlayElement extends Components.ZonosLoadingOverlay, HTMLStencilElement {
+    }
+    var HTMLZonosLoadingOverlayElement: {
+        prototype: HTMLZonosLoadingOverlayElement;
+        new (): HTMLZonosLoadingOverlayElement;
+    };
     interface HTMLZonosLogoElement extends Components.ZonosLogo, HTMLStencilElement {
     }
     var HTMLZonosLogoElement: {
@@ -3989,6 +3654,7 @@ declare global {
         "zonos-language-select": HTMLZonosLanguageSelectElement;
         "zonos-link": HTMLZonosLinkElement;
         "zonos-link-authentication": HTMLZonosLinkAuthenticationElement;
+        "zonos-loading-overlay": HTMLZonosLoadingOverlayElement;
         "zonos-logo": HTMLZonosLogoElement;
         "zonos-notification": HTMLZonosNotificationElement;
         "zonos-payment": HTMLZonosPaymentElement;
@@ -4901,6 +4567,27 @@ declare namespace LocalJSX {
          */
         "titleText": string;
     }
+    interface ZonosLoadingOverlay {
+        /**
+          * Whether or not the overlay is open
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * Spinner size (optional, default 40)
+         */
+        "size"?: number;
+        /**
+          * Spinner color (optional)
+         */
+        "spinnerColor"?: | 'primary'
+    | 'info'
+    | 'success'
+    | 'danger'
+    | 'warning'
+    | 'black'
+    | 'white';
+    }
     interface ZonosLogo {
         /**
           * Theme to change the color of the logo
@@ -5313,6 +5000,7 @@ declare namespace LocalJSX {
         "zonos-language-select": ZonosLanguageSelect;
         "zonos-link": ZonosLink;
         "zonos-link-authentication": ZonosLinkAuthentication;
+        "zonos-loading-overlay": ZonosLoadingOverlay;
         "zonos-logo": ZonosLogo;
         "zonos-notification": ZonosNotification;
         "zonos-payment": ZonosPayment;
@@ -5375,6 +5063,7 @@ declare module "@stencil/core" {
             "zonos-language-select": LocalJSX.ZonosLanguageSelect & JSXBase.HTMLAttributes<HTMLZonosLanguageSelectElement>;
             "zonos-link": LocalJSX.ZonosLink & JSXBase.HTMLAttributes<HTMLZonosLinkElement>;
             "zonos-link-authentication": LocalJSX.ZonosLinkAuthentication & JSXBase.HTMLAttributes<HTMLZonosLinkAuthenticationElement>;
+            "zonos-loading-overlay": LocalJSX.ZonosLoadingOverlay & JSXBase.HTMLAttributes<HTMLZonosLoadingOverlayElement>;
             "zonos-logo": LocalJSX.ZonosLogo & JSXBase.HTMLAttributes<HTMLZonosLogoElement>;
             "zonos-notification": LocalJSX.ZonosNotification & JSXBase.HTMLAttributes<HTMLZonosNotificationElement>;
             "zonos-payment": LocalJSX.ZonosPayment & JSXBase.HTMLAttributes<HTMLZonosPaymentElement>;
@@ -5405,6 +5094,74 @@ declare module "@stencil/core" {
     }
 }
 
+type CalculateLandedCostAdjustmentInput = {
+    amount: number;
+    name?: string | null;
+    productId: string | null;
+    promoCode?: string | null;
+    sku: string | null;
+    type: LandedCostAdjustmentType;
+};
+type Extensions = {
+    [key: string]: unknown;
+} & {
+    rule?: {
+        description: string;
+        id: string;
+        name: string;
+    };
+    ruleMessageType?: 'CUSTOM' | 'DEFAULT';
+};
+type ApiError = {
+    extensions?: Extensions | null;
+    message: string;
+};
+type CalculateLandedCostRequest = {
+    billingAddress: {
+        addressLine1: string;
+        addressLine2?: string | undefined;
+        city: string;
+        country: CountryCode;
+        postalCode: string;
+        state: string;
+    };
+    billingContact: {
+        firstName: string;
+        lastName: string;
+        phone: string;
+    };
+    checkoutSessionId: string;
+    contact: {
+        companyName?: string;
+        email?: string;
+        firstName: string;
+        lastName: string;
+        phone: string;
+    };
+    /**
+     * When this is set, the created quote will not be shown on the Quote List page in the Zonos Dashboard.
+     */
+    isTest?: boolean;
+    items: CartItem[];
+    landedCostAdjustments?: CalculateLandedCostAdjustmentInput[];
+    metadata?: {
+        key: string;
+        value: string;
+    }[];
+    /**
+     * TaxId that the some destination countries require for the shipment.
+     */
+    shipToTaxId?: string;
+    shippingAddress: {
+        addressLine1: string;
+        addressLine2?: string | undefined;
+        city: string;
+        country: CountryCode;
+        postalCode: string;
+        state: string;
+    };
+};
+
 type NormalizedItemAttribute = {
     key: string;
     value: string;
@@ -5423,50 +5180,371 @@ type NormalizedTempCartItem = {
         unitOfMeasure: ItemUnitOfMeasure;
         value: number;
     }[];
-    name: string | null;
-    productId: string | null;
-    quantity: number;
-    sku: string | null;
+    name: string | null;
+    productId: string | null;
+    quantity: number;
+    sku: string | null;
+};
+type NormalizedTempCart = {
+    adjustments: {
+        amount: number;
+        currencyCode: CurrencyCode;
+        description: string | null;
+        productId: string | null;
+        promoCode?: string | null;
+        sku: string | null;
+        type: CartAdjustmentType;
+    }[];
+    createdAt: string;
+    credentialToken: string;
+    id: string;
+    items: NormalizedTempCartItem[];
+    metadata: {
+        key: string;
+        value: string;
+    }[];
+    storeBaseUrl: string;
+    storeId: number;
+};
+type Settings = Omit<CartCheckoutWorkflowQuery['cartCheckoutWorkflow'], 'cart'> & {
+    genericSettings: GenericZonosSettings | null;
+};
+type CartCheckoutResult = {
+    cartData: NormalizedTempCart;
+    settings: Settings & {
+        organization: {
+            id: string;
+            name: string;
+            references: {
+                storeId: number | null;
+            } | null;
+        };
+    };
+    storeFaviconUrl: string;
+    storeLogoUrl: string;
+};
+
+type BuildLandedCostParams = {
+    billingAddress: CalculateLandedCostRequest['billingAddress'];
+    billingContact: CalculateLandedCostRequest['billingContact'];
+    checkoutSessionId: string;
+    contact: CalculateLandedCostRequest['contact'];
+    landedCostAdjustments?: CalculateLandedCostRequest['landedCostAdjustments'];
+    publicCredential: string;
+    shippingAddress: CalculateLandedCostRequest['shippingAddress'];
+    zonosApiRoute: string;
+};
+type BuildLandedCostResponse = (CalculateLandedCostMutation & {
+    errors: ApiError[];
+}) | null;
+
+type ZonosOrder = GetOrderQuery['order'];
+
+type BuildCardDetailParams = {
+    countryCode: CountryCode;
+    currencyCode: CurrencyCode;
+};
+type PromiseOrValue<T> = T | Promise<T>;
+type PrefillAddress = {
+    customerAddress1: string;
+    customerAddress2?: string;
+    customerCity?: string;
+    /**
+     * If country is not provided, it will try to pull from query params `zCountry` or `country` or `customerCountry` in the URL or fallback to user's selected country
+     */
+    customerCountry?: string;
+    customerEmail: string;
+    /**
+     * Will use this value to prefill the first name field in the checkout form instead of `customerName`
+     */
+    customerFirstName: string;
+    /**
+     * Will use this value to prefill the last name field in the checkout form instead of `customerName`
+     */
+    customerLastName: string;
+    /**
+     * Will use this value to prefill if customerFirstName and customerLastName are not provided
+     * @deprecated Use `customerFirstName` and `customerLastName` since Checkout uses 2 inputs for first and last name, there is not a good way to split the name into first and last name for some countries.
+     */
+    customerName?: string;
+    customerPhone: string;
+    customerState?: string;
+    customerZip: string;
+};
+type CreateCartIdObject = {
+    cartId: string;
+    customerAuthenticationToken?: string;
+    shippingData?: PrefillAddress | null;
+};
+type CheckoutConfig = {
+    /**
+     * Validate address to allow specific character sets
+     * @default ALL
+     */
+    allowedCharacterSets?: 'ALL' | 'LATIN';
+    /**
+     * Enable settlement currencies to pay in USD
+     * @default LOCAL
+     */
+    allowedSettlementCurrencies: AllowedSettlementCurrencies;
+    /**
+     * Always trigger International Checkout with this selector regardless of shipping zone
+     */
+    alwaysTriggerInternationalCheckoutSelector?: string | null;
+    analyticsProviders: Array<{
+        status: AnalyticsProviderStatus;
+        type: AnalyticsProviderType;
+    }>;
+    /**
+     * Time that payment will be captured after the order is placed. Can't be overridden in Zonos.init
+     */
+    captureDelay?: number;
+    /**
+     * @default DISABLED - when false, company fields would not show up in the checkout form
+     */
+    companyFieldsStatus: 'ENABLED' | 'DISABLED';
+    /**
+     * Duration (in seconds) for which the cart remains valid for checkout in hosted checkout.
+     * @default 3_600 (1 hour)
+     */
+    defaultCartExpiration?: number;
+    /**
+     * @default false - when false, the place order button will be disabled until the script is loaded
+     * @note if set to true, the place order button will not be enabled or disabled
+     */
+    disablePlaceOrderButtonActivation?: boolean;
+    externalPaymentMethods: Array<{
+        status: ExternalPaymentMethodStatus;
+        type: ExternalPaymentMethodType;
+    }> | null;
+    externalServiceTokens: {
+        token: string;
+        type: ExternalServiceTokenType;
+    }[];
+    /**
+     * Test mode for checkout (sandbox or production)
+     * @default TEST
+     */
+    mode: Mode;
+    orderNotifications: {
+        abandonedCart: {
+            delay: number;
+            discountPercent: number;
+            status: {
+                active: NotificationActiveStatus;
+                sendCopiesTo: Array<string>;
+            };
+        };
+        orderCancelled: {
+            active: NotificationActiveStatus;
+            sendCopiesTo: Array<string>;
+        };
+        orderShipped: {
+            active: NotificationActiveStatus;
+            sendCopiesTo: Array<string>;
+        };
+    };
+    organization: string;
+    /**
+     * Place order button selector that only trigger International Checkout when shopper is in merchant's shipping zones
+     */
+    placeOrderButtonSelector: string | null;
+    /**
+     * @param subscriptionStatus subscription status for checkout, checkout only available if subscription status is ENABLED and visibility status is ENABLED
+     *
+     * **NOTE: this value can't be overridden in Zonos.init**
+     */
+    subscriptionStatus: CheckoutSubscriptionStatus;
+    successBehavior: CheckoutSuccessBehavior;
+    /**
+     * The success page action text for checkout.
+     * @note Default text supports translation automatically, but any custom text will not be translated.
+     */
+    successPageActionText?: string;
+    /**
+     * The success page subtitle text for checkout. Each item in the array will appear on a new line.
+     * @note Default text supports translation automatically, but any custom text will not be translated.
+     */
+    successPageSubtitleText?: string[];
+    /**
+     * The success page title text for checkout.
+     * @note Default text supports translation automatically, but any custom text will not be translated.
+     */
+    successPageTitleText?: string;
+    successRedirectUrl: string;
+    visibilityStatus: CheckoutVisibilityStatus;
+    /**
+     * Cart info callback for checkout (optional),
+     * @deprecated This is deprecated in favor of the new callback `createCartId`. The new API would only need the cart ID to retrieve cart data.
+     * @note will attempt to use cart data if available
+     * User can dispatch an event 'zonos--init-cart-info' to update the cart
+     * @example
+     * const initEvent = new CustomEvent<CartItem[]>('zonos--init-cart-info', {
+     *    detail: cartItems,
+     * });
+     * document.body.dispatchEvent(initEvent);
+     * @returns {object[]} - object with the the item info to be added to cart:
+     * - amount: number;
+     * - countryOfOrigin?: string;
+     * - currencyCode: string;
+     * - description?: string;
+     * - hsCode?: string;
+     * - imageUrl?: string;
+     * - name: string;
+     * - productId?: string;
+     * - quantity: number;
+     */
+    buildCartDetail?: (params: BuildCardDetailParams) => Promise<CartItem[]>;
+    /**
+     * Calculate landed cost callback for checkout (optional)
+     * @deprecated This is deprecated in favor of the new callback `createCartId`. When using the new callback, the cart details will be retrieved using the cart ID, so this callback would no longer be needed.
+     * @note will attempt to use cart data if available
+     */
+    buildLandedCost?: (params: BuildLandedCostParams) => Promise<BuildLandedCostResponse>;
+    /**
+     * A callback that returns the cart id from `cartCreate` mutation. You would use your cart data to call the `cartCreate` mutation and return the cart ID that was created.
+     * @note
+     * The mutation `cartCreate` should be called on the server side
+     * @returns string - Cart ID
+     */
+    createCartId?: () => PromiseOrValue<string | CreateCartIdObject>;
+    /**
+     * Callback trigger when the checkout is closed
+     */
+    onClose?: () => void;
+    /**
+     * This callback is optional. If provided, it will be called right before the payment is processed.
+     * @param items - The cart items.
+     * @returns {string | null} - The error message to display to the user. If the message is empty or null, the payment will proceed.
+     * @example
+     * onInventoryCheck: async ({ items }) => {
+     *   // Check if all items are available from the server. If the fetch is throwing an error, show a generic error message "Unable to check inventory. Please try again.".
+     *   const itemsInfo = await fetch('https://yourserver.com/api/get-available-items', {
+     *     method: 'POST',
+     *     body: JSON.stringify({ items }),
+     *   });
+     *   const items = await itemsInfo.json();
+     *   // Filter out unavailable items.
+     *   const unavailableItems = items.filter(item => !item.available);
+     *   if (unavailableItems.length) {
+     *     // Display an error message to the user.
+     *     return `The following items are not available: ${unavailableItems.map(item => item.name).join(', ')}`;
+     *   }
+     *   // Proceed with the payment if you return an empty string or null.
+     *   return '';
+     * }
+     */
+    onInventoryCheck?: (params: {
+        items: CartItem[];
+    }) => Promise<string | null>;
+    /**
+     * Callback trigger when payment succeeds
+     */
+    onOrderSuccess?: (props: {
+        zonosApiRoute: string;
+        zonosOrder: ZonosOrder;
+    }) => Promise<void>;
 };
-type NormalizedTempCart = {
-    adjustments: {
-        amount: number;
+
+type CountryOverrideBehavior = 'URL_PARAM' | 'SESSION';
+type ShowForCountries = 'ALL' | 'ONLY_SHIPPABLE' | CountryCode[];
+type ShowCountryList = 'ALL' | 'ONLY_SHIPPABLE' | CountryCode[];
+type HelloConfig = {
+    anchorElementSelector: string;
+    cartUrlPattern: string | null;
+    /**
+     * The behavior to use when determining the country to use for the user.
+     * @default 'URL_PARAM'
+     */
+    countryOverrideBehavior?: CountryOverrideBehavior;
+    currencyBehavior: HelloCurrencyBehavior;
+    currencyElementSelector: string;
+    desktopLocation?: HelloMobileLocation | null;
+    excludedUrlPatterns: Array<string>;
+    homepageUrlPattern: string | null;
+    mobileLocation: HelloMobileLocation | null;
+    mode: Mode;
+    /**
+     * Position of floating hello if `anchorElementSelector` is not found after 3 seconds
+     *
+     * null: don't render if not found
+     *
+     * @default null
+     */
+    notFoundElementFallback: HelloMobileLocation | null;
+    organization: string;
+    peekMessageBehavior: HelloPeekMessageBehavior;
+    peekMessageDelay: number;
+    productAddToCartElementSelector: string | null;
+    productDescriptionElementSelector: string | null;
+    productDetailUrlPattern: string | null;
+    productListUrlPattern: string | null;
+    productTitleElementSelector: string | null;
+    restrictionBehavior: HelloRestrictionBehavior;
+    /**
+     * The countries to include in the country list dropdown of the Hello widget.
+     * @default ONLY_SHIPPABLE
+     */
+    showCountryList?: ShowCountryList;
+    /**
+     * The countries to show the widget for.
+     * @default ONLY_SHIPPABLE
+     */
+    showForCountries?: ShowForCountries;
+    visibilityStatus?: 'ENABLED' | 'DISABLED';
+    /**
+     * Callback function to run after the Hello widget has been initialized. This should be triggered only once when hello is attached to the DOM.
+     * **Note**: If hello is detached from the DOM and reattached, this callback will be called again.
+     * @param params - The parameters containing the country code and currency code that hello is initialized with.
+     */
+    onInitSuccess?: (params: {
+        countryCode: CountryCode;
         currencyCode: CurrencyCode;
-        description: string | null;
-        productId: string | null;
-        promoCode?: string | null;
-        sku: string | null;
-        type: CartAdjustmentType;
-    }[];
-    createdAt: string;
-    credentialToken: string;
-    id: string;
-    items: NormalizedTempCartItem[];
-    metadata: {
-        key: string;
-        value: string;
+    }) => Promise<void>;
+};
+
+declare const fallbackApiType: readonly ["cloudflare", "vercel"];
+type FallBackApiType = (typeof fallbackApiType)[number];
+
+type LogBulkLoadRequestPayload = {
+    data: {
+        apiType: FallBackApiType;
+        connectionType?: string;
+        href: string;
+        isHostedCheckout: boolean;
+        isMobile: boolean;
+        loadTimeBrowserApi: number;
+        loadTimeInternal: number;
+        loadTimeTotal: number;
+        metadata: Record<string, unknown>;
+        screenHeight: number;
+        screenWidth: number;
+        userAgent: string;
     }[];
-    storeBaseUrl: string;
     storeId: number;
 };
-type Settings = Omit<CartCheckoutWorkflowQuery['cartCheckoutWorkflow'], 'cart'> & {
-    genericSettings: GenericZonosSettings | null;
-};
-type CartCheckoutResult = {
-    cartData: NormalizedTempCart;
-    settings: Settings & {
-        organization: {
-            id: string;
-            name: string;
-            references: {
-                storeId: number | null;
-            } | null;
-        };
-    };
-    storeFaviconUrl: string;
-    storeLogoUrl: string;
+
+type AppearanceConfig = {
+    colorPrimary?: string;
+    colorSecondary?: string;
+    fontFamily: string;
+    fontSize2XL?: number;
+    fontSize3XL?: number;
+    fontSizeBase?: number;
+    fontSizeInputLabel?: number;
+    fontSizeInputValue?: number;
+    fontSizeL?: number;
+    fontSizeS?: number;
+    fontSizeXL?: number;
+    fontSizeXS?: number;
+    logoUrl: string;
+    style: ElementsUiStyle;
+    theme: ElementsUiTheme;
+    zonosAttribution: ZonosAttribution | null;
 };
 
+type LoadTimeApiLogInfo = LogBulkLoadRequestPayload['data'][number];
+
 type TrackEventLog = {
     checkoutSessionId: string | null;
     eventCreated: number;