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

package/CHANGELOG.md

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

package/ConnectConfig.example.json

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

package/README.md

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

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

@@ -1,4 +1,4 @@
-#Fri Jul 03 01:59:06 PDT 2026
+#Fri Jul 03 03:03:02 PDT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/cli/__tests__/doctor.test.mjs

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

package/cli/doctor.mjs

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

package/package.json

@@ -91,6 +91,7 @@
         "plugin/swift",
         "plugin/src",
         "cli",
+        "ConnectConfig.example.json",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
@@ -217,7 +218,8 @@
         "rebuild": "npm run codegen && npm run rebuildExample --prefix ./example",
         "release": "release-it",
         "test": "jest",
-        "test:all": "npm test && npm run test:plugin",
+        "test:all": "npm test && npm run test:plugin && npm run test:cli",
+        "test:cli": "node --test cli/__tests__/",
         "test:plugin": "npm run build:plugin && node --test plugin/__tests__/",
         "test:watch": "jest --watch",
         "typecheck": "tsc --noEmit",
@@ -227,7 +229,7 @@
     "source": "src/index",
     "summary": "react-native ios android tealeaf connect cxa wxca er enhanced-replay",
     "types": "./lib/typescript/src/index.d.ts",
-    "version": "19.0.7",
+    "version": "19.0.8",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/scripts/reviewConnectConfig.js

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

package/scripts/ConnectConfig.json

@@ -1,180 +0,0 @@
-{
-    "Connect": {
-        "AndroidVersion": "11.0.12-beta",
-        "AppKey": "b6c3709b7a4c479bb4b5a9fb8fec324c",
-        "KillSwitchUrl": "https://lib-us-2.brilliantcollector.com/collector/switch/b6c3709b7a4c479bb4b5a9fb8fec324c",
-        "PostMessageUrl": "https://lib-us-2.brilliantcollector.com/collector/collectorPost",
-        "iOSVersion": "",
-        "layoutConfigAndroid": {
-            "AppendMapIds": {
-                "[w,9290],[v,0]": {
-                    "mid": "ASimpleUIView"
-                },
-                "idxPathValue": {
-                    "mid": "giveAdditionalId2"
-                },
-                "tag2999999": {
-                    "mid": "giveAdditionalId1"
-                }
-            },
-            "AutoLayout": {
-                "ExampleMaskingPage": {
-                    "CaptureLayoutDelay": 0,
-                    "CaptureLayoutOn": 0,
-                    "CaptureScreenVisits": false,
-                    "CaptureScreenshotOn": 0,
-                    "CaptureUserEvents": false,
-                    "DisplayName": "",
-                    "Masking": {
-                        "HasCustomMask": true,
-                        "HasMasking": true,
-                        "MaskAccessibilityIdList": [
-                            
-                        ],
-                        "MaskAccessibilityLabelList": [
-                            
-                        ],
-                        "MaskIdList": [
-                            "^9[0-9][0-9][0-9]$",
-                            "^\\[wvv,0\\],\\[dddv,0\\],\\[v,0\\],\\[v,0\\],\\[v,0\\],\\[b,0\\](.)*$"
-                        ],
-                        "MaskValueList": [
-                            "^4[0-9]{12}(?:[0-9]{3})?$",
-                            "^3[47][0-9]{13}$",
-                            "^65[4-9][0-9]{13}|64[4-9][0-9]{13}|6011[0-9]{12}|(622(?:12[6-9]|1[3-9][0-9]|[2-8][0-9][0-9]|9[01][0-9]|92[0-5])[0-9]{10})$",
-                            "^(5[1-5][0-9]{14}|2(22[1-9][0-9]{12}|2[3-9][0-9]{13}|[3-6][0-9]{14}|7[0-1][0-9]{13}|720[0-9]{12}))$"
-                        ],
-                        "Sensitive": {
-                            "capitalCaseAlphabet": "X",
-                            "number": "9",
-                            "smallCaseAlphabet": "x",
-                            "symbol": "#"
-                        }
-                    },
-                    "NumberOfWebViews": 0,
-                    "ScreenChange": false,
-                    "ScreenShot": false
-                },
-                "GlobalScreenSettings": {
-                    "CaptureLayoutDelay": 1,
-                    "CaptureLayoutOn": 2,
-                    "CaptureScreenVisits": false,
-                    "CaptureScreenshotOn": 2,
-                    "CaptureUserEvents": true,
-                    "DisplayName": "",
-                    "Masking": {
-                        "HasCustomMask": true,
-                        "HasMasking": true,
-                        "MaskAccessibilityIdList": [
-                            
-                        ],
-                        "MaskAccessibilityLabelList": [
-                            
-                        ],
-                        "MaskIdList": [
-                            
-                        ],
-                        "MaskValueList": [
-                            
-                        ],
-                        "Sensitive": {
-                            "capitalCaseAlphabet": "X",
-                            "number": "9",
-                            "smallCaseAlphabet": "x",
-                            "symbol": "#"
-                        }
-                    },
-                    "NumberOfWebViews": 0,
-                    "ScreenChange": true,
-                    "ScreenShot": true
-                }
-            }
-        },
-        "layoutConfigIos": {
-            "AppendMapIds": {
-                "[w,9290],[v,0]": {
-                    "mid": "ASimpleUIView"
-                },
-                "idxPathValue": {
-                    "mid": "giveAdditionalId2"
-                },
-                "tag2999999": {
-                    "mid": "giveAdditionalId1"
-                }
-            },
-            "AutoLayout": {
-                "ExampleMaskingPage": {
-                    "CaptureLayoutDelay": 0,
-                    "CaptureLayoutOn": 0,
-                    "CaptureScreenVisits": false,
-                    "CaptureScreenshotOn": 0,
-                    "CaptureUserEvents": false,
-                    "DisplayName": "",
-                    "Masking": {
-                        "HasCustomMask": true,
-                        "HasMasking": true,
-                        "MaskAccessibilityIdList": [
-                            
-                        ],
-                        "MaskAccessibilityLabelList": [
-                            
-                        ],
-                        "MaskIdList": [
-                            "^9[0-9][0-9][0-9]$",
-                            "^\\[wvv,0\\],\\[dddv,0\\],\\[v,0\\],\\[v,0\\],\\[v,0\\],\\[b,0\\](.)*$"
-                        ],
-                        "MaskValueList": [
-                            "^4[0-9]{12}(?:[0-9]{3})?$",
-                            "^3[47][0-9]{13}$",
-                            "^65[4-9][0-9]{13}|64[4-9][0-9]{13}|6011[0-9]{12}|(622(?:12[6-9]|1[3-9][0-9]|[2-8][0-9][0-9]|9[01][0-9]|92[0-5])[0-9]{10})$",
-                            "^(5[1-5][0-9]{14}|2(22[1-9][0-9]{12}|2[3-9][0-9]{13}|[3-6][0-9]{14}|7[0-1][0-9]{13}|720[0-9]{12}))$"
-                        ],
-                        "Sensitive": {
-                            "capitalCaseAlphabet": "X",
-                            "number": "9",
-                            "smallCaseAlphabet": "x",
-                            "symbol": "#"
-                        }
-                    },
-                    "NumberOfWebViews": 0,
-                    "ScreenChange": false,
-                    "ScreenShot": false
-                },
-                "GlobalScreenSettings": {
-                    "CaptureLayoutDelay": 1,
-                    "CaptureLayoutOn": 2,
-                    "CaptureScreenVisits": false,
-                    "CaptureScreenshotOn": 2,
-                    "CaptureUserEvents": true,
-                    "DisplayName": "",
-                    "Masking": {
-                        "HasCustomMask": true,
-                        "HasMasking": true,
-                        "MaskAccessibilityIdList": [
-                            
-                        ],
-                        "MaskAccessibilityLabelList": [
-                            
-                        ],
-                        "MaskIdList": [
-                            
-                        ],
-                        "MaskValueList": [
-                            
-                        ],
-                        "Sensitive": {
-                            "capitalCaseAlphabet": "X",
-                            "number": "9",
-                            "smallCaseAlphabet": "x",
-                            "symbol": "#"
-                        }
-                    },
-                    "NumberOfWebViews": 0,
-                    "ScreenChange": true,
-                    "ScreenShot": true
-                }
-            }
-        },
-        "useRelease": false
-    }
-}