@zonos/elements 1.3.267 → 1.3.269

package/dist/collection/components/store/translationStore/strings.portuguese.js

@@ -281,6 +281,12 @@ export const stringsPortuguese = {
     'Hide non-prepaid options': {
         value: 'Ocultar opções não pré-pagas',
     },
+    "I agree to [merchantName]'s [policies]": {
+        value: 'Concordo com os [policies] de [merchantName]',
+    },
+    'I agree to the [policies]': {
+        value: 'Concordo com [policies]',
+    },
     "If you select FedEx Ground as your shipping option, you'll need to complete a General Agency Agreement (GAA) after placing your order. This form allows FedEx to clear your package through Canadian customs on your behalf. FedEx will contact you directly—usually by email or phone—with instructions on how to complete the GAA. To avoid delays or the return of your package, please respond promptly to their request.": {
         value: 'Se você selecionar FedEx Ground como sua opção de envio, precisará completar um Acordo de Agência Geral (GAA) após fazer seu pedido. Este formulário permite que a FedEx libere seu pacote pela alfândega canadense em seu nome. A FedEx entrará em contato diretamente com você, geralmente por e-mail ou telefone, com instruções sobre como completar o GAA. Para evitar atrasos ou a devolução do seu pacote, responda prontamente à solicitação deles.',
     },
@@ -497,6 +503,9 @@ export const stringsPortuguese = {
     'RFC number': {
         value: 'Número RFC',
     },
+    'Refund policy': {
+        value: 'Política de reembolso',
+    },
     Region: {
         value: 'Região',
     },
@@ -551,6 +560,9 @@ export const stringsPortuguese = {
     'Shipping method': {
         value: 'Método de envio',
     },
+    'Shipping policy': {
+        value: 'Política de envio',
+    },
     'Shopping cart expired': {
         value: 'Carrinho de compras expirado',
     },
@@ -638,6 +650,9 @@ export const stringsPortuguese = {
     'Taxes, duties, and fees included': {
         value: 'Impostos, taxas e tarifas incluídos',
     },
+    'Terms and conditions': {
+        value: 'Termos e condições',
+    },
     'Test cards': {
         value: 'Cartões de teste',
     },
@@ -725,6 +740,9 @@ export const stringsPortuguese = {
     Village: {
         value: 'Aldeia',
     },
+    'Warranty policy': {
+        value: 'Política de garantia',
+    },
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'Não foi possível concluir seu pagamento. Por favor, verifique os dados e tente novamente.',
     },
@@ -755,6 +773,9 @@ export const stringsPortuguese = {
     'You may incur additional fees from the shipping carrier by not prepaying.': {
         value: 'Você pode incorrer em taxas adicionais da transportadora por não pagar antecipadamente.',
     },
+    'You must accept the policies to place this order': {
+        value: 'Você deve aceitar as políticas para fazer este pedido',
+    },
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'Você será redirecionado de volta ao site do comerciante em alguns segundos.',
     },

package/dist/collection/components/store/translationStore/strings.russian.js

@@ -281,6 +281,12 @@ export const stringsRussian = {
     'Hide non-prepaid options': {
         value: 'Скрыть неоплаченные варианты',
     },
+    "I agree to [merchantName]'s [policies]": {
+        value: 'Я согласен с [policies] компании [merchantName]',
+    },
+    'I agree to the [policies]': {
+        value: 'Я согласен с [policies]',
+    },
     "If you select FedEx Ground as your shipping option, you'll need to complete a General Agency Agreement (GAA) after placing your order. This form allows FedEx to clear your package through Canadian customs on your behalf. FedEx will contact you directly—usually by email or phone—with instructions on how to complete the GAA. To avoid delays or the return of your package, please respond promptly to their request.": {
         value: 'Если вы выберете FedEx Ground в качестве варианта доставки, вам нужно будет заполнить Генеральное агентское соглашение (GAA) после размещения заказа. Эта форма позволяет FedEx растаможить ваш пакет через канадскую таможню от вашего имени. FedEx свяжется с вами напрямую — обычно по электронной почте или телефону — с инструкциями о том, как заполнить GAA. Чтобы избежать задержек или возврата вашего пакета, пожалуйста, быстро ответьте на их запрос.',
     },
@@ -497,6 +503,9 @@ export const stringsRussian = {
     'RFC number': {
         value: 'Номер RFC',
     },
+    'Refund policy': {
+        value: 'Политика возврата',
+    },
     Region: {
         value: 'Регион',
     },
@@ -551,6 +560,9 @@ export const stringsRussian = {
     'Shipping method': {
         value: 'Способ доставки',
     },
+    'Shipping policy': {
+        value: 'Политика доставки',
+    },
     'Shopping cart expired': {
         value: 'Срок действия корзины истек',
     },
@@ -638,6 +650,9 @@ export const stringsRussian = {
     'Taxes, duties, and fees included': {
         value: 'Налоги, пошлины и сборы включены',
     },
+    'Terms and conditions': {
+        value: 'Условия использования',
+    },
     'Test cards': {
         value: 'Тестовые карты',
     },
@@ -725,6 +740,9 @@ export const stringsRussian = {
     Village: {
         value: 'Деревня',
     },
+    'Warranty policy': {
+        value: 'Гарантийная политика',
+    },
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'Не удалось завершить оплату. Пожалуйста, проверьте платежные данные и попробуйте еще раз.',
     },
@@ -755,6 +773,9 @@ export const stringsRussian = {
     'You may incur additional fees from the shipping carrier by not prepaying.': {
         value: 'Вы можете понести дополнительные расходы от перевозчика, если не оплатите заранее.',
     },
+    'You must accept the policies to place this order': {
+        value: 'Вы должны принять политики, чтобы оформить этот заказ',
+    },
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'Вы будете перенаправлены обратно на сайт продавца через несколько секунд.',
     },

package/dist/collection/components/store/translationStore/strings.spanish.js

@@ -281,6 +281,12 @@ export const stringsSpanish = {
     'Hide non-prepaid options': {
         value: 'Ocultar opciones no prepagadas',
     },
+    "I agree to [merchantName]'s [policies]": {
+        value: 'Acepto los [policies] de [merchantName]',
+    },
+    'I agree to the [policies]': {
+        value: 'Acepto [policies]',
+    },
     "If you select FedEx Ground as your shipping option, you'll need to complete a General Agency Agreement (GAA) after placing your order. This form allows FedEx to clear your package through Canadian customs on your behalf. FedEx will contact you directly—usually by email or phone—with instructions on how to complete the GAA. To avoid delays or the return of your package, please respond promptly to their request.": {
         value: 'Si seleccionas FedEx Ground como tu opción de envío, necesitarás completar un Acuerdo de Agencia General (GAA) después de realizar tu pedido. Este formulario permite a FedEx despachar tu paquete a través de la aduana canadiense en tu nombre. FedEx se pondrá en contacto contigo directamente, generalmente por correo electrónico o teléfono, con instrucciones sobre cómo completar el GAA. Para evitar retrasos o la devolución de tu paquete, responde rápidamente a su solicitud.',
     },
@@ -497,6 +503,9 @@ export const stringsSpanish = {
     'RFC number': {
         value: 'Número RFC',
     },
+    'Refund policy': {
+        value: 'Política de reembolso',
+    },
     Region: {
         value: 'Región',
     },
@@ -551,6 +560,9 @@ export const stringsSpanish = {
     'Shipping method': {
         value: 'Método de envío',
     },
+    'Shipping policy': {
+        value: 'Política de envío',
+    },
     'Shopping cart expired': {
         value: 'Carrito de compras caducado',
     },
@@ -638,6 +650,9 @@ export const stringsSpanish = {
     'Taxes, duties, and fees included': {
         value: 'Impuestos, aranceles y tarifas incluidos',
     },
+    'Terms and conditions': {
+        value: 'Términos y condiciones',
+    },
     'Test cards': {
         value: 'Tarjetas de prueba',
     },
@@ -725,6 +740,9 @@ export const stringsSpanish = {
     Village: {
         value: 'Pueblo',
     },
+    'Warranty policy': {
+        value: 'Política de garantía',
+    },
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'No pudimos completar su pago. Por favor verifique los datos de pago y vuelva a intentarlo.',
     },
@@ -755,6 +773,9 @@ export const stringsSpanish = {
     'You may incur additional fees from the shipping carrier by not prepaying.': {
         value: 'Puede incurrir en tarifas adicionales del transportista si no paga por adelantado.',
     },
+    'You must accept the policies to place this order': {
+        value: 'Debe aceptar las políticas para realizar este pedido',
+    },
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'Serás redirigido de nuevo al sitio del comerciante en unos segundos.',
     },

package/dist/collection/components/store/translationStore/strings.swedish.js

@@ -281,6 +281,12 @@ export const stringsSwedish = {
     'Hide non-prepaid options': {
         value: 'Dölj icke-förbetalda alternativ',
     },
+    "I agree to [merchantName]'s [policies]": {
+        value: 'Jag godkänner [merchantName]s [policies]',
+    },
+    'I agree to the [policies]': {
+        value: 'Jag godkänner [policies]',
+    },
     "If you select FedEx Ground as your shipping option, you'll need to complete a General Agency Agreement (GAA) after placing your order. This form allows FedEx to clear your package through Canadian customs on your behalf. FedEx will contact you directly—usually by email or phone—with instructions on how to complete the GAA. To avoid delays or the return of your package, please respond promptly to their request.": {
         value: 'Om du väljer FedEx Ground som ditt fraktalternativ måste du fylla i ett General Agency Agreement (GAA) efter att du har lagt din beställning. Detta formulär tillåter FedEx att tullklarera ditt paket genom kanadensisk tull å dina vägnar. FedEx kommer att kontakta dig direkt – vanligtvis via e-post eller telefon – med instruktioner om hur du slutför GAA. För att undvika förseningar eller retur av ditt paket, vänligen svara snabbt på deras begäran.',
     },
@@ -497,6 +503,9 @@ export const stringsSwedish = {
     'RFC number': {
         value: 'RFC-nummer',
     },
+    'Refund policy': {
+        value: 'Återbetalningspolicy',
+    },
     Region: {
         value: 'Region',
     },
@@ -551,6 +560,9 @@ export const stringsSwedish = {
     'Shipping method': {
         value: 'Fraktmetod',
     },
+    'Shipping policy': {
+        value: 'Leveranspolicy',
+    },
     'Shopping cart expired': {
         value: 'Kundvagn har gått ut',
     },
@@ -638,6 +650,9 @@ export const stringsSwedish = {
     'Taxes, duties, and fees included': {
         value: 'Skatter, tullar och avgifter ingår',
     },
+    'Terms and conditions': {
+        value: 'Villkor',
+    },
     'Test cards': {
         value: 'Testkort',
     },
@@ -725,6 +740,9 @@ export const stringsSwedish = {
     Village: {
         value: 'By',
     },
+    'Warranty policy': {
+        value: 'Garantipolicy',
+    },
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'Vi kunde inte slutföra din betalning. Vänligen verifiera betalningsuppgifterna och försök igen.',
     },
@@ -755,6 +773,9 @@ export const stringsSwedish = {
     'You may incur additional fees from the shipping carrier by not prepaying.': {
         value: 'Du kan få extra avgifter från fraktbolaget om du inte förbetalar.',
     },
+    'You must accept the policies to place this order': {
+        value: 'Du måste acceptera policyerna för att lägga denna beställning',
+    },
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'Du kommer att omdirigeras tillbaka till handlarens webbplats om några sekunder.',
     },

package/dist/collection/components/store/translationStore/strings.turkish.js

@@ -281,6 +281,12 @@ export const stringsTurkish = {
     'Hide non-prepaid options': {
         value: 'Ön ödemesiz seçenekleri gizle',
     },
+    "I agree to [merchantName]'s [policies]": {
+        value: '[merchantName] [policies] kabul ediyorum',
+    },
+    'I agree to the [policies]': {
+        value: '[policies] kabul ediyorum',
+    },
     "If you select FedEx Ground as your shipping option, you'll need to complete a General Agency Agreement (GAA) after placing your order. This form allows FedEx to clear your package through Canadian customs on your behalf. FedEx will contact you directly—usually by email or phone—with instructions on how to complete the GAA. To avoid delays or the return of your package, please respond promptly to their request.": {
         value: "FedEx Ground'u nakliye seçeneğiniz olarak seçerseniz, siparişinizi verdikten sonra bir Genel Ajans Anlaşması (GAA) tamamlamanız gerekecektir. Bu form, FedEx'in adınıza Kanada gümrüğünden paketinizi geçirmesine olanak tanır. FedEx, GAA'yı nasıl tamamlayacağınız konusunda talimatlarla genellikle e-posta veya telefon yoluyla doğrudan sizinle iletişime geçecektir. Gecikmeleri veya paketinizin iadesini önlemek için taleplerine hızlıca yanıt verin.",
     },
@@ -497,6 +503,9 @@ export const stringsTurkish = {
     'RFC number': {
         value: 'RFC numarası',
     },
+    'Refund policy': {
+        value: 'İade politikası',
+    },
     Region: {
         value: 'Bölge',
     },
@@ -551,6 +560,9 @@ export const stringsTurkish = {
     'Shipping method': {
         value: 'Kargo yöntemi',
     },
+    'Shipping policy': {
+        value: 'Kargo politikası',
+    },
     'Shopping cart expired': {
         value: 'Alışveriş sepeti süresi doldu',
     },
@@ -638,6 +650,9 @@ export const stringsTurkish = {
     'Taxes, duties, and fees included': {
         value: 'Vergiler, harçlar ve ücretler dahildir',
     },
+    'Terms and conditions': {
+        value: 'Şartlar ve koşullar',
+    },
     'Test cards': {
         value: 'Test kartları',
     },
@@ -725,6 +740,9 @@ export const stringsTurkish = {
     Village: {
         value: 'Köy',
     },
+    'Warranty policy': {
+        value: 'Garanti politikası',
+    },
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'Ödemenizi tamamlayamadık. Lütfen ödeme bilgilerinizi kontrol edip tekrar deneyin.',
     },
@@ -755,6 +773,9 @@ export const stringsTurkish = {
     'You may incur additional fees from the shipping carrier by not prepaying.': {
         value: 'Ön ödeme yapmazsanız, nakliye şirketinden ek ücretler alabilirsiniz.',
     },
+    'You must accept the policies to place this order': {
+        value: 'Bu siparişi vermek için politikaları kabul etmelisiniz',
+    },
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'Birkaç saniye içinde satıcının sitesine geri yönlendirileceksiniz.',
     },

package/dist/collection/components/store/translationStore/strings.vietnamese.js

@@ -281,6 +281,12 @@ export const stringsVietnamese = {
     'Hide non-prepaid options': {
         value: 'Ẩn các tùy chọn chưa trả trước',
     },
+    "I agree to [merchantName]'s [policies]": {
+        value: 'Tôi đồng ý với [policies] của [merchantName]',
+    },
+    'I agree to the [policies]': {
+        value: 'Tôi đồng ý với [policies]',
+    },
     "If you select FedEx Ground as your shipping option, you'll need to complete a General Agency Agreement (GAA) after placing your order. This form allows FedEx to clear your package through Canadian customs on your behalf. FedEx will contact you directly—usually by email or phone—with instructions on how to complete the GAA. To avoid delays or the return of your package, please respond promptly to their request.": {
         value: 'Nếu bạn chọn FedEx Ground làm tùy chọn vận chuyển của mình, bạn sẽ cần hoàn thành Thỏa thuận Đại lý Chung (GAA) sau khi đặt hàng. Biểu mẫu này cho phép FedEx thông quan gói hàng của bạn qua hải quan Canada thay mặt bạn. FedEx sẽ liên hệ trực tiếp với bạn - thường qua email hoặc điện thoại - với hướng dẫn về cách hoàn thành GAA. Để tránh sự chậm trễ hoặc trả lại gói hàng của bạn, vui lòng trả lời nhanh chóng yêu cầu của họ.',
     },
@@ -497,6 +503,9 @@ export const stringsVietnamese = {
     'RFC number': {
         value: 'Số RFC',
     },
+    'Refund policy': {
+        value: 'Chính sách hoàn tiền',
+    },
     Region: {
         value: 'Khu vực',
     },
@@ -551,6 +560,9 @@ export const stringsVietnamese = {
     'Shipping method': {
         value: 'Phương thức vận chuyển',
     },
+    'Shipping policy': {
+        value: 'Chính sách vận chuyển',
+    },
     'Shopping cart expired': {
         value: 'Giỏ hàng đã hết hạn',
     },
@@ -638,6 +650,9 @@ export const stringsVietnamese = {
     'Taxes, duties, and fees included': {
         value: 'Thuế, phí và lệ phí đã bao gồm',
     },
+    'Terms and conditions': {
+        value: 'Điều khoản và điều kiện',
+    },
     'Test cards': {
         value: 'Thẻ kiểm tra',
     },
@@ -725,6 +740,9 @@ export const stringsVietnamese = {
     Village: {
         value: 'Làng',
     },
+    'Warranty policy': {
+        value: 'Chính sách bảo hành',
+    },
     "We couldn't complete your payment. Please verify the payment details and try again.": {
         value: 'Chúng tôi không thể hoàn tất thanh toán của bạn. Vui lòng xác minh thông tin thanh toán và thử lại.',
     },
@@ -755,6 +773,9 @@ export const stringsVietnamese = {
     'You may incur additional fees from the shipping carrier by not prepaying.': {
         value: 'Bạn có thể phải chịu thêm phí từ nhà vận chuyển nếu không trả trước.',
     },
+    'You must accept the policies to place this order': {
+        value: 'Bạn phải chấp nhận các chính sách để đặt đơn hàng này',
+    },
     "You will be redirected back to the merchant's site in a few seconds.": {
         value: 'Bạn sẽ được chuyển hướng trở lại trang web của người bán trong vài giây.',
     },

package/dist/collection/components/store/zonosStore.js

@@ -20,6 +20,7 @@ const { dispose: zonosStoreDispose, onChange: zonosStoreOnChange, reset, state:
         defaultCartExpiration: 3600,
         externalPaymentMethods: [],
         externalServiceTokens: [],
+        merchantPolicyLinks: null,
         mode: 'TEST',
         orderNotifications: {
             abandonedCart: {

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

@@ -50,6 +50,34 @@ export const fetchBigCommerceCheckout = async (checkoutId) => {
         return null;
     }
 };
+/**
+ * Delete a consignment (a saved shipping selection, e.g. a domestic shipping
+ * quote the shopper added on the cart page) from the active BigCommerce
+ * checkout via the Storefront API. Cookie-authenticated (same-origin), so no
+ * token is needed. Returns the updated checkout on success, or null on
+ * failure.
+ */
+export const deleteBigCommerceConsignment = async (checkoutId, consignmentId) => {
+    try {
+        const response = await fetch(`/api/storefront/checkouts/${checkoutId}/consignments/${consignmentId}`, {
+            credentials: 'same-origin',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+            },
+            method: 'DELETE',
+        });
+        if (!response.ok) {
+            log(`Failed to delete BigCommerce consignment: ${String(response.status)}`, 'error');
+            return null;
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        logError('Error deleting BigCommerce consignment', error);
+        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

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

@@ -0,0 +1,83 @@
+import { localizationStore } from "../../store/hello/localization";
+import { deleteBigCommerceConsignment, fetchBigCommerceCheckout, fetchCheckoutId, } from "./bigcommerceStorefrontApi";
+import { shouldShowHelloWidget } from "../hello/shouldShowHelloWidget";
+import { log } from "../logging/log";
+import { logError } from "../logging/logError";
+/**
+ * Guard against overlapping passes. `removeBigcommerceCartShipping` is fired on
+ * every country change; without this flag, rapid country switches could stack
+ * concurrent fetch/DELETE cycles against the same cart before the reload kicks
+ * in.
+ */
+let isRemoving = false;
+/**
+ * On the BigCommerce cart page, drop any native domestic shipping quote the
+ * shopper added before they switched to an international country, then reload
+ * the page.
+ *
+ * The native cart stores a shipping estimate as a consignment on the active
+ * checkout. When Hello is shown the shopper is checking out internationally
+ * through Zonos, so that domestic shipping cost should not linger in the Grand
+ * Total. We delete the consignment(s) and reload so the server re-renders the
+ * cart consistently (subtotal, shipping, and Grand Total all add up).
+ *
+ * No-ops unless all of the following hold: the host is BigCommerce, the shopper
+ * is on the cart page, they are in a shipping zone with Hello shown, and the
+ * active checkout actually has a consignment. Because the reload happens only
+ * when a consignment is found and removed, the freshly-loaded page has none —
+ * so this cannot loop.
+ */
+export const removeBigcommerceCartShipping = async () => {
+    var _a, _b;
+    if (typeof window === 'undefined' || !((_a = window.Zonos) === null || _a === void 0 ? void 0 : _a.isBigCommerce)) {
+        return;
+    }
+    // Only on the cart page and only when Hello is shown — elsewhere there is no
+    // Grand Total to correct. Gate on Hello visibility (not raw shipping-zone
+    // membership) so include/exclude country overrides are respected.
+    if (window.location.pathname !== '/cart.php' ||
+        !localizationStore.isShippableCountry ||
+        !shouldShowHelloWidget(false)) {
+        return;
+    }
+    if (isRemoving) {
+        return;
+    }
+    isRemoving = true;
+    try {
+        const checkoutId = await fetchCheckoutId();
+        if (!checkoutId) {
+            return;
+        }
+        const checkout = await fetchBigCommerceCheckout(checkoutId);
+        const consignmentIds = ((_b = checkout === null || checkout === void 0 ? void 0 : checkout.consignments) !== null && _b !== void 0 ? _b : [])
+            .map(consignment => consignment.id)
+            .filter((id) => !!id);
+        // Nothing to do if there is no domestic shipping quote on the cart.
+        if (!consignmentIds.length) {
+            return;
+        }
+        log(`Removing ${String(consignmentIds.length)} BigCommerce cart consignment(s) for international shopper`, 'info');
+        // `deleteBigCommerceConsignment` resolves to null on failure (it swallows
+        // the error and logs it), so a non-null result means that consignment was
+        // actually removed.
+        const deleteResults = await Promise.all(consignmentIds.map(consignmentId => deleteBigCommerceConsignment(checkoutId, consignmentId)));
+        const removedCount = deleteResults.filter(Boolean).length;
+        // Only reload when at least one consignment was actually removed. If every
+        // DELETE failed, reloading would re-run this on init with the same
+        // consignments still present and trap the shopper in a reload loop.
+        if (!removedCount) {
+            log('No BigCommerce cart consignments were removed; skipping reload to avoid a reload loop', 'warn');
+            return;
+        }
+        // Reload so the server re-renders the cart consistently without the removed
+        // shipping, instead of surgically patching the DOM total.
+        window.location.reload();
+    }
+    catch (error) {
+        logError('Error removing BigCommerce cart shipping consignment', error);
+    }
+    finally {
+        isRemoving = false;
+    }
+};

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

@@ -0,0 +1,61 @@
+import { localizationStore } from "../../store/hello/localization";
+import { zonosStore } from "../../store/zonosStore";
+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.
+ */
+export const shouldShowHelloWidget = (showLog = true) => {
+    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;
+    // 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) {
+        log(`Hello: not shippable country - Show for countries: ${behavior}`);
+    }
+    // Legacy: explicit list of country codes from deprecated showForCountries
+    if (Array.isArray(behavior)) {
+        return !!selectedCountry && behavior.includes(selectedCountry);
+    }
+    // Determine base visibility from behavior
+    let isVisible;
+    if (behavior === 'ALL') {
+        isVisible = true;
+    }
+    else {
+        // Default: ONLY_SHIPPABLE
+        isVisible = localizationStore.isShippableCountry;
+    }
+    // Apply includedCountries — force show the widget for these countries
+    if (!isVisible &&
+        selectedCountry &&
+        ((_a = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.includedCountries) === null || _a === void 0 ? void 0 : _a.includes(selectedCountry))) {
+        isVisible = true;
+    }
+    // Apply excludedCountries — force hide the widget for these countries
+    if (isVisible &&
+        selectedCountry &&
+        ((_b = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.excludedCountries) === null || _b === void 0 ? void 0 : _b.includes(selectedCountry))) {
+        isVisible = false;
+    }
+    return isVisible;
+};