cryptique-sdk 1.1.6 → 1.1.8

package/lib/cjs/index.js

@@ -164,6 +164,21 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     eip6963Providers: []            // EIP-6963 discovered wallet providers
   };
 
+  // Ready promise - resolves when SDK is fully initialized (allows consumers to await init)
+  let _readyPromiseResolve;
+  const _readyPromise = new Promise((resolve) => {
+    _readyPromiseResolve = resolve;
+  });
+
+  // Helper to wait for SDK ready with timeout (avoids hanging if init fails)
+  const _waitForReady = (timeoutMs = 5000) => {
+    if (runtimeState.isInitialized) return Promise.resolve();
+    return Promise.race([
+      _readyPromise,
+      new Promise((_, reject) => setTimeout(() => reject(new Error('SDK init timeout')), timeoutMs))
+    ]);
+  };
+
   // Initialize EIP-6963 wallet provider detection (if enabled)
   {
     // Listen for providers being announced
@@ -4299,6 +4314,10 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
   // - Proper use of sendBeacon vs fetch
   // ============================================================================
 
+  // Throttle network error logs (e.g. "Failed to fetch" from ad blockers) - log at most once per 30s
+  let _lastNetworkErrorLog = 0;
+  const _NETWORK_ERROR_THROTTLE_MS = 30000;
+
   /**
    * APIClient - Unified API communication
    * 
@@ -4479,8 +4498,14 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           // Don't retry aborted requests - they were intentionally cancelled
           return; // Silently return, don't throw
         }
-        
-        console.error('❌ Error sending data:', error);
+
+        // Throttle "Failed to fetch" logs (common with ad blockers, CORS, network issues)
+        const isNetworkError = error.name === 'TypeError' && (error.message === 'Failed to fetch' || error.message?.includes('fetch'));
+        const now = Date.now();
+        if (isNetworkError && (now - _lastNetworkErrorLog) < _NETWORK_ERROR_THROTTLE_MS) ; else {
+          if (isNetworkError) _lastNetworkErrorLog = now;
+          console.error('❌ Error sending data:', error);
+        }
         
         // Retry if retries > 0 (but not for abort errors)
         if (retries > 0) {
@@ -5887,6 +5912,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
       } catch (error) {
         console.error('Error initializing Cryptique SDK:', error);
+      } finally {
+        // Always resolve ready promise so awaiters don't hang (even if init failed)
+        if (typeof _readyPromiseResolve === 'function') {
+          _readyPromiseResolve();
+          _readyPromiseResolve = null; // Prevent multiple resolves
+        }
       }
     }
   };
@@ -6099,9 +6130,17 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           }
         }
         
+        // Wait for SDK init if not ready (handles race conditions)
         if (!runtimeState.isInitialized) {
-          console.warn('⚠️ [Events] SDK not initialized, skipping auto event:', eventName);
-          return;
+          try {
+            await _waitForReady();
+          } catch (e) {
+            // Init timeout or failed - silently skip
+            return;
+          }
+          if (!runtimeState.isInitialized) {
+            return;
+          }
         }
 
         // Get session from storage - it returns { id, userId, ... }
@@ -6676,8 +6715,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
     /**
      * Setup auto events tracking
+     * Waits for SDK initialization before proceeding (handles SPA navigation race)
      */
-    setup() {
+    async setup() {
       // Check if auto events are enabled
       if (!CONFIG.AUTO_EVENTS.enabled) {
         return;
@@ -6693,6 +6733,17 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       }
       
       try {
+        // Wait for SDK to be fully initialized (handles SPA nav before init completes)
+        await _waitForReady().catch(() => {
+          // Init failed or timed out - silently skip setup
+          return;
+        });
+        
+        // Double-check after wait (init may have failed)
+        if (!runtimeState.isInitialized) {
+          return;
+        }
+        
         // Track page views
         this.trackPageView();
         
@@ -6852,11 +6903,15 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         const isInteractive = isInteractiveElement(element);
         
         if (!isInteractive) {
-          // Capture coordinates before setTimeout
+          // Capture coordinates and page context before setTimeout (for heatmaps)
           const clickX = event.clientX;
           const clickY = event.clientY;
           const clickElement = element;
-          
+          const scrollX = window.scrollX != null ? window.scrollX : window.pageXOffset;
+          const scrollY = window.scrollY != null ? window.scrollY : window.pageYOffset;
+          const docHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
+          const docWidth = Math.max(document.body.scrollWidth, document.documentElement.scrollWidth);
+
           // Mark this click as potentially dead
           const clickId = `${now}_${Math.random().toString(36).substr(2, 9)}`;
           pendingDeadClicks.set(clickId, {
@@ -6866,7 +6921,13 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             timestamp: now,
             url: window.location.href,
             clickX,
-            clickY
+            clickY,
+            page_x: event.pageX,
+            page_y: event.pageY,
+            scroll_x: scrollX,
+            scroll_y: scrollY,
+            document_height: docHeight,
+            document_width: docWidth
           });
           
           // Check after 1 second if navigation occurred or if it's still a dead click
@@ -6880,6 +6941,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
               
               EventsManager.trackAutoEvent('dead_click', {
                 click_coordinates: { x: pendingClick.clickX, y: pendingClick.clickY },
+                page_x: pendingClick.page_x,
+                page_y: pendingClick.page_y,
+                scroll_x: pendingClick.scroll_x,
+                scroll_y: pendingClick.scroll_y,
+                document_height: pendingClick.document_height,
+                document_width: pendingClick.document_width,
                 element_area: clickElement.offsetWidth * clickElement.offsetHeight,
                 element_category: pendingClick.elementCategory,
                 element_has_onclick: !!clickElement.onclick,
@@ -6895,9 +6962,19 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           }, 1000);
         }
 
-        // Track regular click with enhanced data
+        // Track regular click with enhanced data (viewport + page-relative for heatmaps)
+        const scrollX = window.scrollX != null ? window.scrollX : window.pageXOffset;
+        const scrollY = window.scrollY != null ? window.scrollY : window.pageYOffset;
+        const docHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
+        const docWidth = Math.max(document.body.scrollWidth, document.documentElement.scrollWidth);
         EventsManager.trackAutoEvent('element_click', {
           click_coordinates: { x: event.clientX, y: event.clientY },
+          page_x: event.pageX,
+          page_y: event.pageY,
+          scroll_x: scrollX,
+          scroll_y: scrollY,
+          document_height: docHeight,
+          document_width: docWidth,
           double_click: event.detail === 2,
           element_category: elementCategory
         }, elementData).catch(err => {
@@ -6922,11 +6999,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         clearTimeout(scrollTimeout);
         
         scrollTimeout = setTimeout(() => {
-          const scrollDepth = Math.round((window.scrollY / (document.body.scrollHeight - window.innerHeight)) * 100);
-          
+          const maxScroll = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight) - window.innerHeight;
+          const scrollDepth = maxScroll <= 0 ? 100 : Math.round((window.scrollY / maxScroll) * 100);
+
           if (scrollDepth > maxScrollDepth) {
             maxScrollDepth = scrollDepth;
-            
+
             EventsManager.trackAutoEvent('page_scroll', {
               scroll_depth: scrollDepth,
               max_scroll_reached: maxScrollDepth,
@@ -7675,6 +7753,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     ...window.Cryptique,
     version: CONFIG.VERSION,
     
+    // Wait for SDK to be fully initialized (returns Promise)
+    ready: () => _readyPromise,
+    
     // Events System
     track: EventsManager.trackEvent.bind(EventsManager),
     trackEvent: EventsManager.trackEvent.bind(EventsManager),
@@ -7899,7 +7980,7 @@ const CryptiqueSDK = {
   init(options = {}) {
     if (typeof window === 'undefined') {
       console.warn('Cryptique SDK requires a browser environment');
-      return null;
+      return Promise.resolve(null);
     }
 
     if (!options.siteId) {
@@ -7940,21 +8021,28 @@ const CryptiqueSDK = {
       return null;
     };
 
-    // If SDK is already loaded, configure immediately
+    // If SDK is already loaded, configure and return ready promise
     if (window.Cryptique) {
-      return checkSDK();
+      checkSDK();
+      // Return ready() so await Cryptique.init() waits for full initialization
+      return window.Cryptique.ready ? window.Cryptique.ready() : Promise.resolve(window.Cryptique);
     }
 
-    // Otherwise, wait a bit for it to initialize
+    // Otherwise, wait for SDK to load then configure and wait for ready
     return new Promise((resolve) => {
       const maxAttempts = 50;
       let attempts = 0;
       const interval = setInterval(() => {
         attempts++;
         const sdk = checkSDK();
-        if (sdk || attempts >= maxAttempts) {
+        if (sdk) {
+          clearInterval(interval);
+          // Wait for full initialization
+          const readyPromise = sdk.ready ? sdk.ready() : Promise.resolve(sdk);
+          resolve(readyPromise);
+        } else if (attempts >= maxAttempts) {
           clearInterval(interval);
-          resolve(sdk);
+          resolve(null);
         }
       }, 100);
     });
@@ -7971,6 +8059,19 @@ const CryptiqueSDK = {
     return null;
   },
 
+  /**
+   * Wait for SDK to be fully initialized
+   * Returns a Promise that resolves when initialization is complete
+   * @returns {Promise<void>}
+   */
+  ready() {
+    const instance = this.getInstance();
+    if (instance && instance.ready) {
+      return instance.ready();
+    }
+    return Promise.resolve();
+  },
+
   /**
    * Identify a user with a unique identifier
    * 

package/lib/esm/index.js

@@ -162,6 +162,21 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     eip6963Providers: []            // EIP-6963 discovered wallet providers
   };
 
+  // Ready promise - resolves when SDK is fully initialized (allows consumers to await init)
+  let _readyPromiseResolve;
+  const _readyPromise = new Promise((resolve) => {
+    _readyPromiseResolve = resolve;
+  });
+
+  // Helper to wait for SDK ready with timeout (avoids hanging if init fails)
+  const _waitForReady = (timeoutMs = 5000) => {
+    if (runtimeState.isInitialized) return Promise.resolve();
+    return Promise.race([
+      _readyPromise,
+      new Promise((_, reject) => setTimeout(() => reject(new Error('SDK init timeout')), timeoutMs))
+    ]);
+  };
+
   // Initialize EIP-6963 wallet provider detection (if enabled)
   {
     // Listen for providers being announced
@@ -4297,6 +4312,10 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
   // - Proper use of sendBeacon vs fetch
   // ============================================================================
 
+  // Throttle network error logs (e.g. "Failed to fetch" from ad blockers) - log at most once per 30s
+  let _lastNetworkErrorLog = 0;
+  const _NETWORK_ERROR_THROTTLE_MS = 30000;
+
   /**
    * APIClient - Unified API communication
    * 
@@ -4477,8 +4496,14 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           // Don't retry aborted requests - they were intentionally cancelled
           return; // Silently return, don't throw
         }
-        
-        console.error('❌ Error sending data:', error);
+
+        // Throttle "Failed to fetch" logs (common with ad blockers, CORS, network issues)
+        const isNetworkError = error.name === 'TypeError' && (error.message === 'Failed to fetch' || error.message?.includes('fetch'));
+        const now = Date.now();
+        if (isNetworkError && (now - _lastNetworkErrorLog) < _NETWORK_ERROR_THROTTLE_MS) ; else {
+          if (isNetworkError) _lastNetworkErrorLog = now;
+          console.error('❌ Error sending data:', error);
+        }
         
         // Retry if retries > 0 (but not for abort errors)
         if (retries > 0) {
@@ -5885,6 +5910,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
       } catch (error) {
         console.error('Error initializing Cryptique SDK:', error);
+      } finally {
+        // Always resolve ready promise so awaiters don't hang (even if init failed)
+        if (typeof _readyPromiseResolve === 'function') {
+          _readyPromiseResolve();
+          _readyPromiseResolve = null; // Prevent multiple resolves
+        }
       }
     }
   };
@@ -6097,9 +6128,17 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           }
         }
         
+        // Wait for SDK init if not ready (handles race conditions)
         if (!runtimeState.isInitialized) {
-          console.warn('⚠️ [Events] SDK not initialized, skipping auto event:', eventName);
-          return;
+          try {
+            await _waitForReady();
+          } catch (e) {
+            // Init timeout or failed - silently skip
+            return;
+          }
+          if (!runtimeState.isInitialized) {
+            return;
+          }
         }
 
         // Get session from storage - it returns { id, userId, ... }
@@ -6674,8 +6713,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
     /**
      * Setup auto events tracking
+     * Waits for SDK initialization before proceeding (handles SPA navigation race)
      */
-    setup() {
+    async setup() {
       // Check if auto events are enabled
       if (!CONFIG.AUTO_EVENTS.enabled) {
         return;
@@ -6691,6 +6731,17 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       }
       
       try {
+        // Wait for SDK to be fully initialized (handles SPA nav before init completes)
+        await _waitForReady().catch(() => {
+          // Init failed or timed out - silently skip setup
+          return;
+        });
+        
+        // Double-check after wait (init may have failed)
+        if (!runtimeState.isInitialized) {
+          return;
+        }
+        
         // Track page views
         this.trackPageView();
         
@@ -6850,11 +6901,15 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         const isInteractive = isInteractiveElement(element);
         
         if (!isInteractive) {
-          // Capture coordinates before setTimeout
+          // Capture coordinates and page context before setTimeout (for heatmaps)
           const clickX = event.clientX;
           const clickY = event.clientY;
           const clickElement = element;
-          
+          const scrollX = window.scrollX != null ? window.scrollX : window.pageXOffset;
+          const scrollY = window.scrollY != null ? window.scrollY : window.pageYOffset;
+          const docHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
+          const docWidth = Math.max(document.body.scrollWidth, document.documentElement.scrollWidth);
+
           // Mark this click as potentially dead
           const clickId = `${now}_${Math.random().toString(36).substr(2, 9)}`;
           pendingDeadClicks.set(clickId, {
@@ -6864,7 +6919,13 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             timestamp: now,
             url: window.location.href,
             clickX,
-            clickY
+            clickY,
+            page_x: event.pageX,
+            page_y: event.pageY,
+            scroll_x: scrollX,
+            scroll_y: scrollY,
+            document_height: docHeight,
+            document_width: docWidth
           });
           
           // Check after 1 second if navigation occurred or if it's still a dead click
@@ -6878,6 +6939,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
               
               EventsManager.trackAutoEvent('dead_click', {
                 click_coordinates: { x: pendingClick.clickX, y: pendingClick.clickY },
+                page_x: pendingClick.page_x,
+                page_y: pendingClick.page_y,
+                scroll_x: pendingClick.scroll_x,
+                scroll_y: pendingClick.scroll_y,
+                document_height: pendingClick.document_height,
+                document_width: pendingClick.document_width,
                 element_area: clickElement.offsetWidth * clickElement.offsetHeight,
                 element_category: pendingClick.elementCategory,
                 element_has_onclick: !!clickElement.onclick,
@@ -6893,9 +6960,19 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           }, 1000);
         }
 
-        // Track regular click with enhanced data
+        // Track regular click with enhanced data (viewport + page-relative for heatmaps)
+        const scrollX = window.scrollX != null ? window.scrollX : window.pageXOffset;
+        const scrollY = window.scrollY != null ? window.scrollY : window.pageYOffset;
+        const docHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
+        const docWidth = Math.max(document.body.scrollWidth, document.documentElement.scrollWidth);
         EventsManager.trackAutoEvent('element_click', {
           click_coordinates: { x: event.clientX, y: event.clientY },
+          page_x: event.pageX,
+          page_y: event.pageY,
+          scroll_x: scrollX,
+          scroll_y: scrollY,
+          document_height: docHeight,
+          document_width: docWidth,
           double_click: event.detail === 2,
           element_category: elementCategory
         }, elementData).catch(err => {
@@ -6920,11 +6997,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         clearTimeout(scrollTimeout);
         
         scrollTimeout = setTimeout(() => {
-          const scrollDepth = Math.round((window.scrollY / (document.body.scrollHeight - window.innerHeight)) * 100);
-          
+          const maxScroll = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight) - window.innerHeight;
+          const scrollDepth = maxScroll <= 0 ? 100 : Math.round((window.scrollY / maxScroll) * 100);
+
           if (scrollDepth > maxScrollDepth) {
             maxScrollDepth = scrollDepth;
-            
+
             EventsManager.trackAutoEvent('page_scroll', {
               scroll_depth: scrollDepth,
               max_scroll_reached: maxScrollDepth,
@@ -7673,6 +7751,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     ...window.Cryptique,
     version: CONFIG.VERSION,
     
+    // Wait for SDK to be fully initialized (returns Promise)
+    ready: () => _readyPromise,
+    
     // Events System
     track: EventsManager.trackEvent.bind(EventsManager),
     trackEvent: EventsManager.trackEvent.bind(EventsManager),
@@ -7897,7 +7978,7 @@ const CryptiqueSDK = {
   init(options = {}) {
     if (typeof window === 'undefined') {
       console.warn('Cryptique SDK requires a browser environment');
-      return null;
+      return Promise.resolve(null);
     }
 
     if (!options.siteId) {
@@ -7938,21 +8019,28 @@ const CryptiqueSDK = {
       return null;
     };
 
-    // If SDK is already loaded, configure immediately
+    // If SDK is already loaded, configure and return ready promise
     if (window.Cryptique) {
-      return checkSDK();
+      checkSDK();
+      // Return ready() so await Cryptique.init() waits for full initialization
+      return window.Cryptique.ready ? window.Cryptique.ready() : Promise.resolve(window.Cryptique);
     }
 
-    // Otherwise, wait a bit for it to initialize
+    // Otherwise, wait for SDK to load then configure and wait for ready
     return new Promise((resolve) => {
       const maxAttempts = 50;
       let attempts = 0;
       const interval = setInterval(() => {
         attempts++;
         const sdk = checkSDK();
-        if (sdk || attempts >= maxAttempts) {
+        if (sdk) {
+          clearInterval(interval);
+          // Wait for full initialization
+          const readyPromise = sdk.ready ? sdk.ready() : Promise.resolve(sdk);
+          resolve(readyPromise);
+        } else if (attempts >= maxAttempts) {
           clearInterval(interval);
-          resolve(sdk);
+          resolve(null);
         }
       }, 100);
     });
@@ -7969,6 +8057,19 @@ const CryptiqueSDK = {
     return null;
   },
 
+  /**
+   * Wait for SDK to be fully initialized
+   * Returns a Promise that resolves when initialization is complete
+   * @returns {Promise<void>}
+   */
+  ready() {
+    const instance = this.getInstance();
+    if (instance && instance.ready) {
+      return instance.ready();
+    }
+    return Promise.resolve();
+  },
+
   /**
    * Identify a user with a unique identifier
    * 

package/lib/types/index.d.ts

@@ -99,14 +99,20 @@ export interface PeopleManager {
 export default class CryptiqueSDK {
   /**
    * Initialize the SDK programmatically
+   * Returns a Promise that resolves when the SDK is fully initialized
    */
-  init(options: CryptiqueOptions): Promise<any> | any;
+  init(options: CryptiqueOptions): Promise<any>;
 
   /**
    * Get the SDK instance
    */
   getInstance(): any | null;
 
+  /**
+   * Wait for SDK to be fully initialized
+   */
+  ready(): Promise<void>;
+
   /**
    * Track a custom event
    */

package/lib/umd/index.js

@@ -168,6 +168,21 @@
       eip6963Providers: []            // EIP-6963 discovered wallet providers
     };
 
+    // Ready promise - resolves when SDK is fully initialized (allows consumers to await init)
+    let _readyPromiseResolve;
+    const _readyPromise = new Promise((resolve) => {
+      _readyPromiseResolve = resolve;
+    });
+
+    // Helper to wait for SDK ready with timeout (avoids hanging if init fails)
+    const _waitForReady = (timeoutMs = 5000) => {
+      if (runtimeState.isInitialized) return Promise.resolve();
+      return Promise.race([
+        _readyPromise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error('SDK init timeout')), timeoutMs))
+      ]);
+    };
+
     // Initialize EIP-6963 wallet provider detection (if enabled)
     {
       // Listen for providers being announced
@@ -4303,6 +4318,10 @@
     // - Proper use of sendBeacon vs fetch
     // ============================================================================
 
+    // Throttle network error logs (e.g. "Failed to fetch" from ad blockers) - log at most once per 30s
+    let _lastNetworkErrorLog = 0;
+    const _NETWORK_ERROR_THROTTLE_MS = 30000;
+
     /**
      * APIClient - Unified API communication
      * 
@@ -4483,8 +4502,14 @@
             // Don't retry aborted requests - they were intentionally cancelled
             return; // Silently return, don't throw
           }
-          
-          console.error('❌ Error sending data:', error);
+
+          // Throttle "Failed to fetch" logs (common with ad blockers, CORS, network issues)
+          const isNetworkError = error.name === 'TypeError' && (error.message === 'Failed to fetch' || error.message?.includes('fetch'));
+          const now = Date.now();
+          if (isNetworkError && (now - _lastNetworkErrorLog) < _NETWORK_ERROR_THROTTLE_MS) ; else {
+            if (isNetworkError) _lastNetworkErrorLog = now;
+            console.error('❌ Error sending data:', error);
+          }
           
           // Retry if retries > 0 (but not for abort errors)
           if (retries > 0) {
@@ -5891,6 +5916,12 @@
 
         } catch (error) {
           console.error('Error initializing Cryptique SDK:', error);
+        } finally {
+          // Always resolve ready promise so awaiters don't hang (even if init failed)
+          if (typeof _readyPromiseResolve === 'function') {
+            _readyPromiseResolve();
+            _readyPromiseResolve = null; // Prevent multiple resolves
+          }
         }
       }
     };
@@ -6103,9 +6134,17 @@
             }
           }
           
+          // Wait for SDK init if not ready (handles race conditions)
           if (!runtimeState.isInitialized) {
-            console.warn('⚠️ [Events] SDK not initialized, skipping auto event:', eventName);
-            return;
+            try {
+              await _waitForReady();
+            } catch (e) {
+              // Init timeout or failed - silently skip
+              return;
+            }
+            if (!runtimeState.isInitialized) {
+              return;
+            }
           }
 
           // Get session from storage - it returns { id, userId, ... }
@@ -6680,8 +6719,9 @@
 
       /**
        * Setup auto events tracking
+       * Waits for SDK initialization before proceeding (handles SPA navigation race)
        */
-      setup() {
+      async setup() {
         // Check if auto events are enabled
         if (!CONFIG.AUTO_EVENTS.enabled) {
           return;
@@ -6697,6 +6737,17 @@
         }
         
         try {
+          // Wait for SDK to be fully initialized (handles SPA nav before init completes)
+          await _waitForReady().catch(() => {
+            // Init failed or timed out - silently skip setup
+            return;
+          });
+          
+          // Double-check after wait (init may have failed)
+          if (!runtimeState.isInitialized) {
+            return;
+          }
+          
           // Track page views
           this.trackPageView();
           
@@ -6856,11 +6907,15 @@
           const isInteractive = isInteractiveElement(element);
           
           if (!isInteractive) {
-            // Capture coordinates before setTimeout
+            // Capture coordinates and page context before setTimeout (for heatmaps)
             const clickX = event.clientX;
             const clickY = event.clientY;
             const clickElement = element;
-            
+            const scrollX = window.scrollX != null ? window.scrollX : window.pageXOffset;
+            const scrollY = window.scrollY != null ? window.scrollY : window.pageYOffset;
+            const docHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
+            const docWidth = Math.max(document.body.scrollWidth, document.documentElement.scrollWidth);
+
             // Mark this click as potentially dead
             const clickId = `${now}_${Math.random().toString(36).substr(2, 9)}`;
             pendingDeadClicks.set(clickId, {
@@ -6870,7 +6925,13 @@
               timestamp: now,
               url: window.location.href,
               clickX,
-              clickY
+              clickY,
+              page_x: event.pageX,
+              page_y: event.pageY,
+              scroll_x: scrollX,
+              scroll_y: scrollY,
+              document_height: docHeight,
+              document_width: docWidth
             });
             
             // Check after 1 second if navigation occurred or if it's still a dead click
@@ -6884,6 +6945,12 @@
                 
                 EventsManager.trackAutoEvent('dead_click', {
                   click_coordinates: { x: pendingClick.clickX, y: pendingClick.clickY },
+                  page_x: pendingClick.page_x,
+                  page_y: pendingClick.page_y,
+                  scroll_x: pendingClick.scroll_x,
+                  scroll_y: pendingClick.scroll_y,
+                  document_height: pendingClick.document_height,
+                  document_width: pendingClick.document_width,
                   element_area: clickElement.offsetWidth * clickElement.offsetHeight,
                   element_category: pendingClick.elementCategory,
                   element_has_onclick: !!clickElement.onclick,
@@ -6899,9 +6966,19 @@
             }, 1000);
           }
 
-          // Track regular click with enhanced data
+          // Track regular click with enhanced data (viewport + page-relative for heatmaps)
+          const scrollX = window.scrollX != null ? window.scrollX : window.pageXOffset;
+          const scrollY = window.scrollY != null ? window.scrollY : window.pageYOffset;
+          const docHeight = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
+          const docWidth = Math.max(document.body.scrollWidth, document.documentElement.scrollWidth);
           EventsManager.trackAutoEvent('element_click', {
             click_coordinates: { x: event.clientX, y: event.clientY },
+            page_x: event.pageX,
+            page_y: event.pageY,
+            scroll_x: scrollX,
+            scroll_y: scrollY,
+            document_height: docHeight,
+            document_width: docWidth,
             double_click: event.detail === 2,
             element_category: elementCategory
           }, elementData).catch(err => {
@@ -6926,11 +7003,12 @@
           clearTimeout(scrollTimeout);
           
           scrollTimeout = setTimeout(() => {
-            const scrollDepth = Math.round((window.scrollY / (document.body.scrollHeight - window.innerHeight)) * 100);
-            
+            const maxScroll = Math.max(document.body.scrollHeight, document.documentElement.scrollHeight) - window.innerHeight;
+            const scrollDepth = maxScroll <= 0 ? 100 : Math.round((window.scrollY / maxScroll) * 100);
+
             if (scrollDepth > maxScrollDepth) {
               maxScrollDepth = scrollDepth;
-              
+
               EventsManager.trackAutoEvent('page_scroll', {
                 scroll_depth: scrollDepth,
                 max_scroll_reached: maxScrollDepth,
@@ -7679,6 +7757,9 @@
       ...window.Cryptique,
       version: CONFIG.VERSION,
       
+      // Wait for SDK to be fully initialized (returns Promise)
+      ready: () => _readyPromise,
+      
       // Events System
       track: EventsManager.trackEvent.bind(EventsManager),
       trackEvent: EventsManager.trackEvent.bind(EventsManager),
@@ -7903,7 +7984,7 @@
     init(options = {}) {
       if (typeof window === 'undefined') {
         console.warn('Cryptique SDK requires a browser environment');
-        return null;
+        return Promise.resolve(null);
       }
 
       if (!options.siteId) {
@@ -7944,21 +8025,28 @@
         return null;
       };
 
-      // If SDK is already loaded, configure immediately
+      // If SDK is already loaded, configure and return ready promise
       if (window.Cryptique) {
-        return checkSDK();
+        checkSDK();
+        // Return ready() so await Cryptique.init() waits for full initialization
+        return window.Cryptique.ready ? window.Cryptique.ready() : Promise.resolve(window.Cryptique);
       }
 
-      // Otherwise, wait a bit for it to initialize
+      // Otherwise, wait for SDK to load then configure and wait for ready
       return new Promise((resolve) => {
         const maxAttempts = 50;
         let attempts = 0;
         const interval = setInterval(() => {
           attempts++;
           const sdk = checkSDK();
-          if (sdk || attempts >= maxAttempts) {
+          if (sdk) {
+            clearInterval(interval);
+            // Wait for full initialization
+            const readyPromise = sdk.ready ? sdk.ready() : Promise.resolve(sdk);
+            resolve(readyPromise);
+          } else if (attempts >= maxAttempts) {
             clearInterval(interval);
-            resolve(sdk);
+            resolve(null);
           }
         }, 100);
       });
@@ -7975,6 +8063,19 @@
       return null;
     },
 
+    /**
+     * Wait for SDK to be fully initialized
+     * Returns a Promise that resolves when initialization is complete
+     * @returns {Promise<void>}
+     */
+    ready() {
+      const instance = this.getInstance();
+      if (instance && instance.ready) {
+        return instance.ready();
+      }
+      return Promise.resolve();
+    },
+
     /**
      * Identify a user with a unique identifier
      * 

package/package.json

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