@v-tilt/browser 1.4.3 → 1.4.4

package/lib/user-manager.js

@@ -380,17 +380,49 @@ class UserManager {
     // Storage Operations (using StorageManager)
     // ============================================================================
     /**
-     * Load user identity from storage
+     * Load user identity from storage.
+     *
+     * For traditional SSR websites where each page navigation reloads JavaScript,
+     * identity MUST be persisted immediately when generated to ensure the same
+     * anonymous_id is used across all page loads.
+     *
+     * Flow:
+     * 1. Load from storage (reads cookies first for critical properties in SSR mode)
+     * 2. Generate new IDs if not found
+     * 3. Immediately persist to storage (saved to both localStorage and cookies)
+     *
+     * With `localStorage+cookie` persistence (default):
+     * - Critical properties are stored in cookies for SSR compatibility
+     * - Full data is stored in localStorage for fast SPA-style access
+     * - Cookies ensure identity persists across full page reloads
      */
     loadUserIdentity() {
-        const anonymousId = this.storage.get(constants_1.ANONYMOUS_ID_KEY) || this.generateAnonymousId();
-        const distinctId = this.storage.get(constants_1.DISTINCT_ID_KEY) || null;
-        const deviceId = this.storage.get(constants_1.DEVICE_ID_KEY) || this.generateDeviceId();
+        // Try to load existing IDs from storage
+        // In localStorage+cookie mode, this reads from cookies first for critical properties
+        const storedAnonymousId = this.storage.get(constants_1.ANONYMOUS_ID_KEY);
+        const storedDeviceId = this.storage.get(constants_1.DEVICE_ID_KEY);
+        const storedDistinctId = this.storage.get(constants_1.DISTINCT_ID_KEY);
+        const storedUserState = this.storage.get(constants_1.USER_STATE_KEY);
         const properties = this.getStoredUserProperties();
-        const userState = this.storage.get(constants_1.USER_STATE_KEY) ||
-            "anonymous";
+        // Generate new IDs if not found in storage
+        const anonymousId = storedAnonymousId || this.generateAnonymousId();
+        const deviceId = storedDeviceId || this.generateDeviceId();
+        const distinctId = storedDistinctId || null;
+        const userState = storedUserState || "anonymous";
         // Ensure anonymous_id is never undefined
         const safeAnonymousId = anonymousId || this.generateAnonymousId();
+        // CRITICAL: Immediately persist newly generated IDs to storage
+        // This ensures identity survives page reloads in traditional SSR websites
+        // In localStorage+cookie mode, critical properties are saved to cookies automatically
+        if (!storedAnonymousId) {
+            this.storage.set(constants_1.ANONYMOUS_ID_KEY, safeAnonymousId, storage_1.USER_COOKIE_MAX_AGE);
+        }
+        if (!storedDeviceId) {
+            this.storage.set(constants_1.DEVICE_ID_KEY, deviceId, storage_1.USER_COOKIE_MAX_AGE);
+        }
+        if (!storedUserState) {
+            this.storage.set(constants_1.USER_STATE_KEY, userState, storage_1.USER_COOKIE_MAX_AGE);
+        }
         const identity = {
             distinct_id: distinctId,
             anonymous_id: safeAnonymousId,

package/lib/vtilt.js

@@ -44,7 +44,10 @@ class VTilt {
         this.configManager = new config_1.ConfigManager(config);
         const fullConfig = this.configManager.getConfig();
         this.sessionManager = new session_1.SessionManager(fullConfig.storage || "cookie", fullConfig.cross_subdomain_cookie);
-        this.userManager = new user_manager_1.UserManager(fullConfig.persistence || "localStorage", fullConfig.cross_subdomain_cookie);
+        // Default to localStorage+cookie for better SSR support (following PostHog)
+        // Critical properties (anonymous_id, device_id, etc.) are stored in cookies
+        // This ensures identity persists across page navigations in traditional SSR websites
+        this.userManager = new user_manager_1.UserManager(fullConfig.persistence || "localStorage+cookie", fullConfig.cross_subdomain_cookie);
         this.webVitalsManager = new web_vitals_1.WebVitalsManager(fullConfig, this);
         // Initialize rate limiter to prevent flooding
         // Default: 10 events/second with burst of 100
@@ -747,7 +750,8 @@ class VTilt {
         const fullConfig = this.configManager.getConfig();
         // Recreate managers with new config
         this.sessionManager = new session_1.SessionManager(fullConfig.storage || "cookie", fullConfig.cross_subdomain_cookie);
-        this.userManager = new user_manager_1.UserManager(fullConfig.persistence || "localStorage", fullConfig.cross_subdomain_cookie);
+        // Default to localStorage+cookie for better SSR support (following PostHog)
+        this.userManager = new user_manager_1.UserManager(fullConfig.persistence || "localStorage+cookie", fullConfig.cross_subdomain_cookie);
         this.webVitalsManager = new web_vitals_1.WebVitalsManager(fullConfig, this);
         // Update session recording config if it exists
         if (this.sessionRecording && fullConfig.session_recording) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-tilt/browser",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "description": "vTilt browser tracking library",
   "main": "dist/main.js",
   "module": "dist/module.js",