@grainql/analytics-web 2.7.1 → 2.9.0

package/dist/index.mjs

@@ -3,10 +3,11 @@
  * A lightweight, dependency-free TypeScript SDK for sending analytics events to Grain's REST API
  */
 import { ConsentManager } from './consent.js';
-import { setCookie, getCookie, areCookiesEnabled } from './cookies.js';
+import { setCookie, getCookie } from './cookies.js';
 import { ActivityDetector } from './activity.js';
 import { HeartbeatManager } from './heartbeat.js';
 import { PageTrackingManager } from './page-tracking.js';
+import { IdManager } from './id-manager.js';
 import { categorizeReferrer, parseUTMParameters, getOrCreateFirstTouchAttribution, getSessionUTMParameters, getFirstTouchAttribution, } from './attribution.js';
 export { categorizeReferrer, parseUTMParameters };
 // Re-export timezone-country utilities
@@ -18,13 +19,13 @@ export class GrainAnalytics {
         this.flushTimer = null;
         this.isDestroyed = false;
         this.globalUserId = null;
-        this.persistentAnonymousUserId = null;
+        this.persistentAnonymousUserId = null; // Deprecated: use idManager instead
         // Remote Config properties
         this.configCache = null;
         this.configRefreshTimer = null;
         this.configChangeListeners = [];
         this.configFetchPromise = null;
-        this.cookiesEnabled = false;
+        this.cookiesEnabled = false; // Deprecated: cookies no longer used for IDs
         // Automatic Tracking properties
         this.activityDetector = null;
         this.heartbeatManager = null;
@@ -38,6 +39,9 @@ export class GrainAnalytics {
         // Session tracking
         this.sessionStartTime = Date.now();
         this.sessionEventCount = 0;
+        // Debug mode properties
+        this.debugAgent = null;
+        this.isDebugMode = false;
         this.config = {
             apiUrl: 'https://api.grainql.com',
             authStrategy: 'NONE',
@@ -52,38 +56,37 @@ export class GrainAnalytics {
             configCacheKey: 'grain_config',
             configRefreshInterval: 300000, // 5 minutes
             enableConfigCache: true,
-            // Privacy defaults
-            consentMode: 'opt-out',
+            // Privacy defaults (v2.0)
+            consentMode: 'cookieless', // Default: privacy-first, no permanent tracking
             waitForConsent: false,
-            enableCookies: false,
-            anonymizeIP: false,
             disableAutoProperties: false,
             // Automatic Tracking defaults
             enableHeartbeat: true,
             heartbeatActiveInterval: 120000, // 2 minutes
             heartbeatInactiveInterval: 300000, // 5 minutes
             enableAutoPageView: true,
-            stripQueryParams: true,
+            stripQueryParams: true, // Privacy-first: strip by default
+            stripHash: false,
             // Heatmap Tracking defaults
             enableHeatmapTracking: true,
             ...config,
             tenantId: config.tenantId,
         };
-        // Initialize consent manager
+        // Initialize consent manager (v2.0)
         this.consentManager = new ConsentManager(this.config.tenantId, this.config.consentMode);
-        // Check if cookies are enabled
-        if (this.config.enableCookies) {
-            this.cookiesEnabled = areCookiesEnabled();
-            if (!this.cookiesEnabled && this.config.debug) {
-                console.warn('[Grain Analytics] Cookies are not available, falling back to localStorage');
-            }
-        }
+        // Initialize ID manager (v2.0)
+        const idMode = this.consentManager.getIdMode();
+        this.idManager = new IdManager({
+            mode: idMode,
+            tenantId: this.config.tenantId,
+            useLocalStorage: true, // For permanent IDs when consented
+        });
         // Set global userId if provided in config
         if (config.userId) {
             this.globalUserId = config.userId;
         }
         this.validateConfig();
-        this.initializePersistentAnonymousUserId();
+        // Deprecated: initializePersistentAnonymousUserId() - now handled by IdManager
         this.setupBeforeUnload();
         this.startFlushTimer();
         this.initializeConfigCache();
@@ -91,6 +94,8 @@ export class GrainAnalytics {
         this.ephemeralSessionId = this.generateUUID();
         // Initialize automatic tracking (browser only)
         if (typeof window !== 'undefined') {
+            // Check for debug mode before initializing tracking
+            this.checkAndInitializeDebugMode();
             this.initializeAutomaticTracking();
             // Track session start
             this.trackSessionStart();
@@ -99,8 +104,11 @@ export class GrainAnalytics {
                 this.initializeHeatmapTracking();
             }
         }
-        // Set up consent change listener to flush waiting events and handle consent upgrade
+        // Set up consent change listener to sync IdManager and flush waiting events (v2.0)
         this.consentManager.addListener((state) => {
+            // Sync IdManager with consent state
+            const idMode = this.consentManager.getIdMode();
+            this.idManager.setMode(idMode);
             if (state.granted) {
                 this.handleConsentGranted();
             }
@@ -142,11 +150,14 @@ export class GrainAnalytics {
      */
     shouldAllowPersistentStorage() {
         const hasConsent = this.consentManager.hasConsent('analytics');
-        const isOptInMode = this.config.consentMode === 'opt-in';
+        const isCookieless = this.config.consentMode === 'cookieless';
         const userExplicitlyIdentified = !!this.globalUserId;
         const isJWTAuth = this.config.authStrategy === 'JWT';
+        // Never allow persistent storage in cookieless mode
+        if (isCookieless)
+            return false;
         // Allow persistent storage if any of these conditions are met
-        return hasConsent || !isOptInMode || userExplicitlyIdentified || isJWTAuth;
+        return hasConsent || userExplicitlyIdentified || isJWTAuth;
     }
     /**
      * Generate a proper UUIDv4 identifier for anonymous user ID
@@ -240,23 +251,21 @@ export class GrainAnalytics {
         }
     }
     /**
-     * Get the effective user ID (global userId or persistent anonymous ID)
+     * Get the effective user ID (v2.0)
      *
-     * GDPR Compliance: In opt-in mode without consent and no explicit user identification,
-     * this should not be called. Use getEphemeralSessionId() instead.
+     * Privacy-first implementation:
+     * - Returns global userId if explicitly set (via identify/login)
+     * - Otherwise uses IdManager to generate:
+     *   - Daily rotating ID (cookieless mode)
+     *   - Permanent ID (with consent)
      */
     getEffectiveUserIdInternal() {
+        // Explicit user identification always takes precedence
         if (this.globalUserId) {
             return this.globalUserId;
         }
-        if (this.persistentAnonymousUserId) {
-            return this.persistentAnonymousUserId;
-        }
-        // Generate a new UUIDv4 identifier as fallback
-        this.persistentAnonymousUserId = this.generateAnonymousUserId();
-        // Try to persist it (will be skipped in opt-in mode without consent)
-        this.savePersistentAnonymousUserId(this.persistentAnonymousUserId);
-        return this.persistentAnonymousUserId;
+        // Use IdManager to generate appropriate ID based on consent
+        return this.idManager.getCurrentUserId();
     }
     log(...args) {
         if (this.config.debug) {
@@ -627,6 +636,7 @@ export class GrainAnalytics {
             try {
                 this.pageTrackingManager = new PageTrackingManager(this, {
                     stripQueryParams: this.config.stripQueryParams,
+                    stripHash: this.config.stripHash,
                     debug: this.config.debug,
                     tenantId: this.config.tenantId,
                 });
@@ -719,6 +729,8 @@ export class GrainAnalytics {
                         debug: this.config.debug,
                         enableMutationObserver: true,
                         mutationDebounceDelay: 500,
+                        tenantId: this.config.tenantId,
+                        apiUrl: this.config.apiUrl,
                     });
                     this.log('Interaction tracking initialized');
                 }
@@ -922,12 +934,13 @@ export class GrainAnalytics {
             return;
         const hasConsent = this.consentManager.hasConsent('analytics');
         // Create event with appropriate user ID
+        // v2.0: Always use IdManager which returns daily rotating ID or permanent ID based on consent
         const event = {
             eventName,
-            userId: hasConsent ? this.getEffectiveUserId() : this.getEphemeralSessionId(),
+            userId: this.getEffectiveUserId(), // IdManager handles daily vs permanent based on consent
             properties: {
                 ...properties,
-                _minimal: !hasConsent, // Flag to indicate minimal tracking
+                _minimal: !hasConsent, // Flag to indicate minimal tracking (daily rotating ID)
                 _consent_status: hasConsent ? 'granted' : 'pending',
             },
         };
@@ -1024,17 +1037,22 @@ export class GrainAnalytics {
                 event.properties = filtered;
             }
             const formattedEvent = this.formatEvent(event);
-            // Check consent before tracking
+            // Check if we should wait for consent (only if explicitly configured)
             if (this.consentManager.shouldWaitForConsent() && this.config.waitForConsent) {
                 // Queue event until consent is granted
                 this.waitingForConsentQueue.push(formattedEvent);
                 this.log(`Event waiting for consent: ${event.eventName}`, event.properties);
                 return;
             }
-            if (!this.consentManager.hasConsent('analytics')) {
-                this.log(`Event blocked by consent: ${event.eventName}`);
-                return;
-            }
+            // v2.0: GDPR Strict falls back to cookie-less mode (daily rotating IDs)
+            // Events are never blocked - IdManager already provides correct ID (daily or permanent)
+            const hasConsent = this.consentManager.hasConsent('analytics');
+            // Add tracking flags to indicate consent status
+            formattedEvent.properties = {
+                ...formattedEvent.properties,
+                _minimal: !hasConsent, // Flag: true = daily rotating ID, false = permanent ID
+                _consent_status: hasConsent ? 'granted' : 'pending',
+            };
             this.eventQueue.push(formattedEvent);
             this.eventCountSinceLastHeartbeat++;
             this.sessionEventCount++;
@@ -1722,13 +1740,24 @@ export class GrainAnalytics {
     }
     // Privacy & Consent Methods
     /**
-     * Grant consent for tracking
+     * Grant consent for tracking (v2.0)
+     * Switches from cookie-less mode to permanent IDs
      * @param categories - Optional array of consent categories (e.g., ['analytics', 'functional'])
      */
     grantConsent(categories) {
         try {
             this.consentManager.grantConsent(categories);
-            this.log('Consent granted', categories);
+            // Sync ID manager with consent state
+            const idMode = this.consentManager.getIdMode();
+            this.idManager.setMode(idMode);
+            this.log('Consent granted, switched to permanent IDs', categories);
+            // Process any queued events waiting for consent
+            if (this.waitingForConsentQueue.length > 0) {
+                this.log(`Processing ${this.waitingForConsentQueue.length} queued events`);
+                this.eventQueue.push(...this.waitingForConsentQueue);
+                this.waitingForConsentQueue = [];
+                this.flush();
+            }
         }
         catch (error) {
             const formattedError = this.formatError(error, 'grantConsent');
@@ -1736,16 +1765,22 @@ export class GrainAnalytics {
         }
     }
     /**
-     * Revoke consent for tracking (opt-out)
+     * Revoke consent for tracking (v2.0)
+     * Switches from permanent IDs to cookie-less mode
      * @param categories - Optional array of categories to revoke (if not provided, revokes all)
      */
     revokeConsent(categories) {
         try {
             this.consentManager.revokeConsent(categories);
-            this.log('Consent revoked', categories);
-            // Clear queued events when consent is revoked
-            this.eventQueue = [];
-            this.waitingForConsentQueue = [];
+            // Sync ID manager with consent state
+            const idMode = this.consentManager.getIdMode();
+            this.idManager.setMode(idMode);
+            this.log('Consent revoked, switched to cookie-less mode', categories);
+            // Clear queued events when consent is fully revoked
+            if (!this.consentManager.hasConsent()) {
+                this.eventQueue = [];
+                this.waitingForConsentQueue = [];
+            }
         }
         catch (error) {
             const formattedError = this.formatError(error, 'revokeConsent');
@@ -1777,6 +1812,93 @@ export class GrainAnalytics {
     offConsentChange(listener) {
         this.consentManager.removeListener(listener);
     }
+    /**
+     * Check for debug mode parameters and initialize debug agent if valid
+     */
+    checkAndInitializeDebugMode() {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const urlParams = new URLSearchParams(window.location.search);
+            const isDebug = urlParams.get('grain_debug') === '1';
+            const sessionId = urlParams.get('grain_session');
+            if (!isDebug || !sessionId) {
+                return;
+            }
+            this.log('Debug mode detected, verifying session:', sessionId);
+            // Verify session with API
+            this.verifyDebugSession(sessionId, window.location.hostname)
+                .then((valid) => {
+                if (valid) {
+                    this.log('Debug session verified, initializing debug agent');
+                    this.isDebugMode = true;
+                    this.initializeDebugAgent(sessionId);
+                }
+                else {
+                    this.log('Debug session verification failed');
+                }
+            })
+                .catch((error) => {
+                this.log('Failed to verify debug session:', error);
+            });
+        }
+        catch (error) {
+            this.log('Error checking debug mode:', error);
+        }
+    }
+    /**
+     * Verify debug session with API
+     */
+    async verifyDebugSession(sessionId, domain) {
+        try {
+            const url = `${this.config.apiUrl}/v1/tenant/${encodeURIComponent(this.config.tenantId)}/debug-sessions/verify`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    sessionId,
+                    domain,
+                }),
+            });
+            if (!response.ok) {
+                return false;
+            }
+            const result = await response.json();
+            return result.valid === true;
+        }
+        catch (error) {
+            this.log('Debug session verification error:', error);
+            return false;
+        }
+    }
+    /**
+     * Initialize debug agent
+     */
+    initializeDebugAgent(sessionId) {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            this.log('Loading debug agent module');
+            import('./debug-agent').then(({ DebugAgent }) => {
+                try {
+                    this.debugAgent = new DebugAgent(this, sessionId, this.config.tenantId, this.config.apiUrl, {
+                        debug: this.config.debug,
+                    });
+                    this.log('Debug agent initialized');
+                }
+                catch (error) {
+                    this.log('Failed to initialize debug agent:', error);
+                }
+            }).catch((error) => {
+                this.log('Failed to load debug agent module:', error);
+            });
+        }
+        catch (error) {
+            this.log('Error initializing debug agent:', error);
+        }
+    }
     /**
      * Destroy the client and clean up resources
      */
@@ -1816,6 +1938,11 @@ export class GrainAnalytics {
             this.heatmapTrackingManager.destroy();
             this.heatmapTrackingManager = null;
         }
+        // Destroy debug agent
+        if (this.debugAgent) {
+            this.debugAgent.destroy();
+            this.debugAgent = null;
+        }
         // Send any remaining events (in chunks if necessary)
         if (this.eventQueue.length > 0) {
             const eventsToSend = [...this.eventQueue];

package/dist/interaction-tracking.d.ts

@@ -15,6 +15,8 @@ export interface InteractionTrackingConfig {
     debug?: boolean;
     enableMutationObserver?: boolean;
     mutationDebounceDelay?: number;
+    tenantId?: string;
+    apiUrl?: string;
 }
 export declare class InteractionTrackingManager {
     private tracker;
@@ -26,6 +28,10 @@ export declare class InteractionTrackingManager {
     private mutationObserver;
     private mutationDebounceTimer;
     constructor(tracker: InteractionTracker, interactions: InteractionConfig[], config?: InteractionTrackingConfig);
+    /**
+     * Fetch trackers from API and merge with existing interactions
+     */
+    private fetchAndMergeTrackers;
     /**
      * Attach listeners to all configured interactions
      */

package/dist/interaction-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction-tracking.d.ts","sourceRoot":"","sources":["../src/interaction-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjH,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IACxE,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAA6E;IACtG,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,qBAAqB,CAAuB;gBAGlD,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,iBAAiB,EAAE,EACjC,MAAM,GAAE,yBAA8B;IA0BxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAiCjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAoB3D;;OAEG;IACH,OAAO,IAAI,IAAI;CA4BhB"}
+{"version":3,"file":"interaction-tracking.d.ts","sourceRoot":"","sources":["../src/interaction-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjH,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IACxE,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAA6E;IACtG,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,qBAAqB,CAAuB;gBAGlD,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,iBAAiB,EAAE,EACjC,MAAM,GAAE,yBAA8B;IAmCxC;;OAEG;YACW,qBAAqB;IA6CnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAiCjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAoB3D;;OAEG;IACH,OAAO,IAAI,IAAI;CA4BhB"}

package/dist/interaction-tracking.js

@@ -19,15 +19,25 @@ class InteractionTrackingManager {
             debug: config.debug ?? false,
             enableMutationObserver: config.enableMutationObserver ?? true,
             mutationDebounceDelay: config.mutationDebounceDelay ?? 500,
+            tenantId: config.tenantId,
+            apiUrl: config.apiUrl,
         };
         if (typeof window !== 'undefined' && typeof document !== 'undefined') {
-            // Attach listeners after DOM is ready
-            if (document.readyState === 'loading') {
-                document.addEventListener('DOMContentLoaded', () => this.attachAllListeners());
+            // Fetch and merge trackers if configured
+            if (this.config.tenantId && this.config.apiUrl) {
+                this.fetchAndMergeTrackers().then(() => {
+                    this.attachAllListeners();
+                });
             }
             else {
-                // DOM already loaded
-                setTimeout(() => this.attachAllListeners(), 0);
+                // Attach listeners after DOM is ready
+                if (document.readyState === 'loading') {
+                    document.addEventListener('DOMContentLoaded', () => this.attachAllListeners());
+                }
+                else {
+                    // DOM already loaded
+                    setTimeout(() => this.attachAllListeners(), 0);
+                }
             }
             // Setup mutation observer for dynamic content
             if (this.config.enableMutationObserver) {
@@ -35,6 +45,46 @@ class InteractionTrackingManager {
             }
         }
     }
+    /**
+     * Fetch trackers from API and merge with existing interactions
+     */
+    async fetchAndMergeTrackers() {
+        if (!this.config.tenantId || !this.config.apiUrl)
+            return;
+        try {
+            const currentUrl = typeof window !== 'undefined' ? window.location.href : '';
+            const url = `${this.config.apiUrl}/v1/client/${encodeURIComponent(this.config.tenantId)}/trackers?url=${encodeURIComponent(currentUrl)}`;
+            this.log('Fetching trackers from:', url);
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+            if (!response.ok) {
+                this.log('Failed to fetch trackers:', response.status);
+                return;
+            }
+            const result = await response.json();
+            if (result.trackers && Array.isArray(result.trackers)) {
+                this.log('Fetched', result.trackers.length, 'trackers');
+                // Convert trackers to InteractionConfig format
+                const trackerInteractions = result.trackers.map((tracker) => ({
+                    eventName: tracker.eventName,
+                    selector: tracker.selector,
+                    priority: 5, // High priority for manually created trackers
+                    label: tracker.eventName,
+                    description: `Tracker: ${tracker.eventName}`,
+                }));
+                // Merge with existing interactions (trackers take precedence)
+                this.interactions = [...trackerInteractions, ...this.interactions];
+                this.log('Merged trackers, total interactions:', this.interactions.length);
+            }
+        }
+        catch (error) {
+            this.log('Error fetching trackers:', error);
+        }
+    }
     /**
      * Attach listeners to all configured interactions
      */

package/dist/page-tracking.d.ts

@@ -4,6 +4,7 @@
  */
 export interface PageTrackingConfig {
     stripQueryParams: boolean;
+    stripHash?: boolean;
     debug?: boolean;
     tenantId: string;
 }
@@ -63,8 +64,13 @@ export declare class PageTrackingManager {
     private getDeviceType;
     /**
      * Extract path from URL, optionally stripping query parameters
+     * Privacy-first: strips query params by default
      */
     private extractPath;
+    /**
+     * Clean URL for privacy (strip query params based on config)
+     */
+    private cleanUrl;
     /**
      * Get the current page path
      */

package/dist/page-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-tracking.d.ts","sourceRoot":"","sources":["../src/page-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB;IAY5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc,CAGpB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4GxB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,KAAK;IAUb;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqCnE;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAqBhB"}
+{"version":3,"file":"page-tracking.d.ts","sourceRoot":"","sources":["../src/page-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB;IAY5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc,CAGpB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4GxB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,KAAK;IAUb;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqCnE;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAqBhB"}

package/dist/page-tracking.js

@@ -113,7 +113,7 @@ class PageTrackingManager {
         // Enhanced properties when consent is granted
         if (hasConsent) {
             properties.title = document.title || '';
-            properties.full_url = currentUrl;
+            properties.full_url = this.cleanUrl(currentUrl); // Clean URL based on privacy settings
             properties.session_id = this.tracker.getSessionId();
             // Add referrer info
             if (referrer) {
@@ -231,14 +231,20 @@ class PageTrackingManager {
     }
     /**
      * Extract path from URL, optionally stripping query parameters
+     * Privacy-first: strips query params by default
      */
     extractPath(url) {
         try {
             const urlObj = new URL(url);
-            let path = urlObj.pathname + urlObj.hash;
+            let path = urlObj.pathname;
+            // Include query params only if not stripping
             if (!this.config.stripQueryParams && urlObj.search) {
                 path += urlObj.search;
             }
+            // Include hash only if not stripping
+            if (!this.config.stripHash && urlObj.hash) {
+                path += urlObj.hash;
+            }
             return path;
         }
         catch (error) {
@@ -249,6 +255,21 @@ class PageTrackingManager {
             return url;
         }
     }
+    /**
+     * Clean URL for privacy (strip query params based on config)
+     */
+    cleanUrl(url) {
+        if (!this.config.stripQueryParams) {
+            return url;
+        }
+        try {
+            const urlObj = new URL(url);
+            return `${urlObj.origin}${urlObj.pathname}${this.config.stripHash ? '' : urlObj.hash}`;
+        }
+        catch (error) {
+            return url;
+        }
+    }
     /**
      * Get the current page path
      */

package/dist/react/hooks/useConsent.d.ts

@@ -1,7 +1,8 @@
 /**
- * useConsent - Hook for managing user consent
+ * useConsent - Hook for managing user consent (v2.0)
+ * Updated for new consent modes: cookieless, gdpr-strict, gdpr-opt-out
  */
-import type { ConsentState } from '../../consent';
+import type { ConsentState, ConsentMode } from '../../consent';
 export declare function useConsent(): {
     consentState: ConsentState;
     grantConsent: (categories?: string[]) => void;
@@ -10,4 +11,19 @@ export declare function useConsent(): {
     isGranted: boolean;
     categories: string[];
 };
+/**
+ * useConsentMode - Hook to get current consent mode
+ * v2.0: Returns 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out'
+ */
+export declare function useConsentMode(): ConsentMode | null;
+/**
+ * useTrackingId - Hook to get current tracking ID
+ * v2.0: Returns daily rotating ID or permanent ID based on consent
+ */
+export declare function useTrackingId(): string | null;
+/**
+ * useCanTrack - Hook to check if tracking is allowed
+ * v2.0: Always returns true (even cookieless mode allows basic tracking)
+ */
+export declare function useCanTrack(): boolean;
 //# sourceMappingURL=useConsent.d.ts.map

package/dist/react/hooks/useConsent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConsent.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,wBAAgB,UAAU;;gCAwBR,MAAM,EAAE;iCASR,MAAM,EAAE;4BASV,MAAM;;;EAerB"}
+{"version":3,"file":"useConsent.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/D,wBAAgB,UAAU;;gCAwBR,MAAM,EAAE;iCASR,MAAM,EAAE;4BASV,MAAM;;;EAerB;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAanD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAiB7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC"}