@zonos/elements 1.3.260 → 1.3.262

package/dist/collection/components/store/checkout/paypal.js

@@ -13,7 +13,7 @@ import { isContrastColor } from "../../utils/isContrastColor";
 import { jsonParse } from "../../utils/jsonParse";
 import { log } from "../../utils/logging/log";
 import { logError } from "../../utils/logging/logError";
-import { submitGtag } from "../../utils/submitGtag";
+import { submitAnalytics } from "../../utils/submitAnalytics";
 import { validateCheckoutSession } from "../../utils/validateCheckoutSession";
 const { onChange: paypalStoreOnChange, reset: paypalStoreReset, state: paypalStore, } = createStore(() => ({
     intent: 'capture',
@@ -95,7 +95,7 @@ const paypalButtonOptions = ({ checkoutSessionId, onPaypalFail, onPaypalSessionD
                 // reset stripe error message
                 stripeStore.hasPaymentError = false;
                 stripeStore.customErrorMessage = null;
-                submitGtag({
+                submitAnalytics({
                     event: 'zonos-checkout-payment-fail',
                     metadata: {
                         checkoutSessionId,
@@ -160,7 +160,7 @@ const paypalButtonOptions = ({ checkoutSessionId, onPaypalFail, onPaypalSessionD
                 // reset stripe error message
                 stripeStore.hasPaymentError = false;
                 stripeStore.customErrorMessage = null;
-                submitGtag({
+                submitAnalytics({
                     event: 'zonos-checkout-payment-fail',
                     metadata: {
                         checkoutSessionId,
@@ -176,7 +176,7 @@ const paypalButtonOptions = ({ checkoutSessionId, onPaypalFail, onPaypalSessionD
                 // reset paypal error banner
                 paypalStore.paypalErrorMessage = null;
                 // submit google tag when the form is complete
-                submitGtag({
+                submitAnalytics({
                     event: 'zonos-checkout-payment-info',
                     metadata: {
                         checkoutSessionId,

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

@@ -352,11 +352,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: '5dc571d7c5e706ae9cb90de70deee22847e5ba7e', class: classes([
+        return (h(Host, { key: '300434f0623d886693dc101b47cb5cd5f9503d3e', class: classes([
                 'zonos--address',
                 'zonos--elements',
                 `zonos--${this.type}-address`,
-            ]) }, this.titleText && (h("zonos-text", { key: 'a7c9f730bc9b64aa2c6e8cc24701e638481eac19', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("slot", { key: '3078529c201c7947ffc833485d46184bc79ab1d1', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), h("div", { key: 'b4a9850ac30ad9c483e05743ff41b7de9756d826', class: "zonos--address-component" })));
+            ]) }, this.titleText && (h("zonos-text", { key: 'eb7592c563d728af019db397f4d5e7e9f448f4d7', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("slot", { key: 'c9556ead2ad1bf1b462637ae44834dc4f25afa8a', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), h("div", { key: 'cecaa1a9b4a176607125106f55b6e4d6cab31705', 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

@@ -78,9 +78,9 @@ export class ZonosAddressSuggestions {
         return segments;
     }
     render() {
-        return (h(Host, { key: '00686fe9c09bb764f18548ea438f9fa39deb5413', class: "zonos--address-suggestions", role: "group", style: {
+        return (h(Host, { key: 'fe92e3ac70b644dbacda2cfc56e2676ac34632cc', class: "zonos--address-suggestions", role: "group", style: {
                 '--zonos--border-radius': getBorderRadius(),
-            } }, h("ul", { key: '89c0f50ea5bbabdf3efe3e58bd4d7a7c96f33b47', "aria-label": "Suggestions", class: "wrapper", role: "listbox" }, !!this.localSuggestions.length && (h("li", { key: 'ad3286076569701e1318c93b7ebc674ad85a7ae6', "aria-selected": false, class: "powered-by option", role: "option" }, h("div", { key: 'bdcb8cc865eb77b3a0189c8d88a7698d405c332e', class: "powered-by-container" }, h("zonos-text", { key: '1db905ec989aef0f8dd30835657d1dd1b1836fc2', type: "caption" }, "Suggestions powered by"), h("zonos-text", { key: '55c36840f1bb850ce135bd238d01b9a3055463d7', type: "semiBoldLabel" }, "Google")), h("zonos-button", { key: 'e89402e39549482c41b046fb534e727690e43100', "aria-label": "Clear suggestions", icon: h("zonos-icon", { content: RemoveIcon }), noBackground: true, onClick: () => {
+            } }, h("ul", { key: 'c042e5d4f563ace9631f3a9d4ad3dd3c9e12cc35', "aria-label": "Suggestions", class: "wrapper", role: "listbox" }, !!this.localSuggestions.length && (h("li", { key: 'b68deb87d190d53b597085f7503c838e0a089227', "aria-selected": false, class: "powered-by option", role: "option" }, h("div", { key: '4dac7702de58610364ad031a181c33d135ec2b1f', class: "powered-by-container" }, h("zonos-text", { key: '74e97d754914267d43e39740ea48634ddcb87355', type: "caption" }, "Suggestions powered by"), h("zonos-text", { key: 'f2771fd3f18665eb414b653740930afe1bb42e4e', type: "semiBoldLabel" }, "Google")), h("zonos-button", { key: '657f036bec0ad31091b83be9927036362f6607a6', "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

@@ -924,10 +924,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: '4a2a2bb06e16eb0470b827efd104c1a7a373e2b5', class: classes([
+        return (h(Host, { key: '4874639006b452cc6a2b5e5beabbe97fe7a0fde5', class: classes([
                 'zonos--address zonos--elements',
                 `zonos--${this.type}-address`,
-            ]) }, h("zonos-text", { key: '74fd51761c8672e23ada3c5f1bac121cdf559ca6', class: "zonos--title", type: "semiBoldLabel" }, this.titleText), h("slot", { key: 'e21b18b079f013e1bdaf2ab526c1c7826f2376f0', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), this.renderCustomAddressForm()));
+            ]) }, h("zonos-text", { key: 'a365f9de88a9f7602e46e1d87aa180d2b51a4079', class: "zonos--title", type: "semiBoldLabel" }, this.titleText), h("slot", { key: '66146ab6e78cfce499a10aa4d117a64a49a7f886', 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-payment/zonos-payment.js

@@ -67,7 +67,7 @@ export class ZonosPayment {
     }
     render() {
         // this component loads iframe from the stripe elements and puts here, so we don't need to do anything here
-        return (h(Host, { key: '1fb61e01184d3a0b2dc079ae468e96175d9f6518', class: "zonos--payment zonos--elements" }, this.titleText && (h("zonos-text", { key: '3860ff7fc2656ff045ce09c0de2e14aa7a22e194', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("div", { key: '3cabad9c095f2eeba8cfc464374ca9abfc2af5ee', class: "zonos--payment-component" }), h("div", { key: '9e2b13a0d8131a5513f99e2a6436ca3c5f03d7cf', class: "zonos--payment-paypal-container" })));
+        return (h(Host, { key: 'd6aba7a614610a64012ef6636e19b345623141ec', class: "zonos--payment zonos--elements" }, this.titleText && (h("zonos-text", { key: 'edf8c9ee8d7a9ebf87922a49d9b7420efd80b226', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("div", { key: '3d0d7638a309fdf4dc1ab39bb463a0c35add911d', class: "zonos--payment-component" }), h("div", { key: 'a79f98f63bad2a7c5023eeb5bb28ae39997ada27', class: "zonos--payment-paypal-container" })));
     }
     static get is() { return "zonos-payment"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/utils/analytics/analyticsRelayState.js

@@ -0,0 +1,112 @@
+import { RELAY_PING_TYPE, RELAY_READY_TYPE, ZONOS_ANALYTIC_TYPE, } from "../../../types/analyticsRelay";
+const providerReady = {
+    fbq: false,
+    gtag: false,
+};
+const queue = [];
+let listenerAdded = false;
+const isInIframe = () => typeof window !== 'undefined' && window.parent !== window;
+const flushQueue = () => {
+    // Walk a copy and rebuild to keep events whose provider isn't ready yet
+    const remaining = [];
+    while (queue.length > 0) {
+        const event = queue.shift();
+        if (!providerReady[event.provider]) {
+            remaining.push(event);
+            continue;
+        }
+        try {
+            window.parent.postMessage({
+                event: event.event,
+                fbqMode: event.fbqMode,
+                metadata: event.payload,
+                provider: event.provider,
+                type: ZONOS_ANALYTIC_TYPE,
+            }, '*');
+        }
+        catch (_a) {
+            // Ignore postMessage failures
+        }
+    }
+    queue.push(...remaining);
+};
+const ensureListener = () => {
+    if (listenerAdded)
+        return;
+    listenerAdded = true;
+    window.addEventListener('message', (e) => {
+        var _a;
+        if (((_a = e.data) === null || _a === void 0 ? void 0 : _a.type) !== RELAY_READY_TYPE)
+            return;
+        // Older parent scripts may omit `provider`; treat as gtag for backward compatibility.
+        const provider = e.data.provider || 'gtag';
+        providerReady[provider] = true;
+        if (typeof window.Zonos !== 'undefined') {
+            if (provider === 'gtag') {
+                window.Zonos.googleAnalyticReady = true;
+            }
+            else {
+                window.Zonos.facebookPixelReady = true;
+            }
+        }
+        flushQueue();
+    });
+};
+/**
+ * Send a ping to the parent so it can inject/configure analytics relays for the providers we care about.
+ * Picks up `googleAnalyticId` and `facebookPixelId` from `window.Zonos`, both of which may be set by `customHTML`.
+ */
+export const sendRelayPing = () => {
+    if (!isInIframe())
+        return;
+    ensureListener();
+    try {
+        const z = typeof window.Zonos !== 'undefined' ? window.Zonos : undefined;
+        window.parent.postMessage({
+            facebookPixelId: z === null || z === void 0 ? void 0 : z.facebookPixelId,
+            googleAnalyticId: z === null || z === void 0 ? void 0 : z.googleAnalyticId,
+            type: RELAY_PING_TYPE,
+        }, '*');
+    }
+    catch (_a) {
+        // Ignore postMessage failures
+    }
+};
+/**
+ * Sends ping to parent so it can inject/configure analytics relays and respond with ready.
+ * Call after customHTML or custom script sets `window.Zonos.googleAnalyticId` / `window.Zonos.facebookPixelId`.
+ */
+export const ensureAnalyticsRelayPing = () => {
+    if (!isInIframe())
+        return;
+    // If both providers are already ready, no need to ping again
+    if (providerReady.gtag && providerReady.fbq)
+        return;
+    sendRelayPing();
+};
+/**
+ * Queue an analytic event for relay to parent. If the provider's relay is already ready,
+ * the event is forwarded immediately; otherwise it waits for the ready signal.
+ */
+export const enqueueRelayEvent = (event) => {
+    ensureListener();
+    if (providerReady[event.provider]) {
+        try {
+            window.parent.postMessage({
+                event: event.event,
+                fbqMode: event.fbqMode,
+                metadata: event.payload,
+                provider: event.provider,
+                type: ZONOS_ANALYTIC_TYPE,
+            }, '*');
+        }
+        catch (_a) {
+            // Ignore postMessage failures
+        }
+        return;
+    }
+    queue.push(event);
+    // Re-ping in case the parent hasn't received the ID yet (e.g. customHTML set it after init)
+    sendRelayPing();
+};
+export const isAnalyticsRelayInIframe = isInIframe;

package/dist/collection/components/utils/analytics/mapToFbEvent.js

@@ -0,0 +1,66 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s)
+        if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+            t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+/**
+ * Mapping from our internal event names (GA-style) to Facebook Pixel standard event names.
+ * @see https://developers.facebook.com/docs/meta-pixel/reference#standard-events
+ *
+ * Events without an entry have no FB standard equivalent — they are still fired as a custom event
+ * via `fbq('trackCustom', ...)` so merchants can target them.
+ */
+const FB_STANDARD_EVENT_BY_INTERNAL_EVENT = {
+    purchase: 'Purchase',
+    'zonos-checkout-payment-info': 'AddPaymentInfo',
+    'zonos-checkout-start': 'InitiateCheckout',
+};
+export const getFbStandardEventName = (event) => { var _a; return (_a = FB_STANDARD_EVENT_BY_INTERNAL_EVENT[event]) !== null && _a !== void 0 ? _a : null; };
+const isPurchaseMetadata = (metadata) => {
+    if (!metadata)
+        return false;
+    return Array.isArray(metadata.items);
+};
+/**
+ * Convert a GA-style event payload into a Facebook Pixel parameter object.
+ *
+ * GA `items: [{ item_id, item_name, price, quantity }]` is converted into FB's
+ * `contents: [{ id, quantity, item_price }]` with derived `content_ids`, `num_items`,
+ * and `content_type: 'product'`. Other primitive params (e.g. `checkoutSessionId`,
+ * `paymentMethod`, `serviceLevelId`) are forwarded as-is so merchants can build
+ * custom audiences on them.
+ */
+export const buildFbqParams = (metadata) => {
+    if (!metadata)
+        return {};
+    if (!isPurchaseMetadata(metadata)) {
+        // Forward primitive metadata as-is for custom events
+        return Object.assign({}, metadata);
+    }
+    const { currency, items, transaction_id, value } = metadata, rest = __rest(metadata, ["currency", "items", "transaction_id", "value"]);
+    const contents = items.map(item => ({
+        id: item.item_id,
+        item_price: item.price,
+        quantity: item.quantity,
+    }));
+    const contentIds = items.map(item => item.item_id);
+    const numItems = items.reduce((acc, item) => acc + item.quantity, 0);
+    const params = Object.assign(Object.assign({}, rest), { content_ids: contentIds, content_type: 'product', contents, num_items: numItems });
+    if (transaction_id) {
+        params.order_id = transaction_id;
+    }
+    if (currency !== undefined) {
+        params.currency = currency;
+    }
+    if (value !== undefined) {
+        params.value = value;
+    }
+    return params;
+};

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

@@ -0,0 +1,16 @@
+import { submitFbq } from "./submitFbq";
+import { submitGtag, } from "./submitGtag";
+/**
+ * Fan out an analytics event to every enabled provider.
+ *
+ * - Calls `submitGtag` (Google Analytics) — always sends the original event name.
+ * - Calls `submitFbq` (Facebook Pixel) — sends the original event name as a custom event,
+ *   and additionally fires the matching FB standard event when one exists
+ *   (e.g. `purchase` → `Purchase`, `zonos-checkout-start` → `InitiateCheckout`).
+ *
+ * Each submitter no-ops when its provider is disabled in `analyticsProviders` settings.
+ */
+export const submitAnalytics = (input) => {
+    submitGtag(input);
+    submitFbq(input);
+};

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

@@ -0,0 +1,56 @@
+import { zonosStore } from "../store/zonosStore";
+import { enqueueRelayEvent, isAnalyticsRelayInIframe, } from "./analytics/analyticsRelayState";
+import { buildFbqParams, getFbStandardEventName, } from "./analytics/mapToFbEvent";
+import { getIsTestMode } from "./checkout/getIsTestMode";
+import { log } from "./logging/log";
+const isFacebookPixelEnabled = () => {
+    const provider = zonosStore.checkoutSettings.analyticsProviders.find(item => item.type === 'FACEBOOK_PIXEL');
+    return !!provider && provider.status === 'ENABLED';
+};
+const fireFbq = (mode, event, params) => {
+    if (isAnalyticsRelayInIframe()) {
+        // fbq does not work in the iframe (Facebook Pixel must be on the parent for proper attribution).
+        // Relay to parent which will call fbq() once the FB Pixel script is ready.
+        enqueueRelayEvent({
+            event,
+            fbqMode: mode,
+            payload: params,
+            provider: 'fbq',
+        });
+        return;
+    }
+    if (typeof window.fbq === 'function') {
+        log('Zonos submits fbq event', 'log', `${mode}:${event}`);
+        window.fbq(mode, event, params);
+    }
+};
+/**
+ * Submit a Facebook Pixel event matching the gtag event payload shape.
+ *
+ * Behavior:
+ * - Always fires `fbq('trackCustom', event, params)` so merchants see `zonos-xxx` events.
+ * - If the event has a Facebook standard equivalent (e.g. `purchase` → `Purchase`,
+ *   `zonos-checkout-start` → `InitiateCheckout`, `zonos-checkout-payment-info` →
+ *   `AddPaymentInfo`), additionally fires `fbq('track', standardEvent, params)` with
+ *   FB-formatted parameters.
+ *
+ * @see https://developers.facebook.com/docs/meta-pixel/reference
+ */
+export const submitFbq = ({ event, metadata }) => {
+    if (!isFacebookPixelEnabled()) {
+        return;
+    }
+    const isTestMode = getIsTestMode();
+    const baseParams = buildFbqParams(metadata);
+    const params = Object.assign(Object.assign({}, baseParams), (isTestMode && { isTestMode: true }));
+    // filter null values
+    const filteredParams = Object.fromEntries(Object.entries(params).filter(([_, value]) => value !== null));
+    // 1) Always emit the original event as a custom event so merchants can target zonos-xxx names.
+    fireFbq('trackCustom', event, filteredParams);
+    // 2) Emit FB standard equivalent if one exists. Skipped when the event itself is the standard
+    //    name to avoid double-firing (e.g. 'purchase' -> 'Purchase').
+    const fbStandardEvent = getFbStandardEventName(event);
+    if (fbStandardEvent && fbStandardEvent !== event) {
+        fireFbq('track', fbStandardEvent, filteredParams);
+    }
+};

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

@@ -1,99 +1,36 @@
 import { zonosStore } from "../store/zonosStore";
+import { enqueueRelayEvent, ensureAnalyticsRelayPing as ensureAnalyticsRelayPingShared, isAnalyticsRelayInIframe, } from "./analytics/analyticsRelayState";
 import { getIsTestMode } from "./checkout/getIsTestMode";
 import { log } from "./logging/log";
-import { RELAY_PING_TYPE, RELAY_READY_TYPE, ZONOS_ANALYTIC_TYPE, } from "../../types/analyticsRelay";
-let parentGtagReady = false;
-let relayListenerAdded = false;
-const queuedEvents = [];
-function flushQueuedEvents() {
-    while (queuedEvents.length > 0) {
-        const { event, payload } = queuedEvents.shift();
-        try {
-            window.parent.postMessage({
-                event,
-                metadata: payload,
-                type: ZONOS_ANALYTIC_TYPE,
-            }, '*');
-        }
-        catch (_a) {
-            // Ignore postMessage failures
-        }
-    }
-}
-function ensureRelayListener() {
-    if (relayListenerAdded)
-        return;
-    relayListenerAdded = true;
-    window.addEventListener('message', (e) => {
-        var _a;
-        if (((_a = e.data) === null || _a === void 0 ? void 0 : _a.type) === RELAY_READY_TYPE) {
-            parentGtagReady = true;
-            if (typeof window.Zonos !== 'undefined') {
-                window.Zonos.googleAnalyticReady = true;
-            }
-            flushQueuedEvents();
-        }
-    });
-}
-function sendPingToParent() {
-    try {
-        const googleAnalyticId = typeof window.Zonos !== 'undefined'
-            ? window.Zonos.googleAnalyticId
-            : undefined;
-        window.parent.postMessage({ googleAnalyticId, type: RELAY_PING_TYPE }, '*');
-    }
-    catch (_a) {
-        // Ignore postMessage failures
-    }
-}
 /**
- * Sends ping to parent with googleAnalyticId so parent can inject/configure GA and respond with ready.
- * Call after customHTML or custom script sets window.Zonos.googleAnalyticId.
+ * Re-export of the shared relay ping helper. Kept here for backward compatibility with
+ * existing import paths (e.g. `zonos-controller`).
  */
-export function ensureAnalyticsRelayPing() {
-    if (typeof window === 'undefined' ||
-        window.parent === window ||
-        parentGtagReady) {
-        return;
-    }
-    ensureRelayListener();
-    sendPingToParent();
-}
+export const ensureAnalyticsRelayPing = ensureAnalyticsRelayPingShared;
+const isGoogleAnalyticsEnabled = () => {
+    const provider = zonosStore.checkoutSettings.analyticsProviders.find(item => item.type === 'GOOGLE_ANALYTICS');
+    return !!provider && provider.status === 'ENABLED';
+};
 /**
  * Submit a gtag event if the gtag function is available.
  * When running inside an iframe, only posts to parent after the parent has
  * confirmed (via analyticsRelayOnInit) that gtag is available.
  */
 export const submitGtag = ({ event, metadata }) => {
-    const googleAnalyticSetting = zonosStore.checkoutSettings.analyticsProviders.find(item => item.type === 'GOOGLE_ANALYTICS');
-    // only submit if googleAnalytic in checkout setting is on.
-    if (!googleAnalyticSetting || (googleAnalyticSetting === null || googleAnalyticSetting === void 0 ? void 0 : googleAnalyticSetting.status) === 'DISABLED') {
+    if (!isGoogleAnalyticsEnabled()) {
         return;
     }
     const isTestMode = getIsTestMode();
     const payload = Object.assign(Object.assign({}, metadata), (isTestMode && { isTestMode: true }));
     // filter null key
     const filteredPayload = Object.fromEntries(Object.entries(payload).filter(([_, value]) => value !== null));
-    const isInIframe = typeof window !== 'undefined' && window.parent !== window;
-    if (isInIframe) {
+    if (isAnalyticsRelayInIframe()) {
         // gtag does not work in iframe; must relay to parent via postMessage
-        ensureRelayListener();
-        if (parentGtagReady) {
-            try {
-                window.parent.postMessage({
-                    event,
-                    metadata: filteredPayload,
-                    type: ZONOS_ANALYTIC_TYPE,
-                }, '*');
-            }
-            catch (_a) {
-                // Ignore postMessage failures
-            }
-        }
-        else {
-            queuedEvents.push({ event, payload: filteredPayload });
-            sendPingToParent();
-        }
+        enqueueRelayEvent({
+            event,
+            payload: filteredPayload,
+            provider: 'gtag',
+        });
         return;
     }
     // Not in iframe: call gtag directly

package/dist/collection/scripts/_zonosBase.js

@@ -53,6 +53,8 @@ Zonos.releaseDate = process.env.NEXT_PUBLIC_RELEASE_DATE;
 Zonos.isLegacyCheckout = false;
 Zonos.googleAnalyticId = null;
 Zonos.googleAnalyticReady = false;
+Zonos.facebookPixelId = null;
+Zonos.facebookPixelReady = false;
 Zonos.startLoadTime = startLoadTime;
 Zonos.domain = typeof window !== 'undefined'
     ? // domain that embeds the iframe
@@ -92,9 +94,10 @@ Zonos.init = async (params) => {
     log(`====== ZONOS DEBUG MODE: on (${_a.version}) ======`);
     _a.zonosApiKey = zonosApiKey;
     _a.storeId = storeId;
-    // When not in iframe, GA is ready (gtag works directly). When in iframe, relay will set this after parent configures.
+    // When not in iframe, providers are ready (gtag/fbq work directly). When in iframe, relay sets these after parent configures.
     if (typeof window !== 'undefined' && window.parent === window) {
         _a.googleAnalyticReady = true;
+        _a.facebookPixelReady = true;
     }
     if (_a.isNpm) {
         log('====== ZONOS LOADING FROM NPM ======');
@@ -200,7 +203,7 @@ Zonos.injectCustomScriptForHostedCheckout = () => {
     const metadata = (cartData === null || cartData === void 0 ? void 0 : cartData.metadata) || [];
     const headerScript = metadata.find(meta => meta.key === 'customHeaderScript');
     const footerScript = metadata.find(meta => meta.key === 'customFooterScript');
-    // googleAnalyticId is set by customHTML in checkoutSettings (e.g. <script>window.Zonos.googleAnalyticId = "G-XXX";</script>), injected by zonos-controller
+    // googleAnalyticId / facebookPixelId are set by customHTML in checkoutSettings (e.g. <script>window.Zonos.googleAnalyticId = "G-XXX"; window.Zonos.facebookPixelId = "1234567890";</script>), injected by zonos-controller
     // Only inject the script if checkout is on Zonos hosted checkout and custom script is available
     if (!window.Zonos.isLegacyCheckout || (!headerScript && !footerScript)) {
         log('Skip injecting custom script for hosted checkout', 'info', {

package/dist/collection/types/analyticsRelay.js

@@ -1,6 +1,6 @@
 /** Message type for zonos-analytic events sent from iframe to parent. */
 export const ZONOS_ANALYTIC_TYPE = 'zonos-analytic';
-/** Ping sent by iframe to configure parent's analytics relay (e.g. GA) and get ready signal. */
+/** Ping sent by iframe to configure parent's analytics relay (e.g. GA, FB Pixel) and get ready signal. */
 export const RELAY_PING_TYPE = 'zonos-analytics-relay-ping';
-/** Response from parent when analytics relay (e.g. gtag) is ready. */
+/** Response from parent when an analytics relay (e.g. gtag, fbq) is ready. */
 export const RELAY_READY_TYPE = 'zonos-analytics-relay-ready';

package/dist/esm/index.js

@@ -131,7 +131,7 @@ const getZonosQaUrl = () => {
         return null;
     }
     const qaUrl = extractZonosQaUrl(window.location.href);
-    const cdnUrl = "https://v1.3.260.js.zonos.com";
+    const cdnUrl = "https://v1.3.262.js.zonos.com";
     // when the qaUrl is not set and the built URL is from the test domain, use the test domain for testing
     if (!qaUrl &&
         (cdnUrl.includes('test.') ||
@@ -379,10 +379,10 @@ const zonosLoadUrl = (() => {
     return null;
 })();
 const startLoadTime = Date.now();
-const ZONOS_URL = "https://v1.3.260.js.zonos.com";
-const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.260";
-const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.260";
-const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.260";
+const ZONOS_URL = "https://v1.3.262.js.zonos.com";
+const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.262";
+const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.262";
+const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.262";
 const GOOGLE_FONT_URL = 'https://fonts.googleapis.com';
 const GOOGLE_FONT_REGEX = /^https:\/\/fonts\.googleapis\.com/;
 class Zonos {
@@ -400,10 +400,12 @@ Zonos.iframeLogType = typeof window !== 'undefined'
     ? new URLSearchParams(window.location.search).get('iframeLogType')
     : null;
 Zonos.isBigCommerce = false;
-Zonos.releaseDate = "1776892835210";
+Zonos.releaseDate = "1777585626922";
 Zonos.isLegacyCheckout = false;
 Zonos.googleAnalyticId = null;
 Zonos.googleAnalyticReady = false;
+Zonos.facebookPixelId = null;
+Zonos.facebookPixelReady = false;
 Zonos.startLoadTime = startLoadTime;
 Zonos.domain = typeof window !== 'undefined'
     ? // domain that embeds the iframe
@@ -423,7 +425,7 @@ Zonos.isNpm = true;
 Zonos.zonosQaUrl = null;
 Zonos.zonosQaUrlApi = null;
 Zonos.trackEventLogs = [];
-Zonos.version = `v${"1.3.260"}`;
+Zonos.version = `v${"1.3.262"}`;
 Zonos.modeAlerted = false;
 Zonos.cartData = null;
 Zonos.paypal = null;
@@ -443,9 +445,10 @@ Zonos.init = async (params) => {
     log(`====== ZONOS DEBUG MODE: on (${_a.version}) ======`);
     _a.zonosApiKey = zonosApiKey;
     _a.storeId = storeId;
-    // When not in iframe, GA is ready (gtag works directly). When in iframe, relay will set this after parent configures.
+    // When not in iframe, providers are ready (gtag/fbq work directly). When in iframe, relay sets these after parent configures.
     if (typeof window !== 'undefined' && window.parent === window) {
         _a.googleAnalyticReady = true;
+        _a.facebookPixelReady = true;
     }
     if (_a.isNpm) {
         log('====== ZONOS LOADING FROM NPM ======');
@@ -551,7 +554,7 @@ Zonos.injectCustomScriptForHostedCheckout = () => {
     const metadata = (cartData === null || cartData === void 0 ? void 0 : cartData.metadata) || [];
     const headerScript = metadata.find(meta => meta.key === 'customHeaderScript');
     const footerScript = metadata.find(meta => meta.key === 'customFooterScript');
-    // googleAnalyticId is set by customHTML in checkoutSettings (e.g. <script>window.Zonos.googleAnalyticId = "G-XXX";</script>), injected by zonos-controller
+    // googleAnalyticId / facebookPixelId are set by customHTML in checkoutSettings (e.g. <script>window.Zonos.googleAnalyticId = "G-XXX"; window.Zonos.facebookPixelId = "1234567890";</script>), injected by zonos-controller
     // Only inject the script if checkout is on Zonos hosted checkout and custom script is available
     if (!window.Zonos.isLegacyCheckout || (!headerScript && !footerScript)) {
         log('Skip injecting custom script for hosted checkout', 'info', {