aurea-tracking-sdk 1.0.1 → 1.1.1

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;
     /**
@@ -62,6 +68,10 @@ declare class AureaSDK {
      * Get or create anonymous ID
      */
     private getOrCreateAnonymousId;
+    /**
+     * Parse device information from user agent
+     */
+    private parseDeviceInfo;
     /**
      * Build event context
      */
@@ -107,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;
     /**
@@ -62,6 +68,10 @@ declare class AureaSDK {
      * Get or create anonymous ID
      */
     private getOrCreateAnonymousId;
+    /**
+     * Parse device information from user agent
+     */
+    private parseDeviceInfo;
     /**
      * Build event context
      */
@@ -107,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

@@ -27,10 +27,24 @@ __export(index_exports, {
   trackPage: () => trackPage
 });
 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,
@@ -82,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,
@@ -107,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);
@@ -119,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
+      });
     }
   }
   /**
@@ -184,6 +208,48 @@ var AureaSDK = class {
     }
     return anonymousId;
   }
+  /**
+   * Parse device information from user agent
+   */
+  parseDeviceInfo() {
+    if (typeof navigator === "undefined") return void 0;
+    const parser = new import_ua_parser_js.UAParser(navigator.userAgent);
+    const result = parser.getResult();
+    let deviceType = "Desktop";
+    if (result.device.type) {
+      switch (result.device.type.toLowerCase()) {
+        case "mobile":
+          deviceType = "Mobile";
+          break;
+        case "tablet":
+          deviceType = "Tablet";
+          break;
+        case "smarttv":
+          deviceType = "Smart TV";
+          break;
+        case "wearable":
+          deviceType = "Wearable";
+          break;
+        case "console":
+          deviceType = "Console";
+          break;
+        default:
+          deviceType = "Desktop";
+      }
+    }
+    return {
+      userAgent: navigator.userAgent,
+      deviceType,
+      browserName: result.browser.name || "Unknown",
+      browserVersion: result.browser.version || "Unknown",
+      osName: result.os.name || "Unknown",
+      osVersion: result.os.version || "Unknown",
+      screenWidth: window.screen?.width,
+      screenHeight: window.screen?.height,
+      language: navigator.language,
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+    };
+  }
   /**
    * Build event context
    */
@@ -210,13 +276,7 @@ var AureaSDK = class {
       session: {
         sessionId: this.sessionId
       },
-      device: typeof navigator !== "undefined" ? {
-        userAgent: navigator.userAgent,
-        screenWidth: window.screen?.width,
-        screenHeight: window.screen?.height,
-        language: navigator.language,
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
-      } : void 0
+      device: typeof navigator !== "undefined" ? this.parseDeviceInfo() : void 0
     };
   }
   /**
@@ -400,6 +460,144 @@ 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);
+      this.track("session_end", {
+        duration: totalDuration,
+        activeTime: activeTimeSeconds,
+        idleTime: totalDuration - activeTimeSeconds,
+        engagementRate: totalDuration > 0 ? activeTimeSeconds / totalDuration * 100 : 0
+      });
+      this.flushEvents();
+    });
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Session timing tracking enabled");
+    }
+  }
   /**
    * Generate unique ID
    */

package/dist/index.mjs

@@ -1,8 +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,
@@ -54,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,
@@ -79,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);
@@ -91,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
+      });
     }
   }
   /**
@@ -156,6 +180,48 @@ var AureaSDK = class {
     }
     return anonymousId;
   }
+  /**
+   * Parse device information from user agent
+   */
+  parseDeviceInfo() {
+    if (typeof navigator === "undefined") return void 0;
+    const parser = new UAParser(navigator.userAgent);
+    const result = parser.getResult();
+    let deviceType = "Desktop";
+    if (result.device.type) {
+      switch (result.device.type.toLowerCase()) {
+        case "mobile":
+          deviceType = "Mobile";
+          break;
+        case "tablet":
+          deviceType = "Tablet";
+          break;
+        case "smarttv":
+          deviceType = "Smart TV";
+          break;
+        case "wearable":
+          deviceType = "Wearable";
+          break;
+        case "console":
+          deviceType = "Console";
+          break;
+        default:
+          deviceType = "Desktop";
+      }
+    }
+    return {
+      userAgent: navigator.userAgent,
+      deviceType,
+      browserName: result.browser.name || "Unknown",
+      browserVersion: result.browser.version || "Unknown",
+      osName: result.os.name || "Unknown",
+      osVersion: result.os.version || "Unknown",
+      screenWidth: window.screen?.width,
+      screenHeight: window.screen?.height,
+      language: navigator.language,
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+    };
+  }
   /**
    * Build event context
    */
@@ -182,13 +248,7 @@ var AureaSDK = class {
       session: {
         sessionId: this.sessionId
       },
-      device: typeof navigator !== "undefined" ? {
-        userAgent: navigator.userAgent,
-        screenWidth: window.screen?.width,
-        screenHeight: window.screen?.height,
-        language: navigator.language,
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
-      } : void 0
+      device: typeof navigator !== "undefined" ? this.parseDeviceInfo() : void 0
     };
   }
   /**
@@ -372,6 +432,144 @@ 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);
+      this.track("session_end", {
+        duration: totalDuration,
+        activeTime: activeTimeSeconds,
+        idleTime: totalDuration - activeTimeSeconds,
+        engagementRate: totalDuration > 0 ? activeTimeSeconds / totalDuration * 100 : 0
+      });
+      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.0.1",
+  "version": "1.1.1",
   "description": "Standalone tracking SDK for Aurea CRM external funnels",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -26,15 +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",
+    "web-vitals": "^5.1.0"
   }
 }