@chordcommerce/analytics 1.22.0-beta.1 → 1.22.0-beta.2

package/README.md

@@ -181,13 +181,19 @@ The release flow:
 4. If releasable commits exist, the package is published to npm and GitHub Packages, CHANGELOG.md is updated, and a Git tag is created.
 5. If no releasable commits exist, `semantic-release` exits cleanly and nothing is published.
 
+### PR titles must follow conventional commits
+
+When using GitHub's **squash merge** (the default), the PR title becomes the first line of the squash commit message. Semantic-release only parses the **first line** to determine the version bump, so **the PR title must use a conventional commit prefix** (e.g., `fix: resolve consent race condition`). Individual commit messages in the PR body are ignored.
+
+If the PR title does not start with a releasable prefix, no release will be published even if the individual commits within the PR use `fix:` or `feat:`.
+
 ### When a release happens (and when it doesn't)
 
 A release is published **only** when all three conditions are met:
 
 1. A push lands on `main` or `beta` (via merged PR or direct push)
 2. Tests pass
-3. There are new commits since the last release tag with a releasable prefix
+3. There are new commits since the last release tag with a releasable prefix (checked against the **first line** of each commit message)
 
 **Releasable commit prefixes** (these trigger a version bump):
 

package/dist/cjs/client/cdp.js

@@ -80,15 +80,9 @@ var addCdpSnippet = function (options) { return __awaiter(void 0, void 0, void 0
                 _a.sent();
                 initialConsent = null;
                 if (!options.consent) return [3 /*break*/, 3];
-                if (options.debug && options.enableLogging) {
-                    console.log('[Chord Analytics DEBUG]: Setting up consent management');
-                }
                 return [4 /*yield*/, (0, index_js_1.addCdpConsent)(options).init()];
             case 2:
                 initialConsent = _a.sent();
-                if (options.debug && options.enableLogging) {
-                    console.log('[Chord Analytics DEBUG]: Consent management setup complete');
-                }
                 _a.label = 3;
             case 3:
                 if (options.debug && options.enableLogging) {

package/dist/cjs/client/consent/index.js

@@ -152,7 +152,7 @@ var addCdpConsent = function (options) {
      * or null if consent setup failed or was blocked.
      */
     var init = function () { return __awaiter(void 0, void 0, void 0, function () {
-        var canBeTracked, result, error_1;
+        var canBeTracked, error_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -180,17 +180,10 @@ var addCdpConsent = function (options) {
                 case 2:
                     _a.trys.push([2, 4, , 5]);
                     return [4 /*yield*/, setupConsentManagement()];
-                case 3:
-                    result = _a.sent();
-                    if (options.debug && options.enableLogging) {
-                        console.log('[Chord Analytics DEBUG]: setupConsentManagement() returned:', JSON.stringify(result));
-                    }
-                    return [2 /*return*/, result];
+                case 3: return [2 /*return*/, _a.sent()];
                 case 4:
                     error_1 = _a.sent();
-                    if (options.debug && options.enableLogging) {
-                        console.error('[Chord Analytics DEBUG]: Error setting up consent management:', error_1);
-                    }
+                    console.error('Error setting up consent management:', error_1);
                     return [2 /*return*/, null];
                 case 5: return [2 /*return*/];
             }

package/dist/cjs/client/consent/onetrust-api.d.ts

@@ -71,6 +71,16 @@ export declare const getOneTrustActiveGroups: () => string | undefined;
  * getNormalizedActiveGroupIds() // ["C0001", "C0003"]
  */
 export declare const getNormalizedActiveGroupIds: () => string[];
+/**
+ * Check if OnetrustActiveGroups is populated with actual consent categories.
+ *
+ * OneTrust sets window.OnetrustActiveGroups after the API object is available,
+ * so this guards against a race condition where the API exists but consent
+ * categories have not yet been populated.
+ *
+ * @returns true if OnetrustActiveGroups is a non-empty string with at least one group ID
+ */
+export declare const hasActiveGroups: () => boolean;
 /**
  * Get all configured consent groups from OneTrust.
  *

package/dist/cjs/client/consent/onetrust-api.js

@@ -8,7 +8,7 @@
  * Modeled after analytics-next's onetrust-api.ts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.coerceConsentModel = exports.getNormalizedCategories = exports.getAllGroups = exports.getNormalizedActiveGroupIds = exports.getOneTrustActiveGroups = exports.getOneTrustGlobal = exports.OtConsentModel = void 0;
+exports.coerceConsentModel = exports.getNormalizedCategories = exports.getAllGroups = exports.hasActiveGroups = exports.getNormalizedActiveGroupIds = exports.getOneTrustActiveGroups = exports.getOneTrustGlobal = exports.OtConsentModel = void 0;
 /**
  * OneTrust consent model types
  */
@@ -70,6 +70,19 @@ var getNormalizedActiveGroupIds = function () {
     return groups.trim().split(',').filter(Boolean);
 };
 exports.getNormalizedActiveGroupIds = getNormalizedActiveGroupIds;
+/**
+ * Check if OnetrustActiveGroups is populated with actual consent categories.
+ *
+ * OneTrust sets window.OnetrustActiveGroups after the API object is available,
+ * so this guards against a race condition where the API exists but consent
+ * categories have not yet been populated.
+ *
+ * @returns true if OnetrustActiveGroups is a non-empty string with at least one group ID
+ */
+var hasActiveGroups = function () {
+    return (0, exports.getNormalizedActiveGroupIds)().length > 0;
+};
+exports.hasActiveGroups = hasActiveGroups;
 /**
  * Get all configured consent groups from OneTrust.
  *

package/dist/cjs/client/consent/onetrust.js

@@ -63,7 +63,7 @@ var onetrustConsentAdapter = function (options) {
         },
         userCanBeTracked: userCanBeTracked,
         getCategories: function () { return (0, onetrust_api_js_1.getNormalizedCategories)(); },
-        isConsentReady: function () { return !!(0, onetrust_api_js_1.getOneTrustGlobal)(); },
+        isConsentReady: function () { return !!(0, onetrust_api_js_1.getOneTrustGlobal)() && (0, onetrust_api_js_1.hasActiveGroups)(); },
         getConsentModel: function () {
             var api = (0, onetrust_api_js_1.getOneTrustGlobal)();
             if (!api)

package/dist/cjs/client/identifiers.d.ts

@@ -39,13 +39,17 @@ export declare const getShopifyCart: (baseUrl?: string, localePath?: string) =>
  */
 export declare const updateShopifyCartAttributes: (attributes: Record<string, string>, baseUrl?: string, localePath?: string) => Promise<ShopifyCart>;
 /**
- * Sync identifiers to Shopify cart attributes.
+ * Sync CDP and analytics identifiers to Shopify cart attributes.
  *
- * This function:
- * 1. Gets the current cart
- * 2. Checks if identifiers already exist
- * 3. If not, updates the cart with the identifiers
+ * By default, syncs the Chord CDP anonymous ID (`__eventn_id` cookie) and
+ * Google Analytics client ID (`_ga` cookie) to the cart. These attributes
+ * are included in Shopify order webhooks, enabling server-side events to
+ * correlate with client-side tracking sessions.
  *
- * @returns The updated cart, or undefined if no update was needed
+ * Smart deduplication: only updates the cart if identifiers are missing or
+ * have changed, avoiding unnecessary API calls on repeat page loads.
+ *
+ * @param options - Optional configuration for base URL, locale path, or custom identifier getter
+ * @returns The updated cart, or undefined if no update was needed or an error occurred
  */
 export declare const syncIdentifiersToCart: (options?: IdentifierSyncOptions) => Promise<ShopifyCart | undefined>;

package/dist/cjs/client/identifiers.js

@@ -150,14 +150,18 @@ var updateShopifyCartAttributes = function (attributes, baseUrl, localePath) { r
 }); };
 exports.updateShopifyCartAttributes = updateShopifyCartAttributes;
 /**
- * Sync identifiers to Shopify cart attributes.
+ * Sync CDP and analytics identifiers to Shopify cart attributes.
  *
- * This function:
- * 1. Gets the current cart
- * 2. Checks if identifiers already exist
- * 3. If not, updates the cart with the identifiers
+ * By default, syncs the Chord CDP anonymous ID (`__eventn_id` cookie) and
+ * Google Analytics client ID (`_ga` cookie) to the cart. These attributes
+ * are included in Shopify order webhooks, enabling server-side events to
+ * correlate with client-side tracking sessions.
  *
- * @returns The updated cart, or undefined if no update was needed
+ * Smart deduplication: only updates the cart if identifiers are missing or
+ * have changed, avoiding unnecessary API calls on repeat page loads.
+ *
+ * @param options - Optional configuration for base URL, locale path, or custom identifier getter
+ * @returns The updated cart, or undefined if no update was needed or an error occurred
  */
 var syncIdentifiersToCart = function (options) {
     if (options === void 0) { options = {}; }

package/dist/cjs/client/index.d.ts

@@ -159,10 +159,10 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     private webPixelMessageHandler;
     /**
      * Set up a listener for postMessage events from the Shopify Web Pixel sandbox.
-     * This allows the lightweight web pixel (running in Shopify's sandboxed iframe)
+     * This allows the web pixel (running in Shopify's sandboxed iframe)
      * to forward analytics events to this ChordAnalytics instance on the storefront.
      *
-     * The lightweight web pixel sends messages in the format:
+     * The web pixel sends messages in the format:
      * - { source: 'chord-web-pixel', type: 'track', payload: [eventName, properties] }
      * - { source: 'chord-web-pixel', type: 'identify', payload: [userId, traits] }
      * - { source: 'chord-web-pixel', type: 'page', payload: [properties] }

package/dist/cjs/client/index.js

@@ -70,7 +70,7 @@ var CONSENT_QUEUE_MAX_EVENTS = 50; // Max number of events to queue
 var ChordAnalytics = /** @class */ (function () {
     function ChordAnalytics(options) {
         var _this = this;
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         /**
          * Allows snippet.js to detect whether this library has been initialized yet.
          */
@@ -799,10 +799,10 @@ var ChordAnalytics = /** @class */ (function () {
         this.webPixelMessageHandler = null;
         /**
          * Set up a listener for postMessage events from the Shopify Web Pixel sandbox.
-         * This allows the lightweight web pixel (running in Shopify's sandboxed iframe)
+         * This allows the web pixel (running in Shopify's sandboxed iframe)
          * to forward analytics events to this ChordAnalytics instance on the storefront.
          *
-         * The lightweight web pixel sends messages in the format:
+         * The web pixel sends messages in the format:
          * - { source: 'chord-web-pixel', type: 'track', payload: [eventName, properties] }
          * - { source: 'chord-web-pixel', type: 'identify', payload: [userId, traits] }
          * - { source: 'chord-web-pixel', type: 'page', payload: [properties] }
@@ -1447,12 +1447,16 @@ var ChordAnalytics = /** @class */ (function () {
             window[this.options.namespace] = (window === null || window === void 0 ? void 0 : window[this.options.namespace]) || this;
             this.initializeCdp();
         }
-        // Automatically set up web pixel listener if enabled
-        if ((_d = this.options) === null || _d === void 0 ? void 0 : _d.enableWebPixelListener) {
+        // Set up web pixel listener: explicit true/false takes precedence,
+        // otherwise auto-detect by checking for window.Shopify.shop (Liquid storefront)
+        var shouldEnableWebPixel = (_e = (_d = this.options) === null || _d === void 0 ? void 0 : _d.enableWebPixelListener) !== null && _e !== void 0 ? _e : (typeof window !== 'undefined' && !!((_f = window.Shopify) === null || _f === void 0 ? void 0 : _f.shop));
+        if (shouldEnableWebPixel) {
             this.setupWebPixelListener();
         }
-        // Automatically sync identifiers to cart if enabled
-        if ((_e = this.options) === null || _e === void 0 ? void 0 : _e.enableIdentifierSync) {
+        // Sync identifiers to cart: explicit true/false takes precedence,
+        // otherwise auto-detect by checking for window.Shopify.shop (Liquid storefront)
+        var shouldEnableIdentifierSync = (_h = (_g = this.options) === null || _g === void 0 ? void 0 : _g.enableIdentifierSync) !== null && _h !== void 0 ? _h : (typeof window !== 'undefined' && !!((_j = window.Shopify) === null || _j === void 0 ? void 0 : _j.shop));
+        if (shouldEnableIdentifierSync) {
             this.syncIdentifiersToCart();
         }
     }

package/dist/cjs/types/client.d.ts

@@ -35,15 +35,17 @@ export interface ChordAnalyticsOptions<T extends ObjectTypes = ObjectTypes> {
     debug?: boolean;
     enableLogging?: boolean;
     /**
-     * When true, automatically sets up a postMessage listener for events from
-     * the Shopify Custom Web Pixel sandbox. This enables the lightweight web pixel
-     * to forward analytics events to this ChordAnalytics instance.
+     * Controls the postMessage listener for events from the Shopify Custom Web
+     * Pixel sandbox. When true, always enables the listener. When false, always
+     * disables it. When undefined (default), auto-detects by checking for
+     * window.Shopify.shop which is present on Shopify Liquid storefronts.
      */
     enableWebPixelListener?: boolean;
     /**
-     * When true, automatically syncs CDP anonymous ID and Google Client ID
-     * to Shopify cart attributes. This enables server-side events (webhooks)
-     * to correlate with client-side tracking.
+     * Controls syncing CDP anonymous ID and Google Client ID to Shopify cart
+     * attributes. When true, always enables sync. When false, always disables it.
+     * When undefined (default), auto-detects by checking for window.Shopify.shop
+     * which is present on Shopify Liquid storefronts.
      */
     enableIdentifierSync?: boolean;
     formatters: ChordAnalyticsFormatters<T>;

package/dist/client/cdp.js

@@ -44,13 +44,7 @@ export const addCdpSnippet = (options) => __awaiter(void 0, void 0, void 0, func
     yield cdpReadyPromise;
     let initialConsent = null;
     if (options.consent) {
-        if (options.debug && options.enableLogging) {
-            console.log('[Chord Analytics DEBUG]: Setting up consent management');
-        }
         initialConsent = yield addCdpConsent(options).init();
-        if (options.debug && options.enableLogging) {
-            console.log('[Chord Analytics DEBUG]: Consent management setup complete');
-        }
     }
     if (options.debug && options.enableLogging) {
         console.log('[Chord Analytics DEBUG]: CDP snippet added, initialConsent:', JSON.stringify(initialConsent));

package/dist/client/consent/index.js

@@ -121,17 +121,12 @@ export const addCdpConsent = (options) => {
                 return null;
             }
         }
+        // Set up consent management and wait for it to complete
         try {
-            const result = yield setupConsentManagement();
-            if (options.debug && options.enableLogging) {
-                console.log('[Chord Analytics DEBUG]: setupConsentManagement() returned:', JSON.stringify(result));
-            }
-            return result;
+            return yield setupConsentManagement();
         }
         catch (error) {
-            if (options.debug && options.enableLogging) {
-                console.error('[Chord Analytics DEBUG]: Error setting up consent management:', error);
-            }
+            console.error('Error setting up consent management:', error);
             return null;
         }
     });

package/dist/client/consent/onetrust-api.d.ts

@@ -71,6 +71,16 @@ export declare const getOneTrustActiveGroups: () => string | undefined;
  * getNormalizedActiveGroupIds() // ["C0001", "C0003"]
  */
 export declare const getNormalizedActiveGroupIds: () => string[];
+/**
+ * Check if OnetrustActiveGroups is populated with actual consent categories.
+ *
+ * OneTrust sets window.OnetrustActiveGroups after the API object is available,
+ * so this guards against a race condition where the API exists but consent
+ * categories have not yet been populated.
+ *
+ * @returns true if OnetrustActiveGroups is a non-empty string with at least one group ID
+ */
+export declare const hasActiveGroups: () => boolean;
 /**
  * Get all configured consent groups from OneTrust.
  *

package/dist/client/consent/onetrust-api.js

@@ -64,6 +64,18 @@ export const getNormalizedActiveGroupIds = () => {
         return [];
     return groups.trim().split(',').filter(Boolean);
 };
+/**
+ * Check if OnetrustActiveGroups is populated with actual consent categories.
+ *
+ * OneTrust sets window.OnetrustActiveGroups after the API object is available,
+ * so this guards against a race condition where the API exists but consent
+ * categories have not yet been populated.
+ *
+ * @returns true if OnetrustActiveGroups is a non-empty string with at least one group ID
+ */
+export const hasActiveGroups = () => {
+    return getNormalizedActiveGroupIds().length > 0;
+};
 /**
  * Get all configured consent groups from OneTrust.
  *

package/dist/client/consent/onetrust.js

@@ -1,4 +1,4 @@
-import { getOneTrustGlobal, getNormalizedCategories, coerceConsentModel, } from './onetrust-api.js';
+import { getOneTrustGlobal, getNormalizedCategories, coerceConsentModel, hasActiveGroups, } from './onetrust-api.js';
 /**
  * Returns whether the user can currently be tracked.
  * Uses duck typing to check if OneTrust is fully loaded.
@@ -60,7 +60,7 @@ export const onetrustConsentAdapter = (options) => {
         },
         userCanBeTracked,
         getCategories: () => getNormalizedCategories(),
-        isConsentReady: () => !!getOneTrustGlobal(),
+        isConsentReady: () => !!getOneTrustGlobal() && hasActiveGroups(),
         getConsentModel: () => {
             const api = getOneTrustGlobal();
             if (!api)

package/dist/client/identifiers.d.ts

@@ -39,13 +39,17 @@ export declare const getShopifyCart: (baseUrl?: string, localePath?: string) =>
  */
 export declare const updateShopifyCartAttributes: (attributes: Record<string, string>, baseUrl?: string, localePath?: string) => Promise<ShopifyCart>;
 /**
- * Sync identifiers to Shopify cart attributes.
+ * Sync CDP and analytics identifiers to Shopify cart attributes.
  *
- * This function:
- * 1. Gets the current cart
- * 2. Checks if identifiers already exist
- * 3. If not, updates the cart with the identifiers
+ * By default, syncs the Chord CDP anonymous ID (`__eventn_id` cookie) and
+ * Google Analytics client ID (`_ga` cookie) to the cart. These attributes
+ * are included in Shopify order webhooks, enabling server-side events to
+ * correlate with client-side tracking sessions.
  *
- * @returns The updated cart, or undefined if no update was needed
+ * Smart deduplication: only updates the cart if identifiers are missing or
+ * have changed, avoiding unnecessary API calls on repeat page loads.
+ *
+ * @param options - Optional configuration for base URL, locale path, or custom identifier getter
+ * @returns The updated cart, or undefined if no update was needed or an error occurred
  */
 export declare const syncIdentifiersToCart: (options?: IdentifierSyncOptions) => Promise<ShopifyCart | undefined>;

package/dist/client/identifiers.js

@@ -100,14 +100,18 @@ export const updateShopifyCartAttributes = (attributes, baseUrl, localePath) =>
     return response.json();
 });
 /**
- * Sync identifiers to Shopify cart attributes.
+ * Sync CDP and analytics identifiers to Shopify cart attributes.
  *
- * This function:
- * 1. Gets the current cart
- * 2. Checks if identifiers already exist
- * 3. If not, updates the cart with the identifiers
+ * By default, syncs the Chord CDP anonymous ID (`__eventn_id` cookie) and
+ * Google Analytics client ID (`_ga` cookie) to the cart. These attributes
+ * are included in Shopify order webhooks, enabling server-side events to
+ * correlate with client-side tracking sessions.
  *
- * @returns The updated cart, or undefined if no update was needed
+ * Smart deduplication: only updates the cart if identifiers are missing or
+ * have changed, avoiding unnecessary API calls on repeat page loads.
+ *
+ * @param options - Optional configuration for base URL, locale path, or custom identifier getter
+ * @returns The updated cart, or undefined if no update was needed or an error occurred
  */
 export const syncIdentifiersToCart = (options = {}) => __awaiter(void 0, void 0, void 0, function* () {
     try {

package/dist/client/index.d.ts

@@ -159,10 +159,10 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     private webPixelMessageHandler;
     /**
      * Set up a listener for postMessage events from the Shopify Web Pixel sandbox.
-     * This allows the lightweight web pixel (running in Shopify's sandboxed iframe)
+     * This allows the web pixel (running in Shopify's sandboxed iframe)
      * to forward analytics events to this ChordAnalytics instance on the storefront.
      *
-     * The lightweight web pixel sends messages in the format:
+     * The web pixel sends messages in the format:
      * - { source: 'chord-web-pixel', type: 'track', payload: [eventName, properties] }
      * - { source: 'chord-web-pixel', type: 'identify', payload: [userId, traits] }
      * - { source: 'chord-web-pixel', type: 'page', payload: [properties] }

package/dist/client/index.js

@@ -19,7 +19,7 @@ const CONSENT_QUEUE_MAX_SIZE_BYTES = 100 * 1024; // 100KB max queue size
 const CONSENT_QUEUE_MAX_EVENTS = 50; // Max number of events to queue
 export class ChordAnalytics {
     constructor(options) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         /**
          * Allows snippet.js to detect whether this library has been initialized yet.
          */
@@ -586,7 +586,7 @@ export class ChordAnalytics {
             });
         });
         this.reset = () => __awaiter(this, void 0, void 0, function* () {
-            var _f;
+            var _k;
             try {
                 this.resetInProgress = true;
                 const a = this.ccdp();
@@ -603,12 +603,12 @@ export class ChordAnalytics {
                     // eslint-disable-next-line
                     yield new Promise((resolve) => setTimeout(resolve, 10));
                     try {
-                        const userState = ((_f = a === null || a === void 0 ? void 0 : a.user) === null || _f === void 0 ? void 0 : _f.call(a)) || {};
+                        const userState = ((_k = a === null || a === void 0 ? void 0 : a.user) === null || _k === void 0 ? void 0 : _k.call(a)) || {};
                         if (userState.userId === null || userState.userId === undefined) {
                             break;
                         }
                     }
-                    catch (_g) {
+                    catch (_l) {
                         break;
                     }
                     attempts++;
@@ -628,10 +628,10 @@ export class ChordAnalytics {
         this.webPixelMessageHandler = null;
         /**
          * Set up a listener for postMessage events from the Shopify Web Pixel sandbox.
-         * This allows the lightweight web pixel (running in Shopify's sandboxed iframe)
+         * This allows the web pixel (running in Shopify's sandboxed iframe)
          * to forward analytics events to this ChordAnalytics instance on the storefront.
          *
-         * The lightweight web pixel sends messages in the format:
+         * The web pixel sends messages in the format:
          * - { source: 'chord-web-pixel', type: 'track', payload: [eventName, properties] }
          * - { source: 'chord-web-pixel', type: 'identify', payload: [userId, traits] }
          * - { source: 'chord-web-pixel', type: 'page', payload: [properties] }
@@ -717,8 +717,8 @@ export class ChordAnalytics {
         });
         // TODO: Add support for props.products
         this.trackCartViewed = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
-            const cart = (_l = (_k = (_j = (_h = this.options) === null || _h === void 0 ? void 0 : _h.formatters) === null || _j === void 0 ? void 0 : _j.objects) === null || _k === void 0 ? void 0 : _k.cart) === null || _l === void 0 ? void 0 : _l.call(_k, {
+            var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
+            const cart = (_q = (_p = (_o = (_m = this.options) === null || _m === void 0 ? void 0 : _m.formatters) === null || _o === void 0 ? void 0 : _o.objects) === null || _p === void 0 ? void 0 : _p.cart) === null || _q === void 0 ? void 0 : _q.call(_p, {
                 cart: props === null || props === void 0 ? void 0 : props.cart,
             });
             const payload = {
@@ -727,17 +727,17 @@ export class ChordAnalytics {
                 products: cart === null || cart === void 0 ? void 0 : cart.products,
                 value: cart === null || cart === void 0 ? void 0 : cart.value,
             };
-            if ((_p = (_o = (_m = this.options) === null || _m === void 0 ? void 0 : _m.formatters) === null || _o === void 0 ? void 0 : _o.events) === null || _p === void 0 ? void 0 : _p.cartViewed) {
-                const formattedPayload = (_s = (_r = (_q = this.options) === null || _q === void 0 ? void 0 : _q.formatters) === null || _r === void 0 ? void 0 : _r.events) === null || _s === void 0 ? void 0 : _s.cartViewed(props, payload);
+            if ((_t = (_s = (_r = this.options) === null || _r === void 0 ? void 0 : _r.formatters) === null || _s === void 0 ? void 0 : _s.events) === null || _t === void 0 ? void 0 : _t.cartViewed) {
+                const formattedPayload = (_w = (_v = (_u = this.options) === null || _u === void 0 ? void 0 : _u.formatters) === null || _v === void 0 ? void 0 : _v.events) === null || _w === void 0 ? void 0 : _w.cartViewed(props, payload);
                 return this.track('Cart Viewed', formattedPayload, options);
             }
             return this.track('Cart Viewed', payload, options);
         });
         // TODO: Add support for props.products
         this.trackCheckoutStarted = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _t, _u, _v, _w, _x, _y, _z;
-            const formatter = (_v = (_u = (_t = this.options) === null || _t === void 0 ? void 0 : _t.formatters) === null || _u === void 0 ? void 0 : _u.events) === null || _v === void 0 ? void 0 : _v.checkoutStarted;
-            const checkout = (_z = (_y = (_x = (_w = this.options) === null || _w === void 0 ? void 0 : _w.formatters) === null || _x === void 0 ? void 0 : _x.objects) === null || _y === void 0 ? void 0 : _y.checkout) === null || _z === void 0 ? void 0 : _z.call(_y, {
+            var _x, _y, _z, _0, _1, _2, _3;
+            const formatter = (_z = (_y = (_x = this.options) === null || _x === void 0 ? void 0 : _x.formatters) === null || _y === void 0 ? void 0 : _y.events) === null || _z === void 0 ? void 0 : _z.checkoutStarted;
+            const checkout = (_3 = (_2 = (_1 = (_0 = this.options) === null || _0 === void 0 ? void 0 : _0.formatters) === null || _1 === void 0 ? void 0 : _1.objects) === null || _2 === void 0 ? void 0 : _2.checkout) === null || _3 === void 0 ? void 0 : _3.call(_2, {
                 checkout: props === null || props === void 0 ? void 0 : props.checkout,
             });
             const payload = checkout;
@@ -748,8 +748,8 @@ export class ChordAnalytics {
             return this.track('Checkout Started', payload, options);
         });
         this.trackCheckoutStepCompleted = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _0, _1, _2;
-            const formatter = (_2 = (_1 = (_0 = this.options) === null || _0 === void 0 ? void 0 : _0.formatters) === null || _1 === void 0 ? void 0 : _1.events) === null || _2 === void 0 ? void 0 : _2.checkoutStepCompleted;
+            var _4, _5, _6;
+            const formatter = (_6 = (_5 = (_4 = this.options) === null || _4 === void 0 ? void 0 : _4.formatters) === null || _5 === void 0 ? void 0 : _5.events) === null || _6 === void 0 ? void 0 : _6.checkoutStepCompleted;
             const payload = {
                 checkout_id: props === null || props === void 0 ? void 0 : props.checkoutId,
                 payment_method: props === null || props === void 0 ? void 0 : props.paymentMethod,
@@ -763,8 +763,8 @@ export class ChordAnalytics {
             return this.track('Checkout Step Completed', payload, options);
         });
         this.trackCheckoutStepViewed = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _3, _4, _5;
-            const formatter = (_5 = (_4 = (_3 = this.options) === null || _3 === void 0 ? void 0 : _3.formatters) === null || _4 === void 0 ? void 0 : _4.events) === null || _5 === void 0 ? void 0 : _5.checkoutStepViewed;
+            var _7, _8, _9;
+            const formatter = (_9 = (_8 = (_7 = this.options) === null || _7 === void 0 ? void 0 : _7.formatters) === null || _8 === void 0 ? void 0 : _8.events) === null || _9 === void 0 ? void 0 : _9.checkoutStepViewed;
             const payload = {
                 checkout_id: props === null || props === void 0 ? void 0 : props.checkoutId,
                 payment_method: props === null || props === void 0 ? void 0 : props.paymentMethod,
@@ -778,8 +778,8 @@ export class ChordAnalytics {
             return this.track('Checkout Step Viewed', payload, options);
         });
         this.trackCouponApplied = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _6, _7, _8;
-            const formatter = (_8 = (_7 = (_6 = this.options) === null || _6 === void 0 ? void 0 : _6.formatters) === null || _7 === void 0 ? void 0 : _7.events) === null || _8 === void 0 ? void 0 : _8.couponApplied;
+            var _10, _11, _12;
+            const formatter = (_12 = (_11 = (_10 = this.options) === null || _10 === void 0 ? void 0 : _10.formatters) === null || _11 === void 0 ? void 0 : _11.events) === null || _12 === void 0 ? void 0 : _12.couponApplied;
             const payload = {
                 cart_id: props === null || props === void 0 ? void 0 : props.cartId,
                 coupon_id: props === null || props === void 0 ? void 0 : props.couponId,
@@ -794,8 +794,8 @@ export class ChordAnalytics {
             return this.track('Coupon Applied', payload, options);
         });
         this.trackCouponDenied = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _9, _10, _11;
-            const formatter = (_11 = (_10 = (_9 = this.options) === null || _9 === void 0 ? void 0 : _9.formatters) === null || _10 === void 0 ? void 0 : _10.events) === null || _11 === void 0 ? void 0 : _11.couponDenied;
+            var _13, _14, _15;
+            const formatter = (_15 = (_14 = (_13 = this.options) === null || _13 === void 0 ? void 0 : _13.formatters) === null || _14 === void 0 ? void 0 : _14.events) === null || _15 === void 0 ? void 0 : _15.couponDenied;
             const payload = {
                 cart_id: props === null || props === void 0 ? void 0 : props.cartId,
                 coupon_id: props === null || props === void 0 ? void 0 : props.couponId,
@@ -810,8 +810,8 @@ export class ChordAnalytics {
             return this.track('Coupon Denied', payload, options);
         });
         this.trackCouponEntered = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _12, _13, _14;
-            const formatter = (_14 = (_13 = (_12 = this.options) === null || _12 === void 0 ? void 0 : _12.formatters) === null || _13 === void 0 ? void 0 : _13.events) === null || _14 === void 0 ? void 0 : _14.couponEntered;
+            var _16, _17, _18;
+            const formatter = (_18 = (_17 = (_16 = this.options) === null || _16 === void 0 ? void 0 : _16.formatters) === null || _17 === void 0 ? void 0 : _17.events) === null || _18 === void 0 ? void 0 : _18.couponEntered;
             const payload = {
                 cart_id: props === null || props === void 0 ? void 0 : props.cartId,
                 coupon_id: props === null || props === void 0 ? void 0 : props.couponId,
@@ -825,8 +825,8 @@ export class ChordAnalytics {
             return this.track('Coupon Entered', payload, options);
         });
         this.trackCouponRemoved = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _15, _16, _17;
-            const formatter = (_17 = (_16 = (_15 = this.options) === null || _15 === void 0 ? void 0 : _15.formatters) === null || _16 === void 0 ? void 0 : _16.events) === null || _17 === void 0 ? void 0 : _17.couponRemoved;
+            var _19, _20, _21;
+            const formatter = (_21 = (_20 = (_19 = this.options) === null || _19 === void 0 ? void 0 : _19.formatters) === null || _20 === void 0 ? void 0 : _20.events) === null || _21 === void 0 ? void 0 : _21.couponRemoved;
             const payload = {
                 cart_id: props === null || props === void 0 ? void 0 : props.cartId,
                 coupon_id: props === null || props === void 0 ? void 0 : props.couponId,
@@ -841,8 +841,8 @@ export class ChordAnalytics {
             return this.track('Coupon Removed', payload, options);
         });
         this.trackEmailCaptured = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _18, _19, _20;
-            const formatter = (_20 = (_19 = (_18 = this.options) === null || _18 === void 0 ? void 0 : _18.formatters) === null || _19 === void 0 ? void 0 : _19.events) === null || _20 === void 0 ? void 0 : _20.emailCaptured;
+            var _22, _23, _24;
+            const formatter = (_24 = (_23 = (_22 = this.options) === null || _22 === void 0 ? void 0 : _22.formatters) === null || _23 === void 0 ? void 0 : _23.events) === null || _24 === void 0 ? void 0 : _24.emailCaptured;
             const payload = {
                 email: props === null || props === void 0 ? void 0 : props.email,
                 placement_component: props === null || props === void 0 ? void 0 : props.placementComponent,
@@ -855,13 +855,13 @@ export class ChordAnalytics {
             return this.track('Email Captured', payload, options);
         });
         this.trackProductAdded = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31, _32;
-            const formatter = (_23 = (_22 = (_21 = this.options) === null || _21 === void 0 ? void 0 : _21.formatters) === null || _22 === void 0 ? void 0 : _22.events) === null || _23 === void 0 ? void 0 : _23.productAdded;
-            const product = (_27 = (_26 = (_25 = (_24 = this.options) === null || _24 === void 0 ? void 0 : _24.formatters) === null || _25 === void 0 ? void 0 : _25.objects) === null || _26 === void 0 ? void 0 : _26.product) === null || _27 === void 0 ? void 0 : _27.call(_26, props === null || props === void 0 ? void 0 : props.product);
-            const cart = (_31 = (_30 = (_29 = (_28 = this.options) === null || _28 === void 0 ? void 0 : _28.formatters) === null || _29 === void 0 ? void 0 : _29.objects) === null || _30 === void 0 ? void 0 : _30.cart) === null || _31 === void 0 ? void 0 : _31.call(_30, {
+            var _25, _26, _27, _28, _29, _30, _31, _32, _33, _34, _35, _36;
+            const formatter = (_27 = (_26 = (_25 = this.options) === null || _25 === void 0 ? void 0 : _25.formatters) === null || _26 === void 0 ? void 0 : _26.events) === null || _27 === void 0 ? void 0 : _27.productAdded;
+            const product = (_31 = (_30 = (_29 = (_28 = this.options) === null || _28 === void 0 ? void 0 : _28.formatters) === null || _29 === void 0 ? void 0 : _29.objects) === null || _30 === void 0 ? void 0 : _30.product) === null || _31 === void 0 ? void 0 : _31.call(_30, props === null || props === void 0 ? void 0 : props.product);
+            const cart = (_35 = (_34 = (_33 = (_32 = this.options) === null || _32 === void 0 ? void 0 : _32.formatters) === null || _33 === void 0 ? void 0 : _33.objects) === null || _34 === void 0 ? void 0 : _34.cart) === null || _35 === void 0 ? void 0 : _35.call(_34, {
                 cart: props === null || props === void 0 ? void 0 : props.cart,
             });
-            const quantity = ((_32 = props === null || props === void 0 ? void 0 : props.product) === null || _32 === void 0 ? void 0 : _32.quantity) || 1;
+            const quantity = ((_36 = props === null || props === void 0 ? void 0 : props.product) === null || _36 === void 0 ? void 0 : _36.quantity) || 1;
             const payload = Object.assign(Object.assign({}, product), { cart_id: cart.cart_id, currency: cart.currency, products: [Object.assign(Object.assign({}, product), { quantity })], total: product.price * (quantity || 1), value: product.price * (quantity || 1) });
             if (typeof formatter === 'function') {
                 const formattedPayload = formatter(props, payload);
@@ -870,14 +870,14 @@ export class ChordAnalytics {
             return this.track('Product Added', payload, options);
         });
         this.trackProductClicked = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _33, _34, _35, _36, _37, _38, _39, _40, _41, _42, _43, _44, _45;
-            const formatter = (_35 = (_34 = (_33 = this.options) === null || _33 === void 0 ? void 0 : _33.formatters) === null || _34 === void 0 ? void 0 : _34.events) === null || _35 === void 0 ? void 0 : _35.productClicked;
-            const product = (_39 = (_38 = (_37 = (_36 = this.options) === null || _36 === void 0 ? void 0 : _36.formatters) === null || _37 === void 0 ? void 0 : _37.objects) === null || _38 === void 0 ? void 0 : _38.product) === null || _39 === void 0 ? void 0 : _39.call(_38, props === null || props === void 0 ? void 0 : props.product);
-            const cart = (_43 = (_42 = (_41 = (_40 = this.options) === null || _40 === void 0 ? void 0 : _40.formatters) === null || _41 === void 0 ? void 0 : _41.objects) === null || _42 === void 0 ? void 0 : _42.cart) === null || _43 === void 0 ? void 0 : _43.call(_42, {
+            var _37, _38, _39, _40, _41, _42, _43, _44, _45, _46, _47, _48, _49;
+            const formatter = (_39 = (_38 = (_37 = this.options) === null || _37 === void 0 ? void 0 : _37.formatters) === null || _38 === void 0 ? void 0 : _38.events) === null || _39 === void 0 ? void 0 : _39.productClicked;
+            const product = (_43 = (_42 = (_41 = (_40 = this.options) === null || _40 === void 0 ? void 0 : _40.formatters) === null || _41 === void 0 ? void 0 : _41.objects) === null || _42 === void 0 ? void 0 : _42.product) === null || _43 === void 0 ? void 0 : _43.call(_42, props === null || props === void 0 ? void 0 : props.product);
+            const cart = (_47 = (_46 = (_45 = (_44 = this.options) === null || _44 === void 0 ? void 0 : _44.formatters) === null || _45 === void 0 ? void 0 : _45.objects) === null || _46 === void 0 ? void 0 : _46.cart) === null || _47 === void 0 ? void 0 : _47.call(_46, {
                 cart: props === null || props === void 0 ? void 0 : props.cart,
             });
-            const quantity = ((_44 = props === null || props === void 0 ? void 0 : props.product) === null || _44 === void 0 ? void 0 : _44.quantity) || 1;
-            const payload = Object.assign(Object.assign({}, product), { cart_id: cart.cart_id, currency: cart.currency, item_list_id: (_45 = props === null || props === void 0 ? void 0 : props.listId) === null || _45 === void 0 ? void 0 : _45.toString(), item_list_name: props === null || props === void 0 ? void 0 : props.listName, products: [Object.assign(Object.assign({}, product), { quantity })] });
+            const quantity = ((_48 = props === null || props === void 0 ? void 0 : props.product) === null || _48 === void 0 ? void 0 : _48.quantity) || 1;
+            const payload = Object.assign(Object.assign({}, product), { cart_id: cart.cart_id, currency: cart.currency, item_list_id: (_49 = props === null || props === void 0 ? void 0 : props.listId) === null || _49 === void 0 ? void 0 : _49.toString(), item_list_name: props === null || props === void 0 ? void 0 : props.listName, products: [Object.assign(Object.assign({}, product), { quantity })] });
             if (typeof formatter === 'function') {
                 const formattedPayload = formatter(props, payload);
                 return this.track('Product Clicked', formattedPayload, options);
@@ -885,13 +885,13 @@ export class ChordAnalytics {
             return this.track('Product Clicked', payload, options);
         });
         this.trackVariantClicked = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _46, _47, _48, _49, _50, _51, _52, _53, _54, _55, _56, _57;
-            const formatter = (_48 = (_47 = (_46 = this.options) === null || _46 === void 0 ? void 0 : _46.formatters) === null || _47 === void 0 ? void 0 : _47.events) === null || _48 === void 0 ? void 0 : _48.variantClicked;
-            const product = (_52 = (_51 = (_50 = (_49 = this.options) === null || _49 === void 0 ? void 0 : _49.formatters) === null || _50 === void 0 ? void 0 : _50.objects) === null || _51 === void 0 ? void 0 : _51.product) === null || _52 === void 0 ? void 0 : _52.call(_51, props === null || props === void 0 ? void 0 : props.product);
-            const cart = (_56 = (_55 = (_54 = (_53 = this.options) === null || _53 === void 0 ? void 0 : _53.formatters) === null || _54 === void 0 ? void 0 : _54.objects) === null || _55 === void 0 ? void 0 : _55.cart) === null || _56 === void 0 ? void 0 : _56.call(_55, {
+            var _50, _51, _52, _53, _54, _55, _56, _57, _58, _59, _60, _61;
+            const formatter = (_52 = (_51 = (_50 = this.options) === null || _50 === void 0 ? void 0 : _50.formatters) === null || _51 === void 0 ? void 0 : _51.events) === null || _52 === void 0 ? void 0 : _52.variantClicked;
+            const product = (_56 = (_55 = (_54 = (_53 = this.options) === null || _53 === void 0 ? void 0 : _53.formatters) === null || _54 === void 0 ? void 0 : _54.objects) === null || _55 === void 0 ? void 0 : _55.product) === null || _56 === void 0 ? void 0 : _56.call(_55, props === null || props === void 0 ? void 0 : props.product);
+            const cart = (_60 = (_59 = (_58 = (_57 = this.options) === null || _57 === void 0 ? void 0 : _57.formatters) === null || _58 === void 0 ? void 0 : _58.objects) === null || _59 === void 0 ? void 0 : _59.cart) === null || _60 === void 0 ? void 0 : _60.call(_59, {
                 cart: props === null || props === void 0 ? void 0 : props.cart,
             });
-            const quantity = ((_57 = props === null || props === void 0 ? void 0 : props.product) === null || _57 === void 0 ? void 0 : _57.quantity) || 1;
+            const quantity = ((_61 = props === null || props === void 0 ? void 0 : props.product) === null || _61 === void 0 ? void 0 : _61.quantity) || 1;
             const payload = Object.assign(Object.assign({}, product), { cart_id: cart.cart_id, currency: cart.currency, quantity: quantity, line_item_id: props === null || props === void 0 ? void 0 : props.lineItemId, coupon: props === null || props === void 0 ? void 0 : props.coupon });
             if (typeof formatter === 'function') {
                 const formattedPayload = formatter(props, payload);
@@ -900,13 +900,13 @@ export class ChordAnalytics {
             return this.track('Variant Clicked', payload, options);
         });
         this.trackProductListFiltered = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _58, _59, _60, _61, _62;
-            const formatter = (_60 = (_59 = (_58 = this.options) === null || _58 === void 0 ? void 0 : _58.formatters) === null || _59 === void 0 ? void 0 : _59.events) === null || _60 === void 0 ? void 0 : _60.productListFiltered;
+            var _62, _63, _64, _65, _66;
+            const formatter = (_64 = (_63 = (_62 = this.options) === null || _62 === void 0 ? void 0 : _62.formatters) === null || _63 === void 0 ? void 0 : _63.events) === null || _64 === void 0 ? void 0 : _64.productListFiltered;
             const payload = {
                 category: props === null || props === void 0 ? void 0 : props.category,
                 filters: props === null || props === void 0 ? void 0 : props.filters,
-                list_id: (_61 = props === null || props === void 0 ? void 0 : props.listId) === null || _61 === void 0 ? void 0 : _61.toString(),
-                item_list_id: (_62 = props === null || props === void 0 ? void 0 : props.listId) === null || _62 === void 0 ? void 0 : _62.toString(),
+                list_id: (_65 = props === null || props === void 0 ? void 0 : props.listId) === null || _65 === void 0 ? void 0 : _65.toString(),
+                item_list_id: (_66 = props === null || props === void 0 ? void 0 : props.listId) === null || _66 === void 0 ? void 0 : _66.toString(),
                 item_list_name: props === null || props === void 0 ? void 0 : props.listName,
                 sorts: props === null || props === void 0 ? void 0 : props.sorts,
             };
@@ -917,14 +917,14 @@ export class ChordAnalytics {
             return this.track('Product List Filtered', payload, options);
         });
         this.trackProductListViewed = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _63, _64, _65, _66, _67, _68;
-            const formatter = (_65 = (_64 = (_63 = this.options) === null || _63 === void 0 ? void 0 : _63.formatters) === null || _64 === void 0 ? void 0 : _64.events) === null || _65 === void 0 ? void 0 : _65.productListViewed;
+            var _67, _68, _69, _70, _71, _72;
+            const formatter = (_69 = (_68 = (_67 = this.options) === null || _67 === void 0 ? void 0 : _67.formatters) === null || _68 === void 0 ? void 0 : _68.events) === null || _69 === void 0 ? void 0 : _69.productListViewed;
             const payload = {
                 category: props === null || props === void 0 ? void 0 : props.category,
-                list_id: (_66 = props === null || props === void 0 ? void 0 : props.listId) === null || _66 === void 0 ? void 0 : _66.toString(),
-                item_list_id: (_67 = props === null || props === void 0 ? void 0 : props.listId) === null || _67 === void 0 ? void 0 : _67.toString(),
+                list_id: (_70 = props === null || props === void 0 ? void 0 : props.listId) === null || _70 === void 0 ? void 0 : _70.toString(),
+                item_list_id: (_71 = props === null || props === void 0 ? void 0 : props.listId) === null || _71 === void 0 ? void 0 : _71.toString(),
                 item_list_name: props === null || props === void 0 ? void 0 : props.listName,
-                products: (_68 = props === null || props === void 0 ? void 0 : props.products) === null || _68 === void 0 ? void 0 : _68.map((p, i) => {
+                products: (_72 = props === null || props === void 0 ? void 0 : props.products) === null || _72 === void 0 ? void 0 : _72.map((p, i) => {
                     var _a, _b, _c, _d;
                     return (_d = (_c = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.formatters) === null || _b === void 0 ? void 0 : _b.objects) === null || _c === void 0 ? void 0 : _c.product) === null || _d === void 0 ? void 0 : _d.call(_c, Object.assign(Object.assign({}, p), { position: i + 1 }));
                 }),
@@ -937,8 +937,8 @@ export class ChordAnalytics {
             return this.track('Product List Viewed', payload, options);
         });
         this.trackProductRemoved = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _69, _70, _71, _72, _73, _74, _75, _76, _77, _78, _79, _80, _81, _82, _83;
-            const formatter = (_71 = (_70 = (_69 = this.options) === null || _69 === void 0 ? void 0 : _69.formatters) === null || _70 === void 0 ? void 0 : _70.events) === null || _71 === void 0 ? void 0 : _71.productRemoved;
+            var _73, _74, _75, _76, _77, _78, _79, _80, _81, _82, _83, _84, _85, _86, _87;
+            const formatter = (_75 = (_74 = (_73 = this.options) === null || _73 === void 0 ? void 0 : _73.formatters) === null || _74 === void 0 ? void 0 : _74.events) === null || _75 === void 0 ? void 0 : _75.productRemoved;
             /*
             const product = this.options?.formatters?.objects?.product?.({
               position: props?.position,
@@ -947,13 +947,13 @@ export class ChordAnalytics {
               variantId: props?.variantId,
             })
             */
-            const lineItem = (_75 = (_74 = (_73 = (_72 = this.options) === null || _72 === void 0 ? void 0 : _72.formatters) === null || _73 === void 0 ? void 0 : _73.objects) === null || _74 === void 0 ? void 0 : _74.lineItem) === null || _75 === void 0 ? void 0 : _75.call(_74, {
+            const lineItem = (_79 = (_78 = (_77 = (_76 = this.options) === null || _76 === void 0 ? void 0 : _76.formatters) === null || _77 === void 0 ? void 0 : _77.objects) === null || _78 === void 0 ? void 0 : _78.lineItem) === null || _79 === void 0 ? void 0 : _79.call(_78, {
                 lineItem: props === null || props === void 0 ? void 0 : props.lineItem,
             });
-            const cart = (_79 = (_78 = (_77 = (_76 = this.options) === null || _76 === void 0 ? void 0 : _76.formatters) === null || _77 === void 0 ? void 0 : _77.objects) === null || _78 === void 0 ? void 0 : _78.cart) === null || _79 === void 0 ? void 0 : _79.call(_78, {
+            const cart = (_83 = (_82 = (_81 = (_80 = this.options) === null || _80 === void 0 ? void 0 : _80.formatters) === null || _81 === void 0 ? void 0 : _81.objects) === null || _82 === void 0 ? void 0 : _82.cart) === null || _83 === void 0 ? void 0 : _83.call(_82, {
                 cart: props === null || props === void 0 ? void 0 : props.cart,
             });
-            const payload = Object.assign(Object.assign({}, lineItem), { cart_id: cart.cart_id, currency: cart.currency, products: [lineItem], total: ((_80 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.price) !== null && _80 !== void 0 ? _80 : 0) * ((_81 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.quantity) !== null && _81 !== void 0 ? _81 : 1), value: ((_82 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.price) !== null && _82 !== void 0 ? _82 : 0) * ((_83 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.quantity) !== null && _83 !== void 0 ? _83 : 1) });
+            const payload = Object.assign(Object.assign({}, lineItem), { cart_id: cart.cart_id, currency: cart.currency, products: [lineItem], total: ((_84 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.price) !== null && _84 !== void 0 ? _84 : 0) * ((_85 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.quantity) !== null && _85 !== void 0 ? _85 : 1), value: ((_86 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.price) !== null && _86 !== void 0 ? _86 : 0) * ((_87 = lineItem === null || lineItem === void 0 ? void 0 : lineItem.quantity) !== null && _87 !== void 0 ? _87 : 1) });
             if (typeof formatter === 'function') {
                 const formattedPayload = formatter(props, payload);
                 return this.track('Product Removed', formattedPayload, options);
@@ -961,14 +961,14 @@ export class ChordAnalytics {
             return this.track('Product Removed', payload, options);
         });
         this.trackProductViewed = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _84, _85, _86, _87, _88, _89, _90, _91, _92, _93, _94, _95, _96;
-            const formatter = (_86 = (_85 = (_84 = this.options) === null || _84 === void 0 ? void 0 : _84.formatters) === null || _85 === void 0 ? void 0 : _85.events) === null || _86 === void 0 ? void 0 : _86.productViewed;
-            const product = (_90 = (_89 = (_88 = (_87 = this.options) === null || _87 === void 0 ? void 0 : _87.formatters) === null || _88 === void 0 ? void 0 : _88.objects) === null || _89 === void 0 ? void 0 : _89.product) === null || _90 === void 0 ? void 0 : _90.call(_89, props === null || props === void 0 ? void 0 : props.product);
-            const cart = (_94 = (_93 = (_92 = (_91 = this.options) === null || _91 === void 0 ? void 0 : _91.formatters) === null || _92 === void 0 ? void 0 : _92.objects) === null || _93 === void 0 ? void 0 : _93.cart) === null || _94 === void 0 ? void 0 : _94.call(_93, {
+            var _88, _89, _90, _91, _92, _93, _94, _95, _96, _97, _98, _99, _100;
+            const formatter = (_90 = (_89 = (_88 = this.options) === null || _88 === void 0 ? void 0 : _88.formatters) === null || _89 === void 0 ? void 0 : _89.events) === null || _90 === void 0 ? void 0 : _90.productViewed;
+            const product = (_94 = (_93 = (_92 = (_91 = this.options) === null || _91 === void 0 ? void 0 : _91.formatters) === null || _92 === void 0 ? void 0 : _92.objects) === null || _93 === void 0 ? void 0 : _93.product) === null || _94 === void 0 ? void 0 : _94.call(_93, props === null || props === void 0 ? void 0 : props.product);
+            const cart = (_98 = (_97 = (_96 = (_95 = this.options) === null || _95 === void 0 ? void 0 : _95.formatters) === null || _96 === void 0 ? void 0 : _96.objects) === null || _97 === void 0 ? void 0 : _97.cart) === null || _98 === void 0 ? void 0 : _98.call(_97, {
                 cart: props === null || props === void 0 ? void 0 : props.cart,
             });
-            const quantity = ((_95 = props === null || props === void 0 ? void 0 : props.product) === null || _95 === void 0 ? void 0 : _95.quantity) || 1;
-            const payload = Object.assign(Object.assign({}, product), { cart_id: cart.cart_id, currency: cart.currency, products: [Object.assign(Object.assign({}, product), { quantity })], value: product.price * (((_96 = props === null || props === void 0 ? void 0 : props.product) === null || _96 === void 0 ? void 0 : _96.quantity) || 1) });
+            const quantity = ((_99 = props === null || props === void 0 ? void 0 : props.product) === null || _99 === void 0 ? void 0 : _99.quantity) || 1;
+            const payload = Object.assign(Object.assign({}, product), { cart_id: cart.cart_id, currency: cart.currency, products: [Object.assign(Object.assign({}, product), { quantity })], value: product.price * (((_100 = props === null || props === void 0 ? void 0 : props.product) === null || _100 === void 0 ? void 0 : _100.quantity) || 1) });
             if (typeof formatter === 'function') {
                 const formattedPayload = formatter(props, payload);
                 return this.track('Product Viewed', formattedPayload, options);
@@ -976,12 +976,12 @@ export class ChordAnalytics {
             return this.track('Product Viewed', payload, options);
         });
         this.trackProductsSearched = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _97, _98, _99, _100;
-            const formatter = (_99 = (_98 = (_97 = this.options) === null || _97 === void 0 ? void 0 : _97.formatters) === null || _98 === void 0 ? void 0 : _98.events) === null || _99 === void 0 ? void 0 : _99.productsSearched;
+            var _101, _102, _103, _104;
+            const formatter = (_103 = (_102 = (_101 = this.options) === null || _101 === void 0 ? void 0 : _101.formatters) === null || _102 === void 0 ? void 0 : _102.events) === null || _103 === void 0 ? void 0 : _103.productsSearched;
             const payload = {
                 currency: props === null || props === void 0 ? void 0 : props.currency,
                 price: typeof (props === null || props === void 0 ? void 0 : props.price) !== 'undefined' ? Number(props === null || props === void 0 ? void 0 : props.price) : undefined,
-                product_id: (_100 = props === null || props === void 0 ? void 0 : props.productId) === null || _100 === void 0 ? void 0 : _100.toString(),
+                product_id: (_104 = props === null || props === void 0 ? void 0 : props.productId) === null || _104 === void 0 ? void 0 : _104.toString(),
                 quantity: props === null || props === void 0 ? void 0 : props.quantity,
                 query: props === null || props === void 0 ? void 0 : props.query,
             };
@@ -992,8 +992,8 @@ export class ChordAnalytics {
             return this.track('Products Searched', payload, options);
         });
         this.trackSignedIn = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _101, _102, _103;
-            const formatter = (_103 = (_102 = (_101 = this.options) === null || _101 === void 0 ? void 0 : _101.formatters) === null || _102 === void 0 ? void 0 : _102.events) === null || _103 === void 0 ? void 0 : _103.signedIn;
+            var _105, _106, _107;
+            const formatter = (_107 = (_106 = (_105 = this.options) === null || _105 === void 0 ? void 0 : _105.formatters) === null || _106 === void 0 ? void 0 : _106.events) === null || _107 === void 0 ? void 0 : _107.signedIn;
             const payload = {
                 email: props === null || props === void 0 ? void 0 : props.email,
                 method: props === null || props === void 0 ? void 0 : props.method,
@@ -1005,8 +1005,8 @@ export class ChordAnalytics {
             return this.track('Signed In', payload, options);
         });
         this.trackSignedOut = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _104, _105, _106;
-            const formatter = (_106 = (_105 = (_104 = this.options) === null || _104 === void 0 ? void 0 : _104.formatters) === null || _105 === void 0 ? void 0 : _105.events) === null || _106 === void 0 ? void 0 : _106.signedOut;
+            var _108, _109, _110;
+            const formatter = (_110 = (_109 = (_108 = this.options) === null || _108 === void 0 ? void 0 : _108.formatters) === null || _109 === void 0 ? void 0 : _109.events) === null || _110 === void 0 ? void 0 : _110.signedOut;
             const payload = {
                 email: props === null || props === void 0 ? void 0 : props.email,
             };
@@ -1017,8 +1017,8 @@ export class ChordAnalytics {
             return this.track('Signed Out', payload, options);
         });
         this.trackSignedUp = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _107, _108, _109;
-            const formatter = (_109 = (_108 = (_107 = this.options) === null || _107 === void 0 ? void 0 : _107.formatters) === null || _108 === void 0 ? void 0 : _108.events) === null || _109 === void 0 ? void 0 : _109.signedUp;
+            var _111, _112, _113;
+            const formatter = (_113 = (_112 = (_111 = this.options) === null || _111 === void 0 ? void 0 : _111.formatters) === null || _112 === void 0 ? void 0 : _112.events) === null || _113 === void 0 ? void 0 : _113.signedUp;
             const payload = {
                 email: props === null || props === void 0 ? void 0 : props.email,
                 method: props === null || props === void 0 ? void 0 : props.method,
@@ -1030,8 +1030,8 @@ export class ChordAnalytics {
             return this.track('Signed Up', payload, options);
         });
         this.trackLoginStarted = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _110, _111, _112;
-            const formatter = (_112 = (_111 = (_110 = this.options) === null || _110 === void 0 ? void 0 : _110.formatters) === null || _111 === void 0 ? void 0 : _111.events) === null || _112 === void 0 ? void 0 : _112.loginStarted;
+            var _114, _115, _116;
+            const formatter = (_116 = (_115 = (_114 = this.options) === null || _114 === void 0 ? void 0 : _114.formatters) === null || _115 === void 0 ? void 0 : _115.events) === null || _116 === void 0 ? void 0 : _116.loginStarted;
             const payload = {
                 email: props === null || props === void 0 ? void 0 : props.email,
             };
@@ -1042,8 +1042,8 @@ export class ChordAnalytics {
             return this.track('Login Started', payload, options);
         });
         this.trackSubscriptionCancelled = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _113, _114, _115, _116;
-            const formatter = (_115 = (_114 = (_113 = this.options) === null || _113 === void 0 ? void 0 : _113.formatters) === null || _114 === void 0 ? void 0 : _114.events) === null || _115 === void 0 ? void 0 : _115.subscriptionCancelled;
+            var _117, _118, _119, _120;
+            const formatter = (_119 = (_118 = (_117 = this.options) === null || _117 === void 0 ? void 0 : _117.formatters) === null || _118 === void 0 ? void 0 : _118.events) === null || _119 === void 0 ? void 0 : _119.subscriptionCancelled;
             const payload = {
                 actionable_date: props === null || props === void 0 ? void 0 : props.actionableDate,
                 address: props === null || props === void 0 ? void 0 : props.address,
@@ -1052,7 +1052,7 @@ export class ChordAnalytics {
                 end_date: props === null || props === void 0 ? void 0 : props.endDate,
                 interval_length: props === null || props === void 0 ? void 0 : props.intervalLength,
                 interval_units: props === null || props === void 0 ? void 0 : props.intervalUnits,
-                products: (_116 = props === null || props === void 0 ? void 0 : props.products) === null || _116 === void 0 ? void 0 : _116.map((p, i) => {
+                products: (_120 = props === null || props === void 0 ? void 0 : props.products) === null || _120 === void 0 ? void 0 : _120.map((p, i) => {
                     var _a, _b, _c, _d;
                     return (_d = (_c = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.formatters) === null || _b === void 0 ? void 0 : _b.objects) === null || _c === void 0 ? void 0 : _c.product) === null || _d === void 0 ? void 0 : _d.call(_c, Object.assign(Object.assign({}, p), { position: i + 1 }));
                 }),
@@ -1067,8 +1067,8 @@ export class ChordAnalytics {
             return this.track('Subscription Cancelled', payload, options);
         });
         this.trackNavigationClicked = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _117, _118, _119;
-            const formatter = (_119 = (_118 = (_117 = this.options) === null || _117 === void 0 ? void 0 : _117.formatters) === null || _118 === void 0 ? void 0 : _118.events) === null || _119 === void 0 ? void 0 : _119.navigationClicked;
+            var _121, _122, _123;
+            const formatter = (_123 = (_122 = (_121 = this.options) === null || _121 === void 0 ? void 0 : _121.formatters) === null || _122 === void 0 ? void 0 : _122.events) === null || _123 === void 0 ? void 0 : _123.navigationClicked;
             const payload = {
                 category: props === null || props === void 0 ? void 0 : props.category,
                 label: props === null || props === void 0 ? void 0 : props.label,
@@ -1083,15 +1083,15 @@ export class ChordAnalytics {
             return this.track('Navigation Clicked', payload, options);
         });
         this.trackPaymentInfoEntered = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _120, _121, _122, _123;
-            const formatter = (_122 = (_121 = (_120 = this.options) === null || _120 === void 0 ? void 0 : _120.formatters) === null || _121 === void 0 ? void 0 : _121.events) === null || _122 === void 0 ? void 0 : _122.paymentInfoEntered;
+            var _124, _125, _126, _127;
+            const formatter = (_126 = (_125 = (_124 = this.options) === null || _124 === void 0 ? void 0 : _124.formatters) === null || _125 === void 0 ? void 0 : _125.events) === null || _126 === void 0 ? void 0 : _126.paymentInfoEntered;
             const payload = {
                 checkout_id: props === null || props === void 0 ? void 0 : props.checkoutId,
                 coupon: props === null || props === void 0 ? void 0 : props.coupon,
                 currency: props === null || props === void 0 ? void 0 : props.currency,
                 order_id: props === null || props === void 0 ? void 0 : props.orderId,
                 payment_method: props === null || props === void 0 ? void 0 : props.paymentMethod,
-                products: (_123 = props === null || props === void 0 ? void 0 : props.products) === null || _123 === void 0 ? void 0 : _123.map((p, i) => {
+                products: (_127 = props === null || props === void 0 ? void 0 : props.products) === null || _127 === void 0 ? void 0 : _127.map((p, i) => {
                     var _a, _b, _c, _d;
                     return (_d = (_c = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.formatters) === null || _b === void 0 ? void 0 : _b.objects) === null || _c === void 0 ? void 0 : _c.product) === null || _d === void 0 ? void 0 : _d.call(_c, Object.assign(Object.assign({}, p), { position: i + 1 }));
                 }),
@@ -1106,8 +1106,8 @@ export class ChordAnalytics {
             return this.track('Payment Info Entered', payload, options);
         });
         this.trackOrderCompleted = (props, options) => __awaiter(this, void 0, void 0, function* () {
-            var _124, _125, _126, _127;
-            const formatter = (_126 = (_125 = (_124 = this.options) === null || _124 === void 0 ? void 0 : _124.formatters) === null || _125 === void 0 ? void 0 : _125.events) === null || _126 === void 0 ? void 0 : _126.orderCompleted;
+            var _128, _129, _130, _131;
+            const formatter = (_130 = (_129 = (_128 = this.options) === null || _128 === void 0 ? void 0 : _128.formatters) === null || _129 === void 0 ? void 0 : _129.events) === null || _130 === void 0 ? void 0 : _130.orderCompleted;
             const payload = {
                 affiliation: props === null || props === void 0 ? void 0 : props.affiliation,
                 campaign_id: props === null || props === void 0 ? void 0 : props.campaignId,
@@ -1127,7 +1127,7 @@ export class ChordAnalytics {
                 order_date: props === null || props === void 0 ? void 0 : props.orderDate,
                 order_id: props === null || props === void 0 ? void 0 : props.orderId,
                 phone: props === null || props === void 0 ? void 0 : props.phone,
-                products: (_127 = props === null || props === void 0 ? void 0 : props.products) === null || _127 === void 0 ? void 0 : _127.map((p, i) => {
+                products: (_131 = props === null || props === void 0 ? void 0 : props.products) === null || _131 === void 0 ? void 0 : _131.map((p, i) => {
                     var _a;
                     return ({
                         affiliation: p === null || p === void 0 ? void 0 : p.affiliation,
@@ -1199,12 +1199,16 @@ export class ChordAnalytics {
             window[this.options.namespace] = (window === null || window === void 0 ? void 0 : window[this.options.namespace]) || this;
             this.initializeCdp();
         }
-        // Automatically set up web pixel listener if enabled
-        if ((_d = this.options) === null || _d === void 0 ? void 0 : _d.enableWebPixelListener) {
+        // Set up web pixel listener: explicit true/false takes precedence,
+        // otherwise auto-detect by checking for window.Shopify.shop (Liquid storefront)
+        const shouldEnableWebPixel = (_e = (_d = this.options) === null || _d === void 0 ? void 0 : _d.enableWebPixelListener) !== null && _e !== void 0 ? _e : (typeof window !== 'undefined' && !!((_f = window.Shopify) === null || _f === void 0 ? void 0 : _f.shop));
+        if (shouldEnableWebPixel) {
             this.setupWebPixelListener();
         }
-        // Automatically sync identifiers to cart if enabled
-        if ((_e = this.options) === null || _e === void 0 ? void 0 : _e.enableIdentifierSync) {
+        // Sync identifiers to cart: explicit true/false takes precedence,
+        // otherwise auto-detect by checking for window.Shopify.shop (Liquid storefront)
+        const shouldEnableIdentifierSync = (_h = (_g = this.options) === null || _g === void 0 ? void 0 : _g.enableIdentifierSync) !== null && _h !== void 0 ? _h : (typeof window !== 'undefined' && !!((_j = window.Shopify) === null || _j === void 0 ? void 0 : _j.shop));
+        if (shouldEnableIdentifierSync) {
             this.syncIdentifiersToCart();
         }
     }

package/dist/types/client.d.ts

@@ -35,15 +35,17 @@ export interface ChordAnalyticsOptions<T extends ObjectTypes = ObjectTypes> {
     debug?: boolean;
     enableLogging?: boolean;
     /**
-     * When true, automatically sets up a postMessage listener for events from
-     * the Shopify Custom Web Pixel sandbox. This enables the lightweight web pixel
-     * to forward analytics events to this ChordAnalytics instance.
+     * Controls the postMessage listener for events from the Shopify Custom Web
+     * Pixel sandbox. When true, always enables the listener. When false, always
+     * disables it. When undefined (default), auto-detects by checking for
+     * window.Shopify.shop which is present on Shopify Liquid storefronts.
      */
     enableWebPixelListener?: boolean;
     /**
-     * When true, automatically syncs CDP anonymous ID and Google Client ID
-     * to Shopify cart attributes. This enables server-side events (webhooks)
-     * to correlate with client-side tracking.
+     * Controls syncing CDP anonymous ID and Google Client ID to Shopify cart
+     * attributes. When true, always enables sync. When false, always disables it.
+     * When undefined (default), auto-detects by checking for window.Shopify.shop
+     * which is present on Shopify Liquid storefronts.
      */
     enableIdentifierSync?: boolean;
     formatters: ChordAnalyticsFormatters<T>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chordcommerce/analytics",
   "description": "Chord Commerce event tracking",
-  "version": "1.22.0-beta.1",
+  "version": "1.22.0-beta.2",
   "author": "Chord Commerce <help@chord.co> (https://www.chord.co)",
   "type": "module",
   "main": "dist/index.js",