react-native-acoustic-connect-beta 18.0.37 → 18.0.38

package/CHANGELOG.md

@@ -1,3 +1,4 @@
+## [18.0.38](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.37...18.0.38) (2026-06-22)
 ## [18.0.37](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.36...18.0.37) (2026-06-22)
 ## [18.0.35](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.34...18.0.35) (2026-06-15)
 ## [18.0.34](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.33...18.0.34) (2026-06-15)

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

@@ -1,4 +1,4 @@
-#Mon Jun 22 05:14:55 PDT 2026
+#Mon Jun 22 06:57:38 PDT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/cli/doctor.mjs

@@ -0,0 +1,294 @@
+// `acoustic-connect doctor [dir]` — pre-build doctor + config scaffolder.
+//
+// One command that checks the prerequisites and validates the bits of Acoustic
+// 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.
+//
+// Auto-detects the project shape:
+//   - Expo  : a root app.json with an `expo` block (identifiers live there;
+//             google-services.json sits at the project root).
+//   - bare  : an android/app/build.gradle (identifiers come from
+//             applicationId; google-services.json sits under android/app/).
+//
+// It is read-mostly: the only thing it writes is a missing ConnectConfig.json
+// (copied from the example). It never touches native projects, installs
+// dependencies, or creates Apple/Firebase resources — those are owned by the
+// platform tooling and the developer's accounts.
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+import {
+  Reporter,
+  color,
+  copyIfMissing,
+  fileExists,
+  readJson,
+  readText,
+  section,
+} from './lib.mjs'
+
+// 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.-]+$/
+
+// Java reserved words (+ literals) that cannot appear as a package segment.
+// Expo uses android.package as the Java/Kotlin namespace, so any segment that
+// is a keyword breaks the Gradle build ("not a valid Java package name").
+const JAVA_KEYWORDS = new Set([
+  'abstract', 'assert', 'boolean', 'break', 'byte', 'case', 'catch', 'char',
+  'class', 'const', 'continue', 'default', 'do', 'double', 'else', 'enum',
+  'extends', 'final', 'finally', 'float', 'for', 'goto', 'if', 'implements',
+  'import', 'instanceof', 'int', 'interface', 'long', 'native', 'new',
+  'package', 'private', 'protected', 'public', 'return', 'short', 'static',
+  'strictfp', 'super', 'switch', 'synchronized', 'this', 'throw', 'throws',
+  'transient', 'try', 'void', 'volatile', 'while', 'true', 'false', 'null',
+])
+
+// Decide whether `dir` is an Expo or a bare React Native project.
+export function detectProjectType(dir) {
+  const appJson = readJson(path.join(dir, 'app.json'))
+  if (appJson && appJson.expo) return 'expo'
+  // A bare RN app always declares `react-native` in its manifest. Use that as
+  // the discriminator rather than a bare `android/` directory — any Flutter or
+  // native-Android project also has one, and would be misclassified as bare.
+  const pkg = readJson(path.join(dir, 'package.json'))
+  const deps = {...pkg?.dependencies, ...pkg?.devDependencies}
+  if (deps['react-native']) return 'bare'
+  return 'unknown'
+}
+
+function checkNode(reporter) {
+  const major = Number(process.versions.node.split('.')[0])
+  if (major >= 20) reporter.pass(`Node ${process.versions.node}`)
+  else
+    reporter.fail(
+      `Node ${process.versions.node}`,
+      'Node >= 20 is required — upgrade Node and re-run',
+    )
+}
+
+// Scaffold the per-developer ConnectConfig.json from the committed example.
+function ensureConnectConfig(reporter, dir) {
+  const dest = path.join(dir, 'ConnectConfig.json')
+  const src = path.join(dir, 'ConnectConfig.example.json')
+  const result = copyIfMissing(src, dest)
+  if (result === 'created')
+    reporter.warn(
+      'ConnectConfig.json',
+      'created from example — EDIT it: set AppKey + collector URLs (PostMessageUrl/KillSwitchUrl), and iOSAppGroupIdentifier for push',
+    )
+  else if (result === 'exists') reporter.pass('ConnectConfig.json present')
+  else reporter.fail('ConnectConfig.json', 'ConnectConfig.example.json missing')
+}
+
+// Validate the App Group identifier (when set). A bad value fails the Config
+// Plugin during `expo prebuild` / the iOS extensions at build time, not here,
+// so catch it early. Returns { appGroup, pushEnabled } for downstream checks.
+function checkConnectConfigValues(reporter, dir) {
+  const cfg = readJson(path.join(dir, 'ConnectConfig.json'))
+  if (cfg === undefined) {
+    // Missing/failed was already reported by ensureConnectConfig; only flag a
+    // present-but-broken file here.
+    if (fileExists(path.join(dir, 'ConnectConfig.json')))
+      reporter.fail('ConnectConfig.json', 'present but not valid JSON')
+    return {}
+  }
+  const connect = (cfg && cfg.Connect) || {}
+  const appGroup = connect.iOSAppGroupIdentifier
+  const pushEnabled = connect.PushEnabled === true
+
+  if (appGroup) {
+    if (APP_GROUP_PATTERN.test(appGroup))
+      reporter.pass('iOSAppGroupIdentifier', appGroup)
+    else
+      reporter.fail(
+        'iOSAppGroupIdentifier',
+        `"${appGroup}" is invalid — must match group.<reverse-dns> (letters/digits/dots/hyphens)`,
+      )
+  } else if (pushEnabled) {
+    reporter.warn(
+      'iOSAppGroupIdentifier',
+      'PushEnabled is true but no App Group set — required for the NSE/NCE rich-push extensions',
+    )
+  }
+  return {appGroup, pushEnabled}
+}
+
+function validateAndroidPackage(reporter, label, pkg) {
+  if (!pkg) {
+    reporter.warn(label, 'not set')
+    return
+  }
+  const badSegment = pkg.split('.').find((seg) => JAVA_KEYWORDS.has(seg))
+  if (badSegment)
+    reporter.fail(
+      label,
+      `"${pkg}" — segment "${badSegment}" is a Java keyword; the Android build will fail. Use a Java-safe package (the iOS bundle id may keep it).`,
+    )
+  else reporter.pass(label, pkg)
+}
+
+// Expo: identifiers live in app.json's expo block.
+function checkAppJson(reporter, dir) {
+  const appJson = readJson(path.join(dir, 'app.json'))
+  if (!appJson || !appJson.expo) {
+    reporter.fail('app.json', 'missing or has no "expo" block')
+    return {}
+  }
+  const expo = appJson.expo
+  const androidPackage = expo.android && expo.android.package
+  const iosBundleId = expo.ios && expo.ios.bundleIdentifier
+  validateAndroidPackage(reporter, 'android.package', androidPackage)
+  if (iosBundleId) reporter.pass('ios.bundleIdentifier', iosBundleId)
+  else reporter.warn('ios.bundleIdentifier', 'not set in app.json')
+  return {androidPackage, iosBundleId}
+}
+
+// Bare: read identifiers from android/app/build.gradle. Two distinct fields:
+//   - `namespace`     → the R-class / Java package; MUST be a valid Java
+//                       package (keyword check applies here).
+//   - `applicationId` → the published app id; may contain segments that are
+//                       not valid Java identifiers (e.g. `new`), so it is NOT
+//                       keyword-checked. It is what FCM matches in
+//                       google-services.json, so it's returned for that check.
+// (Expo collapses both into android.package, which is why checkAppJson
+// keyword-checks that single field.)
+function checkBareAndroidId(reporter, dir) {
+  const gradle = readText(path.join(dir, 'android', 'app', 'build.gradle'))
+  const namespace = gradle?.match(/namespace\s+["']([^"']+)["']/)?.[1] || null
+  const appId = gradle?.match(/applicationId\s+["']([^"']+)["']/)?.[1] || null
+  validateAndroidPackage(reporter, 'namespace', namespace)
+  if (appId) reporter.pass('applicationId', appId)
+  else reporter.warn('applicationId', 'not set')
+  return {androidPackage: appId}
+}
+
+// google-services.json must contain a client whose package_name matches the
+// Android package (FCM matches by package); the gradle plugin fails otherwise
+// ("No matching client found for package name").
+function checkGoogleServices(reporter, {gsPath, androidPackage, pushEnabled}) {
+  if (!fileExists(gsPath)) {
+    if (pushEnabled)
+      reporter.warn(
+        'google-services.json',
+        'missing — required for Android FCM builds (add the Firebase Android app, then download it here)',
+      )
+    else reporter.pass('google-services.json', 'not present (push disabled)')
+    return
+  }
+  const gs = readJson(gsPath)
+  if (gs === undefined) {
+    reporter.fail('google-services.json', 'present but not valid JSON')
+    return
+  }
+  const isPlaceholder =
+    gs.project_info?.project_id === 'your-firebase-project-id' ||
+    JSON.stringify(gs).includes('REPLACE_WITH_YOUR_FIREBASE')
+  const packages = (gs.client || [])
+    .map((c) => c.client_info?.android_client_info?.package_name)
+    .filter(Boolean)
+  if (isPlaceholder)
+    reporter.warn(
+      'google-services.json',
+      `placeholder values — replace with your real Firebase config (register package '${androidPackage}')`,
+    )
+  else if (androidPackage && !packages.includes(androidPackage))
+    reporter.fail(
+      'google-services.json',
+      `no client matches '${androidPackage}' (has: ${packages.join(', ') || 'none'}). Register that package in Firebase and re-download.`,
+    )
+  else reporter.pass('google-services.json', 'package match')
+}
+
+// Collect *.entitlements files at most one level deep under iosDir (host +
+// extension target folders), skipping Pods/build.
+function findEntitlements(iosDir) {
+  const out = []
+  let entries
+  try {
+    entries = fs.readdirSync(iosDir, {withFileTypes: true})
+  } catch {
+    return out
+  }
+  for (const e of entries) {
+    const p = path.join(iosDir, e.name)
+    if (e.isFile() && e.name.endsWith('.entitlements')) out.push(p)
+    else if (e.isDirectory() && e.name !== 'Pods' && e.name !== 'build') {
+      try {
+        for (const f of fs.readdirSync(p))
+          if (f.endsWith('.entitlements')) out.push(path.join(p, f))
+      } catch {
+        /* ignore unreadable subdir */
+      }
+    }
+  }
+  return out
+}
+
+// Bare iOS only: the host entitlements must declare aps-environment + an App
+// Group (the Config Plugin generates these for Expo).
+function checkBareIosEntitlements(reporter, dir) {
+  const iosDir = path.join(dir, 'ios')
+  if (!fileExists(iosDir)) {
+    reporter.warn('ios/', 'no ios/ directory found')
+    return
+  }
+  const hasBoth = findEntitlements(iosDir).some((p) => {
+    const t = readText(p) || ''
+    return t.includes('aps-environment') && t.includes('application-groups')
+  })
+  if (hasBoth) reporter.pass('App entitlements (aps-environment + App Group)')
+  else
+    reporter.warn(
+      'App entitlements',
+      'no *.entitlements with both aps-environment and application-groups — run `acoustic-connect setup-ios-push`',
+    )
+}
+
+// Run all relevant checks for `dir`. Returns the Reporter (caller decides how
+// to print the summary / exit).
+export function runDoctor(dir, {reporter = new Reporter()} = {}) {
+  const type = detectProjectType(dir)
+  console.log(
+    color.bold('\nAcoustic Connect doctor') +
+      color.dim(`  (${type} project — ${dir})`),
+  )
+
+  section('Prerequisites')
+  checkNode(reporter)
+
+  section('Configuration')
+  ensureConnectConfig(reporter, dir)
+  const {pushEnabled} = checkConnectConfigValues(reporter, dir)
+
+  section('Identifiers')
+  let androidPackage
+  if (type === 'expo') {
+    ;({androidPackage} = checkAppJson(reporter, dir))
+  } else if (type === 'bare') {
+    ;({androidPackage} = checkBareAndroidId(reporter, dir))
+  } else {
+    reporter.warn(
+      'project type',
+      'could not detect Expo or bare RN layout — skipping identifier checks',
+    )
+  }
+
+  section('Android push (FCM)')
+  const gsPath =
+    type === 'expo'
+      ? path.join(dir, 'google-services.json')
+      : path.join(dir, 'android', 'app', 'google-services.json')
+  checkGoogleServices(reporter, {gsPath, androidPackage, pushEnabled})
+
+  if (type === 'bare') {
+    section('iOS push')
+    checkBareIosEntitlements(reporter, dir)
+  }
+
+  return reporter
+}

package/cli/index.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+// `acoustic-connect` — setup CLI for the React Native Acoustic Connect SDK.
+//
+// Ships in the published package so client apps don't have to re-implement the
+// integration plumbing our own sample apps used to carry. Subcommands:
+//
+//   acoustic-connect doctor [dir]          Validate config + scaffold ConnectConfig.json
+//   acoustic-connect setup-ios-push [dir]  Create/repair the iOS NSE + NCE push extensions
+//
+// `dir` defaults to the current working directory (npm passes $INIT_CWD when
+// run as a script). All commands are idempotent and safe to re-run.
+
+import path from 'node:path'
+
+import {runDoctor} from './doctor.mjs'
+import {setupIosPush} from './ios/setup-push.mjs'
+import {Reporter, color} from './lib.mjs'
+
+const USAGE = `acoustic-connect — React Native Acoustic Connect SDK setup
+
+Usage:
+  acoustic-connect doctor [dir]          Validate config + scaffold ConnectConfig.json
+  acoustic-connect setup-ios-push [dir]  Create/repair the iOS NSE + NCE push extensions
+
+dir defaults to the current directory.`
+
+// Resolve the target directory: explicit arg > $INIT_CWD (npm) > cwd.
+function targetDir(arg) {
+  if (arg && !arg.startsWith('-')) return path.resolve(arg)
+  if (process.env.INIT_CWD) return path.resolve(process.env.INIT_CWD)
+  return process.cwd()
+}
+
+async function main() {
+  const [command, maybeDir] = process.argv.slice(2)
+
+  if (!command || command === '--help' || command === '-h' || command === 'help') {
+    console.log(USAGE)
+    process.exit(command ? 0 : 1)
+  }
+
+  const dir = targetDir(maybeDir)
+
+  switch (command) {
+    case 'doctor': {
+      const reporter = runDoctor(dir)
+      process.exit(reporter.summary())
+    }
+    case 'setup-ios-push': {
+      const reporter = new Reporter()
+      await setupIosPush(dir, {reporter})
+      process.exit(reporter.summary())
+    }
+    default:
+      console.error(color.red(`Unknown command: ${command}\n`))
+      console.log(USAGE)
+      process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error(color.red('\nacoustic-connect crashed:'), err)
+  process.exit(1)
+})

package/cli/ios/add_push_extensions.rb

@@ -0,0 +1,192 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# add_push_extensions.rb  (SDK-shipped, parameterized)
+#
+# Idempotently adds the two Acoustic Connect push extensions to a host app's
+# Xcode project:
+#
+#   * ConnectNSE — Notification Service Extension (rich-media download +
+#     PushReceived signal logging via the App Group pending store)
+#   * ConnectNCE — Notification Content Extension (rich expansion UI)
+#
+# Both subclass the Connect SDK base classes and share the host app's App
+# Group. This is the MANUAL setup path for bare React Native projects; the Expo
+# Config Plugin performs the equivalent target surgery automatically for Expo
+# projects.
+#
+# This is the generalized version that ships inside the SDK package. It is
+# normally invoked by `acoustic-connect setup-ios-push` (cli/ios/setup-push.mjs),
+# which derives the parameters from the project and creates the per-extension
+# source/plist/entitlements files from templates BEFORE running this — this
+# script only performs the pbxproj surgery and assumes those files exist.
+#
+# Parameters come from the environment (the Node wrapper sets them):
+#   ACOUSTIC_PROJECT_PATH      absolute path to the .xcodeproj   (required)
+#   ACOUSTIC_APP_TARGET        host app target name              (required)
+#   ACOUSTIC_APP_BUNDLE_ID     host app bundle identifier        (optional —
+#                              falls back to the app target's
+#                              PRODUCT_BUNDLE_IDENTIFIER)
+#   ACOUSTIC_DEPLOYMENT_TARGET iOS deployment target (default 15.1)
+#   ACOUSTIC_SWIFT_VERSION     Swift version        (default 5.0)
+#
+# Requires the `xcodeproj` gem (ships with CocoaPods).
+
+require 'xcodeproj'
+
+def env!(key)
+  value = ENV[key]
+  raise "#{key} is required" if value.nil? || value.empty?
+
+  value
+end
+
+PROJECT_PATH = env!('ACOUSTIC_PROJECT_PATH')
+APP_TARGET_NAME = env!('ACOUSTIC_APP_TARGET')
+DEPLOYMENT_TARGET = ENV.fetch('ACOUSTIC_DEPLOYMENT_TARGET', '15.1')
+SWIFT_VERSION = ENV.fetch('ACOUSTIC_SWIFT_VERSION', '5.0')
+
+EXTENSIONS = [
+  {
+    name: 'ConnectNSE',
+    source: 'NotificationService.swift',
+    suffix: 'ConnectNSE',
+    # UserNotifications declares the service-extension point
+    # (com.apple.usernotifications.service / UNNotificationServiceExtension).
+    frameworks: %w[UserNotifications],
+  },
+  {
+    name: 'ConnectNCE',
+    source: 'NotificationViewController.swift',
+    suffix: 'ConnectNCE',
+    # UserNotificationsUI declares the content-extension point
+    # (com.apple.usernotifications.content-extension) and provides the
+    # UNNotificationContentExtension context class. WITHOUT it the extension
+    # traps on first connection — "Unable to find NSExtensionContextClass
+    # (_UNNotificationContentExtensionVendorContext) … did you link the
+    # framework that declares the extension point?" — and no custom rich UI
+    # renders. UIKit + UserNotifications back the view controller. The Xcode
+    # template links these automatically; this scaffolder must do the same.
+    frameworks: %w[UserNotificationsUI UserNotifications UIKit],
+  },
+].freeze
+
+project = Xcodeproj::Project.open(PROJECT_PATH)
+app_target = project.targets.find { |t| t.name == APP_TARGET_NAME }
+raise "App target #{APP_TARGET_NAME} not found in #{PROJECT_PATH}" unless app_target
+
+# Bundle id: explicit override, else read it off the host app target so the
+# extension ids (<bundle>.ConnectNSE / .ConnectNCE) match the real app.
+def resolve_bundle_id(app_target)
+  explicit = ENV['ACOUSTIC_APP_BUNDLE_ID']
+  return explicit unless explicit.nil? || explicit.empty?
+
+  app_target.build_configurations
+            .map { |c| c.build_settings['PRODUCT_BUNDLE_IDENTIFIER'] }
+            .compact
+            .find { |v| !v.include?('$(') }
+end
+
+APP_BUNDLE_ID = resolve_bundle_id(app_target)
+raise 'Could not determine the host bundle id; pass ACOUSTIC_APP_BUNDLE_ID' unless APP_BUNDLE_ID
+
+# 1. Wire the host app's entitlements (App Group + aps-environment) onto both
+#    build configurations. Safe to re-run.
+app_target.build_configurations.each do |config|
+  config.build_settings['CODE_SIGN_ENTITLEMENTS'] =
+    "#{APP_TARGET_NAME}/#{APP_TARGET_NAME}.entitlements"
+end
+
+# Make the host entitlements file visible in the project navigator.
+app_group = project.main_group.find_subpath(APP_TARGET_NAME, true)
+ent_rel = "#{APP_TARGET_NAME}/#{APP_TARGET_NAME}.entitlements"
+unless app_group.files.any? { |f| f.path == ent_rel }
+  app_group.new_reference(ent_rel)
+end
+
+# 2. Ensure there is an "Embed Foundation Extensions" copy-files phase on the
+#    app target (dstSubfolderSpec = PlugIns).
+embed_phase = app_target.copy_files_build_phases.find do |p|
+  p.symbol_dst_subfolder_spec == :plug_ins
+end
+unless embed_phase
+  embed_phase = app_target.new_copy_files_build_phase('Embed Foundation Extensions')
+  embed_phase.symbol_dst_subfolder_spec = :plug_ins
+end
+
+EXTENSIONS.each do |ext|
+  if project.targets.any? { |t| t.name == ext[:name] }
+    puts "#{ext[:name]}: target already exists — skipping creation."
+    next
+  end
+
+  puts "#{ext[:name]}: creating app-extension target."
+  target = project.new_target(
+    :app_extension,
+    ext[:name],
+    :ios,
+    DEPLOYMENT_TARGET,
+    nil,
+    :swift
+  )
+
+  # Group + source file (added to the Compile Sources phase).
+  group = project.main_group.find_subpath(ext[:name], true)
+  source_ref = group.new_reference("#{ext[:name]}/#{ext[:source]}")
+  target.add_file_references([source_ref])
+  # Info.plist + entitlements are referenced via build settings only — add as
+  # plain references for navigator visibility (not compiled / copied).
+  group.new_reference("#{ext[:name]}/Info.plist")
+  group.new_reference("#{ext[:name]}/#{ext[:suffix]}.entitlements")
+
+  target.build_configurations.each do |config|
+    bs = config.build_settings
+    bs['PRODUCT_BUNDLE_IDENTIFIER'] = "#{APP_BUNDLE_ID}.#{ext[:suffix]}"
+    bs['PRODUCT_NAME'] = '$(TARGET_NAME)'
+    bs['INFOPLIST_FILE'] = "#{ext[:name]}/Info.plist"
+    bs['GENERATE_INFOPLIST_FILE'] = 'NO'
+    bs['CODE_SIGN_ENTITLEMENTS'] = "#{ext[:name]}/#{ext[:suffix]}.entitlements"
+    bs['CODE_SIGN_STYLE'] = 'Automatic'
+    bs['IPHONEOS_DEPLOYMENT_TARGET'] = DEPLOYMENT_TARGET
+    bs['SWIFT_VERSION'] = SWIFT_VERSION
+    bs['SKIP_INSTALL'] = 'YES'
+    bs['APPLICATION_EXTENSION_API_ONLY'] = 'YES'
+    bs['CLANG_ENABLE_MODULES'] = 'YES'
+    bs['MARKETING_VERSION'] = '1.0'
+    bs['CURRENT_PROJECT_VERSION'] = '1'
+    bs['TARGETED_DEVICE_FAMILY'] = '1,2'
+    bs['LD_RUNPATH_SEARCH_PATHS'] = [
+      '$(inherited)',
+      '@executable_path/Frameworks',
+      '@executable_path/../../Frameworks',
+    ]
+  end
+
+  # App depends on the extension and embeds it in PlugIns.
+  app_target.add_dependency(target)
+  build_file = embed_phase.add_file_reference(target.product_reference)
+  build_file.settings = { 'ATTRIBUTES' => ['RemoveHeadersOnCopy'] }
+  puts "#{ext[:name]}: target created, embedded, and added as app dependency."
+end
+
+# 3. Ensure each extension links the system frameworks that declare its
+#    extension point. Runs every time (also repairs pre-existing targets that
+#    were created before this step was added), and is idempotent — a framework
+#    already in the Link Binary phase is left untouched.
+EXTENSIONS.each do |ext|
+  target = project.targets.find { |t| t.name == ext[:name] }
+  next unless target
+
+  linked = target.frameworks_build_phase.files.map(&:display_name)
+  Array(ext[:frameworks]).each do |fw|
+    if linked.include?("#{fw}.framework")
+      puts "#{ext[:name]}: #{fw}.framework already linked."
+    else
+      target.add_system_framework(fw)
+      puts "#{ext[:name]}: linked #{fw}.framework."
+    end
+  end
+end
+
+project.save
+puts "Saved #{PROJECT_PATH}"

package/cli/ios/connect_pods.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# connect_pods.rb — shared CocoaPods helper for the Acoustic Connect SDK.
+#
+# Ships in the published package so consumer Podfiles don't have to re-implement
+# the Connect SDK pod resolution. Mirrors AcousticConnectRN.podspec so the host
+# app target and the push extensions (ConnectNSE / ConnectNCE) all link the SAME
+# SDK build:
+#   - useRelease => 'AcousticConnect', otherwise 'AcousticConnectDebug'
+#   - floor '>= 2.1.12' (the push permission API floor)
+#   - optional exact pin via Connect.iOSVersion
+#
+# Usage from a Podfile (resolve the file the same way the RN template resolves
+# react_native_pods.rb):
+#
+#   require Pod::Executable.execute_command('node', ['-p',
+#     'require.resolve("react-native-acoustic-connect-beta/cli/ios/connect_pods.rb", {paths: [process.argv[1]]})',
+#     __dir__]).strip
+#
+#   target 'MyApp' do
+#     # ...
+#     pod *acoustic_connect_pod(__dir__)
+#   end
+#   target 'ConnectNSE' do
+#     pod *acoustic_connect_pod(__dir__)
+#   end
+#
+# ConnectConfig.json is resolved at <podfile_dir>/../ConnectConfig.json (the
+# consumer app root), matching where the podspec and config.gradle read it.
+
+require 'json'
+
+# Returns [pod_name, requirements_array] for `pod *acoustic_connect_pod(__dir__)`.
+#
+# podfile_dir : the Podfile's own directory (pass `__dir__`). ConnectConfig.json
+#               is read from its parent, i.e. the app root.
+# config_path : optional explicit path to ConnectConfig.json (overrides the
+#               default lookup).
+def acoustic_connect_pod(podfile_dir, config_path: nil)
+  path = config_path || File.join(podfile_dir, '..', 'ConnectConfig.json')
+  connect_config = JSON.parse(File.read(path))['Connect'] || {}
+  use_release = connect_config['useRelease']
+  ios_version = connect_config['iOSVersion'].to_s
+  name = use_release ? 'AcousticConnect' : 'AcousticConnectDebug'
+  floor = '>= 2.1.12'
+  requirements = ios_version.empty? ? [floor] : [floor, ios_version]
+  [name, requirements]
+end

package/cli/ios/setup-push.mjs

@@ -0,0 +1,196 @@
+// `acoustic-connect setup-ios-push [dir]` — create/repair the iOS push extensions.
+//
+// The manual-setup counterpart to what the Expo Config Plugin does on
+// `prebuild`: it provisions the two app-extension targets a bare React Native
+// app needs for Acoustic Connect rich push —
+//
+//   * ConnectNSE — Notification Service Extension
+//   * ConnectNCE — Notification Content Extension
+//
+// Division of labour:
+//   - THIS script (Node) owns the files: it writes the per-extension Swift,
+//     Info.plist and entitlements from the SDK templates (substituting the App
+//     Group from ConnectConfig.json), and ensures the host app has an
+//     entitlements file with aps-environment + the App Group.
+//   - add_push_extensions.rb (Ruby + xcodeproj) owns the pbxproj surgery:
+//     it creates/links the targets, the embed phase, and the system frameworks.
+//
+// Everything is idempotent — existing files are left untouched, existing
+// targets are skipped. Re-running repairs missing pieces without duplicating.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import {fileURLToPath} from 'node:url'
+
+import {color, commandExists, fileExists, readJson, readText, run, section} from '../lib.mjs'
+
+const cliDir = path.dirname(path.dirname(fileURLToPath(import.meta.url))) // .../cli
+const sdkRoot = path.dirname(cliDir) // package root
+const templatesDir = path.join(cliDir, 'ios', 'templates')
+// Swift principal-class templates are shared with the Expo Config Plugin.
+const swiftDir = path.join(sdkRoot, 'plugin', 'swift')
+
+const APP_GROUP_TOKEN = 'CONNECT_APP_GROUP_IDENTIFIER_PLACEHOLDER'
+
+const EXTENSIONS = [
+  {name: 'ConnectNSE', swift: 'NotificationService.swift'},
+  {name: 'ConnectNCE', swift: 'NotificationViewController.swift'},
+]
+
+// Find the single .xcodeproj under <dir>/ios. The app target name follows the
+// RN convention (the project basename), which is what `setup-ios-push` assumes.
+function findXcodeproj(iosDir) {
+  let entries = []
+  try {
+    entries = fs.readdirSync(iosDir)
+  } catch {
+    return null
+  }
+  const proj = entries.find((e) => e.endsWith('.xcodeproj'))
+  return proj ? path.join(iosDir, proj) : null
+}
+
+// Write `content` to `dest` only if missing; report which happened.
+function writeIfMissing(reporter, label, dest, content) {
+  if (fileExists(dest)) {
+    reporter.pass(label, 'present')
+    return
+  }
+  fs.mkdirSync(path.dirname(dest), {recursive: true})
+  fs.writeFileSync(dest, content)
+  reporter.pass(label, 'created')
+}
+
+// Render a template file, substituting the App Group placeholder. Only the
+// real occurrences are replaced — the Swift string literal and the plist
+// <string> entry — so any explanatory comment that mentions the token by name
+// (e.g. "The <token> is replaced by …") stays readable.
+function renderTemplate(srcPath, appGroup) {
+  const raw = readText(srcPath)
+  if (raw == null) return null
+  return raw
+    .split(`"${APP_GROUP_TOKEN}"`)
+    .join(`"${appGroup}"`)
+    .split(`<string>${APP_GROUP_TOKEN}</string>`)
+    .join(`<string>${appGroup}</string>`)
+}
+
+// Minimal host entitlements when the app has none yet: aps-environment +
+// the App Group, matching what the extensions share.
+function hostEntitlements(appGroup) {
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+\t<key>aps-environment</key>
+\t<string>development</string>
+\t<key>com.apple.security.application-groups</key>
+\t<array>
+\t\t<string>${appGroup}</string>
+\t</array>
+</dict>
+</plist>
+`
+}
+
+export async function setupIosPush(dir, {reporter}) {
+  console.log(
+    color.bold('\nAcoustic Connect — iOS push extensions') +
+      color.dim(`  (${dir})`),
+  )
+
+  if (process.platform !== 'darwin') {
+    reporter.warn('iOS', 'skipped — iOS project surgery requires macOS')
+    return
+  }
+
+  const iosDir = path.join(dir, 'ios')
+  if (!fileExists(iosDir)) {
+    reporter.fail('ios/', `no ios/ directory under ${dir}`)
+    return
+  }
+
+  const projectPath = findXcodeproj(iosDir)
+  if (!projectPath) {
+    reporter.fail('.xcodeproj', `none found under ${iosDir}`)
+    return
+  }
+  const appTarget = path.basename(projectPath, '.xcodeproj')
+  reporter.pass('Xcode project', `${path.basename(projectPath)} (target ${appTarget})`)
+
+  // App Group is the linchpin — host + both extensions must share it.
+  const cfg = readJson(path.join(dir, 'ConnectConfig.json'))
+  const appGroup = cfg?.Connect?.iOSAppGroupIdentifier
+  if (!appGroup) {
+    reporter.fail(
+      'iOSAppGroupIdentifier',
+      'not set in ConnectConfig.json — required for the NSE/NCE shared store. Run `acoustic-connect doctor` first.',
+    )
+    return
+  }
+  reporter.pass('App Group', appGroup)
+
+  // ── Files (idempotent) ───────────────────────────────────────────────────
+  section('Source files')
+
+  // Host entitlements — only created if absent (never clobber a real one).
+  const hostEntPath = path.join(iosDir, appTarget, `${appTarget}.entitlements`)
+  writeIfMissing(
+    reporter,
+    `${appTarget}/${appTarget}.entitlements`,
+    hostEntPath,
+    hostEntitlements(appGroup),
+  )
+
+  for (const ext of EXTENSIONS) {
+    const extDir = path.join(iosDir, ext.name)
+
+    const swift = renderTemplate(path.join(swiftDir, ext.swift), appGroup)
+    if (swift == null) {
+      reporter.fail(`${ext.name}/${ext.swift}`, `template missing in ${swiftDir}`)
+      return
+    }
+    writeIfMissing(reporter, `${ext.name}/${ext.swift}`, path.join(extDir, ext.swift), swift)
+
+    const tplKey = ext.name === 'ConnectNSE' ? 'nse' : 'nce'
+    const plist = readText(path.join(templatesDir, tplKey, 'Info.plist'))
+    writeIfMissing(reporter, `${ext.name}/Info.plist`, path.join(extDir, 'Info.plist'), plist)
+
+    const ent = renderTemplate(
+      path.join(templatesDir, tplKey, `${ext.name}.entitlements`),
+      appGroup,
+    )
+    writeIfMissing(
+      reporter,
+      `${ext.name}/${ext.name}.entitlements`,
+      path.join(extDir, `${ext.name}.entitlements`),
+      ent,
+    )
+  }
+
+  // ── pbxproj surgery (Ruby) ─────────────────────────────────────────────────
+  section('Xcode targets')
+  if (!commandExists('ruby')) {
+    reporter.warn(
+      'Push extensions',
+      'ruby not found — files written, but run add_push_extensions.rb on a machine with ruby + the xcodeproj gem to wire the targets',
+    )
+    return
+  }
+
+  const rubyScript = path.join(cliDir, 'ios', 'add_push_extensions.rb')
+  // Pass the project path / target name as real environment variables (the
+  // Ruby script reads them via ENV[…]) rather than interpolating them into the
+  // command line — a path with shell metacharacters must not be re-parsed.
+  const rubyEnv = {
+    ACOUSTIC_PROJECT_PATH: projectPath,
+    ACOUSTIC_APP_TARGET: appTarget,
+  }
+  if (run(`ruby "${rubyScript}"`, {cwd: iosDir, env: rubyEnv}))
+    reporter.pass('Push extensions wired (NSE + NCE)')
+  else
+    reporter.fail(
+      'Push extensions',
+      'add_push_extensions.rb failed — needs the xcodeproj gem (ships with CocoaPods: `gem install xcodeproj`)',
+    )
+}

package/cli/ios/templates/nce/ConnectNCE.entitlements

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.security.application-groups</key>
+	<array>
+		<string>CONNECT_APP_GROUP_IDENTIFIER_PLACEHOLDER</string>
+	</array>
+</dict>
+</plist>

package/cli/ios/templates/nce/Info.plist

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>ConnectNCE</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(MARKETING_VERSION)</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionAttributes</key>
+		<dict>
+			<key>UNNotificationExtensionCategory</key>
+			<array>
+				<string>ACOUSTIC_RICH_NOTIFICATION</string>
+				<string>ACTIONABLE_NOTIFICATION</string>
+			</array>
+			<key>UNNotificationExtensionDefaultContentHidden</key>
+			<false/>
+			<key>UNNotificationExtensionInitialContentSizeRatio</key>
+			<real>1.0</real>
+		</dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.usernotifications.content-extension</string>
+		<key>NSExtensionPrincipalClass</key>
+		<string>$(PRODUCT_MODULE_NAME).NotificationViewController</string>
+	</dict>
+	<key>RCTNewArchEnabled</key>
+	<true/>
+</dict>
+</plist>

package/cli/ios/templates/nse/ConnectNSE.entitlements

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.security.application-groups</key>
+	<array>
+		<string>CONNECT_APP_GROUP_IDENTIFIER_PLACEHOLDER</string>
+	</array>
+</dict>
+</plist>

package/cli/ios/templates/nse/Info.plist

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>ConnectNSE</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(MARKETING_VERSION)</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.usernotifications.service</string>
+		<key>NSExtensionPrincipalClass</key>
+		<string>$(PRODUCT_MODULE_NAME).NotificationService</string>
+	</dict>
+	<key>RCTNewArchEnabled</key>
+	<true/>
+</dict>
+</plist>

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/package.json

@@ -1,5 +1,8 @@
 {
     "author": "Acoustic, L.P., Radoslaw Serek, Aksana Naskalava",
+    "bin": {
+        "acoustic-connect": "cli/index.mjs"
+    },
     "dependencies": {
         "@prettier/plugin-xml": "^2.2.0",
         "fast-xml-parser": "^4.0.8",
@@ -76,6 +79,7 @@
         "plugin/build",
         "plugin/swift",
         "plugin/src",
+        "cli",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
@@ -197,20 +201,20 @@
         "build": "npm run typecheck && bob build",
         "build:plugin": "tsc -p plugin/tsconfig.json",
         "codegen": "nitrogen --logLevel=\"debug\" && npm run build && node post-script.js",
-        "postinstall": "./scripts/postInstallScripts.sh",
+        "postinstall": "node scripts/postinstall.mjs",
         "prepack": "npm run build:plugin",
         "rebuild": "npm run codegen && npm run rebuildExample --prefix ./example",
         "release": "release-it",
         "test": "echo \"Error: no test specified\" && exit 1",
         "test:plugin": "npm run build:plugin && node --test plugin/__tests__/",
         "typecheck": "tsc --noEmit",
-        "verifyConnectSetup": "node scripts/verifyConnectSetup.js $INIT_CWD",
+        "verifyConnectSetup": "node cli/index.mjs doctor $INIT_CWD",
         "yalcPublish": "npm run rebuild && yalc publish"
     },
     "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.37",
+    "version": "18.0.38",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/scripts/postinstall.mjs

@@ -0,0 +1,35 @@
+// Cross-platform postinstall (replaces the bash-only postInstallScripts.sh,
+// which silently no-opped on Windows and violated the repo's cross-platform
+// rule). Runs the same three helper scripts that integrate the SDK into a
+// consumer project, from the package root, best-effort: a non-zero exit from
+// any of them is logged but never fails `npm install`.
+
+import {spawnSync} from 'node:child_process'
+import path from 'node:path'
+import {fileURLToPath} from 'node:url'
+
+const scriptsDir = path.dirname(fileURLToPath(import.meta.url))
+const packageRoot = path.dirname(scriptsDir)
+
+// Order matches the original postInstallScripts.sh. Note: the file is
+// `xmlparser.js` (lowercase) — the old shell script referenced `xmlParser.js`
+// with a capital P, which failed on case-sensitive filesystems (Linux CI).
+const steps = ['reviewConnectConfig.js', 'xmlparser.js', 'gradleParser.js']
+
+console.log(
+  '**Acoustic Integration***********************************************************************',
+)
+for (const step of steps) {
+  console.log(`Running scripts/${step} ...`)
+  const result = spawnSync(process.execPath, [path.join('scripts', step)], {
+    cwd: packageRoot,
+    stdio: 'inherit',
+  })
+  if (result.status !== 0)
+    console.log(
+      `scripts/${step} exited with ${result.status ?? result.signal} — continuing (postinstall is best-effort).`,
+    )
+}
+console.log(
+  '*********************************************************************************************',
+)

package/scripts/xmlparser.js

@@ -14,7 +14,7 @@ const xmlPaserPlugin = require("@prettier/plugin-xml");
 const { exit } = require('process');
 const { isValid } = require('./util');
 
-console.log("Run xmlParser.js");
+console.log("Run xmlparser.js");
 
 const directoryPath = path.join(__dirname,"..","..","..")
 const filePath = `${directoryPath}/android/app/src/main/AndroidManifest.xml`;

package/scripts/postInstallScripts.sh

@@ -1,10 +0,0 @@
-#!/bin/bash
-echo "**Acoustic Integration***********************************************************************"
-echo "Current directory:"
-pwd
-echo "Running Node scripts..."
-node ./scripts/reviewConnectConfig.js
-node ./scripts/xmlParser.js
-node ./scripts/gradleParser.js
-echo "*********************************************************************************************"
-echo "Running here scripts..."

package/scripts/verifyConnectSetup.js

@@ -1,87 +0,0 @@
-/********************************************************************************************
-* 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.
-********************************************************************************************/
-
-/**
- * Verify and Update React Native SDK integration to capture screen tracking.
- * 
- * cd node_modules/react-native-acoustic-connect-beta folder
- * 
- * yarn run verifyConnectSetup
- * 
- */
-const fs = require('fs');
-
-//const filePath = "../../src/components/RootComponent.tsx"
-const filePath = "Example/nativebase-v3-kitchensink/src/components/RootComponent.tsx"
-
-function log(message) {
-    console.log(message);
-}
-
-function isRootFileAvailable() {
-    return fs.existsSync(filePath);
-}
-
-function isConnectComponentAvailable() {
-    log("Looking for Connect tag...");
-    return isComponentAvailable(/<Connect/);
-}
-
-function isNavigationContainerAvailable() {
-    log("Looking for NavigationContainer tag...");
-    return isComponentAvailable(/<NavigationContainer/);
-}
-
-function isComponentAvailable(componentTag) {
-    try {
-        let data = fs.readFileSync(filePath, 'utf8');
-        const re = new RegExp(componentTag, "g");
-        const found = re.test(data);
-
-        return found;
-    } catch (err) {
-        console.error(err);
-    }
-}
-
-if (isRootFileAvailable()) {
-    if (isConnectComponentAvailable()) {
-        log("Connect component found. You are ready to go!");
-    } else if (isNavigationContainerAvailable()) {
-        log("NavigationContainer component is available but Connect component is missing.\n I'll add Connect around NavigationContainer component.");
-        AddConnectComponent();
-    } else {
-        log("Missing both Connect and NavigationContainer component.\n Please refer to SDK integration without React Navigation.");
-    };
-} else {
-    console.error("App.js file not found in root app folder.");
-}
-
-// Update and add Connect around NavigationContainer
-function AddConnectComponent() {
-    const connectImport = `import { Connect } from 'react-native-acoustic-connect-beta';`
-
-    const startNavigationContainer = /<NavigationContainer/
-    const startConnectComponent = `<Connect><NavigationContainer`
-
-    const endNavigationContainer = /<\/NavigationContainer>/
-    const endConnectComponent = `</NavigationContainer></Connect>`
-    
-    try {
-        let data = fs.readFileSync(filePath, 'utf8');
-        data = data
-            .replace(startNavigationContainer, startConnectComponent)
-            .replace(endNavigationContainer, endConnectComponent);
-        fs.writeFileSync(filePath, ConnectImport + '\n' + data);
-    } catch (err) {
-        log("Something went wrong.\n Please refer to SDK integration with React Navigation.");
-        console.error(err);
-    }
-}