@zonos/elements 1.3.258 → 1.3.259

package/dist/esm/zonos-checkout.entry.js

@@ -4,7 +4,7 @@ import { p as paypalStoreHasPaypalEnabled, a as paypalStore, b as paypalInitScri
 import { f as filterValidTests, l as localizationStore, a as localizationStoreUpdateSelectedCountryCode, g as getZCountryUrlParam, s as storageStore, V as VARIANT_TEST_KEY_EXPIRATION, b as storageStoreSetEnabledVariantTestKeys, t as translate, c as localizationStoreOnChange, d as currencyFormat } from './localization-76ce3e29.js';
 import { z as zonosStore, g as getZonosStoreTheme, m as mergeConfig } from './zonosStore-f1d45eac.js';
 import { b as buildCartItemsByTempCart } from './buildCartItemsByTempCart-a117f75d.js';
-import { h as handleFetch, g as getIsTestMode, l as logError, b as getAdditionalLogMetadata, j as jsonParse, s as sendErrorLog, a as getIsStagingMode, i as isCheckoutMobile } from './handleFetch-a844cac1.js';
+import { h as handleFetch, g as getIsTestMode, l as logError, j as jsonParse, b as getAdditionalLogMetadata, s as sendErrorLog, a as getIsStagingMode, i as isCheckoutMobile } from './handleFetch-a844cac1.js';
 import { u as updateCheckoutSessionAttributes } from './updateCheckoutSessionAttributes-8f3f932e.js';
 import { l as log, g as getElapsedTime, b as allLogs } from './VarianceTest-572cecf5.js';
 import { _ as _getIsValidCartId, c as checkoutHiddenBtnSelector, a as checkoutHiddenInternationalBtnSelector, d as domesticRedirectedBtnSelector, g as getAbandonedCartRenewTokenValue } from './CheckoutConfig-724d7bae.js';
@@ -93,6 +93,71 @@ const buildCartUrl = ({ cartId, checkoutSessionId, customerAddress1, customerAdd
     return `${hostedCheckoutUrl}?${urlParams.toString()}`;
 };
 
+/**
+ * The query flag that BigCommerce carries back to `cart.php` after the
+ * shopper logs in. When present, Zonos-elements knows to resume the
+ * international checkout flow instead of letting BC's native cart UX
+ * take over.
+ */
+const BIGCOMMERCE_INTERNATIONAL_CHECKOUT_FLAG = 'isInternationalCheckout';
+/**
+ * Build the `from` query value handed to BigCommerce's `/login.php` so that
+ * after a successful login the shopper lands back on `cart.php` with the
+ * `isInternationalCheckout=true` flag set (plus any `zonosTestMode` /
+ * `zonosQaUrl` / `zonosQaUrlApi` that were on the current URL, so the
+ * preview build / API host / test credentials carry through the round trip).
+ */
+const buildFromCartPath = () => {
+    const params = new URLSearchParams();
+    params.set(BIGCOMMERCE_INTERNATIONAL_CHECKOUT_FLAG, 'true');
+    const currentParams = new URLSearchParams(window.location.search);
+    const zonosQaUrl = currentParams.get('zonosQaUrl');
+    if (zonosQaUrl) {
+        params.set('zonosQaUrl', zonosQaUrl);
+    }
+    const zonosQaUrlApi = currentParams.get('zonosQaUrlApi');
+    if (zonosQaUrlApi) {
+        params.set('zonosQaUrlApi', zonosQaUrlApi);
+    }
+    if (getIsTestMode()) {
+        params.set('zonosTestMode', '1');
+    }
+    return `cart.php?${params.toString()}`;
+};
+/**
+ * Build an absolute URL to BigCommerce's `/login.php` with the
+ * `from=cart.php?isInternationalCheckout=true` round-trip encoded so the
+ * shopper resumes Zonos international checkout after authenticating.
+ *
+ * Preserves `zonosTestMode` / `zonosQaUrl` / `zonosQaUrlApi` from the current
+ * URL across the redirect — the login round trip leaves BC's frontend, so
+ * without this the returning `cart.php` would drop back to the production
+ * build / API host.
+ */
+const buildBigcommerceLoginUrl = ({ action } = {}) => {
+    const url = new URL('/login.php', window.location.origin);
+    if (action) {
+        url.searchParams.set('action', action);
+    }
+    const currentParams = new URLSearchParams(window.location.search);
+    // set zonosQaUrl from the current URL
+    const zonosQaUrl = currentParams.get('zonosQaUrl');
+    if (zonosQaUrl) {
+        url.searchParams.set('zonosQaUrl', zonosQaUrl);
+    }
+    // set zonosQaUrlApi from the current URL
+    const zonosQaUrlApi = currentParams.get('zonosQaUrlApi');
+    if (zonosQaUrlApi) {
+        url.searchParams.set('zonosQaUrlApi', zonosQaUrlApi);
+    }
+    // set zonosTestMode from the current URL
+    if (getIsTestMode()) {
+        url.searchParams.set('zonosTestMode', '1');
+    }
+    url.searchParams.set('from', buildFromCartPath());
+    return url.toString();
+};
+
 /**
  * Build an absolute redirect URL used by the BigCommerce checkout flows to
  * navigate between the BC native `/checkout` page and the Zonos international
@@ -165,6 +230,12 @@ const fetchBigCommerceCheckout = async (checkoutId) => {
         return null;
     }
 };
+/**
+ * Whether the BigCommerce shopper is already logged in. We key off the
+ * customer's numeric `id` since the storefront API populates it only for
+ * authenticated sessions (guest checkouts have an empty `customer` object).
+ */
+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 DEFAULT_RESULT = {
     customerGroupId: null,
@@ -174,7 +245,7 @@ const DEFAULT_RESULT = {
  * Performs the actual fetch logic to determine if the customer
  * belongs to a bypass group.
  */
-const fetchBypassOutcome = async () => {
+const fetchBypassOutcome = async (preFetched) => {
     var _a, _b, _c, _d;
     // Only relevant for BigCommerce stores — permanent no-op on other platforms
     if (!window.Zonos.isBigCommerce) {
@@ -191,8 +262,11 @@ const fetchBypassOutcome = async () => {
         // Mark as inconclusive so a later caller retries after config loads.
         return { conclusive: false, result: DEFAULT_RESULT };
     }
-    // Fetch customer group from BigCommerce Storefront API
-    const checkoutId = await fetchCheckoutId();
+    // Fetch customer group from BigCommerce Storefront API — or reuse
+    // caller-supplied data when available.
+    const checkoutId = preFetched
+        ? preFetched.checkoutId
+        : await fetchCheckoutId();
     if (!checkoutId) {
         // No active cart yet — inconclusive. Common on fresh sessions where
         // `initBigCommerceBypassCheck` runs before the user has added anything
@@ -200,7 +274,9 @@ const fetchBypassOutcome = async () => {
         log('BigCommerce bypass check: no active cart yet, will retry on next call', 'info');
         return { conclusive: false, result: DEFAULT_RESULT };
     }
-    const checkout = await fetchBigCommerceCheckout(checkoutId);
+    const checkout = preFetched
+        ? preFetched.checkout
+        : await fetchBigCommerceCheckout(checkoutId);
     if (!checkout) {
         // API call failed (network error, non-200, etc.) — inconclusive.
         // Caching this would permanently disable bypass for the session if
@@ -234,8 +310,8 @@ const fetchBypassOutcome = async () => {
  * cart or after settings finish loading).
  */
 let bypassCheckPromise = null;
-const startBypassCheck = () => {
-    const outcomePromise = fetchBypassOutcome();
+const startBypassCheck = (preFetched) => {
+    const outcomePromise = fetchBypassOutcome(preFetched);
     const resultPromise = outcomePromise.then(({ conclusive, result }) => {
         if (!conclusive && bypassCheckPromise === resultPromise) {
             // Invalidate cache so the next caller performs a fresh fetch.
@@ -281,11 +357,259 @@ const initBigCommerceBypassCheck = () => {
  */
 const checkBigCommerceBypassCustomerGroup = async (options = {}) => {
     if (options.forceRefresh || !bypassCheckPromise) {
-        return startBypassCheck();
+        return startBypassCheck(options.preFetched);
     }
     return bypassCheckPromise;
 };
 
+const EMPTY = { guestCheckoutType: null };
+/**
+ * BigCommerce's `/checkouts/settings` values almost never change after a
+ * merchant's initial setup, so we persist the result in `localStorage` and
+ * reuse it across page loads up to this TTL. Short enough that if the
+ * merchant flips `guest_checkout_type` the change still propagates within
+ * an hour.
+ */
+const CACHE_TTL_MS = 60 * 60 * 1000;
+const CACHE_KEY = 'zonos--bc-checkout-settings';
+const readFromCache = (storeHash) => {
+    try {
+        const raw = window.localStorage.getItem(CACHE_KEY);
+        if (!raw) {
+            return null;
+        }
+        const parsed = jsonParse(raw);
+        if (!parsed) {
+            return null;
+        }
+        // Different store on the same origin (e.g. zonosQaUrl preview) — ignore.
+        if (parsed.storeHash !== storeHash) {
+            return null;
+        }
+        if (parsed.expiresAt < Date.now()) {
+            return null;
+        }
+        return { guestCheckoutType: parsed.guestCheckoutType };
+    }
+    catch (_a) {
+        // localStorage access can throw in blocked-storage contexts (Safari
+        // private mode, cross-origin iframes) — treat as a cache miss so the
+        // network fallback runs.
+        return null;
+    }
+};
+const writeToCache = (storeHash, result) => {
+    try {
+        const payload = {
+            expiresAt: Date.now() + CACHE_TTL_MS,
+            guestCheckoutType: result.guestCheckoutType,
+            storeHash,
+        };
+        window.localStorage.setItem(CACHE_KEY, JSON.stringify(payload));
+    }
+    catch (_a) {
+        // localStorage can be disabled / quota-exceeded in some browser contexts
+        // (private mode, cross-origin iframes) — drop silently since caching
+        // is only an optimization.
+    }
+};
+/**
+ * Fetch the merchant's BigCommerce `/checkouts/settings` (via the demo-app
+ * proxy) so we can inspect `guest_checkout_type` from the storefront. The
+ * Store API is auth-gated, which is why we don't call it directly.
+ *
+ * Results are cached in `localStorage` for `CACHE_TTL_MS` so navigations
+ * inside the same store don't all pay the proxy round trip — the setting
+ * is merchant-level and rarely changes.
+ */
+const fetchBigCommerceCheckoutSettings = async () => {
+    var _a;
+    if (!window.Zonos.isBigCommerce) {
+        return EMPTY;
+    }
+    const storeHash = (_a = zonosStore.checkoutSettings.bigCommerceConfig) === null || _a === void 0 ? void 0 : _a.storeHash;
+    if (!storeHash) {
+        log('BigCommerce checkout settings: no storeHash provided — skipping fetch', 'info');
+        return EMPTY;
+    }
+    const cached = readFromCache(storeHash);
+    if (cached) {
+        return cached;
+    }
+    const { errors, json } = await handleFetch('/api/bigcommerce/checkout-settings', {
+        body: { storeHash },
+        method: 'POST',
+    });
+    if (errors.length || !json) {
+        log('BigCommerce checkout settings: proxy call failed, falling back to guest-allowed behavior', 'info');
+        return EMPTY;
+    }
+    const result = {
+        guestCheckoutType: json.guestCheckoutType,
+    };
+    writeToCache(storeHash, result);
+    return result;
+};
+
+const SKIP = {
+    redirectUrl: null,
+    shouldForceLogin: false,
+};
+/**
+ * Session cache for the merchant-level "does BC require login?" answer.
+ * Hitting `/checkouts/settings` on every checkout open would add a visible
+ * round trip to the hot path, so we resolve it once and reuse — the setting
+ * is configured at the store level and very rarely changes.
+ *
+ * `null` means we haven't kicked off the fetch yet; the promise holds the
+ * eventual boolean so multiple concurrent callers deduplicate.
+ */
+let storeRequiresLoginPromise = null;
+const resolveStoreRequiresLogin = () => {
+    if (!storeRequiresLoginPromise) {
+        const pending = fetchBigCommerceCheckoutSettings()
+            .then(({ guestCheckoutType }) => {
+            if (!guestCheckoutType) {
+                // `null` here means either the proxy call failed (transient) or the
+                // storeHash wasn't known yet. Fail open for this call, but clear
+                // the cached promise so the next caller retries instead of
+                // permanently disabling force-login for the rest of the session.
+                if (storeRequiresLoginPromise === pending) {
+                    storeRequiresLoginPromise = null;
+                }
+                return false;
+            }
+            return guestCheckoutType === 'no_guest_checkout';
+        })
+            .catch(() => {
+            // Defense-in-depth: `fetchBigCommerceCheckoutSettings` is expected to
+            // swallow its own errors, but if anything above does reject we fail
+            // open and clear the cached promise so the next caller can retry.
+            if (storeRequiresLoginPromise === pending) {
+                storeRequiresLoginPromise = null;
+            }
+            return false;
+        });
+        storeRequiresLoginPromise = pending;
+    }
+    return storeRequiresLoginPromise;
+};
+/**
+ * Kick off the `/checkouts/settings` fetch in the background on page load
+ * so the result is warm by the time the shopper opens checkout. Safe to
+ * call more than once — re-invocations reuse the in-flight/resolved
+ * promise.
+ */
+const initBigCommerceForceLoginCheck = () => {
+    if (!window.Zonos.isBigCommerce) {
+        return;
+    }
+    void resolveStoreRequiresLogin();
+};
+/**
+ * Decide whether the current BigCommerce shopper must sign in before the
+ * Zonos international checkout is allowed to open.
+ *
+ * Required conditions (all must hold):
+ *  1. Running on a BigCommerce storefront.
+ *  2. BC merchant has `guest_checkout_type === 'no_guest_checkout'` in their
+ *     live `/v3/checkouts/settings` response.
+ *  3. Shopper has an active cart.
+ *  4. Shopper is not already logged in to BigCommerce.
+ *
+ * Returning a `redirectUrl` is an instruction, not an action: callers drive
+ * the navigation themselves so they can short-circuit any UI state (loading
+ * overlays, dialog open flags) before `window.location.href` flips.
+ */
+const checkBigCommerceForceLogin = async ({ preFetched, } = {}) => {
+    if (!window.Zonos.isBigCommerce) {
+        return SKIP;
+    }
+    const requiresLogin = await resolveStoreRequiresLogin();
+    if (!requiresLogin) {
+        return SKIP;
+    }
+    const checkoutId = preFetched
+        ? preFetched.checkoutId
+        : await fetchCheckoutId();
+    if (!checkoutId) {
+        // No active cart — nothing to protect. Force-login only matters once
+        // the shopper has a cart we're about to carry into Zonos checkout.
+        return SKIP;
+    }
+    const checkout = preFetched
+        ? preFetched.checkout
+        : await fetchBigCommerceCheckout(checkoutId);
+    if (!checkout) {
+        // Storefront API failure — fail open so a transient outage doesn't
+        // block the shopper. The merchant's BC checkout will still enforce
+        // login server-side as a last line of defense.
+        log('BigCommerce force-login check: failed to fetch checkout data, allowing flow to continue', 'info');
+        return SKIP;
+    }
+    if (isBigCommerceCustomerLoggedIn(checkout)) {
+        return SKIP;
+    }
+    log('BigCommerce force-login check: guest shopper on no-guest-checkout store, redirecting to /login.php', 'info');
+    return {
+        redirectUrl: buildBigcommerceLoginUrl(),
+        shouldForceLogin: true,
+    };
+};
+
+/**
+ * Mark we've already rewritten a given anchor so the MutationObserver
+ * doesn't loop on its own mutation.
+ */
+const REWRITTEN_ATTR = 'data-zonos-login-from-rewritten';
+const CREATE_ACCOUNT_SELECTOR = 'a[href*="login.php?action=create_account"]:not([' + REWRITTEN_ATTR + '])';
+const rewriteCreateAccountLinks = () => {
+    const anchors = document.querySelectorAll(CREATE_ACCOUNT_SELECTOR);
+    if (!anchors.length) {
+        return;
+    }
+    const target = buildBigcommerceLoginUrl({ action: 'create_account' });
+    anchors.forEach(anchor => {
+        anchor.setAttribute('href', target);
+        anchor.setAttribute(REWRITTEN_ATTR, 'true');
+    });
+};
+/**
+ * On BigCommerce's `/login.php`, the default **Create account** button links
+ * to `login.php?action=create_account` without the `from=cart.php...`
+ * parameter that the shopper had when they arrived. Without this, completing
+ * signup would drop them on the account home page instead of resuming Zonos
+ * international checkout.
+ *
+ * This watcher finds any create-account anchor on the page (including ones
+ * that the BC theme renders later via Stencil bundle load) and rewrites the
+ * `href` so the account-creation round trip preserves the
+ * `isInternationalCheckout=true` flag as well as `zonosTestMode` /
+ * `zonosQaUrl`.
+ *
+ * Safe to call more than once — idempotent thanks to the `data-zonos-…`
+ * attribute on rewritten anchors.
+ */
+const fixBigCommerceLoginCreateAccountLink = () => {
+    if (!window.Zonos.isBigCommerce) {
+        return;
+    }
+    if (!window.location.pathname.includes('/login.php')) {
+        return;
+    }
+    rewriteCreateAccountLinks();
+    // BC's login page often renders the auth form asynchronously, so the
+    // anchor may not exist yet when this runs. Observe for a short window,
+    // then stop so we don't leak a listener for the rest of the session.
+    const observer = new MutationObserver(() => {
+        rewriteCreateAccountLinks();
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    // 10 seconds is plenty for the login form to mount; stopping the observer
+    // avoids churn from the rest of the page's normal DOM activity.
+    setTimeout(() => observer.disconnect(), 10000);
+};
+
 const isDisabledCountry = (showLog = true) => {
     if (!localizationStore.localizationLoaded) {
         return true;
@@ -335,19 +659,27 @@ const FALLBACK_SHIP_TO_COUNTRY_SELECTOR = 'select[name="shippingAddress.countryC
  */
 const checkLoggedInUserShippingAddress = async ({ onInternationalCheckoutSelected, onLoggedInInternationalAddressDetected, }) => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    // Fetch the Storefront API data once up front and thread it through every
+    // decision below (bypass, shipping-address inspection, force-login). The
+    // function always needs the checkout for the address check, so reusing one
+    // fetch avoids the earlier 4x round-trip fan-out where bypass, address
+    // lookup, and force-login each fetched independently.
+    const checkoutId = await fetchCheckoutId();
+    if (!checkoutId) {
+        return 'noAction';
+    }
+    const checkout = await fetchBigCommerceCheckout(checkoutId);
+    const preFetched = { checkout, checkoutId };
     // Check if the customer belongs to a bypass group (e.g. resellers) before
     // redirecting them away from BigCommerce native checkout. This delegates to
     // the shared helper so the bypass decision has a single source of truth and
     // reuses the cached promise warmed by `initBigCommerceBypassCheck`.
-    const { shouldBypass } = await checkBigCommerceBypassCustomerGroup();
+    const { shouldBypass } = await checkBigCommerceBypassCustomerGroup({
+        preFetched,
+    });
     if (shouldBypass) {
         return 'noAction';
     }
-    const checkoutId = await fetchCheckoutId();
-    if (!checkoutId) {
-        return 'noAction';
-    }
-    const checkout = await fetchBigCommerceCheckout(checkoutId);
     const shippingAddress = (_b = (_a = checkout === null || checkout === void 0 ? void 0 : checkout.consignments) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.shippingAddress;
     if (!(shippingAddress === null || shippingAddress === void 0 ? void 0 : shippingAddress.countryCode)) {
         return 'noAction';
@@ -370,6 +702,14 @@ const checkLoggedInUserShippingAddress = async ({ onInternationalCheckoutSelecte
             return 'optedOut';
         }
     }
+    // Force-login merchants must sign the guest shopper in before we leave
+    // BC's native checkout. Reuse the checkout we already fetched above so we
+    // don't double up on Storefront API round trips.
+    const forceLogin = await checkBigCommerceForceLogin({ preFetched });
+    if (forceLogin.shouldForceLogin && forceLogin.redirectUrl) {
+        window.location.href = forceLogin.redirectUrl;
+        return 'redirected';
+    }
     if (onInternationalCheckoutSelected) {
         await onInternationalCheckoutSelected();
     }
@@ -427,9 +767,17 @@ const watchImmediateBigcommerceDomesticCheckoutRedirect = ({ domesticRedirectedB
         // Only check bypass after confirming the country is shippable (i.e. user is
         // about to be redirected to Zonos international checkout). Force-refresh so
         // we re-fetch BigCommerce checkout data every time the ship-to country
-        // changes — prevents stale customer-group data from a cached fetch.
+        // changes — prevents stale customer-group data from a cached fetch. Share
+        // one fetch between the bypass and force-login decisions so this poll
+        // tick does 2 Storefront API round trips instead of 4.
+        const checkoutId = await fetchCheckoutId();
+        const checkout = checkoutId
+            ? await fetchBigCommerceCheckout(checkoutId)
+            : null;
+        const preFetched = { checkout, checkoutId };
         const { shouldBypass } = await checkBigCommerceBypassCustomerGroup({
             forceRefresh: true,
+            preFetched,
         });
         if (shouldBypass) {
             // Logged-in customer is in a bypass group — keep them on BC native
@@ -437,6 +785,14 @@ const watchImmediateBigcommerceDomesticCheckoutRedirect = ({ domesticRedirectedB
             log('Bypass customer group detected on BC checkout, stopping interval', 'info');
             return true;
         }
+        // Same force-login gate as the logged-in-default-address path — we run
+        // it *after* the bypass check so reseller groups never see the login
+        // bounce, and *before* any UI/session state flips to the redirect.
+        const forceLogin = await checkBigCommerceForceLogin({ preFetched });
+        if (forceLogin.shouldForceLogin && forceLogin.redirectUrl) {
+            window.location.href = forceLogin.redirectUrl;
+            return true;
+        }
         if (onInternationalCheckoutSelected) {
             await onInternationalCheckoutSelected();
         }
@@ -1560,6 +1916,15 @@ const ZonosCheckout = class {
                         window.location.href = buildBigcommerceRedirectUrl('/checkout');
                         return;
                     }
+                    // Merchants who disable BC guest checkout need the shopper
+                    // signed in before we open the Zonos international checkout.
+                    // Redirecting here keeps the dialog from flashing before the
+                    // login bounce.
+                    const forceLogin = await checkBigCommerceForceLogin();
+                    if (forceLogin.shouldForceLogin && forceLogin.redirectUrl) {
+                        window.location.href = forceLogin.redirectUrl;
+                        return;
+                    }
                 }
                 // start loading
                 stripeStore.isFetchingSession = true;
@@ -1812,6 +2177,19 @@ const ZonosCheckout = class {
         // Start fetching BigCommerce customer group on page load so the bypass
         // result is ready by the time checkout opens or the BC watcher fires
         initBigCommerceBypassCheck();
+        // Warm the BigCommerce `/checkouts/settings` fetch (merchant's
+        // `guest_checkout_type`) so force-login gating resolves instantly when
+        // the shopper clicks checkout — otherwise the first checkout open
+        // would block on a proxy round trip.
+        initBigCommerceForceLoginCheck();
+        // On BC's `/login.php`, rewrite the "Create account" button href so
+        // the post-signup round trip preserves the `from=cart.php?...` flag
+        // that carries the shopper back into Zonos international checkout.
+        fixBigCommerceLoginCreateAccountLink();
+        // If BC redirected the shopper back here after login with the Zonos
+        // resume flag, auto-open the international checkout. Strip the flag
+        // from the URL so a refresh doesn't keep re-triggering the dialog.
+        this.handleBigcommerceInternationalResumeFlag();
         // check if bigcommerce, if user enters the shipping address that's in the shipping zone at bigcommerce checkout
         watchImmediateBigcommerceDomesticCheckoutRedirect({
             domesticRedirectedBtnSelector: domesticRedirectedBtnSelector,
@@ -1893,6 +2271,53 @@ const ZonosCheckout = class {
             clearInterval(interval);
         }, 10000);
     }
+    /**
+     * After BigCommerce's `/login.php` round trip, the shopper lands back on
+     * `cart.php?isInternationalCheckout=true`. Detect the flag, strip it from
+     * the URL (so refreshing doesn't re-open the dialog), then fire the
+     * international-checkout trigger once three preconditions are all met:
+     *  1. Hello localization finished loading (`localizationLoaded`).
+     *  2. A country code is selected — otherwise `buildCartDetail` runs
+     *     without a `countryCode` / `currencyCode` and never builds a cart.
+     *  3. The hidden trigger button has mounted.
+     *
+     * Without the first two gates we race Hello's own init and the click
+     * fires against a half-initialized store, which is what happens when
+     * the shopper refreshes back into cart.php straight from the login
+     * round trip.
+     */
+    handleBigcommerceInternationalResumeFlag() {
+        if (!window.Zonos.isBigCommerce) {
+            return;
+        }
+        const url = new URL(window.location.href);
+        if (url.searchParams.get(BIGCOMMERCE_INTERNATIONAL_CHECKOUT_FLAG) !== 'true') {
+            return;
+        }
+        url.searchParams.delete(BIGCOMMERCE_INTERNATIONAL_CHECKOUT_FLAG);
+        window.history.replaceState({}, '', url.toString());
+        const start = Date.now();
+        const interval = setInterval(() => {
+            if (!localizationStore.localizationLoaded ||
+                !localizationStore.selectedCountryCode) {
+                if (Date.now() - start > 15000) {
+                    clearInterval(interval);
+                    log('BigCommerce international checkout resume flag: localization did not initialize within 15s', 'info');
+                }
+                return;
+            }
+            const btn = document.querySelector(`#${checkoutHiddenInternationalBtnSelector}`);
+            if (btn) {
+                clearInterval(interval);
+                btn.dispatchEvent(createCustomEvent('click'));
+                return;
+            }
+            if (Date.now() - start > 15000) {
+                clearInterval(interval);
+                log('BigCommerce international checkout resume flag: trigger button did not mount within 15s', 'info');
+            }
+        }, 200);
+    }
     /**
      * For storybook to set to finish step, this is to trigger in the story for zonos-checkout-finish
      */

package/dist/esm/zonos-hello-dialog.entry.js

@@ -139,7 +139,7 @@ const ZonosHelloDialog = class {
         };
         this.getDutyMessage = () => {
             // Domestic orders stay within the merchant's origin country, so no
-            // duty is ever assessed — surface that instead of a de minimis threshold.
+            // duty is ever assessed — skip the de minimis message.
             if (this.isDomesticCountry()) {
                 return null;
             }
@@ -163,7 +163,7 @@ const ZonosHelloDialog = class {
         this.getTaxMessage = () => {
             const { countryLandedCost } = localizationStore;
             // Domestic orders stay within the merchant's origin country, so no
-            // duty is ever assessed — surface that instead of a de minimis threshold.
+            // import tax is ever assessed — skip the de minimis message.
             if (this.isDomesticCountry()) {
                 return null;
             }
@@ -379,25 +379,25 @@ const ZonosHelloDialog = class {
         // If deminimis is undefined or null, assume it's $0
         const taxDeMinimisMessage = this.getTaxMessage();
         const inclusivePriceMessage = this.getInclusivePriceMessage();
-        return (h(Host, { key: '1278dbea844ec9e53b8224ede278281614be2fc6', class: "zonos--elements" }, h("div", { key: '5728be8b327198f0c09cf5865df43ae8bbe60beb', class: classes([
+        return (h(Host, { key: '910b2b5600107a097fa4cdc77ec487e03fe6a8d2', class: "zonos--elements" }, h("div", { key: 'edf1d9b554807db1c973a1ccdb6e20a647c24204', class: classes([
                 'zonos--hello-dialog',
                 animateLeft && 'zonos--hello-dialog-animate-from-left',
                 animateFromBottom && 'zonos--hello-dialog-animate-from-bottom',
                 !!this.mobileLocationOverride &&
                     'zonos--hello-dialog-mobile-override',
                 this.isOpen && 'zonos--hello-dialog-open',
-            ]), inert: !this.isOpen, ref: el => el && (this.dialogRef = el) }, !this.showCountrySelect && !this.showLanguageSelect && (h("div", { key: 'cbaa0d35c446529f07bcca4d7e12980e61d9bd7b' }, h("div", { key: '7da2f46a06fb320f07300232e2c910ba572ee5ad', class: "zonos--hello-dialog-content" }, h("zonos-button", { key: 'ebe6f3cc03afdb1ffa5e8fb13c311dcd2249c002', class: "zonos--close-button", icon: h("zonos-icon", { "aria-label": "Close Zonos Hello dialog", content: RemoveIcon }), noBackground: true, onClick: () => this.setIsOpen(false) }), h("zonos-v-stack", { key: 'ccfe32e9dda067e0c95cd28a3e3ee283f2efbdff', spacing: 24 }, h("zonos-country-flag", { key: 'ead0ffe10deb11ef18ef39def2710faf43b286a7', class: "zonos--hello-country-flag", countryCode: selectedCountryCode }), h("zonos-v-stack", { key: '4927c2cb517003ccc55d57c0c7ab5cb55db5b369', class: "zonos--hello-dialog-header", spacing: 4 }, h("zonos-text", { key: '732277a98d48d4041eef395db5d06a5c4214fd4d', type: "boldSubheader" }, welcomeMessage), h("zonos-text", { key: '88a0fec8b49e5a998688e5be8eb444cde1c04295', innerHTML: defaultMessage, textColor: "gray-800" })), h("zonos-v-stack", { key: '9e004f4aedff3236736efc3287f4f94759f426a3', spacing: 8 }, this.restrictedItems.map(item => {
+            ]), inert: !this.isOpen, ref: el => el && (this.dialogRef = el) }, !this.showCountrySelect && !this.showLanguageSelect && (h("div", { key: 'f5316102d12d07e1a3c701ad641995413ee445b2' }, h("div", { key: 'c11cc7e8d11f733c82435a531d7d8595b0237eae', class: "zonos--hello-dialog-content" }, h("zonos-button", { key: 'a2aa2802331e9ed5c40d877fcb7ffb0cebd318c5', class: "zonos--close-button", icon: h("zonos-icon", { "aria-label": "Close Zonos Hello dialog", content: RemoveIcon }), noBackground: true, onClick: () => this.setIsOpen(false) }), h("zonos-v-stack", { key: 'f6df6e6562b8ddebb0e910d669a6a263114f6407', spacing: 24 }, h("zonos-country-flag", { key: '71c320b3364deee7c545284a2fc639cef3a3ba27', class: "zonos--hello-country-flag", countryCode: selectedCountryCode }), h("zonos-v-stack", { key: '9603247163d334db33fe00428190fafdd6ef6c42', class: "zonos--hello-dialog-header", spacing: 4 }, h("zonos-text", { key: 'aad7fd909092a9fad15ce88a3f43ad5115bca1f9', type: "boldSubheader" }, welcomeMessage), h("zonos-text", { key: 'c3c9c5d5f9e1000b2b6c6aebc73f18c6653f9de2', innerHTML: defaultMessage, textColor: "gray-800" })), h("zonos-v-stack", { key: 'c34b1b9debb507ce6f230bd13b493a14af12e880', spacing: 8 }, this.restrictedItems.map(item => {
             var _a;
             return item && (h("zonos-banner", { bannerTitle: item.name, intent: "error" }, (_a = item.itemRestrictions) === null || _a === void 0 ? void 0 : _a.map(x => (h("zonos-text", { textColor: "red-800" }, x === null || x === void 0 ? void 0 : x.note)))));
         }), (dutyDeMinimisMessage ||
             taxDeMinimisMessage ||
             inclusivePriceMessage ||
-            !!(additionalInformation === null || additionalInformation === void 0 ? void 0 : additionalInformation.length)) && (h("zonos-card", { key: 'bb2f4d2442f1ef0926dcc3740d3b66e4ef0a3c53', spacing: "12px" }, h("zonos-v-stack", { key: 'a2459ed448da424b89298c24ef7df3629a7fca81', spacing: 12 }, this.renderHelloMessage({
+            !!(additionalInformation === null || additionalInformation === void 0 ? void 0 : additionalInformation.length)) && (h("zonos-card", { key: '5dc5af9af7263333433b8a0382a30ccf9f28056d', spacing: "12px" }, h("zonos-v-stack", { key: '725669eaca664abc90f5ec8181c3b81c05cc3b52', spacing: 12 }, this.renderHelloMessage({
             dutyDeMinimisMessage,
             inclusivePriceMessage,
             taxDeMinimisMessage,
         }), additionalInformation === null || additionalInformation === void 0 ? void 0 :
-            additionalInformation.map(info => (h("div", { class: "zonos--flex-message" }, h("zonos-icon", { "aria-label": "Additional information for buying goods from selected country icon", content: BagIcon }), h("zonos-text", { "aria-label": `Additional information for buying goods from selected country message`, innerHTML: info }))))))), filteredMessages.map(x => (h("zonos-custom-message", { icon: MessageIcon, message: x.message })))))), h("zonos-hello-dialog-footer", { key: '1480a6212aa6a620549962b2b58349592c2474c0', appearanceSettings: this.appearanceSettings, setShowCountrySelect: value => this.setShowCountrySelect(value), setShowLanguageSelect: value => this.setShowLanguageSelect(value) }))), this.showCountrySelect && (h("div", { key: 'af985242d03159913dc3e3dc832fdd6bbb48d905' }, h("zonos-country-select", { key: 'e98898e3cba56bc3299832345c9e47608acd6176', handleOnClose: () => this.setShowCountrySelect(false) }))), this.showLanguageSelect && (h("div", { key: '3fc35b6383376e25c8d810d1631b7ccbe5541843' }, h("zonos-language-select", { key: 'ed782d71214f8668f14c468171231428b55e712a', handleOnClose: () => this.setShowLanguageSelect(false) }))))));
+            additionalInformation.map(info => (h("div", { class: "zonos--flex-message" }, h("zonos-icon", { "aria-label": "Additional information for buying goods from selected country icon", content: BagIcon }), h("zonos-text", { "aria-label": `Additional information for buying goods from selected country message`, innerHTML: info }))))))), filteredMessages.map(x => (h("zonos-custom-message", { icon: MessageIcon, message: x.message })))))), h("zonos-hello-dialog-footer", { key: '077adfd58b2d7d95d5f352a09783089a1e91c99f', appearanceSettings: this.appearanceSettings, setShowCountrySelect: value => this.setShowCountrySelect(value), setShowLanguageSelect: value => this.setShowLanguageSelect(value) }))), this.showCountrySelect && (h("div", { key: '8c2dd5d73a649eebf1517a9b359d3ecc93b12620' }, h("zonos-country-select", { key: 'e2f64c73efe1e931808fdfe6aa5f8545d6f39c93', handleOnClose: () => this.setShowCountrySelect(false) }))), this.showLanguageSelect && (h("div", { key: '0b9ba684ac67fa652a34e6fbad8e966970f391ce' }, h("zonos-language-select", { key: '2e03e02459b0f31bc69376bc154ed8bb2d96ef56', handleOnClose: () => this.setShowLanguageSelect(false) }))))));
     }
     static get assetsDirs() { return ["assets"]; }
     static get watchers() { return {