@grainql/analytics-web 1.2.0 → 1.3.0

package/dist/index.js

@@ -11,6 +11,7 @@ class GrainAnalytics {
         this.eventQueue = [];
         this.flushTimer = null;
         this.isDestroyed = false;
+        this.globalUserId = null;
         this.config = {
             apiUrl: 'https://api.grainql.com',
             authStrategy: 'NONE',
@@ -23,6 +24,10 @@ class GrainAnalytics {
             ...config,
             tenantId: config.tenantId,
         };
+        // Set global userId if provided in config
+        if (config.userId) {
+            this.globalUserId = config.userId;
+        }
         this.validateConfig();
         this.setupBeforeUnload();
         this.startFlushTimer();
@@ -46,7 +51,7 @@ class GrainAnalytics {
     formatEvent(event) {
         return {
             eventName: event.eventName,
-            userId: event.userId || 'anonymous',
+            userId: event.userId || this.globalUserId || 'anonymous',
             properties: event.properties || {},
         };
     }
@@ -104,7 +109,7 @@ class GrainAnalytics {
                 const response = await fetch(url, {
                     method: 'POST',
                     headers,
-                    body: JSON.stringify(events),
+                    body: JSON.stringify({ events }),
                 });
                 if (!response.ok) {
                     let errorMessage = `HTTP ${response.status}`;
@@ -250,9 +255,70 @@ class GrainAnalytics {
      * Identify a user (sets userId for subsequent events)
      */
     identify(userId) {
-        // Store userId for future events - this would typically be handled
-        // by the application layer, but we can provide a helper
         this.log(`Identified user: ${userId}`);
+        this.globalUserId = userId;
+    }
+    /**
+     * Set global user ID for all subsequent events
+     */
+    setUserId(userId) {
+        this.log(`Set global user ID: ${userId}`);
+        this.globalUserId = userId;
+    }
+    /**
+     * Get current global user ID
+     */
+    getUserId() {
+        return this.globalUserId;
+    }
+    // Template event methods
+    /**
+     * Track user login event
+     */
+    async trackLogin(properties, options) {
+        return this.track('login', properties, options);
+    }
+    /**
+     * Track user signup event
+     */
+    async trackSignup(properties, options) {
+        return this.track('signup', properties, options);
+    }
+    /**
+     * Track checkout event
+     */
+    async trackCheckout(properties, options) {
+        return this.track('checkout', properties, options);
+    }
+    /**
+     * Track page view event
+     */
+    async trackPageView(properties, options) {
+        return this.track('page_view', properties, options);
+    }
+    /**
+     * Track purchase event
+     */
+    async trackPurchase(properties, options) {
+        return this.track('purchase', properties, options);
+    }
+    /**
+     * Track search event
+     */
+    async trackSearch(properties, options) {
+        return this.track('search', properties, options);
+    }
+    /**
+     * Track add to cart event
+     */
+    async trackAddToCart(properties, options) {
+        return this.track('add_to_cart', properties, options);
+    }
+    /**
+     * Track remove from cart event
+     */
+    async trackRemoveFromCart(properties, options) {
+        return this.track('remove_from_cart', properties, options);
     }
     /**
      * Manually flush all queued events

package/dist/index.mjs

@@ -7,6 +7,7 @@ export class GrainAnalytics {
         this.eventQueue = [];
         this.flushTimer = null;
         this.isDestroyed = false;
+        this.globalUserId = null;
         this.config = {
             apiUrl: 'https://api.grainql.com',
             authStrategy: 'NONE',
@@ -19,6 +20,10 @@ export class GrainAnalytics {
             ...config,
             tenantId: config.tenantId,
         };
+        // Set global userId if provided in config
+        if (config.userId) {
+            this.globalUserId = config.userId;
+        }
         this.validateConfig();
         this.setupBeforeUnload();
         this.startFlushTimer();
@@ -42,7 +47,7 @@ export class GrainAnalytics {
     formatEvent(event) {
         return {
             eventName: event.eventName,
-            userId: event.userId || 'anonymous',
+            userId: event.userId || this.globalUserId || 'anonymous',
             properties: event.properties || {},
         };
     }
@@ -100,7 +105,7 @@ export class GrainAnalytics {
                 const response = await fetch(url, {
                     method: 'POST',
                     headers,
-                    body: JSON.stringify(events),
+                    body: JSON.stringify({ events }),
                 });
                 if (!response.ok) {
                     let errorMessage = `HTTP ${response.status}`;
@@ -246,9 +251,70 @@ export class GrainAnalytics {
      * Identify a user (sets userId for subsequent events)
      */
     identify(userId) {
-        // Store userId for future events - this would typically be handled
-        // by the application layer, but we can provide a helper
         this.log(`Identified user: ${userId}`);
+        this.globalUserId = userId;
+    }
+    /**
+     * Set global user ID for all subsequent events
+     */
+    setUserId(userId) {
+        this.log(`Set global user ID: ${userId}`);
+        this.globalUserId = userId;
+    }
+    /**
+     * Get current global user ID
+     */
+    getUserId() {
+        return this.globalUserId;
+    }
+    // Template event methods
+    /**
+     * Track user login event
+     */
+    async trackLogin(properties, options) {
+        return this.track('login', properties, options);
+    }
+    /**
+     * Track user signup event
+     */
+    async trackSignup(properties, options) {
+        return this.track('signup', properties, options);
+    }
+    /**
+     * Track checkout event
+     */
+    async trackCheckout(properties, options) {
+        return this.track('checkout', properties, options);
+    }
+    /**
+     * Track page view event
+     */
+    async trackPageView(properties, options) {
+        return this.track('page_view', properties, options);
+    }
+    /**
+     * Track purchase event
+     */
+    async trackPurchase(properties, options) {
+        return this.track('purchase', properties, options);
+    }
+    /**
+     * Track search event
+     */
+    async trackSearch(properties, options) {
+        return this.track('search', properties, options);
+    }
+    /**
+     * Track add to cart event
+     */
+    async trackAddToCart(properties, options) {
+        return this.track('add_to_cart', properties, options);
+    }
+    /**
+     * Track remove from cart event
+     */
+    async trackRemoveFromCart(properties, options) {
+        return this.track('remove_from_cart', properties, options);
     }
     /**
      * Manually flush all queued events

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Lightweight TypeScript SDK for sending analytics events to Grain's REST API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -22,10 +22,10 @@
     "build:cjs": "tsc --module commonjs --target es2020 --outDir dist/cjs && mv dist/cjs/index.js dist/index.js",
     "build:iife": "node scripts/build-iife.js",
     "clean": "rm -rf dist",
-    "test": "echo 'Tests disabled'",
-    "test:watch": "echo 'Tests disabled'",
-    "test:coverage": "echo 'Tests disabled'",
-    "test:ci": "echo 'Tests disabled'",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --ci --coverage",
     "prepublishOnly": "npm run clean && npm run build",
     "size": "npm run build && node scripts/bundle-analysis.js",
     "size:limit": "size-limit"