cryptique-sdk 1.2.16 → 1.2.17

package/lib/cjs/index.js

@@ -92,8 +92,8 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
     // Geolocation API
     GEOLOCATION: {
-      PRIMARY_URL: "https://ipinfo.io/json?token=73937f74acc045",
-      BACKUP_URL: "https://ipinfo.io/json?token=73937f74acc045&http=1.1",
+      PRIMARY_URL: "https://ipinfo.io/json?token=8fc6409059aa39",
+      BACKUP_URL: "https://ipinfo.io/json?token=8fc6409059aa39&http=1.1",
       TIMEOUT_MS: 5000                                  // 5 second timeout
     },
 
@@ -4999,19 +4999,26 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     startCopyPasteTracking() {
       try {
         document.addEventListener('copy', (event) => {
+          const sel = window.getSelection();
           const copyData = {
             type: 'copy_action',
-            selectedText: window.getSelection().toString().substring(0, 100),
+            selectedText: sel ? sel.toString().substring(0, 100) : '',
             target: {
               tagName: event.target?.tagName || '',
               id: event.target?.id || ''
             },
             path: window.location.pathname
           };
-          
           InteractionManager.add('copyPasteEvents', copyData);
+          // Fire structured auto-event (low volume — only when user explicitly copies)
+          EventsManager.trackAutoEvent('copy_action', {
+            text_length: sel ? sel.toString().length : 0,
+            element_id:  event.target?.id    || '',
+            element_tag: event.target?.tagName?.toLowerCase() || '',
+            element_class: (event.target?.className || '').split(' ').filter(Boolean).slice(0, 3).join(' '),
+          });
         });
-        
+
         document.addEventListener('paste', (event) => {
           const pasteData = {
             type: 'paste_action',
@@ -5021,7 +5028,6 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             },
             path: window.location.pathname
           };
-          
           InteractionManager.add('copyPasteEvents', pasteData);
         });
       } catch (error) {
@@ -5047,8 +5053,15 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             },
             path: window.location.pathname
           };
-          
           InteractionManager.add('contextMenuEvents', contextData);
+          // Fire structured auto-event (low volume — only when user right-clicks)
+          EventsManager.trackAutoEvent('context_menu', {
+            element_tag:   event.target?.tagName?.toLowerCase() || '',
+            element_id:    event.target?.id    || '',
+            element_class: (event.target?.className || '').split(' ').filter(Boolean).slice(0, 3).join(' '),
+            page_x:        event.pageX,
+            page_y:        event.pageY,
+          });
         });
       } catch (error) {
         }
@@ -5576,6 +5589,167 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         }
     },
 
+    /**
+     * PageSummaryTracker — collects high-frequency signals in-memory and flushes
+     * them as a single 'page_summary' auto-event on page unload.
+     *
+     * This keeps event counts low (1 per page visit) while capturing:
+     *  - Mouse movement grid (move_grid)
+     *  - Hover dwell grid    (hover_grid)
+     *  - Tab-switch count and hidden time
+     *  - Scroll reversal count
+     *  - Per-field focus dwell times
+     */
+    startPageSummaryTracking() {
+      try {
+        const GRID_SIZE = 40;
+        // In-memory accumulators — never sent to the server individually
+        const moveGrid  = new Map(); // cellKey → move count
+        const hoverGrid = new Map(); // cellKey → total dwell_ms
+        const fieldDwells = [];      // [{field_id, field_label, field_type, dwell_ms, was_filled}]
+
+        let tabSwitches      = 0;
+        let totalTabHiddenMs = 0;
+        let tabHiddenTime    = null;
+        let scrollReversals  = 0;
+
+        // Track last significant scroll position for reversal detection
+        let lastSigScrollY  = window.scrollY;
+        let lastSigDir      = 0; // 1=down, -1=up
+
+        function getGridCell(pageX, pageY) {
+          const docW = Math.max(1, document.documentElement.scrollWidth || document.body.scrollWidth || window.innerWidth);
+          const docH = Math.max(1, document.documentElement.scrollHeight || document.body.scrollHeight || window.innerHeight);
+          const col  = Math.min(GRID_SIZE - 1, Math.max(0, Math.floor((pageX / docW) * GRID_SIZE)));
+          const row  = Math.min(GRID_SIZE - 1, Math.max(0, Math.floor((pageY / docH) * GRID_SIZE)));
+          return col * GRID_SIZE + row;
+        }
+
+        // ── Mouse movement → move_grid (throttled to max 1 sample / 100 ms)
+        let moveThrottle = false;
+        document.addEventListener('mousemove', (e) => {
+          if (moveThrottle) return;
+          moveThrottle = true;
+          setTimeout(() => { moveThrottle = false; }, 100);
+          const key = getGridCell(e.pageX, e.pageY);
+          moveGrid.set(key, (moveGrid.get(key) || 0) + 1);
+        }, { passive: true });
+
+        // ── Hover dwell → hover_grid (track all elements, filter < 100 ms)
+        const hoverStarts = new Map(); // element → enterTime
+        document.addEventListener('mouseover', (e) => {
+          if (e.target && e.target !== document.documentElement) {
+            hoverStarts.set(e.target, Date.now());
+          }
+        }, { passive: true });
+        document.addEventListener('mouseout', (e) => {
+          const target = e.target;
+          if (!target || !hoverStarts.has(target)) return;
+          const dwell = Date.now() - hoverStarts.get(target);
+          hoverStarts.delete(target);
+          if (dwell < 100) return; // skip accidental hovers
+          try {
+            const rect = target.getBoundingClientRect();
+            const cx   = rect.left + rect.width  / 2 + window.scrollX;
+            const cy   = rect.top  + rect.height / 2 + window.scrollY;
+            const key  = getGridCell(cx, cy);
+            hoverGrid.set(key, (hoverGrid.get(key) || 0) + dwell);
+          } catch (_) {}
+        }, { passive: true });
+
+        // ── Tab visibility → tab_switches + total_tab_hidden_ms
+        document.addEventListener('visibilitychange', () => {
+          if (document.hidden) {
+            tabHiddenTime = Date.now();
+            tabSwitches++;
+          } else if (tabHiddenTime !== null) {
+            totalTabHiddenMs += Date.now() - tabHiddenTime;
+            tabHiddenTime = null;
+          }
+        });
+
+        // ── Scroll reversal detection (direction change > 200 px)
+        window.addEventListener('scroll', () => {
+          const curr = window.scrollY;
+          const diff = curr - lastSigScrollY;
+          if (Math.abs(diff) < 50) return; // ignore tiny movements
+          const dir  = diff > 0 ? 1 : -1;
+          if (lastSigDir !== 0 && dir !== lastSigDir && Math.abs(curr - lastSigScrollY) >= 200) {
+            scrollReversals++;
+          }
+          if (Math.abs(diff) >= 50) { lastSigDir = dir; lastSigScrollY = curr; }
+        }, { passive: true });
+
+        // ── Field dwell → per-field focus duration (no content captured)
+        const fieldFocusTimes = new Map();
+        document.addEventListener('focus', (e) => {
+          const t = e.target;
+          if (!t || !['INPUT', 'SELECT', 'TEXTAREA'].includes(t.tagName)) return;
+          if (t.type === 'hidden') return;
+          fieldFocusTimes.set(t, Date.now());
+        }, true);
+        document.addEventListener('blur', (e) => {
+          const t = e.target;
+          if (!t || !fieldFocusTimes.has(t)) return;
+          const dwell = Date.now() - fieldFocusTimes.get(t);
+          fieldFocusTimes.delete(t);
+          if (dwell < 100) return; // skip accidental focus
+          const label = t.id
+            ? (document.querySelector(`label[for="${CSS.escape(t.id)}"]`)?.textContent?.trim() || t.placeholder || t.name || t.id)
+            : (t.placeholder || t.name || t.type || '');
+          fieldDwells.push({
+            field_id:    (t.id || t.name || t.type || '').substring(0, 100),
+            field_label: (label || '').substring(0, 100),
+            field_type:  t.type || t.tagName.toLowerCase(),
+            dwell_ms:    dwell,
+            was_filled:  !!(t.value && t.value.length > 0),
+          });
+        }, true);
+
+        // ── Serialise grid Map to [[col, row, value], ...] sparse array
+        function serializeGrid(grid) {
+          const out = [];
+          grid.forEach((val, key) => {
+            if (val > 0) {
+              const col = Math.floor(key / GRID_SIZE);
+              const row = key % GRID_SIZE;
+              out.push([col, row, Math.round(val)]);
+            }
+          });
+          return out;
+        }
+
+        let summarySent = false;
+        function firePageSummary() {
+          if (summarySent) return; // only fire once per page lifecycle
+          if (moveGrid.size === 0 && hoverGrid.size === 0 && fieldDwells.length === 0
+              && tabSwitches === 0 && scrollReversals === 0) return;
+          summarySent = true;
+          try {
+            EventsManager.trackAutoEvent('page_summary', {
+              scroll_reversals:  scrollReversals,
+              tab_switches:      tabSwitches,
+              total_tab_hidden_ms: totalTabHiddenMs,
+              move_grid:  serializeGrid(moveGrid),
+              hover_grid: serializeGrid(hoverGrid),
+              field_dwells: fieldDwells,
+              document_height: document.documentElement.scrollHeight || document.body.scrollHeight || 0,
+              document_width:  document.documentElement.scrollWidth  || document.body.scrollWidth  || 0,
+              viewport_width:  window.innerWidth,
+              viewport_height: window.innerHeight,
+            });
+          } catch (_) {}
+        }
+
+        // Fire on hard navigation / tab close (pagehide is more reliable than beforeunload)
+        window.addEventListener('pagehide', firePageSummary);
+        // Also fire when tab becomes hidden (covers SPA navigation that doesn't fire pagehide)
+        document.addEventListener('visibilitychange', () => {
+          if (document.hidden) firePageSummary();
+        });
+      } catch (error) {}
+    },
+
     /**
      * Initialize all event trackers
      *
@@ -5599,6 +5773,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       this.startAdvancedFormTracking();
       this.startFormAbandonmentTracking();
       this.startElementVisibilityTracking();
+      this.startPageSummaryTracking();
     }
   };
 
@@ -6427,7 +6602,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         // Performance
         'page_performance': 'performance',
         // Visibility
-        'element_view': 'visibility'
+        'element_view': 'visibility',
+        // Page summary (aggregate)
+        'page_summary': 'interaction',
+        // Clipboard & context
+        'copy_action':  'interaction',
+        'context_menu': 'interaction',
       };
 
       return categoryMap[eventName] || 'other';
@@ -8224,6 +8404,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
  * The script.js file is inlined during the build process by Rollup.
  */
 
+
 // Create a wrapper that provides programmatic initialization
 const CryptiqueSDK = {
   /**

package/lib/esm/index.js

@@ -90,8 +90,8 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
     // Geolocation API
     GEOLOCATION: {
-      PRIMARY_URL: "https://ipinfo.io/json?token=73937f74acc045",
-      BACKUP_URL: "https://ipinfo.io/json?token=73937f74acc045&http=1.1",
+      PRIMARY_URL: "https://ipinfo.io/json?token=8fc6409059aa39",
+      BACKUP_URL: "https://ipinfo.io/json?token=8fc6409059aa39&http=1.1",
       TIMEOUT_MS: 5000                                  // 5 second timeout
     },
 
@@ -4997,19 +4997,26 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     startCopyPasteTracking() {
       try {
         document.addEventListener('copy', (event) => {
+          const sel = window.getSelection();
           const copyData = {
             type: 'copy_action',
-            selectedText: window.getSelection().toString().substring(0, 100),
+            selectedText: sel ? sel.toString().substring(0, 100) : '',
             target: {
               tagName: event.target?.tagName || '',
               id: event.target?.id || ''
             },
             path: window.location.pathname
           };
-          
           InteractionManager.add('copyPasteEvents', copyData);
+          // Fire structured auto-event (low volume — only when user explicitly copies)
+          EventsManager.trackAutoEvent('copy_action', {
+            text_length: sel ? sel.toString().length : 0,
+            element_id:  event.target?.id    || '',
+            element_tag: event.target?.tagName?.toLowerCase() || '',
+            element_class: (event.target?.className || '').split(' ').filter(Boolean).slice(0, 3).join(' '),
+          });
         });
-        
+
         document.addEventListener('paste', (event) => {
           const pasteData = {
             type: 'paste_action',
@@ -5019,7 +5026,6 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             },
             path: window.location.pathname
           };
-          
           InteractionManager.add('copyPasteEvents', pasteData);
         });
       } catch (error) {
@@ -5045,8 +5051,15 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             },
             path: window.location.pathname
           };
-          
           InteractionManager.add('contextMenuEvents', contextData);
+          // Fire structured auto-event (low volume — only when user right-clicks)
+          EventsManager.trackAutoEvent('context_menu', {
+            element_tag:   event.target?.tagName?.toLowerCase() || '',
+            element_id:    event.target?.id    || '',
+            element_class: (event.target?.className || '').split(' ').filter(Boolean).slice(0, 3).join(' '),
+            page_x:        event.pageX,
+            page_y:        event.pageY,
+          });
         });
       } catch (error) {
         }
@@ -5574,6 +5587,167 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         }
     },
 
+    /**
+     * PageSummaryTracker — collects high-frequency signals in-memory and flushes
+     * them as a single 'page_summary' auto-event on page unload.
+     *
+     * This keeps event counts low (1 per page visit) while capturing:
+     *  - Mouse movement grid (move_grid)
+     *  - Hover dwell grid    (hover_grid)
+     *  - Tab-switch count and hidden time
+     *  - Scroll reversal count
+     *  - Per-field focus dwell times
+     */
+    startPageSummaryTracking() {
+      try {
+        const GRID_SIZE = 40;
+        // In-memory accumulators — never sent to the server individually
+        const moveGrid  = new Map(); // cellKey → move count
+        const hoverGrid = new Map(); // cellKey → total dwell_ms
+        const fieldDwells = [];      // [{field_id, field_label, field_type, dwell_ms, was_filled}]
+
+        let tabSwitches      = 0;
+        let totalTabHiddenMs = 0;
+        let tabHiddenTime    = null;
+        let scrollReversals  = 0;
+
+        // Track last significant scroll position for reversal detection
+        let lastSigScrollY  = window.scrollY;
+        let lastSigDir      = 0; // 1=down, -1=up
+
+        function getGridCell(pageX, pageY) {
+          const docW = Math.max(1, document.documentElement.scrollWidth || document.body.scrollWidth || window.innerWidth);
+          const docH = Math.max(1, document.documentElement.scrollHeight || document.body.scrollHeight || window.innerHeight);
+          const col  = Math.min(GRID_SIZE - 1, Math.max(0, Math.floor((pageX / docW) * GRID_SIZE)));
+          const row  = Math.min(GRID_SIZE - 1, Math.max(0, Math.floor((pageY / docH) * GRID_SIZE)));
+          return col * GRID_SIZE + row;
+        }
+
+        // ── Mouse movement → move_grid (throttled to max 1 sample / 100 ms)
+        let moveThrottle = false;
+        document.addEventListener('mousemove', (e) => {
+          if (moveThrottle) return;
+          moveThrottle = true;
+          setTimeout(() => { moveThrottle = false; }, 100);
+          const key = getGridCell(e.pageX, e.pageY);
+          moveGrid.set(key, (moveGrid.get(key) || 0) + 1);
+        }, { passive: true });
+
+        // ── Hover dwell → hover_grid (track all elements, filter < 100 ms)
+        const hoverStarts = new Map(); // element → enterTime
+        document.addEventListener('mouseover', (e) => {
+          if (e.target && e.target !== document.documentElement) {
+            hoverStarts.set(e.target, Date.now());
+          }
+        }, { passive: true });
+        document.addEventListener('mouseout', (e) => {
+          const target = e.target;
+          if (!target || !hoverStarts.has(target)) return;
+          const dwell = Date.now() - hoverStarts.get(target);
+          hoverStarts.delete(target);
+          if (dwell < 100) return; // skip accidental hovers
+          try {
+            const rect = target.getBoundingClientRect();
+            const cx   = rect.left + rect.width  / 2 + window.scrollX;
+            const cy   = rect.top  + rect.height / 2 + window.scrollY;
+            const key  = getGridCell(cx, cy);
+            hoverGrid.set(key, (hoverGrid.get(key) || 0) + dwell);
+          } catch (_) {}
+        }, { passive: true });
+
+        // ── Tab visibility → tab_switches + total_tab_hidden_ms
+        document.addEventListener('visibilitychange', () => {
+          if (document.hidden) {
+            tabHiddenTime = Date.now();
+            tabSwitches++;
+          } else if (tabHiddenTime !== null) {
+            totalTabHiddenMs += Date.now() - tabHiddenTime;
+            tabHiddenTime = null;
+          }
+        });
+
+        // ── Scroll reversal detection (direction change > 200 px)
+        window.addEventListener('scroll', () => {
+          const curr = window.scrollY;
+          const diff = curr - lastSigScrollY;
+          if (Math.abs(diff) < 50) return; // ignore tiny movements
+          const dir  = diff > 0 ? 1 : -1;
+          if (lastSigDir !== 0 && dir !== lastSigDir && Math.abs(curr - lastSigScrollY) >= 200) {
+            scrollReversals++;
+          }
+          if (Math.abs(diff) >= 50) { lastSigDir = dir; lastSigScrollY = curr; }
+        }, { passive: true });
+
+        // ── Field dwell → per-field focus duration (no content captured)
+        const fieldFocusTimes = new Map();
+        document.addEventListener('focus', (e) => {
+          const t = e.target;
+          if (!t || !['INPUT', 'SELECT', 'TEXTAREA'].includes(t.tagName)) return;
+          if (t.type === 'hidden') return;
+          fieldFocusTimes.set(t, Date.now());
+        }, true);
+        document.addEventListener('blur', (e) => {
+          const t = e.target;
+          if (!t || !fieldFocusTimes.has(t)) return;
+          const dwell = Date.now() - fieldFocusTimes.get(t);
+          fieldFocusTimes.delete(t);
+          if (dwell < 100) return; // skip accidental focus
+          const label = t.id
+            ? (document.querySelector(`label[for="${CSS.escape(t.id)}"]`)?.textContent?.trim() || t.placeholder || t.name || t.id)
+            : (t.placeholder || t.name || t.type || '');
+          fieldDwells.push({
+            field_id:    (t.id || t.name || t.type || '').substring(0, 100),
+            field_label: (label || '').substring(0, 100),
+            field_type:  t.type || t.tagName.toLowerCase(),
+            dwell_ms:    dwell,
+            was_filled:  !!(t.value && t.value.length > 0),
+          });
+        }, true);
+
+        // ── Serialise grid Map to [[col, row, value], ...] sparse array
+        function serializeGrid(grid) {
+          const out = [];
+          grid.forEach((val, key) => {
+            if (val > 0) {
+              const col = Math.floor(key / GRID_SIZE);
+              const row = key % GRID_SIZE;
+              out.push([col, row, Math.round(val)]);
+            }
+          });
+          return out;
+        }
+
+        let summarySent = false;
+        function firePageSummary() {
+          if (summarySent) return; // only fire once per page lifecycle
+          if (moveGrid.size === 0 && hoverGrid.size === 0 && fieldDwells.length === 0
+              && tabSwitches === 0 && scrollReversals === 0) return;
+          summarySent = true;
+          try {
+            EventsManager.trackAutoEvent('page_summary', {
+              scroll_reversals:  scrollReversals,
+              tab_switches:      tabSwitches,
+              total_tab_hidden_ms: totalTabHiddenMs,
+              move_grid:  serializeGrid(moveGrid),
+              hover_grid: serializeGrid(hoverGrid),
+              field_dwells: fieldDwells,
+              document_height: document.documentElement.scrollHeight || document.body.scrollHeight || 0,
+              document_width:  document.documentElement.scrollWidth  || document.body.scrollWidth  || 0,
+              viewport_width:  window.innerWidth,
+              viewport_height: window.innerHeight,
+            });
+          } catch (_) {}
+        }
+
+        // Fire on hard navigation / tab close (pagehide is more reliable than beforeunload)
+        window.addEventListener('pagehide', firePageSummary);
+        // Also fire when tab becomes hidden (covers SPA navigation that doesn't fire pagehide)
+        document.addEventListener('visibilitychange', () => {
+          if (document.hidden) firePageSummary();
+        });
+      } catch (error) {}
+    },
+
     /**
      * Initialize all event trackers
      *
@@ -5597,6 +5771,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       this.startAdvancedFormTracking();
       this.startFormAbandonmentTracking();
       this.startElementVisibilityTracking();
+      this.startPageSummaryTracking();
     }
   };
 
@@ -6425,7 +6600,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         // Performance
         'page_performance': 'performance',
         // Visibility
-        'element_view': 'visibility'
+        'element_view': 'visibility',
+        // Page summary (aggregate)
+        'page_summary': 'interaction',
+        // Clipboard & context
+        'copy_action':  'interaction',
+        'context_menu': 'interaction',
       };
 
       return categoryMap[eventName] || 'other';
@@ -8222,6 +8402,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
  * The script.js file is inlined during the build process by Rollup.
  */
 
+
 // Create a wrapper that provides programmatic initialization
 const CryptiqueSDK = {
   /**

package/lib/umd/index.js

@@ -96,8 +96,8 @@
 
       // Geolocation API
       GEOLOCATION: {
-        PRIMARY_URL: "https://ipinfo.io/json?token=73937f74acc045",
-        BACKUP_URL: "https://ipinfo.io/json?token=73937f74acc045&http=1.1",
+        PRIMARY_URL: "https://ipinfo.io/json?token=8fc6409059aa39",
+        BACKUP_URL: "https://ipinfo.io/json?token=8fc6409059aa39&http=1.1",
         TIMEOUT_MS: 5000                                  // 5 second timeout
       },
 
@@ -5003,19 +5003,26 @@
       startCopyPasteTracking() {
         try {
           document.addEventListener('copy', (event) => {
+            const sel = window.getSelection();
             const copyData = {
               type: 'copy_action',
-              selectedText: window.getSelection().toString().substring(0, 100),
+              selectedText: sel ? sel.toString().substring(0, 100) : '',
               target: {
                 tagName: event.target?.tagName || '',
                 id: event.target?.id || ''
               },
               path: window.location.pathname
             };
-            
             InteractionManager.add('copyPasteEvents', copyData);
+            // Fire structured auto-event (low volume — only when user explicitly copies)
+            EventsManager.trackAutoEvent('copy_action', {
+              text_length: sel ? sel.toString().length : 0,
+              element_id:  event.target?.id    || '',
+              element_tag: event.target?.tagName?.toLowerCase() || '',
+              element_class: (event.target?.className || '').split(' ').filter(Boolean).slice(0, 3).join(' '),
+            });
           });
-          
+
           document.addEventListener('paste', (event) => {
             const pasteData = {
               type: 'paste_action',
@@ -5025,7 +5032,6 @@
               },
               path: window.location.pathname
             };
-            
             InteractionManager.add('copyPasteEvents', pasteData);
           });
         } catch (error) {
@@ -5051,8 +5057,15 @@
               },
               path: window.location.pathname
             };
-            
             InteractionManager.add('contextMenuEvents', contextData);
+            // Fire structured auto-event (low volume — only when user right-clicks)
+            EventsManager.trackAutoEvent('context_menu', {
+              element_tag:   event.target?.tagName?.toLowerCase() || '',
+              element_id:    event.target?.id    || '',
+              element_class: (event.target?.className || '').split(' ').filter(Boolean).slice(0, 3).join(' '),
+              page_x:        event.pageX,
+              page_y:        event.pageY,
+            });
           });
         } catch (error) {
           }
@@ -5580,6 +5593,167 @@
           }
       },
 
+      /**
+       * PageSummaryTracker — collects high-frequency signals in-memory and flushes
+       * them as a single 'page_summary' auto-event on page unload.
+       *
+       * This keeps event counts low (1 per page visit) while capturing:
+       *  - Mouse movement grid (move_grid)
+       *  - Hover dwell grid    (hover_grid)
+       *  - Tab-switch count and hidden time
+       *  - Scroll reversal count
+       *  - Per-field focus dwell times
+       */
+      startPageSummaryTracking() {
+        try {
+          const GRID_SIZE = 40;
+          // In-memory accumulators — never sent to the server individually
+          const moveGrid  = new Map(); // cellKey → move count
+          const hoverGrid = new Map(); // cellKey → total dwell_ms
+          const fieldDwells = [];      // [{field_id, field_label, field_type, dwell_ms, was_filled}]
+
+          let tabSwitches      = 0;
+          let totalTabHiddenMs = 0;
+          let tabHiddenTime    = null;
+          let scrollReversals  = 0;
+
+          // Track last significant scroll position for reversal detection
+          let lastSigScrollY  = window.scrollY;
+          let lastSigDir      = 0; // 1=down, -1=up
+
+          function getGridCell(pageX, pageY) {
+            const docW = Math.max(1, document.documentElement.scrollWidth || document.body.scrollWidth || window.innerWidth);
+            const docH = Math.max(1, document.documentElement.scrollHeight || document.body.scrollHeight || window.innerHeight);
+            const col  = Math.min(GRID_SIZE - 1, Math.max(0, Math.floor((pageX / docW) * GRID_SIZE)));
+            const row  = Math.min(GRID_SIZE - 1, Math.max(0, Math.floor((pageY / docH) * GRID_SIZE)));
+            return col * GRID_SIZE + row;
+          }
+
+          // ── Mouse movement → move_grid (throttled to max 1 sample / 100 ms)
+          let moveThrottle = false;
+          document.addEventListener('mousemove', (e) => {
+            if (moveThrottle) return;
+            moveThrottle = true;
+            setTimeout(() => { moveThrottle = false; }, 100);
+            const key = getGridCell(e.pageX, e.pageY);
+            moveGrid.set(key, (moveGrid.get(key) || 0) + 1);
+          }, { passive: true });
+
+          // ── Hover dwell → hover_grid (track all elements, filter < 100 ms)
+          const hoverStarts = new Map(); // element → enterTime
+          document.addEventListener('mouseover', (e) => {
+            if (e.target && e.target !== document.documentElement) {
+              hoverStarts.set(e.target, Date.now());
+            }
+          }, { passive: true });
+          document.addEventListener('mouseout', (e) => {
+            const target = e.target;
+            if (!target || !hoverStarts.has(target)) return;
+            const dwell = Date.now() - hoverStarts.get(target);
+            hoverStarts.delete(target);
+            if (dwell < 100) return; // skip accidental hovers
+            try {
+              const rect = target.getBoundingClientRect();
+              const cx   = rect.left + rect.width  / 2 + window.scrollX;
+              const cy   = rect.top  + rect.height / 2 + window.scrollY;
+              const key  = getGridCell(cx, cy);
+              hoverGrid.set(key, (hoverGrid.get(key) || 0) + dwell);
+            } catch (_) {}
+          }, { passive: true });
+
+          // ── Tab visibility → tab_switches + total_tab_hidden_ms
+          document.addEventListener('visibilitychange', () => {
+            if (document.hidden) {
+              tabHiddenTime = Date.now();
+              tabSwitches++;
+            } else if (tabHiddenTime !== null) {
+              totalTabHiddenMs += Date.now() - tabHiddenTime;
+              tabHiddenTime = null;
+            }
+          });
+
+          // ── Scroll reversal detection (direction change > 200 px)
+          window.addEventListener('scroll', () => {
+            const curr = window.scrollY;
+            const diff = curr - lastSigScrollY;
+            if (Math.abs(diff) < 50) return; // ignore tiny movements
+            const dir  = diff > 0 ? 1 : -1;
+            if (lastSigDir !== 0 && dir !== lastSigDir && Math.abs(curr - lastSigScrollY) >= 200) {
+              scrollReversals++;
+            }
+            if (Math.abs(diff) >= 50) { lastSigDir = dir; lastSigScrollY = curr; }
+          }, { passive: true });
+
+          // ── Field dwell → per-field focus duration (no content captured)
+          const fieldFocusTimes = new Map();
+          document.addEventListener('focus', (e) => {
+            const t = e.target;
+            if (!t || !['INPUT', 'SELECT', 'TEXTAREA'].includes(t.tagName)) return;
+            if (t.type === 'hidden') return;
+            fieldFocusTimes.set(t, Date.now());
+          }, true);
+          document.addEventListener('blur', (e) => {
+            const t = e.target;
+            if (!t || !fieldFocusTimes.has(t)) return;
+            const dwell = Date.now() - fieldFocusTimes.get(t);
+            fieldFocusTimes.delete(t);
+            if (dwell < 100) return; // skip accidental focus
+            const label = t.id
+              ? (document.querySelector(`label[for="${CSS.escape(t.id)}"]`)?.textContent?.trim() || t.placeholder || t.name || t.id)
+              : (t.placeholder || t.name || t.type || '');
+            fieldDwells.push({
+              field_id:    (t.id || t.name || t.type || '').substring(0, 100),
+              field_label: (label || '').substring(0, 100),
+              field_type:  t.type || t.tagName.toLowerCase(),
+              dwell_ms:    dwell,
+              was_filled:  !!(t.value && t.value.length > 0),
+            });
+          }, true);
+
+          // ── Serialise grid Map to [[col, row, value], ...] sparse array
+          function serializeGrid(grid) {
+            const out = [];
+            grid.forEach((val, key) => {
+              if (val > 0) {
+                const col = Math.floor(key / GRID_SIZE);
+                const row = key % GRID_SIZE;
+                out.push([col, row, Math.round(val)]);
+              }
+            });
+            return out;
+          }
+
+          let summarySent = false;
+          function firePageSummary() {
+            if (summarySent) return; // only fire once per page lifecycle
+            if (moveGrid.size === 0 && hoverGrid.size === 0 && fieldDwells.length === 0
+                && tabSwitches === 0 && scrollReversals === 0) return;
+            summarySent = true;
+            try {
+              EventsManager.trackAutoEvent('page_summary', {
+                scroll_reversals:  scrollReversals,
+                tab_switches:      tabSwitches,
+                total_tab_hidden_ms: totalTabHiddenMs,
+                move_grid:  serializeGrid(moveGrid),
+                hover_grid: serializeGrid(hoverGrid),
+                field_dwells: fieldDwells,
+                document_height: document.documentElement.scrollHeight || document.body.scrollHeight || 0,
+                document_width:  document.documentElement.scrollWidth  || document.body.scrollWidth  || 0,
+                viewport_width:  window.innerWidth,
+                viewport_height: window.innerHeight,
+              });
+            } catch (_) {}
+          }
+
+          // Fire on hard navigation / tab close (pagehide is more reliable than beforeunload)
+          window.addEventListener('pagehide', firePageSummary);
+          // Also fire when tab becomes hidden (covers SPA navigation that doesn't fire pagehide)
+          document.addEventListener('visibilitychange', () => {
+            if (document.hidden) firePageSummary();
+          });
+        } catch (error) {}
+      },
+
       /**
        * Initialize all event trackers
        *
@@ -5603,6 +5777,7 @@
         this.startAdvancedFormTracking();
         this.startFormAbandonmentTracking();
         this.startElementVisibilityTracking();
+        this.startPageSummaryTracking();
       }
     };
 
@@ -6431,7 +6606,12 @@
           // Performance
           'page_performance': 'performance',
           // Visibility
-          'element_view': 'visibility'
+          'element_view': 'visibility',
+          // Page summary (aggregate)
+          'page_summary': 'interaction',
+          // Clipboard & context
+          'copy_action':  'interaction',
+          'context_menu': 'interaction',
         };
 
         return categoryMap[eventName] || 'other';
@@ -8228,6 +8408,7 @@
    * The script.js file is inlined during the build process by Rollup.
    */
 
+
   // Create a wrapper that provides programmatic initialization
   const CryptiqueSDK = {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cryptique-sdk",
-  "version": "1.2.16",
+  "version": "1.2.17",
   "type": "module",
   "description": "Cryptique Analytics SDK - Comprehensive web analytics and user tracking for modern web applications",
   "main": "lib/cjs/index.js",