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

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

@@ -8,6 +8,68 @@ export interface AcousticConnectRN extends HybridObject<{
     ios: 'swift';
     android: 'kotlin';
 }> {
+    /**
+     * Re-enables the Connect SDK after a prior {@link disable} call.
+     *
+     * The SDK auto-initialises at module load time using the values from
+     * `ConnectConfig.json` at the consumer's project root — so for most apps
+     * there is no need to call `enable()` at all. The method exists as the
+     * pair of {@link disable}: if a consent flow, A/B-test gate, or opt-out
+     * toggle previously called `disable()`, calling `enable()` brings the
+     * SDK back up using the same bundled configuration.
+     *
+     * @returns `true` when the call was accepted and dispatched to the native
+     *   SDK. `false` only when the platform cannot satisfy a precondition
+     *   (e.g. Android without an `Application` context yet).
+     *
+     * @remarks
+     * **Single source of truth.** All configuration (AppKey, PostMessageUrl,
+     * push, platform extras) lives in `ConnectConfig.json` at the consumer's
+     * project root. The podspec (iOS) and `config.gradle` (Android) bake
+     * those values into the bundled config that the native bridge reads at
+     * init time. There is no runtime override path — by design, to eliminate
+     * the inconsistency surface that runtime arguments would create against
+     * the bundled config.
+     *
+     * **Idempotency.** Owned by the native SDK. iOS
+     * `ConnectSDK.shared.enable(with:)` short-circuits via
+     * `guard !isEnabled else { return }` in its internal `enableCore`; the
+     * Android `Connect.init` / `Connect.enable` pair behaves the same way
+     * once the SDK is running.
+     *
+     * **Threading.** Returns synchronously; the native SDK call is
+     * fire-and-forget on the main thread / actor.
+     *
+     * @example User opt-in after a prior opt-out
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * function onUserOptIn() {
+     *   AcousticConnectRN.enable()
+     * }
+     * ```
+     */
+    enable(): boolean;
+    /**
+     * Disables the Connect SDK and stops all data capture.
+     *
+     * After this call the SDK flushes pending data to the backend, stops
+     * listening for events, and releases push state. Call {@link enable}
+     * to bring the SDK back up using the same bundled configuration.
+     *
+     * @returns `true` when the call was accepted and dispatched. Idempotent —
+     *   calling `disable()` on an already-disabled SDK is safe.
+     *
+     * @example User opt-out flow
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * function onUserOptOut() {
+     *   AcousticConnectRN.disable()
+     * }
+     * ```
+     */
+    disable(): boolean;
     setBooleanConfigItemForKey(key: string, value: boolean, moduleName: string): boolean;
     setStringItemForKey(key: string, value: string, moduleName: string): boolean;
     setNumberItemForKey(key: string, value: number, moduleName: string): 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/nitrogen/generated/android/c++/JHybridAcousticConnectRNSpec.cpp

@@ -51,6 +51,16 @@ namespace margelo::nitro::acousticconnectrn {
   
 
   // Methods
+  bool JHybridAcousticConnectRNSpec::enable() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean()>("enable");
+    auto __result = method(_javaPart);
+    return static_cast<bool>(__result);
+  }
+  bool JHybridAcousticConnectRNSpec::disable() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean()>("disable");
+    auto __result = method(_javaPart);
+    return static_cast<bool>(__result);
+  }
   bool JHybridAcousticConnectRNSpec::setBooleanConfigItemForKey(const std::string& key, bool value, const std::string& moduleName) {
     static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean(jni::alias_ref<jni::JString> /* key */, jboolean /* value */, jni::alias_ref<jni::JString> /* moduleName */)>("setBooleanConfigItemForKey");
     auto __result = method(_javaPart, jni::make_jstring(key), value, jni::make_jstring(moduleName));

package/nitrogen/generated/android/c++/JHybridAcousticConnectRNSpec.hpp

@@ -54,6 +54,8 @@ namespace margelo::nitro::acousticconnectrn {
 
   public:
     // Methods
+    bool enable() override;
+    bool disable() override;
     bool setBooleanConfigItemForKey(const std::string& key, bool value, const std::string& moduleName) override;
     bool setStringItemForKey(const std::string& key, const std::string& value, const std::string& moduleName) override;
     bool setNumberItemForKey(const std::string& key, double value, const std::string& moduleName) override;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/acousticconnectrn/HybridAcousticConnectRNSpec.kt

@@ -29,6 +29,14 @@ abstract class HybridAcousticConnectRNSpec: HybridObject() {
   
 
   // Methods
+  @DoNotStrip
+  @Keep
+  abstract fun enable(): Boolean
+  
+  @DoNotStrip
+  @Keep
+  abstract fun disable(): Boolean
+  
   @DoNotStrip
   @Keep
   abstract fun setBooleanConfigItemForKey(key: String, value: Boolean, moduleName: String): Boolean

package/nitrogen/generated/ios/c++/HybridAcousticConnectRNSpecSwift.hpp

@@ -70,6 +70,22 @@ namespace margelo::nitro::acousticconnectrn {
 
   public:
     // Methods
+    inline bool enable() override {
+      auto __result = _swiftPart.enable();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+    inline bool disable() override {
+      auto __result = _swiftPart.disable();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline bool setBooleanConfigItemForKey(const std::string& key, bool value, const std::string& moduleName) override {
       auto __result = _swiftPart.setBooleanConfigItemForKey(key, std::forward<decltype(value)>(value), moduleName);
       if (__result.hasError()) [[unlikely]] {

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

@@ -13,6 +13,8 @@ public protocol HybridAcousticConnectRNSpec_protocol: HybridObject {
   
 
   // Methods
+  func enable() throws -> Bool
+  func disable() throws -> Bool
   func setBooleanConfigItemForKey(key: String, value: Bool, moduleName: String) throws -> Bool
   func setStringItemForKey(key: String, value: String, moduleName: String) throws -> Bool
   func setNumberItemForKey(key: String, value: Double, moduleName: String) throws -> Bool

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

@@ -124,6 +124,30 @@ open class HybridAcousticConnectRNSpec_cxx {
   
 
   // Methods
+  @inline(__always)
+  public final func enable() -> bridge.Result_bool_ {
+    do {
+      let __result = try self.__implementation.enable()
+      let __resultCpp = __result
+      return bridge.create_Result_bool_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_bool_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func disable() -> bridge.Result_bool_ {
+    do {
+      let __result = try self.__implementation.disable()
+      let __resultCpp = __result
+      return bridge.create_Result_bool_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_bool_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func setBooleanConfigItemForKey(key: std.string, value: Bool, moduleName: std.string) -> bridge.Result_bool_ {
     do {

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

@@ -14,6 +14,8 @@ namespace margelo::nitro::acousticconnectrn {
     HybridObject::loadHybridMethods();
     // load custom methods/properties
     registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("enable", &HybridAcousticConnectRNSpec::enable);
+      prototype.registerHybridMethod("disable", &HybridAcousticConnectRNSpec::disable);
       prototype.registerHybridMethod("setBooleanConfigItemForKey", &HybridAcousticConnectRNSpec::setBooleanConfigItemForKey);
       prototype.registerHybridMethod("setStringItemForKey", &HybridAcousticConnectRNSpec::setStringItemForKey);
       prototype.registerHybridMethod("setNumberItemForKey", &HybridAcousticConnectRNSpec::setNumberItemForKey);

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

@@ -52,6 +52,8 @@ namespace margelo::nitro::acousticconnectrn {
 
     public:
       // Methods
+      virtual bool enable() = 0;
+      virtual bool disable() = 0;
       virtual bool setBooleanConfigItemForKey(const std::string& key, bool value, const std::string& moduleName) = 0;
       virtual bool setStringItemForKey(const std::string& key, const std::string& value, const std::string& moduleName) = 0;
       virtual bool setNumberItemForKey(const std::string& key, double value, const std::string& moduleName) = 0;

package/package.json

@@ -23,6 +23,9 @@
         "release-it": "^19.0.2",
         "typescript": "5.0.4"
     },
+    "engines": {
+        "node": ">=20.0.0"
+    },
     "eslintConfig": {
         "extends": [
             "@react-native",
@@ -94,9 +97,9 @@
     "module": "./lib/module/index.js",
     "name": "react-native-acoustic-connect-beta",
     "peerDependencies": {
-        "react": "*",
-        "react-native": "*",
-        "react-native-nitro-modules": ">=0.35.0 <0.36.0"
+        "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"
     },
     "prettier": {
         "quoteProps": "consistent",
@@ -192,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.22",
+    "version": "18.0.24",
     "workspaces": [
         "example"
     ]

package/scripts/ConnectConfig.json

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

package/src/TLTRN.ts

@@ -105,27 +105,34 @@ class TLTRN {
     return result;
   };
 
-  static logClickEvent = async (event: any) => {    
+  static logClickEvent = async (event: any) => {
     let result = false
 
-    if(!event.target || !event.target._nativeTag || typeof event.target._nativeTag === 'undefined'){ return result; }
-
-    const events = event._dispatchInstances.filter((node: any) => {
-      return node.memoizedProps && node.memoizedProps.id;
-    });
-    const id = (events.length) ? events[0].memoizedProps.id : '';
+    // Fabric exposes the host tag as `__nativeTag` (double underscore).
+    // Paper used `_nativeTag` (single). Read both for safety.
+    const target = event?.target?.__nativeTag ?? event?.target?._nativeTag;
+    if (target == null) {
+      return result;
+    }
 
-    let target = event.target._nativeTag;
-    let controlId = event._targetInst.memoizedProps.id !== undefined ? event._targetInst.memoizedProps.id : id;
-    let ariaLabel = event._targetInst.memoizedProps.accessible !== undefined ? event._targetInst.memoizedProps.accessibilityLabel : '';
+    // controlId comes from the touched view's `id` prop. Fiber internals can
+    // vary across React versions, so guard each access.
+    let controlId = '';
+    try {
+      const fiberId = event?._targetInst?.memoizedProps?.id;
+      if (typeof fiberId === 'string' && fiberId.length > 0) {
+        controlId = fiberId;
+      } else if (Array.isArray(event?._dispatchInstances)) {
+        const found = event._dispatchInstances.find(
+          (node: any) => node?.memoizedProps?.id
+        );
+        if (found) controlId = found.memoizedProps.id;
+      }
+    } catch {}
 
     try {
-        if (Platform.OS === 'ios') {
-          result = AcousticConnectRN.logClickEvent(target, controlId);
-        } else if (Platform.OS === 'android') {
-          result = AcousticConnectRN.logClickEvent(target, controlId);
-        }
-    } catch(error: Error | any){
+      result = AcousticConnectRN.logClickEvent(target, controlId);
+    } catch (error: Error | any) {
       console.log('LogClickEvent error: ', error.message);
     }
     return result;

package/src/components/Connect.tsx

@@ -37,6 +37,9 @@ 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`.
+    // 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;
     const internalRef = useRef<any>(null);
 

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

@@ -21,6 +21,69 @@ export type KeyValueObject = {
 export type ConnectMonitoringLevelType = 'Ignore' | 'CellularAndWiFi' | 'WiFi'
 
 export interface AcousticConnectRN extends HybridObject<{ ios: 'swift', android: 'kotlin' }> {
+    /**
+     * Re-enables the Connect SDK after a prior {@link disable} call.
+     *
+     * The SDK auto-initialises at module load time using the values from
+     * `ConnectConfig.json` at the consumer's project root — so for most apps
+     * there is no need to call `enable()` at all. The method exists as the
+     * pair of {@link disable}: if a consent flow, A/B-test gate, or opt-out
+     * toggle previously called `disable()`, calling `enable()` brings the
+     * SDK back up using the same bundled configuration.
+     *
+     * @returns `true` when the call was accepted and dispatched to the native
+     *   SDK. `false` only when the platform cannot satisfy a precondition
+     *   (e.g. Android without an `Application` context yet).
+     *
+     * @remarks
+     * **Single source of truth.** All configuration (AppKey, PostMessageUrl,
+     * push, platform extras) lives in `ConnectConfig.json` at the consumer's
+     * project root. The podspec (iOS) and `config.gradle` (Android) bake
+     * those values into the bundled config that the native bridge reads at
+     * init time. There is no runtime override path — by design, to eliminate
+     * the inconsistency surface that runtime arguments would create against
+     * the bundled config.
+     *
+     * **Idempotency.** Owned by the native SDK. iOS
+     * `ConnectSDK.shared.enable(with:)` short-circuits via
+     * `guard !isEnabled else { return }` in its internal `enableCore`; the
+     * Android `Connect.init` / `Connect.enable` pair behaves the same way
+     * once the SDK is running.
+     *
+     * **Threading.** Returns synchronously; the native SDK call is
+     * fire-and-forget on the main thread / actor.
+     *
+     * @example User opt-in after a prior opt-out
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * function onUserOptIn() {
+     *   AcousticConnectRN.enable()
+     * }
+     * ```
+     */
+    enable(): boolean
+
+    /**
+     * Disables the Connect SDK and stops all data capture.
+     *
+     * After this call the SDK flushes pending data to the backend, stops
+     * listening for events, and releases push state. Call {@link enable}
+     * to bring the SDK back up using the same bundled configuration.
+     *
+     * @returns `true` when the call was accepted and dispatched. Idempotent —
+     *   calling `disable()` on an already-disabled SDK is safe.
+     *
+     * @example User opt-out flow
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * function onUserOptOut() {
+     *   AcousticConnectRN.disable()
+     * }
+     * ```
+     */
+    disable(): boolean
     setBooleanConfigItemForKey(key: string, value: boolean, moduleName: string): boolean
     setStringItemForKey(key: string, value: string, moduleName: string): boolean
     setNumberItemForKey(key: string, value: number, moduleName: string): boolean