@blinkdotnew/sdk 0.9.0 → 0.10.0

package/README.md

@@ -585,14 +585,18 @@ blink.analytics.log('button_clicked', {
 // - device/browser/OS info (parsed server-side)
 // - channel detection (Organic Search, Social, Direct, etc.)
 // - UTM parameters (source, medium, campaign, content, term)
-// - entry_page, exit_page tracking
+// - UTM persistence for attribution tracking across sessions
 
 // Control analytics
 blink.analytics.disable()
 blink.analytics.enable()
 const isEnabled = blink.analytics.isEnabled()
 
+// Clear attribution data (e.g., when user logs out)
+blink.analytics.clearAttribution()
+
 // Features: Privacy-first, offline support, event batching, session management
+// Attribution: UTM params persist across sessions for conversion tracking
 ```
 
 ### Realtime Operations

package/dist/index.d.mts

@@ -268,8 +268,6 @@ interface AnalyticsEvent {
     utm_campaign?: string | null;
     utm_content?: string | null;
     utm_term?: string | null;
-    entry_page?: string | null;
-    exit_page?: string | null;
     [key: string]: any;
 }
 interface BlinkAnalytics {
@@ -279,6 +277,7 @@ interface BlinkAnalytics {
     isEnabled(): boolean;
     setUserId(userId: string | null): void;
     setUserEmail(email: string | null): void;
+    clearAttribution(): void;
 }
 declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private httpClient;
@@ -289,8 +288,8 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private userId;
     private userEmail;
     private hasTrackedPageview;
-    private entryPage;
     private utmParams;
+    private persistedAttribution;
     constructor(httpClient: HttpClient, projectId: string);
     /**
      * Log a custom analytics event
@@ -316,6 +315,10 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
      * Set the user email for analytics events
      */
     setUserEmail(email: string | null): void;
+    /**
+     * Clear persisted attribution data
+     */
+    clearAttribution(): void;
     private buildEvent;
     private sanitizeData;
     private enqueue;
@@ -329,6 +332,8 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private setupRouteChangeListener;
     private setupUnloadListener;
     private captureUTMParams;
+    private loadPersistedAttribution;
+    private persistAttribution;
     private detectChannel;
 }
 

package/dist/index.d.ts

@@ -268,8 +268,6 @@ interface AnalyticsEvent {
     utm_campaign?: string | null;
     utm_content?: string | null;
     utm_term?: string | null;
-    entry_page?: string | null;
-    exit_page?: string | null;
     [key: string]: any;
 }
 interface BlinkAnalytics {
@@ -279,6 +277,7 @@ interface BlinkAnalytics {
     isEnabled(): boolean;
     setUserId(userId: string | null): void;
     setUserEmail(email: string | null): void;
+    clearAttribution(): void;
 }
 declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private httpClient;
@@ -289,8 +288,8 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private userId;
     private userEmail;
     private hasTrackedPageview;
-    private entryPage;
     private utmParams;
+    private persistedAttribution;
     constructor(httpClient: HttpClient, projectId: string);
     /**
      * Log a custom analytics event
@@ -316,6 +315,10 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
      * Set the user email for analytics events
      */
     setUserEmail(email: string | null): void;
+    /**
+     * Clear persisted attribution data
+     */
+    clearAttribution(): void;
     private buildEvent;
     private sanitizeData;
     private enqueue;
@@ -329,6 +332,8 @@ declare class BlinkAnalyticsImpl implements BlinkAnalytics {
     private setupRouteChangeListener;
     private setupUnloadListener;
     private captureUTMParams;
+    private loadPersistedAttribution;
+    private persistAttribution;
     private detectChannel;
 }
 

package/dist/index.js

@@ -2887,6 +2887,7 @@ var BATCH_TIMEOUT = 3e3;
 var MAX_STRING_LENGTH = 256;
 var STORAGE_KEY_QUEUE = "blinkAnalyticsQueue";
 var STORAGE_KEY_SESSION = "blinkAnalyticsSession";
+var STORAGE_KEY_ATTRIBUTION = "blinkAnalyticsAttribution";
 var BlinkAnalyticsImpl = class {
   httpClient;
   projectId;
@@ -2896,8 +2897,8 @@ var BlinkAnalyticsImpl = class {
   userId = null;
   userEmail = null;
   hasTrackedPageview = false;
-  entryPage = null;
   utmParams = {};
+  persistedAttribution = {};
   constructor(httpClient, projectId) {
     this.httpClient = httpClient;
     this.projectId = projectId;
@@ -2908,7 +2909,7 @@ var BlinkAnalyticsImpl = class {
       this.enabled = false;
       return;
     }
-    this.entryPage = window.location.pathname;
+    this.loadPersistedAttribution();
     this.captureUTMParams();
     this.loadQueue();
     this.trackPageview();
@@ -2956,6 +2957,16 @@ var BlinkAnalyticsImpl = class {
   setUserEmail(email) {
     this.userEmail = email;
   }
+  /**
+   * Clear persisted attribution data
+   */
+  clearAttribution() {
+    this.persistedAttribution = {};
+    try {
+      localStorage.removeItem(STORAGE_KEY_ATTRIBUTION);
+    } catch {
+    }
+  }
   // Private methods
   buildEvent(type, data = {}) {
     const sessionId = this.getOrCreateSessionId();
@@ -2971,14 +2982,11 @@ var BlinkAnalyticsImpl = class {
       referrer: document.referrer || null,
       screen_width: window.innerWidth,
       channel,
-      utm_source: this.utmParams.utm_source || null,
-      utm_medium: this.utmParams.utm_medium || null,
-      utm_campaign: this.utmParams.utm_campaign || null,
-      utm_content: this.utmParams.utm_content || null,
-      utm_term: this.utmParams.utm_term || null,
-      entry_page: this.entryPage,
-      exit_page: window.location.pathname,
-      // Current page is potential exit
+      utm_source: this.utmParams.utm_source || this.persistedAttribution.utm_source || null,
+      utm_medium: this.utmParams.utm_medium || this.persistedAttribution.utm_medium || null,
+      utm_campaign: this.utmParams.utm_campaign || this.persistedAttribution.utm_campaign || null,
+      utm_content: this.utmParams.utm_content || this.persistedAttribution.utm_content || null,
+      utm_term: this.utmParams.utm_term || this.persistedAttribution.utm_term || null,
       ...this.sanitizeData(data)
     };
   }
@@ -3122,6 +3130,33 @@ var BlinkAnalyticsImpl = class {
       utm_content: urlParams.get("utm_content"),
       utm_term: urlParams.get("utm_term")
     };
+    const hasNewParams = Object.values(this.utmParams).some((v) => v !== null);
+    if (hasNewParams) {
+      this.persistAttribution();
+    }
+  }
+  loadPersistedAttribution() {
+    try {
+      const stored = localStorage.getItem(STORAGE_KEY_ATTRIBUTION);
+      if (stored) {
+        this.persistedAttribution = JSON.parse(stored);
+      }
+    } catch {
+      this.persistedAttribution = {};
+    }
+  }
+  persistAttribution() {
+    try {
+      const attribution = {
+        ...this.persistedAttribution,
+        ...Object.fromEntries(
+          Object.entries(this.utmParams).filter(([_, v]) => v !== null)
+        )
+      };
+      localStorage.setItem(STORAGE_KEY_ATTRIBUTION, JSON.stringify(attribution));
+      this.persistedAttribution = attribution;
+    } catch {
+    }
   }
   detectChannel() {
     const referrer = document.referrer;

package/dist/index.mjs

@@ -2885,6 +2885,7 @@ var BATCH_TIMEOUT = 3e3;
 var MAX_STRING_LENGTH = 256;
 var STORAGE_KEY_QUEUE = "blinkAnalyticsQueue";
 var STORAGE_KEY_SESSION = "blinkAnalyticsSession";
+var STORAGE_KEY_ATTRIBUTION = "blinkAnalyticsAttribution";
 var BlinkAnalyticsImpl = class {
   httpClient;
   projectId;
@@ -2894,8 +2895,8 @@ var BlinkAnalyticsImpl = class {
   userId = null;
   userEmail = null;
   hasTrackedPageview = false;
-  entryPage = null;
   utmParams = {};
+  persistedAttribution = {};
   constructor(httpClient, projectId) {
     this.httpClient = httpClient;
     this.projectId = projectId;
@@ -2906,7 +2907,7 @@ var BlinkAnalyticsImpl = class {
       this.enabled = false;
       return;
     }
-    this.entryPage = window.location.pathname;
+    this.loadPersistedAttribution();
     this.captureUTMParams();
     this.loadQueue();
     this.trackPageview();
@@ -2954,6 +2955,16 @@ var BlinkAnalyticsImpl = class {
   setUserEmail(email) {
     this.userEmail = email;
   }
+  /**
+   * Clear persisted attribution data
+   */
+  clearAttribution() {
+    this.persistedAttribution = {};
+    try {
+      localStorage.removeItem(STORAGE_KEY_ATTRIBUTION);
+    } catch {
+    }
+  }
   // Private methods
   buildEvent(type, data = {}) {
     const sessionId = this.getOrCreateSessionId();
@@ -2969,14 +2980,11 @@ var BlinkAnalyticsImpl = class {
       referrer: document.referrer || null,
       screen_width: window.innerWidth,
       channel,
-      utm_source: this.utmParams.utm_source || null,
-      utm_medium: this.utmParams.utm_medium || null,
-      utm_campaign: this.utmParams.utm_campaign || null,
-      utm_content: this.utmParams.utm_content || null,
-      utm_term: this.utmParams.utm_term || null,
-      entry_page: this.entryPage,
-      exit_page: window.location.pathname,
-      // Current page is potential exit
+      utm_source: this.utmParams.utm_source || this.persistedAttribution.utm_source || null,
+      utm_medium: this.utmParams.utm_medium || this.persistedAttribution.utm_medium || null,
+      utm_campaign: this.utmParams.utm_campaign || this.persistedAttribution.utm_campaign || null,
+      utm_content: this.utmParams.utm_content || this.persistedAttribution.utm_content || null,
+      utm_term: this.utmParams.utm_term || this.persistedAttribution.utm_term || null,
       ...this.sanitizeData(data)
     };
   }
@@ -3120,6 +3128,33 @@ var BlinkAnalyticsImpl = class {
       utm_content: urlParams.get("utm_content"),
       utm_term: urlParams.get("utm_term")
     };
+    const hasNewParams = Object.values(this.utmParams).some((v) => v !== null);
+    if (hasNewParams) {
+      this.persistAttribution();
+    }
+  }
+  loadPersistedAttribution() {
+    try {
+      const stored = localStorage.getItem(STORAGE_KEY_ATTRIBUTION);
+      if (stored) {
+        this.persistedAttribution = JSON.parse(stored);
+      }
+    } catch {
+      this.persistedAttribution = {};
+    }
+  }
+  persistAttribution() {
+    try {
+      const attribution = {
+        ...this.persistedAttribution,
+        ...Object.fromEntries(
+          Object.entries(this.utmParams).filter(([_, v]) => v !== null)
+        )
+      };
+      localStorage.setItem(STORAGE_KEY_ATTRIBUTION, JSON.stringify(attribution));
+      this.persistedAttribution = attribution;
+    } catch {
+    }
   }
   detectChannel() {
     const referrer = document.referrer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",