@chordcommerce/analytics 1.16.0 → 1.17.0

package/dist/client/cdp.js

@@ -16,6 +16,19 @@ export const addCdpSnippet = (options) => __awaiter(void 0, void 0, void 0, func
     if (!document || typeof document.createElement === 'undefined')
         return;
     const normalizedCDPDomain = normalizeCDPDomain(options.cdpDomain);
+    // Create a promise that resolves when CDP is ready
+    const cdpReadyPromise = new Promise((resolve) => {
+        const checkCdpReady = () => {
+            const cdp = window[`_${options.namespace}`];
+            if (cdp && typeof cdp.configure === 'function') {
+                resolve();
+            }
+            else {
+                setTimeout(checkCdpReady, 50);
+            }
+        };
+        checkCdpReady();
+    });
     const s = document.createElement('script');
     s.async = true;
     s.src = `${normalizedCDPDomain}/p.js`;
@@ -23,20 +36,11 @@ export const addCdpSnippet = (options) => __awaiter(void 0, void 0, void 0, func
     s.setAttribute('data-init-only', 'true');
     s.setAttribute('data-namespace', `_${options.namespace}`);
     s.setAttribute('data-write-key', options.cdpWriteKey);
+    document.head.appendChild(s);
+    // Wait for CDP to be ready before setting up consent
+    yield cdpReadyPromise;
     if (options.consent) {
-        // If awaitConsent is true, wait for consent before loading CDP
-        if (options.awaitConsent) {
-            yield addCdpConsent(options).init();
-            document.head.appendChild(s);
-        }
-        else {
-            document.head.appendChild(s);
-            // If not awaiting consent, initialize in the background
-            addCdpConsent(options).init().catch(console.error);
-        }
-    }
-    else {
-        document.head.appendChild(s);
+        addCdpConsent(options).init();
     }
 });
 /*

package/dist/client/consent/index.js

@@ -68,7 +68,9 @@ export const addCdpConsent = (options) => {
             const cdp = window[`_${options.namespace}`];
             if (cdp && typeof cdp.configure === 'function') {
                 try {
-                    cdp.configure({ privacy: updatedConsent });
+                    if (Object.keys(updatedConsent).length > 0) {
+                        cdp.configure({ privacy: updatedConsent });
+                    }
                     return true;
                 }
                 catch (error) {

package/dist/client/index.d.ts

@@ -1,4 +1,5 @@
 import type { AnyAnalytics, EventProperties, Options, ValidateResult, ChordAnalyticsOptions, AnyOptions, CartViewedInput, IdentifyTraits, CheckoutStartedInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, EmailCapturedInput, ProductListViewedInput, ProductListFilteredInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductRemovedInput, ProductViewedInput, ProductsSearchedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, ObjectTypes, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from '../types/index.js';
+import { AnalyticsMiddleware } from '../types/client.js';
 export interface ChordAnalyticsSnippet {
     _loadOptions: ChordAnalyticsOptions<ObjectTypes>;
     invoked: boolean;
@@ -21,7 +22,19 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
      * Options for ChordAnalytics.
      */
     options: ChordAnalyticsOptions<T>;
+    /**
+     * Middleware to be applied to the event properties
+     */
+    middleware: any[];
+    /**
+     * Promise that resolves when CDP is ready
+     */
+    private cdpReadyPromise;
     constructor(options: ChordAnalyticsOptions<T>);
+    /**
+     * Initialize CDP snippet and wait for it to be ready
+     */
+    private initializeCdp;
     /**
      * Set debug mode for Chord Analytics
      * @param enabled - Whether debug mode should be enabled
@@ -52,6 +65,7 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
         platform: import("../types/client.js").platformMetadata;
         store: import("../types/client.js").storeMetadata;
     };
+    addSourceMiddleware: (func: AnalyticsMiddleware) => void;
     /**
      * Send a `track` event to the CDP with any event name and properties.
      */

package/dist/client/index.js

@@ -22,6 +22,14 @@ export class ChordAnalytics {
          * Allows snippet.js to detect whether the snippet has started running yet.
          */
         this.invoked = true;
+        /**
+         * Middleware to be applied to the event properties
+         */
+        this.middleware = [];
+        /**
+         * Promise that resolves when CDP is ready
+         */
+        this.cdpReadyPromise = null;
         /**
          * Set debug mode for Chord Analytics
          * @param enabled - Whether debug mode should be enabled
@@ -89,14 +97,54 @@ export class ChordAnalytics {
                     patch: 0,
                 } });
         };
+        // eslint-disable-next-line class-methods-use-this
+        this.addSourceMiddleware = (func) => {
+            this.middleware.push(func);
+        };
         /**
          * Send a `track` event to the CDP with any event name and properties.
          */
-        this.track = (event, props, options) => {
+        this.track = (event, props, options) => __awaiter(this, void 0, void 0, function* () {
             if (!event)
                 this.logger('No event name provided');
+            // Wait for CDP to be ready before sending track events
+            if (this.cdpReadyPromise) {
+                yield this.cdpReadyPromise;
+            }
             const formattedProps = this.options.stripNull && props ? pruneNullValues(props) : props;
-            const finalEventProps = Object.assign(Object.assign({}, formattedProps), { meta: this.meta() });
+            let middlewareProps = {};
+            if (this.middleware.length > 0) {
+                const searchParams = typeof window !== 'undefined' ? window.location.search : '';
+                const urlSearchParams = new URLSearchParams(searchParams);
+                const searchData = Object.fromEntries(urlSearchParams.entries());
+                // process middleware synchronously
+                this.middleware.forEach((func) => {
+                    try {
+                        const result = func({
+                            payload: {
+                                obj: {
+                                    properties: props,
+                                    event,
+                                    context: {
+                                        page: {
+                                            search: searchParams,
+                                            searchParams: searchData,
+                                        },
+                                    },
+                                },
+                            },
+                            next: (_) => _,
+                        });
+                        if (result && typeof result === 'object') {
+                            middlewareProps = Object.assign(Object.assign({}, middlewareProps), result);
+                        }
+                    }
+                    catch (error) {
+                        console.warn('Middleware error:', error);
+                    }
+                });
+            }
+            const finalEventProps = Object.assign(Object.assign(Object.assign({}, formattedProps), middlewareProps), { meta: this.meta() });
             if (this.options.debug) {
                 this.validate(event, finalEventProps).forEach((valid) => {
                     if (!valid.success) {
@@ -136,11 +184,15 @@ export class ChordAnalytics {
                     resolve();
                 }
             });
-        };
+        });
         /**
          * Send an `identify` event to the CDP with user id and traits.
          */
-        this.identify = (...props) => {
+        this.identify = (...props) => __awaiter(this, void 0, void 0, function* () {
+            // Wait for CDP to be ready before sending identify events
+            if (this.cdpReadyPromise) {
+                yield this.cdpReadyPromise;
+            }
             try {
                 const identifyPromises = [];
                 const a = this.ccdp();
@@ -163,11 +215,15 @@ export class ChordAnalytics {
             catch (error) {
                 this.logger(error);
             }
-        };
+        });
         /**
          * Send a `page` event to the CDP.
          */
-        this.page = (props = {}) => {
+        this.page = (props = {}) => __awaiter(this, void 0, void 0, function* () {
+            // Wait for CDP to be ready before sending page events
+            if (this.cdpReadyPromise) {
+                yield this.cdpReadyPromise;
+            }
             try {
                 const pagePromises = [];
                 const a = this.ccdp();
@@ -190,7 +246,7 @@ export class ChordAnalytics {
             catch (error) {
                 this.logger(error);
             }
-        };
+        });
         this.reset = () => {
             try {
                 const resetPromises = [];
@@ -609,12 +665,25 @@ export class ChordAnalytics {
             enableLogging: debug,
             namespace: 'chord',
             stripNull: true,
-            awaitConsent: true,
         };
         this.options = Object.assign(Object.assign({}, defaults), options);
         if (((_b = this.options) === null || _b === void 0 ? void 0 : _b.cdpDomain) && ((_c = this.options) === null || _c === void 0 ? void 0 : _c.cdpWriteKey) && window) {
             window[this.options.namespace] = (window === null || window === void 0 ? void 0 : window[this.options.namespace]) || this;
-            addCdpSnippet(this.options);
+            this.initializeCdp();
         }
     }
+    /**
+     * Initialize CDP snippet and wait for it to be ready
+     */
+    initializeCdp() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                this.cdpReadyPromise = addCdpSnippet(this.options);
+                yield this.cdpReadyPromise;
+            }
+            catch (error) {
+                console.error('CDP initialization failed:', error);
+            }
+        });
+    }
 }

package/dist/setupTests.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/setupTests.js

@@ -0,0 +1,4 @@
+// eslint-disable-next-line import/no-extraneous-dependencies
+import { jest } from '@jest/globals';
+// Make jest available globally
+globalThis.jest = jest;

package/dist/types/client.d.ts

@@ -1,4 +1,4 @@
-import type { AnalyticsSnippet, Analytics, AnalyticsBrowser, Options } from '@segment/analytics-next';
+import type { EventProperties, AnalyticsSnippet, Analytics, AnalyticsBrowser, Options } from '@segment/analytics-next';
 import { ChordAnalyticsFormatters } from './formatters.js';
 export interface ValidateResult {
     success: boolean;
@@ -39,6 +39,7 @@ export interface ChordAnalyticsOptions<T extends ObjectTypes = ObjectTypes> {
     stripNull?: boolean;
     metadata: EventMetadata;
     awaitConsentTimeout?: number;
+    middleware?: Array<() => void>;
 }
 export interface EventMetadata {
     i18n: i18nMetadata;
@@ -74,3 +75,22 @@ export type ChordAnalyticsQueue = {
     page: (...args: any[]) => void;
     reset: (...args: any[]) => void;
 };
+type PageContext = {
+    search: string;
+    searchParams: Record<string, string>;
+};
+type MiddlewarePayload = {
+    obj: {
+        properties?: EventProperties;
+        event: string;
+        context: {
+            page: PageContext;
+        };
+    };
+};
+type MiddlewareArgs = {
+    payload: MiddlewarePayload;
+    next: <T>(arg: T) => T;
+};
+export type AnalyticsMiddleware = (args: MiddlewareArgs) => Partial<EventProperties> | void;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chordcommerce/analytics",
   "description": "Chord Commerce event tracking",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "author": "Chord Commerce <help@chord.co> (https://www.chord.co)",
   "type": "module",
   "main": "dist/index.js",
@@ -18,6 +18,7 @@
     "clean": "rimraf dist",
     "test": "jest",
     "test:watch": "jest --watch",
+    "test:file": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:ci": "yarn test --ci --runInBand --reporters=default --passWithNoTests",
     "zod": "yarn ts-to-zod src/types/typewriter.ts src/validators/tracking-plan.ts && yarn ts-to-zod src/types/objects.ts src/validators/objects.ts"
   },