@zonos/elements 1.3.261 → 1.3.262

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.261.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.261.js.zonos.com";
-const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.261";
-const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.261";
-const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.261";
+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 = "1777476611591";
+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.261"}`;
+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', {

package/dist/esm/{paypal-38ca5d21.js → paypal-d8804da5.js}

@@ -1,10 +1,10 @@
-import { c as createStore, z as zonosStore } from './zonosStore-f1d45eac.js';
+import { z as zonosStore, c as createStore } from './zonosStore-f1d45eac.js';
 import { t as trackConversionEvent, y as validateCheckoutSession, b as stripeStore, d as cartStore, v as stripeStoreHandleInventoryCheck, w as storeCreditStoreApplyCredit, x as storeCreditStoreCoversFullAmount, z as storeCreditStoreCreateOrder, r as cartStoreNextStep, h as cartStoreClearCheckoutInterval, F as storeCreditStoreGetEffectiveAmount } from './cart-c490d252.js';
 import { t as translate, s as storageStore } from './localization-542dbe20.js';
-import { h as handleFetch, l as logError, j as jsonParse } from './handleFetch-a844cac1.js';
+import { h as handleFetch, g as getIsTestMode, l as logError, j as jsonParse } from './handleFetch-a844cac1.js';
 import { i as isContrastColor } from './isContrastColor-f9e65e70.js';
 import { l as log } from './VarianceTest-572cecf5.js';
-import { s as submitGtag } from './submitGtag-543058f9.js';
+import { i as isAnalyticsRelayInIframe, e as enqueueRelayEvent, s as submitGtag } from './submitGtag-7f5c5bb5.js';
 
 /*!
  * paypal-js v8.4.2 (2025-09-04T17:21:30.135Z)
@@ -39,7 +39,7 @@ PERFORMANCE OF THIS SOFTWARE.
 /* global Reflect, Promise, SuppressedError, Symbol */
 
 
-function __rest(s, e) {
+function __rest$1(s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
         t[p] = s[p];
@@ -86,7 +86,7 @@ function insertScriptElement(_a) {
     document.head.insertBefore(newScript, document.head.firstElementChild);
 }
 function processOptions(_a) {
-    var customSdkBaseUrl = _a.sdkBaseUrl, environment = _a.environment, options = __rest(_a, ["sdkBaseUrl", "environment"]);
+    var customSdkBaseUrl = _a.sdkBaseUrl, environment = _a.environment, options = __rest$1(_a, ["sdkBaseUrl", "environment"]);
     var sdkBaseUrl = customSdkBaseUrl || processSdkBaseUrl(environment);
     var optionsWithStringIndex = options;
     var _b = Object.keys(optionsWithStringIndex)
@@ -256,6 +256,139 @@ const paypalCreateOrder = async ({ checkoutSessionId, intent, }) => {
     return { errors, json };
 };
 
+var __rest = (undefined && undefined.__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',
+};
+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.
+ */
+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;
+};
+
+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
+ */
+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);
+    }
+};
+
+/**
+ * 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.
+ */
+const submitAnalytics = (input) => {
+    submitGtag(input);
+    submitFbq(input);
+};
+
 const { onChange: paypalStoreOnChange, reset: paypalStoreReset, state: paypalStore, } = createStore(() => ({
     intent: 'capture',
     orderIdCreated: null,
@@ -336,7 +469,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,
@@ -401,7 +534,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,
@@ -417,7 +550,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,
@@ -538,4 +671,4 @@ const paypalStoreHasPaypalEnabled = () => {
     return paypalEnabledInSetting || !!paypalStore.paypalButtons.length;
 };
 
-export { paypalStore as a, paypalInitScript as b, paypalStoreReset as c, paypalStoreInitButtons as d, paypalStoreOnChange as e, paypalStoreHasPaypalEnabled as p };
+export { paypalStore as a, paypalInitScript as b, paypalStoreReset as c, paypalStoreInitButtons as d, paypalStoreOnChange as e, paypalStoreHasPaypalEnabled as p, submitAnalytics as s };