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

package/CHANGELOG.md

@@ -1,3 +1,5 @@
+## [18.0.39](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.38...18.0.39) (2026-06-23)
+## [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
+#Tue Jun 23 01:25:25 PDT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/cli/doctor.mjs

@@ -0,0 +1,314 @@
+// `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.-]+$/
+
+// The committed sample ships placeholder identifiers (com.example.*) that the
+// consumer is expected to replace with their own — setting app.json identity is
+// the normal Expo workflow, not something the SDK rewrites for you. Flag a value
+// still on the placeholder so it isn't shipped by accident.
+const PLACEHOLDER_ID_PREFIX = 'com.example.'
+
+// 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')
+
+  // The sample ships placeholder ids; warn if they haven't been replaced. We
+  // only flag — setting them is the standard Expo step, owned by the developer
+  // (or injected by the test-automation pipeline), not rewritten by the SDK.
+  for (const [label, value] of [
+    ['ios.bundleIdentifier', iosBundleId],
+    ['android.package', androidPackage],
+  ]) {
+    if (value && value.startsWith(PLACEHOLDER_ID_PREFIX))
+      reporter.warn(
+        label,
+        `still the sample placeholder "${value}" — set your own in app.json before building (standard Expo step)`,
+      )
+  }
+  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