@grainql/analytics-web 2.1.3 → 2.2.0

package/dist/index.js

@@ -116,6 +116,23 @@ class GrainAnalytics {
             return v.toString(16);
         });
     }
+    /**
+     * Check if we should allow persistent storage (GDPR compliance)
+     *
+     * Returns true if:
+     * - Consent has been granted, OR
+     * - Not in opt-in mode, OR
+     * - User has been explicitly identified by the site (login/identify), OR
+     * - Using JWT auth strategy (functional/essential purpose)
+     */
+    shouldAllowPersistentStorage() {
+        const hasConsent = this.consentManager.hasConsent('analytics');
+        const isOptInMode = this.config.consentMode === 'opt-in';
+        const userExplicitlyIdentified = !!this.globalUserId;
+        const isJWTAuth = this.config.authStrategy === 'JWT';
+        // Allow persistent storage if any of these conditions are met
+        return hasConsent || !isOptInMode || userExplicitlyIdentified || isJWTAuth;
+    }
     /**
      * Generate a proper UUIDv4 identifier for anonymous user ID
      */
@@ -125,10 +142,19 @@ class GrainAnalytics {
     /**
      * Initialize persistent anonymous user ID from cookies or localStorage
      * Priority: Cookie → localStorage → generate new
+     *
+     * GDPR Compliance: In opt-in mode without consent, we skip loading/saving
+     * persistent IDs unless the user has been explicitly identified by the site
+     * or when using JWT auth (functional/essential purpose)
      */
     initializePersistentAnonymousUserId() {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID initialization (GDPR compliance)');
+            return; // Don't load or create persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -166,10 +192,18 @@ class GrainAnalytics {
     }
     /**
      * Save persistent anonymous user ID to cookie and/or localStorage
+     *
+     * GDPR Compliance: In opt-in mode without consent, we don't persist IDs
+     * unless the user has been explicitly identified or using JWT auth
      */
     savePersistentAnonymousUserId(userId) {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID save (GDPR compliance)');
+            return; // Don't save persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -192,6 +226,9 @@ class GrainAnalytics {
     }
     /**
      * Get the effective user ID (global userId or persistent anonymous ID)
+     *
+     * GDPR Compliance: In opt-in mode without consent and no explicit user identification,
+     * this should not be called. Use getEphemeralSessionId() instead.
      */
     getEffectiveUserIdInternal() {
         if (this.globalUserId) {
@@ -202,16 +239,8 @@ class GrainAnalytics {
         }
         // Generate a new UUIDv4 identifier as fallback
         this.persistentAnonymousUserId = this.generateAnonymousUserId();
-        // Try to persist it
-        if (typeof window !== 'undefined') {
-            try {
-                const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-            }
-            catch (error) {
-                this.log('Failed to persist generated anonymous user ID:', error);
-            }
-        }
+        // Try to persist it (will be skipped in opt-in mode without consent)
+        this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
         return this.persistentAnonymousUserId;
     }
     log(...args) {
@@ -559,7 +588,12 @@ class GrainAnalytics {
      */
     handleConsentGranted() {
         this.flushWaitingForConsentQueue();
-        // Track consent granted event with mapping
+        // Initialize persistent ID now that consent is granted (if not already initialized)
+        if (!this.persistentAnonymousUserId) {
+            this.initializePersistentAnonymousUserId();
+            this.log('Initialized persistent ID after consent grant');
+        }
+        // Track consent granted event with mapping from ephemeral to persistent ID
         if (this.ephemeralSessionId) {
             this.trackSystemEvent('_grain_consent_granted', {
                 previous_session_id: this.ephemeralSessionId,
@@ -729,19 +763,11 @@ class GrainAnalytics {
             this.persistentAnonymousUserId = null;
         }
         else {
-            // If clearing user ID, ensure we have a UUIDv4 identifier
+            // If clearing user ID, ensure we have an identifier
             if (!this.persistentAnonymousUserId) {
                 this.persistentAnonymousUserId = this.generateAnonymousUserId();
-                // Try to persist the new anonymous ID
-                if (typeof window !== 'undefined') {
-                    try {
-                        const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                        localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-                    }
-                    catch (error) {
-                        this.log('Failed to persist new anonymous user ID:', error);
-                    }
-                }
+                // Try to persist the new anonymous ID (respects GDPR opt-in mode)
+                this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
             }
         }
     }

package/dist/index.mjs

@@ -112,6 +112,23 @@ export class GrainAnalytics {
             return v.toString(16);
         });
     }
+    /**
+     * Check if we should allow persistent storage (GDPR compliance)
+     *
+     * Returns true if:
+     * - Consent has been granted, OR
+     * - Not in opt-in mode, OR
+     * - User has been explicitly identified by the site (login/identify), OR
+     * - Using JWT auth strategy (functional/essential purpose)
+     */
+    shouldAllowPersistentStorage() {
+        const hasConsent = this.consentManager.hasConsent('analytics');
+        const isOptInMode = this.config.consentMode === 'opt-in';
+        const userExplicitlyIdentified = !!this.globalUserId;
+        const isJWTAuth = this.config.authStrategy === 'JWT';
+        // Allow persistent storage if any of these conditions are met
+        return hasConsent || !isOptInMode || userExplicitlyIdentified || isJWTAuth;
+    }
     /**
      * Generate a proper UUIDv4 identifier for anonymous user ID
      */
@@ -121,10 +138,19 @@ export class GrainAnalytics {
     /**
      * Initialize persistent anonymous user ID from cookies or localStorage
      * Priority: Cookie → localStorage → generate new
+     *
+     * GDPR Compliance: In opt-in mode without consent, we skip loading/saving
+     * persistent IDs unless the user has been explicitly identified by the site
+     * or when using JWT auth (functional/essential purpose)
      */
     initializePersistentAnonymousUserId() {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID initialization (GDPR compliance)');
+            return; // Don't load or create persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -162,10 +188,18 @@ export class GrainAnalytics {
     }
     /**
      * Save persistent anonymous user ID to cookie and/or localStorage
+     *
+     * GDPR Compliance: In opt-in mode without consent, we don't persist IDs
+     * unless the user has been explicitly identified or using JWT auth
      */
     savePersistentAnonymousUserId(userId) {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID save (GDPR compliance)');
+            return; // Don't save persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -188,6 +222,9 @@ export class GrainAnalytics {
     }
     /**
      * Get the effective user ID (global userId or persistent anonymous ID)
+     *
+     * GDPR Compliance: In opt-in mode without consent and no explicit user identification,
+     * this should not be called. Use getEphemeralSessionId() instead.
      */
     getEffectiveUserIdInternal() {
         if (this.globalUserId) {
@@ -198,16 +235,8 @@ export class GrainAnalytics {
         }
         // Generate a new UUIDv4 identifier as fallback
         this.persistentAnonymousUserId = this.generateAnonymousUserId();
-        // Try to persist it
-        if (typeof window !== 'undefined') {
-            try {
-                const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-            }
-            catch (error) {
-                this.log('Failed to persist generated anonymous user ID:', error);
-            }
-        }
+        // Try to persist it (will be skipped in opt-in mode without consent)
+        this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
         return this.persistentAnonymousUserId;
     }
     log(...args) {
@@ -555,7 +584,12 @@ export class GrainAnalytics {
      */
     handleConsentGranted() {
         this.flushWaitingForConsentQueue();
-        // Track consent granted event with mapping
+        // Initialize persistent ID now that consent is granted (if not already initialized)
+        if (!this.persistentAnonymousUserId) {
+            this.initializePersistentAnonymousUserId();
+            this.log('Initialized persistent ID after consent grant');
+        }
+        // Track consent granted event with mapping from ephemeral to persistent ID
         if (this.ephemeralSessionId) {
             this.trackSystemEvent('_grain_consent_granted', {
                 previous_session_id: this.ephemeralSessionId,
@@ -725,19 +759,11 @@ export class GrainAnalytics {
             this.persistentAnonymousUserId = null;
         }
         else {
-            // If clearing user ID, ensure we have a UUIDv4 identifier
+            // If clearing user ID, ensure we have an identifier
             if (!this.persistentAnonymousUserId) {
                 this.persistentAnonymousUserId = this.generateAnonymousUserId();
-                // Try to persist the new anonymous ID
-                if (typeof window !== 'undefined') {
-                    try {
-                        const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                        localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-                    }
-                    catch (error) {
-                        this.log('Failed to persist new anonymous user ID:', error);
-                    }
-                }
+                // Try to persist the new anonymous ID (respects GDPR opt-in mode)
+                this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
             }
         }
     }

package/dist/react/consent.d.ts

@@ -22,6 +22,10 @@ export declare class ConsentManager {
     constructor(tenantId: string, consentMode?: ConsentMode);
     /**
      * Load consent state from localStorage
+     *
+     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
+     * since storing consent choices is a legitimate interest and necessary for compliance.
+     * The consent preference itself is not tracking data.
      */
     private loadConsentState;
     /**

package/dist/react/consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}

package/dist/react/consent.js

@@ -20,6 +20,10 @@ class ConsentManager {
     }
     /**
      * Load consent state from localStorage
+     *
+     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
+     * since storing consent choices is a legitimate interest and necessary for compliance.
+     * The consent preference itself is not tracking data.
      */
     loadConsentState() {
         if (typeof window === 'undefined')
@@ -43,6 +47,7 @@ class ConsentManager {
                 };
                 this.saveConsentState();
             }
+            // Note: In opt-in mode without stored consent, consentState remains null (no consent)
         }
         catch (error) {
             console.error('[Grain Consent] Failed to load consent state:', error);

package/dist/react/consent.mjs

@@ -17,6 +17,10 @@ export class ConsentManager {
     }
     /**
      * Load consent state from localStorage
+     *
+     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
+     * since storing consent choices is a legitimate interest and necessary for compliance.
+     * The consent preference itself is not tracking data.
      */
     loadConsentState() {
         if (typeof window === 'undefined')
@@ -40,6 +44,7 @@ export class ConsentManager {
                 };
                 this.saveConsentState();
             }
+            // Note: In opt-in mode without stored consent, consentState remains null (no consent)
         }
         catch (error) {
             console.error('[Grain Consent] Failed to load consent state:', error);

package/dist/react/index.d.ts

@@ -219,6 +219,16 @@ export declare class GrainAnalytics implements HeartbeatTracker, PageTracker {
      * Generate a UUID v4 string
      */
     private generateUUID;
+    /**
+     * Check if we should allow persistent storage (GDPR compliance)
+     *
+     * Returns true if:
+     * - Consent has been granted, OR
+     * - Not in opt-in mode, OR
+     * - User has been explicitly identified by the site (login/identify), OR
+     * - Using JWT auth strategy (functional/essential purpose)
+     */
+    private shouldAllowPersistentStorage;
     /**
      * Generate a proper UUIDv4 identifier for anonymous user ID
      */
@@ -226,14 +236,24 @@ export declare class GrainAnalytics implements HeartbeatTracker, PageTracker {
     /**
      * Initialize persistent anonymous user ID from cookies or localStorage
      * Priority: Cookie → localStorage → generate new
+     *
+     * GDPR Compliance: In opt-in mode without consent, we skip loading/saving
+     * persistent IDs unless the user has been explicitly identified by the site
+     * or when using JWT auth (functional/essential purpose)
      */
     private initializePersistentAnonymousUserId;
     /**
      * Save persistent anonymous user ID to cookie and/or localStorage
+     *
+     * GDPR Compliance: In opt-in mode without consent, we don't persist IDs
+     * unless the user has been explicitly identified or using JWT auth
      */
     private savePersistentAnonymousUserId;
     /**
      * Get the effective user ID (global userId or persistent anonymous ID)
+     *
+     * GDPR Compliance: In opt-in mode without consent and no explicit user identification,
+     * this should not be called. Use getEphemeralSessionId() instead.
      */
     private getEffectiveUserIdInternal;
     private log;

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/react/index.js

@@ -116,6 +116,23 @@ class GrainAnalytics {
             return v.toString(16);
         });
     }
+    /**
+     * Check if we should allow persistent storage (GDPR compliance)
+     *
+     * Returns true if:
+     * - Consent has been granted, OR
+     * - Not in opt-in mode, OR
+     * - User has been explicitly identified by the site (login/identify), OR
+     * - Using JWT auth strategy (functional/essential purpose)
+     */
+    shouldAllowPersistentStorage() {
+        const hasConsent = this.consentManager.hasConsent('analytics');
+        const isOptInMode = this.config.consentMode === 'opt-in';
+        const userExplicitlyIdentified = !!this.globalUserId;
+        const isJWTAuth = this.config.authStrategy === 'JWT';
+        // Allow persistent storage if any of these conditions are met
+        return hasConsent || !isOptInMode || userExplicitlyIdentified || isJWTAuth;
+    }
     /**
      * Generate a proper UUIDv4 identifier for anonymous user ID
      */
@@ -125,10 +142,19 @@ class GrainAnalytics {
     /**
      * Initialize persistent anonymous user ID from cookies or localStorage
      * Priority: Cookie → localStorage → generate new
+     *
+     * GDPR Compliance: In opt-in mode without consent, we skip loading/saving
+     * persistent IDs unless the user has been explicitly identified by the site
+     * or when using JWT auth (functional/essential purpose)
      */
     initializePersistentAnonymousUserId() {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID initialization (GDPR compliance)');
+            return; // Don't load or create persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -166,10 +192,18 @@ class GrainAnalytics {
     }
     /**
      * Save persistent anonymous user ID to cookie and/or localStorage
+     *
+     * GDPR Compliance: In opt-in mode without consent, we don't persist IDs
+     * unless the user has been explicitly identified or using JWT auth
      */
     savePersistentAnonymousUserId(userId) {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID save (GDPR compliance)');
+            return; // Don't save persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -192,6 +226,9 @@ class GrainAnalytics {
     }
     /**
      * Get the effective user ID (global userId or persistent anonymous ID)
+     *
+     * GDPR Compliance: In opt-in mode without consent and no explicit user identification,
+     * this should not be called. Use getEphemeralSessionId() instead.
      */
     getEffectiveUserIdInternal() {
         if (this.globalUserId) {
@@ -202,16 +239,8 @@ class GrainAnalytics {
         }
         // Generate a new UUIDv4 identifier as fallback
         this.persistentAnonymousUserId = this.generateAnonymousUserId();
-        // Try to persist it
-        if (typeof window !== 'undefined') {
-            try {
-                const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-            }
-            catch (error) {
-                this.log('Failed to persist generated anonymous user ID:', error);
-            }
-        }
+        // Try to persist it (will be skipped in opt-in mode without consent)
+        this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
         return this.persistentAnonymousUserId;
     }
     log(...args) {
@@ -559,7 +588,12 @@ class GrainAnalytics {
      */
     handleConsentGranted() {
         this.flushWaitingForConsentQueue();
-        // Track consent granted event with mapping
+        // Initialize persistent ID now that consent is granted (if not already initialized)
+        if (!this.persistentAnonymousUserId) {
+            this.initializePersistentAnonymousUserId();
+            this.log('Initialized persistent ID after consent grant');
+        }
+        // Track consent granted event with mapping from ephemeral to persistent ID
         if (this.ephemeralSessionId) {
             this.trackSystemEvent('_grain_consent_granted', {
                 previous_session_id: this.ephemeralSessionId,
@@ -729,19 +763,11 @@ class GrainAnalytics {
             this.persistentAnonymousUserId = null;
         }
         else {
-            // If clearing user ID, ensure we have a UUIDv4 identifier
+            // If clearing user ID, ensure we have an identifier
             if (!this.persistentAnonymousUserId) {
                 this.persistentAnonymousUserId = this.generateAnonymousUserId();
-                // Try to persist the new anonymous ID
-                if (typeof window !== 'undefined') {
-                    try {
-                        const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                        localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-                    }
-                    catch (error) {
-                        this.log('Failed to persist new anonymous user ID:', error);
-                    }
-                }
+                // Try to persist the new anonymous ID (respects GDPR opt-in mode)
+                this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
             }
         }
     }

package/dist/react/index.mjs

@@ -112,6 +112,23 @@ export class GrainAnalytics {
             return v.toString(16);
         });
     }
+    /**
+     * Check if we should allow persistent storage (GDPR compliance)
+     *
+     * Returns true if:
+     * - Consent has been granted, OR
+     * - Not in opt-in mode, OR
+     * - User has been explicitly identified by the site (login/identify), OR
+     * - Using JWT auth strategy (functional/essential purpose)
+     */
+    shouldAllowPersistentStorage() {
+        const hasConsent = this.consentManager.hasConsent('analytics');
+        const isOptInMode = this.config.consentMode === 'opt-in';
+        const userExplicitlyIdentified = !!this.globalUserId;
+        const isJWTAuth = this.config.authStrategy === 'JWT';
+        // Allow persistent storage if any of these conditions are met
+        return hasConsent || !isOptInMode || userExplicitlyIdentified || isJWTAuth;
+    }
     /**
      * Generate a proper UUIDv4 identifier for anonymous user ID
      */
@@ -121,10 +138,19 @@ export class GrainAnalytics {
     /**
      * Initialize persistent anonymous user ID from cookies or localStorage
      * Priority: Cookie → localStorage → generate new
+     *
+     * GDPR Compliance: In opt-in mode without consent, we skip loading/saving
+     * persistent IDs unless the user has been explicitly identified by the site
+     * or when using JWT auth (functional/essential purpose)
      */
     initializePersistentAnonymousUserId() {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID initialization (GDPR compliance)');
+            return; // Don't load or create persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -162,10 +188,18 @@ export class GrainAnalytics {
     }
     /**
      * Save persistent anonymous user ID to cookie and/or localStorage
+     *
+     * GDPR Compliance: In opt-in mode without consent, we don't persist IDs
+     * unless the user has been explicitly identified or using JWT auth
      */
     savePersistentAnonymousUserId(userId) {
         if (typeof window === 'undefined')
             return;
+        // Check if we should avoid persistent storage (GDPR compliance)
+        if (!this.shouldAllowPersistentStorage()) {
+            this.log('Opt-in mode without consent: skipping persistent ID save (GDPR compliance)');
+            return; // Don't save persistent ID
+        }
         const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
         const cookieName = '_grain_uid';
         try {
@@ -188,6 +222,9 @@ export class GrainAnalytics {
     }
     /**
      * Get the effective user ID (global userId or persistent anonymous ID)
+     *
+     * GDPR Compliance: In opt-in mode without consent and no explicit user identification,
+     * this should not be called. Use getEphemeralSessionId() instead.
      */
     getEffectiveUserIdInternal() {
         if (this.globalUserId) {
@@ -198,16 +235,8 @@ export class GrainAnalytics {
         }
         // Generate a new UUIDv4 identifier as fallback
         this.persistentAnonymousUserId = this.generateAnonymousUserId();
-        // Try to persist it
-        if (typeof window !== 'undefined') {
-            try {
-                const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-            }
-            catch (error) {
-                this.log('Failed to persist generated anonymous user ID:', error);
-            }
-        }
+        // Try to persist it (will be skipped in opt-in mode without consent)
+        this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
         return this.persistentAnonymousUserId;
     }
     log(...args) {
@@ -555,7 +584,12 @@ export class GrainAnalytics {
      */
     handleConsentGranted() {
         this.flushWaitingForConsentQueue();
-        // Track consent granted event with mapping
+        // Initialize persistent ID now that consent is granted (if not already initialized)
+        if (!this.persistentAnonymousUserId) {
+            this.initializePersistentAnonymousUserId();
+            this.log('Initialized persistent ID after consent grant');
+        }
+        // Track consent granted event with mapping from ephemeral to persistent ID
         if (this.ephemeralSessionId) {
             this.trackSystemEvent('_grain_consent_granted', {
                 previous_session_id: this.ephemeralSessionId,
@@ -725,19 +759,11 @@ export class GrainAnalytics {
             this.persistentAnonymousUserId = null;
         }
         else {
-            // If clearing user ID, ensure we have a UUIDv4 identifier
+            // If clearing user ID, ensure we have an identifier
             if (!this.persistentAnonymousUserId) {
                 this.persistentAnonymousUserId = this.generateAnonymousUserId();
-                // Try to persist the new anonymous ID
-                if (typeof window !== 'undefined') {
-                    try {
-                        const storageKey = `grain_anonymous_user_id_${this.config.tenantId}`;
-                        localStorage.setItem(storageKey, this.persistentAnonymousUserId);
-                    }
-                    catch (error) {
-                        this.log('Failed to persist new anonymous user ID:', error);
-                    }
-                }
+                // Try to persist the new anonymous ID (respects GDPR opt-in mode)
+                this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
             }
         }
     }