@grainql/analytics-web 3.0.2 → 3.0.4

package/dist/index.js

@@ -98,7 +98,7 @@ class GrainAnalytics {
             configRefreshInterval: 300000, // 5 minutes
             enableConfigCache: true,
             // Privacy defaults (v2.0)
-            consentMode: 'cookieless', // Default: privacy-first, no permanent tracking
+            consentMode: 'COOKIELESS', // Default: privacy-first, no permanent tracking
             waitForConsent: false,
             disableAutoProperties: false,
             // Automatic Tracking defaults
@@ -191,7 +191,7 @@ class GrainAnalytics {
      */
     shouldAllowPersistentStorage() {
         const hasConsent = this.consentManager.hasConsent('analytics');
-        const isCookieless = this.config.consentMode === 'cookieless';
+        const isCookieless = this.config.consentMode === 'COOKIELESS';
         const userExplicitlyIdentified = !!this.globalUserId;
         const isJWTAuth = this.config.authStrategy === 'JWT';
         // Never allow persistent storage in cookieless mode
@@ -1085,7 +1085,7 @@ class GrainAnalytics {
                 this.log(`Event waiting for consent: ${event.eventName}`, event.properties);
                 return;
             }
-            // v2.0: GDPR Strict falls back to cookie-less mode (daily rotating IDs)
+            // v2.0: GDPR Strict falls back to cookieless 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
@@ -1557,10 +1557,23 @@ class GrainAnalytics {
             const userId = options.userId || this.getEffectiveUserIdInternal();
             const immediateKeys = options.immediateKeys || [];
             const properties = options.properties || {};
+            // Include currentUrl from options, or automatically get it from window.location if available
+            // Strip query parameters and hash to match backend normalization
+            let currentUrl = options.currentUrl ?? (typeof window !== 'undefined' ? window.location.href : undefined);
+            if (currentUrl) {
+                try {
+                    const urlObj = new URL(currentUrl);
+                    currentUrl = `${urlObj.protocol}//${urlObj.host}${urlObj.pathname}`;
+                }
+                catch {
+                    // If URL parsing fails, use as-is
+                }
+            }
             const request = {
                 userId,
                 immediateKeys,
                 properties,
+                currentUrl,
             };
             let lastError;
             for (let attempt = 0; attempt <= this.config.retryAttempts; attempt++) {
@@ -1782,7 +1795,7 @@ class GrainAnalytics {
     // Privacy & Consent Methods
     /**
      * Grant consent for tracking (v2.0)
-     * Switches from cookie-less mode to permanent IDs
+     * Switches from cookieless mode to permanent IDs
      * @param categories - Optional array of consent categories (e.g., ['analytics', 'functional'])
      */
     grantConsent(categories) {
@@ -1807,7 +1820,7 @@ class GrainAnalytics {
     }
     /**
      * Revoke consent for tracking (v2.0)
-     * Switches from permanent IDs to cookie-less mode
+     * Switches from permanent IDs to cookieless mode
      * @param categories - Optional array of categories to revoke (if not provided, revokes all)
      */
     revokeConsent(categories) {
@@ -1816,7 +1829,7 @@ class GrainAnalytics {
             // 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);
+            this.log('Consent revoked, switched to cookieless mode', categories);
             // Clear queued events when consent is fully revoked
             if (!this.consentManager.hasConsent()) {
                 this.eventQueue = [];

package/dist/index.mjs

@@ -57,7 +57,7 @@ export class GrainAnalytics {
             configRefreshInterval: 300000, // 5 minutes
             enableConfigCache: true,
             // Privacy defaults (v2.0)
-            consentMode: 'cookieless', // Default: privacy-first, no permanent tracking
+            consentMode: 'COOKIELESS', // Default: privacy-first, no permanent tracking
             waitForConsent: false,
             disableAutoProperties: false,
             // Automatic Tracking defaults
@@ -150,7 +150,7 @@ export class GrainAnalytics {
      */
     shouldAllowPersistentStorage() {
         const hasConsent = this.consentManager.hasConsent('analytics');
-        const isCookieless = this.config.consentMode === 'cookieless';
+        const isCookieless = this.config.consentMode === 'COOKIELESS';
         const userExplicitlyIdentified = !!this.globalUserId;
         const isJWTAuth = this.config.authStrategy === 'JWT';
         // Never allow persistent storage in cookieless mode
@@ -1044,7 +1044,7 @@ export class GrainAnalytics {
                 this.log(`Event waiting for consent: ${event.eventName}`, event.properties);
                 return;
             }
-            // v2.0: GDPR Strict falls back to cookie-less mode (daily rotating IDs)
+            // v2.0: GDPR Strict falls back to cookieless 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
@@ -1516,10 +1516,23 @@ export class GrainAnalytics {
             const userId = options.userId || this.getEffectiveUserIdInternal();
             const immediateKeys = options.immediateKeys || [];
             const properties = options.properties || {};
+            // Include currentUrl from options, or automatically get it from window.location if available
+            // Strip query parameters and hash to match backend normalization
+            let currentUrl = options.currentUrl ?? (typeof window !== 'undefined' ? window.location.href : undefined);
+            if (currentUrl) {
+                try {
+                    const urlObj = new URL(currentUrl);
+                    currentUrl = `${urlObj.protocol}//${urlObj.host}${urlObj.pathname}`;
+                }
+                catch {
+                    // If URL parsing fails, use as-is
+                }
+            }
             const request = {
                 userId,
                 immediateKeys,
                 properties,
+                currentUrl,
             };
             let lastError;
             for (let attempt = 0; attempt <= this.config.retryAttempts; attempt++) {
@@ -1741,7 +1754,7 @@ export class GrainAnalytics {
     // Privacy & Consent Methods
     /**
      * Grant consent for tracking (v2.0)
-     * Switches from cookie-less mode to permanent IDs
+     * Switches from cookieless mode to permanent IDs
      * @param categories - Optional array of consent categories (e.g., ['analytics', 'functional'])
      */
     grantConsent(categories) {
@@ -1766,7 +1779,7 @@ export class GrainAnalytics {
     }
     /**
      * Revoke consent for tracking (v2.0)
-     * Switches from permanent IDs to cookie-less mode
+     * Switches from permanent IDs to cookieless mode
      * @param categories - Optional array of categories to revoke (if not provided, revokes all)
      */
     revokeConsent(categories) {
@@ -1775,7 +1788,7 @@ export class GrainAnalytics {
             // 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);
+            this.log('Consent revoked, switched to cookieless mode', categories);
             // Clear queued events when consent is fully revoked
             if (!this.consentManager.hasConsent()) {
                 this.eventQueue = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "description": "Lightweight TypeScript SDK for sending analytics events and managing remote configurations via Grain's REST API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",