@grainql/analytics-web 1.2.0 → 1.4.0

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 || {},
         };
     }
@@ -95,12 +100,12 @@ export class GrainAnalytics {
         for (let attempt = 0; attempt <= this.config.retryAttempts; attempt++) {
             try {
                 const headers = await this.getAuthHeaders();
-                const url = `${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}`;
+                const url = `${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}/multi`;
                 this.log(`Sending ${events.length} events to ${url} (attempt ${attempt + 1})`);
                 const response = await fetch(url, {
                     method: 'POST',
                     headers,
-                    body: JSON.stringify(events),
+                    body: JSON.stringify({ events }),
                 });
                 if (!response.ok) {
                     let errorMessage = `HTTP ${response.status}`;
@@ -146,7 +151,7 @@ export class GrainAnalytics {
             return;
         try {
             const headers = await this.getAuthHeaders();
-            const url = `${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}`;
+            const url = `${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}/multi`;
             const body = JSON.stringify({ events });
             // Try beacon API first (more reliable for page unload)
             if (typeof navigator !== 'undefined' && 'sendBeacon' in navigator) {
@@ -246,9 +251,159 @@ 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;
+    }
+    /**
+     * Set user properties
+     */
+    async setProperty(properties, options) {
+        if (this.isDestroyed) {
+            throw new Error('Grain Analytics: Client has been destroyed');
+        }
+        const userId = options?.userId || this.globalUserId || 'anonymous';
+        // Validate property count (max 4 properties)
+        const propertyKeys = Object.keys(properties);
+        if (propertyKeys.length > 4) {
+            throw new Error('Grain Analytics: Maximum 4 properties allowed per request');
+        }
+        if (propertyKeys.length === 0) {
+            throw new Error('Grain Analytics: At least one property is required');
+        }
+        // Serialize all values to strings
+        const serializedProperties = {};
+        for (const [key, value] of Object.entries(properties)) {
+            if (value === null || value === undefined) {
+                serializedProperties[key] = '';
+            }
+            else if (typeof value === 'string') {
+                serializedProperties[key] = value;
+            }
+            else {
+                serializedProperties[key] = JSON.stringify(value);
+            }
+        }
+        const payload = {
+            userId,
+            ...serializedProperties,
+        };
+        await this.sendProperties(payload);
+    }
+    /**
+     * Send properties to the API
+     */
+    async sendProperties(payload) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.config.retryAttempts; attempt++) {
+            try {
+                const headers = await this.getAuthHeaders();
+                const url = `${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}/properties`;
+                this.log(`Setting properties for user ${payload.userId} (attempt ${attempt + 1})`);
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(payload),
+                });
+                if (!response.ok) {
+                    let errorMessage = `HTTP ${response.status}`;
+                    try {
+                        const errorBody = await response.json();
+                        if (errorBody?.message) {
+                            errorMessage = errorBody.message;
+                        }
+                    }
+                    catch {
+                        const errorText = await response.text();
+                        if (errorText) {
+                            errorMessage = errorText;
+                        }
+                    }
+                    const error = new Error(`Failed to set properties: ${errorMessage}`);
+                    error.status = response.status;
+                    throw error;
+                }
+                this.log(`Successfully set properties for user ${payload.userId}`);
+                return; // Success, exit retry loop
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt === this.config.retryAttempts) {
+                    // Last attempt, don't retry
+                    break;
+                }
+                if (!this.isRetriableError(error)) {
+                    // Non-retriable error, don't retry
+                    break;
+                }
+                const delayMs = this.config.retryDelay * Math.pow(2, attempt); // Exponential backoff
+                this.log(`Retrying in ${delayMs}ms after error:`, error);
+                await this.delay(delayMs);
+            }
+        }
+        console.error('[Grain Analytics] Failed to set properties after all retries:', lastError);
+        throw lastError;
+    }
+    // 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.4.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"