@nexly/react-native 0.13.0 → 0.15.0

package/README.md

@@ -73,3 +73,5 @@ Hook it up to your router of choice. Example with `@react-navigation/native`:
 - Sends `session_ping` when the app goes to background, and `session_end` on provider unmount.
 
 No scroll/click tracking (those are DOM-only); if you want tap analytics, send custom `engagement` events yourself.
+
+`startEngagement()` is idempotent — calling it again stops the previous subscription first, so Fast Refresh or double-mounts cannot produce duplicate listeners.

package/dist/nexly.d.ts

@@ -8,6 +8,7 @@ import { NexlyBase, type NexlyInit } from '@nexly/core';
  */
 export declare class Nexly extends NexlyBase {
     private currentScreen;
+    private engagementStop;
     /**
      * Creates (or replaces) the singleton **and awaits ID prewarming**.
      * `NexlyProvider` awaits this before exposing a client via context.
@@ -24,6 +25,10 @@ export declare class Nexly extends NexlyBase {
     protected collectEventContext(): Record<string, unknown>;
     protected collectSessionContext(): Record<string, unknown>;
     getDefaultPath(): string;
+    /**
+     * Attaches AppState-driven engagement tracking. Idempotent: calling again
+     * stops the previous subscription first. Returns a cleanup function.
+     */
     startEngagement(): () => void;
 }
 //# sourceMappingURL=nexly.d.ts.map

package/dist/nexly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexly.d.ts","sourceRoot":"","sources":["../src/nexly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAmBpE;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAClC,OAAO,CAAC,aAAa,CAAM;IAE3B;;;OAGG;WACU,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;IASrD,+DAA+D;IAC/D,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;gBAItB,IAAI,EAAE,SAAS;IAI3B,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;cAKd,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;cAIpD,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAI9C,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1D,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM,IAAI;CASvC"}
+{"version":3,"file":"nexly.d.ts","sourceRoot":"","sources":["../src/nexly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAmBpE;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAClC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,cAAc,CAA4B;IAElD;;;OAGG;WACU,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;IASrD,+DAA+D;IAC/D,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;gBAItB,IAAI,EAAE,SAAS;IAI3B,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;cAKd,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;cAIpD,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAI9C,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1D,cAAc,IAAI,MAAM;IAIjC;;;OAGG;IACH,eAAe,IAAI,MAAM,IAAI;CAe9B"}

package/dist/nexly.js

@@ -24,6 +24,7 @@ function defaultClient() {
  */
 export class Nexly extends NexlyBase {
     currentScreen = '/';
+    engagementStop = null;
     /**
      * Creates (or replaces) the singleton **and awaits ID prewarming**.
      * `NexlyProvider` awaits this before exposing a client via context.
@@ -65,14 +66,25 @@ export class Nexly extends NexlyBase {
     getDefaultPath() {
         return this.currentScreen;
     }
+    /**
+     * Attaches AppState-driven engagement tracking. Idempotent: calling again
+     * stops the previous subscription first. Returns a cleanup function.
+     */
     startEngagement() {
         if (this.disabled)
             return () => { };
-        return startEngagementTracking({
+        this.engagementStop?.();
+        const stop = startEngagementTracking({
             collectUrl: this.collectUrl,
             appId: this.appId,
             apiToken: this.key,
             client: this.client,
         });
+        this.engagementStop = stop;
+        return () => {
+            stop();
+            if (this.engagementStop === stop)
+                this.engagementStop = null;
+        };
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexly/react-native",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "React Native bindings for Nexly: fetch transport, AsyncStorage IDs, AppState engagement on top of @nexly/core",
   "license": "MIT",
   "keywords": [
@@ -43,7 +43,7 @@
     "react-native": ">=0.72.0"
   },
   "dependencies": {
-    "@nexly/core": "0.13.0"
+    "@nexly/core": "0.15.0"
   },
   "devDependencies": {
     "@react-native-async-storage/async-storage": "^2.1.2",