aurea-tracking-sdk 1.3.0 → 1.3.1

package/dist/index.d.mts

@@ -258,6 +258,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

@@ -258,6 +258,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

@@ -539,6 +539,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

@@ -510,6 +510,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.1",
   "description": "Standalone tracking SDK for Aurea CRM external funnels",
   "main": "dist/index.js",
   "module": "dist/index.mjs",