react-native-acoustic-connect-beta 19.0.19 → 19.0.21

package/lib/typescript/src/TLTRN.d.ts

@@ -55,14 +55,77 @@ declare class TLTRN {
      * Passing no delay used to send a hardcoded `0`, which made
      * `CaptureLayoutDelay` inert for React Native apps and fired the capture at
      * the *start* of the transition rather than after it.
+     *
+     * @returns With no `delayMs` — the normal case — only that the capture was
+     *   **scheduled**, not that it produced a layout message. The native
+     *   deferred overload dispatches and returns immediately, so anything that
+     *   goes wrong once it runs (no view controller resolved, layout capture
+     *   gated off by config) cannot be reflected here; those surface in logcat
+     *   / os_log instead. Pass `0` and the value describes the capture itself,
+     *   at the cost of capturing mid-transition.
      */
     static logScreenLayout: (name: string | undefined, delayMs?: number) => boolean;
     static logClickEvent: (event: any) => Promise<boolean>;
     static logTextChangeEvent: (target: number, controlId: string, text: string, _ariaLabel: string) => Promise<boolean>;
+    /**
+     * Keys already warned about, so a call site inside a render or a list loop
+     * warns once rather than on every pass.
+     */
+    static warnedNestedValueSites: Set<string>;
+    /**
+     * Cap on {@link warnedNestedValueSites}.
+     *
+     * The site key includes the nested keys' names, so a payload built from an
+     * API response — per-record ids, timestamps — makes every call a distinct
+     * site, and the set would then grow for the life of the session. By the
+     * hundredth distinct shape the warning has made its point, so it stops
+     * instead of accumulating: bounded memory matters more than warning about
+     * shape 101.
+     */
+    static WARNED_NESTED_VALUE_SITES_MAX: number;
+    /**
+     * Warns when a flat-values payload carries a nested object or array.
+     *
+     * `logCustomEvent`/`logDialogCustomEvent` are typed for flat scalars, but
+     * TypeScript types are erased at runtime: a payload built from an API
+     * response, widened through `any`, or passed from untyped JS reaches the
+     * bridge with its nesting intact. Both platforms then reshape it silently —
+     * Android's SDK chain is typed `HashMap<String, String>` end to end, so a
+     * nested value is stringified into whatever its `toString()` yields — and
+     * the call still returns `true`. `logSignal` is the API that carries nested
+     * JSON on both platforms.
+     *
+     * Warning only: the payload is passed through untouched, so this changes no
+     * behaviour and cannot break a caller who is relying on today's reshaping.
+     *
+     * @param api    Name of the calling API, for the message.
+     * @param values The payload about to cross the bridge.
+     */
+    static warnOnNestedValues: (api: string, values: Record<string, unknown>) => void;
+    /**
+     * Logs a custom event.
+     *
+     * @param eventName Event name, as it appears in the posted JSON.
+     * @param values    Flat key/value pairs. Nested objects and arrays are NOT
+     *   supported here and are reshaped by the native SDKs — use `logSignal`
+     *   for nested JSON.
+     * @param level     Monitoring level for this event.
+     * @returns Whether the native SDK **accepted the event for delivery** —
+     *   not whether the collector received it. The event is queued locally and
+     *   posted later, so no return value from this call can attest to delivery;
+     *   a `true` here means only that the SDK took the event. A `false` is also
+     *   logged natively (logcat / os_log) so the rejection is visible.
+     */
     static logCustomEvent: (eventName: string, values: Record<string, string | number | boolean>, level: number) => Promise<boolean>;
     static logDialogShowEvent: (dialogId: string, dialogTitle: string, dialogType: string) => Promise<boolean>;
     static logDialogDismissEvent: (dialogId: string, dismissReason: string) => Promise<boolean>;
     static logDialogButtonClickEvent: (dialogId: string, buttonText: string, buttonIndex: number) => Promise<boolean>;
+    /**
+     * Logs a custom event tied to a dialog.
+     *
+     * Same flat-values contract and same return-value meaning as
+     * {@link logCustomEvent} — it routes to the same native API.
+     */
     static logDialogCustomEvent: (dialogId: string, eventName: string, values: Record<string, string | number | boolean>) => Promise<boolean>;
     static eventListenerRegistered: boolean;
     static eventListenerUnsubscribe: (() => void) | null;

package/lib/typescript/src/TLTRN.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TLTRN.d.ts","sourceRoot":"","sources":["../../../src/TLTRN.ts"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;;AAmC7F,cAAM,KAAK;IACT,MAAM,CAAC,aAAa,SACgD;IACpE,MAAM,CAAC,uBAAuB,SAAK;IACnC,MAAM,CAAC,eAAe,SAAK;IAC3B,MAAM,CAAC,iBAAiB,SAAK;IAC7B,MAAM,CAAC,SAAS,SAAK;IACrB,MAAM,CAAC,cAAc,SAAK;IAC1B,MAAM,CAAC,kBAAkB,SAAK;IAC9B,MAAM,CAAC,aAAa,SAAK;IACzB,MAAM,CAAC,YAAY,UAAS;IAE5B,MAAM,CAAC,OAAO;;;;QAIZ;;WAEG;;QAKH;;WAEG;;MAQH;IAEF,MAAM,CAAC,IAAI,yBAA0B,MAAM,4BAA4B,OAAO,UAQ5E;IAEF,MAAM,CAAC,uBAAuB,WAAY,OAAO,UAE/C;IAEF,MAAM,CAAC,qBAAqB,SAAU,MAAM,GAAG,SAAS,aAQtD;IAEF,MAAM,CAAC,wBAAwB,SAAU,MAAM,YAAY,MAAM,aAQ/D;IAEF;;;;;OAKG;IACH,MAAM,CAAC,4BAA4B,SAAM;IAEzC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,eAAe,SAAU,MAAM,GAAG,SAAS,YAAY,MAAM,aAYlE;IAEF,MAAM,CAAC,aAAa,UAAiB,GAAG,sBA+BtC;IAEF,MAAM,CAAC,kBAAkB,WAAkB,MAAM,aAAa,MAAM,QAAQ,MAAM,cAAc,MAAM,sBAYpG;IAEF,MAAM,CAAC,cAAc,cAAqB,MAAM,UAAU,OAAO,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,sBAQhH;IAGF,MAAM,CAAC,kBAAkB,aAAoB,MAAM,eAAe,MAAM,cAAc,MAAM,sBAQ1F;IAEF,MAAM,CAAC,qBAAqB,aAAoB,MAAM,iBAAiB,MAAM,sBAQ3E;IAEF,MAAM,CAAC,yBAAyB,aAAoB,MAAM,cAAc,MAAM,eAAe,MAAM,sBAQjG;IAEF,MAAM,CAAC,oBAAoB,aAAoB,MAAM,aAAa,MAAM,UAAU,OAAO,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,sBAQzH;IAGF,MAAM,CAAC,uBAAuB,UAAS;IACvC,MAAM,CAAC,wBAAwB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE5D,MAAM,CAAC,qBAAqB,WAAY,OAAO,UA0B7C;IAEF,MAAM,CAAC,cAAc,YAAa,GAAG,UAqEnC;IAEF,MAAM,CAAC,SAAS,aA6Bd;IAEF,MAAM,CAAC,OAAO,sBAyBZ;CACH;AAGD,eAAe,KAAK,CAAC"}
+{"version":3,"file":"TLTRN.d.ts","sourceRoot":"","sources":["../../../src/TLTRN.ts"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;;AAmC7F,cAAM,KAAK;IACT,MAAM,CAAC,aAAa,SACgD;IACpE,MAAM,CAAC,uBAAuB,SAAK;IACnC,MAAM,CAAC,eAAe,SAAK;IAC3B,MAAM,CAAC,iBAAiB,SAAK;IAC7B,MAAM,CAAC,SAAS,SAAK;IACrB,MAAM,CAAC,cAAc,SAAK;IAC1B,MAAM,CAAC,kBAAkB,SAAK;IAC9B,MAAM,CAAC,aAAa,SAAK;IACzB,MAAM,CAAC,YAAY,UAAS;IAE5B,MAAM,CAAC,OAAO;;;;QAIZ;;WAEG;;QAKH;;WAEG;;MAQH;IAEF,MAAM,CAAC,IAAI,yBAA0B,MAAM,4BAA4B,OAAO,UAQ5E;IAEF,MAAM,CAAC,uBAAuB,WAAY,OAAO,UAE/C;IAEF,MAAM,CAAC,qBAAqB,SAAU,MAAM,GAAG,SAAS,aAQtD;IAEF,MAAM,CAAC,wBAAwB,SAAU,MAAM,YAAY,MAAM,aAQ/D;IAEF;;;;;OAKG;IACH,MAAM,CAAC,4BAA4B,SAAM;IAEzC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,eAAe,SAAU,MAAM,GAAG,SAAS,YAAY,MAAM,aAYlE;IAEF,MAAM,CAAC,aAAa,UAAiB,GAAG,sBA+BtC;IAEF,MAAM,CAAC,kBAAkB,WAAkB,MAAM,aAAa,MAAM,QAAQ,MAAM,cAAc,MAAM,sBAYpG;IAEF;;;OAGG;IACH,MAAM,CAAC,sBAAsB,cAAqB;IAElD;;;;;;;;;OASG;IACH,MAAM,CAAC,6BAA6B,SAAO;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,kBAAkB,QAAS,MAAM,UAAU,OAAO,MAAM,EAAE,OAAO,CAAC,UAyBvE;IAEF;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,cAAc,cAAqB,MAAM,UAAU,OAAO,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,sBAShH;IAGF,MAAM,CAAC,kBAAkB,aAAoB,MAAM,eAAe,MAAM,cAAc,MAAM,sBAQ1F;IAEF,MAAM,CAAC,qBAAqB,aAAoB,MAAM,iBAAiB,MAAM,sBAQ3E;IAEF,MAAM,CAAC,yBAAyB,aAAoB,MAAM,cAAc,MAAM,eAAe,MAAM,sBAQjG;IAEF;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,aAAoB,MAAM,aAAa,MAAM,UAAU,OAAO,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,sBASzH;IAGF,MAAM,CAAC,uBAAuB,UAAS;IACvC,MAAM,CAAC,wBAAwB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE5D,MAAM,CAAC,qBAAqB,WAAY,OAAO,UA0B7C;IAEF,MAAM,CAAC,cAAc,YAAa,GAAG,UAqEnC;IAEF,MAAM,CAAC,SAAS,aA6Bd;IAEF,MAAM,CAAC,OAAO,sBAyBZ;CACH;AAGD,eAAe,KAAK,CAAC"}

package/lib/typescript/src/components/Connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Connect.d.ts","sourceRoot":"","sources":["../../../../src/components/Connect.tsx"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAC7F,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,UAAU,YAAY;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CACxC;AAED,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA0KnC,CAAC;AAWF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Connect.d.ts","sourceRoot":"","sources":["../../../../src/components/Connect.tsx"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAC7F,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,UAAU,YAAY;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CACxC;AAED,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA6KnC,CAAC;AAuHF,eAAe,OAAO,CAAC"}

package/lib/typescript/src/specs/react-native-acoustic-connect.nitro.d.ts

@@ -147,7 +147,12 @@ export interface AcousticConnectRN extends HybridObject<{
      * @param eventName Event name; appears in the posted JSON.
      * @param values Flat key/value pairs to attach to the event.
      * @param level Monitoring level for this event.
-     * @returns `true` if the event was queued.
+     * @returns `true` if the SDK **accepted the event for delivery** — not
+     *   that the collector received it. Events are queued on device and posted
+     *   in batches later, so nothing this call can return attests to delivery
+     *   or to server-side acceptance. A `false` means the SDK rejected the
+     *   event outright and nothing was queued; the bridge also logs that to
+     *   logcat / os_log so it is visible without inspecting the return value.
      */
     logCustomEvent(eventName: string, values: Record<string, string | number | boolean>, level: number): boolean;
     /**
@@ -166,7 +171,12 @@ export interface AcousticConnectRN extends HybridObject<{
      * @param values Signal payload. Objects, arrays, strings, numbers,
      *   booleans and `null` are all carried through.
      * @param level Monitoring level for this signal.
-     * @returns `true` if the signal was queued.
+     * @returns `true` if the SDK **accepted the signal for delivery** — not
+     *   that the collector received it, and not that it passed server-side
+     *   schema validation. Signals are queued on device and posted later, so
+     *   nothing this call can return attests to delivery. A `false` means the
+     *   SDK rejected it and nothing was queued; the bridge logs that to
+     *   logcat / os_log.
      *
      * @remarks
      * **Android limitation — top-level numbers.** The Android SDK's
@@ -177,7 +187,8 @@ export interface AcousticConnectRN extends HybridObject<{
      * `JSONObject`/`JSONArray` values itself. iOS carries top-level numbers
      * normally. Send numbers inside a nested object when cross-platform
      * parity matters. This is a pre-existing SDK-side gap, not a
-     * restriction of this bridge.
+     * restriction of this bridge — the Android bridge now names the affected
+     * keys in a logcat warning so the loss is not silent.
      *
      * @example Nested payload
      * ```ts
@@ -218,6 +229,14 @@ export interface AcousticConnectRN extends HybridObject<{
      *   screen"; `0` captures immediately.
      *
      * Prefer `TLTRN.logScreenLayout`, which defaults to the configured delay.
+     *
+     * @returns For a `delay` of `0`, whether the capture itself succeeded. For
+     *   any positive or configured delay, only that the capture was
+     *   **scheduled** — the native deferred overload dispatches and returns
+     *   immediately, so a `true` says nothing about what the capture found
+     *   when it eventually ran. Failures after that point (no view controller
+     *   resolved, config gating the capture off) surface in logcat / os_log,
+     *   not here.
      */
     logScreenLayout(name: string, delay: number): boolean;
     logDialogShowEvent(dialogId: string, dialogTitle: string, dialogType: string): boolean;
@@ -300,6 +319,14 @@ export interface AcousticConnectRN extends HybridObject<{
      *   { registrationMethod: 'email' }
      * )
      * ```
+     *
+     * @returns `true` if the SDK **accepted the identity signal for
+     *   delivery**. It does not mean the signal reached the collector, and it
+     *   does not mean the collector kept it — a schema-invalid signal (the
+     *   wrong method key above) is discarded server-side after resolving
+     *   `true` here. Never rejects. A `false` means the SDK rejected the call
+     *   locally, e.g. a blank identifier; the bridge logs that to logcat /
+     *   os_log.
      */
     logIdentity(identifierName: string, identifierValue: string, signalType?: string, additionalParameters?: Record<string, string>): Promise<boolean>;
     /**

package/lib/typescript/src/specs/react-native-acoustic-connect.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-native-acoustic-connect.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/react-native-acoustic-connect.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"react-native-acoustic-connect.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/react-native-acoustic-connect.nitro.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -92,12 +92,15 @@
         "plugin/swift",
         "plugin/src",
         "cli",
+        "!cli/__tests__/**",
         "ConnectConfig.example.json",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
         "scripts",
         "Examples/SampleUI/**/*",
+        "!Examples/SampleUI/**/__tests__/**",
+        "!Examples/SampleUI/**/*.test.*",
         "!Examples/SampleUI/node_modules/**",
         "!Examples/SampleUI/temp/**",
         "!Examples/SampleUI/logs/**",
@@ -230,7 +233,7 @@
     "source": "src/index",
     "summary": "react-native ios android tealeaf connect cxa wxca er enhanced-replay",
     "types": "./lib/typescript/src/index.d.ts",
-    "version": "19.0.19",
+    "version": "19.0.21",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/src/TLTRN.ts

@@ -131,6 +131,14 @@ class TLTRN {
    * Passing no delay used to send a hardcoded `0`, which made
    * `CaptureLayoutDelay` inert for React Native apps and fired the capture at
    * the *start* of the transition rather than after it.
+   *
+   * @returns With no `delayMs` — the normal case — only that the capture was
+   *   **scheduled**, not that it produced a layout message. The native
+   *   deferred overload dispatches and returns immediately, so anything that
+   *   goes wrong once it runs (no view controller resolved, layout capture
+   *   gated off by config) cannot be reflected here; those surface in logcat
+   *   / os_log instead. Pass `0` and the value describes the capture itself,
+   *   at the cost of capturing mid-transition.
    */
   static logScreenLayout = (name: string | undefined, delayMs?: number) => {
     TLTRN.currentScreen = name || '';
@@ -193,8 +201,86 @@ class TLTRN {
     return result;
   };
   
+  /**
+   * Keys already warned about, so a call site inside a render or a list loop
+   * warns once rather than on every pass.
+   */
+  static warnedNestedValueSites = new Set<string>();
+
+  /**
+   * Cap on {@link warnedNestedValueSites}.
+   *
+   * The site key includes the nested keys' names, so a payload built from an
+   * API response — per-record ids, timestamps — makes every call a distinct
+   * site, and the set would then grow for the life of the session. By the
+   * hundredth distinct shape the warning has made its point, so it stops
+   * instead of accumulating: bounded memory matters more than warning about
+   * shape 101.
+   */
+  static WARNED_NESTED_VALUE_SITES_MAX = 100;
+
+  /**
+   * Warns when a flat-values payload carries a nested object or array.
+   *
+   * `logCustomEvent`/`logDialogCustomEvent` are typed for flat scalars, but
+   * TypeScript types are erased at runtime: a payload built from an API
+   * response, widened through `any`, or passed from untyped JS reaches the
+   * bridge with its nesting intact. Both platforms then reshape it silently —
+   * Android's SDK chain is typed `HashMap<String, String>` end to end, so a
+   * nested value is stringified into whatever its `toString()` yields — and
+   * the call still returns `true`. `logSignal` is the API that carries nested
+   * JSON on both platforms.
+   *
+   * Warning only: the payload is passed through untouched, so this changes no
+   * behaviour and cannot break a caller who is relying on today's reshaping.
+   *
+   * @param api    Name of the calling API, for the message.
+   * @param values The payload about to cross the bridge.
+   */
+  static warnOnNestedValues = (api: string, values: Record<string, unknown>) => {
+    if (values == null || typeof values !== 'object') {
+      return;
+    }
+    const nested = Object.keys(values).filter((key) => {
+      const value = (values as Record<string, unknown>)[key];
+      return typeof value === 'object' && value !== null;
+    });
+    if (nested.length === 0) {
+      return;
+    }
+    const site = `${api}:${nested.sort().join(',')}`;
+    if (TLTRN.warnedNestedValueSites.has(site)) {
+      return;
+    }
+    if (TLTRN.warnedNestedValueSites.size >= TLTRN.WARNED_NESTED_VALUE_SITES_MAX) {
+      return;
+    }
+    TLTRN.warnedNestedValueSites.add(site);
+    console.warn(
+      `TLTRN.${api}: nested value(s) [${nested.sort().join(', ')}] will be flattened — ` +
+        `${api} carries flat scalars only, and the native SDKs reshape anything else ` +
+        `without reporting it. Use logSignal for nested JSON; it is carried intact on ` +
+        `both platforms.`
+    );
+  };
+
+  /**
+   * Logs a custom event.
+   *
+   * @param eventName Event name, as it appears in the posted JSON.
+   * @param values    Flat key/value pairs. Nested objects and arrays are NOT
+   *   supported here and are reshaped by the native SDKs — use `logSignal`
+   *   for nested JSON.
+   * @param level     Monitoring level for this event.
+   * @returns Whether the native SDK **accepted the event for delivery** —
+   *   not whether the collector received it. The event is queued locally and
+   *   posted later, so no return value from this call can attest to delivery;
+   *   a `true` here means only that the SDK took the event. A `false` is also
+   *   logged natively (logcat / os_log) so the rejection is visible.
+   */
   static logCustomEvent = async (eventName: string, values: Record<string, string | number | boolean>, level: number) => {
     let result = false
+    TLTRN.warnOnNestedValues('logCustomEvent', values);
     try {
       result = AcousticConnectRN.logCustomEvent(eventName, values, level);
     } catch (error: Error | any) {
@@ -234,8 +320,15 @@ class TLTRN {
     return result;
   };
 
+  /**
+   * Logs a custom event tied to a dialog.
+   *
+   * Same flat-values contract and same return-value meaning as
+   * {@link logCustomEvent} — it routes to the same native API.
+   */
   static logDialogCustomEvent = async (dialogId: string, eventName: string, values: Record<string, string | number | boolean>) => {
     let result = false
+    TLTRN.warnOnNestedValues('logDialogCustomEvent', values);
     try {
       result = AcousticConnectRN.logDialogCustomEvent(dialogId, eventName, values);
     } catch (error: Error | any) {

package/src/components/Connect.tsx

@@ -131,7 +131,11 @@ const Connect: React.FC<ConnectProps> = ({
 
         // Listen for the 'state' event to track navigation state changes
         const unsubscribeState = navigation.current.addListener("state", () => {
-            currentRoute.current = extractName(navigation) || navigation.current.getCurrentRoute()?.name;
+            // extractName resolves the focused route through the nested
+            // navigators itself, so there is no outer-level fallback to chain
+            // here — one used to be appended, which reported the tab name for
+            // every push inside that tab.
+            currentRoute.current = extractName(navigation);
 
             // Both platforms take the same path. iOS used to be excluded from
             // the layout call, which left the wrapper with no layout trigger
@@ -158,12 +162,9 @@ const Connect: React.FC<ConnectProps> = ({
     }, [navReady, navigation]);
 
     const onStartShouldSetResponderCapture = useCallback((event: any) => {
-        if (navigation?.current?.getCurrentRoute) {
-            currentRoute.current =
-                extractName(navigation) || navigation.current.getCurrentRoute()?.name;
-            if (currentRoute.current) {
-                TLTRN.logScreenViewPageName(currentRoute.current);
-            }
+        currentRoute.current = extractName(navigation);
+        if (currentRoute.current) {
+            TLTRN.logScreenViewPageName(currentRoute.current);
         }
         TLTRN.logClickEvent(event);
         return false; // Must remain false so events bubble to the host app's handlers
@@ -175,16 +176,18 @@ const Connect: React.FC<ConnectProps> = ({
         }
         initial.current = true;
 
-        if (navigation?.current?.getCurrentRoute) {
-            currentRoute.current = navigation.current.getCurrentRoute()?.name;
-            // Same unification as the 'state' listener above: the split sent
-            // only a screenview on iOS and only a layout on Android, so
-            // neither platform got both from the first-paint trigger. No delay
-            // argument, for the reason given there.
-            if (currentRoute.current) {
-                TLTRN.logScreenViewPageName(currentRoute.current);
-                TLTRN.logScreenLayout(currentRoute.current);
-            }
+        // Resolved through extractName like the other two triggers. This site
+        // used to read `getCurrentRoute()?.name` directly, so a `params.name`
+        // override was honoured on navigation but silently ignored for the
+        // first-paint screen — the same screen reported under two names.
+        currentRoute.current = extractName(navigation);
+        // Same unification as the 'state' listener above: the split sent
+        // only a screenview on iOS and only a layout on Android, so
+        // neither platform got both from the first-paint trigger. No delay
+        // argument, for the reason given there.
+        if (currentRoute.current) {
+            TLTRN.logScreenViewPageName(currentRoute.current);
+            TLTRN.logScreenLayout(currentRoute.current);
         }
         return true;
     }, [navigation]);
@@ -202,13 +205,121 @@ const Connect: React.FC<ConnectProps> = ({
     );
 };
 
+/**
+ * Walks a React Navigation state down to the deepest **focused** route.
+ *
+ * Nested navigators are the default architecture of production RN apps: a tab
+ * navigator whose tabs each hold a stack. The container's root state then
+ * describes only the outer level, and the route that the user is actually
+ * looking at lives in `routes[index].state`, recursively. Reading the outer
+ * level alone reports the *tab* name for every push inside that tab, so screen
+ * changes below the first level are invisible to analytics and replay.
+ *
+ * `index` can legitimately be absent on a partial/rehydrated state, in which
+ * case React Navigation treats the last route as focused — matched here.
+ *
+ * A depth cap guards against a malformed state whose nesting cycles; 32 is far
+ * past any real navigator tree.
+ */
+function findFocusedRoute(state: any): any {
+    let current = state;
+    let depth = 0;
+    while (current?.routes?.length && depth++ < 32) {
+        const index = current.index ?? current.routes.length - 1;
+        const route = current.routes[index];
+        if (!route?.state?.routes?.length) {
+            return route;
+        }
+        current = route.state;
+    }
+    return undefined;
+}
+
+/**
+ * Containers already reported by {@link warnExtractNameFailed}.
+ *
+ * Keyed by the container itself, so a ref that throws on every navigation
+ * produces one line rather than one per transition, while a genuinely
+ * different container still gets its own. A `WeakSet` holds no strong
+ * reference, so remembering a container cannot keep it alive.
+ */
+const extractNameErrorReported = new WeakSet<object>();
+
+/**
+ * Reports, once per container, that resolving the current route threw.
+ *
+ * A throw here is expected and harmless during teardown, which is why
+ * ``extractName`` swallows it. A ref that keeps throwing is a different
+ * matter: every screen view goes unnamed, and without a line here that looks
+ * exactly like a ref that never attached. One warning separates the two
+ * without flooding a listener that fires per navigation.
+ */
+function warnExtractNameFailed(container: unknown, error: unknown) {
+    if (typeof container === "object" && container !== null) {
+        if (extractNameErrorReported.has(container)) {
+            return;
+        }
+        extractNameErrorReported.add(container);
+    }
+    console.warn(
+        "Connect: could not resolve the current route — the navigation container ref threw. " +
+        "Screen views stay unnamed while this persists (harmless if the container is unmounting). " +
+        "Cause:",
+        error
+    );
+}
+
+/**
+ * The screen name to report for the navigation container's current position.
+ *
+ * Resolution order:
+ *
+ * 1. The focused route resolved from `getRootState()` by ``findFocusedRoute``.
+ *    Taking the state and walking it here — rather than trusting a single
+ *    accessor — keeps the wrapper correct regardless of whether the host app's
+ *    navigation library resolves nesting inside `getCurrentRoute()`, and works
+ *    for a custom container ref that exposes state but not that helper.
+ * 2. `getCurrentRoute()`, for refs that expose no `getRootState`.
+ *
+ * Either way `params.name` wins over the route's own `name` when the host app
+ * supplies it — the documented override for giving a route a human-readable
+ * analytics name. Only a non-empty string counts, so `params: { name: '' }`
+ * falls through to the route name instead of blanking the screenview.
+ *
+ * Returns `""` when nothing resolves, which both callers treat as "skip".
+ */
 function extractName(navigation: any): string {
-    const routeParams = navigation?.current?.getCurrentRoute?.()?.params;
-    if (routeParams) {
-        const { name } = routeParams;
-        return name ? name : navigation.current?.getCurrentRoute()?.name || "";
+    const container = navigation?.current;
+    if (!container) {
+        return "";
+    }
+
+    let route: any;
+    try {
+        route = findFocusedRoute(container.getRootState?.());
+    } catch (error) {
+        // A container mid-teardown can throw out of getRootState(). Screen
+        // naming is not worth taking the host app's navigation down for.
+        warnExtractNameFailed(container, error);
+        route = undefined;
+    }
+    if (!route) {
+        try {
+            route = container.getCurrentRoute?.();
+        } catch (error) {
+            warnExtractNameFailed(container, error);
+            route = undefined;
+        }
+    }
+    if (!route) {
+        return "";
+    }
+
+    const overridden = route.params?.name;
+    if (typeof overridden === "string" && overridden.length > 0) {
+        return overridden;
     }
-    return "";
+    return typeof route.name === "string" ? route.name : "";
 }
 
 export default Connect;

package/src/specs/react-native-acoustic-connect.nitro.ts

@@ -164,7 +164,12 @@ export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android:
      * @param eventName Event name; appears in the posted JSON.
      * @param values Flat key/value pairs to attach to the event.
      * @param level Monitoring level for this event.
-     * @returns `true` if the event was queued.
+     * @returns `true` if the SDK **accepted the event for delivery** — not
+     *   that the collector received it. Events are queued on device and posted
+     *   in batches later, so nothing this call can return attests to delivery
+     *   or to server-side acceptance. A `false` means the SDK rejected the
+     *   event outright and nothing was queued; the bridge also logs that to
+     *   logcat / os_log so it is visible without inspecting the return value.
      */
     logCustomEvent(eventName: string, values: Record<string, string | number | boolean>, level: number): boolean
 
@@ -184,7 +189,12 @@ export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android:
      * @param values Signal payload. Objects, arrays, strings, numbers,
      *   booleans and `null` are all carried through.
      * @param level Monitoring level for this signal.
-     * @returns `true` if the signal was queued.
+     * @returns `true` if the SDK **accepted the signal for delivery** — not
+     *   that the collector received it, and not that it passed server-side
+     *   schema validation. Signals are queued on device and posted later, so
+     *   nothing this call can return attests to delivery. A `false` means the
+     *   SDK rejected it and nothing was queued; the bridge logs that to
+     *   logcat / os_log.
      *
      * @remarks
      * **Android limitation — top-level numbers.** The Android SDK's
@@ -195,7 +205,8 @@ export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android:
      * `JSONObject`/`JSONArray` values itself. iOS carries top-level numbers
      * normally. Send numbers inside a nested object when cross-platform
      * parity matters. This is a pre-existing SDK-side gap, not a
-     * restriction of this bridge.
+     * restriction of this bridge — the Android bridge now names the affected
+     * keys in a logcat warning so the loss is not silent.
      *
      * @example Nested payload
      * ```ts
@@ -236,6 +247,14 @@ export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android:
      *   screen"; `0` captures immediately.
      *
      * Prefer `TLTRN.logScreenLayout`, which defaults to the configured delay.
+     *
+     * @returns For a `delay` of `0`, whether the capture itself succeeded. For
+     *   any positive or configured delay, only that the capture was
+     *   **scheduled** — the native deferred overload dispatches and returns
+     *   immediately, so a `true` says nothing about what the capture found
+     *   when it eventually ran. Failures after that point (no view controller
+     *   resolved, config gating the capture off) surface in logcat / os_log,
+     *   not here.
      */
     logScreenLayout(name: string, delay: number): boolean
     // New dialog event handling methods
@@ -320,6 +339,14 @@ export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android:
      *   { registrationMethod: 'email' }
      * )
      * ```
+     *
+     * @returns `true` if the SDK **accepted the identity signal for
+     *   delivery**. It does not mean the signal reached the collector, and it
+     *   does not mean the collector kept it — a schema-invalid signal (the
+     *   wrong method key above) is discarded server-side after resolving
+     *   `true` here. Never rejects. A `false` means the SDK rejected the call
+     *   locally, e.g. a blank identifier; the bridge logs that to logcat /
+     *   os_log.
      */
     logIdentity(
         identifierName: string,

package/Examples/SampleUI/__tests__/App.test.tsx

@@ -1,17 +0,0 @@
-/**
- * @format
- */
-
-import 'react-native';
-import React from 'react';
-import App from '../App';
-
-// Note: import explicitly to use the types shipped with jest.
-import {it} from '@jest/globals';
-
-// Note: test renderer must be required after react-native.
-import renderer from 'react-test-renderer';
-
-it('renders correctly', () => {
-  renderer.create(<App />);
-});