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

package/CHANGELOG.md

@@ -1,3 +1,4 @@
+## [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,94 @@ 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 the App Group entitlement to both the host app and the NSE;
+- appends a `ConnectNSE` target to the generated `Podfile` that links 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.
+
+A working example 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
+#Mon Jun 15 05:39:24 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.35",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/plugin/build/index.d.ts

@@ -0,0 +1,22 @@
+import { type ConfigPlugin } from '@expo/config-plugins';
+import { withConnectNSE, type ConnectPluginProps } from './withConnectNSE';
+/**
+ * Expo Config Plugin for react-native-acoustic-connect-beta.
+ *
+ * Provisions the ConnectNSE Notification Service Extension target during
+ * `expo prebuild`. Designed as a chainable composition: additional mods
+ * (e.g. withConnectNCE from CA-143488) are appended by adding to the mods
+ * array without touching this file.
+ *
+ * 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 };
+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;AAE1E;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,mBAAmB,EAAE,YAAY,CAAC,kBAAkB,GAAG,IAAI,CAWhE,CAAA;AAED,eAAe,mBAAmB,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,CAAA;AACzB,YAAY,EAAE,kBAAkB,EAAE,CAAA"}

package/plugin/build/index.js

@@ -0,0 +1,35 @@
+"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.withConnectNSE = void 0;
+const withConnectNSE_1 = require("./withConnectNSE");
+Object.defineProperty(exports, "withConnectNSE", { enumerable: true, get: function () { return withConnectNSE_1.withConnectNSE; } });
+/**
+ * Expo Config Plugin for react-native-acoustic-connect-beta.
+ *
+ * Provisions the ConnectNSE Notification Service Extension target during
+ * `expo prebuild`. Designed as a chainable composition: additional mods
+ * (e.g. withConnectNCE from CA-143488) are appended by adding to the mods
+ * array without touching this file.
+ *
+ * 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 — CA-143488 appends withConnectNCE here.
+    const mods = [withConnectNSE_1.withConnectNSE];
+    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;AA+BjE,+FA/BA,+BAAc,OA+BA;AA7BvB;;;;;;;;;;;;;;GAcG;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,uEAAuE;IACvE,MAAM,IAAI,GAA4C,CAAC,+BAAc,CAAC,CAAA;IAEtE,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/withConnectNSE.d.ts

@@ -0,0 +1,95 @@
+import { type ConfigPlugin } from '@expo/config-plugins';
+import type { ExpoConfig } from '@expo/config-types';
+export interface ConnectPluginProps {
+    /** Explicit App Group override. Wins over ConnectConfig.json when set. */
+    iosAppGroupIdentifier?: string;
+}
+/**
+ * Validates an App Group identifier against Apple's format and returns it.
+ * Throws an actionable error otherwise.
+ */
+export declare function assertValidAppGroup(value: string, source: string): string;
+/**
+ * Resolves the iOS App Group identifier used by ConnectNSE.
+ *
+ * Priority:
+ *  1. `iosAppGroupIdentifier` plugin prop in app.json (explicit override)
+ *  2. `Connect.iOSAppGroupIdentifier` in `<projectRoot>/ConnectConfig.json`
+ *
+ * The resolved value is validated against Apple's App Group format. Throws a
+ * clear, actionable error if neither source provides the value, or if the
+ * provided value is malformed.
+ */
+export declare function resolveAppGroupIdentifier(projectRoot: string, props: ConnectPluginProps): string;
+/**
+ * Returns the content of `plugin/swift/NotificationService.swift` with the
+ * placeholder replaced by the resolved App Group identifier and a generated
+ * header prepended.
+ */
+export declare function substituteSwiftTemplate(templatePath: string, appGroupIdentifier: string): string;
+/**
+ * Generates the Info.plist content for the ConnectNSE target.
+ *
+ * RCTNewArchEnabled is intentionally omitted: the NSE links the Connect SDK
+ * only — no React Native runtime is present in the extension process.
+ */
+export declare function buildNSEInfoPlist(): string;
+/** Generates the entitlements plist content for the ConnectNSE target. */
+export declare function buildNSEEntitlements(appGroupIdentifier: string): string;
+/**
+ * Returns the Ruby snippet to inject into the Expo-generated Podfile.
+ *
+ * Tolerates a missing ConnectConfig.json or a missing `Connect` key: when
+ * the file or key is absent the block defaults to AcousticConnectDebug with
+ * floor '>= 2.1.12' and no version pin, so prop-only setups (no
+ * ConnectConfig.json) keep working.  If the file exists but contains invalid
+ * JSON, `pod install` will print a warning and use the same defaults rather
+ * than crashing.
+ */
+export declare function buildPodfileBlock(): string;
+/**
+ * Injects the ConnectNSE Podfile block into `podfileContent` if not already
+ * present (idempotent, guarded by PODFILE_MARKER).
+ */
+export declare function injectPodfileBlock(podfileContent: string): string;
+/**
+ * Adds the App Group to the HOST app's entitlements. Merges idempotently
+ * — never clobbers an existing `com.apple.security.application-groups` array.
+ */
+export declare function withNSEEntitlements(config: ExpoConfig, appGroupIdentifier: string): ExpoConfig;
+/**
+ * Adds the ConnectNSE Xcode target (app_extension) to the project.
+ *
+ * Follows the OneSignal plugin pattern (withOneSignalNSE.ts) using the
+ * `xcode` API exposed via `config.modResults`.
+ *
+ * Idempotent: if a target named ConnectNSE already exists, skips target
+ * creation but still (re)writes the source files.
+ */
+export declare function withNSEXcodeProject(config: ExpoConfig, appGroupIdentifier: string, swiftContent: string): ExpoConfig;
+/**
+ * Injects the ConnectNSE Podfile target block via withDangerousMod.
+ * Guarded by a marker comment — re-runs are no-ops.
+ *
+ * M5: 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 NSE whose `import Connect` cannot resolve.
+ */
+export declare function withNSEPodfile(config: ExpoConfig): ExpoConfig;
+/**
+ * Expo Config Plugin mod that provisions a Notification Service Extension
+ * (NSE) Xcode target named `ConnectNSE`.
+ *
+ * Applies three mutations — all idempotent:
+ *  1. Host app entitlements: merges App Group into
+ *     `com.apple.security.application-groups`.
+ *  2. Xcode project: adds ConnectNSE target + files (skips if already present).
+ *  3. Podfile: injects `target 'ConnectNSE'` block (guarded by marker comment).
+ *
+ * M4: `config._internal.projectRoot` is required. If absent (i.e. invoked
+ * outside Expo CLI), an actionable error is thrown rather than silently
+ * falling back to `process.cwd()`, which would misresolve ConnectConfig.json
+ * in monorepo setups.
+ */
+export declare const withConnectNSE: ConfigPlugin<ConnectPluginProps>;
+//# sourceMappingURL=withConnectNSE.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"withConnectNSE.d.ts","sourceRoot":"","sources":["../src/withConnectNSE.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAapD,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,GACxB,MAAM,CAsCR;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAOR;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAiC1C;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAYvE;AAOD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA4B1C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAKjE;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,MAAM,GACzB,UAAU,CAcZ;AAkFD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,MAAM,GACnB,UAAU,CA+MZ;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAuB7D;AAID;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,CAAC,kBAAkB,CAgC3D,CAAA"}