@grainql/analytics-web 2.5.3 → 2.5.4

package/dist/index.js

@@ -417,10 +417,46 @@ class GrainAnalytics {
         }
     }
     formatEvent(event) {
+        const properties = event.properties || {};
+        // Auto-enrich events with session-level attribution properties
+        // This ensures UTM parameters and attribution data are available on ALL events, not just page_view
+        if (!this.config.disableAutoProperties && typeof window !== 'undefined') {
+            const hasConsent = this.consentManager.hasConsent('analytics');
+            // Only enrich if not a system event (they handle their own properties)
+            const isSystemEvent = event.eventName.startsWith('_grain_');
+            if (!isSystemEvent && hasConsent) {
+                // Get session UTM parameters
+                const sessionUTMs = (0, attribution_1.getSessionUTMParameters)();
+                if (sessionUTMs) {
+                    if (sessionUTMs.utm_source)
+                        properties.utm_source = sessionUTMs.utm_source;
+                    if (sessionUTMs.utm_medium)
+                        properties.utm_medium = sessionUTMs.utm_medium;
+                    if (sessionUTMs.utm_campaign)
+                        properties.utm_campaign = sessionUTMs.utm_campaign;
+                    if (sessionUTMs.utm_term)
+                        properties.utm_term = sessionUTMs.utm_term;
+                    if (sessionUTMs.utm_content)
+                        properties.utm_content = sessionUTMs.utm_content;
+                }
+                // Get first-touch attribution
+                const firstTouch = (0, attribution_1.getFirstTouchAttribution)(this.config.tenantId);
+                if (firstTouch) {
+                    properties.first_touch_source = firstTouch.source;
+                    properties.first_touch_medium = firstTouch.medium;
+                    properties.first_touch_campaign = firstTouch.campaign;
+                    properties.first_touch_referrer_category = firstTouch.referrer_category;
+                }
+                // Add session ID if not already present
+                if (!properties.session_id) {
+                    properties.session_id = this.getSessionId();
+                }
+            }
+        }
         return {
             eventName: event.eventName,
             userId: event.userId || this.getEffectiveUserIdInternal(),
-            properties: event.properties || {},
+            properties,
         };
     }
     async getAuthHeaders() {

package/dist/index.mjs

@@ -7,7 +7,7 @@ import { setCookie, getCookie, areCookiesEnabled } from './cookies.js';
 import { ActivityDetector } from './activity.js';
 import { HeartbeatManager } from './heartbeat.js';
 import { PageTrackingManager } from './page-tracking.js';
-import { categorizeReferrer, parseUTMParameters, getOrCreateFirstTouchAttribution, getSessionUTMParameters, } from './attribution.js';
+import { categorizeReferrer, parseUTMParameters, getOrCreateFirstTouchAttribution, getSessionUTMParameters, getFirstTouchAttribution, } from './attribution.js';
 export { categorizeReferrer, parseUTMParameters };
 // Re-export timezone-country utilities
 export { getCountry, getCountryCodeFromTimezone, getState } from './countries.js';
@@ -376,10 +376,46 @@ export class GrainAnalytics {
         }
     }
     formatEvent(event) {
+        const properties = event.properties || {};
+        // Auto-enrich events with session-level attribution properties
+        // This ensures UTM parameters and attribution data are available on ALL events, not just page_view
+        if (!this.config.disableAutoProperties && typeof window !== 'undefined') {
+            const hasConsent = this.consentManager.hasConsent('analytics');
+            // Only enrich if not a system event (they handle their own properties)
+            const isSystemEvent = event.eventName.startsWith('_grain_');
+            if (!isSystemEvent && hasConsent) {
+                // Get session UTM parameters
+                const sessionUTMs = getSessionUTMParameters();
+                if (sessionUTMs) {
+                    if (sessionUTMs.utm_source)
+                        properties.utm_source = sessionUTMs.utm_source;
+                    if (sessionUTMs.utm_medium)
+                        properties.utm_medium = sessionUTMs.utm_medium;
+                    if (sessionUTMs.utm_campaign)
+                        properties.utm_campaign = sessionUTMs.utm_campaign;
+                    if (sessionUTMs.utm_term)
+                        properties.utm_term = sessionUTMs.utm_term;
+                    if (sessionUTMs.utm_content)
+                        properties.utm_content = sessionUTMs.utm_content;
+                }
+                // Get first-touch attribution
+                const firstTouch = getFirstTouchAttribution(this.config.tenantId);
+                if (firstTouch) {
+                    properties.first_touch_source = firstTouch.source;
+                    properties.first_touch_medium = firstTouch.medium;
+                    properties.first_touch_campaign = firstTouch.campaign;
+                    properties.first_touch_referrer_category = firstTouch.referrer_category;
+                }
+                // Add session ID if not already present
+                if (!properties.session_id) {
+                    properties.session_id = this.getSessionId();
+                }
+            }
+        }
         return {
             eventName: event.eventName,
             userId: event.userId || this.getEffectiveUserIdInternal(),
-            properties: event.properties || {},
+            properties,
         };
     }
     async getAuthHeaders() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "2.5.3",
+  "version": "2.5.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",