aurea-tracking-sdk 1.2.0 → 1.3.1

package/dist/index.d.mts

@@ -8,6 +8,7 @@ interface EventCategoryConfig {
     advanceTo?: string;
     value?: number;
     description?: string;
+    trackOnce?: boolean;
 }
 interface AureaConfig {
     apiKey: string;
@@ -129,6 +130,7 @@ declare class AureaSDK {
     private isInCheckout;
     private checkoutStartedAt?;
     private eventCategoryStats;
+    private trackedOnceEvents;
     constructor(config: AureaConfig);
     /**
      * Initialize the SDK
@@ -256,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

@@ -8,6 +8,7 @@ interface EventCategoryConfig {
     advanceTo?: string;
     value?: number;
     description?: string;
+    trackOnce?: boolean;
 }
 interface AureaConfig {
     apiKey: string;
@@ -129,6 +130,7 @@ declare class AureaSDK {
     private isInCheckout;
     private checkoutStartedAt?;
     private eventCategoryStats;
+    private trackedOnceEvents;
     constructor(config: AureaConfig);
     /**
      * Initialize the SDK
@@ -256,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

@@ -53,6 +53,8 @@ var AureaSDK = class {
     this.isInCheckout = false;
     // NEW: Event categorization tracking
     this.eventCategoryStats = /* @__PURE__ */ new Map();
+    // NEW: Track which events have been fired (for trackOnce behavior)
+    this.trackedOnceEvents = /* @__PURE__ */ new Set();
     this.config = {
       apiUrl: "http://localhost:3000/api",
       debug: false,
@@ -250,6 +252,16 @@ var AureaSDK = class {
     const value = options?.value ?? categoryConfig?.value ?? 50;
     const advanceTo = options?.advanceTo || categoryConfig?.advanceTo;
     const description = options?.description || categoryConfig?.description;
+    const trackOnce = categoryConfig?.trackOnce ?? false;
+    if (trackOnce) {
+      if (this.trackedOnceEvents.has(eventName)) {
+        if (this.config.debug) {
+          console.log(`[Aurea SDK] Event skipped (already tracked once): ${eventName}`);
+        }
+        return;
+      }
+      this.trackedOnceEvents.add(eventName);
+    }
     this.eventCategoryStats.set(
       category,
       (this.eventCategoryStats.get(category) || 0) + 1
@@ -265,10 +277,12 @@ var AureaSDK = class {
       _value: value,
       _description: description,
       _currentStage: this.currentStage,
-      _categoryStats: Object.fromEntries(this.eventCategoryStats)
+      _categoryStats: Object.fromEntries(this.eventCategoryStats),
+      _trackedOnce: trackOnce
+      // Include for backend reference
     });
     if (this.config.debug) {
-      console.log(`[Aurea SDK] Event tracked: ${eventName} [${category}] (value: ${value}, stage: ${this.currentStage})`);
+      console.log(`[Aurea SDK] Event tracked: ${eventName} [${category}] (value: ${value}, stage: ${this.currentStage}${trackOnce ? ", once-only" : ""})`);
     }
   }
   /**
@@ -525,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

@@ -24,6 +24,8 @@ var AureaSDK = class {
     this.isInCheckout = false;
     // NEW: Event categorization tracking
     this.eventCategoryStats = /* @__PURE__ */ new Map();
+    // NEW: Track which events have been fired (for trackOnce behavior)
+    this.trackedOnceEvents = /* @__PURE__ */ new Set();
     this.config = {
       apiUrl: "http://localhost:3000/api",
       debug: false,
@@ -221,6 +223,16 @@ var AureaSDK = class {
     const value = options?.value ?? categoryConfig?.value ?? 50;
     const advanceTo = options?.advanceTo || categoryConfig?.advanceTo;
     const description = options?.description || categoryConfig?.description;
+    const trackOnce = categoryConfig?.trackOnce ?? false;
+    if (trackOnce) {
+      if (this.trackedOnceEvents.has(eventName)) {
+        if (this.config.debug) {
+          console.log(`[Aurea SDK] Event skipped (already tracked once): ${eventName}`);
+        }
+        return;
+      }
+      this.trackedOnceEvents.add(eventName);
+    }
     this.eventCategoryStats.set(
       category,
       (this.eventCategoryStats.get(category) || 0) + 1
@@ -236,10 +248,12 @@ var AureaSDK = class {
       _value: value,
       _description: description,
       _currentStage: this.currentStage,
-      _categoryStats: Object.fromEntries(this.eventCategoryStats)
+      _categoryStats: Object.fromEntries(this.eventCategoryStats),
+      _trackedOnce: trackOnce
+      // Include for backend reference
     });
     if (this.config.debug) {
-      console.log(`[Aurea SDK] Event tracked: ${eventName} [${category}] (value: ${value}, stage: ${this.currentStage})`);
+      console.log(`[Aurea SDK] Event tracked: ${eventName} [${category}] (value: ${value}, stage: ${this.currentStage}${trackOnce ? ", once-only" : ""})`);
     }
   }
   /**
@@ -496,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.2.0",
+  "version": "1.3.1",
   "description": "Standalone tracking SDK for Aurea CRM external funnels",
   "main": "dist/index.js",
   "module": "dist/index.mjs",