react-native-acoustic-connect 19.0.11 → 19.0.34

package/lib/typescript/src/specs/react-native-acoustic-connect.nitro.d.ts

@@ -1,8 +1,33 @@
-import { type HybridObject } from 'react-native-nitro-modules';
+import { type AnyMap, type HybridObject } from 'react-native-nitro-modules';
 export type KeyValueObject = {
     placeholder: string;
     [key: string]: unknown;
 };
+/**
+ * Payload accepted by {@link AcousticConnectRN.logSignal} — any JSON-shaped
+ * object. Nested objects and arrays are allowed, so this is a superset of a
+ * flat `Record<string, string | number | boolean>`.
+ *
+ * You do not need this type to call `logSignal`: an object literal is enough.
+ * It exists for the times you want to name the payload — a helper parameter, a
+ * shared constant — and is re-exported from the package root so you never have
+ * to reach into `react-native-nitro-modules` for it:
+ *
+ * ```ts
+ * import AcousticConnectRN, { type SignalValues } from 'react-native-acoustic-connect-beta'
+ *
+ * const payload: SignalValues = { signalContent: { signalType: 'pageview' } }
+ * AcousticConnectRN.logSignal(payload, 1)
+ * ```
+ *
+ * @remarks
+ * Aliases nitro's `AnyMap`, which is the only way to express arbitrary JSON in
+ * a Nitro spec — a hand-rolled recursive type is rejected by nitrogen, which
+ * tries to generate a struct for it. Nitrogen resolves the alias, so the
+ * generated native bindings are identical either way; the indirection exists
+ * purely to keep a third-party type name off our public API.
+ */
+export type SignalValues = AnyMap;
 export type ConnectMonitoringLevelType = 'Ignore' | 'CellularAndWiFi' | 'WiFi';
 /**
  * Structured error describing an APNs / permission failure.
@@ -107,20 +132,136 @@ export interface AcousticConnectRN extends HybridObject<{
     getBooleanConfigItemForKey(theDefault: boolean, key: string, moduleName: string): boolean;
     getStringItemForKey(theDefault: string, key: string, moduleName: string): string | null | undefined;
     getNumberItemForKey(theDefault: number, key: string, moduleName: string): number;
+    /**
+     * Logs a named custom event with a flat set of key/value pairs.
+     *
+     * `values` is deliberately **flat** (scalars only), unlike
+     * {@link logSignal}. The Android SDK's custom-event path is typed
+     * `HashMap<String, String>` end to end (`Connect.logCustomEvent` →
+     * `Tealeaf.logCustomEvent`), so there is no native route for nested
+     * JSON. Widening this signature would compile but silently drop the
+     * nesting on Android while preserving it on iOS — a cross-platform
+     * divergence worse than the restriction. Use {@link logSignal} when the
+     * payload needs structure.
+     *
+     * @param eventName Event name; appears in the posted JSON.
+     * @param values Flat key/value pairs to attach to the event.
+     * @param level Monitoring level for this event.
+     * @returns `true` if the SDK **accepted the event for delivery** — not
+     *   that the collector received it. Events are queued on device and posted
+     *   in batches later, so nothing this call can return attests to delivery
+     *   or to server-side acceptance. A `false` means the SDK rejected the
+     *   event outright and nothing was queued; the bridge also logs that to
+     *   logcat / os_log so it is visible without inspecting the return value.
+     */
     logCustomEvent(eventName: string, values: Record<string, string | number | boolean>, level: number): boolean;
-    logSignal(values: Record<string, string | number | boolean>, level: number): boolean;
+    /**
+     * Logs a signal payload.
+     *
+     * `values` accepts **arbitrary JSON** — nested objects and arrays, not
+     * just scalars — because both native SDKs embed the payload verbatim:
+     * iOS `CTSignalMessage` gates only on `NSJSONSerialization
+     * isValidJSONObject:`, and Android `Connect.logSignal` takes an untyped
+     * `HashMap<String, Any?>`. The bridge converts the map to each
+     * platform's JSON representation without flattening or reshaping it.
+     *
+     * Scalar-only callers are unaffected: {@link SignalValues} is a superset
+     * of `Record<string, string | number | boolean>`.
+     *
+     * @param values Signal payload. Objects, arrays, strings, numbers,
+     *   booleans and `null` are all carried through.
+     * @param level Monitoring level for this signal.
+     * @returns `true` if the SDK **accepted the signal for delivery** — not
+     *   that the collector received it, and not that it passed server-side
+     *   schema validation. Signals are queued on device and posted later, so
+     *   nothing this call can return attests to delivery. A `false` means the
+     *   SDK rejected it and nothing was queued; the bridge logs that to
+     *   logcat / os_log.
+     *
+     * @remarks
+     * **Android version boundary — top-level numbers.** The Android SDK's
+     * `JsonUtil.getHashValues` gained a `Number` branch in Connect Android
+     * **11.0.24-beta**, so from that version a top-level numeric value is
+     * carried. Earlier versions serialised only `String`, `Boolean`,
+     * `JSONObject`, `JSONArray` and `byte[]` at the top level of the signal
+     * map and dropped a top-level number. Numbers nested *inside* an object
+     * or array were never affected, because the bridge builds those
+     * `JSONObject`/`JSONArray` values itself, and iOS has always carried
+     * top-level numbers normally. Both versions sit inside the
+     * `[11.0.11, 12.0.0)` range this package accepts, so nest the number if
+     * your integration pins a Connect Android version below 11.0.24-beta.
+     *
+     * @example Nested payload
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * AcousticConnectRN.logSignal(
+     *   {
+     *     signalContent: {
+     *       signalType: 'pageview',
+     *       url: 'https://app.example.com/dashboard',
+     *       pageCategory: 'dashboard',
+     *     },
+     *     audience: [
+     *       { name: 'Account Name', value: 'Acme Corp' },
+     *       { name: 'Account ID', value: '4815162342' },
+     *     ],
+     *   },
+     *   1
+     * )
+     * ```
+     */
+    logSignal(values: SignalValues, level: number): boolean;
     logExceptionEvent(message: string, stackInfo: string, unhandled: boolean): boolean;
     logLocation(): boolean;
     logLocationWithLatitudeLongitude(latitude: number, longitude: number, level: number): boolean;
     logClickEvent(target: number, controlId: string): boolean;
     logTextChangeEvent(target: number, controlId: string, text: string | null | undefined): boolean;
+    /**
+     * Sets the logical screen name subsequent events are attributed to.
+     *
+     * Sets the name and nothing else — no screenview, no layout capture — on
+     * both platforms. `<Connect>` calls this on every touch so the click that
+     * follows lands on the right screen, so it has to stay cheap.
+     *
+     * Android used to route it through `Connect.resumeConnect`, which also
+     * emitted a screenview and captured a full layout, putting tens to hundreds
+     * of KB on the wire per tap where iOS sent none. Use `logScreenLayout` when
+     * a layout capture is what you want.
+     */
     setCurrentScreenName(logicalPageName: string): boolean;
     logScreenViewContextLoad(logicalPageName: string | null | undefined, referrer: string | null | undefined): boolean;
     logScreenViewContextUnload(logicalPageName: string | null | undefined, referrer: string | null | undefined): boolean;
+    /**
+     * Captures the layout of the current screen.
+     *
+     * @param name  Screen name to associate with the capture.
+     * @param delay Milliseconds to wait before capturing — the same unit as
+     *   `CaptureLayoutDelay` in the layout config, on both platforms. A
+     *   negative value means "use the `CaptureLayoutDelay` configured for this
+     *   screen"; `0` captures immediately.
+     *
+     * Prefer `TLTRN.logScreenLayout`, which defaults to the configured delay.
+     *
+     * @returns For a `delay` of `0`, whether the capture itself succeeded. For
+     *   any positive or configured delay, only that the capture was
+     *   **scheduled** — the native deferred overload dispatches and returns
+     *   immediately, so a `true` says nothing about what the capture found
+     *   when it eventually ran. Failures after that point (no view controller
+     *   resolved, config gating the capture off) surface in logcat / os_log,
+     *   not here.
+     */
     logScreenLayout(name: string, delay: number): boolean;
     logDialogShowEvent(dialogId: string, dialogTitle: string, dialogType: string): boolean;
     logDialogDismissEvent(dialogId: string, dismissReason: string): boolean;
     logDialogButtonClickEvent(dialogId: string, buttonText: string, buttonIndex: number): boolean;
+    /**
+     * Logs a custom event against a tracked dialog.
+     *
+     * `values` is flat for the same reason as {@link logCustomEvent} — this
+     * routes to the native custom-event API, whose Android path carries string
+     * values only.
+     */
     logDialogCustomEvent(dialogId: string, eventName: string, values: Record<string, string | number | boolean>): boolean;
     /**
      * Logs a user identity so the current device/session can be associated with
@@ -143,23 +284,62 @@ export interface AcousticConnectRN extends HybridObject<{
      *   `'loggedIn'` when omitted (identity logging typically marks a sign-in),
      *   overriding the native SDKs' own `'pageView'` default.
      * @param additionalParameters Optional extra key/value pairs merged into the
-     *   signal payload. Only when omitted (`undefined`) does the bridge supply
-     *   the default `{ registrationMethod: 'email' }`; an explicitly-provided
-     *   map is used as-is, so passing an empty `{}` sends no extra parameters
-     *   (the default is not merged in). A `'url'` entry is honoured uniformly on
-     *   both platforms: on Android it is routed to the SDK's explicit `url`
-     *   parameter, on iOS it rides inside the parameter map (where the native
-     *   API expects it).
+     *   signal payload. Only when omitted (`undefined`) does the bridge supply a
+     *   default, and that default follows the resolved `signalType` — see
+     *   **Required method attribute** below. An explicitly-provided map is used
+     *   as-is, so passing an empty `{}` sends no extra parameters (the default is
+     *   not merged in). A `'url'` entry is honoured uniformly on both platforms:
+     *   on Android it is routed to the SDK's explicit `url` parameter, on iOS it
+     *   rides inside the parameter map (where the native API expects it).
      * @returns A promise resolving to `true` if the identity signal was
      *   dispatched, `false` otherwise (including the blank-identifier case).
      *   Never rejects.
      *
-     * @example
+     * ### Required method attribute
+     *
+     * Identity signals must carry a *method* attribute, and the key Connect
+     * requires depends on the signal type:
+     *
+     * | `signalType`         | Required attribute   |
+     * | -------------------- | -------------------- |
+     * | `'loggedIn'`         | `loginMethod`        |
+     * | `'accountRegistered'`| `registrationMethod` |
+     *
+     * Send the wrong key and the signal fails schema validation and is
+     * discarded server-side — while this promise still resolves `true`, because
+     * the native SDKs report only that the signal was queued. If you pass
+     * `additionalParameters` explicitly, you own supplying the right key.
+     *
+     * @example Sign-in — `loginMethod` is required
      * ```ts
      * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
      *
+     * await AcousticConnectRN.logIdentity('Email', 'user@example.com', 'loggedIn', {
+     *   loginMethod: 'sso',
+     * })
+     *
+     * // Omitting both arguments is equivalent to the above with
+     * // `{ loginMethod: 'email' }` — the bridge defaults to a `loggedIn` signal.
      * await AcousticConnectRN.logIdentity('Email', 'user@example.com')
      * ```
+     *
+     * @example Registration — `registrationMethod` is required
+     * ```ts
+     * await AcousticConnectRN.logIdentity(
+     *   'Email',
+     *   'user@example.com',
+     *   'accountRegistered',
+     *   { registrationMethod: 'email' }
+     * )
+     * ```
+     *
+     * @returns `true` if the SDK **accepted the identity signal for
+     *   delivery**. It does not mean the signal reached the collector, and it
+     *   does not mean the collector kept it — a schema-invalid signal (the
+     *   wrong method key above) is discarded server-side after resolving
+     *   `true` here. Never rejects. A `false` means the SDK rejected the call
+     *   locally, e.g. a blank identifier; the bridge logs that to logcat /
+     *   os_log.
      */
     logIdentity(identifierName: string, identifierValue: string, signalType?: string, additionalParameters?: Record<string, string>): Promise<boolean>;
     /**

package/lib/typescript/src/specs/react-native-acoustic-connect.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-native-acoustic-connect.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/react-native-acoustic-connect.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"react-native-acoustic-connect.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/react-native-acoustic-connect.nitro.ts"],"names":[],"mappings":"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"}

package/nitrogen/generated/android/c++/JHybridAcousticConnectRNSpec.cpp

@@ -25,6 +25,8 @@ namespace margelo::nitro::acousticconnectrn { struct PushErrorInfo; }
 #include "JVariant_NullType_Boolean.hpp"
 #include "JVariant_Boolean_String_Double.hpp"
 #include <unordered_map>
+#include <NitroModules/AnyMap.hpp>
+#include <NitroModules/JAnyMap.hpp>
 #include <NitroModules/ArrayBuffer.hpp>
 #include <NitroModules/JArrayBuffer.hpp>
 #include "PushErrorInfo.hpp"
@@ -119,15 +121,9 @@ namespace margelo::nitro::acousticconnectrn {
     }(), level);
     return static_cast<bool>(__result);
   }
-  bool JHybridAcousticConnectRNSpec::logSignal(const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values, double level) {
-    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean(jni::alias_ref<jni::JMap<jni::JString, JVariant_Boolean_String_Double>> /* values */, double /* level */)>("logSignal");
-    auto __result = method(_javaPart, [&]() -> jni::local_ref<jni::JMap<jni::JString, JVariant_Boolean_String_Double>> {
-      auto __map = jni::JHashMap<jni::JString, JVariant_Boolean_String_Double>::create(values.size());
-      for (const auto& __entry : values) {
-        __map->put(jni::make_jstring(__entry.first), JVariant_Boolean_String_Double::fromCpp(__entry.second));
-      }
-      return __map;
-    }(), level);
+  bool JHybridAcousticConnectRNSpec::logSignal(const std::shared_ptr<AnyMap>& values, double level) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean(jni::alias_ref<JAnyMap::javaobject> /* values */, double /* level */)>("logSignal");
+    auto __result = method(_javaPart, JAnyMap::create(values), level);
     return static_cast<bool>(__result);
   }
   bool JHybridAcousticConnectRNSpec::logExceptionEvent(const std::string& message, const std::string& stackInfo, bool unhandled) {

package/nitrogen/generated/android/c++/JHybridAcousticConnectRNSpec.hpp

@@ -64,7 +64,7 @@ namespace margelo::nitro::acousticconnectrn {
     std::optional<std::variant<nitro::NullType, std::string>> getStringItemForKey(const std::string& theDefault, const std::string& key, const std::string& moduleName) override;
     double getNumberItemForKey(double theDefault, const std::string& key, const std::string& moduleName) override;
     bool logCustomEvent(const std::string& eventName, const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values, double level) override;
-    bool logSignal(const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values, double level) override;
+    bool logSignal(const std::shared_ptr<AnyMap>& values, double level) override;
     bool logExceptionEvent(const std::string& message, const std::string& stackInfo, bool unhandled) override;
     bool logLocation() override;
     bool logLocationWithLatitudeLongitude(double latitude, double longitude, double level) override;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/acousticconnectrn/HybridAcousticConnectRNSpec.kt

@@ -11,6 +11,7 @@ import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
 import com.margelo.nitro.core.NullType
+import com.margelo.nitro.core.AnyMap
 import com.margelo.nitro.core.Promise
 import com.margelo.nitro.core.ArrayBuffer
 import com.margelo.nitro.core.HybridObject
@@ -73,7 +74,7 @@ abstract class HybridAcousticConnectRNSpec: HybridObject() {
   
   @DoNotStrip
   @Keep
-  abstract fun logSignal(values: Map<String, Variant_Boolean_String_Double>, level: Double): Boolean
+  abstract fun logSignal(values: AnyMap, level: Double): Boolean
   
   @DoNotStrip
   @Keep

package/nitrogen/generated/ios/AcousticConnectRN-Swift-Cxx-Umbrella.hpp

@@ -19,6 +19,7 @@ namespace margelo::nitro::acousticconnectrn { struct PushPermissionResult; }
 #include "HybridAcousticConnectRNSpec.hpp"
 #include "PushErrorInfo.hpp"
 #include "PushPermissionResult.hpp"
+#include <NitroModules/AnyMap.hpp>
 #include <NitroModules/ArrayBuffer.hpp>
 #include <NitroModules/Null.hpp>
 #include <NitroModules/Promise.hpp>

package/nitrogen/generated/ios/c++/HybridAcousticConnectRNSpecSwift.hpp

@@ -24,6 +24,7 @@ namespace margelo::nitro::acousticconnectrn { struct PushPermissionResult; }
 #include <NitroModules/Null.hpp>
 #include <optional>
 #include <unordered_map>
+#include <NitroModules/AnyMap.hpp>
 #include <NitroModules/Promise.hpp>
 #include <NitroModules/ArrayBuffer.hpp>
 #include <NitroModules/ArrayBufferHolder.hpp>
@@ -160,7 +161,7 @@ namespace margelo::nitro::acousticconnectrn {
       auto __value = std::move(__result.value());
       return __value;
     }
-    inline bool logSignal(const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values, double level) override {
+    inline bool logSignal(const std::shared_ptr<AnyMap>& values, double level) override {
       auto __result = _swiftPart.logSignal(values, std::forward<decltype(level)>(level));
       if (__result.hasError()) [[unlikely]] {
         std::rethrow_exception(__result.error());

package/nitrogen/generated/ios/swift/HybridAcousticConnectRNSpec.swift

@@ -23,7 +23,7 @@ public protocol HybridAcousticConnectRNSpec_protocol: HybridObject {
   func getStringItemForKey(theDefault: String, key: String, moduleName: String) throws -> Variant_NullType_String?
   func getNumberItemForKey(theDefault: Double, key: String, moduleName: String) throws -> Double
   func logCustomEvent(eventName: String, values: Dictionary<String, Variant_Bool_String_Double>, level: Double) throws -> Bool
-  func logSignal(values: Dictionary<String, Variant_Bool_String_Double>, level: Double) throws -> Bool
+  func logSignal(values: AnyMap, level: Double) throws -> Bool
   func logExceptionEvent(message: String, stackInfo: String, unhandled: Bool) throws -> Bool
   func logLocation() throws -> Bool
   func logLocationWithLatitudeLongitude(latitude: Double, longitude: Double, level: Double) throws -> Bool

package/nitrogen/generated/ios/swift/HybridAcousticConnectRNSpec_cxx.swift

@@ -296,32 +296,9 @@ open class HybridAcousticConnectRNSpec_cxx {
   }
   
   @inline(__always)
-  public final func logSignal(values: bridge.std__unordered_map_std__string__std__variant_bool__std__string__double__, level: Double) -> bridge.Result_bool_ {
+  public final func logSignal(values: margelo.nitro.SharedAnyMap, level: Double) -> bridge.Result_bool_ {
     do {
-      let __result = try self.__implementation.logSignal(values: { () -> Dictionary<String, Variant_Bool_String_Double> in
-        var __dictionary = Dictionary<String, Variant_Bool_String_Double>(minimumCapacity: values.size())
-        let __keys = bridge.get_std__unordered_map_std__string__std__variant_bool__std__string__double___keys(values)
-        for __key in __keys {
-          let __value = bridge.get_std__unordered_map_std__string__std__variant_bool__std__string__double___value(values, __key)
-          __dictionary[String(__key)] = { () -> Variant_Bool_String_Double in
-            let __variant = bridge.std__variant_bool__std__string__double_(__value)
-            switch __variant.index() {
-              case 0:
-                let __actual = __variant.get_0()
-                return .first(__actual)
-              case 1:
-                let __actual = __variant.get_1()
-                return .second(String(__actual))
-              case 2:
-                let __actual = __variant.get_2()
-                return .third(__actual)
-              default:
-                fatalError("Variant can never have index \(__variant.index())!")
-            }
-          }()
-        }
-        return __dictionary
-      }(), level: level)
+      let __result = try self.__implementation.logSignal(values: AnyMap(withCppPart: values), level: level)
       let __resultCpp = __result
       return bridge.create_Result_bool_(__resultCpp)
     } catch (let __error) {

package/nitrogen/generated/shared/c++/HybridAcousticConnectRNSpec.hpp

@@ -23,6 +23,7 @@ namespace margelo::nitro::acousticconnectrn { struct PushPermissionResult; }
 #include <NitroModules/Null.hpp>
 #include <optional>
 #include <unordered_map>
+#include <NitroModules/AnyMap.hpp>
 #include <NitroModules/Promise.hpp>
 #include <NitroModules/ArrayBuffer.hpp>
 #include "PushErrorInfo.hpp"
@@ -69,7 +70,7 @@ namespace margelo::nitro::acousticconnectrn {
       virtual std::optional<std::variant<nitro::NullType, std::string>> getStringItemForKey(const std::string& theDefault, const std::string& key, const std::string& moduleName) = 0;
       virtual double getNumberItemForKey(double theDefault, const std::string& key, const std::string& moduleName) = 0;
       virtual bool logCustomEvent(const std::string& eventName, const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values, double level) = 0;
-      virtual bool logSignal(const std::unordered_map<std::string, std::variant<bool, std::string, double>>& values, double level) = 0;
+      virtual bool logSignal(const std::shared_ptr<AnyMap>& values, double level) = 0;
       virtual bool logExceptionEvent(const std::string& message, const std::string& stackInfo, bool unhandled) = 0;
       virtual bool logLocation() = 0;
       virtual bool logLocationWithLatitudeLongitude(double latitude, double longitude, double level) = 0;

package/package.json

@@ -79,6 +79,7 @@
         "!android/src/test/**",
         "android/config.gradle",
         "android/src/main/assets/**",
+        "!android/src/main/assets/ConnectLayoutConfig.json",
         "ios/**/*.h",
         "ios/**/*.m",
         "ios/**/*.mm",
@@ -91,16 +92,12 @@
         "plugin/swift",
         "plugin/src",
         "cli",
+        "!cli/__tests__/**",
         "ConnectConfig.example.json",
         "*.podspec",
         "README.md",
         "CHANGELOG.md",
-        "scripts",
-        "Examples/SampleUI/**/*",
-        "!Examples/SampleUI/node_modules/**",
-        "!Examples/SampleUI/temp/**",
-        "!Examples/SampleUI/logs/**",
-        "!Examples/SampleUI/android/.gradle/**"
+        "scripts"
     ],
     "homepage": "https://github.com/go-acoustic/react-native-acoustic-connect",
     "keywords": [
@@ -218,9 +215,10 @@
         "rebuild": "npm run codegen && npm run rebuildExample --prefix ./example",
         "release": "release-it",
         "test": "jest",
-        "test:all": "npm test && npm run test:plugin && npm run test:cli",
+        "test:all": "npm test && npm run test:plugin && npm run test:cli && npm run test:skills",
         "test:cli": "node --test cli/__tests__/",
         "test:plugin": "npm run build:plugin && node --test plugin/__tests__/",
+        "test:skills": "node .claude/skills/release-verification/scripts/assert-messages.mjs selftest",
         "test:watch": "jest --watch",
         "typecheck": "tsc --noEmit",
         "verifyConnectSetup": "node cli/index.mjs doctor $INIT_CWD",
@@ -229,7 +227,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.11",
+    "version": "19.0.34",
     "workspaces": [
         "example",
         "Examples/bare-workflow"

package/plugin/build/withConnectAndroidConfig.d.ts

@@ -23,8 +23,8 @@ export declare const withConnectAndroidConfig: ConfigPlugin<ConnectPluginProps>;
  * name, so a mismatch makes Gradle fail much later at
  * `:app:processDebugGoogleServices` with the opaque "No matching client found
  * for package name …" — and only after a full prebuild + Gradle config. Surface
- * it here, at the moment the native project is (re)generated, with the exact fix
- * (CA-144135 §10b). `acoustic-connect doctor` performs the same check up front;
+ * it here, at the moment the native project is (re)generated, with the exact fix.
+ * `acoustic-connect doctor` performs the same check up front;
  * this is the guard for a developer who runs `expo run:android` directly.
  *
  * Only the genuine MISMATCH throws. A missing package / googleServicesFile is

package/plugin/build/withConnectAndroidConfig.js

@@ -106,8 +106,8 @@ function isPushEnabled(projectRoot) {
  * name, so a mismatch makes Gradle fail much later at
  * `:app:processDebugGoogleServices` with the opaque "No matching client found
  * for package name …" — and only after a full prebuild + Gradle config. Surface
- * it here, at the moment the native project is (re)generated, with the exact fix
- * (CA-144135 §10b). `acoustic-connect doctor` performs the same check up front;
+ * it here, at the moment the native project is (re)generated, with the exact fix.
+ * `acoustic-connect doctor` performs the same check up front;
  * this is the guard for a developer who runs `expo run:android` directly.
  *
  * Only the genuine MISMATCH throws. A missing package / googleServicesFile is

package/plugin/build/withConnectIosSigning.d.ts

@@ -19,7 +19,7 @@ export declare function resolveDevelopmentTeam(projectRoot: string, props: Conne
  * Why this matters: the NSE mod injects the `aps-environment` entitlement, but
  * a CLI build (`expo run:ios` / `xcodebuild`) with no signing team falls back
  * to ad-hoc signing (`CODE_SIGN_IDENTITY = -`), which DROPS that entitlement —
- * so the OS issues no APNs token and push silently fails (CA-144135 §6). Setting
+ * so the OS issues no APNs token and push silently fails. Setting
  * the team closes that loop on the prebuild path the SDK owns. Provisioning
  * itself still needs the developer's Apple ID in Xcode and
  * `-allowProvisioningUpdates` on the build (documented in the README).

package/plugin/build/withConnectIosSigning.js

@@ -74,7 +74,7 @@ exports.resolveDevelopmentTeam = resolveDevelopmentTeam;
  * Why this matters: the NSE mod injects the `aps-environment` entitlement, but
  * a CLI build (`expo run:ios` / `xcodebuild`) with no signing team falls back
  * to ad-hoc signing (`CODE_SIGN_IDENTITY = -`), which DROPS that entitlement —
- * so the OS issues no APNs token and push silently fails (CA-144135 §6). Setting
+ * so the OS issues no APNs token and push silently fails. Setting
  * the team closes that loop on the prebuild path the SDK owns. Provisioning
  * itself still needs the developer's Apple ID in Xcode and
  * `-allowProvisioningUpdates` on the build (documented in the README).

package/plugin/src/withConnectAndroidConfig.ts

@@ -95,8 +95,8 @@ function isPushEnabled(projectRoot: string): boolean {
  * name, so a mismatch makes Gradle fail much later at
  * `:app:processDebugGoogleServices` with the opaque "No matching client found
  * for package name …" — and only after a full prebuild + Gradle config. Surface
- * it here, at the moment the native project is (re)generated, with the exact fix
- * (CA-144135 §10b). `acoustic-connect doctor` performs the same check up front;
+ * it here, at the moment the native project is (re)generated, with the exact fix.
+ * `acoustic-connect doctor` performs the same check up front;
  * this is the guard for a developer who runs `expo run:android` directly.
  *
  * Only the genuine MISMATCH throws. A missing package / googleServicesFile is

package/plugin/src/withConnectIosSigning.ts

@@ -63,7 +63,7 @@ export function resolveDevelopmentTeam(
  * Why this matters: the NSE mod injects the `aps-environment` entitlement, but
  * a CLI build (`expo run:ios` / `xcodebuild`) with no signing team falls back
  * to ad-hoc signing (`CODE_SIGN_IDENTITY = -`), which DROPS that entitlement —
- * so the OS issues no APNs token and push silently fails (CA-144135 §6). Setting
+ * so the OS issues no APNs token and push silently fails. Setting
  * the team closes that loop on the prebuild path the SDK owns. Provisioning
  * itself still needs the developer's Apple ID in Xcode and
  * `-allowProvisioningUpdates` on the build (documented in the README).

package/scripts/gradleParser.js

@@ -21,7 +21,7 @@ console.log("Run gradleParser.js");
 // new architecture does not guarantee — and fails the Gradle sync with
 // "Project with path ':react-native-acoustic-connect' could not be
 // found" otherwise. `require.resolve` walks up node_modules from the Android
-// rootDir and finds the package regardless of autolinking. See CA-144314.
+// rootDir and finds the package regardless of autolinking.
 const gradleCode = `apply from: new File(["node", "--print", "require.resolve('react-native-acoustic-connect/package.json')"].execute(null, rootDir).text.trim()).getParentFile().getAbsolutePath() + "/android/config.gradle"`
 // Matches the legacy `apply from: project(':react-native-acoustic-connect')...`
 // line so an existing integration is upgraded in place on the next install.