@zonos/elements 1.3.288 → 1.3.289

package/dist/collection/components/store/hello/localization.js

@@ -12,8 +12,12 @@ import { getShippingZones } from "../../utils/api/getShippingZones";
 import { removeBigcommerceCartShipping } from "../../utils/checkout/removeBigcommerceCartShipping";
 import { getSupportedLanguages } from "../../utils/getSupportedLanguages";
 import { handleFetch } from "../../utils/handleFetch";
+import { getCountryOverrideStorage, migrateCountryOverrideStorage, setCountryOverrideStorage, } from "../../utils/hello/countryOverrideStorage";
 import { currencyDisplay } from "../../utils/hello/currencyConversion/currencyDisplay";
 import { getCurrencyCode } from "../../utils/hello/currencyConversion/getCurrencyCode";
+import { getZCountryUrlParam } from "../../utils/hello/getZCountryUrlParam";
+import { isCountryInShippingZone } from "../../utils/hello/isCountryInShippingZone";
+import { reconcileRememberedCountryOverride } from "../../utils/hello/reconcileRememberedCountryOverride";
 import { setZCountryUrlParam } from "../../utils/hello/setZCountryUrlParam";
 import { log } from "../../utils/logging/log";
 import { logError } from "../../utils/logging/logError";
@@ -124,19 +128,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,
         };
@@ -179,17 +187,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}`);
@@ -212,9 +222,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,
@@ -244,27 +255,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;
@@ -343,12 +351,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];
@@ -367,7 +388,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();
@@ -389,10 +410,24 @@ 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();
     }
 };

package/dist/collection/components/stripe/zonos-address/zonos-address.js

@@ -357,11 +357,11 @@ export class ZonosAddress {
             this.isAddressFilled = true;
         }
         // this component loads iframe from the stripe elements and puts here, so we don't need to do anything here
-        return (h(Host, { key: '9b7a5340b839d63c64da03639bdfda5a11a5c25e', class: classes([
+        return (h(Host, { key: '302dafde973c4bf2d847640d8f0e064d88f350f8', class: classes([
                 'zonos--address',
                 'zonos--elements',
                 `zonos--${this.type}-address`,
-            ]) }, this.titleText && (h("zonos-text", { key: '23739f6a48e5698372df2d53098dea6ad1c0559a', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("slot", { key: 'dea4b437eedaad2af2f6bbe3a1e2ae4f0706aa13', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), h("div", { key: 'b4be684977a632371b9b6ff4587ccdd7bacc8c67', class: "zonos--address-component" })));
+            ]) }, this.titleText && (h("zonos-text", { key: '706204604ad32eed710e38adbe8133b3384044eb', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("slot", { key: '0edc4c5d6c3ff965be6edbf680acaed892c71a16', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), h("div", { key: '6aa6e4e86a76f1081c5af1f2b5f3282dfd91f3c5', class: "zonos--address-component" })));
     }
     static get is() { return "zonos-address"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/stripe/zonos-custom-address/zonos-address-suggestions/zonos-address-suggestions.js

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { h, Host, } from "@stencil/core";
 import { classes } from "../../../utils/classes";
 import { getBorderRadius } from "../../../utils/getBorderRadius";
@@ -78,9 +77,9 @@ export class ZonosAddressSuggestions {
         return segments;
     }
     render() {
-        return (h(Host, { key: '9de4179f1bd0057ac71d6b9ed646c034035382f7', class: "zonos--address-suggestions", role: "group", style: {
+        return (h(Host, { key: '34018ecc951c0335041e24102329eb83a8d68439', class: "zonos--address-suggestions", role: "group", style: {
                 '--zonos--border-radius': getBorderRadius(),
-            } }, h("ul", { key: '62fa5ed92fafcdd641f9a7eb36e36e62309c9f52', "aria-label": "Suggestions", class: "wrapper", role: "listbox" }, !!this.localSuggestions.length && (h("li", { key: '27c61b5693720d0b33a75385841476787f92b884', "aria-selected": false, class: "powered-by option", role: "option" }, h("div", { key: 'fea9f2e8f65cd50fdf28fc45e18beb8976320f0d', class: "powered-by-container" }, h("zonos-text", { key: '1fec46f543e3673433b6924f7dca1cbd84e0ef16', type: "caption" }, "Suggestions powered by"), h("zonos-text", { key: '7b3fd93c18d4320522d61e07278f5388d14c8bbb', type: "semiBoldLabel" }, "Google")), h("zonos-button", { key: '61a8362ab0514a78dd71eaa9bd638dc8b50e2a9c', "aria-label": "Clear suggestions", icon: h("zonos-icon", { content: RemoveIcon }), noBackground: true, onClick: () => {
+            } }, h("ul", { key: '80433831c875845e57225a1317c430e2626edf9a', "aria-label": "Suggestions", class: "wrapper", role: "listbox" }, !!this.localSuggestions.length && (h("li", { key: '3510ef51b56b1cb0a36334e842792bccc2daeca5', "aria-selected": false, class: "powered-by option", role: "option" }, h("div", { key: '72773af6f9c7e0644ebc5239e4bf585bba6e164a', class: "powered-by-container" }, h("zonos-text", { key: '7fabccbe33cbc8d037dfd25f6e5b0a5bdaf97b2f', type: "caption" }, "Suggestions powered by"), h("zonos-text", { key: '2d88a3b8d7369a44e910ec60f5c7ac0c3f0ce801', type: "semiBoldLabel" }, "Google")), h("zonos-button", { key: '74315c248cc84617d854a3b51d0bad8300c6b762', "aria-label": "Clear suggestions", icon: h("zonos-icon", { content: RemoveIcon }), noBackground: true, onClick: () => {
                 this.localSuggestions = [];
             } }))), this.localSuggestions.map(suggestion => (
         // eslint-disable-next-line jsx-a11y/click-events-have-key-events

package/dist/collection/components/stripe/zonos-custom-address/zonos-custom-address.js

@@ -933,10 +933,10 @@ export class ZonosAddress {
             this.country = localizationStore.selectedCountryCode;
         }
         // this component loads iframe from the stripe elements and puts here, so we don't need to do anything here
-        return (h(Host, { key: 'b4e39a6e92e646f98c0061bf3de8e028c9285556', class: classes([
+        return (h(Host, { key: '9d178094ee341623633d1e3822bd79f254a27e51', class: classes([
                 'zonos--address zonos--elements',
                 `zonos--${this.type}-address`,
-            ]) }, h("zonos-text", { key: '28d21737c78a1b8125c5170c67f214e3f39939ff', class: "zonos--title", type: "semiBoldLabel" }, this.titleText), h("slot", { key: '97357f001b27197b8648d6158b786b153c31a7ba', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), this.renderCustomAddressForm()));
+            ]) }, h("zonos-text", { key: 'c36b4ce9b63cce95664894fd8929ffe15807a22a', class: "zonos--title", type: "semiBoldLabel" }, this.titleText), h("slot", { key: '661eab7074f99b6dca52d5f7f546cfbd29322fbf', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), this.renderCustomAddressForm()));
     }
     static get is() { return "zonos-custom-address"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/stripe/zonos-link-authentication/zonos-link-authentication.js

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { h, Host, } from "@stencil/core";
 import { cartStore } from "../../store/checkout/cart";
 import { stripeStore, stripeStoreOnChange, } from "../../store/checkout/stripe";

package/dist/collection/components/utils/api/getLocalization.js

@@ -1,8 +1,8 @@
 import { getOverridenZCountry } from "../getOverridenZCountry";
 import { handleFetch } from "../handleFetch";
-export const getLocalization = async () => {
+export const getLocalization = async ({ ignoreCountryOverride = false, } = {}) => {
     try {
-        const zCountry = getOverridenZCountry();
+        const zCountry = ignoreCountryOverride ? null : getOverridenZCountry();
         const searchParams = new URLSearchParams();
         if (zCountry) {
             searchParams.set('zCountry', zCountry);

package/dist/collection/components/utils/checkout/isShippableCountry.js

@@ -1,18 +1,16 @@
 import { localizationStore } from "../../store/hello/localization";
-import { zonosStore } from "../../store/zonosStore";
+import { isCountryInShippingZone } from "../hello/isCountryInShippingZone";
 import { log } from "../logging/log";
 export const isShippableCountry = (showLog = true, 
 /**
  * If provided, will check if the country is shippable based on the provided country code instead of the Hello selected country code
  */
 providedCountryCode) => {
-    var _a;
     if (!localizationStore.localizationLoaded) {
         return false;
     }
     if (providedCountryCode) {
-        const isProvidedCountryCodeShippableCountry = !!((_a = localizationStore.shippingZoneCountries) === null || _a === void 0 ? void 0 : _a[providedCountryCode]) &&
-            !zonosStore.disabledCountries.includes(providedCountryCode);
+        const isProvidedCountryCodeShippableCountry = isCountryInShippingZone(providedCountryCode);
         if (showLog && !isProvidedCountryCodeShippableCountry) {
             log(`Checkout: ${providedCountryCode} is not a shippable country: ${isProvidedCountryCodeShippableCountry}`);
         }

package/dist/collection/components/utils/checkout/watchBigcommerceDomesticCheckout.js

@@ -48,6 +48,7 @@ export const watchBigcommerceDomesticCheckout = ({ domesticRedirectedBtnSelector
             localizationStoreUpdateSelectedCountryCode({
                 isInitializing: false,
                 newSelectedCountryCode: shippingCountry,
+                persistOverride: false,
             });
             // do nothing if the country is still domestic
             if (!isShippableCountry(false)) {

package/dist/collection/components/utils/checkout/watchImmediateBigcommerceDomesticCheckoutRedirect.js

@@ -80,6 +80,7 @@ const checkLoggedInUserShippingAddress = async ({ onInternationalCheckoutSelecte
     localizationStoreUpdateSelectedCountryCode({
         isInitializing: false,
         newSelectedCountryCode: countryCode,
+        persistOverride: false,
     });
     // Save the shipping address to session storage for the international checkout
     stripeStoreSaveDomesticShippingSession({
@@ -163,6 +164,7 @@ export const watchImmediateBigcommerceDomesticCheckoutRedirect = ({ domesticRedi
         localizationStoreUpdateSelectedCountryCode({
             isInitializing: false,
             newSelectedCountryCode: shippingCountry,
+            persistOverride: false,
         });
         const shippingAddress = {
             address1: '',

package/dist/collection/components/utils/formatDate.js

@@ -1,6 +1,4 @@
-export const formatDate = ({ date, 
-// eslint-disable-next-line sort-keys/sort-keys-fix
-formatOptions = {
+export const formatDate = ({ date, formatOptions = {
     dateStyle: 'full',
 }, }) => {
     // format date to 'Wednesday, May 15, 2024'

package/dist/collection/components/utils/getOverridenZCountry.js

@@ -1,11 +1,9 @@
+import { getCountryOverrideStorage } from "./hello/countryOverrideStorage";
 import { getZCountryUrlParam } from "./hello/getZCountryUrlParam";
 /**
- * Retrieve the zCountry from the URL or session storage.
+ * Retrieve the shopper country override from the URL or remembered storage.
  */
 export 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());
 };

package/dist/collection/components/utils/hello/countryOverrideStorage.js

@@ -0,0 +1,49 @@
+import { isCountryCode } from "./isCountryCode";
+const COUNTRY_OVERRIDE_KEY = 'zonos--country';
+const withBlockedStorage = (run) => {
+    try {
+        run();
+    }
+    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;
+    }
+};
+export const getCountryOverrideStorage = () => {
+    var _a;
+    return (_a = readStoredCountry(window.localStorage)) !== null && _a !== void 0 ? _a : readStoredCountry(window.sessionStorage);
+};
+export const migrateCountryOverrideStorage = () => {
+    withBlockedStorage(() => {
+        if (readStoredCountry(window.localStorage)) {
+            clearSessionOverride();
+        }
+    });
+};
+export const setCountryOverrideStorage = (countryCode) => {
+    withBlockedStorage(() => {
+        window.localStorage.setItem(COUNTRY_OVERRIDE_KEY, countryCode);
+        clearSessionOverride();
+    });
+};
+export const clearCountryOverrideStorage = () => {
+    withBlockedStorage(() => {
+        window.localStorage.removeItem(COUNTRY_OVERRIDE_KEY);
+        clearSessionOverride();
+    });
+};

package/dist/collection/components/utils/hello/getZCountryUrlParam.js

@@ -1,16 +1,12 @@
-const validateCountryCode = (countryCode) => {
-    // Check that the country is two characters and is upper case
-    if (countryCode && /^[A-Z]{2}$/.test(countryCode)) {
-        return countryCode;
-    }
-    return null;
-};
+import { isCountryCode } from "./isCountryCode";
 export 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'

package/dist/collection/components/utils/hello/isCountryCode.js

@@ -0,0 +1 @@
+export const isCountryCode = (value) => /^[A-Z]{2}$/.test(value);

package/dist/collection/components/utils/hello/isCountryInShippingZone.js

@@ -0,0 +1,8 @@
+import { localizationStore } from "../../store/hello/localization";
+import { zonosStore } from "../../store/zonosStore";
+export const isCountryInShippingZone = (countryCode) => {
+    var _a;
+    return !!countryCode &&
+        !!((_a = localizationStore.shippingZoneCountries) === null || _a === void 0 ? void 0 : _a[countryCode]) &&
+        !zonosStore.disabledCountries.includes(countryCode);
+};

package/dist/collection/components/utils/hello/reconcileRememberedCountryOverride.js

@@ -0,0 +1,37 @@
+import { getLocalization } from "../api/getLocalization";
+import { clearCountryOverrideStorage, getCountryOverrideStorage, } from "./countryOverrideStorage";
+import { getHelloWidgetVisibility } from "./shouldShowHelloWidget";
+/**
+ * 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.
+ */
+export 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;
+};

package/dist/collection/components/utils/hello/shouldShowHelloWidget.js

@@ -1,35 +1,25 @@
 import { localizationStore } from "../../store/hello/localization";
 import { zonosStore } from "../../store/zonosStore";
+import { isCountryInShippingZone } from "./isCountryInShippingZone";
 import { log } from "../logging/log";
 /**
- * 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.
  */
-export const shouldShowHelloWidget = (showLog = true) => {
+export 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
@@ -43,7 +33,7 @@ export const shouldShowHelloWidget = (showLog = true) => {
     }
     else {
         // Default: ONLY_SHIPPABLE
-        isVisible = localizationStore.isShippableCountry;
+        isVisible = isShippableCountry;
     }
     // Apply includedCountries — force show the widget for these countries
     if (!isVisible &&
@@ -59,3 +49,20 @@ export 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.
+ */
+export const shouldShowHelloWidget = (showLog = true) => {
+    if (!localizationStore.localizationLoaded) {
+        return false;
+    }
+    return getHelloWidgetVisibility(showLog);
+};

package/dist/collection/environment.js

@@ -78,7 +78,6 @@ export const env = createEnv({
     },
     // eslint-disable-next-line sort-keys/sort-keys-fix
     client: envClient,
-    // eslint-disable-next-line sort-keys/sort-keys-fix
     runtimeEnvStrict: {
         NEXT_PUBLIC_FLAG_URL: process.env.NEXT_PUBLIC_FLAG_URL,
         NEXT_PUBLIC_RELEASE_DATE: new Date().getTime().toString(),

package/dist/collection/scripts/_stripe.js

@@ -77,7 +77,6 @@ export const zonosStripeLoadScript = (params) => {
     });
     return stripePromise;
 };
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 const registerWrapper = (stripe, startTime) => {
     if (!stripe || !stripe._registerWrapper) {
         return;
@@ -92,7 +91,6 @@ export const initStripe = (maybeStripe, args, startTime) => {
     registerWrapper(stripe, startTime);
     return stripe;
 };
-// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
 export const validateLoadParams = (params) => {
     const errorMessage = `invalid load parameters; expected object of shape
 

package/dist/collection/scripts/_zonosBase.js

@@ -90,7 +90,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