@zonos/elements 1.3.255 → 1.3.257

package/dist/types/components/store/translationStore/strings.norwegian.d.ts

@@ -128,6 +128,9 @@ export declare const stringsNorwegian: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsNorwegian: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsNorwegian: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsNorwegian: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.polish.d.ts

@@ -128,6 +128,9 @@ export declare const stringsPolish: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsPolish: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsPolish: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsPolish: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.portuguese.d.ts

@@ -128,6 +128,9 @@ export declare const stringsPortuguese: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsPortuguese: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsPortuguese: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsPortuguese: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.russian.d.ts

@@ -128,6 +128,9 @@ export declare const stringsRussian: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsRussian: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsRussian: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsRussian: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.spanish.d.ts

@@ -128,6 +128,9 @@ export declare const stringsSpanish: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsSpanish: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsSpanish: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsSpanish: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.swedish.d.ts

@@ -128,6 +128,9 @@ export declare const stringsSwedish: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsSwedish: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsSwedish: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsSwedish: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.turkish.d.ts

@@ -128,6 +128,9 @@ export declare const stringsTurkish: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsTurkish: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsTurkish: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsTurkish: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/store/translationStore/strings.vietnamese.d.ts

@@ -128,6 +128,9 @@ export declare const stringsVietnamese: {
     Contact: {
         value: string;
     };
+    'Continue to international checkout': {
+        value: string;
+    };
     'Continue to shipping': {
         value: string;
     };
@@ -284,6 +287,9 @@ export declare const stringsVietnamese: {
     Indeks: {
         value: string;
     };
+    'International shipping address detected': {
+        value: string;
+    };
     'Invalid CUIT/CUIL format. Must contain 11 digits, with or without dashes (XX-XXXXXXXX-X).': {
         value: string;
     };
@@ -587,6 +593,9 @@ export declare const stringsVietnamese: {
     'State/Province/Region/Prefecture': {
         value: string;
     };
+    'Stay on this page': {
+        value: string;
+    };
     'Store credit': {
         value: string;
     };
@@ -773,6 +782,9 @@ export declare const stringsVietnamese: {
     'Your payment went through successfully! Thank you for shopping with us! We hope you had an enjoyable experience and your support means the world to us.': {
         value: string;
     };
+    'Your saved default address ships internationally. Would you like to continue to international checkout, or stay here and select a domestic address?': {
+        value: string;
+    };
     'Your selected payment method requires additional verification. Please follow the instructions provided by your payment provider to complete the transaction.': {
         value: string;
     };

package/dist/types/components/utils/api/getLocaleMessages.d.ts

@@ -4,7 +4,7 @@ export declare const getLocaleMessages: ({ countryCode, localeTo, storeId, }: {
     localeTo?: string;
     storeId: number;
 }) => Promise<{
-    countryCodes: Array<string> | null;
+    countryCodes: Array<string>;
     countryCodesPageMessageLinks: Array<{
         id: number;
         message: {

package/dist/types/components/utils/checkout/bigcommerceStorefrontApi.d.ts

@@ -0,0 +1,36 @@
+/**
+ * BigCommerce Storefront API checkout response shape — partial, only the
+ * fields we consume.
+ */
+export type BigCommerceCheckoutResponse = {
+    consignments?: {
+        shippingAddress?: {
+            address1?: string;
+            address2?: string;
+            city?: string;
+            countryCode?: string;
+            firstName?: string;
+            lastName?: string;
+            phone?: string;
+            postalCode?: string;
+            stateOrProvince?: string;
+        };
+    }[];
+    customer?: {
+        customerGroup?: {
+            id: number;
+        };
+        id?: number;
+    };
+};
+/**
+ * Fetch the checkout/cart ID from the BigCommerce Storefront Cart API.
+ * The `/checkout` page URL does not include the checkout ID, so we
+ * retrieve it from `/api/storefront/cart` which returns the active cart(s).
+ */
+export declare const fetchCheckoutId: () => Promise<string | null>;
+/**
+ * Fetch checkout data from the BigCommerce Storefront API.
+ * This API is cookie-authenticated (same-origin), so no token is needed.
+ */
+export declare const fetchBigCommerceCheckout: (checkoutId: string) => Promise<BigCommerceCheckoutResponse | null>;

package/dist/types/components/utils/checkout/buildBigcommerceRedirectUrl.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build an absolute redirect URL used by the BigCommerce checkout flows to
+ * navigate between the BC native `/checkout` page and the Zonos international
+ * checkout at `/`.
+ *
+ * Carries over the `zonosQaUrl` query param from the current URL (when
+ * present) so the preview Zonos elements build keeps loading after the
+ * redirect, and sets `zonosTestMode=1` when test mode is active so the
+ * destination page continues to use the test credentials.
+ */
+export declare const buildBigcommerceRedirectUrl: (pathname: string) => string;

package/dist/types/components/utils/checkout/checkBigCommerceBypassCustomerGroup.d.ts

@@ -0,0 +1,30 @@
+type BypassResult = {
+    customerGroupId: number | null;
+    shouldBypass: boolean;
+};
+/**
+ * Start fetching the BigCommerce customer group on page load.
+ * Call this once during initialization (e.g. in `zonos-checkout.init()`).
+ * The fetch runs in the background; `checkBigCommerceBypassCustomerGroup`
+ * will await the result when needed.
+ */
+export declare const initBigCommerceBypassCheck: () => void;
+/**
+ * Check if the current BigCommerce customer belongs to a customer group
+ * that should bypass Zonos Checkout.
+ *
+ * If `initBigCommerceBypassCheck` was called on page load and the resulting
+ * outcome was conclusive, this returns the already-resolved (or in-flight)
+ * result without making additional API calls. If the previous outcome was
+ * inconclusive (no cart, settings not loaded), the cache was invalidated
+ * automatically and this triggers a fresh fetch.
+ *
+ * @param options.forceRefresh - When true, bypasses any cached result and
+ * always fetches fresh BigCommerce checkout data. Use this on the
+ * BigCommerce domestic checkout page when the shipping country changes,
+ * to ensure the customer group reflects the current checkout state.
+ */
+export declare const checkBigCommerceBypassCustomerGroup: (options?: {
+    forceRefresh?: boolean;
+}) => Promise<BypassResult>;
+export {};

package/dist/types/components/utils/checkout/watchImmediateBigcommerceDomesticCheckoutRedirect.d.ts

@@ -4,6 +4,21 @@ type Params = {
      * Action trigger when country select is selected with international shipping country
      */
     onInternationalCheckoutSelected?: () => Promise<void>;
+    /**
+     * Called when a logged-in user is detected on the BigCommerce native
+     * `/checkout` page with a saved default shipping address that is
+     * internationally shippable. The implementer should prompt the user to
+     * choose between proceeding to the Zonos international checkout or staying
+     * on the BigCommerce native checkout (so they can pick a domestic address
+     * instead).
+     *
+     * When omitted, the redirect is performed automatically (legacy behavior).
+     *
+     * @returns `'redirect'` to perform the international redirect, or `'stay'`
+     * to keep the user on the BigCommerce native checkout. Once `'stay'` is
+     * returned the watcher will not prompt again for the rest of the session.
+     */
+    onLoggedInInternationalAddressDetected?: () => Promise<'redirect' | 'stay'>;
     onShippingAddressSessionFound?: (shippingAddress: {
         address1: string;
         address2: string;
@@ -20,5 +35,5 @@ type Params = {
  * Watch for changes in domestic checkout step. Redirects user to home page to open international checkout when user selects a country in the international shipping zone.
  * @note Only works on default bigcommerce checkout page
  */
-export declare const watchImmediateBigcommerceDomesticCheckoutRedirect: ({ domesticRedirectedBtnSelector, onInternationalCheckoutSelected, onShippingAddressSessionFound, }: Params) => void;
+export declare const watchImmediateBigcommerceDomesticCheckoutRedirect: ({ domesticRedirectedBtnSelector, onInternationalCheckoutSelected, onLoggedInInternationalAddressDetected, onShippingAddressSessionFound, }: Params) => void;
 export {};

package/dist/types/scripts/cart/_setupCartDataWithSettings.d.ts

@@ -135,8 +135,20 @@ export declare const setupCartDataWithSettings: (cartId: string) => Promise<{
             allowedDomains: Array<string>;
             anchorElementSelector: string;
             cartUrlPattern: string | null;
+            countryDisplayRules: {
+                countrySelector: {
+                    behavior: import("../../types/generated/graphql.internal.types").HelloCountryDisplayBehavior;
+                    excludedCountries: Array<import("../..").CountryCode>;
+                    includedCountries: Array<import("../..").CountryCode>;
+                };
+                widgetVisibility: {
+                    behavior: import("../../types/generated/graphql.internal.types").HelloCountryDisplayBehavior;
+                    excludedCountries: Array<import("../..").CountryCode>;
+                    includedCountries: Array<import("../..").CountryCode>;
+                };
+            };
             createdAt: string;
-            createdBy: string;
+            organization: string;
             currencyBehavior: import("../../types/generated/graphql.internal.types").HelloCurrencyBehavior;
             currencyElementSelector: string;
             desktopLocation: import("../../types/generated/graphql.internal.types").HelloDesktopLocation;
@@ -146,15 +158,15 @@ export declare const setupCartDataWithSettings: (cartId: string) => Promise<{
             id: string;
             mobileLocation: import("../..").HelloMobileLocation;
             mode: import("../../types/generated/graphql.internal.types").Mode;
-            organization: string;
+            productTitleElementSelector: string | null;
             peekMessageBehavior: import("../../types/generated/graphql.internal.types").HelloPeekMessageBehavior;
-            productDetailUrlPattern: string | null;
+            peekMessageDelay: number;
             productAddToCartElementSelector: string | null;
-            productDescriptionElementSelector: string | null;
             productListUrlPattern: string | null;
-            peekMessageDelay: number;
+            productDetailUrlPattern: string | null;
+            createdBy: string;
             productPriceElementSelector: string | null;
-            productTitleElementSelector: string | null;
+            productDescriptionElementSelector: string | null;
             restrictionBehavior: import("../../types/generated/graphql.internal.types").HelloRestrictionBehavior;
             updatedAt: string;
             updatedBy: string;

package/dist/types/types/generated/graphql.frontend.types.d.ts

@@ -727,7 +727,7 @@ export type FailToGetQuoteErrorsQuery = {
 };
 export type LocaleCountryMessagesQuery = {
     locale_countryCodesPage: Array<{
-        countryCodes: Array<string> | null;
+        countryCodes: Array<string>;
         countryCodesPageMessageLinks: Array<{
             id: number;
             message: {

package/dist/types/types/generated/graphql.frontend.types.ts

@@ -684,7 +684,7 @@ export type FailToGetQuoteErrorsQuery = {
 
 export type LocaleCountryMessagesQuery = {
   locale_countryCodesPage: Array<{
-    countryCodes: Array<string> | null;
+    countryCodes: Array<string>;
     countryCodesPageMessageLinks: Array<{
       id: number;
       message: {