react-native-acoustic-connect 16.0.39 → 19.0.3

package/android/build.gradle

@@ -1,49 +1,235 @@
-apply plugin: 'com.android.library'
-apply plugin: "com.facebook.react"
+// Copyright (C) 2024 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.
+//
+//
+//  Created on 5/9/25.
+//
 
 buildscript {
-    ext.kotlin_version = '1.7.21'
+  repositories {
+    google()
+    mavenCentral()
+  }
 
-    repositories {
-        google()
-        mavenCentral()
-    }
-    dependencies {
-        classpath 'com.android.tools.build:gradle:7.2.2'
-    }
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.10.0"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+apply plugin: 'org.jetbrains.kotlin.android'
+apply from: '../nitrogen/generated/android/AcousticConnectRN+autolinking.gradle'
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["AcousticConnectRN_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["AcousticConnectRN_" + name]).toInteger()
 }
 
 android {
-    compileSdk 34
-
-    defaultConfig {
-        minSdk 21
-        targetSdk 34
-        versionCode 1
-        // get version name from package.json version
-        versionName "1.0"
+  namespace = "com.acousticconnectrn"
+
+  ndkVersion = getExtOrDefault("ndkVersion")
+  compileSdkVersion = getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -Wextra -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
     }
-    lintOptions {
-        abortOnError false
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+        "META-INF",
+        "META-INF/**",
+        "**/libc++_shared.so",
+        "**/libfbjni.so",
+        "**/libjsi.so",
+        "**/libfolly_json.so",
+        "**/libfolly_runtime.so",
+        "**/libglog.so",
+        "**/libhermes.so",
+        "**/libhermes-executor-debug.so",
+        "**/libhermes_executor.so",
+        "**/libreactnative.so",
+        "**/libreactnativejni.so",
+        "**/libturbomodulejsijni.so",
+        "**/libreact_nativemodule_core.so",
+        "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig = true
+    prefab = true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
     }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      if (isNewArchitectureEnabled()) {
+        java.srcDirs += [
+          // React Codegen files
+          "${project.buildDir}/generated/source/codegen/java"
+        ]
+      }
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
 }
 
 allprojects {
     repositories {
         google()
         mavenCentral()
-        maven { url "https://s01.oss.sonatype.org/content/groups/staging" }
-        
+        maven { url="https://s01.oss.sonatype.org/content/groups/staging" }
+
         maven {
             // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
-            url "$rootDir/../node_modules/react-native/android"
+            url="$rootDir/../node_modules/react-native/android"
         }
     }
 }
 
+// Read consumer config at script-evaluation time so the right Connect Android
+// artifact is selected without depending on config.gradle's text-rewriting
+// pass (which only matches the analytics artifact name). Both `PushEnabled`
+// and `AndroidVersion` are read directly here:
+//   - `PushEnabled` picks between the analytics-only and push-fcm artifacts.
+//   - `AndroidVersion` (when set) pins the version against the active artifact.
+import groovy.json.JsonSlurper
+def acousticConfigFile = new File("$rootDir/../ConnectConfig.json")
+def acousticConfig = acousticConfigFile.exists()
+  ? new JsonSlurper().parse(acousticConfigFile)
+  : [Connect: [:]]
+def acousticPushEnabled = (acousticConfig.Connect?.PushEnabled ?: false).toString().toBoolean()
+def acousticVersionPin = (acousticConfig.Connect?.AndroidVersion ?: '').trim()
+def acousticVersion = acousticVersionPin.isEmpty() ? '+' : acousticVersionPin
+def acousticArtifact = acousticPushEnabled ? 'connect-push-fcm' : 'connect'
+println "AcousticConnectRN: PushEnabled=$acousticPushEnabled, artifact=io.github.go-acoustic:$acousticArtifact:$acousticVersion"
+
 dependencies {
-    implementation 'com.facebook.react:react-native:+'
+  // Provided by the host app at runtime — compileOnly avoids version conflicts
+  //noinspection GradleDynamicVersion
+  compileOnly "com.facebook.react:react-native:+"
+
+  // Provided by the host app via react-native-nitro-modules peer dependency
+  compileOnly project(":react-native-nitro-modules")
+
+  // Connect Android SDK — analytics-only artifact OR push variant, never both.
+  // The push-fcm artifact transitively brings in the core analytics module;
+  // declaring both as direct dependencies would risk duplicate-class errors
+  // and ambiguous version resolution. The selection is structural and gated
+  // at build time by `ConnectConfig.json -> Connect.PushEnabled` — a customer
+  // who didn't opt in for push can't accidentally pull in FCM transitives,
+  // and a customer who did opt in gets the right module without a second
+  // toggle.
+  //noinspection GradleDynamicVersion
+  implementation "io.github.go-acoustic:$acousticArtifact:$acousticVersion"
+
+  // Firebase Cloud Messaging — required by the push variant. The
+  // `connect-push-fcm` AAR calls `com.google.firebase.messaging.*`
+  // (its `FCMPushService` extends `FirebaseMessagingService`) but its
+  // published POM does NOT declare firebase-messaging, so the transitive
+  // never arrives. Without it the push classes fail to link at runtime and
+  // push silently stays inactive — the bridge logs
+  // `connect-push-fcm on classpath: false` and no FCM token is ever
+  // requested. Gated by the same `PushEnabled` flag so analytics-only
+  // builds pull zero Firebase. The host app still supplies its own
+  // `google-services.json` and applies the `com.google.gms.google-services`
+  // plugin (the bare-workflow demo does this conditionally). The BoM aligns
+  // messaging + its installations/datatransport transitives. See CA-144314.
+  if (acousticPushEnabled) {
+    implementation platform('com.google.firebase:firebase-bom:33.7.0')
+    implementation 'com.google.firebase:firebase-messaging'
+  }
 
-    // Connect SDK libraries
-    api 'io.github.go-acoustic:connect:+'
-}
+  // Version range enforced by the RN bridge. Lower bound prevents downgrades
+  // to releases that lack APIs this bridge calls; upper bound prevents a
+  // future 12.x major (with potentially breaking changes) from being picked
+  // up automatically by Gradle's `+` resolver. Both halves are `strictly` so
+  // an attempted override via `Connect.AndroidVersion` fails loudly at
+  // resolution time rather than surfacing as a runtime `ClassNotFoundException`
+  // or method-missing error. Constraints are declared for both artifact
+  // names — Gradle only enforces the one that resolves into the graph, so
+  // the unused entry is inert.
+  constraints {
+    implementation('io.github.go-acoustic:connect') {
+      version { strictly '[11.0.11, 12.0.0)' }
+      because 'AcousticConnectRN requires Connect Android SDK in [11.0.11, 12.0.0). Bump the upper bound after validating compatibility with a new major.'
+    }
+    implementation('io.github.go-acoustic:connect-push-fcm') {
+      version { strictly '[11.0.11, 12.0.0)' }
+      because 'connect-push-fcm tracks the same release line as the core connect artifact.'
+    }
+  }
+}
+
+if (isNewArchitectureEnabled()) {
+  react {
+    jsRootDir = file("../src/")
+    libraryName = "AcousticConnectRN"
+    codegenJavaPackageName = "com.acousticconnectrn"
+  }
+}

package/android/config.gradle

@@ -1,5 +1,5 @@
 /********************************************************************************************
-* Copyright (C) 2024 Acoustic, L.P. All rights reserved.
+* 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
@@ -85,6 +85,71 @@ def updateTealeafBasicConfig(mp, json) {
     println("Updating:$propertiesFile")
 }
 
+def updateConnectBasicConfig(mp, json) {
+    def propertiesFile = "$mp/src/main/assets/ConnectBasicConfig.properties"
+    FileInputStream _file = new FileInputStream(propertiesFile);
+    Properties properties = new Properties();
+    properties.load(_file);
+    _file.close();
+
+    FileOutputStream out = new FileOutputStream(propertiesFile);
+
+    json.each { key, value ->
+        if(key != "Connect"){ return }
+
+        println("Update/Add the following key/values:")
+        value.each { config_key, config_value ->
+            if(config_value.getClass() != java.lang.String
+            && config_value.getClass() != java.lang.Boolean
+            && config_value.getClass() != java.lang.Integer){
+                return
+            }
+            // Just update the following items
+            if (config_key == "AppKey" ||
+                config_key == "PostMessageUrl" ||
+                config_key == "KillSwitchUrl" ||
+                config_key == "KillSwitchEnabled" ||
+                config_key == "KillSwitchMaxNumberOfTries" ||
+                config_key == "KillSwitchTimeInterval" ||
+                config_key == "UseWhiteList" ||
+                config_key == "WhiteListParam" ||
+                config_key == "UseRandomSample" ||
+                config_key == "RandomSampleParam" ||
+                config_key == "PrintScreen" ||
+                config_key == "Connection" ||
+                config_key == "MaxStringsLength" ||
+                config_key == "CookieUrl" ||
+                config_key == "CookieParam" ||
+                config_key == "CookiePath" ||
+                config_key == "CookieDomain" ||
+                config_key == "CookieExpires" ||
+                config_key == "CookieSecure" ||
+                config_key == "CookieExpiresFormat" ||
+                config_key == "SessionTimeout" ||
+                config_key == "SessionTimeoutKillSwitch" ||
+                config_key == "disableTLTDID" ||
+                config_key == "ScreenshotFormat" ||
+                config_key == "PercentOfScreenshotsSize" ||
+                config_key == "PercentToCompressImage" ||
+                config_key == "ScreenShotPixelDensity" ||
+                config_key == "LogViewLayoutOnScreenTransition" ||
+                config_key == "GetImageDataOnScreenLayout" ||
+                config_key == "SetGestureDetector" ||
+                config_key == "CaptureNativeGesturesOnWebview" ||
+                config_key == "LogLocationEnabled" ||
+                config_key == "LogLocationTries" ||
+                config_key == "LogLocationTimeout" ) {
+                println(config_key + "=" + config_value)
+                properties.setProperty(config_key, config_value.toString())
+            }
+        }
+    }
+
+    properties.store(out, null);
+    out.close();
+    println("Updating:$propertiesFile")
+}
+
 def updateLayoutConfig(mp, json){
     def layoutConfigPath = "$mp/src/main/assets/TealeafLayoutConfig.json"
     def layoutConfigDefaultPath = "$mp/src/main/assets/TealeafLayoutConfigDefault.json"
@@ -257,6 +322,8 @@ def updateGradle(mp, json){
     def updatedBuildGradle = buildGradleFile.text
 
     if (json != null && json.Connect) {
+        def useRelease = json.Connect.useRelease ?: false
+
         if(json.Connect.AndroidVersion != null) {
             def connectSDK = "io.github.go-acoustic:connect:"
             if(json.Connect.AndroidVersion.length() > 0) {
@@ -264,7 +331,22 @@ def updateGradle(mp, json){
             } else {
                 connectSDK += "+"
             }
-            updatedBuildGradle = updatedBuildGradle.replaceAll(~/io.github.go-acoustic:connect:(\+|\d+.\d+.\d+)/, connectSDK)
+            updatedBuildGradle = updatedBuildGradle.replaceAll(~/io.github.go-acoustic:connect:(\+|\d+\.\d+\.\d+(-beta)?)/, connectSDK)
+        }
+
+        if (useRelease) {
+            project.configurations.all {
+                resolutionStrategy {
+                    componentSelection {
+                        all { selection ->
+                            if (selection.candidate.group == 'io.github.go-acoustic' &&
+                                selection.candidate.version.endsWith('-beta')) {
+                                selection.reject("useRelease is true — rejecting beta version ${selection.candidate.version}")
+                            }
+                        }
+                    }
+                }
+            }
         }
     }
 
@@ -273,7 +355,17 @@ def updateGradle(mp, json){
 }
 
 try {
-    def module_path = project(':react-native-acoustic-connect').projectDir.getPath()
+    // Resolve the SDK's android/ directory WITHOUT relying on a Gradle
+    // subproject named ':react-native-acoustic-connect'. RN 0.82 + new
+    // architecture does not guarantee that autolinking registers third-party
+    // libraries as named Gradle subprojects, so `project(':...')` can throw
+    // "Project with path ... could not be found" during sync. Resolving the
+    // package via Node (the same mechanism the injected `apply from:` entry
+    // point uses) works regardless of how/whether the library was autolinked.
+    // See CA-144314.
+    def sdkPackageJson = ["node", "--print", "require.resolve('react-native-acoustic-connect/package.json')"]
+        .execute(null, project.rootDir).text.trim()
+    def module_path = new File(sdkPackageJson).getParentFile().getAbsolutePath() + "/android"
 
     println("**Acoustic Integration***********************************************************************")
     println("Executing $module_path/config.gradle")
@@ -282,14 +374,16 @@ try {
     println("Step 2:")
     updateTealeafBasicConfig(module_path, configJSONData)
     println("Step 3:")
-    updateLayoutConfig(module_path, configJSONData)
+    updateConnectBasicConfig(module_path, configJSONData)
     println("Step 4:")
-    updateTealeafAdvConfig(module_path, configJSONData)
+    updateLayoutConfig(module_path, configJSONData)
     println("Step 5:")
-    updateEOCoreBasicConfig(module_path, configJSONData)
+    updateTealeafAdvConfig(module_path, configJSONData)
     println("Step 6:")
-    updateEOCoreAdvConfig(module_path, configJSONData)
+    updateEOCoreBasicConfig(module_path, configJSONData)
     println("Step 7:")
+    updateEOCoreAdvConfig(module_path, configJSONData)
+    println("Step 8:")
     updateGradle(module_path, configJSONData)
     println("*********************************************************************************************")
 } catch (FileNotFoundException e) {

package/android/gradle.properties

@@ -1,21 +1,5 @@
-# Project-wide Gradle settings.
-
-# IDE (e.g. Android Studio) users:
-# Gradle settings configured through the IDE *will override*
-# any settings specified in this file.
-
-# For more details on how to configure your build environment visit
-# http://www.gradle.org/docs/current/userguide/build_environment.html
-
-# Specifies the JVM arguments used for the daemon process.
-# The setting is particularly useful for tweaking memory settings.
-# Default value: -Xmx10248m -XX:MaxPermSize=256m
-org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
-
-# When configured, Gradle will run in incubating parallel mode.
-# This option should only be used with decoupled projects. More details, visit
-# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
-# org.gradle.parallel=true
-
-android.enableJetifier=true
-android.useAndroidX=true
+AcousticConnectRN_kotlinVersion=2.0.21
+AcousticConnectRN_minSdkVersion=26
+AcousticConnectRN_targetSdkVersion=36
+AcousticConnectRN_compileSdkVersion=36
+AcousticConnectRN_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -1,3 +1,3 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-          package="com.tl.uic.rncxa">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 </manifest>

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

@@ -1,3 +1,42 @@
 {
-    "LibraryVersion": "10.4.20"
+    "AddMessageTypeHeader": false,
+    "ClickEventEnabled": false,
+    "ColorAccent": "#FF4081",
+    "ColorPrimary": "#3F51B5",
+    "ColorPrimaryDark": "#303F9F",
+    "DefaultAutoLayoutDelay": 0,
+    "DefaultTextViewGravity": "left",
+    "DefaultTextViewPaddingLeft": 5,
+    "DefaultTextViewPaddingRight": 5,
+    "EditTextEnabled": true,
+    "EnableActivityLifeCycleListener": true,
+    "EnableFragmentLifeCycleListener": true,
+    "EnableGestureSwipeLogScreen": true,
+    "EnableScreenshotCache": true,
+    "ExcludeTextViewStyleForOS": "",
+    "ExtendsGoogleWebViewClient": false,
+    "FilterMessageTypes": false,
+    "FlushUpdatedPlaceHolders": false,
+    "GenerateImageHash": true,
+    "GestureConfirmedScreenshotDelay": 0,
+    "GoogleWebViewEnabled": true,
+    "InitialZIndex": 500,
+    "IpPlaceholder": "N/A",
+    "KillSwitchAsync": true,
+    "KillSwitchDelay": 300,
+    "LibraryVersion": "11.0.11",
+    "LogFullRequestResponsePayloads": true,
+    "MessageTypeHeader": "WorklightHit",
+    "MessageTypes": "4,5",
+    "NavigationControllerEnabled": false,
+    "RemoveAllCookies": false,
+    "RemoveIp": false,
+    "ScreenViewUnloadDelay": 1000,
+    "StripDrawableFolderExt": true,
+    "SwitchWidth": 140,
+    "TouchEventEnabled": false,
+    "UseXpathId": false,
+    "UseZindex": false,
+    "WebViewDelay": "1000",
+    "WebViewSetTagForId": false
 }

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

@@ -0,0 +1,35 @@
+#Mon Jun 15 05:39:24 PDT 2026
+UseWhiteList=true
+PrintScreen=3
+UseRandomSample=false
+CookieDomain=.straussandplesser.com
+PostMessageUrl=https\://lib-us-2.brilliantcollector.com/collector/collectorPost
+SessionTimeout=30
+PercentToCompressImage=80
+CookieExpires=false
+AppKey=b6c3709b7a4c479bb4b5a9fb8fec324c
+KillSwitchEnabled=false
+ScreenShotPixelDensity=1.5
+CookieExpiresFormat=ASCTIME
+RandomSampleParam=
+SessionTimeoutKillSwitch=false
+PercentOfScreenshotsSize=40
+SetGestureDetector=true
+disableTLTDID=false
+GetImageDataOnScreenLayout=false
+CookieUrl=http\://m.straussandplesser.com
+ScreenshotFormat=JPG
+Connection=3
+CookiePath=/
+KillSwitchUrl=https\://lib-us-2.brilliantcollector.com/collector/switch/b6c3709b7a4c479bb4b5a9fb8fec324c
+LogLocationEnabled=true
+LogLocationTimeout=30
+KillSwitchTimeInterval=5
+MaxStringsLength=300
+CookieParam=TLTSID
+CookieSecure=true
+LogViewLayoutOnScreenTransition=true
+KillSwitchMaxNumberOfTries=3
+WhiteListParam=id
+CaptureNativeGesturesOnWebview=false
+LogLocationTries=3

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

@@ -6,7 +6,7 @@
     "CompressPostMessage": true,
     "DefaultOrientation": 0,
     "DisableCookieManager": false,
-    "LibraryVersion": "2.1.5",
+    "LibraryVersion": "2.1.16",
     "MNCMCC": {
         "00": "N/A",
         "20201": "Cosmote",

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

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

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

@@ -0,0 +1,40 @@
+{
+  "AutoLayout": {
+      "GlobalScreenSettings":{
+          "ScreenChange": true,
+          "DisplayName": "",
+          "CaptureLayoutDelay": 500,
+          "ScreenShot": true,
+          "NumberOfWebViews": 0,
+          "CaptureUserEvents": true,
+          "CaptureScreenVisits": false,
+          "CaptureLayoutOn": 2,
+          "CaptureScreenshotOn": 2,
+          "Masking": {
+              "HasMasking": true,
+              "HasCustomMask": true,
+              "Sensitive": {
+                  "capitalCaseAlphabet": "X",
+                  "number": "9",
+                  "smallCaseAlphabet": "x",
+                  "symbol": "#"
+              },
+              "MaskIdList": [
+              ],
+              "MaskValueList": [
+              ]
+          }
+      }
+  },
+  "AppendMapIds": {
+      "[w,9290],[v,0]": {
+          "mid": "ASimpleUIView"
+      },
+      "tag2999999": {
+          "mid": "giveAdditionalId1"
+      },
+      "idxPathValue": {
+          "mid": "giveAdditionalId2"
+      }
+  }
+}

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,9 @@
+#include <jni.h>
+#include "AcousticConnectRNOnLoad.hpp"
+#include <fbjni/fbjni.h>
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return facebook::jni::initialize(vm, []() {
+    margelo::nitro::acousticconnectrn::registerAllNatives();
+  });
+}

package/android/src/main/java/com/acousticconnectrn/AcousticConnectRNPackage.java

@@ -0,0 +1,51 @@
+// 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.
+//
+//
+//  Created on 5/9/25.
+//
+
+package com.acousticconnectrn;
+
+import androidx.annotation.Nullable;
+import androidx.annotation.NonNull;
+
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.module.model.ReactModuleInfoProvider;
+import com.facebook.react.TurboReactPackage;
+import com.margelo.nitro.acousticconnectrn.AcousticConnectRNOnLoad;
+
+import java.util.HashMap;
+
+public class AcousticConnectRNPackage extends TurboReactPackage {
+  @Nullable
+  @Override
+  public NativeModule getModule(@NonNull String name, @NonNull ReactApplicationContext reactContext) {
+    return null;
+  }
+
+  @NonNull
+  @Override
+  public ReactModuleInfoProvider getReactModuleInfoProvider() {
+    return HashMap::new;
+  }
+
+  static {
+    // Nitro's C++ factory (AcousticConnectRNOnLoad.cpp) constructs instances
+    // of HybridAcousticConnectRN itself via a zero-arg constructor, lazily on
+    // first JS call. Earlier versions of this file spun up a background
+    // thread to poll NitroModules.getApplicationContext() and eagerly
+    // construct one instance — that workaround was masking the symptom of
+    // the bridge holding a stored ReactApplicationContext field that Nitro's
+    // factory then passed as null. The bridge now resolves the React context
+    // on-demand from NitroModules.applicationContext (nullable, guarded), so
+    // no eager construction is needed.
+    AcousticConnectRNOnLoad.initializeNative();
+  }
+}