react-native-acoustic-connect-beta 18.0.34 → 18.0.36

package/CHANGELOG.md

@@ -1,3 +1,5 @@
+## [18.0.36](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.35...18.0.36) (2026-06-17)
+## [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)
 ## [18.0.33](https://github.com/aipoweredmarketer/react-native-acoustic-connect-beta/compare/18.0.32...18.0.33) (2026-06-15)
 <!--

package/README.md

@@ -15,8 +15,9 @@ For the full product overview see the
 - Node 20 or newer
 - iOS deployment target ≥ 15.1, AcousticConnect / AcousticConnectDebug pod ≥ 2.0.5
 - Android `minSdk` ≥ 26, `compileSdk` ≥ 35, `io.github.go-acoustic:connect` in `[11.0.11, 12.0.0)`
-- **Expo is not supported by this package.** Expo apps should use the sibling
-  Config Plugin (shipped separately).
+- **Expo SDK 55+ is supported** via the bundled Expo Config Plugin —
+  development builds only (Expo Go is not supported); see
+  [Using with Expo SDK 55+](#using-with-expo-sdk-55).
 
 ### Nitro version pin
 
@@ -83,6 +84,120 @@ 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. |
 
+## Using with Expo SDK 55+
+
+Expo SDK 55 and newer is supported via the bundled Expo Config Plugin.
+**Development builds only** — Expo Go is not supported: Nitro Modules and
+native push registration require native code that Expo Go cannot load. There
+is no runtime Expo Go detection or fallback; use
+[`expo-dev-client`](https://docs.expo.dev/develop/development-builds/introduction/)
+or EAS Build.
+
+### Install
+
+```bash
+npx create-expo-app@latest my-app    # Expo SDK 55+, new architecture enabled
+cd my-app
+npx expo install expo-dev-client expo-build-properties
+npm install react-native-acoustic-connect-beta react-native-nitro-modules
+```
+
+`expo-build-properties` is needed to raise Android `minSdkVersion` to 26
+(the Connect Android SDK floor — Expo templates default to a lower value):
+
+```json
+{
+  "expo": {
+    "plugins": [
+      ["expo-build-properties", { "android": { "minSdkVersion": 26 } }]
+    ]
+  }
+}
+```
+
+### Configure
+
+1. Put `ConnectConfig.json` at the project root — the same file documented in
+   [Installation](#installation). For push, set `PushEnabled`, `iOSPushMode`,
+   and `iOSAppGroupIdentifier` in the `Connect` block.
+
+2. Add the plugin to `app.json`:
+
+```json
+{
+  "expo": {
+    "plugins": ["react-native-acoustic-connect-beta"]
+  }
+}
+```
+
+The plugin reads the App Group from `Connect.iOSAppGroupIdentifier` in
+`ConnectConfig.json` — the same value the SDK reads at runtime, so the
+entitlement and the runtime config agree by construction. To use a different
+value for the entitlement only (rarely needed), pass a plugin prop; the prop
+takes precedence over `ConnectConfig.json`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "react-native-acoustic-connect-beta",
+        { "iosAppGroupIdentifier": "group.com.example.myapp" }
+      ]
+    ]
+  }
+}
+```
+
+### Build
+
+```bash
+npx expo prebuild
+npx expo run:ios        # or: eas build --profile development --platform ios
+npx expo run:android    # or: eas build --profile development --platform android
+```
+
+During `expo prebuild` the plugin automatically:
+
+- adds a `ConnectNSE` Notification Service Extension target to the Xcode
+  project (rich-media push attachments + delivery tracking), with
+  `NotificationService.swift` generated from the SDK template;
+- adds a `ConnectNCE` Notification Content Extension target (rich expansion
+  UI — renders the attached media / expanded body when the user expands an
+  Acoustic notification), with `NotificationViewController.swift` generated
+  from the SDK template;
+- adds the App Group entitlement to the host app and to both extensions, so
+  all three processes share the same pending store;
+- appends `ConnectNSE` and `ConnectNCE` targets to the generated `Podfile`,
+  each linking the same Connect SDK pod as the app.
+
+Re-running `expo prebuild` — with or without `--clean` — is idempotent: no
+duplicate targets, entitlements, or Podfile entries.
+
+The NCE renders notifications whose category matches
+`ACOUSTIC_RICH_NOTIFICATION` or `ACTIONABLE_NOTIFICATION` (the categories the
+Connect backend sets on rich-media pushes). No app-side configuration is
+required — the category identifiers are baked into the generated target's
+`Info.plist`.
+
+### EAS Build
+
+The plugin works with [EAS Build](https://docs.expo.dev/build/introduction/)
+out of the box — the NSE and NCE targets are provisioned by the same
+`expo prebuild` step EAS runs on its build workers. iOS extension targets are
+signed automatically when you use EAS-managed credentials (`eas credentials`),
+which provisions the host app and both extension App IDs together.
+
+```bash
+eas build --profile development --platform ios
+eas build --profile development --platform android
+```
+
+A working example — including a sample
+[`eas.json`](Examples/expo/eas.json) — lives in
+[`Examples/expo`](Examples/expo).
+
 ## Quick start
 
 ### 1. Initialise the SDK

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

@@ -1,4 +1,4 @@
-#Mon Jun 15 05:05:53 PDT 2026
+#Wed Jun 17 07:43:32 PDT 2026
 UseWhiteList=true
 PrintScreen=3
 UseRandomSample=false

package/app.plugin.js

@@ -0,0 +1,15 @@
+// Copyright (C) 2026 Acoustic, L.P. All rights reserved.
+//
+// Thin entry shim for the Expo Config Plugin.
+//
+// Expo resolves the plugin from the package root via the `expo.plugins` field
+// in app.json. This file delegates directly to the compiled plugin build so
+// that Expo's Node.js environment (CommonJS) loads it correctly.
+//
+// The plugin composition is defined in plugin/src/index.ts and compiled to
+// plugin/build/index.js (CommonJS) by `npm run build:plugin`.
+//
+// To add a new mod (e.g. withConnectNCE from CA-143488), extend the `mods`
+// array in plugin/src/index.ts — do not modify this shim.
+
+module.exports = require('./plugin/build/index').default

package/package.json

@@ -8,6 +8,8 @@
     },
     "description": "BETA: React native plugin for Acoustic Connect",
     "devDependencies": {
+        "@expo/config-plugins": "~55.0.10",
+        "@expo/config-types": "^55.0.5",
         "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
         "@release-it/bumper": "^7.0.1",
         "@release-it/conventional-changelog": "^10.0.0",
@@ -71,6 +73,9 @@
         "ios/**/*.swift",
         "ios/AcousticConnectRNConfig.json",
         "app.plugin.js",
+        "plugin/build",
+        "plugin/swift",
+        "plugin/src",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
@@ -98,10 +103,16 @@
     "module": "./lib/module/index.js",
     "name": "react-native-acoustic-connect-beta",
     "peerDependencies": {
+        "@expo/config-plugins": ">=55.0.0",
         "react": ">=19.1.1 <20.0.0",
         "react-native": ">=0.82.0 <0.86.0",
         "react-native-nitro-modules": "0.35.9"
     },
+    "peerDependenciesMeta": {
+        "@expo/config-plugins": {
+            "optional": true
+        }
+    },
     "prettier": {
         "quoteProps": "consistent",
         "semi": false,
@@ -184,11 +195,14 @@
     "scripts": {
         "applyConfiguration": "node scripts/applyConfiguration.js $INIT_CWD",
         "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",
+        "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",
         "yalcPublish": "npm run rebuild && yalc publish"
@@ -196,7 +210,7 @@
     "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.34",
+    "version": "18.0.36",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/plugin/build/index.d.ts

@@ -0,0 +1,25 @@
+import { type ConfigPlugin } from '@expo/config-plugins';
+import { withConnectNSE, type ConnectPluginProps } from './withConnectNSE';
+import { withConnectNCE } from './withConnectNCE';
+/**
+ * Expo Config Plugin for react-native-acoustic-connect-beta.
+ *
+ * Provisions the ConnectNSE Notification Service Extension and the ConnectNCE
+ * Notification Content Extension targets during `expo prebuild`. Designed as a
+ * chainable composition: additional mods are appended by adding to the mods
+ * array. Order matters — withConnectNSE runs first so it seeds the host
+ * entitlements and the PBXTargetDependency/PBXContainerItemProxy sections that
+ * withConnectNCE reuses.
+ *
+ * Consumer app.json usage:
+ *   // With explicit App Group override:
+ *   ["react-native-acoustic-connect-beta", { "iosAppGroupIdentifier": "group.com.example.app" }]
+ *
+ *   // Without props (reads from ConnectConfig.json):
+ *   "react-native-acoustic-connect-beta"
+ */
+declare const withAcousticConnect: ConfigPlugin<ConnectPluginProps | void>;
+export default withAcousticConnect;
+export { withConnectNSE, withConnectNCE };
+export type { ConnectPluginProps };
+//# sourceMappingURL=index.d.ts.map

package/plugin/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,mBAAmB,EAAE,YAAY,CAAC,kBAAkB,GAAG,IAAI,CAgBhE,CAAA;AAED,eAAe,mBAAmB,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAA;AACzC,YAAY,EAAE,kBAAkB,EAAE,CAAA"}

package/plugin/build/index.js

@@ -0,0 +1,44 @@
+"use strict";
+// Copyright (C) 2026 Acoustic, L.P. All rights reserved.
+//
+// NOTICE: This file contains material that is confidential and proprietary to
+// Acoustic, L.P. and/or other developers. No license is granted under any
+// intellectual or industrial property rights of Acoustic, L.P. except as may
+// be provided in an agreement with Acoustic, L.P. Any unauthorized copying or
+// distribution of content from this file is prohibited.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withConnectNCE = exports.withConnectNSE = void 0;
+const withConnectNSE_1 = require("./withConnectNSE");
+Object.defineProperty(exports, "withConnectNSE", { enumerable: true, get: function () { return withConnectNSE_1.withConnectNSE; } });
+const withConnectNCE_1 = require("./withConnectNCE");
+Object.defineProperty(exports, "withConnectNCE", { enumerable: true, get: function () { return withConnectNCE_1.withConnectNCE; } });
+/**
+ * Expo Config Plugin for react-native-acoustic-connect-beta.
+ *
+ * Provisions the ConnectNSE Notification Service Extension and the ConnectNCE
+ * Notification Content Extension targets during `expo prebuild`. Designed as a
+ * chainable composition: additional mods are appended by adding to the mods
+ * array. Order matters — withConnectNSE runs first so it seeds the host
+ * entitlements and the PBXTargetDependency/PBXContainerItemProxy sections that
+ * withConnectNCE reuses.
+ *
+ * Consumer app.json usage:
+ *   // With explicit App Group override:
+ *   ["react-native-acoustic-connect-beta", { "iosAppGroupIdentifier": "group.com.example.app" }]
+ *
+ *   // Without props (reads from ConnectConfig.json):
+ *   "react-native-acoustic-connect-beta"
+ */
+const withAcousticConnect = (config, props) => {
+    const resolvedProps = props != null && typeof props === 'object' ? props : {};
+    // Chainable composition array. withConnectNSE must precede withConnectNCE:
+    // the NSE mod seeds the host App Group entitlement and the
+    // PBXTargetDependency/PBXContainerItemProxy sections the NCE mod relies on.
+    const mods = [
+        withConnectNSE_1.withConnectNSE,
+        withConnectNCE_1.withConnectNCE,
+    ];
+    return mods.reduce((accConfig, mod) => mod(accConfig, resolvedProps), config);
+};
+exports.default = withAcousticConnect;
+//# sourceMappingURL=index.js.map

package/plugin/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,yDAAyD;AACzD,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,wDAAwD;;;AAGxD,qDAA0E;AAuCjE,+FAvCA,+BAAc,OAuCA;AAtCvB,qDAAiD;AAsCxB,+FAtChB,+BAAc,OAsCgB;AApCvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,mBAAmB,GAA4C,CACnE,MAAM,EACN,KAAK,EACL,EAAE;IACF,MAAM,aAAa,GACjB,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAEzD,2EAA2E;IAC3E,2DAA2D;IAC3D,4EAA4E;IAC5E,MAAM,IAAI,GAA4C;QACpD,+BAAc;QACd,+BAAc;KACf,CAAA;IAED,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAA;AAC/E,CAAC,CAAA;AAED,kBAAe,mBAAmB,CAAA"}

package/plugin/build/withConnectNCE.d.ts

@@ -0,0 +1,88 @@
+import { type ConfigPlugin } from '@expo/config-plugins';
+import type { ExpoConfig } from '@expo/config-types';
+import { type ConnectPluginProps } from './withConnectNSE';
+/**
+ * Generates the Info.plist content for the ConnectNCE target.
+ *
+ * The NSExtensionAttributes mirror the canonical bare-workflow reference
+ * (Examples/bare-workflow/ios/ConnectNCE/Info.plist), which itself mirrors the
+ * iOS-SDK NCE 1:1:
+ *  - UNNotificationExtensionCategory: the category identifiers the Connect
+ *    APNs payload routes rich-media notifications through. Must match the
+ *    category the SDK/Collector sets — keep in sync with the iOS-SDK NCE.
+ *  - UNNotificationExtensionDefaultContentHidden=false: keep the default
+ *    system body alongside the custom content view.
+ *  - UNNotificationExtensionInitialContentSizeRatio=1.0: start full-height;
+ *    the SDK content controller resizes to fit the rendered media.
+ *
+ * RCTNewArchEnabled is intentionally omitted: the NCE links the Connect SDK
+ * only — no React Native runtime is present in the extension process. (The
+ * bare-workflow reference carries it as an Xcode-template leftover; the
+ * plugin-generated target drops it, consistent with the NSE template.)
+ */
+export declare function buildNCEInfoPlist(): string;
+/** Generates the entitlements plist content for the ConnectNCE target. */
+export declare function buildNCEEntitlements(appGroupIdentifier: string): string;
+/**
+ * Returns the Ruby snippet to inject into the Expo-generated Podfile for the
+ * ConnectNCE target. Thin wrapper over the shared
+ * {@link buildConnectPodTargetBlock} (single source of truth for the
+ * AcousticConnect pod-resolution helper), parameterised with the NCE marker,
+ * helper name, and target name.
+ */
+export declare function buildPodfileBlock(): string;
+/**
+ * Injects the ConnectNCE Podfile block into `podfileContent` if not already
+ * present (idempotent, guarded by PODFILE_MARKER).
+ */
+export declare function injectPodfileBlock(podfileContent: string): string;
+/**
+ * Adds the ConnectNCE Xcode target (app_extension) to the project.
+ *
+ * Sibling to withNSEXcodeProject; the only differences are the target name,
+ * the Swift source file (NotificationViewController.swift), the NCE Info.plist
+ * (content-extension NSExtension keys), and skipping BOTH extension targets'
+ * configs when mirroring host build settings.
+ *
+ * Idempotent: if a target named ConnectNCE already exists, skips target
+ * creation but still (re)writes the source files.
+ */
+export declare function withNCEXcodeProject(config: ExpoConfig, appGroupIdentifier: string, swiftContent: string): ExpoConfig;
+/**
+ * Injects the ConnectNCE Podfile target block via withDangerousMod.
+ * Guarded by a marker comment — re-runs are no-ops.
+ *
+ * Throws a clear, actionable error when the Podfile does not exist at
+ * mod-execution time, instead of silently returning — a silent skip would
+ * ship an NCE whose `import Connect` cannot resolve.
+ */
+export declare function withNCEPodfile(config: ExpoConfig): ExpoConfig;
+/**
+ * Expo Config Plugin mod that provisions a Notification Content Extension
+ * (NCE) Xcode target named `ConnectNCE`.
+ *
+ * Applies three mutations — all idempotent:
+ *  1. Host app entitlements: merges App Group into
+ *     `com.apple.security.application-groups` (reuses the NSE host-entitlements
+ *     mod — the host shares one App Group across app + NSE + NCE; the merge is
+ *     a no-op when the NSE mod already added it).
+ *  2. Xcode project: adds ConnectNCE target + files (skips if already present).
+ *  3. Podfile: injects `target 'ConnectNCE'` block (guarded by marker comment).
+ *
+ * `config._internal.projectRoot` is required (injected by Expo CLI during
+ * `expo prebuild`); an actionable error is thrown if absent rather than
+ * silently falling back to `process.cwd()`.
+ *
+ * NSE coupling (intentional, tracked for refactor): this mod deliberately
+ * reuses three pieces of withConnectNSE — `withNSEEntitlements` (the host App
+ * Group is shared across app + NSE + NCE), `buildConnectPodTargetBlock` (one
+ * source for the pod-resolution helper), and `getHostBuildSettingForConfig`
+ * (the per-config mirroring logic). The composition always runs withConnectNSE
+ * before withConnectNCE, so the shared host entitlement and the
+ * PBXTargetDependency/PBXContainerItemProxy sections already exist when this
+ * runs. Extracting a shared `withConnectExtension` base for NSE + NCE is
+ * tracked as a follow-up refactor (see PR description) rather than done here,
+ * to keep the already-landed NSE mod stable.
+ */
+export declare const withConnectNCE: ConfigPlugin<ConnectPluginProps>;
+//# sourceMappingURL=withConnectNCE.d.ts.map

package/plugin/build/withConnectNCE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withConnectNCE.d.ts","sourceRoot":"","sources":["../src/withConnectNCE.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAA;AAuBzB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6C1C;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAYvE;AAOD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAKjE;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,MAAM,GACnB,UAAU,CAqNZ;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAuB7D;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,CAAC,kBAAkB,CAgC3D,CAAA"}