react-native-acoustic-connect-beta 18.0.20 → 18.0.22

package/AcousticConnectRN.podspec

@@ -10,6 +10,19 @@ dependencyName = useRelease ? 'AcousticConnect' : 'AcousticConnectDebug'
 iOSVersion = connectConfig["Connect"]["iOSVersion"]
 dependencyVersion = iOSVersion.to_s.empty? ? "" : ", '#{iOSVersion}'"
 
+# Write the merged consumer config to the resource-bundle source path AT POD INSTALL TIME.
+# This MUST happen before CocoaPods builds the AcousticConnectRNConfig bundle target,
+# which it does as a dependency of the parent target — too early for any build-time
+# script_phase to influence. Writing here ensures the bundle ships the consumer's
+# AppKey / PostMessageUrl / KillSwitchUrl from the very first build, instead of an
+# empty placeholder that causes the SDK to fall back to its bundled demo defaults.
+# See: ios/AcousticConnectRNConfig.json (placeholder shipped in the npm tarball;
+# overwritten here on every `pod install`).
+File.open(File.join(__dir__, 'ios', 'AcousticConnectRNConfig.json'), 'w') do |f|
+  f.write(JSON.pretty_generate(connectConfig))
+end
+puts "Merged ConnectConfig.json into ios/AcousticConnectRNConfig.json (install-time)"
+
 puts "*********react-native-acoustic-connect-beta.podspec*********"
 puts "connectConfig:"
 puts JSON.pretty_generate(connectConfig)
@@ -37,8 +50,6 @@ Pod::Spec.new do |s|
     "ios/**/*.{swift}",
     # Autolinking/Registration (Objective-C++)
     "ios/**/*.{m,mm}",
-    # Build Config (Ruby)
-    "ios/ConnectConfig/**/*.{rb}",
     # Implementation (C++ objects)
     "cpp/**/*.{hpp,cpp}",
   ]
@@ -52,11 +63,6 @@ Pod::Spec.new do |s|
     'AcousticConnectRNConfig' => ['ios/AcousticConnectRNConfig.json'],
   }
   s.resource = 'ios/AcousticConnectRNConfig.json'
-  s.script_phase = {
-    :name => 'Build Config',
-    :script => %("${PODS_TARGET_SRCROOT}/ios/ConnectConfig/Build_Config.rb" "${PODS_ROOT}" "ConnectConfig.json" "${PODS_TARGET_SRCROOT}"), 
-    :execution_position => :before_compile,
-  }
 
   load 'nitrogen/generated/ios/AcousticConnectRN+autolinking.rb'
   add_nitrogen_files(s)

package/android/src/main/assets/ConnectAdvancedConfig.json

@@ -24,7 +24,7 @@
     "IpPlaceholder": "N/A",
     "KillSwitchAsync": true,
     "KillSwitchDelay": 300,
-    "LibraryVersion": "11.0.8-beta",
+    "LibraryVersion": "11.0.9-beta",
     "LogFullRequestResponsePayloads": true,
     "MessageTypeHeader": "WorklightHit",
     "MessageTypes": "4,5",

package/android/src/main/assets/ConnectBasicConfig.properties

@@ -1,4 +1,4 @@
-#Fri Apr 24 00:36:32 PDT 2026
+#Tue Apr 28 02:21:07 PDT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/android/src/main/assets/TealeafAdvancedConfig.json

@@ -24,7 +24,7 @@
     "IpPlaceholder": "N/A",
     "KillSwitchAsync": true,
     "KillSwitchDelay": 300,
-    "LibraryVersion": "10.4.27-beta",
+    "LibraryVersion": "10.4.28-beta",
     "LogFullRequestResponsePayloads": true,
     "MessageTypeHeader": "WorklightHit",
     "MessageTypes": "4,5",

package/ios/AcousticConnectRNConfig.json

@@ -0,0 +1,156 @@
+{
+  "Connect": {
+    "AndroidVersion": "11.0.9-beta",
+    "AppKey": "b6c3709b7a4c479bb4b5a9fb8fec324c",
+    "KillSwitchUrl": "https://lib-us-2.brilliantcollector.com/collector/switch/b6c3709b7a4c479bb4b5a9fb8fec324c",
+    "PostMessageUrl": "https://lib-us-2.brilliantcollector.com/collector/collectorPost",
+    "iOSVersion": "",
+    "layoutConfigAndroid": {
+      "AppendMapIds": {
+        "[w,9290],[v,0]": {
+          "mid": "ASimpleUIView"
+        },
+        "idxPathValue": {
+          "mid": "giveAdditionalId2"
+        },
+        "tag2999999": {
+          "mid": "giveAdditionalId1"
+        }
+      },
+      "AutoLayout": {
+        "ExampleMaskingPage": {
+          "CaptureLayoutDelay": 0,
+          "CaptureLayoutOn": 0,
+          "CaptureScreenVisits": false,
+          "CaptureScreenshotOn": 0,
+          "CaptureUserEvents": false,
+          "DisplayName": "",
+          "Masking": {
+            "HasCustomMask": true,
+            "HasMasking": true,
+            "MaskAccessibilityIdList": [],
+            "MaskAccessibilityLabelList": [],
+            "MaskIdList": [
+              "^9[0-9][0-9][0-9]$",
+              "^\\[wvv,0\\],\\[dddv,0\\],\\[v,0\\],\\[v,0\\],\\[v,0\\],\\[b,0\\](.)*$"
+            ],
+            "MaskValueList": [
+              "^4[0-9]{12}(?:[0-9]{3})?$",
+              "^3[47][0-9]{13}$",
+              "^65[4-9][0-9]{13}|64[4-9][0-9]{13}|6011[0-9]{12}|(622(?:12[6-9]|1[3-9][0-9]|[2-8][0-9][0-9]|9[01][0-9]|92[0-5])[0-9]{10})$",
+              "^(5[1-5][0-9]{14}|2(22[1-9][0-9]{12}|2[3-9][0-9]{13}|[3-6][0-9]{14}|7[0-1][0-9]{13}|720[0-9]{12}))$"
+            ],
+            "Sensitive": {
+              "capitalCaseAlphabet": "X",
+              "number": "9",
+              "smallCaseAlphabet": "x",
+              "symbol": "#"
+            }
+          },
+          "NumberOfWebViews": 0,
+          "ScreenChange": false,
+          "ScreenShot": false
+        },
+        "GlobalScreenSettings": {
+          "CaptureLayoutDelay": 1,
+          "CaptureLayoutOn": 2,
+          "CaptureScreenVisits": false,
+          "CaptureScreenshotOn": 2,
+          "CaptureUserEvents": true,
+          "DisplayName": "",
+          "Masking": {
+            "HasCustomMask": true,
+            "HasMasking": true,
+            "MaskAccessibilityIdList": [],
+            "MaskAccessibilityLabelList": [],
+            "MaskIdList": [],
+            "MaskValueList": [],
+            "Sensitive": {
+              "capitalCaseAlphabet": "X",
+              "number": "9",
+              "smallCaseAlphabet": "x",
+              "symbol": "#"
+            }
+          },
+          "NumberOfWebViews": 0,
+          "ScreenChange": true,
+          "ScreenShot": true
+        }
+      }
+    },
+    "layoutConfigIos": {
+      "AppendMapIds": {
+        "[w,9290],[v,0]": {
+          "mid": "ASimpleUIView"
+        },
+        "idxPathValue": {
+          "mid": "giveAdditionalId2"
+        },
+        "tag2999999": {
+          "mid": "giveAdditionalId1"
+        }
+      },
+      "AutoLayout": {
+        "ExampleMaskingPage": {
+          "CaptureLayoutDelay": 0,
+          "CaptureLayoutOn": 0,
+          "CaptureScreenVisits": false,
+          "CaptureScreenshotOn": 0,
+          "CaptureUserEvents": false,
+          "DisplayName": "",
+          "Masking": {
+            "HasCustomMask": true,
+            "HasMasking": true,
+            "MaskAccessibilityIdList": [],
+            "MaskAccessibilityLabelList": [],
+            "MaskIdList": [
+              "^9[0-9][0-9][0-9]$",
+              "^\\[wvv,0\\],\\[dddv,0\\],\\[v,0\\],\\[v,0\\],\\[v,0\\],\\[b,0\\](.)*$"
+            ],
+            "MaskValueList": [
+              "^4[0-9]{12}(?:[0-9]{3})?$",
+              "^3[47][0-9]{13}$",
+              "^65[4-9][0-9]{13}|64[4-9][0-9]{13}|6011[0-9]{12}|(622(?:12[6-9]|1[3-9][0-9]|[2-8][0-9][0-9]|9[01][0-9]|92[0-5])[0-9]{10})$",
+              "^(5[1-5][0-9]{14}|2(22[1-9][0-9]{12}|2[3-9][0-9]{13}|[3-6][0-9]{14}|7[0-1][0-9]{13}|720[0-9]{12}))$"
+            ],
+            "Sensitive": {
+              "capitalCaseAlphabet": "X",
+              "number": "9",
+              "smallCaseAlphabet": "x",
+              "symbol": "#"
+            }
+          },
+          "NumberOfWebViews": 0,
+          "ScreenChange": false,
+          "ScreenShot": false
+        },
+        "GlobalScreenSettings": {
+          "CaptureLayoutDelay": 1,
+          "CaptureLayoutOn": 2,
+          "CaptureScreenVisits": false,
+          "CaptureScreenshotOn": 2,
+          "CaptureUserEvents": true,
+          "DisplayName": "",
+          "Masking": {
+            "HasCustomMask": true,
+            "HasMasking": true,
+            "MaskAccessibilityIdList": [],
+            "MaskAccessibilityLabelList": [],
+            "MaskIdList": [],
+            "MaskValueList": [],
+            "Sensitive": {
+              "capitalCaseAlphabet": "X",
+              "number": "9",
+              "smallCaseAlphabet": "x",
+              "symbol": "#"
+            }
+          },
+          "NumberOfWebViews": 0,
+          "ScreenChange": true,
+          "ScreenShot": true
+        }
+      }
+    },
+    "useRelease": false
+  }
+}

package/ios/HybridAcousticConnectRN.swift

@@ -14,64 +14,30 @@ import Foundation
 import Connect
 import NitroModules
 
-// EOCore and Tealeaf ship as separate modules in the Release iOS SDK and in the
-// Debug SDK before 2.1.2. From Debug 2.1.2 onward they are merged into Connect
-// and these modules are no longer on the search path — so we import them
-// conditionally to support both variants from the same source.
-#if canImport(EOCore)
-import EOCore
-#endif
-#if canImport(Tealeaf)
-import Tealeaf
-#endif
-
-// In the unified SDK, module-name constants were dropped along with the modules
-// themselves. The replacement helper (`ConnectApplicationHelper`) ignores the
-// module name — a single config store holds all keys. We still keep the old
-// names so existing call sites compile unchanged on both variants.
-#if !canImport(EOCore)
-private let kEOCoreModule = "EOCore"
-private let kTLFCoreModule = "TLFCoreModule"
-#endif
-
-// Cross-SDK bridge for the config-item set/get API. On the old SDK this calls
-// through `EOApplicationHelper` with a module name; on the unified SDK it calls
-// through `ConnectApplicationHelper` and the module name is ignored.
+// Single compat entry point for the config-item store. Works against every
+// shipping iOS SDK variant (Release with separate EOCore/Tealeaf, current merged
+// Debug 2.1.2, future merged-only) because `ConnectApplicationHelper` ships with
+// each of them. Not importing `EOCore`/`Tealeaf` avoids a link dependency on
+// frameworks that aren't always packaged into the app bundle.
 private enum ConnectConfigStore {
     @discardableResult
-    static func set(_ key: String, value: Any, forModule moduleName: String) -> Bool {
-#if canImport(EOCore)
-        return EOApplicationHelper.sharedInstance().setConfigItem(key, value: value, forModuleName: moduleName)
-#else
+    static func set(_ key: String, value: Any) -> Bool {
         return ConnectApplicationHelper.sharedInstance().setConfigurableItem(key, value: value)
-#endif
     }
 
-    static func bool(forKey key: String, default def: Bool, moduleName: String) -> Bool {
-#if canImport(EOCore)
-        return EOApplicationHelper().getBOOLconfigItem(forKey: key, withDefault: def, forModuleName: moduleName)
-#else
+    static func bool(forKey key: String, default def: Bool) -> Bool {
         let raw = ConnectApplicationHelper.sharedInstance().value(forConfigurableItem: key)
         if let n = raw as? NSNumber { return n.boolValue }
         if let s = raw as? String   { return (s as NSString).boolValue }
         return def
-#endif
     }
 
-    static func string(forKey key: String, default def: String, moduleName: String) -> String? {
-#if canImport(EOCore)
-        return EOApplicationHelper().getStringItem(forKey: key, withDefault: def, forModuleName: moduleName)
-#else
+    static func string(forKey key: String, default def: String) -> String? {
         return (ConnectApplicationHelper.sharedInstance().value(forConfigurableItem: key) as? String) ?? def
-#endif
     }
 
-    static func number(forKey key: String, default def: Double, moduleName: String) -> Double {
-#if canImport(EOCore)
-        return (EOApplicationHelper().getNumberItem(forKey: key, withDefault: NSNumber(value: def), forModuleName: moduleName) as? NSNumber)?.doubleValue ?? def
-#else
+    static func number(forKey key: String, default def: Double) -> Double {
         return (ConnectApplicationHelper.sharedInstance().value(forConfigurableItem: key) as? NSNumber)?.doubleValue ?? def
-#endif
     }
 }
 
@@ -95,17 +61,89 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     
     func load() {
         DispatchQueue.main.async {
-            self.loadConnectConfig()
-//            EOApplicationHelper().setConfigItem(kConfigurableItemSetGestureDetector, value: "false", forModuleName: kTLFCoreModule)
-//            EOApplicationHelper().setConfigItem(kConfigurableItemLogViewLayoutOnScreenTransition, value: "false", forModuleName: kTLFCoreModule)
-            ConnectApplicationHelper().isReactNative(true, wrapNavigationContainer: true)
-            ConnectApplicationHelper().enableFramework()
+            let connectData = self.parseConnectConfigJSON()
+            let appKey  = (connectData?["AppKey"]         as? String) ?? ""
+            let postURL = (connectData?["PostMessageUrl"] as? String) ?? ""
+
+            // Skip enable entirely if the consumer's config didn't reach us —
+            // proceeding with empty strings would let the SDK silently fall back
+            // to its bundled demo collector, which is exactly the bug this flow
+            // is designed to prevent. Most likely cause: missing or malformed
+            // ConnectConfig.json at the consumer's project root, or `pod install`
+            // didn't run after the file was added.
+            guard !appKey.isEmpty, !postURL.isEmpty else {
+                print("[AcousticConnectRN] SDK NOT ENABLED — empty AppKey or PostMessageUrl. " +
+                      "Verify ConnectConfig.json at your project root contains both fields, " +
+                      "then re-run `pod install`.")
+                return
+            }
+
+            let helper = ConnectApplicationHelper.sharedInstance()
+            helper.isReactNative(true, wrapNavigationContainer: true)
+
+            // Seed bundle defaults via the new internal selector when available.
+            // Required on merged Debug 2.1.2+ SDKs where EOCoreSettings.bundle /
+            // TLFResources.bundle aren't on the app target's resource path; without
+            // it the SDK fails to enable. Runtime-dispatched so older SDKs that
+            // don't expose this method skip cleanly.
+            let applyDefaults = NSSelectorFromString("_connectApplyBundleDefaults")
+            if helper.responds(to: applyDefaults) {
+                helper.perform(applyDefaults)
+            }
+
+            // Enable with explicit appKey/postURL via the new internal selector
+            // when present. The zero-arg `enableFramework()` and the deprecated
+            // 2-arg public form both empirically ignore explicit values on merged
+            // SDKs (they re-read from Connect.framework's bundled demo defaults).
+            // The new `_connectEnableWithAppKey:postURL:` honours the args — same
+            // path the SDK's own ConnectSDK.shared.enable(...) wrapper uses.
+            // Falls back to the deprecated public 2-arg form on older SDKs.
+            let connectEnableSel = NSSelectorFromString("_connectEnableWithAppKey:postURL:")
+            if helper.responds(to: connectEnableSel) {
+                typealias EnableFn = @convention(c) (AnyObject, Selector, NSString, NSString) -> Bool
+                let imp = helper.method(for: connectEnableSel)
+                let fn = unsafeBitCast(imp, to: EnableFn.self)
+                _ = fn(helper, connectEnableSel, appKey as NSString, postURL as NSString)
+            } else {
+                // Older SDK build that doesn't expose the underscored category. The
+                // deprecated 2-arg public form may not honor explicit values on every
+                // SDK version — log so the consumer can tell which path fired if they
+                // see unexpected routing on their dashboard.
+                print("[AcousticConnectRN] Using deprecated enableFramework(_:withPostMessageUrl:) — " +
+                      "the new internal selector is not exposed by this SDK build. " +
+                      "If sessions appear on the wrong dashboard, upgrade the AcousticConnect pod.")
+                _ = helper.enableFramework(appKey, withPostMessageUrl: postURL)
+            }
+
+            // Apply remaining programmatic overrides (everything other than the
+            // two enable parameters) AFTER enable — matches the order in the SDK's
+            // own ConnectSDK.shared.enable(with:) implementation.
+            if let connectData = connectData {
+                self.applyConnectConfig(connectData)
+            }
         }
     }
+
+    /// Reads and returns the `Connect` dictionary from the bundled
+    /// `AcousticConnectRNConfig.json`. The bundle is populated at pod install
+    /// time by the podspec — see `AcousticConnectRN.podspec`. Returns nil when
+    /// the bundle or file is missing; callers fall back to empty values.
+    private func parseConnectConfigJSON() -> [String: Any]? {
+        let bundle = Bundle(for: Self.self)
+        let bundleURL = bundle.resourceURL?.appendingPathComponent("AcousticConnectRNConfig.bundle")
+        let resourceBundle = bundleURL.flatMap { Bundle(url: $0) }
+        let path = resourceBundle?.path(forResource: "AcousticConnectRNConfig", ofType: "json")
+        let data = path.flatMap { try? Data(contentsOf: URL(fileURLWithPath: $0)) }
+        let jsonData = data.flatMap { try? JSONSerialization.jsonObject(with: $0, options: []) as? [String: Any] }
+        return jsonData?["Connect"] as? [String: Any]
+    }
     
-    /// <#Description#>
-    /// - Returns: <#description#>
-    func loadConnectConfig() {
+    /// Applies every recognised key from the parsed `Connect` config as a
+    /// programmatic override. Called by `load()` AFTER enable so values land on
+    /// a fully-initialised SDK. AppKey and PostMessageUrl are skipped here —
+    /// they're passed to enable directly because the SDK's bundle-read
+    /// short-circuits `tempConfigDict` for those two specifically.
+    private func applyConnectConfig(_ connectData: [String: Any]) {
         let eocoreKeys = [
             "CachingLevel", "DoPostAppComesFromBackground", "DoPostAppGoesToBackground", "DoPostAppGoesToClose",
             "DoPostAppIsLaunched", "DoPostOnIntervals", "DynamicConfigurationEnabled", "HasToPersistLocalCache",
@@ -140,29 +178,20 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
             "textBox:_searchFieldBeginChanged", "textBox:_searchFieldBeginEditing", "textBox:_searchFieldEditingChanged",
             "textBox:textChange", "textBox:textChanged", "textBox:textFieldDidChange", "toggleButton:click"
         ]
-        
-        let bundle = Bundle(for: Self.self)
-        let bundleURL = bundle.resourceURL?.appendingPathComponent("AcousticConnectRNConfig.bundle")
-        let resourceBundle = bundleURL.flatMap { Bundle(url: $0) }
-        let path = resourceBundle?.path(forResource: "AcousticConnectRNConfig", ofType: "json")
-        let data = path.flatMap { try? Data(contentsOf: URL(fileURLWithPath: $0)) }
-        let jsonData = data.flatMap { try? JSONSerialization.jsonObject(with: $0, options: []) as? [String: Any] }
-            
-        if let jsonData = jsonData,
-           let connectData = jsonData["Connect"] as? [String: Any] {
-            for (key, value) in connectData {
-                if tealeafKeys.contains(key) {
-                    ConnectConfigStore.set(key, value: value, forModule: kTLFCoreModule)
-                } else if eocoreKeys.contains(key) {
-                    ConnectConfigStore.set(key, value: value, forModule: kEOCoreModule)
-                } else if key == "layoutConfig",
-                          let layoutConfig = value as? [String: Any] {
-                    if let autoLayout = layoutConfig["AutoLayout"] {
-                        ConnectConfigStore.set("AutoLayout", value: autoLayout, forModule: kTLFCoreModule)
-                    }
-                    if let appendMapIds = layoutConfig["AppendMapIds"] {
-                        ConnectConfigStore.set("AppendMapIds", value: appendMapIds, forModule: kTLFCoreModule)
-                    }
+
+        for (key, value) in connectData {
+            // Skip keys load() passes directly to enable — re-applying is harmless but redundant.
+            if key == "AppKey" || key == "PostMessageUrl" { continue }
+
+            if tealeafKeys.contains(key) || eocoreKeys.contains(key) {
+                ConnectConfigStore.set(key, value: value)
+            } else if key == "layoutConfig",
+                      let layoutConfig = value as? [String: Any] {
+                if let autoLayout = layoutConfig["AutoLayout"] {
+                    ConnectConfigStore.set("AutoLayout", value: autoLayout)
+                }
+                if let appendMapIds = layoutConfig["AppendMapIds"] {
+                    ConnectConfigStore.set("AppendMapIds", value: appendMapIds)
                 }
             }
         }
@@ -175,7 +204,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: Whether it was able to set the value as Boolean value.
     func setBooleanConfigItemForKey(key: String, value: Bool, moduleName: String) throws -> Bool {
-        return ConnectConfigStore.set(key, value: value, forModule: moduleName)
+        return ConnectConfigStore.set(key, value: value)
     }
     
     /// Sets the module's configuration item from AdvancedConfig.json or BasicConfig.plist that matches the specified key as a NString value.
@@ -185,7 +214,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: Whether it was able to set the value as Boolean value.
     func setStringItemForKey(key: String, value: String, moduleName: String) throws -> Bool {
-        return ConnectConfigStore.set(key, value: value, forModule: moduleName)
+        return ConnectConfigStore.set(key, value: value)
     }
     
     /// Sets the module's configuration item from AdvancedConfig.json or BasicConfig.plist that matches the specified key as a NSNumber value.
@@ -195,7 +224,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: Whether it was able to set the value as Boolean value.
     func setNumberItemForKey(key: String, value: Double, moduleName: String) throws -> Bool {
-        return ConnectConfigStore.set(key, value: value, forModule: moduleName)
+        return ConnectConfigStore.set(key, value: value)
     }
   
   
@@ -206,7 +235,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: Whether it was able to set the value.
     func setConfigItemForKey(key: String, value: Variant_Bool_String_Double, moduleName: String) throws -> Bool {
-        return ConnectConfigStore.set(key, value: convertVariantToAny(value), forModule: moduleName)
+        return ConnectConfigStore.set(key, value: convertVariantToAny(value))
     }
     
     /// Gets the module's configuration item from AdvancedConfig.json or BasicConfig.plist that matches the specified key as a BOOL value.
@@ -216,7 +245,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: The value of the configuration item key as a BOOL value.
     func getBooleanConfigItemForKey(theDefault: Bool, key: String, moduleName: String) throws -> Bool {
-        return ConnectConfigStore.bool(forKey: key, default: theDefault, moduleName: moduleName)
+        return ConnectConfigStore.bool(forKey: key, default: theDefault)
     }
     
     /// Gets the module's configuration item from AdvancedConfig.json or BasicConfig.plist that matches the specified key as a NString value.
@@ -226,7 +255,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: The value of the configuration item key as a NString value.
     func getStringItemForKey(theDefault: String, key: String, moduleName: String) throws -> Variant_NullType_String? {
-        let result = ConnectConfigStore.string(forKey: key, default: theDefault, moduleName: moduleName)
+        let result = ConnectConfigStore.string(forKey: key, default: theDefault)
         return result.map { .second($0) }
     }
     
@@ -237,7 +266,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     ///   - moduleName: The name of the module to be updated. For EOCore settings, please use 'EOCore' which can be found the following files EOCoreBasicConfig.plist, EOCoreBasicConfig.properties or EOCoreAdvancedConfig.json and 'Connect' for Connect which can be found the following files ConnectBasicConfig.plist, ConnectBasicConfig.properties or ConnectAdvancedConfig.json.
     /// - Returns: The value of the configuration item key as a NSNumber value.
     func getNumberItemForKey(theDefault: Double, key: String, moduleName: String) throws -> Double {
-        return ConnectConfigStore.number(forKey: key, default: theDefault, moduleName: moduleName)
+        return ConnectConfigStore.number(forKey: key, default: theDefault)
     }
     
     /// Log custom event.

package/lib/commonjs/components/Connect.js

@@ -25,10 +25,19 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 const Connect = ({
   children,
   captureKeyboardEvents,
-  captureDialogEvents = false
+  captureDialogEvents = false,
+  navigationRef
 }) => {
   const child = children;
-  const navigation = child.props?.ref ?? child.ref;
+  const childProvidedRef = child?.props?.ref ?? child?.ref;
+  const internalRef = (0, _react.useRef)(null);
+
+  // Resolution order (explicit → legacy child ref → auto-injected fallback).
+  // The chosen ref flows through the same mount-effect / touch / layout
+  // guards, so any path that fails to resolve a usable navigation container
+  // simply disables tracking rather than breaking host-app gestures.
+  const navigation = navigationRef ?? childProvidedRef ?? internalRef;
+  const shouldInjectRef = !navigationRef && !childProvidedRef && /*#__PURE__*/_react.default.isValidElement(child);
   const currentRoute = (0, _react.useRef)(undefined);
   const initial = (0, _react.useRef)(false);
   (0, _react.useEffect)(() => {
@@ -38,8 +47,8 @@ const Connect = ({
     _TLTRN.default.interceptDialogEvents(captureDialogEvents);
   }, [captureDialogEvents]);
   (0, _react.useEffect)(() => {
-    if (!navigation || typeof navigation.current.addListener !== "function" || typeof navigation.current.getCurrentRoute !== "function") {
-      console.warn("Connect: The Connect component's first child must be a NavigationContainer with a ref.");
+    if (!navigation || !navigation.current || typeof navigation.current.addListener !== "function" || typeof navigation.current.getCurrentRoute !== "function") {
+      console.warn("Connect: navigation tracking disabled — no usable NavigationContainer ref resolved. " + "Pass `navigationRef` (from useNavigationContainerRef()) or ensure the direct child is a NavigationContainer.");
       return;
     }
 
@@ -61,24 +70,27 @@ const Connect = ({
     };
   }, [navigation]);
   const onStartShouldSetResponderCapture = (0, _react.useCallback)(event => {
-    currentRoute.current = extractName(navigation) || navigation.current.getCurrentRoute()?.name;
-    if (currentRoute && currentRoute.current) {
-      _TLTRN.default.logScreenViewPageName(currentRoute.current);
+    if (navigation?.current?.getCurrentRoute) {
+      currentRoute.current = extractName(navigation) || navigation.current.getCurrentRoute()?.name;
+      if (currentRoute.current) {
+        _TLTRN.default.logScreenViewPageName(currentRoute.current);
+      }
     }
     _TLTRN.default.logClickEvent(event);
-    return false; // Must be false; true means this component becomes the touch responder and events don't bubble
-  }, []);
-  const onLayout = (0, _react.useCallback)(event => {
+    return false; // Must remain false so events bubble to the host app's handlers
+  }, [navigation]);
+  const onLayout = (0, _react.useCallback)(_event => {
     if (initial.current) {
       return false;
     }
     initial.current = true;
-    console.log("event - ", event.nativeEvent);
-    currentRoute.current = navigation.current.getCurrentRoute()?.name;
-    if (_reactNative.Platform.OS === "ios" && currentRoute && currentRoute.current) {
-      _TLTRN.default.logScreenViewPageName(currentRoute.current);
-    } else if (_reactNative.Platform.OS === "android") {
-      _TLTRN.default.logScreenLayout(currentRoute.current);
+    if (navigation?.current?.getCurrentRoute) {
+      currentRoute.current = navigation.current.getCurrentRoute()?.name;
+      if (_reactNative.Platform.OS === "ios" && currentRoute.current) {
+        _TLTRN.default.logScreenViewPageName(currentRoute.current);
+      } else if (_reactNative.Platform.OS === "android") {
+        _TLTRN.default.logScreenLayout(currentRoute.current);
+      }
     }
     return true;
   }, [navigation]);
@@ -86,11 +98,13 @@ const Connect = ({
     style: styles.connect_main,
     onLayout: onLayout,
     onStartShouldSetResponderCapture: onStartShouldSetResponderCapture,
-    children: children
+    children: shouldInjectRef ? /*#__PURE__*/_react.default.cloneElement(child, {
+      ref: internalRef
+    }) : children
   });
 };
 function extractName(navigation) {
-  const routeParams = navigation.current.getCurrentRoute()?.params;
+  const routeParams = navigation?.current?.getCurrentRoute?.()?.params;
   if (routeParams) {
     const {
       name

package/lib/commonjs/components/Connect.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_TLTRN","_interopRequireDefault","_jsxRuntime","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","Connect","children","captureKeyboardEvents","captureDialogEvents","child","navigation","props","ref","currentRoute","useRef","undefined","initial","useEffect","TLTRN","interceptKeyboardEvents","interceptDialogEvents","current","addListener","getCurrentRoute","console","warn","unsubscribeState","extractName","name","log","Platform","OS","logScreenViewPageName","logScreenLayout","onStartShouldSetResponderCapture","useCallback","event","logClickEvent","onLayout","nativeEvent","jsx","View","style","styles","connect_main","routeParams","params","_default","exports","StyleSheet","create","flex"],"sourceRoot":"../../../src","sources":["components/Connect.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_TLTRN","_interopRequireDefault","_jsxRuntime","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","Connect","children","captureKeyboardEvents","captureDialogEvents","navigationRef","child","childProvidedRef","props","ref","internalRef","useRef","navigation","shouldInjectRef","React","isValidElement","currentRoute","undefined","initial","useEffect","TLTRN","interceptKeyboardEvents","interceptDialogEvents","current","addListener","getCurrentRoute","console","warn","unsubscribeState","extractName","name","log","Platform","OS","logScreenViewPageName","logScreenLayout","onStartShouldSetResponderCapture","useCallback","event","logClickEvent","onLayout","_event","jsx","View","style","styles","connect_main","cloneElement","routeParams","params","_default","exports","StyleSheet","create","flex"],"sourceRoot":"../../../src","sources":["components/Connect.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/Connect.js

@@ -17,10 +17,19 @@ import { jsx as _jsx } from "react/jsx-runtime";
 const Connect = ({
   children,
   captureKeyboardEvents,
-  captureDialogEvents = false
+  captureDialogEvents = false,
+  navigationRef
 }) => {
   const child = children;
-  const navigation = child.props?.ref ?? child.ref;
+  const childProvidedRef = child?.props?.ref ?? child?.ref;
+  const internalRef = useRef(null);
+
+  // Resolution order (explicit → legacy child ref → auto-injected fallback).
+  // The chosen ref flows through the same mount-effect / touch / layout
+  // guards, so any path that fails to resolve a usable navigation container
+  // simply disables tracking rather than breaking host-app gestures.
+  const navigation = navigationRef ?? childProvidedRef ?? internalRef;
+  const shouldInjectRef = !navigationRef && !childProvidedRef && /*#__PURE__*/React.isValidElement(child);
   const currentRoute = useRef(undefined);
   const initial = useRef(false);
   useEffect(() => {
@@ -30,8 +39,8 @@ const Connect = ({
     TLTRN.interceptDialogEvents(captureDialogEvents);
   }, [captureDialogEvents]);
   useEffect(() => {
-    if (!navigation || typeof navigation.current.addListener !== "function" || typeof navigation.current.getCurrentRoute !== "function") {
-      console.warn("Connect: The Connect component's first child must be a NavigationContainer with a ref.");
+    if (!navigation || !navigation.current || typeof navigation.current.addListener !== "function" || typeof navigation.current.getCurrentRoute !== "function") {
+      console.warn("Connect: navigation tracking disabled — no usable NavigationContainer ref resolved. " + "Pass `navigationRef` (from useNavigationContainerRef()) or ensure the direct child is a NavigationContainer.");
       return;
     }
 
@@ -53,24 +62,27 @@ const Connect = ({
     };
   }, [navigation]);
   const onStartShouldSetResponderCapture = useCallback(event => {
-    currentRoute.current = extractName(navigation) || navigation.current.getCurrentRoute()?.name;
-    if (currentRoute && currentRoute.current) {
-      TLTRN.logScreenViewPageName(currentRoute.current);
+    if (navigation?.current?.getCurrentRoute) {
+      currentRoute.current = extractName(navigation) || navigation.current.getCurrentRoute()?.name;
+      if (currentRoute.current) {
+        TLTRN.logScreenViewPageName(currentRoute.current);
+      }
     }
     TLTRN.logClickEvent(event);
-    return false; // Must be false; true means this component becomes the touch responder and events don't bubble
-  }, []);
-  const onLayout = useCallback(event => {
+    return false; // Must remain false so events bubble to the host app's handlers
+  }, [navigation]);
+  const onLayout = useCallback(_event => {
     if (initial.current) {
       return false;
     }
     initial.current = true;
-    console.log("event - ", event.nativeEvent);
-    currentRoute.current = navigation.current.getCurrentRoute()?.name;
-    if (Platform.OS === "ios" && currentRoute && currentRoute.current) {
-      TLTRN.logScreenViewPageName(currentRoute.current);
-    } else if (Platform.OS === "android") {
-      TLTRN.logScreenLayout(currentRoute.current);
+    if (navigation?.current?.getCurrentRoute) {
+      currentRoute.current = navigation.current.getCurrentRoute()?.name;
+      if (Platform.OS === "ios" && currentRoute.current) {
+        TLTRN.logScreenViewPageName(currentRoute.current);
+      } else if (Platform.OS === "android") {
+        TLTRN.logScreenLayout(currentRoute.current);
+      }
     }
     return true;
   }, [navigation]);
@@ -78,11 +90,13 @@ const Connect = ({
     style: styles.connect_main,
     onLayout: onLayout,
     onStartShouldSetResponderCapture: onStartShouldSetResponderCapture,
-    children: children
+    children: shouldInjectRef ? /*#__PURE__*/React.cloneElement(child, {
+      ref: internalRef
+    }) : children
   });
 };
 function extractName(navigation) {
-  const routeParams = navigation.current.getCurrentRoute()?.params;
+  const routeParams = navigation?.current?.getCurrentRoute?.()?.params;
   if (routeParams) {
     const {
       name

package/lib/module/components/Connect.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useCallback","useEffect","useRef","View","StyleSheet","Platform","TLTRN","jsx","_jsx","Connect","children","captureKeyboardEvents","captureDialogEvents","child","navigation","props","ref","currentRoute","undefined","initial","interceptKeyboardEvents","interceptDialogEvents","current","addListener","getCurrentRoute","console","warn","unsubscribeState","extractName","name","log","OS","logScreenViewPageName","logScreenLayout","onStartShouldSetResponderCapture","event","logClickEvent","onLayout","nativeEvent","style","styles","connect_main","routeParams","params","create","flex"],"sourceRoot":"../../../src","sources":["components/Connect.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useCallback","useEffect","useRef","View","StyleSheet","Platform","TLTRN","jsx","_jsx","Connect","children","captureKeyboardEvents","captureDialogEvents","navigationRef","child","childProvidedRef","props","ref","internalRef","navigation","shouldInjectRef","isValidElement","currentRoute","undefined","initial","interceptKeyboardEvents","interceptDialogEvents","current","addListener","getCurrentRoute","console","warn","unsubscribeState","extractName","name","log","OS","logScreenViewPageName","logScreenLayout","onStartShouldSetResponderCapture","event","logClickEvent","onLayout","_event","style","styles","connect_main","cloneElement","routeParams","params","create","flex"],"sourceRoot":"../../../src","sources":["components/Connect.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -12,6 +12,18 @@ interface ConnectProps {
     children: React.ReactNode;
     captureKeyboardEvents: boolean;
     captureDialogEvents?: boolean;
+    /**
+     * Preferred: an explicit NavigationContainer ref obtained from
+     * `useNavigationContainerRef()`. Using this prop decouples <Connect> from
+     * any assumption about the children structure and is the recommended
+     * integration path.
+     *
+     * If omitted, <Connect> falls back to (a) inspecting the direct child's
+     * own ref, then (b) auto-injecting an internal ref via cloneElement.
+     * Every path degrades gracefully — if no usable ref is resolved,
+     * screen-name tracking is disabled but touches still reach host components.
+     */
+    navigationRef?: React.RefObject<any>;
 }
 declare const Connect: React.FC<ConnectProps>;
 export default Connect;

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,KAAqD,MAAM,OAAO,CAAC;AAK1E,UAAU,YAAY;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAgFnC,CAAC;AAWF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Connect.d.ts","sourceRoot":"","sources":["../../../../src/components/Connect.tsx"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAC7F,OAAO,KAAyC,MAAM,OAAO,CAAC;AAK9D,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,CAsGnC,CAAC;AAWF,eAAe,OAAO,CAAC"}

package/package.json

@@ -66,7 +66,7 @@
         "ios/**/*.mm",
         "ios/**/*.cpp",
         "ios/**/*.swift",
-        "ios/ConnectConfig/Build_Config.rb",
+        "ios/AcousticConnectRNConfig.json",
         "app.plugin.js",
         "*.podspec",
         "README.md",
@@ -192,7 +192,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.20",
+    "version": "18.0.22",
     "workspaces": [
         "example"
     ]

package/scripts/ConnectConfig.json

@@ -1,6 +1,6 @@
 {
     "Connect": {
-        "AndroidVersion": "11.0.8-beta",
+        "AndroidVersion": "11.0.9-beta",
         "AppKey": "b6c3709b7a4c479bb4b5a9fb8fec324c",
         "KillSwitchUrl": "https://lib-us-2.brilliantcollector.com/collector/switch/b6c3709b7a4c479bb4b5a9fb8fec324c",
         "PostMessageUrl": "https://lib-us-2.brilliantcollector.com/collector/collectorPost",

package/src/components/Connect.tsx

@@ -7,8 +7,8 @@
 * Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
 * prohibited.
 ********************************************************************************************/
-import React, { useCallback, useEffect, useRef, forwardRef } from "react";
-import { View, StyleSheet, Platform, NativeModules, findNodeHandle } from "react-native";
+import React, { useCallback, useEffect, useRef } from "react";
+import { View, StyleSheet, Platform } from "react-native";
 import type { LayoutChangeEvent } from "react-native"; // Use type-only import for LayoutChangeEvent
 import TLTRN from '../TLTRN';
 
@@ -16,11 +16,38 @@ interface ConnectProps {
     children: React.ReactNode;
     captureKeyboardEvents: boolean;
     captureDialogEvents?: boolean; // New prop for dialog event capture
+    /**
+     * Preferred: an explicit NavigationContainer ref obtained from
+     * `useNavigationContainerRef()`. Using this prop decouples <Connect> from
+     * any assumption about the children structure and is the recommended
+     * integration path.
+     *
+     * If omitted, <Connect> falls back to (a) inspecting the direct child's
+     * own ref, then (b) auto-injecting an internal ref via cloneElement.
+     * Every path degrades gracefully — if no usable ref is resolved,
+     * screen-name tracking is disabled but touches still reach host components.
+     */
+    navigationRef?: React.RefObject<any>;
 }
 
-const Connect: React.FC<ConnectProps> = ({ children, captureKeyboardEvents, captureDialogEvents = false }) => {
+const Connect: React.FC<ConnectProps> = ({
+    children,
+    captureKeyboardEvents,
+    captureDialogEvents = false,
+    navigationRef,
+}) => {
     const child = children as any;
-    const navigation = child.props?.ref ?? child.ref;
+    const childProvidedRef = child?.props?.ref ?? child?.ref;
+    const internalRef = useRef<any>(null);
+
+    // Resolution order (explicit → legacy child ref → auto-injected fallback).
+    // The chosen ref flows through the same mount-effect / touch / layout
+    // guards, so any path that fails to resolve a usable navigation container
+    // simply disables tracking rather than breaking host-app gestures.
+    const navigation = navigationRef ?? childProvidedRef ?? internalRef;
+    const shouldInjectRef =
+        !navigationRef && !childProvidedRef && React.isValidElement(child);
+
     const currentRoute = useRef<string | undefined>(undefined);
     const initial = useRef<boolean>(false);
 
@@ -35,11 +62,13 @@ const Connect: React.FC<ConnectProps> = ({ children, captureKeyboardEvents, capt
     useEffect(() => {
         if (
             !navigation ||
+            !navigation.current ||
             typeof navigation.current.addListener !== "function" ||
             typeof navigation.current.getCurrentRoute !== "function"
         ) {
             console.warn(
-                "Connect: The Connect component's first child must be a NavigationContainer with a ref."
+                "Connect: navigation tracking disabled — no usable NavigationContainer ref resolved. " +
+                "Pass `navigationRef` (from useNavigationContainerRef()) or ensure the direct child is a NavigationContainer."
             );
             return;
         }
@@ -64,29 +93,32 @@ const Connect: React.FC<ConnectProps> = ({ children, captureKeyboardEvents, capt
     }, [navigation]);
 
     const onStartShouldSetResponderCapture = useCallback((event: any) => {
-        currentRoute.current = extractName(navigation) || navigation.current.getCurrentRoute()?.name;
-        if (currentRoute && currentRoute.current) {
-            TLTRN.logScreenViewPageName(currentRoute.current);
+        if (navigation?.current?.getCurrentRoute) {
+            currentRoute.current =
+                extractName(navigation) || navigation.current.getCurrentRoute()?.name;
+            if (currentRoute.current) {
+                TLTRN.logScreenViewPageName(currentRoute.current);
+            }
         }
         TLTRN.logClickEvent(event);
-        return false; // Must be false; true means this component becomes the touch responder and events don't bubble
-    }, []);
+        return false; // Must remain false so events bubble to the host app's handlers
+    }, [navigation]);
 
-    const onLayout = useCallback((event: LayoutChangeEvent) => {
+    const onLayout = useCallback((_event: LayoutChangeEvent) => {
         if (initial.current) {
             return false;
         }
         initial.current = true;
 
-        console.log("event - ", event.nativeEvent);
-
-        currentRoute.current = navigation.current.getCurrentRoute()?.name;
-        if (Platform.OS === "ios" && currentRoute && currentRoute.current) {
-            TLTRN.logScreenViewPageName(currentRoute.current);
-        } else if (Platform.OS === "android") {
-            TLTRN.logScreenLayout(currentRoute.current);
+        if (navigation?.current?.getCurrentRoute) {
+            currentRoute.current = navigation.current.getCurrentRoute()?.name;
+            if (Platform.OS === "ios" && currentRoute.current) {
+                TLTRN.logScreenViewPageName(currentRoute.current);
+            } else if (Platform.OS === "android") {
+                TLTRN.logScreenLayout(currentRoute.current);
+            }
         }
-        return true
+        return true;
     }, [navigation]);
 
     return (
@@ -95,13 +127,15 @@ const Connect: React.FC<ConnectProps> = ({ children, captureKeyboardEvents, capt
             onLayout={onLayout}
             onStartShouldSetResponderCapture={onStartShouldSetResponderCapture}
         >
-            {children}
+            {shouldInjectRef
+                ? React.cloneElement(child as React.ReactElement<any>, { ref: internalRef })
+                : children}
         </View>
     );
 };
 
 function extractName(navigation: any): string {
-    const routeParams = navigation.current.getCurrentRoute()?.params;
+    const routeParams = navigation?.current?.getCurrentRoute?.()?.params;
     if (routeParams) {
         const { name } = routeParams;
         return name ? name : navigation.current?.getCurrentRoute()?.name || "";

package/ios/ConnectConfig/Build_Config.rb

@@ -1,59 +0,0 @@
-#!/usr/bin/env ruby
-require 'json'
-
-#--------------------------------------------------------------------------------------------
-# Copyright (C) 2025 Acoustic, L.P. All rights reserved.
-#
-# NOTICE: This file contains material that is confidential and proprietary to
-# Acoustic, L.P. and/or other developers. No license is granted under any intellectual or
-# industrial property rights of Acoustic, L.P. except as may be provided in an agreement with
-# Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
-# prohibited.
-#--------------------------------------------------------------------------------------------
-  
-pods_root   = ARGV[0]
-config_file = ARGV[1]
-lib_root    = ARGV[2]
-
-begin 
-    puts "*********Build_Config.rb*********"
-    puts "Pods root:#{pods_root}"
-    puts "Config file:#{config_file}"
-    puts "Lib root:#{lib_root}"
-    puts "**********************************"
-    config_path = "#{pods_root}/../../#{config_file}"
-    if !File.exist?(config_path)
-        config_path = "#{pods_root}/../#{config_file}"
-        lib_root = "#{pods_root}/../#{lib_root}"
-    end
-
-    if File.exist?(config_path)
-        puts "Read from ConnectConfig.json at:#{config_path}"
-        json = JSON.parse(File.read(config_path))
-        puts JSON.pretty_generate(json)
-    else
-        puts "ConnectConfig.json does not exist at:#{config_path}"
-        exit
-    end
-
-    libConfigPath = "#{lib_root}/ios/ConnectConfig.json"
-    if File.exist?(libConfigPath)
-        puts "Read from ConnectConfig.json at:#{libConfigPath}"
-        libConfig = File.read(libConfigPath)
-        puts libConfig
-
-        File.open(libConfigPath, 'w') do |f|
-          f.write(JSON.pretty_generate(json))
-        end
-
-        libConfig = File.read(libConfigPath)
-        puts "Update #{libConfigPath} to"
-        puts "#{libConfig}"
-    else
-        puts "ConnectConfig.json does not exist at:#{libConfigPath}"
-        exit
-    end
-
-    rescue Errno::ENOENT
-        exit
-end