cryptique-sdk 1.1.5 → 1.1.7

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
@@ -3770,18 +3785,6 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
         // Save updated session
         StorageManager.saveSession(session);
-
-        // Fire page_view auto event on every navigation (single source of truth with session tracking)
-        // This ensures SPAs get page_view on route changes without a separate history override
-        if (typeof CONFIG !== 'undefined' && CONFIG.AUTO_EVENTS && CONFIG.AUTO_EVENTS.enabled && typeof shouldTrackAutoEvents === 'function' && shouldTrackAutoEvents()) {
-          if (typeof AutoEventsTracker !== 'undefined') {
-            if (!AutoEventsTracker.isSetup) {
-              AutoEventsTracker.setup();
-            } else {
-              AutoEventsTracker.trackPageView();
-            }
-          }
-        }
       } catch (error) {
         console.error("Error tracking page visit:", error);
       }
@@ -4311,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
    * 
@@ -4491,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) {
@@ -5899,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
+        }
       }
     }
   };
@@ -6111,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, ... }
@@ -6688,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;
@@ -6705,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();
         
@@ -7687,6 +7726,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),
@@ -7817,6 +7859,46 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
   // Initialize SDK when DOM is ready
   // ============================================================================
 
+  /**
+   * Monitor path changes for Single Page Applications (SPAs)
+   * Re-checks auto events configuration when navigation occurs
+   */
+  function setupSPANavigationMonitoring() {
+    let lastPath = window.location.pathname;
+
+    // Check path changes
+    function checkPathChange() {
+      const currentPath = window.location.pathname;
+      if (currentPath !== lastPath) {
+        lastPath = currentPath;
+        
+        // If auto events were disabled on previous page but enabled on new page, setup
+        if (CONFIG.AUTO_EVENTS.enabled && shouldTrackAutoEvents() && !AutoEventsTracker.isSetup) {
+          AutoEventsTracker.setup();
+        }
+        // Note: If auto events should be disabled on new page, trackAutoEvent will check
+        // shouldTrackAutoEvents() before tracking, so no need to remove listeners
+      }
+    }
+
+    // Check on popstate (browser back/forward)
+    window.addEventListener('popstate', checkPathChange);
+
+    // For SPAs using history.pushState/replaceState, monitor them
+    const originalPushState = history.pushState;
+    const originalReplaceState = history.replaceState;
+    
+    history.pushState = function(...args) {
+      originalPushState.apply(history, args);
+      setTimeout(checkPathChange, 0);
+    };
+    
+    history.replaceState = function(...args) {
+      originalReplaceState.apply(history, args);
+      setTimeout(checkPathChange, 0);
+    };
+  }
+
   // Initialize SDK
   async function initializeSDK() {
     await Initializer.initialize();
@@ -7826,6 +7908,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     setTimeout(() => {
       AutoEventsTracker.setup();
     }, 2000); // Wait 2 seconds for initial session to be saved
+    
+    // Setup SPA navigation monitoring for auto events
+    setupSPANavigationMonitoring();
   }
 
   if (document.readyState === 'loading') {
@@ -7868,7 +7953,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) {
@@ -7909,21 +7994,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);
     });
@@ -7940,6 +8032,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
@@ -3768,18 +3783,6 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
         // Save updated session
         StorageManager.saveSession(session);
-
-        // Fire page_view auto event on every navigation (single source of truth with session tracking)
-        // This ensures SPAs get page_view on route changes without a separate history override
-        if (typeof CONFIG !== 'undefined' && CONFIG.AUTO_EVENTS && CONFIG.AUTO_EVENTS.enabled && typeof shouldTrackAutoEvents === 'function' && shouldTrackAutoEvents()) {
-          if (typeof AutoEventsTracker !== 'undefined') {
-            if (!AutoEventsTracker.isSetup) {
-              AutoEventsTracker.setup();
-            } else {
-              AutoEventsTracker.trackPageView();
-            }
-          }
-        }
       } catch (error) {
         console.error("Error tracking page visit:", error);
       }
@@ -4309,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
    * 
@@ -4489,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) {
@@ -5897,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
+        }
       }
     }
   };
@@ -6109,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, ... }
@@ -6686,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;
@@ -6703,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();
         
@@ -7685,6 +7724,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),
@@ -7815,6 +7857,46 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
   // Initialize SDK when DOM is ready
   // ============================================================================
 
+  /**
+   * Monitor path changes for Single Page Applications (SPAs)
+   * Re-checks auto events configuration when navigation occurs
+   */
+  function setupSPANavigationMonitoring() {
+    let lastPath = window.location.pathname;
+
+    // Check path changes
+    function checkPathChange() {
+      const currentPath = window.location.pathname;
+      if (currentPath !== lastPath) {
+        lastPath = currentPath;
+        
+        // If auto events were disabled on previous page but enabled on new page, setup
+        if (CONFIG.AUTO_EVENTS.enabled && shouldTrackAutoEvents() && !AutoEventsTracker.isSetup) {
+          AutoEventsTracker.setup();
+        }
+        // Note: If auto events should be disabled on new page, trackAutoEvent will check
+        // shouldTrackAutoEvents() before tracking, so no need to remove listeners
+      }
+    }
+
+    // Check on popstate (browser back/forward)
+    window.addEventListener('popstate', checkPathChange);
+
+    // For SPAs using history.pushState/replaceState, monitor them
+    const originalPushState = history.pushState;
+    const originalReplaceState = history.replaceState;
+    
+    history.pushState = function(...args) {
+      originalPushState.apply(history, args);
+      setTimeout(checkPathChange, 0);
+    };
+    
+    history.replaceState = function(...args) {
+      originalReplaceState.apply(history, args);
+      setTimeout(checkPathChange, 0);
+    };
+  }
+
   // Initialize SDK
   async function initializeSDK() {
     await Initializer.initialize();
@@ -7824,6 +7906,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     setTimeout(() => {
       AutoEventsTracker.setup();
     }, 2000); // Wait 2 seconds for initial session to be saved
+    
+    // Setup SPA navigation monitoring for auto events
+    setupSPANavigationMonitoring();
   }
 
   if (document.readyState === 'loading') {
@@ -7866,7 +7951,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) {
@@ -7907,21 +7992,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);
     });
@@ -7938,6 +8030,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
@@ -3774,18 +3789,6 @@
 
           // Save updated session
           StorageManager.saveSession(session);
-
-          // Fire page_view auto event on every navigation (single source of truth with session tracking)
-          // This ensures SPAs get page_view on route changes without a separate history override
-          if (typeof CONFIG !== 'undefined' && CONFIG.AUTO_EVENTS && CONFIG.AUTO_EVENTS.enabled && typeof shouldTrackAutoEvents === 'function' && shouldTrackAutoEvents()) {
-            if (typeof AutoEventsTracker !== 'undefined') {
-              if (!AutoEventsTracker.isSetup) {
-                AutoEventsTracker.setup();
-              } else {
-                AutoEventsTracker.trackPageView();
-              }
-            }
-          }
         } catch (error) {
           console.error("Error tracking page visit:", error);
         }
@@ -4315,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
      * 
@@ -4495,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) {
@@ -5903,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
+          }
         }
       }
     };
@@ -6115,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, ... }
@@ -6692,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;
@@ -6709,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();
           
@@ -7691,6 +7730,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),
@@ -7821,6 +7863,46 @@
     // Initialize SDK when DOM is ready
     // ============================================================================
 
+    /**
+     * Monitor path changes for Single Page Applications (SPAs)
+     * Re-checks auto events configuration when navigation occurs
+     */
+    function setupSPANavigationMonitoring() {
+      let lastPath = window.location.pathname;
+
+      // Check path changes
+      function checkPathChange() {
+        const currentPath = window.location.pathname;
+        if (currentPath !== lastPath) {
+          lastPath = currentPath;
+          
+          // If auto events were disabled on previous page but enabled on new page, setup
+          if (CONFIG.AUTO_EVENTS.enabled && shouldTrackAutoEvents() && !AutoEventsTracker.isSetup) {
+            AutoEventsTracker.setup();
+          }
+          // Note: If auto events should be disabled on new page, trackAutoEvent will check
+          // shouldTrackAutoEvents() before tracking, so no need to remove listeners
+        }
+      }
+
+      // Check on popstate (browser back/forward)
+      window.addEventListener('popstate', checkPathChange);
+
+      // For SPAs using history.pushState/replaceState, monitor them
+      const originalPushState = history.pushState;
+      const originalReplaceState = history.replaceState;
+      
+      history.pushState = function(...args) {
+        originalPushState.apply(history, args);
+        setTimeout(checkPathChange, 0);
+      };
+      
+      history.replaceState = function(...args) {
+        originalReplaceState.apply(history, args);
+        setTimeout(checkPathChange, 0);
+      };
+    }
+
     // Initialize SDK
     async function initializeSDK() {
       await Initializer.initialize();
@@ -7830,6 +7912,9 @@
       setTimeout(() => {
         AutoEventsTracker.setup();
       }, 2000); // Wait 2 seconds for initial session to be saved
+      
+      // Setup SPA navigation monitoring for auto events
+      setupSPANavigationMonitoring();
     }
 
     if (document.readyState === 'loading') {
@@ -7872,7 +7957,7 @@
     init(options = {}) {
       if (typeof window === 'undefined') {
         console.warn('Cryptique SDK requires a browser environment');
-        return null;
+        return Promise.resolve(null);
       }
 
       if (!options.siteId) {
@@ -7913,21 +7998,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);
       });
@@ -7944,6 +8036,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.5",
+  "version": "1.1.7",
   "type": "module",
   "description": "Cryptique Analytics SDK - Comprehensive web analytics and user tracking for modern web applications",
   "main": "lib/cjs/index.js",