@grainql/analytics-web 2.5.3 → 2.6.0

package/dist/interaction-tracking.js

@@ -40,7 +40,7 @@ class InteractionTrackingManager {
     attachAllListeners() {
         if (this.isDestroyed)
             return;
-        this.log('Attaching interaction listeners for', this.interactions.length, 'interactions');
+        this.log('Attaching interaction listeners');
         for (const interaction of this.interactions) {
             this.attachInteractionListener(interaction);
         }
@@ -73,7 +73,6 @@ class InteractionTrackingManager {
             handlers.push({ event: 'focus', handler: focusHandler });
         }
         this.attachedListeners.set(element, handlers);
-        this.log('Attached listeners to element for:', interaction.eventName);
     }
     /**
      * Handle click event on interaction
@@ -98,21 +97,15 @@ class InteractionTrackingManager {
             ...(isNavigationLink && { href: element.href }),
             timestamp: Date.now(),
         };
-        // If it's a navigation link, flush immediately to ensure event is sent before navigation
-        if (isNavigationLink) {
-            // Use flush option to send immediately - handle promise if returned
-            const result = this.tracker.track(interaction.eventName, eventProperties, { flush: true });
-            if (result instanceof Promise) {
-                result.catch((error) => {
-                    // Log error but don't block navigation
-                    this.log('Failed to track navigation click:', error);
-                });
-            }
-        }
-        else {
-            this.tracker.track(interaction.eventName, eventProperties);
+        // Always use flush for auto-tracked clicks to ensure delivery
+        // This is especially important for navigation links and quick interactions
+        const result = this.tracker.track(interaction.eventName, eventProperties, { flush: true });
+        if (result instanceof Promise) {
+            result.catch((error) => {
+                // Log error but don't block interaction
+                this.log('Failed to track click:', error);
+            });
         }
-        this.log('Tracked click interaction:', interaction.eventName);
     }
     /**
      * Handle focus event on interaction (for form fields)
@@ -133,7 +126,6 @@ class InteractionTrackingManager {
             element_class: element.className || undefined,
             timestamp: Date.now(),
         });
-        this.log('Tracked focus interaction:', interaction.eventName);
     }
     /**
      * Find element by XPath selector
@@ -233,7 +225,6 @@ class InteractionTrackingManager {
             element.removeEventListener(event, handler);
         });
         this.attachedListeners.delete(element);
-        this.log('Detached listeners from element');
     }
     /**
      * Log debug messages

package/dist/page-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-tracking.d.ts","sourceRoot":"","sources":["../src/page-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB;IAY5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc,CAGpB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgHxB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,KAAK;IAUb;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAyCnE;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAyBhB"}
+{"version":3,"file":"page-tracking.d.ts","sourceRoot":"","sources":["../src/page-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB;IAY5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc,CAGpB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4GxB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,KAAK;IAUb;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqCnE;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAqBhB"}

package/dist/page-tracking.js

@@ -159,9 +159,6 @@ class PageTrackingManager {
         }
         // Track the page view event
         this.tracker.trackSystemEvent('page_view', properties);
-        if (this.config.debug) {
-            console.log('[Page Tracking] Tracked page view:', properties);
-        }
     }
     /**
      * Extract domain from URL
@@ -293,9 +290,6 @@ class PageTrackingManager {
             }
         }
         this.tracker.trackSystemEvent('page_view', baseProperties);
-        if (this.config.debug) {
-            console.log('[Page Tracking] Manually tracked page:', baseProperties);
-        }
     }
     /**
      * Get page view count for current session
@@ -324,9 +318,6 @@ class PageTrackingManager {
             window.removeEventListener('hashchange', this.handleHashChange);
         }
         this.isDestroyed = true;
-        if (this.config.debug) {
-            console.log('[Page Tracking] Destroyed');
-        }
     }
 }
 exports.PageTrackingManager = PageTrackingManager;

package/dist/section-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section-tracking.d.ts","sourceRoot":"","sources":["../src/section-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAmB,sBAAsB,EAAwB,MAAM,uBAAuB,CAAC;AAE1H,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IACxE,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/B;AAWD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,UAAU,CAA0C;IAG5D,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,mBAAmB,CAAuB;IAGlD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,UAAU,CAAuB;IAGzC,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAGrC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAgB/C;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2D7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IAsB/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAsChB"}
+{"version":3,"file":"section-tracking.d.ts","sourceRoot":"","sources":["../src/section-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAmB,sBAAsB,EAAwB,MAAM,uBAAuB,CAAC;AAE1H,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IACxE,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/B;AAWD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,UAAU,CAA0C;IAG5D,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,mBAAmB,CAAuB;IAGlD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,UAAU,CAAuB;IAGzC,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAGrC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAgB/C;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IAsB/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAsChB"}

package/dist/section-tracking.js

@@ -50,7 +50,7 @@ class SectionTrackingManager {
     initialize() {
         if (this.isDestroyed)
             return;
-        this.log('Initializing section tracking for', this.sections.length, 'sections');
+        this.log('Initializing section tracking');
         // Setup intersection observer
         this.setupIntersectionObserver();
         // Setup scroll listener for velocity tracking
@@ -122,7 +122,6 @@ class SectionTrackingManager {
             if (this.intersectionObserver) {
                 this.intersectionObserver.observe(element);
             }
-            this.log('Section initialized and observed:', section.sectionName);
         }
     }
     /**
@@ -156,7 +155,6 @@ class SectionTrackingManager {
      * Handle section entry (became visible)
      */
     handleSectionEntry(state) {
-        this.log('Section entered view:', state.config.sectionName);
         state.entryTime = Date.now();
         state.entryScrollSpeed = this.scrollVelocity;
         state.lastScrollPosition = window.scrollY;
@@ -210,7 +208,6 @@ class SectionTrackingManager {
                         exit_timestamp: viewData.exitTime,
                         is_split: true, // Flag to indicate this is a periodic split, not final exit
                     });
-                    this.log('Tracked periodic section view split:', state.config.sectionName, 'duration:', duration);
                     // Reset entry time for next split (but keep tracking)
                     state.entryTime = now;
                     state.entryScrollSpeed = this.scrollVelocity;
@@ -233,7 +230,6 @@ class SectionTrackingManager {
      * Handle section exit (became invisible)
      */
     handleSectionExit(state) {
-        this.log('Section exited view:', state.config.sectionName);
         // Stop periodic tracking
         this.stopPeriodicTracking(state.config.sectionName);
         if (state.entryTime === null)
@@ -318,7 +314,6 @@ class SectionTrackingManager {
      */
     queueSectionView(viewData) {
         this.pendingEvents.push(viewData);
-        this.log('Queued section view:', viewData.sectionName, 'duration:', viewData.duration);
         // Setup batch timer if not already set
         if (this.batchTimer === null) {
             this.batchTimer = window.setTimeout(() => {
@@ -336,7 +331,6 @@ class SectionTrackingManager {
             this.pendingEvents = [];
             return;
         }
-        this.log('Flushing', this.pendingEvents.length, 'section view events');
         // Track each section view
         for (const viewData of this.pendingEvents) {
             this.tracker.trackSystemEvent('_grain_section_view', {

package/dist/types/heatmap-tracking.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Type definitions for Heatmap Tracking
+ */
+export interface HeatmapClickData {
+    pageUrl: string;
+    xpath: string;
+    viewportX: number;
+    viewportY: number;
+    pageX: number;
+    pageY: number;
+    elementTag: string;
+    elementText?: string;
+    timestamp: number;
+}
+export interface HeatmapScrollData {
+    pageUrl: string;
+    viewportSection: number;
+    scrollDepthPx: number;
+    durationMs: number;
+    entryTimestamp: number;
+    exitTimestamp: number;
+    pageHeight: number;
+    viewportHeight: number;
+}
+export interface HeatmapTrackingOptions {
+    scrollDebounceDelay: number;
+    batchDelay: number;
+    maxBatchSize: number;
+    debug?: boolean;
+}
+export interface HeatmapScrollState {
+    viewportSection: number;
+    entryTime: number;
+    scrollDepthPx: number;
+}
+export interface HeatmapTrackingState {
+    currentScrollState: HeatmapScrollState | null;
+    pendingClicks: HeatmapClickData[];
+    pendingScrolls: HeatmapScrollData[];
+}
+//# sourceMappingURL=heatmap-tracking.d.ts.map

package/dist/types/heatmap-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap-tracking.d.ts","sourceRoot":"","sources":["../../src/types/heatmap-tracking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,cAAc,EAAE,iBAAiB,EAAE,CAAC;CACrC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "2.5.3",
+  "version": "2.6.0",
   "description": "Lightweight TypeScript SDK for sending analytics events and managing remote configurations via Grain's REST API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",