aurea-tracking-sdk 1.1.0 → 1.1.2

package/dist/index.d.mts

@@ -33,6 +33,12 @@ declare class AureaSDK {
     private eventQueue;
     private batchTimer?;
     private initialized;
+    private sessionStartTime;
+    private pageStartTime;
+    private activeTime;
+    private lastActiveTimestamp;
+    private isPageVisible;
+    private webVitalsCollected;
     constructor(config: AureaConfig);
     /**
      * Initialize the SDK
@@ -43,7 +49,7 @@ declare class AureaSDK {
      */
     track(eventName: string, properties?: Record<string, any>): void;
     /**
-     * Identify a user
+     * Identify a user (links anonymous user to known user)
      */
     identify(userId: string, traits?: Record<string, any>): void;
     /**
@@ -111,6 +117,14 @@ declare class AureaSDK {
      * Check if user has completed a purchase
      */
     private checkForPurchase;
+    /**
+     * Track Core Web Vitals
+     */
+    private trackWebVitals;
+    /**
+     * Track session timing (active time, duration)
+     */
+    private trackSessionTiming;
     /**
      * Generate unique ID
      */

package/dist/index.d.ts

@@ -33,6 +33,12 @@ declare class AureaSDK {
     private eventQueue;
     private batchTimer?;
     private initialized;
+    private sessionStartTime;
+    private pageStartTime;
+    private activeTime;
+    private lastActiveTimestamp;
+    private isPageVisible;
+    private webVitalsCollected;
     constructor(config: AureaConfig);
     /**
      * Initialize the SDK
@@ -43,7 +49,7 @@ declare class AureaSDK {
      */
     track(eventName: string, properties?: Record<string, any>): void;
     /**
-     * Identify a user
+     * Identify a user (links anonymous user to known user)
      */
     identify(userId: string, traits?: Record<string, any>): void;
     /**
@@ -111,6 +117,14 @@ declare class AureaSDK {
      * Check if user has completed a purchase
      */
     private checkForPurchase;
+    /**
+     * Track Core Web Vitals
+     */
+    private trackWebVitals;
+    /**
+     * Track session timing (active time, duration)
+     */
+    private trackSessionTiming;
     /**
      * Generate unique ID
      */

package/dist/index.js

@@ -28,10 +28,23 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_ua_parser_js = require("ua-parser-js");
+var import_web_vitals = require("web-vitals");
 var AureaSDK = class {
   constructor(config) {
     this.eventQueue = [];
     this.initialized = false;
+    this.sessionStartTime = Date.now();
+    this.pageStartTime = Date.now();
+    this.activeTime = 0;
+    this.lastActiveTimestamp = Date.now();
+    this.isPageVisible = true;
+    this.webVitalsCollected = {
+      lcp: false,
+      inp: false,
+      cls: false,
+      fcp: false,
+      ttfb: false
+    };
     this.config = {
       apiUrl: "http://localhost:3000/api",
       debug: false,
@@ -64,9 +77,9 @@ var AureaSDK = class {
       console.warn("[Aurea SDK] Already initialized");
       return;
     }
-    if (this.config.respectDoNotTrack && typeof navigator !== "undefined" && (navigator.doNotTrack === "1" || navigator.msDoNotTrack === "1")) {
+    if (this.config.respectDoNotTrack && typeof navigator !== "undefined" && (navigator.doNotTrack === "1" || navigator.msDoNotTrack === "1" || navigator.globalPrivacyControl === true)) {
       if (this.config.debug) {
-        console.log("[Aurea SDK] Do Not Track enabled, skipping initialization");
+        console.log("[Aurea SDK] Do Not Track or Global Privacy Control enabled, skipping initialization");
       }
       return;
     }
@@ -83,6 +96,8 @@ var AureaSDK = class {
     }
     this.startBatchTimer();
     this.startPurchasePolling();
+    this.trackWebVitals();
+    this.trackSessionTiming();
     if (this.config.debug) {
       console.log("[Aurea SDK] Initialized", {
         sessionId: this.sessionId,
@@ -108,9 +123,10 @@ var AureaSDK = class {
     }
   }
   /**
-   * Identify a user
+   * Identify a user (links anonymous user to known user)
    */
   identify(userId, traits) {
+    const previousUserId = this.userId;
     this.userId = userId;
     if (typeof window !== "undefined") {
       localStorage.setItem("aurea_user_id", userId);
@@ -120,10 +136,17 @@ var AureaSDK = class {
     }
     this.track("user_identified", {
       userId,
-      traits
+      anonymousId: this.anonymousId,
+      previousUserId,
+      traits: traits || {},
+      timestamp: Date.now()
     });
     if (this.config.debug) {
-      console.log("[Aurea SDK] User identified:", userId);
+      console.log("[Aurea SDK] User identified:", {
+        userId,
+        anonymousId: this.anonymousId,
+        traits
+      });
     }
   }
   /**
@@ -437,6 +460,173 @@ var AureaSDK = class {
       }
     }
   }
+  /**
+   * Track Core Web Vitals
+   */
+  trackWebVitals() {
+    if (typeof window === "undefined") return;
+    const getVitalRating = (name, value) => {
+      const thresholds = {
+        LCP: [2500, 4e3],
+        INP: [200, 500],
+        CLS: [0.1, 0.25],
+        FCP: [1800, 3e3],
+        TTFB: [800, 1800]
+      };
+      const [good, needsImprovement] = thresholds[name] || [0, 0];
+      if (value <= good) return "good";
+      if (value <= needsImprovement) return "needs-improvement";
+      return "poor";
+    };
+    (0, import_web_vitals.onLCP)((metric) => {
+      if (!this.webVitalsCollected.lcp) {
+        this.webVitalsCollected.lcp = true;
+        this.track("web_vital", {
+          metric: "lcp",
+          value: metric.value,
+          rating: getVitalRating("LCP", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    (0, import_web_vitals.onINP)((metric) => {
+      if (!this.webVitalsCollected.inp) {
+        this.webVitalsCollected.inp = true;
+        this.track("web_vital", {
+          metric: "inp",
+          value: metric.value,
+          rating: getVitalRating("INP", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    (0, import_web_vitals.onCLS)((metric) => {
+      if (!this.webVitalsCollected.cls) {
+        this.webVitalsCollected.cls = true;
+        this.track("web_vital", {
+          metric: "cls",
+          value: metric.value,
+          rating: getVitalRating("CLS", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    (0, import_web_vitals.onFCP)((metric) => {
+      if (!this.webVitalsCollected.fcp) {
+        this.webVitalsCollected.fcp = true;
+        this.track("web_vital", {
+          metric: "fcp",
+          value: metric.value,
+          rating: getVitalRating("FCP", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    (0, import_web_vitals.onTTFB)((metric) => {
+      if (!this.webVitalsCollected.ttfb) {
+        this.webVitalsCollected.ttfb = true;
+        this.track("web_vital", {
+          metric: "ttfb",
+          value: metric.value,
+          rating: getVitalRating("TTFB", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Core Web Vitals tracking enabled");
+    }
+  }
+  /**
+   * Track session timing (active time, duration)
+   */
+  trackSessionTiming() {
+    if (typeof window === "undefined") return;
+    document.addEventListener("visibilitychange", () => {
+      const now = Date.now();
+      if (document.hidden) {
+        if (this.isPageVisible) {
+          this.activeTime += now - this.lastActiveTimestamp;
+          this.isPageVisible = false;
+        }
+      } else {
+        this.isPageVisible = true;
+        this.lastActiveTimestamp = now;
+      }
+    });
+    let interactionTimeout;
+    const resetInactivityTimer = () => {
+      const now = Date.now();
+      if (!this.isPageVisible) {
+        this.isPageVisible = true;
+        this.lastActiveTimestamp = now;
+      }
+      clearTimeout(interactionTimeout);
+      interactionTimeout = setTimeout(() => {
+        if (this.isPageVisible) {
+          this.activeTime += Date.now() - this.lastActiveTimestamp;
+          this.isPageVisible = false;
+        }
+      }, 3e4);
+    };
+    window.addEventListener("mousemove", resetInactivityTimer, { passive: true });
+    window.addEventListener("keydown", resetInactivityTimer, { passive: true });
+    window.addEventListener("scroll", resetInactivityTimer, { passive: true });
+    window.addEventListener("click", resetInactivityTimer, { passive: true });
+    window.addEventListener("touchstart", resetInactivityTimer, { passive: true });
+    window.addEventListener("beforeunload", () => {
+      const now = Date.now();
+      if (this.isPageVisible) {
+        this.activeTime += now - this.lastActiveTimestamp;
+      }
+      const totalDuration = Math.floor((now - this.sessionStartTime) / 1e3);
+      const activeTimeSeconds = Math.floor(this.activeTime / 1e3);
+      const sessionEndEvent = {
+        eventId: this.generateEventId(),
+        eventName: "session_end",
+        properties: {
+          duration: totalDuration,
+          activeTime: activeTimeSeconds,
+          idleTime: totalDuration - activeTimeSeconds,
+          engagementRate: totalDuration > 0 ? activeTimeSeconds / totalDuration * 100 : 0
+        },
+        context: this.buildContext(),
+        timestamp: Date.now()
+      };
+      const url = `${this.config.apiUrl}/track/events`;
+      const payload = JSON.stringify({
+        events: [sessionEndEvent],
+        batch: false
+      });
+      try {
+        fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-Aurea-API-Key": this.config.apiKey,
+            "X-Aurea-Funnel-ID": this.config.funnelId
+          },
+          body: payload,
+          keepalive: true
+          // Critical: ensures request completes even if page unloads
+        }).catch(() => {
+        });
+        if (this.config.debug) {
+          console.log("[Aurea SDK] Session end sent with keepalive");
+        }
+      } catch (error) {
+      }
+      this.flushEvents();
+    });
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Session timing tracking enabled");
+    }
+  }
   /**
    * Generate unique ID
    */

package/dist/index.mjs

@@ -1,9 +1,22 @@
 // src/index.ts
 import { UAParser } from "ua-parser-js";
+import { onLCP, onINP, onCLS, onFCP, onTTFB } from "web-vitals";
 var AureaSDK = class {
   constructor(config) {
     this.eventQueue = [];
     this.initialized = false;
+    this.sessionStartTime = Date.now();
+    this.pageStartTime = Date.now();
+    this.activeTime = 0;
+    this.lastActiveTimestamp = Date.now();
+    this.isPageVisible = true;
+    this.webVitalsCollected = {
+      lcp: false,
+      inp: false,
+      cls: false,
+      fcp: false,
+      ttfb: false
+    };
     this.config = {
       apiUrl: "http://localhost:3000/api",
       debug: false,
@@ -36,9 +49,9 @@ var AureaSDK = class {
       console.warn("[Aurea SDK] Already initialized");
       return;
     }
-    if (this.config.respectDoNotTrack && typeof navigator !== "undefined" && (navigator.doNotTrack === "1" || navigator.msDoNotTrack === "1")) {
+    if (this.config.respectDoNotTrack && typeof navigator !== "undefined" && (navigator.doNotTrack === "1" || navigator.msDoNotTrack === "1" || navigator.globalPrivacyControl === true)) {
       if (this.config.debug) {
-        console.log("[Aurea SDK] Do Not Track enabled, skipping initialization");
+        console.log("[Aurea SDK] Do Not Track or Global Privacy Control enabled, skipping initialization");
       }
       return;
     }
@@ -55,6 +68,8 @@ var AureaSDK = class {
     }
     this.startBatchTimer();
     this.startPurchasePolling();
+    this.trackWebVitals();
+    this.trackSessionTiming();
     if (this.config.debug) {
       console.log("[Aurea SDK] Initialized", {
         sessionId: this.sessionId,
@@ -80,9 +95,10 @@ var AureaSDK = class {
     }
   }
   /**
-   * Identify a user
+   * Identify a user (links anonymous user to known user)
    */
   identify(userId, traits) {
+    const previousUserId = this.userId;
     this.userId = userId;
     if (typeof window !== "undefined") {
       localStorage.setItem("aurea_user_id", userId);
@@ -92,10 +108,17 @@ var AureaSDK = class {
     }
     this.track("user_identified", {
       userId,
-      traits
+      anonymousId: this.anonymousId,
+      previousUserId,
+      traits: traits || {},
+      timestamp: Date.now()
     });
     if (this.config.debug) {
-      console.log("[Aurea SDK] User identified:", userId);
+      console.log("[Aurea SDK] User identified:", {
+        userId,
+        anonymousId: this.anonymousId,
+        traits
+      });
     }
   }
   /**
@@ -409,6 +432,173 @@ var AureaSDK = class {
       }
     }
   }
+  /**
+   * Track Core Web Vitals
+   */
+  trackWebVitals() {
+    if (typeof window === "undefined") return;
+    const getVitalRating = (name, value) => {
+      const thresholds = {
+        LCP: [2500, 4e3],
+        INP: [200, 500],
+        CLS: [0.1, 0.25],
+        FCP: [1800, 3e3],
+        TTFB: [800, 1800]
+      };
+      const [good, needsImprovement] = thresholds[name] || [0, 0];
+      if (value <= good) return "good";
+      if (value <= needsImprovement) return "needs-improvement";
+      return "poor";
+    };
+    onLCP((metric) => {
+      if (!this.webVitalsCollected.lcp) {
+        this.webVitalsCollected.lcp = true;
+        this.track("web_vital", {
+          metric: "lcp",
+          value: metric.value,
+          rating: getVitalRating("LCP", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    onINP((metric) => {
+      if (!this.webVitalsCollected.inp) {
+        this.webVitalsCollected.inp = true;
+        this.track("web_vital", {
+          metric: "inp",
+          value: metric.value,
+          rating: getVitalRating("INP", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    onCLS((metric) => {
+      if (!this.webVitalsCollected.cls) {
+        this.webVitalsCollected.cls = true;
+        this.track("web_vital", {
+          metric: "cls",
+          value: metric.value,
+          rating: getVitalRating("CLS", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    onFCP((metric) => {
+      if (!this.webVitalsCollected.fcp) {
+        this.webVitalsCollected.fcp = true;
+        this.track("web_vital", {
+          metric: "fcp",
+          value: metric.value,
+          rating: getVitalRating("FCP", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    onTTFB((metric) => {
+      if (!this.webVitalsCollected.ttfb) {
+        this.webVitalsCollected.ttfb = true;
+        this.track("web_vital", {
+          metric: "ttfb",
+          value: metric.value,
+          rating: getVitalRating("TTFB", metric.value),
+          delta: metric.delta,
+          id: metric.id
+        });
+      }
+    });
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Core Web Vitals tracking enabled");
+    }
+  }
+  /**
+   * Track session timing (active time, duration)
+   */
+  trackSessionTiming() {
+    if (typeof window === "undefined") return;
+    document.addEventListener("visibilitychange", () => {
+      const now = Date.now();
+      if (document.hidden) {
+        if (this.isPageVisible) {
+          this.activeTime += now - this.lastActiveTimestamp;
+          this.isPageVisible = false;
+        }
+      } else {
+        this.isPageVisible = true;
+        this.lastActiveTimestamp = now;
+      }
+    });
+    let interactionTimeout;
+    const resetInactivityTimer = () => {
+      const now = Date.now();
+      if (!this.isPageVisible) {
+        this.isPageVisible = true;
+        this.lastActiveTimestamp = now;
+      }
+      clearTimeout(interactionTimeout);
+      interactionTimeout = setTimeout(() => {
+        if (this.isPageVisible) {
+          this.activeTime += Date.now() - this.lastActiveTimestamp;
+          this.isPageVisible = false;
+        }
+      }, 3e4);
+    };
+    window.addEventListener("mousemove", resetInactivityTimer, { passive: true });
+    window.addEventListener("keydown", resetInactivityTimer, { passive: true });
+    window.addEventListener("scroll", resetInactivityTimer, { passive: true });
+    window.addEventListener("click", resetInactivityTimer, { passive: true });
+    window.addEventListener("touchstart", resetInactivityTimer, { passive: true });
+    window.addEventListener("beforeunload", () => {
+      const now = Date.now();
+      if (this.isPageVisible) {
+        this.activeTime += now - this.lastActiveTimestamp;
+      }
+      const totalDuration = Math.floor((now - this.sessionStartTime) / 1e3);
+      const activeTimeSeconds = Math.floor(this.activeTime / 1e3);
+      const sessionEndEvent = {
+        eventId: this.generateEventId(),
+        eventName: "session_end",
+        properties: {
+          duration: totalDuration,
+          activeTime: activeTimeSeconds,
+          idleTime: totalDuration - activeTimeSeconds,
+          engagementRate: totalDuration > 0 ? activeTimeSeconds / totalDuration * 100 : 0
+        },
+        context: this.buildContext(),
+        timestamp: Date.now()
+      };
+      const url = `${this.config.apiUrl}/track/events`;
+      const payload = JSON.stringify({
+        events: [sessionEndEvent],
+        batch: false
+      });
+      try {
+        fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-Aurea-API-Key": this.config.apiKey,
+            "X-Aurea-Funnel-ID": this.config.funnelId
+          },
+          body: payload,
+          keepalive: true
+          // Critical: ensures request completes even if page unloads
+        }).catch(() => {
+        });
+        if (this.config.debug) {
+          console.log("[Aurea SDK] Session end sent with keepalive");
+        }
+      } catch (error) {
+      }
+      this.flushEvents();
+    });
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Session timing tracking enabled");
+    }
+  }
   /**
    * Generate unique ID
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aurea-tracking-sdk",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Standalone tracking SDK for Aurea CRM external funnels",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -26,18 +26,19 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/aurea-tracking-sdk.git"
+    "url": "git+https://github.com/akal0/aurea-tracking-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/yourusername/aurea-tracking-sdk/issues"
+    "url": "https://github.com/akal0/aurea-tracking-sdk/issues"
   },
-  "homepage": "https://github.com/yourusername/aurea-tracking-sdk#readme",
+  "homepage": "https://github.com/akal0/aurea-tracking-sdk#readme",
   "devDependencies": {
     "@types/node": "^25.0.3",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "ua-parser-js": "^2.0.7"
+    "ua-parser-js": "^2.0.7",
+    "web-vitals": "^5.1.0"
   }
 }