react-native-acoustic-connect 16.0.39 → 19.0.9

package/cli/lib.mjs

@@ -0,0 +1,240 @@
+// Shared helpers for the Acoustic Connect SDK setup CLI (`acoustic-connect`).
+//
+// This is the single source of truth that used to be duplicated across the
+// Examples/expo and Examples/bare-workflow `scripts/lib.mjs` files. It ships in
+// the published SDK package so client apps (and our own samples) can run the
+// same doctor / scaffolding without copying it.
+//
+// Cross-platform (macOS / Linux / Windows): only node: built-ins, commands run
+// through the platform shell. iOS-only commands (pod/bundle/ruby) are guarded
+// by the callers, never run on Windows.
+
+import {spawnSync} from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+
+const isWindows = process.platform === 'win32'
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR
+
+const paint = (code, s) => (useColor ? `[${code}m${s}` : s)
+export const color = {
+  bold: (s) => paint('1', s),
+  dim: (s) => paint('2', s),
+  red: (s) => paint('31', s),
+  green: (s) => paint('32', s),
+  yellow: (s) => paint('33', s),
+  cyan: (s) => paint('36', s),
+}
+
+export function section(title) {
+  console.log('\n' + color.bold(color.cyan(`▸ ${title}`)))
+}
+
+export function info(msg) {
+  console.log(`  ${msg}`)
+}
+
+// Run a shell command, streaming its output. Returns true on exit code 0.
+// `command` is a full command line (shell-interpreted) so callers can write it
+// the way they'd type it. Pass dynamic, path-derived values through `env`
+// (merged over the parent environment) rather than interpolating them into
+// `command` — that keeps a value containing shell metacharacters (`$`,
+// backticks, quotes, spaces) from being re-parsed by the shell.
+export function run(command, {cwd, env} = {}) {
+  return (
+    spawnSync(command, {
+      cwd,
+      env: {...process.env, ...env},
+      stdio: 'inherit',
+      shell: true,
+    }).status === 0
+  )
+}
+
+// Run a command and capture stdout/stderr instead of streaming. Used for quick
+// version/state probes — never throws (spawnSync returns on a missing binary
+// rather than throwing), and is bounded by `timeout` (default 60s) so an
+// unresponsive probe — e.g. `adb shell` against an offline device — can't hang
+// the caller. On timeout the child is killed and `ok` is false.
+export function capture(command, {cwd, timeout = 60000} = {}) {
+  const result = spawnSync(command, {
+    cwd,
+    encoding: 'utf8',
+    shell: true,
+    timeout,
+    killSignal: 'SIGKILL',
+  })
+  return {
+    ok: result.status === 0,
+    stdout: result.stdout || '',
+    stderr: result.stderr || '',
+  }
+}
+
+// Is a binary resolvable on PATH? Uses `where` on Windows, `command -v` elsewhere.
+export function commandExists(cmd) {
+  const probe = isWindows ? `where ${cmd}` : `command -v ${cmd}`
+  return spawnSync(probe, {stdio: 'ignore', shell: true}).status === 0
+}
+
+export function fileExists(p) {
+  try {
+    return fs.existsSync(p)
+  } catch {
+    return false
+  }
+}
+
+export function readText(p) {
+  try {
+    return fs.readFileSync(p, 'utf8')
+  } catch {
+    return null
+  }
+}
+
+// Read + parse JSON. Returns the parsed value, or `undefined` for any
+// "no usable object" outcome — missing, unreadable, or malformed — so callers
+// only need a single `=== undefined` check and can never hit a TypeError on a
+// null result. Callers that must distinguish missing from malformed should call
+// fileExists() first.
+export function readJson(p) {
+  const raw = readText(p)
+  if (raw == null) return undefined
+  try {
+    return JSON.parse(raw)
+  } catch {
+    return undefined
+  }
+}
+
+// Copy `src` to `dest` only when `dest` is missing. Returns 'created' |
+// 'exists' | 'no-template'. Callers surface the result so the developer knows
+// to fill the freshly-copied file in.
+export function copyIfMissing(src, dest) {
+  if (fileExists(dest)) return 'exists'
+  if (!fileExists(src)) return 'no-template'
+  fs.mkdirSync(path.dirname(dest), {recursive: true})
+  fs.copyFileSync(src, dest)
+  return 'created'
+}
+
+// Walk up from `startDir` for the nearest package.json declaring a `workspaces`
+// array that actually includes `startDir` — that's where `npm install` must run
+// so the SDK is hoisted/symlinked. Returns null for a standalone (published)
+// checkout with no workspace.
+//
+// Only a workspace that actually declares THIS app as a member counts — we
+// verify `target` matches one of the candidate's `workspaces` globs. That way
+// an unrelated outer workspace (e.g. a CI tool's own monorepo root that happens
+// to sit above the checkout) is skipped rather than mistaken for our root.
+export function findWorkspaceRoot(startDir) {
+  const target = path.resolve(startDir)
+  let dir = target
+  for (;;) {
+    const pkgPath = path.join(dir, 'package.json')
+    if (fileExists(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readText(pkgPath))
+        if (pkg && pkg.workspaces && workspaceIncludes(dir, pkg.workspaces, target))
+          return dir
+      } catch {
+        // ignore malformed package.json and keep walking up
+      }
+    }
+    const parent = path.dirname(dir)
+    if (parent === dir) return null
+    dir = parent
+  }
+}
+
+// Does `rootDir`'s `workspaces` declaration cover `target`? Handles the array
+// form and the { packages: [...] } object form, with npm's glob semantics
+// (`*` within a path segment, `**` across segments).
+function workspaceIncludes(rootDir, workspaces, target) {
+  const globs = Array.isArray(workspaces)
+    ? workspaces
+    : Array.isArray(workspaces.packages)
+      ? workspaces.packages
+      : []
+  if (rootDir === target) return true // the workspace root itself
+  const rel = path.relative(rootDir, target).split(path.sep).join('/')
+  return globs.some((glob) => {
+    const pattern = String(glob).replace(/\/$/, '')
+    const re = new RegExp(
+      '^' +
+        pattern
+          .replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape regex specials (keep * /)
+          .replace(/\*\*?/g, (m) => (m === '**' ? '.*' : '[^/]*')) + // ** -> .* , * -> one path segment
+        '$',
+    )
+    return re.test(rel)
+  })
+}
+
+// Accumulates pass/warn/fail results and prints a final summary. A single
+// `fail` makes the process exit non-zero so CI / the developer notice.
+export class Reporter {
+  constructor() {
+    this.results = []
+  }
+
+  record(status, label, detail) {
+    this.results.push({status, label, detail})
+    const mark =
+      status === 'pass'
+        ? color.green('✓')
+        : status === 'warn'
+          ? color.yellow('⚠')
+          : color.red('✗')
+    const tail = detail ? ` ${color.dim('— ' + detail)}` : ''
+    console.log(`  ${mark} ${label}${tail}`)
+  }
+
+  pass(label, detail) {
+    this.record('pass', label, detail)
+  }
+
+  warn(label, detail) {
+    this.record('warn', label, detail)
+  }
+
+  fail(label, detail) {
+    this.record('fail', label, detail)
+  }
+
+  hasFailures() {
+    return this.results.some((r) => r.status === 'fail')
+  }
+
+  // Print the summary and any actionable next steps, then return the exit code.
+  summary(nextSteps = []) {
+    const counts = {pass: 0, warn: 0, fail: 0}
+    for (const r of this.results) counts[r.status]++
+
+    section('Summary')
+    info(
+      `${color.green(counts.pass + ' ok')}, ` +
+        `${color.yellow(counts.warn + ' warning(s)')}, ` +
+        `${color.red(counts.fail + ' failure(s)')}`,
+    )
+
+    const actionable = this.results.filter(
+      (r) => r.status !== 'pass' && r.detail,
+    )
+    if (actionable.length) {
+      section('Action needed')
+      for (const r of actionable) {
+        const mark = r.status === 'fail' ? color.red('✗') : color.yellow('⚠')
+        info(`${mark} ${r.label}: ${r.detail}`)
+      }
+    }
+
+    if (nextSteps.length) {
+      section('Next steps')
+      for (const s of nextSteps) info(`• ${s}`)
+    }
+
+    return this.hasFailures() ? 1 : 0
+  }
+}

package/ios/AcousticConnectRNConfig.json

@@ -0,0 +1,160 @@
+{
+  "Connect": {
+    "AppKey": "b6c3709b7a4c479bb4b5a9fb8fec324c",
+    "KillSwitchUrl": "https://lib-us-2.brilliantcollector.com/collector/switch/b6c3709b7a4c479bb4b5a9fb8fec324c",
+    "PostMessageUrl": "https://lib-us-2.brilliantcollector.com/collector/collectorPost",
+    "AndroidVersion": "",
+    "iOSVersion": "",
+    "PushEnabled": false,
+    "iOSPushMode": "automatic",
+    "iOSAppGroupIdentifier": null,
+    "AndroidNotificationIconResName": null,
+    "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/Bridge.h

@@ -0,0 +1,13 @@
+// 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.
+//
+
+#pragma once

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
+        }
+    }
+}