aurea-tracking-sdk 1.3.0 → 1.3.2

package/dist/index.d.mts

@@ -9,6 +9,7 @@ interface EventCategoryConfig {
     value?: number;
     description?: string;
     trackOnce?: boolean;
+    color?: string;
 }
 interface AureaConfig {
     apiKey: string;
@@ -202,6 +203,7 @@ declare class AureaSDK {
         value?: number;
         advanceTo?: FunnelStage;
         description?: string;
+        color?: string;
     }): void;
     /**
      * Get current event category statistics
@@ -258,6 +260,12 @@ declare class AureaSDK {
      * Track checkout abandoned (user left without completing)
      */
     checkoutAbandoned(reason?: string): void;
+    /**
+     * Manually end the current session
+     * Useful before page navigation (e.g., checkout redirect)
+     * Sends session_end event with active/idle time metrics
+     */
+    endSession(): Promise<void>;
     /**
      * Get time spent in a specific stage (in seconds)
      */

package/dist/index.d.ts

@@ -9,6 +9,7 @@ interface EventCategoryConfig {
     value?: number;
     description?: string;
     trackOnce?: boolean;
+    color?: string;
 }
 interface AureaConfig {
     apiKey: string;
@@ -202,6 +203,7 @@ declare class AureaSDK {
         value?: number;
         advanceTo?: FunnelStage;
         description?: string;
+        color?: string;
     }): void;
     /**
      * Get current event category statistics
@@ -258,6 +260,12 @@ declare class AureaSDK {
      * Track checkout abandoned (user left without completing)
      */
     checkoutAbandoned(reason?: string): void;
+    /**
+     * Manually end the current session
+     * Useful before page navigation (e.g., checkout redirect)
+     * Sends session_end event with active/idle time metrics
+     */
+    endSession(): Promise<void>;
     /**
      * Get time spent in a specific stage (in seconds)
      */

package/dist/index.js

@@ -252,6 +252,7 @@ var AureaSDK = class {
     const value = options?.value ?? categoryConfig?.value ?? 50;
     const advanceTo = options?.advanceTo || categoryConfig?.advanceTo;
     const description = options?.description || categoryConfig?.description;
+    const color = options?.color || categoryConfig?.color;
     const trackOnce = categoryConfig?.trackOnce ?? false;
     if (trackOnce) {
       if (this.trackedOnceEvents.has(eventName)) {
@@ -276,6 +277,8 @@ var AureaSDK = class {
       _category: category,
       _value: value,
       _description: description,
+      _color: color,
+      // Custom color (e.g., 'fuchsia' or full Tailwind classes)
       _currentStage: this.currentStage,
       _categoryStats: Object.fromEntries(this.eventCategoryStats),
       _trackedOnce: trackOnce
@@ -539,6 +542,40 @@ var AureaSDK = class {
       console.log("[Aurea SDK] Checkout abandoned:", reason);
     }
   }
+  /**
+   * Manually end the current session
+   * Useful before page navigation (e.g., checkout redirect)
+   * Sends session_end event with active/idle time metrics
+   */
+  async endSession() {
+    if (typeof window === "undefined") return;
+    const now = Date.now();
+    if (this.isInCheckout && this.currentStage === "checkout") {
+      this.checkoutAbandoned("session_end");
+    }
+    if (this.isPageVisible) {
+      this.activeTime += now - this.lastActiveTimestamp;
+    }
+    const totalDuration = Math.floor((now - this.sessionStartTime) / 1e3);
+    const activeTimeSeconds = Math.floor(this.activeTime / 1e3);
+    const idleTimeSeconds = totalDuration - activeTimeSeconds;
+    const engagementRate = totalDuration > 0 ? activeTimeSeconds / totalDuration * 100 : 0;
+    await this.trackEvent("session_end", {
+      duration: totalDuration,
+      activeTime: activeTimeSeconds,
+      idleTime: idleTimeSeconds,
+      engagementRate
+    });
+    await this.flushEvents();
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Session manually ended", {
+        duration: totalDuration,
+        activeTime: activeTimeSeconds,
+        idleTime: idleTimeSeconds,
+        engagementRate: `${engagementRate.toFixed(1)}%`
+      });
+    }
+  }
   /**
    * Get time spent in a specific stage (in seconds)
    */

package/dist/index.mjs

@@ -223,6 +223,7 @@ var AureaSDK = class {
     const value = options?.value ?? categoryConfig?.value ?? 50;
     const advanceTo = options?.advanceTo || categoryConfig?.advanceTo;
     const description = options?.description || categoryConfig?.description;
+    const color = options?.color || categoryConfig?.color;
     const trackOnce = categoryConfig?.trackOnce ?? false;
     if (trackOnce) {
       if (this.trackedOnceEvents.has(eventName)) {
@@ -247,6 +248,8 @@ var AureaSDK = class {
       _category: category,
       _value: value,
       _description: description,
+      _color: color,
+      // Custom color (e.g., 'fuchsia' or full Tailwind classes)
       _currentStage: this.currentStage,
       _categoryStats: Object.fromEntries(this.eventCategoryStats),
       _trackedOnce: trackOnce
@@ -510,6 +513,40 @@ var AureaSDK = class {
       console.log("[Aurea SDK] Checkout abandoned:", reason);
     }
   }
+  /**
+   * Manually end the current session
+   * Useful before page navigation (e.g., checkout redirect)
+   * Sends session_end event with active/idle time metrics
+   */
+  async endSession() {
+    if (typeof window === "undefined") return;
+    const now = Date.now();
+    if (this.isInCheckout && this.currentStage === "checkout") {
+      this.checkoutAbandoned("session_end");
+    }
+    if (this.isPageVisible) {
+      this.activeTime += now - this.lastActiveTimestamp;
+    }
+    const totalDuration = Math.floor((now - this.sessionStartTime) / 1e3);
+    const activeTimeSeconds = Math.floor(this.activeTime / 1e3);
+    const idleTimeSeconds = totalDuration - activeTimeSeconds;
+    const engagementRate = totalDuration > 0 ? activeTimeSeconds / totalDuration * 100 : 0;
+    await this.trackEvent("session_end", {
+      duration: totalDuration,
+      activeTime: activeTimeSeconds,
+      idleTime: idleTimeSeconds,
+      engagementRate
+    });
+    await this.flushEvents();
+    if (this.config.debug) {
+      console.log("[Aurea SDK] Session manually ended", {
+        duration: totalDuration,
+        activeTime: activeTimeSeconds,
+        idleTime: idleTimeSeconds,
+        engagementRate: `${engagementRate.toFixed(1)}%`
+      });
+    }
+  }
   /**
    * Get time spent in a specific stage (in seconds)
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aurea-tracking-sdk",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Standalone tracking SDK for Aurea CRM external funnels",
   "main": "dist/index.js",
   "module": "dist/index.mjs",