@sendoracloud/sdk-react-native 1.5.0 → 1.6.1

package/dist/index.cjs

@@ -1760,15 +1760,16 @@ var import_react_native3 = require("react-native");
 var DEFAULT_IDLE_MS = 30 * 60 * 1e3;
 function resolveFlags(cfg) {
   if (cfg === false) {
-    return { appOpen: false, sessionStart: false, appBackground: false };
+    return { appOpen: false, sessionStart: false, appBackground: false, engagement: false };
   }
   if (cfg === true || cfg === void 0) {
-    return { appOpen: true, sessionStart: true, appBackground: true };
+    return { appOpen: true, sessionStart: true, appBackground: true, engagement: true };
   }
   return {
     appOpen: cfg.appOpen ?? true,
     sessionStart: cfg.sessionStart ?? true,
-    appBackground: cfg.appBackground ?? true
+    appBackground: cfg.appBackground ?? true,
+    engagement: cfg.engagement ?? true
   };
 }
 function installAutoTrack(args) {
@@ -1799,15 +1800,21 @@ function installAutoTrack(args) {
   if (flags.appOpen) {
     args.fire("app.opened", { sessionId });
   }
-  if (flags.appBackground) {
+  if (flags.appBackground || flags.engagement) {
     const AppState = import_react_native3.AppState;
     if (AppState && typeof AppState.addEventListener === "function") {
       const handler = (state) => {
         ensureSession(true);
         if (state === "background" || state === "inactive") {
-          args.fire("app.backgrounded", { sessionId: args.getSessionId() });
+          if (flags.engagement) args.onForeground?.(false);
+          if (flags.appBackground) {
+            args.fire("app.backgrounded", { sessionId: args.getSessionId() });
+          }
         } else if (state === "active") {
-          args.fire("app.foregrounded", { sessionId: args.getSessionId() });
+          if (flags.appBackground) {
+            args.fire("app.foregrounded", { sessionId: args.getSessionId() });
+          }
+          if (flags.engagement) args.onForeground?.(true);
         }
       };
       const sub = AppState.addEventListener("change", handler);
@@ -1848,6 +1855,8 @@ var MAX_PUSH_METADATA_BYTES = 4096;
 var MAX_USER_ID_LEN = 256;
 var MAX_TRAITS_BYTES = 32 * 1024;
 var MAX_PROPERTIES_BYTES = 32 * 1024;
+var MIN_ENGAGEMENT_MS = 250;
+var MAX_ENGAGEMENT_MS = 6 * 60 * 60 * 1e3;
 function assertCSPRNG() {
   const g = globalThis;
   if (g.crypto?.getRandomValues) {
@@ -1898,6 +1907,12 @@ var SendoraSDK = class {
     this.debug = false;
     this.sessionId = "";
     this.autoTrackCleanup = null;
+    // --- Engagement time (foreground-only, Wave 75) ---
+    this.engEnabled = false;
+    this.engScreen = null;
+    this.engAccumMs = 0;
+    // >0 = accumulating since this timestamp; 0 = paused (backgrounded).
+    this.engSegmentStart = 0;
     /**
      * Lazy-allocated stable session id for chatbot conversations.
      * Survives only the JS lifetime — chatbot multi-turn context lives
@@ -1988,12 +2003,17 @@ var SendoraSDK = class {
     });
     this.ready = true;
     if (config.autoTrack !== false) {
+      this.engEnabled = config.autoTrack === true || config.autoTrack === void 0 || config.autoTrack.engagement !== false;
       this.autoTrackCleanup = installAutoTrack({
         config: this.config,
         fire: (eventType, properties) => this.track(eventType, properties),
         getSessionId: () => this.sessionId,
         setSessionId: (id) => {
           this.sessionId = id;
+        },
+        onForeground: (active) => {
+          if (active) this.engResume();
+          else this.engFlush();
         }
       });
     }
@@ -2057,10 +2077,53 @@ var SendoraSDK = class {
     if (typeof name !== "string" || name.length === 0 || name.length > 256) {
       throw new Error("[sendoracloud] screen name must be a 1-256 char string.");
     }
+    this.engFlush();
     void this.sendEvent("screen", {
       eventType: "screen.viewed",
       properties: { screenName: name, ...properties ?? {} }
     });
+    this.engEnter(name);
+  }
+  // --- Engagement timer (foreground-only, Wave 75) ---
+  /** Bank the in-flight foreground segment into the accumulator + pause. */
+  engBank() {
+    if (this.engSegmentStart > 0) {
+      this.engAccumMs += Date.now() - this.engSegmentStart;
+      this.engSegmentStart = 0;
+    }
+  }
+  /**
+   * Emit `app.engagement` for the current screen with foreground-only
+   * durationMs, then reset the accumulator. Sub-threshold (redirect
+   * flicker) spans are dropped; absurd spans clamp to a 6h ceiling.
+   * Never throws — engagement is best-effort instrumentation.
+   */
+  engFlush() {
+    if (!this.engEnabled || this.engScreen === null) return;
+    this.engBank();
+    let ms = this.engAccumMs;
+    this.engAccumMs = 0;
+    if (ms < MIN_ENGAGEMENT_MS) return;
+    if (ms > MAX_ENGAGEMENT_MS) ms = MAX_ENGAGEMENT_MS;
+    try {
+      void this.sendEvent("track", {
+        eventType: "app.engagement",
+        properties: { durationMs: Math.round(ms), screen: this.engScreen, sessionId: this.sessionId }
+      });
+    } catch {
+    }
+  }
+  /** Start measuring a new screen (foreground from now). */
+  engEnter(name) {
+    if (!this.engEnabled) return;
+    this.engScreen = name;
+    this.engAccumMs = 0;
+    this.engSegmentStart = Date.now();
+  }
+  /** Resume accumulation after the app returns to foreground. */
+  engResume() {
+    if (!this.engEnabled || this.engScreen === null) return;
+    if (this.engSegmentStart === 0) this.engSegmentStart = Date.now();
   }
   /**
    * Register a device push token (APNs or FCM) so server-side
@@ -2086,7 +2149,13 @@ var SendoraSDK = class {
       { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
       "/api/v1/push/tokens",
       {
-        userId: this.userId,
+        // Conditional spread — the backend's registerPushTokenSchema makes
+        // userId `.optional()`, which accepts a missing key but REJECTS
+        // `null` (422 "userId: Expected string, received null"). Anonymous
+        // installs (pre-identify()) carry a null userId, so OMIT the field
+        // rather than send null — anon devices must still be able to
+        // register. Mirrors the same conditional-spread sendEvent() uses.
+        ...this.userId ? { userId: this.userId } : {},
         anonymousId: this.anonId,
         token: reg.token,
         platform: reg.platform,
@@ -2128,7 +2197,7 @@ var SendoraSDK = class {
         if (clickAction !== void 0) body.clickAction = clickAction;
         await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/push/track-open",
+          "/api/v1/push/track-open",
           body
         );
       },
@@ -2147,7 +2216,7 @@ var SendoraSDK = class {
           if (!self.config) throw new Error("[sendoracloud] init() must complete before push.liveActivities.startToken().");
           const res = await post(
             { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-            "/push/live-activities/start-token",
+            "/api/v1/push/live-activities/start-token",
             {
               pushToken: input.pushToken,
               activityType: input.activityType,
@@ -2181,7 +2250,7 @@ var SendoraSDK = class {
           if (!self.config) throw new Error("[sendoracloud] init() must complete before push.geofences.list().");
           const res = await getJson(
             { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-            "/push/geofences/list-for-device"
+            "/api/v1/push/geofences/list-for-device"
           );
           if (!res || !res.ok) {
             throw new Error(`[sendoracloud] geofences list failed (HTTP ${res?.status ?? "network"}).`);
@@ -2199,7 +2268,7 @@ var SendoraSDK = class {
           if (!self.config) throw new Error("[sendoracloud] init() must complete before push.geofences.recordEvent().");
           const res = await post(
             { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-            "/push/geofences/event",
+            "/api/v1/push/geofences/event",
             {
               geofenceId: input.geofenceId,
               kind: input.kind,
@@ -2243,7 +2312,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.reportInstall().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/attribution/install",
+          "/api/v1/attribution/install",
           input ?? {}
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.reportInstall failed (${res?.status ?? "network"})`);
@@ -2255,7 +2324,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.checkDeferred().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/attribution/deferred",
+          "/api/v1/attribution/deferred",
           input ?? {}
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.checkDeferred failed (${res?.status ?? "network"})`);
@@ -2289,7 +2358,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before support.createTicket().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/support/tickets",
+          "/api/v1/support/tickets",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] support.createTicket failed (${res?.status ?? "network"})`);
@@ -2301,7 +2370,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before support.submitCsat().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/support/csat",
+          "/api/v1/support/csat",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] support.submitCsat failed (${res?.status ?? "network"})`);
@@ -2390,7 +2459,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.record().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/consent/record",
+          "/api/v1/consent/record",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] consent.record failed (${res?.status ?? "network"})`);
@@ -2402,7 +2471,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.requestDeletion().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/consent/deletion-request",
+          "/api/v1/consent/deletion-request",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] consent.requestDeletion failed (${res?.status ?? "network"})`);
@@ -2453,7 +2522,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before surveys.submitResponse().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/surveys/responses",
+          "/api/v1/surveys/responses",
           { completed: true, ...input }
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] surveys.submitResponse failed (${res?.status ?? "network"})`);
@@ -2503,7 +2572,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before messages.recordImpression().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/in-app-messages/impressions",
+          "/api/v1/in-app-messages/impressions",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] messages.recordImpression failed (${res?.status ?? "network"})`);
@@ -2541,7 +2610,7 @@ var SendoraSDK = class {
         };
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/feature-flags/evaluate",
+          "/api/v1/feature-flags/evaluate",
           body
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluate failed (${res?.status ?? "network"})`);
@@ -2558,7 +2627,7 @@ var SendoraSDK = class {
         };
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/feature-flags/evaluate-all",
+          "/api/v1/feature-flags/evaluate-all",
           body
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluateAll failed (${res?.status ?? "network"})`);
@@ -2593,7 +2662,7 @@ var SendoraSDK = class {
         };
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/chatbot/message",
+          "/api/v1/chatbot/message",
           body
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] chatbot.sendMessage failed (${res?.status ?? "network"})`);
@@ -2621,6 +2690,7 @@ var SendoraSDK = class {
   }
   /** Tear down auto-track listeners. Call in test harnesses. */
   destroy() {
+    this.engFlush();
     if (this.autoTrackCleanup) {
       this.autoTrackCleanup();
       this.autoTrackCleanup = null;

package/dist/index.d.cts

@@ -728,6 +728,10 @@ interface SendoraConfig {
      *   (idle >`sessionIdleMs` closes session). Default true.
      * - `appBackground` — emit `app.backgrounded`/`app.foregrounded` on
      *   AppState transitions. Default true.
+     * - `engagement` — emit `app.engagement` with foreground-only `durationMs`
+     *   per screen on the next `screen()` call + on app-background (GA4
+     *   user_engagement parity). Default true. Only measures named screens —
+     *   it has no effect until you start calling `screen()`.
      *
      * Note: screen view tracking is NOT auto — RN has no canonical router.
      * Call `SendoraCloud.screen(name)` from your navigation listener.
@@ -736,6 +740,7 @@ interface SendoraConfig {
         appOpen?: boolean;
         sessionStart?: boolean;
         appBackground?: boolean;
+        engagement?: boolean;
     };
     /** Idle threshold (ms) for session expiry; default 30 minutes. */
     sessionIdleMs?: number;
@@ -827,6 +832,10 @@ declare class SendoraSDK {
     private debug;
     private sessionId;
     private autoTrackCleanup;
+    private engEnabled;
+    private engScreen;
+    private engAccumMs;
+    private engSegmentStart;
     /** Lazy-initialised in init() once we know the apiUrl + publicKey. */
     auth: Auth;
     /** Lazy-initialised in init(). Deep-link surface: create + handleUniversalLink + matchDeferred. */
@@ -847,6 +856,19 @@ declare class SendoraSDK {
     track(eventType: string, properties?: TrackProperties): void;
     /** RN equivalent of page view — call on route / screen change. */
     screen(name: string, properties?: TrackProperties): void;
+    /** Bank the in-flight foreground segment into the accumulator + pause. */
+    private engBank;
+    /**
+     * Emit `app.engagement` for the current screen with foreground-only
+     * durationMs, then reset the accumulator. Sub-threshold (redirect
+     * flicker) spans are dropped; absurd spans clamp to a 6h ceiling.
+     * Never throws — engagement is best-effort instrumentation.
+     */
+    private engFlush;
+    /** Start measuring a new screen (foreground from now). */
+    private engEnter;
+    /** Resume accumulation after the app returns to foreground. */
+    private engResume;
     /**
      * Register a device push token (APNs or FCM) so server-side
      * workflows can target this user. The caller is responsible for

package/dist/index.d.ts

@@ -728,6 +728,10 @@ interface SendoraConfig {
      *   (idle >`sessionIdleMs` closes session). Default true.
      * - `appBackground` — emit `app.backgrounded`/`app.foregrounded` on
      *   AppState transitions. Default true.
+     * - `engagement` — emit `app.engagement` with foreground-only `durationMs`
+     *   per screen on the next `screen()` call + on app-background (GA4
+     *   user_engagement parity). Default true. Only measures named screens —
+     *   it has no effect until you start calling `screen()`.
      *
      * Note: screen view tracking is NOT auto — RN has no canonical router.
      * Call `SendoraCloud.screen(name)` from your navigation listener.
@@ -736,6 +740,7 @@ interface SendoraConfig {
         appOpen?: boolean;
         sessionStart?: boolean;
         appBackground?: boolean;
+        engagement?: boolean;
     };
     /** Idle threshold (ms) for session expiry; default 30 minutes. */
     sessionIdleMs?: number;
@@ -827,6 +832,10 @@ declare class SendoraSDK {
     private debug;
     private sessionId;
     private autoTrackCleanup;
+    private engEnabled;
+    private engScreen;
+    private engAccumMs;
+    private engSegmentStart;
     /** Lazy-initialised in init() once we know the apiUrl + publicKey. */
     auth: Auth;
     /** Lazy-initialised in init(). Deep-link surface: create + handleUniversalLink + matchDeferred. */
@@ -847,6 +856,19 @@ declare class SendoraSDK {
     track(eventType: string, properties?: TrackProperties): void;
     /** RN equivalent of page view — call on route / screen change. */
     screen(name: string, properties?: TrackProperties): void;
+    /** Bank the in-flight foreground segment into the accumulator + pause. */
+    private engBank;
+    /**
+     * Emit `app.engagement` for the current screen with foreground-only
+     * durationMs, then reset the accumulator. Sub-threshold (redirect
+     * flicker) spans are dropped; absurd spans clamp to a 6h ceiling.
+     * Never throws — engagement is best-effort instrumentation.
+     */
+    private engFlush;
+    /** Start measuring a new screen (foreground from now). */
+    private engEnter;
+    /** Resume accumulation after the app returns to foreground. */
+    private engResume;
     /**
      * Register a device push token (APNs or FCM) so server-side
      * workflows can target this user. The caller is responsible for

package/dist/index.js

@@ -1722,15 +1722,16 @@ import { AppState as RnAppState2 } from "react-native";
 var DEFAULT_IDLE_MS = 30 * 60 * 1e3;
 function resolveFlags(cfg) {
   if (cfg === false) {
-    return { appOpen: false, sessionStart: false, appBackground: false };
+    return { appOpen: false, sessionStart: false, appBackground: false, engagement: false };
   }
   if (cfg === true || cfg === void 0) {
-    return { appOpen: true, sessionStart: true, appBackground: true };
+    return { appOpen: true, sessionStart: true, appBackground: true, engagement: true };
   }
   return {
     appOpen: cfg.appOpen ?? true,
     sessionStart: cfg.sessionStart ?? true,
-    appBackground: cfg.appBackground ?? true
+    appBackground: cfg.appBackground ?? true,
+    engagement: cfg.engagement ?? true
   };
 }
 function installAutoTrack(args) {
@@ -1761,15 +1762,21 @@ function installAutoTrack(args) {
   if (flags.appOpen) {
     args.fire("app.opened", { sessionId });
   }
-  if (flags.appBackground) {
+  if (flags.appBackground || flags.engagement) {
     const AppState = RnAppState2;
     if (AppState && typeof AppState.addEventListener === "function") {
       const handler = (state) => {
         ensureSession(true);
         if (state === "background" || state === "inactive") {
-          args.fire("app.backgrounded", { sessionId: args.getSessionId() });
+          if (flags.engagement) args.onForeground?.(false);
+          if (flags.appBackground) {
+            args.fire("app.backgrounded", { sessionId: args.getSessionId() });
+          }
         } else if (state === "active") {
-          args.fire("app.foregrounded", { sessionId: args.getSessionId() });
+          if (flags.appBackground) {
+            args.fire("app.foregrounded", { sessionId: args.getSessionId() });
+          }
+          if (flags.engagement) args.onForeground?.(true);
         }
       };
       const sub = AppState.addEventListener("change", handler);
@@ -1810,6 +1817,8 @@ var MAX_PUSH_METADATA_BYTES = 4096;
 var MAX_USER_ID_LEN = 256;
 var MAX_TRAITS_BYTES = 32 * 1024;
 var MAX_PROPERTIES_BYTES = 32 * 1024;
+var MIN_ENGAGEMENT_MS = 250;
+var MAX_ENGAGEMENT_MS = 6 * 60 * 60 * 1e3;
 function assertCSPRNG() {
   const g = globalThis;
   if (g.crypto?.getRandomValues) {
@@ -1860,6 +1869,12 @@ var SendoraSDK = class {
     this.debug = false;
     this.sessionId = "";
     this.autoTrackCleanup = null;
+    // --- Engagement time (foreground-only, Wave 75) ---
+    this.engEnabled = false;
+    this.engScreen = null;
+    this.engAccumMs = 0;
+    // >0 = accumulating since this timestamp; 0 = paused (backgrounded).
+    this.engSegmentStart = 0;
     /**
      * Lazy-allocated stable session id for chatbot conversations.
      * Survives only the JS lifetime — chatbot multi-turn context lives
@@ -1950,12 +1965,17 @@ var SendoraSDK = class {
     });
     this.ready = true;
     if (config.autoTrack !== false) {
+      this.engEnabled = config.autoTrack === true || config.autoTrack === void 0 || config.autoTrack.engagement !== false;
       this.autoTrackCleanup = installAutoTrack({
         config: this.config,
         fire: (eventType, properties) => this.track(eventType, properties),
         getSessionId: () => this.sessionId,
         setSessionId: (id) => {
           this.sessionId = id;
+        },
+        onForeground: (active) => {
+          if (active) this.engResume();
+          else this.engFlush();
         }
       });
     }
@@ -2019,10 +2039,53 @@ var SendoraSDK = class {
     if (typeof name !== "string" || name.length === 0 || name.length > 256) {
       throw new Error("[sendoracloud] screen name must be a 1-256 char string.");
     }
+    this.engFlush();
     void this.sendEvent("screen", {
       eventType: "screen.viewed",
       properties: { screenName: name, ...properties ?? {} }
     });
+    this.engEnter(name);
+  }
+  // --- Engagement timer (foreground-only, Wave 75) ---
+  /** Bank the in-flight foreground segment into the accumulator + pause. */
+  engBank() {
+    if (this.engSegmentStart > 0) {
+      this.engAccumMs += Date.now() - this.engSegmentStart;
+      this.engSegmentStart = 0;
+    }
+  }
+  /**
+   * Emit `app.engagement` for the current screen with foreground-only
+   * durationMs, then reset the accumulator. Sub-threshold (redirect
+   * flicker) spans are dropped; absurd spans clamp to a 6h ceiling.
+   * Never throws — engagement is best-effort instrumentation.
+   */
+  engFlush() {
+    if (!this.engEnabled || this.engScreen === null) return;
+    this.engBank();
+    let ms = this.engAccumMs;
+    this.engAccumMs = 0;
+    if (ms < MIN_ENGAGEMENT_MS) return;
+    if (ms > MAX_ENGAGEMENT_MS) ms = MAX_ENGAGEMENT_MS;
+    try {
+      void this.sendEvent("track", {
+        eventType: "app.engagement",
+        properties: { durationMs: Math.round(ms), screen: this.engScreen, sessionId: this.sessionId }
+      });
+    } catch {
+    }
+  }
+  /** Start measuring a new screen (foreground from now). */
+  engEnter(name) {
+    if (!this.engEnabled) return;
+    this.engScreen = name;
+    this.engAccumMs = 0;
+    this.engSegmentStart = Date.now();
+  }
+  /** Resume accumulation after the app returns to foreground. */
+  engResume() {
+    if (!this.engEnabled || this.engScreen === null) return;
+    if (this.engSegmentStart === 0) this.engSegmentStart = Date.now();
   }
   /**
    * Register a device push token (APNs or FCM) so server-side
@@ -2048,7 +2111,13 @@ var SendoraSDK = class {
       { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
       "/api/v1/push/tokens",
       {
-        userId: this.userId,
+        // Conditional spread — the backend's registerPushTokenSchema makes
+        // userId `.optional()`, which accepts a missing key but REJECTS
+        // `null` (422 "userId: Expected string, received null"). Anonymous
+        // installs (pre-identify()) carry a null userId, so OMIT the field
+        // rather than send null — anon devices must still be able to
+        // register. Mirrors the same conditional-spread sendEvent() uses.
+        ...this.userId ? { userId: this.userId } : {},
         anonymousId: this.anonId,
         token: reg.token,
         platform: reg.platform,
@@ -2090,7 +2159,7 @@ var SendoraSDK = class {
         if (clickAction !== void 0) body.clickAction = clickAction;
         await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/push/track-open",
+          "/api/v1/push/track-open",
           body
         );
       },
@@ -2109,7 +2178,7 @@ var SendoraSDK = class {
           if (!self.config) throw new Error("[sendoracloud] init() must complete before push.liveActivities.startToken().");
           const res = await post(
             { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-            "/push/live-activities/start-token",
+            "/api/v1/push/live-activities/start-token",
             {
               pushToken: input.pushToken,
               activityType: input.activityType,
@@ -2143,7 +2212,7 @@ var SendoraSDK = class {
           if (!self.config) throw new Error("[sendoracloud] init() must complete before push.geofences.list().");
           const res = await getJson(
             { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-            "/push/geofences/list-for-device"
+            "/api/v1/push/geofences/list-for-device"
           );
           if (!res || !res.ok) {
             throw new Error(`[sendoracloud] geofences list failed (HTTP ${res?.status ?? "network"}).`);
@@ -2161,7 +2230,7 @@ var SendoraSDK = class {
           if (!self.config) throw new Error("[sendoracloud] init() must complete before push.geofences.recordEvent().");
           const res = await post(
             { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-            "/push/geofences/event",
+            "/api/v1/push/geofences/event",
             {
               geofenceId: input.geofenceId,
               kind: input.kind,
@@ -2205,7 +2274,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.reportInstall().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/attribution/install",
+          "/api/v1/attribution/install",
           input ?? {}
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.reportInstall failed (${res?.status ?? "network"})`);
@@ -2217,7 +2286,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.checkDeferred().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/attribution/deferred",
+          "/api/v1/attribution/deferred",
           input ?? {}
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.checkDeferred failed (${res?.status ?? "network"})`);
@@ -2251,7 +2320,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before support.createTicket().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/support/tickets",
+          "/api/v1/support/tickets",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] support.createTicket failed (${res?.status ?? "network"})`);
@@ -2263,7 +2332,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before support.submitCsat().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/support/csat",
+          "/api/v1/support/csat",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] support.submitCsat failed (${res?.status ?? "network"})`);
@@ -2352,7 +2421,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.record().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/consent/record",
+          "/api/v1/consent/record",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] consent.record failed (${res?.status ?? "network"})`);
@@ -2364,7 +2433,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before consent.requestDeletion().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/consent/deletion-request",
+          "/api/v1/consent/deletion-request",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] consent.requestDeletion failed (${res?.status ?? "network"})`);
@@ -2415,7 +2484,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before surveys.submitResponse().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/surveys/responses",
+          "/api/v1/surveys/responses",
           { completed: true, ...input }
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] surveys.submitResponse failed (${res?.status ?? "network"})`);
@@ -2465,7 +2534,7 @@ var SendoraSDK = class {
         if (!self.config) throw new Error("[sendoracloud] init() must complete before messages.recordImpression().");
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/in-app-messages/impressions",
+          "/api/v1/in-app-messages/impressions",
           input
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] messages.recordImpression failed (${res?.status ?? "network"})`);
@@ -2503,7 +2572,7 @@ var SendoraSDK = class {
         };
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/feature-flags/evaluate",
+          "/api/v1/feature-flags/evaluate",
           body
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluate failed (${res?.status ?? "network"})`);
@@ -2520,7 +2589,7 @@ var SendoraSDK = class {
         };
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/feature-flags/evaluate-all",
+          "/api/v1/feature-flags/evaluate-all",
           body
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] flags.evaluateAll failed (${res?.status ?? "network"})`);
@@ -2555,7 +2624,7 @@ var SendoraSDK = class {
         };
         const res = await post(
           { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
-          "/chatbot/message",
+          "/api/v1/chatbot/message",
           body
         );
         if (!res || !res.ok) throw new Error(`[sendoracloud] chatbot.sendMessage failed (${res?.status ?? "network"})`);
@@ -2583,6 +2652,7 @@ var SendoraSDK = class {
   }
   /** Tear down auto-track listeners. Call in test harnesses. */
   destroy() {
+    this.engFlush();
     if (this.autoTrackCleanup) {
       this.autoTrackCleanup();
       this.autoTrackCleanup = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
   "type": "module",
   "main": "./dist/index.cjs",