@zonos/elements 1.3.288 → 1.3.290

package/dist/collection/utils/formattedCloudflareApiUrl.js

@@ -11,6 +11,7 @@ import { generateCloudflareDeployUrl } from "./generateCloudflareDeployUrl";
  * "url" is the API url in Cloudflare
  * @returns
  * - `https://<branch_name>.<project_name>.pages.dev` if is Preview
+ *   (Pages branch aliases; Workers previews use versioned `*.workers.dev` URLs)
  * - `https://route.elements.zonos.com` if is Production
  */
 export const formattedCloudflareApiUrl = ({ branchName, inCI: _inCI, inGithubAction, inVercel: _inVercel, isVercelPreview: _isVercelPreview, url, }) => {

package/dist/collection/utils/generateCloudflareDeployUrl.js

@@ -1,8 +1,11 @@
 /**
- * Generate a Cloudflare deploy URL based on the branch name and project name
+ * Generate a Cloudflare Pages-style deploy URL based on the branch name and project name.
+ * Workers preview URLs are version-prefixed (`<version>-<worker>.<account>.workers.dev`)
+ * and cannot be derived from a branch name, so Pages aliases remain the preview mapping
+ * until a matching Workers alias exists.
  * @note not including https://
  * @return {url} string
- * @urlExample build-cloudflare-2.zonos-elements.page.dev
+ * @urlExample build-cloudflare-2.zonos-elements.pages.dev
  */
 export const generateCloudflareDeployUrl = ({ branchName, projectName, }) => {
     const normalizedProjectName = projectName.toLowerCase().replace(/\s+/g, '-');

package/dist/esm/{cart-ekBk_gxV.js → cart-Cleo1j5P.js}

@@ -1,9 +1,9 @@
-import { c as createStore, z as zonosStore } from './zonosStore-DrIOAz4M.js';
-import { s as storageStore, t as translate, k as getOverridenZCountry, l as localizationStore, f as filterValidTests, d as storageStoreSetEnabledVariantTestKeys } from './localization-AOqYXGdP.js';
+import { c as createStore, z as zonosStore } from './zonosStore-msUlqmSD.js';
+import { s as storageStore, t as translate, m as getOverridenZCountry, l as localizationStore, f as filterValidTests, e as storageStoreSetEnabledVariantTestKeys } from './localization-BiL8bPsY.js';
 import { l as log, b as allLogs } from './VarianceTest-BJmZPrZl.js';
 import { h as handleFetch, l as logError, f as fallbackApiList, g as getIsTestMode, a as getIsStagingMode, s as sendErrorLog, j as jsonParse } from './handleFetch-D5GYDF-O.js';
 import { i as isDarkColor } from './isDarkColor-YdrG78th.js';
-import { g as getBorderRadius } from './getBorderRadius-HwG64EKM.js';
+import { g as getBorderRadius } from './getBorderRadius-DYfkeXdx.js';
 import { e as euCountryCodes } from './TaxId-Cye-evFK.js';
 
 const getCheckoutSession = async () => {

package/dist/esm/{collect-33rMINDo.js → collect-CspdWIRo.js}

@@ -1,8 +1,8 @@
-import { c as createStore, z as zonosStore } from './zonosStore-DrIOAz4M.js';
-import { t as translate, l as localizationStore, s as storageStore } from './localization-AOqYXGdP.js';
+import { c as createStore, z as zonosStore } from './zonosStore-msUlqmSD.js';
+import { t as translate, l as localizationStore, s as storageStore } from './localization-BiL8bPsY.js';
 import { l as logError$1, h as handleFetch, s as sendErrorLog } from './handleFetch-D5GYDF-O.js';
 import { l as log, b as allLogs } from './VarianceTest-BJmZPrZl.js';
-import { d as cartStore, Y as cartStoreUpdateSelectedShippingOption, b as stripeStore, a0 as stripeStoreBuildAddressForPartyCreate } from './cart-ekBk_gxV.js';
+import { d as cartStore, Y as cartStoreUpdateSelectedShippingOption, b as stripeStore, a0 as stripeStoreBuildAddressForPartyCreate } from './cart-Cleo1j5P.js';
 
 // src/constant/common.ts
 function _array_like_to_array(arr, len) {

package/dist/esm/{debounce-D4ko2kvZ.js → debounce-BR3PaG8X.js}

@@ -1,4 +1,4 @@
-import { f as require_root, h as require_baseGetTag, i as requireIsObjectLike, r as requireIsObject } from './zonosStore-DrIOAz4M.js';
+import { f as require_root, h as require_baseGetTag, i as requireIsObjectLike, r as requireIsObject } from './zonosStore-msUlqmSD.js';
 
 var now_1;
 var hasRequiredNow;

package/dist/esm/{debounce-DWPsxJsW.js → debounce-CrmpwbEE.js}

@@ -1,5 +1,5 @@
-import { e as getDefaultExportFromCjs } from './zonosStore-DrIOAz4M.js';
-import { r as requireDebounce } from './debounce-D4ko2kvZ.js';
+import { e as getDefaultExportFromCjs } from './zonosStore-msUlqmSD.js';
+import { r as requireDebounce } from './debounce-BR3PaG8X.js';
 
 var debounceExports = requireDebounce();
 var debounce = /*@__PURE__*/getDefaultExportFromCjs(debounceExports);

package/dist/esm/{getBorderRadius-HwG64EKM.js → getBorderRadius-DYfkeXdx.js}

@@ -1,4 +1,4 @@
-import { z as zonosStore } from './zonosStore-DrIOAz4M.js';
+import { z as zonosStore } from './zonosStore-msUlqmSD.js';
 
 /**
  * Get the border radius for the elements based on the style

package/dist/esm/{getMissingRequiredShippingFields-u1nhQzJ1.js → getMissingRequiredShippingFields-B1IL1-gn.js}

@@ -1,4 +1,4 @@
-import { U as extractName } from './cart-ekBk_gxV.js';
+import { U as extractName } from './cart-Cleo1j5P.js';
 
 /**
  * Minimum number of characters we treat as a valid postal code. Mirrors the

package/dist/esm/{hasInclusivePrice-CAVXi310.js → hasInclusivePrice-DKRplpLX.js}

@@ -1,4 +1,4 @@
-import { l as localizationStore } from './localization-AOqYXGdP.js';
+import { l as localizationStore } from './localization-BiL8bPsY.js';
 
 /**
  * Since the backend and the frontend are using the same keys,

package/dist/esm/index.js

@@ -131,7 +131,7 @@ const getZonosQaUrl = () => {
         return null;
     }
     const qaUrl = extractZonosQaUrl(window.location.href);
-    const cdnUrl = "https://v1.3.288.js.zonos.com";
+    const cdnUrl = "https://v1.3.290.js.zonos.com";
     // when the qaUrl is not set and the built URL is from the test domain, use the test domain for testing
     if (!qaUrl &&
         (cdnUrl.includes('test.') ||
@@ -258,7 +258,6 @@ const zonosStripeLoadScript = (params) => {
     });
     return stripePromise$1;
 };
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 const registerWrapper = (stripe, startTime) => {
     if (!stripe || !stripe._registerWrapper) {
         return;
@@ -395,10 +394,10 @@ const zonosLoadUrl = (() => {
     return null;
 })();
 const startLoadTime = Date.now();
-const ZONOS_URL = "https://v1.3.288.js.zonos.com";
-const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.288";
-const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.288";
-const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.288";
+const ZONOS_URL = "https://v1.3.290.js.zonos.com";
+const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.290";
+const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.290";
+const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.290";
 const GOOGLE_FONT_URL = 'https://fonts.googleapis.com';
 const GOOGLE_FONT_REGEX = /^https:\/\/fonts\.googleapis\.com/;
 class Zonos {
@@ -416,7 +415,7 @@ Zonos.iframeLogType = typeof window !== 'undefined'
     ? new URLSearchParams(window.location.search).get('iframeLogType')
     : null;
 Zonos.isBigCommerce = false;
-Zonos.releaseDate = "1788456575866";
+Zonos.releaseDate = "1790609993128";
 Zonos.isLegacyCheckout = false;
 Zonos.googleAnalyticId = null;
 Zonos.googleAnalyticReady = false;
@@ -441,7 +440,7 @@ Zonos.isNpm = true;
 Zonos.zonosQaUrl = null;
 Zonos.zonosQaUrlApi = null;
 Zonos.trackEventLogs = [];
-Zonos.version = `v${"1.3.288"}`;
+Zonos.version = `v${"1.3.290"}`;
 Zonos.modeAlerted = false;
 Zonos.cartData = null;
 Zonos.paypal = null;
@@ -457,7 +456,7 @@ Zonos.init = async (params) => {
     // Expose the checkout cart callbacks on the global so Stripe loading can be
     // gated on whether at least one of them is configured.
     _a.createCartId = checkoutSettings === null || checkoutSettings === void 0 ? void 0 : checkoutSettings.createCartId;
-    // eslint-disable-next-line deprecation/deprecation -- intentionally mirror the (deprecated) callback so Stripe loading can be gated on it
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- intentionally mirror the (deprecated) callback so Stripe loading can be gated on it
     _a.buildCartDetail = checkoutSettings === null || checkoutSettings === void 0 ? void 0 : checkoutSettings.buildCartDetail;
     if (_a.doneInit) {
         // do nothing if zonos is already initialized

package/dist/esm/{invoice-BNDWuVsD.js → invoice-D49igPQ9.js}

@@ -1,6 +1,6 @@
-import { c as createStore, z as zonosStore } from './zonosStore-DrIOAz4M.js';
-import { d as cartStore, Y as cartStoreUpdateSelectedShippingOption, b as stripeStore, a0 as stripeStoreBuildAddressForPartyCreate } from './cart-ekBk_gxV.js';
-import { s as storageStore } from './localization-AOqYXGdP.js';
+import { c as createStore, z as zonosStore } from './zonosStore-msUlqmSD.js';
+import { d as cartStore, Y as cartStoreUpdateSelectedShippingOption, b as stripeStore, a0 as stripeStoreBuildAddressForPartyCreate } from './cart-Cleo1j5P.js';
+import { s as storageStore } from './localization-BiL8bPsY.js';
 import { h as handleFetch, s as sendErrorLog, l as logError } from './handleFetch-D5GYDF-O.js';
 import { b as allLogs } from './VarianceTest-BJmZPrZl.js';
 

package/dist/esm/{localization-AOqYXGdP.js → localization-BiL8bPsY.js}

@@ -1,4 +1,4 @@
-import { c as createStore, z as zonosStore } from './zonosStore-DrIOAz4M.js';
+import { c as createStore, z as zonosStore } from './zonosStore-msUlqmSD.js';
 import { j as jsonParse, h as handleFetch, l as logError } from './handleFetch-D5GYDF-O.js';
 import { a as availableTestKeys, l as log } from './VarianceTest-BJmZPrZl.js';
 
@@ -17652,19 +17652,65 @@ const getLocaleMessages = async ({ countryCode, localeTo, storeId, }) => {
     return json.locale_countryCodesPage;
 };
 
-const validateCountryCode = (countryCode) => {
-    // Check that the country is two characters and is upper case
-    if (countryCode && /^[A-Z]{2}$/.test(countryCode)) {
-        return countryCode;
+const isCountryCode = (value) => /^[A-Z]{2}$/.test(value);
+
+const COUNTRY_OVERRIDE_KEY = 'zonos--country';
+const withBlockedStorage = (run) => {
+    try {
+        run();
     }
-    return null;
+    catch (_a) {
+        // localStorage/sessionStorage can throw in blocked-storage contexts
+        // (Safari private mode, cross-origin iframes).
+    }
+};
+const clearSessionOverride = () => {
+    window.sessionStorage.removeItem(COUNTRY_OVERRIDE_KEY);
 };
+const readStoredCountry = (storage) => {
+    try {
+        const value = storage.getItem(COUNTRY_OVERRIDE_KEY);
+        if (!value || !isCountryCode(value)) {
+            return null;
+        }
+        return value;
+    }
+    catch (_a) {
+        return null;
+    }
+};
+const getCountryOverrideStorage = () => {
+    var _a;
+    return (_a = readStoredCountry(window.localStorage)) !== null && _a !== void 0 ? _a : readStoredCountry(window.sessionStorage);
+};
+const migrateCountryOverrideStorage = () => {
+    withBlockedStorage(() => {
+        if (readStoredCountry(window.localStorage)) {
+            clearSessionOverride();
+        }
+    });
+};
+const setCountryOverrideStorage = (countryCode) => {
+    withBlockedStorage(() => {
+        window.localStorage.setItem(COUNTRY_OVERRIDE_KEY, countryCode);
+        clearSessionOverride();
+    });
+};
+const clearCountryOverrideStorage = () => {
+    withBlockedStorage(() => {
+        window.localStorage.removeItem(COUNTRY_OVERRIDE_KEY);
+        clearSessionOverride();
+    });
+};
+
 const getZCountryUrlParam = (urlParams) => {
     const urlSearchParams = new URLSearchParams(urlParams || window.location.search);
     const getCountryParam = (param) => {
         const country = urlSearchParams.get(param);
-        // Check that the country is two characters and is upper case
-        return validateCountryCode(country);
+        if (country && isCountryCode(country)) {
+            return country;
+        }
+        return null;
     };
     const zCountry = getCountryParam('zCountry');
     // Fallback to legacy 'country'
@@ -17675,19 +17721,16 @@ const getZCountryUrlParam = (urlParams) => {
 };
 
 /**
- * Retrieve the zCountry from the URL or session storage.
+ * Retrieve the shopper country override from the URL or remembered storage.
  */
 const getOverridenZCountry = () => {
     const currentUrl = new URL(window.location.href);
-    // load and use country from session storage when zCountry query param is not present
-    const countryLoadedSession = window.sessionStorage.getItem('zonos--country');
-    const zCountry = getZCountryUrlParam(currentUrl.searchParams) || countryLoadedSession;
-    return zCountry;
+    return (getZCountryUrlParam(currentUrl.searchParams) || getCountryOverrideStorage());
 };
 
-const getLocalization = async () => {
+const getLocalization = async ({ ignoreCountryOverride = false, } = {}) => {
     try {
-        const zCountry = getOverridenZCountry();
+        const zCountry = ignoreCountryOverride ? null : getOverridenZCountry();
         const searchParams = new URLSearchParams();
         if (zCountry) {
             searchParams.set('zCountry', zCountry);
@@ -17807,35 +17850,31 @@ const deleteBigCommerceConsignment = async (checkoutId, consignmentId) => {
  */
 const isBigCommerceCustomerLoggedIn = (checkout) => { var _a; return !!((_a = checkout === null || checkout === void 0 ? void 0 : checkout.customer) === null || _a === void 0 ? void 0 : _a.id); };
 
+const isCountryInShippingZone = (countryCode) => {
+    var _a;
+    return !!countryCode &&
+        !!((_a = localizationStore.shippingZoneCountries) === null || _a === void 0 ? void 0 : _a[countryCode]) &&
+        !zonosStore.disabledCountries.includes(countryCode);
+};
+
 /**
- * Whether the Hello widget should be shown for the current shopper. This is the
- * single source of truth for Hello's visibility decision — the `zonos-hello`
- * component renders by it, and other features (e.g. BigCommerce cart shipping
- * cleanup) gate on it so their behavior stays in lockstep with what the shopper
- * actually sees.
- *
- * Resolves the configured `widgetVisibility` behavior (with the deprecated
- * `showForCountries` override) against the selected country and shipping-zone
- * state, then applies the include/exclude country overrides.
- *
- * @param showLog - emit a debug log when the shopper is not in a shipping zone.
- * Defaults to `true`; pass `false` from non-rendering callers to avoid log
- * noise.
+ * Visibility rules for Hello, ignoring whether localization has finished
+ * loading. Used during init reconcile before `localizationLoaded` is set.
+ * Pass `countryCode` to evaluate a remembered country instead of the
+ * currently selected one.
  */
-const shouldShowHelloWidget = (showLog = true) => {
+const getHelloWidgetVisibility = (showLog = true, countryCode = localizationStore.selectedCountryCode) => {
     var _a, _b;
-    if (!localizationStore.localizationLoaded) {
-        return false;
-    }
     const { countryDisplayRules, showForCountries } = zonosStore.helloSettings;
     const visibilityRules = countryDisplayRules === null || countryDisplayRules === void 0 ? void 0 : countryDisplayRules.widgetVisibility;
-    const selectedCountry = localizationStore.selectedCountryCode;
+    const selectedCountry = countryCode;
+    const isShippableCountry = isCountryInShippingZone(countryCode);
     // Resolve behavior: deprecated showForCountries overrides widgetVisibility.behavior
     // If showForCountries is an array of country codes, treat as legacy explicit list
     const behavior = Array.isArray(showForCountries)
         ? showForCountries
         : (showForCountries !== null && showForCountries !== void 0 ? showForCountries : visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.behavior);
-    if (showLog && !localizationStore.isShippableCountry) {
+    if (showLog && !isShippableCountry) {
         log(`Hello: not shippable country - Show for countries: ${behavior}`);
     }
     // Legacy: explicit list of country codes from deprecated showForCountries
@@ -17849,7 +17888,7 @@ const shouldShowHelloWidget = (showLog = true) => {
     }
     else {
         // Default: ONLY_SHIPPABLE
-        isVisible = localizationStore.isShippableCountry;
+        isVisible = isShippableCountry;
     }
     // Apply includedCountries — force show the widget for these countries
     if (!isVisible &&
@@ -17865,6 +17904,23 @@ const shouldShowHelloWidget = (showLog = true) => {
     }
     return isVisible;
 };
+/**
+ * Whether the Hello widget should be shown for the current shopper. This is the
+ * single source of truth for Hello's visibility decision — the `zonos-hello`
+ * component renders by it, and other features (e.g. BigCommerce cart shipping
+ * cleanup) gate on it so their behavior stays in lockstep with what the shopper
+ * actually sees.
+ *
+ * @param showLog - emit a debug log when the shopper is not in a shipping zone.
+ * Defaults to `true`; pass `false` from non-rendering callers to avoid log
+ * noise.
+ */
+const shouldShowHelloWidget = (showLog = true) => {
+    if (!localizationStore.localizationLoaded) {
+        return false;
+    }
+    return getHelloWidgetVisibility(showLog);
+};
 
 /**
  * Guard against overlapping passes. `removeBigcommerceCartShipping` is fired on
@@ -18331,6 +18387,41 @@ const getCurrencyCode = (code) => {
     return null;
 };
 
+/**
+ * Drop a remembered Hello country when widgetVisibility would hide the
+ * widget for it, then fall back to geo.
+ *
+ * Does not mutate the localization store — the caller applies the returned
+ * country. Pass `geoCountry` when init already fetched IP localization so
+ * discard does not wait on a second round trip. Pass `urlCountryAtLoad`
+ * from the URL as it was at page load (before init writes `zCountry` for
+ * URL_PARAM merchants). Do not omit it after a live URL write — the
+ * default is `null`, not the current URL. Storage is cleared when geo
+ * succeeds, or when a load-time URL country won and the stored country
+ * would be hidden.
+ */
+const reconcileRememberedCountryOverride = async ({ geoCountry, urlCountryAtLoad = null, } = {}) => {
+    const storedCountry = getCountryOverrideStorage();
+    if (!storedCountry) {
+        return null;
+    }
+    if (getHelloWidgetVisibility(false, storedCountry)) {
+        return null;
+    }
+    if (urlCountryAtLoad) {
+        clearCountryOverrideStorage();
+        return null;
+    }
+    const country = geoCountry !== undefined
+        ? geoCountry
+        : (await getLocalization({ ignoreCountryOverride: true })).country;
+    if (!country) {
+        return null;
+    }
+    clearCountryOverrideStorage();
+    return country;
+};
+
 const setZCountryUrlParam = (selectedCountryCode) => {
     if (!selectedCountryCode) {
         return;
@@ -18502,19 +18593,23 @@ const getNewLocalization = async ({ isInitializing, }) => {
     }
 };
 const getCustomMessages = async () => {
-    log(`Getting custom messages for ${localizationStore.selectedCountryCode}`);
-    if (!localizationStore.selectedCountryCode || !zonosStore.storeId) {
+    const countryCode = localizationStore.selectedCountryCode;
+    log(`Getting custom messages for ${countryCode}`);
+    if (!countryCode || !zonosStore.storeId) {
         return;
     }
     const localeMessages = await getLocaleMessages({
-        countryCode: localizationStore.selectedCountryCode,
+        countryCode,
         localeTo: localizationStore.selectedLocale,
         storeId: zonosStore.storeId,
     });
+    if (localizationStore.selectedCountryCode !== countryCode) {
+        return;
+    }
     const allMessages = localeMessages.flatMap(x => {
         var _a;
         return {
-            countryCode: localizationStore.selectedCountryCode,
+            countryCode,
             message: (_a = x.countryCodesPageMessageLinks.find(Boolean)) === null || _a === void 0 ? void 0 : _a.message.textTo,
             pageName: x.pageName,
         };
@@ -18557,17 +18652,19 @@ const getValidLocale = (locale) => {
     log(`Locale ${locale} is not offered, falling back to ${fallback === null || fallback === void 0 ? void 0 : fallback.code}`);
     return (fallback === null || fallback === void 0 ? void 0 : fallback.code) || 'en';
 };
-const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelectedCountryCode, }) => {
-    var _a, _b, _c;
+const syncSelectedCountryToPage = (selectedCountryCode) => {
+    var _a;
+    setZCountryUrlParam(selectedCountryCode);
+    (_a = document
+        .querySelector('zonos-hello')) === null || _a === void 0 ? void 0 : _a.setAttribute('z-country', selectedCountryCode);
+};
+const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelectedCountryCode, persistOverride, }) => {
+    var _a;
     log(`Updating selected country code to ${newSelectedCountryCode}`);
     const isFirstTime = !localizationStore.selectedCountryCode;
     localizationStore.selectedCountryCode = getValidCountryCode(newSelectedCountryCode);
-    const { selectedCountryCode, shippingZoneCountries } = localizationStore;
-    const isShippableCountry = !!shippingZoneCountries &&
-        !!selectedCountryCode &&
-        !!shippingZoneCountries[selectedCountryCode] &&
-        // Make sure the country is not in the disabled countries list
-        !zonosStore.disabledCountries.includes(selectedCountryCode);
+    const { selectedCountryCode } = localizationStore;
+    const isShippableCountry = isCountryInShippingZone(selectedCountryCode);
     // update shippable country
     localizationStore.isShippableCountry = isShippableCountry;
     log(`${localizationStore.selectedCountryCode} is a shippable country: ${localizationStore.isShippableCountry}`);
@@ -18590,9 +18687,10 @@ const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelecte
         return;
     }
     const currencyCode = getCurrencyCode(selectedCountryCode);
-    // Only trigger callback onCountryChange if the country code has been set before
-    if (!isFirstTime) {
-        // Trigger callback onCountryChange
+    const shouldPersistOverride = persistOverride !== null && persistOverride !== void 0 ? persistOverride : !isInitializing;
+    // Only trigger onCountryChange after init — the first apply, and any
+    // reconcile fallback during init, are not shopper-selected changes.
+    if (!isFirstTime && !isInitializing) {
         (_a = zonosStore.onCountryChange) === null || _a === void 0 ? void 0 : _a.call(zonosStore, {
             countryCode: selectedCountryCode,
             currencyCode,
@@ -18622,27 +18720,24 @@ const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelecte
         localizationStore.countryLandedCost = null;
         localizationStore.inclusivePricingConfigurations = [];
         currencyDisplay();
+    }
+    else {
+        localizationStore.targetCurrency = currencyCode;
+        // Init may apply a remembered country that reconcile then discards. Fetch
+        // exchange rates once after reconcile for the final country instead.
         if (!isInitializing) {
-            void getCustomMessages();
+            void getNewLocalization({ isInitializing: false });
         }
-        // Clear session so the next visit falls back to geolocation, but keep
-        // the current shopper's explicit selection visible in the URL (so a
-        // same-tab reload still honors it) and on the hello element.
-        window.sessionStorage.removeItem('zonos--country');
-        setZCountryUrlParam(selectedCountryCode);
-        (_b = document
-            .querySelector('zonos-hello')) === null || _b === void 0 ? void 0 : _b.setAttribute('z-country', selectedCountryCode);
-        return;
     }
-    localizationStore.targetCurrency = currencyCode;
-    void getNewLocalization({ isInitializing: isInitializing });
     if (!isInitializing) {
         void getCustomMessages();
     }
-    window.sessionStorage.setItem('zonos--country', selectedCountryCode);
-    setZCountryUrlParam(selectedCountryCode);
-    (_c = document
-        .querySelector('zonos-hello')) === null || _c === void 0 ? void 0 : _c.setAttribute('z-country', selectedCountryCode);
+    if (shouldPersistOverride) {
+        setCountryOverrideStorage(selectedCountryCode);
+    }
+    if (!isInitializing) {
+        syncSelectedCountryToPage(selectedCountryCode);
+    }
 };
 const initHelloCountryList = (allCountries) => {
     var _a, _b, _c, _d, _e, _f;
@@ -18721,12 +18816,25 @@ const localizationStoreUpdateSelectedLocale = (requestedLocale) => {
     localizationStore.selectedLocale = newSelectedLocale;
     translationStoreUpdateLanguage(newSelectedLocale);
     void updateCheckoutSessionLanguage();
-    void getCustomMessages();
+    if (localizationStore.localizationLoaded) {
+        void getCustomMessages();
+    }
 };
 const initLocalizationStore = async () => {
     var _a;
+    migrateCountryOverrideStorage();
+    const urlCountryAtLoad = getZCountryUrlParam();
+    const storedCountryAtLoad = getCountryOverrideStorage();
+    const shouldPrefetchGeo = !!storedCountryAtLoad && !urlCountryAtLoad;
     // all countries from countries.json, shipping zone and localization
-    const [allCountries, shippingZoneCountries, localization] = await Promise.all([getCountries(), getShippingZones(), getLocalization()]);
+    const [allCountries, shippingZoneCountries, localization, geoLocalization] = await Promise.all([
+        getCountries(),
+        getShippingZones(),
+        getLocalization(),
+        shouldPrefetchGeo
+            ? getLocalization({ ignoreCountryOverride: true })
+            : Promise.resolve(undefined),
+    ]);
     // Filter countries to only include countries in the shipping zone
     const filteredCountries = shippingZoneCountries === null || shippingZoneCountries === void 0 ? void 0 : shippingZoneCountries.reduce((acc, countryCode) => {
         const countryInfo = allCountries === null || allCountries === void 0 ? void 0 : allCountries[countryCode];
@@ -18745,7 +18853,7 @@ const initLocalizationStore = async () => {
     // update selected country code in store
     localizationStoreUpdateSelectedCountryCode({
         isInitializing: true,
-        newSelectedCountryCode: country || null,
+        newSelectedCountryCode: country || storedCountryAtLoad,
     });
     // use locale from params if it exists, otherwise use locale from localization
     const overrideLocale = getOverrideLocale();
@@ -18767,12 +18875,26 @@ const initLocalizationStore = async () => {
             newSelectedCountryCode: 'CA',
         });
     }
+    const fallbackCountry = await reconcileRememberedCountryOverride({
+        geoCountry: geoLocalization === null || geoLocalization === void 0 ? void 0 : geoLocalization.country,
+        urlCountryAtLoad,
+    });
+    if (fallbackCountry) {
+        localizationStoreUpdateSelectedCountryCode({
+            isInitializing: true,
+            newSelectedCountryCode: fallbackCountry,
+        });
+    }
+    if (localizationStore.selectedCountryCode) {
+        syncSelectedCountryToPage(localizationStore.selectedCountryCode);
+    }
+    void getCustomMessages();
+    void getNewLocalization({ isInitializing: true });
     if (!localizationStore.localizationLoaded) {
         localizationStore.localizationLoaded = true;
         void removeBigcommerceCartShipping();
-        // shouldShowHelloWidget is false because localization is not loaded yet
         void toggleBigcommerceNativeCurrencySelector();
     }
 };
 
-export { applyInclusiveEffectiveRate as A, getFallbackDefaultCountryCode as B, localizationStoreUpdateSelectedLocale as C, VARIANT_TEST_KEY_EXPIRATION as V, fetchCheckoutId as a, fetchBigCommerceCheckout as b, localizationStoreUpdateSelectedCountryCode as c, storageStoreSetEnabledVariantTestKeys as d, localizationStoreOnChange as e, filterValidTests as f, getZCountryUrlParam as g, currencyFormat as h, isBigCommerceCustomerLoggedIn as i, languages as j, getOverridenZCountry as k, localizationStore as l, isValidSelector as m, initLocalizationStore as n, setZCountryUrlParam as o, currencyDisplay as p, currencyConvertAndFormat as q, currencyConvert as r, storageStore as s, translate as t, shouldShowHelloWidget as u, getExchangeRate as v, numberFormat as w, translationStoreOnChange as x, storageStoreOnChange as y, getSupportedLanguages as z };
+export { getSupportedLanguages as A, applyInclusiveEffectiveRate as B, getFallbackDefaultCountryCode as C, localizationStoreUpdateSelectedLocale as D, VARIANT_TEST_KEY_EXPIRATION as V, fetchCheckoutId as a, fetchBigCommerceCheckout as b, isCountryInShippingZone as c, localizationStoreUpdateSelectedCountryCode as d, storageStoreSetEnabledVariantTestKeys as e, filterValidTests as f, getZCountryUrlParam as g, localizationStoreOnChange as h, isBigCommerceCustomerLoggedIn as i, currencyFormat as j, languages as k, localizationStore as l, getOverridenZCountry as m, isValidSelector as n, initLocalizationStore as o, setZCountryUrlParam as p, currencyDisplay as q, currencyConvertAndFormat as r, storageStore as s, translate as t, currencyConvert as u, shouldShowHelloWidget as v, getExchangeRate as w, numberFormat as x, translationStoreOnChange as y, storageStoreOnChange as z };

package/dist/esm/{paypal-CW1D2XqZ.js → paypal-D4vWRxHJ.js}

@@ -1,10 +1,10 @@
-import { z as zonosStore, c as createStore } from './zonosStore-DrIOAz4M.js';
-import { x as cartStoreNextStep, j as cartStoreClearCheckoutInterval, t as trackConversionEvent, y as isPolicyConsentRequired, G as policyConsentStore, C as validateCheckoutSession, b as stripeStore, d as cartStore, n as stripeStoreHandleInventoryCheck, A as storeCreditStoreApplyCredit, T as stripeStoreRecordPolicyConsent, B as storeCreditStoreCoversFullAmount, D as storeCreditStoreCreateOrder, K as storeCreditStoreGetEffectiveAmount } from './cart-ekBk_gxV.js';
-import { s as storageStore, t as translate } from './localization-AOqYXGdP.js';
+import { z as zonosStore, c as createStore } from './zonosStore-msUlqmSD.js';
+import { x as cartStoreNextStep, j as cartStoreClearCheckoutInterval, t as trackConversionEvent, y as isPolicyConsentRequired, G as policyConsentStore, C as validateCheckoutSession, b as stripeStore, d as cartStore, n as stripeStoreHandleInventoryCheck, A as storeCreditStoreApplyCredit, T as stripeStoreRecordPolicyConsent, B as storeCreditStoreCoversFullAmount, D as storeCreditStoreCreateOrder, K as storeCreditStoreGetEffectiveAmount } from './cart-Cleo1j5P.js';
+import { s as storageStore, t as translate } from './localization-BiL8bPsY.js';
 import { h as handleFetch, g as getIsTestMode, l as logError, j as jsonParse } from './handleFetch-D5GYDF-O.js';
 import { i as isContrastColor } from './isContrastColor-CWLU13s9.js';
 import { l as log } from './VarianceTest-BJmZPrZl.js';
-import { i as isAnalyticsRelayInIframe, a as enqueueRelayEvent, s as submitGtag } from './submitGtag-CCGQS060.js';
+import { i as isAnalyticsRelayInIframe, a as enqueueRelayEvent, s as submitGtag } from './submitGtag-df9AQ2zL.js';
 
 /*!
  * paypal-js v8.4.2 (2025-09-04T17:21:30.135Z)

package/dist/esm/{placeTestOrder-nhmsLLOA.js → placeTestOrder-BNmc5RCo.js}

@@ -1,5 +1,5 @@
-import { d as cartStore } from './cart-ekBk_gxV.js';
-import { s as storageStore } from './localization-AOqYXGdP.js';
+import { d as cartStore } from './cart-Cleo1j5P.js';
+import { s as storageStore } from './localization-BiL8bPsY.js';
 import { l as logError, h as handleFetch } from './handleFetch-D5GYDF-O.js';
 
 const placeTestOrder = async () => {

package/dist/esm/{renderCheckoutCurrency-BQANmZyM.js → renderCheckoutCurrency-BNbwijGo.js}

@@ -1,5 +1,5 @@
-import { d as cartStore } from './cart-ekBk_gxV.js';
-import { A as applyInclusiveEffectiveRate, h as currencyFormat } from './localization-AOqYXGdP.js';
+import { d as cartStore } from './cart-Cleo1j5P.js';
+import { B as applyInclusiveEffectiveRate, j as currencyFormat } from './localization-BiL8bPsY.js';
 
 const getDisplayCurrency = () => {
     var _a, _b;

package/dist/esm/{shouldShowLanguageSelect-BQFCXouB.js → shouldShowLanguageSelect-B82gTfHz.js}

@@ -1,4 +1,4 @@
-import { z as getSupportedLanguages } from './localization-AOqYXGdP.js';
+import { A as getSupportedLanguages } from './localization-BiL8bPsY.js';
 
 /**
  * Whether to offer the language selector. Hidden when the merchant has narrowed

package/dist/esm/{submitGtag-CCGQS060.js → submitGtag-df9AQ2zL.js}

@@ -1,4 +1,4 @@
-import { z as zonosStore } from './zonosStore-DrIOAz4M.js';
+import { z as zonosStore } from './zonosStore-msUlqmSD.js';
 import { g as getIsTestMode } from './handleFetch-D5GYDF-O.js';
 import { l as log } from './VarianceTest-BJmZPrZl.js';
 

package/dist/esm/{throttle-D5GyA3yr.js → throttle-Cvlvb-dm.js}

@@ -1,5 +1,5 @@
-import { r as requireIsObject, e as getDefaultExportFromCjs } from './zonosStore-DrIOAz4M.js';
-import { r as requireDebounce } from './debounce-D4ko2kvZ.js';
+import { r as requireIsObject, e as getDefaultExportFromCjs } from './zonosStore-msUlqmSD.js';
+import { r as requireDebounce } from './debounce-BR3PaG8X.js';
 
 var throttle_1;
 var hasRequiredThrottle;

package/dist/esm/{updateCheckoutSessionAttributes-eRSqdC74.js → updateCheckoutSessionAttributes-4Jq6V4pO.js}

@@ -1,4 +1,4 @@
-import { d as debounce } from './debounce-DWPsxJsW.js';
+import { d as debounce } from './debounce-CrmpwbEE.js';
 import { h as handleFetch, l as logError } from './handleFetch-D5GYDF-O.js';
 
 const attributesToUpdate = {};