react-native-acoustic-connect-beta 19.0.6 → 19.0.8

package/AcousticConnectRN.podspec

@@ -115,12 +115,45 @@ Pod::Spec.new do |s|
     # Implementation (C++ objects)
     "cpp/**/*.{hpp,cpp}",
   ]
+  # Unit tests live in ios/Tests and belong to the UnitTests test_spec below,
+  # not to the library target (source_files globs ios/**/*.swift).
+  s.exclude_files = "ios/Tests/**"
 
   s.pod_target_xcconfig = {
     # C++ compiler flags, mainly for folly.
-    "GCC_PREPROCESSOR_DEFINITIONS" => "$(inherited) FOLLY_NO_CONFIG FOLLY_CFG_NO_COROUTINES"
+    "GCC_PREPROCESSOR_DEFINITIONS" => "$(inherited) FOLLY_NO_CONFIG FOLLY_CFG_NO_COROUTINES",
+    # @testable import (UnitTests test_spec) needs testability in Debug.
+    "ENABLE_TESTABILITY[config=Debug]" => "YES"
   }
 
+  # Native unit tests. Run through a consumer app's Pods project:
+  #   Podfile: pod 'AcousticConnectRN', :path => '../..', :testspecs => ['UnitTests']
+  #   xcodebuild test -workspace <app>.xcworkspace -scheme AcousticConnectRN \
+  #     -destination 'platform=iOS Simulator,name=<booted sim>'
+  # The tests use Swift Testing. They do NOT `@testable import` the pod
+  # module — see the source_files comment below for why that's impossible.
+  s.test_spec 'UnitTests' do |ts|
+    # The sources under test are compiled directly into the test bundle
+    # instead of `@testable import`ing the pod module: nitrogen's generated
+    # Swift compatibility header emits C++ thunks referencing nitro C++ types
+    # (margelo::nitro::ArrayBufferHolder) without including their headers, so
+    # the AcousticConnectRN clang module cannot be built by any Swift client —
+    # including a test target. Compiling the files here is safe: the linker
+    # pulls static-archive members lazily, so the parent lib's copies of
+    # these objects are never loaded and no duplicate symbols arise.
+    ts.source_files = [
+      'ios/Tests/**/*.swift',
+      'ios/ConnectRNParsing.swift',
+      'nitrogen/generated/ios/swift/Variant_Bool_String_Double.swift',
+    ]
+    # ios/ConnectRNParsing.swift does `import Connect`. CocoaPods test_specs
+    # inherit the parent spec's dependencies implicitly, so this line is
+    # observably redundant today — declared explicitly anyway so the test
+    # bundle's dependency on the Connect SDK doesn't rely on that inheritance
+    # behavior remaining unchanged (e.g. a future migration off CocoaPods).
+    ts.dependency dependencyName, *dependencyRequirements
+  end
+
   s.resource_bundle = {
     'AcousticConnectRNConfig' => ['ios/AcousticConnectRNConfig.json'],
   }

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 19.0.8 (2026-07-03)
+
+### Reverts
+
+* Revert "Beta ReactNativeConnect build: 18.0.36" ([609ad7d](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/commit/609ad7d3244ec06f27dced5864d40585c5b3c9cf))
+## 19.0.7 (2026-07-03)
+
+### Reverts
+
+* Revert "Beta ReactNativeConnect build: 18.0.36" ([609ad7d](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/commit/609ad7d3244ec06f27dced5864d40585c5b3c9cf))
 ## [19.0.6](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/19.0.5...19.0.6) (2026-07-02)
 ## [19.0.5](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/19.0.4...19.0.5) (2026-07-02)
 ## [19.0.4](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/19.0.3...19.0.4) (2026-07-01)

package/ConnectConfig.example.json

@@ -0,0 +1,15 @@
+{
+    "Connect": {
+        "AndroidNotificationIconResName": "ic_notification",
+        "AndroidVersion": "11.0.12-beta",
+        "AppKey": "YOUR_CONNECT_APP_KEY_HERE",
+        "KillSwitchUrl": "YOUR_KILL_SWITCH_URL_HERE",
+        "PostMessageUrl": "YOUR_POST_MESSAGE_URL_HERE",
+        "PushEnabled": false,
+        "iOSAppGroupIdentifier": "YOUR_APP_GROUP_ID_HERE",
+        "iOSDevelopmentTeam": "YOUR_TEAM_ID",
+        "iOSPushMode": "automatic",
+        "iOSVersion": "",
+        "useRelease": false
+    }
+}

package/README.md

@@ -84,6 +84,81 @@ Field summary (see [API reference](#api-reference) for full semantics):
 | `iOSAppGroupIdentifier` | `null` | iOS App Group shared with the Notification Service / Notification Content extension. |
 | `AndroidNotificationIconResName` | `null` | Drawable resource name (no extension) for the Android notification small icon. |
 
+### What `npm install` / `pod install` do for you
+
+Both commands run bootstrap steps against **your** project, not just the
+package's own build:
+
+- `npm install` triggers a postinstall step that (idempotently, best-effort):
+  - scaffolds a starter `ConnectConfig.json` at your project root if one
+    isn't already there,
+  - adds the Android permissions Connect needs
+    (`INTERNET`, `ACCESS_NETWORK_STATE`, `ACCESS_WIFI_STATE`,
+    `ACCESS_FINE_LOCATION`) to `android/app/src/main/AndroidManifest.xml`,
+  - wires `android/app/build.gradle` to apply the SDK's `config.gradle`.
+- `pod install` merges your `ConnectConfig.json` into the iOS pod's
+  generated config bundle at install time (see the podspec).
+
+None of this touches files outside your project's `android/`/`ios/`
+directories, and re-running either command is safe. After install, run
+`npx acoustic-connect doctor` to validate the result — see
+[Setup CLI](#setup-cli-acoustic-connect) below.
+
+## Setup CLI (`acoustic-connect`)
+
+The package ships a small CLI, installed as `acoustic-connect` (invoke it with
+`npx acoustic-connect <command>`), that validates and scaffolds the native
+side of an integration. Both commands auto-detect bare RN vs. Expo and are
+idempotent — safe to re-run, and they never overwrite a file that's already
+there.
+
+### `npx acoustic-connect doctor [dir] [--require-push]`
+
+Checks the things that otherwise fail late and confusingly at build time:
+
+- Node version.
+- `ConnectConfig.json` values — `AppKey`, `PostMessageUrl` / `KillSwitchUrl`
+  (must be real `https` URLs, not the placeholder host), `iOSAppGroupIdentifier`
+  format, `iOSDevelopmentTeam` format.
+- Android identifiers — the package/namespace is a Java-safe name, and it has
+  a matching client in `google-services.json` (Expo also checks for a stale
+  `android/` from an incremental `expo prebuild` after an `android.package`
+  change).
+- iOS entitlements — bare projects need `aps-environment` + an App Group
+  entitlement (from `setup-ios-push`, below, or hand-authored).
+- (macOS only) whether a local Apple Development signing identity is
+  installed, when push is on.
+
+The push-related checks above are **hard failures** only when
+`Connect.PushEnabled` is `true` (or `--require-push` is passed) — a non-push
+integration only needs `AppKey`. `doctor` exits non-zero on any failure, so
+it's usable as a CI gate (`npx acoustic-connect doctor --require-push`).
+
+`dir` defaults to the current directory. If `ConnectConfig.json` is missing,
+`doctor` scaffolds it first (from a project-local `ConnectConfig.example.json`
+if you have one, else from the copy bundled with the package) before running
+the checks above — so it's also a fine first command to run in a fresh
+project.
+
+### `npx acoustic-connect setup-ios-push [dir]`
+
+Bare-workflow only — the Expo Config Plugin does the equivalent automatically
+on `expo prebuild`. Scaffolds the two iOS push extensions:
+
+- `ConnectNSE` (Notification Service Extension — rich-media attachments,
+  delivery tracking)
+- `ConnectNCE` (Notification Content Extension — expanded rich-media UI)
+
+It writes each extension's Swift source, `Info.plist`, and entitlements from
+the SDK's templates (substituting your App Group), adds the App Group +
+`aps-environment` entitlement to the host app if it doesn't have one yet, and
+wires both targets into your `.xcodeproj` via a bundled Ruby script — which
+needs `ruby` and the `xcodeproj` gem (`gem install xcodeproj`; ships with
+CocoaPods, so most Mac dev setups already have it).
+
+Requires macOS and `Connect.iOSAppGroupIdentifier` already set in
+`ConnectConfig.json` — run `doctor` first if it's missing.
+
 ## Using with Expo SDK 55+
 
 Expo SDK 55 and newer is supported via the bundled Expo Config Plugin.
@@ -409,11 +484,36 @@ releases. Match the version rather than bypass it.
 
 ### iOS — push session reaches the collector but no notifications arrive (no APNs token)
 
-A CLI build (`expo run:ios` / `react-native run-ios` / `xcodebuild`) doesn't
-auto-pick a signing team the way the Xcode GUI does. With no team, it signs
-ad-hoc and **drops the `aps-environment` entitlement**, so iOS issues no APNs
-token — the app still launches and analytics reach the collector, but no
-`pushRegistration` (with a `mobileToken`) is ever sent. Fix:
+**Fingerprint:** analytics and `pushRegistration` still reach the collector
+normally, but `mobileToken` stays `null` forever — and, notably, **no
+`didFailToRegisterForRemoteNotificationsWithError` (or any push-related
+failure) shows up in logs either.** It just silently never happens. That
+absence of any error is what makes this look like a missing/broken app-side
+callback or an SDK bug at first glance; it's almost always a signing
+artifact instead. Run `npx acoustic-connect doctor` first — it detects this
+exact condition (missing/invalid `iOSDevelopmentTeam`, no Development
+certificate) up front, before you go digging through portal config.
+
+Cause: a CLI build (`expo run:ios` / `react-native run-ios` / `xcodebuild`)
+doesn't auto-pick a signing team the way the Xcode GUI does. With no team, it
+signs ad-hoc and **drops the `aps-environment` entitlement**, so iOS issues no
+APNs token — the app still launches and analytics reach the collector, but no
+`pushRegistration` with a `mobileToken` is ever sent.
+
+**Setting `Connect.iOSDevelopmentTeam` in `ConnectConfig.json` by itself does
+nothing.** It's just a source value — it has no effect on the build until
+`expo prebuild` / `npx acoustic-connect setup-ios-push` actually stamps
+`DEVELOPMENT_TEAM` onto the host **and** the `ConnectNSE` **and** `ConnectNCE`
+targets in the generated `.pbxproj`. Re-run that step any time
+`iOSDevelopmentTeam` changes, and after every fresh clone — a teammate's
+machine may already have the stamp baked in from a prior run; yours doesn't
+until you run it too. This is the classic "works for me, not for them" trap:
+every portal-side check (App ID push capability, provisioning profile,
+entitlements file contents, App Group registration, `.p8` key upload) can
+look perfect and still not reflect what's actually embedded in the binary
+that got installed on the device.
+
+Fix:
 
 1. Set `Connect.iOSDevelopmentTeam` (10-char Apple Team ID) in
    `ConnectConfig.json` (or pass the `iosDevelopmentTeam` plugin prop). Re-run
@@ -423,8 +523,22 @@ token — the app still launches and analytics reach the collector, but no
    ID added in Xcode → Settings → Accounts, so a Development certificate +
    profiles are provisioned.
 
-`npx acoustic-connect doctor` fails with this exact remedy when push is on and
-the team is missing (or when no Development certificate is in your keychain).
+**Verify the fix actually landed** — rerunning the steps above isn't proof by
+itself; confirm the build artifacts directly:
+
+```bash
+# 1. DEVELOPMENT_TEAM must be stamped on the host AND both push extensions
+grep DEVELOPMENT_TEAM ios/*.xcodeproj/project.pbxproj
+
+# 2. The *installed* binary must carry the entitlement — check the actual
+#    .app, not just the source .entitlements file in your repo
+codesign -d --entitlements :- --xml /path/to/YourApp.app
+# must show aps-environment in the output
+```
+
+If `DEVELOPMENT_TEAM` is missing for any of the three targets, or `codesign`
+doesn't show `aps-environment`, the stamp didn't take (or a stale build was
+reused) — re-run `setup-ios-push` / `prebuild` and do a clean rebuild.
 
 ### iOS — Expo Android build fails: `No matching client found for package name …`
 

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

@@ -1,4 +1,4 @@
-#Thu Jul 02 10:44:10 PDT 2026
+#Fri Jul 03 03:03:02 PDT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/cli/__tests__/doctor.test.mjs

@@ -0,0 +1,88 @@
+// Copyright (C) 2026 Acoustic, L.P. All rights reserved.
+//
+// Unit tests for ensureConnectConfig's local→bundled→missing fallback in
+// cli/doctor.mjs. Uses Node's built-in test runner (node:test) — no build
+// step needed, cli/ is plain ESM.
+//
+//   npm run test:cli
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
+
+import { ensureConnectConfig } from '../doctor.mjs'
+import { Reporter } from '../lib.mjs'
+
+function tmpDir() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), 'connect-doctor-test-'))
+}
+
+// ensureConnectConfig's 'exists' branch reports as `pass('ConnectConfig.json present')`
+// (label includes the detail) while the other branches use a plain
+// 'ConnectConfig.json' label with a separate detail string — match by prefix
+// so the assertion doesn't depend on that formatting quirk.
+function statusFor(reporter, labelPrefix) {
+  return reporter.results.find((r) => r.label.startsWith(labelPrefix))?.status
+}
+
+test('ensureConnectConfig: prefers a project-local ConnectConfig.example.json over the bundled one', () => {
+  const dir = tmpDir()
+  fs.writeFileSync(
+    path.join(dir, 'ConnectConfig.example.json'),
+    JSON.stringify({ Connect: { AppKey: 'from-local-example' } }),
+  )
+  const reporter = new Reporter()
+
+  ensureConnectConfig(reporter, dir, {
+    bundledExample: path.join(dir, 'never-read.json'),
+  })
+
+  const written = JSON.parse(fs.readFileSync(path.join(dir, 'ConnectConfig.json'), 'utf8'))
+  assert.equal(written.Connect.AppKey, 'from-local-example')
+  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'warn')
+})
+
+test('ensureConnectConfig: falls back to the bundled example when no project-local one exists', () => {
+  const dir = tmpDir()
+  const bundledDir = tmpDir()
+  const bundledExample = path.join(bundledDir, 'ConnectConfig.example.json')
+  fs.writeFileSync(bundledExample, JSON.stringify({ Connect: { AppKey: 'from-bundled-example' } }))
+  const reporter = new Reporter()
+
+  ensureConnectConfig(reporter, dir, { bundledExample })
+
+  const written = JSON.parse(fs.readFileSync(path.join(dir, 'ConnectConfig.json'), 'utf8'))
+  assert.equal(written.Connect.AppKey, 'from-bundled-example')
+  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'warn')
+})
+
+test('ensureConnectConfig: fails cleanly (no crash, no file written) when both are missing', () => {
+  const dir = tmpDir()
+  const reporter = new Reporter()
+
+  ensureConnectConfig(reporter, dir, {
+    bundledExample: path.join(dir, 'does-not-exist.json'),
+  })
+
+  assert.equal(fs.existsSync(path.join(dir, 'ConnectConfig.json')), false)
+  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'fail')
+})
+
+test('ensureConnectConfig: never overwrites an existing ConnectConfig.json', () => {
+  const dir = tmpDir()
+  fs.writeFileSync(
+    path.join(dir, 'ConnectConfig.json'),
+    JSON.stringify({ Connect: { AppKey: 'already-configured' } }),
+  )
+  const reporter = new Reporter()
+
+  ensureConnectConfig(reporter, dir, {
+    bundledExample: path.join(dir, 'never-read.json'),
+  })
+
+  const written = JSON.parse(fs.readFileSync(path.join(dir, 'ConnectConfig.json'), 'utf8'))
+  assert.equal(written.Connect.AppKey, 'already-configured')
+  assert.equal(statusFor(reporter, 'ConnectConfig.json'), 'pass')
+})

package/cli/doctor.mjs

@@ -4,8 +4,9 @@
 // Connect integration that otherwise fail late and confusingly at build time:
 // the App Group format, a Java-safe Android package, and the
 // google-services.json package match. It also scaffolds the gitignored
-// ConnectConfig.json from the committed example so a fresh clone has something
-// to edit.
+// ConnectConfig.json — from a project-local ConnectConfig.example.json if
+// present, else from the copy bundled at the package root — so a fresh
+// project has something to edit.
 //
 // Auto-detects the project shape:
 //   - Expo  : a root app.json with an `expo` block (identifiers live there;
@@ -20,6 +21,7 @@
 
 import fs from 'node:fs'
 import path from 'node:path'
+import {fileURLToPath} from 'node:url'
 
 import {
   Reporter,
@@ -32,6 +34,10 @@ import {
   section,
 } from './lib.mjs'
 
+// Package root (one level up from cli/) — where the bundled
+// ConnectConfig.example.json ships for real (published) consumers.
+const sdkRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)))
+
 // App Group format per Apple + the Config Plugin's own validator
 // (plugin/src/withConnectNSE.ts: APP_GROUP_PATTERN).
 const APP_GROUP_PATTERN = /^group\.[A-Za-z0-9.-]+$/
@@ -101,10 +107,22 @@ function checkNode(reporter) {
     )
 }
 
-// Scaffold the per-developer ConnectConfig.json from the committed example.
-function ensureConnectConfig(reporter, dir) {
+// Scaffold the per-developer ConnectConfig.json from an example. Prefers a
+// project-local ConnectConfig.example.json (e.g. this repo's own
+// Examples/bare-workflow and Examples/expo, which commit a customized one) and
+// falls back to the copy bundled with the package — the project-local file
+// generally isn't there for a real (published) consumer.
+//
+// `bundledExample` is overridable purely so cli/__tests__/doctor.test.mjs can
+// exercise the "both missing" branch without touching the real package file.
+export function ensureConnectConfig(
+  reporter,
+  dir,
+  {bundledExample = path.join(sdkRoot, 'ConnectConfig.example.json')} = {},
+) {
   const dest = path.join(dir, 'ConnectConfig.json')
-  const src = path.join(dir, 'ConnectConfig.example.json')
+  const localExample = path.join(dir, 'ConnectConfig.example.json')
+  const src = fileExists(localExample) ? localExample : bundledExample
   const result = copyIfMissing(src, dest)
   if (result === 'created')
     reporter.warn(

package/ios/ConnectRNParsing.swift

@@ -0,0 +1,154 @@
+// Copyright (C) 2026 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.
+
+import Foundation
+import Connect
+import OSLog
+
+// Same subsystem/category as the bridge's config logger so the extraction
+// does not change where these lines surface in Console.app.
+private let configLog = Logger(subsystem: "com.acoustic.AcousticConnectRN", category: "config")
+
+/// Pure parsing / mapping / conversion logic extracted from
+/// `HybridAcousticConnectRN` (behaviour-preserving extraction) so it can be
+/// unit-tested without constructing the hybrid — the hybrid's `init`
+/// dispatches `load()`, which enables the real SDK with the bundled AppKey.
+internal enum ConnectRNParsing {
+
+    internal enum IOSPushMode: Equatable {
+        case automatic, manual
+        var descriptor: String { self == .automatic ? "automatic" : "manual" }
+    }
+
+    /// Lenient `PushEnabled` parser — accepts a `Bool` directly, or a string
+    /// like `"true"`/`"false"`/`"yes"`/`"no"`. Anything else falls back to
+    /// `false` with a warning so a typo in the JSON doesn't silently enable
+    /// push when the developer thought they'd turned it off.
+    static func parsePushEnabled(_ raw: Any?) -> Bool {
+        if let b = raw as? Bool { return b }
+        if let n = raw as? NSNumber { return n.boolValue }
+        if let s = raw as? String {
+            switch s.lowercased() {
+            case "true", "yes", "1": return true
+            case "false", "no", "0", "": return false
+            default:
+                configLog.warning("PushEnabled string \"\(s, privacy: .public)\" not recognised. Falling back to false.")
+                return false
+            }
+        }
+        if raw != nil {
+            configLog.warning("PushEnabled is set but is neither a Bool nor a recognised string. Falling back to false.")
+        }
+        return false
+    }
+
+    static func parseIOSPushMode(_ raw: String?) -> IOSPushMode {
+        switch raw?.lowercased() {
+        case "automatic", "auto", nil, "":
+            return .automatic
+        case "manual":
+            return .manual
+        default:
+            configLog.error("iOSPushMode \"\(raw ?? "", privacy: .public)\" not recognised. Allowed values: \"automatic\", \"manual\". Falling back to \"automatic\".")
+            return .automatic
+        }
+    }
+
+    /// Resolves `PushEnabled` + `iOSPushMode` + `iOSAppGroupIdentifier` from the
+    /// bundled config into a `ConnectPushConfig`. Validation errors are logged
+    /// at `.error`; soft mismatches at `.warning`. The SDK always falls back to
+    /// a safe default (`.off`) so an invalid config never crashes the app.
+    static func resolvePushConfig(from connectData: [String: Any]) -> ConnectPushConfig {
+        let pushEnabled = parsePushEnabled(connectData["PushEnabled"])
+        let iOSPushModeRaw = connectData["iOSPushMode"] as? String
+        let groupId = connectData["iOSAppGroupIdentifier"] as? String
+
+        configLog.info("PushEnabled: \(pushEnabled)")
+
+        // Inconsistency: iOSPushMode is set but PushEnabled is false. The
+        // mode value would never take effect; warn the developer so they
+        // know to fix one or the other.
+        if !pushEnabled, let raw = iOSPushModeRaw, !raw.isEmpty {
+            configLog.error("iOSPushMode \"\(raw, privacy: .public)\" is set but PushEnabled is false. Ignoring iOSPushMode; SDK will run with push disabled.")
+            return .off
+        }
+
+        guard pushEnabled else {
+            configLog.info("iOSPushMode: (not used, PushEnabled is false)")
+            configLog.info("iOSAppGroupIdentifier: (not used, PushEnabled is false)")
+            return .off
+        }
+
+        let mode = parseIOSPushMode(iOSPushModeRaw)
+        configLog.info("iOSPushMode: \(mode.descriptor, privacy: .public)")
+        if let groupId = groupId, !groupId.isEmpty {
+            configLog.info("iOSAppGroupIdentifier: \(groupId, privacy: .public)")
+        } else {
+            configLog.warning("iOSAppGroupIdentifier is not set. Required if your app uses a Notification Service or Notification Content extension to render rich push payloads.")
+        }
+
+        switch mode {
+        case .automatic:
+            return ConnectPushConfig(mode: .automatic, appGroupIdentifier: groupId)
+        case .manual:
+            return ConnectPushConfig(mode: .manual, appGroupIdentifier: groupId)
+        }
+    }
+
+    // Note: nsError(from: PushErrorInfo) stays in HybridAcousticConnectRN —
+    // PushErrorInfo is a C++-backed nitro type, and this file is also
+    // compiled into the UnitTests bundle, which builds without C++ interop.
+
+    /// Maps the JS-facing module name to the config store's module name
+    /// ("Connect" → "TLFCoreModule").
+    static func storeModuleName(for moduleName: String) -> String {
+        if moduleName.caseInsensitiveCompare("Connect") == .orderedSame {
+            return "TLFCoreModule"
+        }
+        return moduleName
+    }
+
+    static func convertToAnyDictionary(input: [String: Variant_Bool_String_Double]) -> [String: Any] {
+        var result: [String: Any] = [:]
+
+        for (key, value) in input {
+            switch value {
+            case .first(let boolValue):
+                result[key] = boolValue
+            case .second(let stringValue):
+                result[key] = stringValue
+            case .third(let doubleValue):
+                result[key] = doubleValue
+            }
+        }
+
+        return result
+    }
+
+    static func convertVariantToAny(_ variant: Variant_Bool_String_Double) -> Any {
+        switch variant {
+        case .first(let boolValue):
+            return boolValue
+        case .second(let stringValue):
+            return stringValue
+        case .third(let doubleValue):
+            return doubleValue
+        }
+    }
+
+    static func logLevel(from level: Double) -> kConnectMonitoringLevelType {
+        let intValue: Int = Int(level)
+        if intValue == 0 {
+            return kConnectMonitoringLevelType.connectMonitoringLevelIgnore
+        } else if intValue == 1 {
+            return kConnectMonitoringLevelType.connectMonitoringLevelCellularAndWiFi
+        } else {
+            return kConnectMonitoringLevelType.connectMonitoringLevelWiFi
+        }
+    }
+}

package/ios/HybridAcousticConnectRN.swift

@@ -143,7 +143,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
             configLog.info("KillSwitchUrl: \(killSwitch, privacy: .public)")
         }
 
-        let pushConfig = self.resolvePushConfig(from: connectData)
+        let pushConfig = ConnectRNParsing.resolvePushConfig(from: connectData)
 
         // Non-release integrations (useRelease:false — the AcousticConnectDebug
         // SDK variant) turn on the Connect/Tealeaf/EOCore verbose native logging
@@ -174,84 +174,9 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
         bridgeLog.info("SDK initialised: appKey length=\(appKey.count), push=\(pushConfig.modeDescription, privacy: .public), isReactNative=true, wrapNavigationContainer=true")
     }
 
-    /// Resolves `PushEnabled` + `iOSPushMode` + `iOSAppGroupIdentifier` from the
-    /// bundled config into a `ConnectPushConfig`. Validation errors are logged
-    /// at `.error`; soft mismatches at `.warning`. The SDK always falls back to
-    /// a safe default (`.off`) so an invalid config never crashes the app.
-    @MainActor
-    private func resolvePushConfig(from connectData: [String: Any]) -> ConnectPushConfig {
-        let pushEnabled = self.parsePushEnabled(connectData["PushEnabled"])
-        let iOSPushModeRaw = connectData["iOSPushMode"] as? String
-        let groupId = connectData["iOSAppGroupIdentifier"] as? String
-
-        configLog.info("PushEnabled: \(pushEnabled)")
-
-        // Inconsistency: iOSPushMode is set but PushEnabled is false. The
-        // mode value would never take effect; warn the developer so they
-        // know to fix one or the other.
-        if !pushEnabled, let raw = iOSPushModeRaw, !raw.isEmpty {
-            configLog.error("iOSPushMode \"\(raw, privacy: .public)\" is set but PushEnabled is false. Ignoring iOSPushMode; SDK will run with push disabled.")
-            return .off
-        }
-
-        guard pushEnabled else {
-            configLog.info("iOSPushMode: (not used, PushEnabled is false)")
-            configLog.info("iOSAppGroupIdentifier: (not used, PushEnabled is false)")
-            return .off
-        }
-
-        let mode = self.parseIOSPushMode(iOSPushModeRaw)
-        configLog.info("iOSPushMode: \(mode.descriptor, privacy: .public)")
-        if let groupId = groupId, !groupId.isEmpty {
-            configLog.info("iOSAppGroupIdentifier: \(groupId, privacy: .public)")
-        } else {
-            configLog.warning("iOSAppGroupIdentifier is not set. Required if your app uses a Notification Service or Notification Content extension to render rich push payloads.")
-        }
-
-        switch mode {
-        case .automatic:
-            return ConnectPushConfig(mode: .automatic, appGroupIdentifier: groupId)
-        case .manual:
-            return ConnectPushConfig(mode: .manual, appGroupIdentifier: groupId)
-        }
-    }
-
-    /// Lenient `PushEnabled` parser — accepts a `Bool` directly, or a string
-    /// like `"true"`/`"false"`/`"yes"`/`"no"`. Anything else falls back to
-    /// `false` with a warning so a typo in the JSON doesn't silently enable
-    /// push when the developer thought they'd turned it off.
-    private func parsePushEnabled(_ raw: Any?) -> Bool {
-        if let b = raw as? Bool { return b }
-        if let n = raw as? NSNumber { return n.boolValue }
-        if let s = raw as? String {
-            switch s.lowercased() {
-            case "true", "yes", "1": return true
-            case "false", "no", "0", "": return false
-            default:
-                configLog.warning("PushEnabled string \"\(s, privacy: .public)\" not recognised. Falling back to false.")
-                return false
-            }
-        }
-        if raw != nil {
-            configLog.warning("PushEnabled is set but is neither a Bool nor a recognised string. Falling back to false.")
-        }
-        return false
-    }
-
-    private enum IOSPushMode { case automatic, manual
-        var descriptor: String { self == .automatic ? "automatic" : "manual" } }
-
-    private func parseIOSPushMode(_ raw: String?) -> IOSPushMode {
-        switch raw?.lowercased() {
-        case "automatic", "auto", nil, "":
-            return .automatic
-        case "manual":
-            return .manual
-        default:
-            configLog.error("iOSPushMode \"\(raw ?? "", privacy: .public)\" not recognised. Allowed values: \"automatic\", \"manual\". Falling back to \"automatic\".")
-            return .automatic
-        }
-    }
+    // Push-config resolution and the PushEnabled / iOSPushMode parsers moved
+    // to ConnectRNParsing (behaviour-preserving extraction) so
+    // they are unit-testable without constructing this hybrid.
 
     /// Reads and returns the `Connect` dictionary from the bundled
     /// `AcousticConnectRNConfig.json`. The bundle is populated at pod install
@@ -488,7 +413,10 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
     // MARK: - Push: helpers
 
     /// Builds an `NSError` from the structured bridge error object, shared by
-    /// `pushDidFailToRegister` and `pushDidReceiveAuthorization`.
+    /// `pushDidFailToRegister` and `pushDidReceiveAuthorization`. Kept here
+    /// (not in ConnectRNParsing) because `PushErrorInfo` is a C++-backed
+    /// nitro type and ConnectRNParsing is also compiled into the UnitTests
+    /// bundle, which builds without C++ interop.
     private static func nsError(from info: PushErrorInfo) -> NSError {
         NSError(
             domain: info.domain ?? "ConnectRNBridge",
@@ -816,39 +744,18 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
         return true
     }
     
+    // The bodies below moved to ConnectRNParsing (behaviour-preserving
+    // extraction); these thin delegates keep the class API stable.
     func testModuleName(moduleName: String) throws -> String {
-        if (moduleName.caseInsensitiveCompare("Connect") == .orderedSame) {
-            return "TLFCoreModule"
-        }
-        return moduleName
+        return ConnectRNParsing.storeModuleName(for: moduleName)
     }
-  
-    func convertToAnyDictionary(input: [String: Variant_Bool_String_Double]) -> [String: Any] {
-        var result: [String: Any] = [:]
-
-        for (key, value) in input {
-            switch value {
-            case .first(let boolValue):
-                result[key] = boolValue
-            case .second(let stringValue):
-                result[key] = stringValue
-            case .third(let doubleValue):
-                result[key] = doubleValue
-            }
-        }
 
-        return result
+    func convertToAnyDictionary(input: [String: Variant_Bool_String_Double]) -> [String: Any] {
+        return ConnectRNParsing.convertToAnyDictionary(input: input)
     }
 
     func convertVariantToAny(_ variant: Variant_Bool_String_Double) -> Any {
-        switch variant {
-        case .first(let boolValue):
-            return boolValue
-        case .second(let stringValue):
-            return stringValue
-        case .third(let doubleValue):
-            return doubleValue
-        }
+        return ConnectRNParsing.convertVariantToAny(variant)
     }
     
 //    func convertKeyValueMapToDictionary(_ keyValueMap: KeyValueMap) -> [AnyHashable: Any] {
@@ -863,14 +770,7 @@ class HybridAcousticConnectRN: HybridAcousticConnectRNSpec {
 //    }
     
     func getLogLevelHelper(level: Double) throws -> kConnectMonitoringLevelType {
-        let intValue: Int = Int(level)
-        if intValue == 0 {
-            return kConnectMonitoringLevelType.connectMonitoringLevelIgnore
-        } else if intValue == 1 {
-            return kConnectMonitoringLevelType.connectMonitoringLevelCellularAndWiFi
-        } else {
-            return kConnectMonitoringLevelType.connectMonitoringLevelWiFi
-        }
+        return ConnectRNParsing.logLevel(from: level)
     }
     
     func getLogLevel(level: Double) throws -> kConnectMonitoringLevelType {

package/package.json

@@ -84,12 +84,14 @@
         "ios/**/*.mm",
         "ios/**/*.cpp",
         "ios/**/*.swift",
+        "!ios/Tests/**",
         "ios/AcousticConnectRNConfig.json",
         "app.plugin.js",
         "plugin/build",
         "plugin/swift",
         "plugin/src",
         "cli",
+        "ConnectConfig.example.json",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
@@ -216,7 +218,8 @@
         "rebuild": "npm run codegen && npm run rebuildExample --prefix ./example",
         "release": "release-it",
         "test": "jest",
-        "test:all": "npm test && npm run test:plugin",
+        "test:all": "npm test && npm run test:plugin && npm run test:cli",
+        "test:cli": "node --test cli/__tests__/",
         "test:plugin": "npm run build:plugin && node --test plugin/__tests__/",
         "test:watch": "jest --watch",
         "typecheck": "tsc --noEmit",
@@ -226,7 +229,7 @@
     "source": "src/index",
     "summary": "react-native ios android tealeaf connect cxa wxca er enhanced-replay",
     "types": "./lib/typescript/src/index.d.ts",
-    "version": "19.0.6",
+    "version": "19.0.8",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/scripts/reviewConnectConfig.js

@@ -12,8 +12,13 @@
  * Used review ConnectConfig.json is present ot will need to add one.
  */
 const fs = require('fs');
+const path = require('path');
 const filePathBaseConnectConfig = "../../ConnectConfig.json"
-const filePathTemplateConnectConfig = "scripts/ConnectConfig.json"
+// Single source of truth for the template — same file cli/doctor.mjs falls
+// back to for bare/Expo consumers. Do not reintroduce a separate copy here.
+// __dirname-relative (not CWD-relative) so this resolves correctly regardless
+// of the working directory the caller runs this script from.
+const filePathTemplateConnectConfig = path.resolve(__dirname, '..', 'ConnectConfig.example.json')
 
 console.log("Run reviewConnectConfig.js");
 

package/scripts/ConnectConfig.json

@@ -1,180 +0,0 @@
-{
-    "Connect": {
-        "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",
-        "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
-    }
-}