@nexly/web 0.13.0 → 0.14.0

package/README.md

@@ -25,6 +25,18 @@ const stopEngagement = client.startEngagement()
 // stopEngagement() on SPA unmount / route change if needed
 ```
 
+`startEngagement()` is idempotent — calling it again stops the previous subscription first, so HMR or double-mounts can't produce duplicate listeners.
+
+### Opting elements out of auto-capture
+
+Auto-click and auto-focus listeners skip any element (or descendant of an element) marked with `data-nexly-ignore`. Use it on elements where you already emit your own `event(...)` to avoid semantic duplicates:
+
+```tsx
+<button data-nexly-ignore onClick={() => client.event({ name: 'signup_clicked', type: 'custom' })}>
+  Sign up
+</button>
+```
+
 ## What you get
 
 - `Nexly` — browser client (auto session + visitor IDs via `localStorage`/`sessionStorage`).

package/dist/events/engagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../../src/events/engagement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AA4BrD,KAAK,MAAM,GAAG,MAAM,IAAI,CAAA;AAExB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA8GzE"}
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../../src/events/engagement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AA4BrD,KAAK,MAAM,GAAG,MAAM,IAAI,CAAA;AAExB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAgHzE"}

package/dist/events/engagement.js

@@ -68,10 +68,12 @@ export function startEngagementTracking(creds) {
         const now = Date.now();
         if (now - lastClickTs < CLICK_THROTTLE_MS)
             return;
-        lastClickTs = now;
         const el = e.target;
         if (!el)
             return;
+        if (el.closest('[data-nexly-ignore]'))
+            return;
+        lastClickTs = now;
         const tag = el.tagName?.toLowerCase() ?? '';
         const rawText = el.innerText ?? '';
         const text = rawText.slice(0, 80).trim();
@@ -86,6 +88,8 @@ export function startEngagementTracking(creds) {
         const el = e.target;
         if (!el)
             return;
+        if (el.closest('[data-nexly-ignore]'))
+            return;
         const tag = el.tagName?.toLowerCase() ?? '';
         if (tag !== 'input' && tag !== 'textarea' && tag !== 'select')
             return;

package/dist/nexly.d.ts

@@ -4,6 +4,7 @@ import { NexlyBase, type NexlyInit } from '@nexly/core';
  * and metadata via DOM/Navigator APIs.
  */
 export declare class Nexly extends NexlyBase {
+    private engagementStop;
     /** Creates (or replaces) the browser singleton. Default `client` is `NexlyClient.Web`. */
     static init(options: NexlyInit): Nexly;
     /** Returns the browser singleton, or `null` if not yet initialized. */
@@ -13,6 +14,11 @@ export declare class Nexly extends NexlyBase {
     protected collectEventContext(): Record<string, unknown>;
     protected collectSessionContext(): Record<string, unknown>;
     getDefaultPath(): string;
+    /**
+     * Attaches engagement listeners. Idempotent: calling again stops the previous
+     * subscription first, so HMR / double-mounts can't produce duplicate listeners.
+     * 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;AAMpE;;;GAGG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAClC,0FAA0F;IAC1F,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,KAAK;IAMtC,uEAAuE;IACvE,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;gBAItB,IAAI,EAAE,SAAS;cAIR,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;cAKpD,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;AAMpE;;;GAGG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAClC,OAAO,CAAC,cAAc,CAA4B;IAElD,0FAA0F;IAC1F,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,KAAK;IAMtC,uEAAuE;IACvE,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;gBAItB,IAAI,EAAE,SAAS;cAIR,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;cAKpD,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAI9C,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1D,cAAc,IAAI,MAAM;IAIjC;;;;OAIG;IACH,eAAe,IAAI,MAAM,IAAI;CAe9B"}

package/dist/nexly.js

@@ -8,6 +8,7 @@ import { getDefaultPathname } from './events/pageview.js';
  * and metadata via DOM/Navigator APIs.
  */
 export class Nexly extends NexlyBase {
+    engagementStop = null;
     /** Creates (or replaces) the browser singleton. Default `client` is `NexlyClient.Web`. */
     static init(options) {
         const instance = new Nexly({ ...options, client: options.client ?? NexlyClient.Web });
@@ -35,14 +36,26 @@ export class Nexly extends NexlyBase {
     getDefaultPath() {
         return getDefaultPathname();
     }
+    /**
+     * Attaches engagement listeners. Idempotent: calling again stops the previous
+     * subscription first, so HMR / double-mounts can't produce duplicate listeners.
+     * 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/web",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Nexly browser ingest SDK: sendBeacon transport, DOM metadata, engagement listeners on top of @nexly/core",
   "license": "MIT",
   "keywords": [
@@ -38,7 +38,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@nexly/core": "0.13.0"
+    "@nexly/core": "0.14.0"
   },
   "devDependencies": {
     "typescript": "~6.0.2"