react-native-acoustic-connect-beta 18.0.27 → 18.0.29

package/nitrogen/generated/ios/swift/HybridAcousticConnectRNSpec.swift

@@ -37,6 +37,7 @@ public protocol HybridAcousticConnectRNSpec_protocol: HybridObject {
   func logDialogDismissEvent(dialogId: String, dismissReason: String) throws -> Bool
   func logDialogButtonClickEvent(dialogId: String, buttonText: String, buttonIndex: Double) throws -> Bool
   func logDialogCustomEvent(dialogId: String, eventName: String, values: Dictionary<String, Variant_Bool_String_Double>) throws -> Bool
+  func logIdentity(identifierName: String, identifierValue: String, signalType: String?, additionalParameters: Dictionary<String, String>?) throws -> Promise<Bool>
   func pushDidRegisterWithToken(deviceToken: ArrayBuffer) throws -> Promise<Bool>
   func pushDidFailToRegister(error: PushErrorInfo) throws -> Promise<Bool>
   func pushDidReceiveNotification(userInfo: Dictionary<String, Variant_Bool_String_Double>) throws -> Promise<Bool>

package/nitrogen/generated/ios/swift/HybridAcousticConnectRNSpec_cxx.swift

@@ -604,6 +604,47 @@ open class HybridAcousticConnectRNSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func logIdentity(identifierName: std.string, identifierValue: std.string, signalType: bridge.std__optional_std__string_, additionalParameters: bridge.std__optional_std__unordered_map_std__string__std__string__) -> bridge.Result_std__shared_ptr_Promise_bool___ {
+    do {
+      let __result = try self.__implementation.logIdentity(identifierName: String(identifierName), identifierValue: String(identifierValue), signalType: { () -> String? in
+        if bridge.has_value_std__optional_std__string_(signalType) {
+          let __unwrapped = bridge.get_std__optional_std__string_(signalType)
+          return String(__unwrapped)
+        } else {
+          return nil
+        }
+      }(), additionalParameters: { () -> Dictionary<String, String>? in
+        if bridge.has_value_std__optional_std__unordered_map_std__string__std__string__(additionalParameters) {
+          let __unwrapped = bridge.get_std__optional_std__unordered_map_std__string__std__string__(additionalParameters)
+          return { () -> Dictionary<String, String> in
+            var __dictionary = Dictionary<String, String>(minimumCapacity: __unwrapped.size())
+            let __keys = bridge.get_std__unordered_map_std__string__std__string__keys(__unwrapped)
+            for __key in __keys {
+              let __value = bridge.get_std__unordered_map_std__string__std__string__value(__unwrapped, __key)
+              __dictionary[String(__key)] = String(__value)
+            }
+            return __dictionary
+          }()
+        } else {
+          return nil
+        }
+      }())
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_bool__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_bool__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_bool__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func pushDidRegisterWithToken(deviceToken: ArrayBuffer) -> bridge.Result_std__shared_ptr_Promise_bool___ {
     do {

package/nitrogen/generated/shared/c++/HybridAcousticConnectRNSpec.cpp

@@ -38,6 +38,7 @@ namespace margelo::nitro::acousticconnectrn {
       prototype.registerHybridMethod("logDialogDismissEvent", &HybridAcousticConnectRNSpec::logDialogDismissEvent);
       prototype.registerHybridMethod("logDialogButtonClickEvent", &HybridAcousticConnectRNSpec::logDialogButtonClickEvent);
       prototype.registerHybridMethod("logDialogCustomEvent", &HybridAcousticConnectRNSpec::logDialogCustomEvent);
+      prototype.registerHybridMethod("logIdentity", &HybridAcousticConnectRNSpec::logIdentity);
       prototype.registerHybridMethod("pushDidRegisterWithToken", &HybridAcousticConnectRNSpec::pushDidRegisterWithToken);
       prototype.registerHybridMethod("pushDidFailToRegister", &HybridAcousticConnectRNSpec::pushDidFailToRegister);
       prototype.registerHybridMethod("pushDidReceiveNotification", &HybridAcousticConnectRNSpec::pushDidReceiveNotification);

package/nitrogen/generated/shared/c++/HybridAcousticConnectRNSpec.hpp

@@ -83,6 +83,7 @@ namespace margelo::nitro::acousticconnectrn {
       virtual bool logDialogDismissEvent(const std::string& dialogId, const std::string& dismissReason) = 0;
       virtual bool logDialogButtonClickEvent(const std::string& dialogId, const std::string& buttonText, double buttonIndex) = 0;
       virtual bool logDialogCustomEvent(const std::string& dialogId, const std::string& eventName, const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values) = 0;
+      virtual std::shared_ptr<Promise<bool>> logIdentity(const std::string& identifierName, const std::string& identifierValue, const std::optional<std::string>& signalType, const std::optional<std::unordered_map<std::string, std::string>>& additionalParameters) = 0;
       virtual std::shared_ptr<Promise<bool>> pushDidRegisterWithToken(const std::shared_ptr<ArrayBuffer>& deviceToken) = 0;
       virtual std::shared_ptr<Promise<bool>> pushDidFailToRegister(const PushErrorInfo& error) = 0;
       virtual std::shared_ptr<Promise<bool>> pushDidReceiveNotification(const std::unordered_map<std::string, std::variant<bool, std::string, double>>& userInfo) = 0;

package/package.json

@@ -1,5 +1,5 @@
 {
-    "author": "Acoustic, L.P., Omar Hernandez, Chang Jie Yang",
+    "author": "Acoustic, L.P., Radoslaw Serek, Aksana Naskalava",
     "dependencies": {
         "@prettier/plugin-xml": "^2.2.0",
         "fast-xml-parser": "^4.0.8",
@@ -14,12 +14,12 @@
         "@types/jest": "^29.5.12",
         "@types/react": "^19.0.10",
         "jetifier": "^1.6.3",
-        "nitrogen": "0.35.4",
+        "nitrogen": "0.35.9",
         "prettier-plugin-kotlin": "^2.1.0",
         "react": "19.1.1",
         "react-native": "0.82.1",
         "react-native-builder-bob": "^0.37.0",
-        "react-native-nitro-modules": "0.35.4",
+        "react-native-nitro-modules": "0.35.9",
         "release-it": "^19.0.2",
         "typescript": "5.0.4"
     },
@@ -99,7 +99,7 @@
     "peerDependencies": {
         "react": ">=19.1.1 <20.0.0",
         "react-native": ">=0.82.0 <0.86.0",
-        "react-native-nitro-modules": ">=0.35.0 <0.37.0"
+        "react-native-nitro-modules": "0.35.9"
     },
     "prettier": {
         "quoteProps": "consistent",
@@ -195,7 +195,7 @@
     "source": "src/index",
     "summary": "react-native ios android tealeaf connect cxa wxca er enhanced-replay",
     "types": "./lib/typescript/src/index.d.ts",
-    "version": "18.0.27",
+    "version": "18.0.29",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/src/TLTRN.ts

@@ -16,13 +16,29 @@ import DialogListener from "./utils/DialogListener";
 import type { DialogEvent, DialogButtonClickEvent, DialogDismissEvent } from "./utils/DialogListener";
 import AcousticConnectRN from './index'; 
 
+// Preserve any previously-installed handler (e.g. React Native's red-box
+// handler) so we augment rather than replace it.
 // @ts-ignore
-global.ErrorUtils.setGlobalHandler((e: any, _isFatal: boolean) => {
-  AcousticConnectRN.logExceptionEvent(
-      JSON.stringify(e),
-      JSON.stringify(e),
-      true
-  );
+const previousGlobalErrorHandler = global.ErrorUtils?.getGlobalHandler?.();
+
+// @ts-ignore
+global.ErrorUtils?.setGlobalHandler?.((e: any, isFatal: boolean) => {
+  // A global error handler must never throw — otherwise it masks the ORIGINAL
+  // error. `AcousticConnectRN` can be undefined here (e.g. the native module
+  // failed to load, or during the module-load circular import), so guard the
+  // call and always forward to the previous handler so the real error still
+  // surfaces and fatals still crash.
+  try {
+    AcousticConnectRN?.logExceptionEvent?.(
+        JSON.stringify(e),
+        JSON.stringify(e),
+        true
+    );
+  } catch (loggingError: Error | any) {
+    console.warn('TLTRN: failed to log uncaught exception:', loggingError?.message);
+  } finally {
+    previousGlobalErrorHandler?.(e, isFatal);
+  }
 });
 
 class TLTRN {
@@ -294,11 +310,15 @@ class TLTRN {
     }
 
     if (message.module === "ExceptionsManager") {
-      AcousticConnectRN.logExceptionEvent(
-        message.args[0],
-        JSON.stringify(message.args[1]),
-        true
-      );
+      try {
+        AcousticConnectRN?.logExceptionEvent?.(
+          message.args[0],
+          JSON.stringify(message.args[1]),
+          true
+        );
+      } catch (error: Error | any) {
+        console.log('logExceptionEvent (bridge) error: ', error?.message);
+      }
     }
   };
 

package/src/components/Connect.tsx

@@ -37,7 +37,7 @@ const Connect: React.FC<ConnectProps> = ({
     navigationRef,
 }) => {
     const child = children as any;
-    // CA-138631: React 19 moved the ref off `element.ref` onto `element.props.ref`.
+    // React 19 moved the ref off `element.ref` onto `element.props.ref`.
     // Read `props.ref` first; the legacy `child.ref` fallback is a defensive
     // guard from the React 18 era — kept to avoid a behavioural change.
     const childProvidedRef = child?.props?.ref ?? child?.ref;

package/src/index.ts

@@ -7,7 +7,7 @@
 * Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
 * prohibited.
 * 
-* Created by Omar Hernandez on 5/9/25.
+* Created on 5/9/25.
 * 
 ********************************************************************************************/
 
@@ -21,7 +21,24 @@ import { withAcousticAutoDialog } from './utils/withAcousticAutoDialog'
 import DialogDebugger from './utils/DialogDebugger'
 import TLTRN from './TLTRN'
 
-const AcousticConnectRN = NitroModules.createHybridObject<AcousticConnectRNSpec>('AcousticConnectRN')
+// Instantiating the native HybridObject is the first thing that fails when the
+// app's `react-native-nitro-modules` runtime does not match the version this SDK
+// was generated against (the generated registration is tightly coupled to the
+// Nitro version — see peerDependencies). Without this guard the failure surfaces
+// as an opaque `ClassNotFoundException` and an `undefined` module far from the
+// cause. Re-throw with an actionable message instead.
+let AcousticConnectRN: AcousticConnectRNSpec
+try {
+  AcousticConnectRN = NitroModules.createHybridObject<AcousticConnectRNSpec>('AcousticConnectRN')
+} catch (error) {
+  throw new Error(
+    '[AcousticConnectRN] Failed to load the native HybridObject. This almost ' +
+      'always means a `react-native-nitro-modules` version mismatch: this SDK is ' +
+      'built against the exact version declared in its peerDependencies, so your ' +
+      'app must resolve that same version (check `npm ls react-native-nitro-modules`). ' +
+      `Original error: ${String(error)}`
+  )
+}
 
 export { Connect, TLTRN, KeyboardListener, DialogListener, useDialogTracking, DialogDebugger, withAcousticAutoDialog }
 export default AcousticConnectRN

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

@@ -7,7 +7,7 @@
 // prohibited.
 //
 //
-//  Created by Omar Hernandez on 5/9/25.
+//  Created on 5/9/25.
 //
 
 import { type HybridObject } from 'react-native-nitro-modules'
@@ -140,6 +140,52 @@ export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android:
     logDialogButtonClickEvent(dialogId: string, buttonText: string, buttonIndex: number): boolean
     logDialogCustomEvent(dialogId: string, eventName: string, values: Record<string, string | number | boolean>): boolean
 
+    /**
+     * Logs a user identity so the current device/session can be associated with
+     * a known Connect contact — the foundation for audience building and
+     * cross-channel engagement. Wraps the native identity loggers
+     * (`ConnectSDK.shared.identity.log` on iOS, `Connect.logIdentificationEvent`
+     * on Android).
+     *
+     * Unlike the synchronous analytics loggers above, this returns a `Promise`:
+     * `ConnectSDK.shared` (iOS) is `@MainActor`-isolated, so the bridge hops to the
+     * main actor and resolves with the *real* success/failure value rather than
+     * firing and forgetting.
+     *
+     * The native APIs return `false` — and emit no signal — when either
+     * `identifierName` or `identifierValue` is empty/blank after trimming.
+     *
+     * @param identifierName  Identifier name, e.g. `'Email'`.
+     * @param identifierValue Identifier value, e.g. `'user@example.com'`.
+     * @param signalType      Optional signal type; the bridge supplies
+     *   `'loggedIn'` when omitted (identity logging typically marks a sign-in),
+     *   overriding the native SDKs' own `'pageView'` default.
+     * @param additionalParameters Optional extra key/value pairs merged into the
+     *   signal payload. Only when omitted (`undefined`) does the bridge supply
+     *   the default `{ registrationMethod: 'email' }`; an explicitly-provided
+     *   map is used as-is, so passing an empty `{}` sends no extra parameters
+     *   (the default is not merged in). A `'url'` entry is honoured uniformly on
+     *   both platforms: on Android it is routed to the SDK's explicit `url`
+     *   parameter, on iOS it rides inside the parameter map (where the native
+     *   API expects it).
+     * @returns A promise resolving to `true` if the identity signal was
+     *   dispatched, `false` otherwise (including the blank-identifier case).
+     *   Never rejects.
+     *
+     * @example
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * await AcousticConnectRN.logIdentity('Email', 'user@example.com')
+     * ```
+     */
+    logIdentity(
+        identifierName: string,
+        identifierValue: string,
+        signalType?: string,
+        additionalParameters?: Record<string, string>
+    ): Promise<boolean>
+
     // ── Push: APNs lifecycle (iOS) ──────────────────────────────────────────
     //
     // Push mode (automatic / manual / off) is configured in `ConnectConfig.json`

package/src/utils/withAcousticAutoDialog.tsx

@@ -7,7 +7,7 @@
 * Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
 * prohibited.
 * 
-* Created by Omar Hernandez on 5/9/25.
+* Created on 5/9/25.
 * 
 ********************************************************************************************/