@ansight/react-native 1.0.2-preview.8 → 1.2.0-preview.1

package/README.md

@@ -10,6 +10,8 @@ JavaScript-backed tools for React component-tree inspection.
 
 ## Install
 
+### React Native CLI
+
 ```sh
 npm install @ansight/react-native
 ```
@@ -23,41 +25,78 @@ npx react-native run-ios
 npx react-native run-android
 ```
 
+### Expo development builds
+
+Ansight contains native iOS and Android code, so it requires an Expo
+development build or production/EAS build. It does not run in Expo Go.
+
+```sh
+npx expo install @ansight/react-native
+```
+
+Add the bundled config plugin to the app config. It supplies the iOS camera
+usage description required by QR enrollment and the local-network description
+used when connecting to Ansight Studio:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@ansight/react-native",
+        {
+          "cameraPermission": "Allow $(PRODUCT_NAME) to scan an Ansight Studio enrollment QR code.",
+          "localNetworkPermission": "Allow $(PRODUCT_NAME) to connect to Ansight Studio on your local network."
+        }
+      ]
+    ]
+  }
+}
+```
+
+Omit either message to use the default. Set `cameraPermission` to `false` only
+when the app will never call `enrollFromQrCode` or `scanPairingQrCode`. Setting
+a permission option to `false` prevents Ansight from adding that key; it does
+not remove a value supplied by another plugin or by the app.
+
+Generate and rebuild the native projects after installing or updating the SDK
+or changing its plugin options:
+
+```sh
+npx expo prebuild --clean
+npx expo run:ios
+npx expo run:android
+```
+
+EAS Build applies the same plugin during prebuild. Expo Updates can update the
+JavaScript integration after the native binary has been built with a compatible
+version of `@ansight/react-native`.
+
+Expo Web is not currently supported. Do not import this package from a web
+bundle; its API requires the native Ansight module.
+
 This package version expects matching native SDK packages:
 
-- CocoaPods: `Ansight`, `AnsightObjC` version `1.0.2-preview.8`
-- Maven: `ai.ansight:ansight-android:1.0.2-preview.8`
+- CocoaPods: `Ansight`, `AnsightObjC` version `1.2.0-preview.1`
+- Maven: `ai.ansight:ansight-android:1.2.0-preview.1`
 
 ## Quickstart
 
 ```ts
 import Ansight from "@ansight/react-native";
 
-const isDevelopmentOnly = __DEV__;
-
 await Ansight.initializeAndActivate({
-  useNativeAllInOneDefaults: isDevelopmentOnly,
+  useNativeAllInOneDefaults: __DEV__,
   clientName: "My React Native App",
-  hostAutoProbe: {
-    enabled: isDevelopmentOnly,
-    initialDelayMilliseconds: 1000,
-    probeIntervalMilliseconds: 5000,
-    reconnectDelayMilliseconds: 10000,
-    clientName: "My React Native App",
-  },
-  hostConnection: isDevelopmentOnly ? {
-    bundledDeveloperConfigJson: process.env.EXPO_PUBLIC_ANSIGHT_PAIRING_CONFIG_JSON,
-  } : undefined,
-  toolGuard: isDevelopmentOnly ? "readOnly" : "disabled",
+  toolGuard: __DEV__ ? "readOnly" : "disabled",
   lifecycle: true,
 });
-
-await Ansight.connect(null, {
-  clientName: "My React Native App",
-  expectedAppId: "com.example.app",
-});
 ```
 
+The native iOS Simulator or Android emulator runtime registers automatically
+with a running, signed-in Studio. No pairing file, environment variable, host
+address, or build-time Studio probe is required.
+
 `useNativeAllInOneDefaults` defaults to `false`. It only applies the native
 iOS/Android all-in-one defaults: 400 ms sampling, 120 second retention, FPS,
 touch capture, 2000 ms JPEG capture at quality 60 and max width 480, host
@@ -92,7 +131,6 @@ The TypeScript `AnsightOptions` surface mirrors Android `AnsightOptions`, iOS
 | Option | Purpose |
 | --- | --- |
 | `useNativeAllInOneDefaults` | Applies native iOS/Android all-in-one defaults when true. Defaults to false. This enables the native visual-tree/screenshot tools required by Studio visual tree inspection unless `remoteTools.visualTree` is explicitly false. Configure `toolGuard`, capture options, and `hostConnection` separately. |
-| `pairingConfigJson` | Legacy top-level pairing JSON. Prefer `hostConnection.*`. |
 | `clientName` | Default client name for host auto-probe and connections. |
 | `sampleFrequencyMilliseconds` | Built-in telemetry sampling interval. |
 | `retentionPeriodSeconds` | Local metric/event retention window. |
@@ -107,14 +145,14 @@ The TypeScript `AnsightOptions` surface mirrors Android `AnsightOptions`, iOS
 | `toolGuard` | `"disabled"`, `"readOnly"`, `"readWrite"`, or `"fullAccess"`. |
 | `customProperties` | Grouped string properties sent with `session.open`. |
 | `hostAutoProbe` | Remembered-host retry settings for reconnecting after the host disappears and later reappears. |
-| `hostConnection` | Saved, bundled, and developer pairing settings. |
+| `hostConnection` | Enrollment reconnect and network policy. |
 | `secureStorage` | Compatibility alias for native secure-storage allow-list settings. |
 | `remoteTools` | Native visual tree, file, database, preferences, reflection, and secure-storage tool options. |
 | `lifecycle` | JS AppState tracking toggle. Defaults to true. |
 
 Cellular host connections are disabled by default. The restriction applies to
-bundled configs, QR/payload flows, remembered/saved profiles, and manual
-connections. Opt in only for a trusted development host or personal hotspot:
+enrollment and reconnect requests. Opt in only for a trusted development host
+or personal hotspot:
 
 ```ts
 const options = Ansight.createOptionsBuilder()
@@ -124,7 +162,7 @@ const options = Ansight.createOptionsBuilder()
 
 You can also set `hostConnection.allowCellularConnections: true` directly.
 This may consume mobile data and permits connection attempts over a broader or
-carrier-managed network; signed pairing-config validation still applies.
+carrier-managed network; use it only with a trusted development host.
 
 Example:
 
@@ -206,36 +244,36 @@ compatibility alias for `remoteTools.secureStorage`.
 
 ## Host Connection
 
-Use `connect(null, options)` for the default automatic flow:
+No connection call is needed for a simulator or emulator. On a physical
+device, scan the QR displayed by Studio once:
 
 ```ts
-await Ansight.connect(null, {
+await Ansight.enrollFromQrCode({
   clientName: "My React Native App",
   expectedAppId: "com.example.app",
 });
 ```
 
-Automatic connection tries:
+After physical-device enrollment, `connect(null, options)` and the runtime
+connection loop use the remembered registration:
 
-1. `hostConnection.bundledDeveloperConfigJson`
-2. native remembered host profiles, newest first
-3. saved pairing config
-4. `hostConnection.bundledConfigJson`
+```ts
+await Ansight.connect(null, { clientName: "My React Native App" });
+```
 
-Use explicit payloads for QR, paste, or app-owned import flows:
+When Studio is closed or signed out, automatic attempts remain dormant and
+retry later without failing the React Native app.
+
+If the app already owns a scanner, pass its result through the explicit payload
+API:
 
 ```ts
-await Ansight.connect(pairingJson, {
+await Ansight.connect(enrollmentPayload, {
   clientName: "My React Native App",
   expectedAppId: "com.example.app",
   hostAddressOverride: "192.168.1.20",
 });
 
-await Ansight.savePairingConfig(pairingJson, {
-  expectedAppId: "com.example.app",
-});
-
-await Ansight.clearSavedPairing();
 await Ansight.clearCachedSession();
 await Ansight.disconnect();
 ```
@@ -541,3 +579,14 @@ The first-party validation app lives in:
 It exercises the native runtime bridge, standard native remote tools,
 JavaScript custom tools, React visual-tree tools, SQLite/file fixtures,
 screenshot capture, and touch/session telemetry.
+
+The current-Expo validation app lives in:
+
+```text
+/Users/matthewrobbins/Development/git/ansight-sdk-test-apps/react-native/ansight-expo-harness
+```
+
+It is pinned to Expo SDK 57 and React Native 0.86 with the New Architecture and
+Hermes enabled. It validates Expo CNG/autolinking, the bundled config plugin,
+Android and iOS native builds, and the same live Studio feature surface as the
+baseline harness.

package/android/build.gradle

@@ -66,5 +66,7 @@ repositories {
 
 dependencies {
   implementation("com.facebook.react:react-android")
-  implementation("ai.ansight:ansight-android:1.0.2-preview.8")
+  def ansightAndroidVersion =
+      findProperty("ansightAndroidVersion") ?: "1.2.0-preview.1"
+  implementation("ai.ansight:ansight-android:1.2.0-preview.1")
 }

package/android/src/main/kotlin/ai/ansight/reactnative/AnsightReactNativeModule.kt

@@ -38,6 +38,7 @@ import ai.ansight.runtime.ToolScope
 import ai.ansight.runtime.ToolSecurity
 import ai.ansight.runtime.ToolSecurityLevel
 import ai.ansight.runtime.sendBinaryTransfer
+import ai.ansight.pairing.AnsightPairing
 import ai.ansight.tools.database.AndroidDatabaseRoot
 import ai.ansight.tools.database.AndroidDatabaseToolsOptions
 import ai.ansight.tools.database.withDatabaseTools
@@ -74,6 +75,7 @@ import java.util.concurrent.CountDownLatch
 import java.util.concurrent.Executors
 import java.util.concurrent.TimeUnit
 import java.util.concurrent.atomic.AtomicInteger
+import java.util.concurrent.atomic.AtomicBoolean
 import java.util.Locale
 
 class AnsightReactNativeModule(
@@ -263,6 +265,56 @@ class AnsightReactNativeModule(
         }
     }
 
+    @ReactMethod
+    fun scanPairingQrCode(options: ReadableMap?, promise: Promise) {
+        val activity = reactContext.currentActivity
+        if (activity == null) {
+            promise.reject("ansight_qr_unavailable", "QR pairing is unavailable because no Android activity is available.")
+            return
+        }
+
+        val completed = AtomicBoolean(false)
+        AnsightPairing.scanQrCode(
+            activity = activity,
+            onPayload = { payload ->
+                if (!completed.compareAndSet(false, true)) {
+                    return@scanQrCode
+                }
+                if (payload.isNullOrBlank()) {
+                    promise.resolve(
+                        hostConnectionResultMap(
+                            HostConnectionResult.failure(
+                                message = "QR pairing canceled.",
+                                reasonCode = "pairing_canceled",
+                            ),
+                        ),
+                    )
+                    return@scanQrCode
+                }
+                backgroundExecutor.execute {
+                    runCatching {
+                        hostConnectionResultMap(
+                            AnsightRuntime.connect(
+                                HostConnectionRequest(
+                                    kind = HostConnectionRequestKind.QrCode,
+                                    payload = payload,
+                                    clientName = options.stringValue("clientName"),
+                                    expectedAppId = options.stringValue("expectedAppId"),
+                                    hostAddressOverride = options.stringValue("hostAddressOverride"),
+                                ),
+                            ),
+                        )
+                    }.resolve(promise)
+                }
+            },
+            onError = { error ->
+                if (completed.compareAndSet(false, true)) {
+                    promise.reject("ansight_qr_error", error.message, error)
+                }
+            },
+        )
+    }
+
     @ReactMethod
     fun openSession(pairingPayload: String?, options: ReadableMap?, promise: Promise) {
         backgroundExecutor.execute {
@@ -616,23 +668,14 @@ class AnsightReactNativeModule(
 
     private fun buildOptions(map: ReadableMap?): AnsightOptions {
         val useNativeAllInOneDefaults = map.booleanValue("useNativeAllInOneDefaults", false)
-        val pairingConfigJson = map.stringValue("pairingConfigJson")
         val clientName = map.stringValue("clientName")
         var options = if (useNativeAllInOneDefaults) {
             AnsightDeveloperMode.options(
-                bundledDeveloperConfigJson = pairingConfigJson,
                 clientName = clientName,
             )
         } else {
             AnsightOptions()
         }
-        if (!useNativeAllInOneDefaults && !pairingConfigJson.isNullOrBlank()) {
-            options = options.copy(
-                hostConnection = options.hostConnection.copy(
-                    bundledConfigJson = pairingConfigJson,
-                ),
-            )
-        }
         if (useNativeAllInOneDefaults && !map.hasString("toolGuard")) {
             options = options.copy(toolGuard = AnsightToolGuard.ReadOnly)
         }
@@ -747,7 +790,6 @@ class AnsightReactNativeModule(
                 hostConnection = AnsightHostConnectionOptions(
                     savedConfigKey = host.stringValue("savedConfigKey") ?: options.hostConnection.savedConfigKey,
                     bundledConfigJson = host.stringValue("bundledConfigJson") ?: options.hostConnection.bundledConfigJson,
-                    bundledDeveloperConfigJson = host.stringValue("bundledDeveloperConfigJson") ?: options.hostConnection.bundledDeveloperConfigJson,
                     discoveryPort = host.optionalInt("discoveryPort") ?: options.hostConnection.discoveryPort,
                     allowCellularConnections = host.booleanValue(
                         "allowCellularConnections",
@@ -1018,7 +1060,6 @@ class AnsightReactNativeModule(
             putString("configId", result.configId)
             putString("appId", result.appId)
             putString("resolvedHostAddress", result.resolvedHostAddress)
-            putBoolean("usedEmbeddedDeveloperPairing", result.usedEmbeddedDeveloperPairing)
             putString("discoverySource", result.discoverySource)
             putString("reasonCode", result.reasonCode)
             putString("hostId", result.hostId)
@@ -1038,7 +1079,6 @@ class AnsightReactNativeModule(
                 putString("hostId", session.hostId)
                 putString("hostName", session.hostName)
                 putBoolean("accepted", session.accepted)
-                putBoolean("usedEmbeddedDeveloperPairing", session.usedEmbeddedDeveloperPairing)
                 putString("discoverySource", session.discoverySource)
             }
         }
@@ -1097,7 +1137,6 @@ class AnsightReactNativeModule(
             putMap("hostConnection", mapOf(
                 "savedConfigKey" to options.hostConnection.savedConfigKey,
                 "hasBundledConfigJson" to (options.hostConnection.bundledConfigJson != null),
-                "hasBundledDeveloperConfigJson" to (options.hostConnection.bundledDeveloperConfigJson != null),
                 "discoveryPort" to options.hostConnection.discoveryPort,
                 "allowCellularConnections" to options.hostConnection.allowCellularConnections,
                 "connectionProfileRetentionSeconds" to options.hostConnection.connectionProfileRetentionSeconds,
@@ -1163,7 +1202,7 @@ class AnsightReactNativeModule(
             ?: error("React Native application context is not an Android Application.")
 
     private fun bindCurrentActivity() {
-        val activity: Activity = currentActivity ?: return
+        val activity: Activity = reactContext.currentActivity ?: return
         AnsightRuntime.bindActivity(activity)
     }
 }

package/app.plugin.js

@@ -0,0 +1,3 @@
+"use strict";
+
+module.exports = require("./expo-plugin");

package/expo-plugin.js

@@ -0,0 +1,56 @@
+"use strict";
+
+const DEFAULT_CAMERA_PERMISSION =
+  "Allow $(PRODUCT_NAME) to use the camera to scan an Ansight Studio enrollment QR code.";
+const DEFAULT_LOCAL_NETWORK_PERMISSION =
+  "Allow $(PRODUCT_NAME) to connect to Ansight Studio on your local network during development.";
+
+function withAnsightReactNative(config, options = {}) {
+  const { withInfoPlist } = loadExpoConfigPlugins();
+
+  return withInfoPlist(config, (modConfig) => {
+    const infoPlist = modConfig.modResults;
+
+    applyPermission(
+      infoPlist,
+      "NSCameraUsageDescription",
+      options.cameraPermission,
+      DEFAULT_CAMERA_PERMISSION,
+    );
+    applyPermission(
+      infoPlist,
+      "NSLocalNetworkUsageDescription",
+      options.localNetworkPermission,
+      DEFAULT_LOCAL_NETWORK_PERMISSION,
+    );
+
+    return modConfig;
+  });
+}
+
+function loadExpoConfigPlugins() {
+  const modulePath = require.resolve("expo/config-plugins", {
+    paths: [process.cwd(), __dirname],
+  });
+  return require(modulePath);
+}
+
+function applyPermission(infoPlist, key, configuredValue, defaultValue) {
+  if (configuredValue === false) {
+    return;
+  }
+
+  if (typeof configuredValue === "string" && configuredValue.trim()) {
+    infoPlist[key] = configuredValue;
+    return;
+  }
+
+  if (typeof infoPlist[key] !== "string" || !infoPlist[key].trim()) {
+    infoPlist[key] = defaultValue;
+  }
+}
+
+module.exports = withAnsightReactNative;
+module.exports.default = withAnsightReactNative;
+module.exports.DEFAULT_CAMERA_PERMISSION = DEFAULT_CAMERA_PERMISSION;
+module.exports.DEFAULT_LOCAL_NETWORK_PERMISSION = DEFAULT_LOCAL_NETWORK_PERMISSION;

package/index.d.ts

@@ -104,9 +104,6 @@ export interface AnsightOptions {
    * `hostAutoProbe`, and `hostConnection` explicitly for the workflow.
    */
   useNativeAllInOneDefaults?: boolean;
-  pairingConfig?: string | object;
-  bundledPairingConfig?: string | object;
-  pairingConfigJson?: string;
   clientName?: string;
   sampleFrequencyMilliseconds?: number;
   retentionPeriodSeconds?: number;
@@ -141,7 +138,6 @@ export interface AnsightOptions {
   hostConnection?: {
     savedConfigKey?: string;
     bundledConfigJson?: string;
-    bundledDeveloperConfigJson?: string;
     discoveryPort?: number;
     allowCellularConnections?: boolean;
     connectionProfileRetentionSeconds?: number;
@@ -209,7 +205,6 @@ export interface AnsightHostConnectionResult extends AnsightOperationResult {
   configId?: string;
   appId?: string;
   resolvedHostAddress?: string;
-  usedEmbeddedDeveloperPairing?: boolean;
   discoverySource?: string;
   hostId?: string;
   hostName?: string;
@@ -290,7 +285,6 @@ export class AnsightOptionsBuilder {
     ) => NonNullable<AnsightOptions["hostConnection"]> | void
   ): this;
   withBundledHostConnection(options?: {
-    bundledDeveloperConfigJson?: string;
     bundledConfigJson?: string;
   }): this;
   withHostConnectionDiscoveryPort(discoveryPort: number): this;
@@ -475,6 +469,10 @@ export interface AnsightConnectOptions {
   hostAddressOverride?: string;
 }
 
+export interface AnsightScanPairingOptions extends AnsightConnectOptions {
+  title?: string;
+}
+
 export interface AnsightOpenSessionOptions extends AnsightConnectOptions {}
 
 export interface AnsightSavePairingOptions {
@@ -516,6 +514,9 @@ export function screenViewed(name: string, details?: Record<string, string>): Pr
 export function trackRoute(name: string, details?: Record<string, string>): Promise<AnsightDebugSnapshot>;
 export function setAppLifecycleState(state: AnsightLifecycleState): Promise<AnsightDebugSnapshot>;
 export function connect(pairingPayload?: string | object | null, options?: AnsightConnectOptions): Promise<AnsightHostConnectionResult>;
+/** Scans a one-use Studio invite, registers this installation, and saves automatic reconnect state. */
+export function enrollFromQrCode(options?: AnsightScanPairingOptions): Promise<AnsightHostConnectionResult>;
+export function scanPairingQrCode(options?: AnsightScanPairingOptions): Promise<AnsightHostConnectionResult>;
 export function openSession(pairingPayload: string | object, options?: AnsightOpenSessionOptions): Promise<AnsightHostConnectionResult>;
 export function disconnect(): Promise<AnsightHostConnectionResult>;
 export function completeSession(): Promise<AnsightOperationResult>;
@@ -586,6 +587,8 @@ declare const Ansight: {
   trackRoute: typeof trackRoute;
   setAppLifecycleState: typeof setAppLifecycleState;
   connect: typeof connect;
+  enrollFromQrCode: typeof enrollFromQrCode;
+  scanPairingQrCode: typeof scanPairingQrCode;
   openSession: typeof openSession;
   disconnect: typeof disconnect;
   completeSession: typeof completeSession;

package/index.js

@@ -1,6 +1,15 @@
 "use strict";
 
-const { AppState, NativeEventEmitter, NativeModules, Platform, UIManager, findNodeHandle } = require("react-native");
+const {
+  AppState,
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+  StyleSheet,
+  UIManager,
+  findNodeHandle,
+  processColor,
+} = require("react-native");
 
 const nativeModule = NativeModules.AnsightReactNative;
 
@@ -35,16 +44,7 @@ function normalizePairingPayload(payload) {
 }
 
 function normalizeOptions(options = {}) {
-  const normalized = { ...options };
-  if (normalized.pairingConfig != null) {
-    normalized.pairingConfigJson = normalizePairingPayload(normalized.pairingConfig);
-    delete normalized.pairingConfig;
-  }
-  if (normalized.bundledPairingConfig != null) {
-    normalized.pairingConfigJson = normalizePairingPayload(normalized.bundledPairingConfig);
-    delete normalized.bundledPairingConfig;
-  }
-  return normalized;
+  return { ...options };
 }
 
 function cloneOptions(options = {}) {
@@ -383,10 +383,9 @@ class AnsightOptionsBuilder {
     return this;
   }
 
-  withBundledHostConnection({ bundledDeveloperConfigJson = undefined, bundledConfigJson = undefined } = {}) {
+  withBundledHostConnection({ bundledConfigJson = undefined } = {}) {
     return this.configureHostConnection((hostConnection) => ({
       ...hostConnection,
-      bundledDeveloperConfigJson,
       bundledConfigJson,
     }));
   }
@@ -1402,6 +1401,56 @@ function summarizeProps(props) {
   return summary;
 }
 
+function reactColorToArgbHex(value) {
+  if (value == null) {
+    return undefined;
+  }
+  try {
+    const processed = typeof processColor === "function" ? processColor(value) : null;
+    if (typeof processed === "number") {
+      return `#${(processed >>> 0).toString(16).padStart(8, "0")}`.toUpperCase();
+    }
+  } catch (_) {
+    // Some dynamic platform colors cannot be represented as one resolved color.
+  }
+  return undefined;
+}
+
+function reactVisualText(fiber, props, maxStringLength) {
+  if (fiber.tag === 6) {
+    return sanitizeString(String(fiber.memoizedProps || fiber.pendingProps || ""), maxStringLength);
+  }
+  const children = summarizeReactChildren(props.children);
+  const candidate = typeof children === "string" || typeof children === "number"
+    ? children
+    : props.placeholder ?? props.title ?? props.accessibilityLabel;
+  return candidate == null ? undefined : sanitizeString(String(candidate), maxStringLength);
+}
+
+function createReactVisual(fiber, props, maxStringLength) {
+  const style = StyleSheet && typeof StyleSheet.flatten === "function"
+    ? StyleSheet.flatten(props && props.style)
+    : props && props.style;
+  const opacity = style && Number.isFinite(Number(style.opacity))
+    ? Math.max(0, Math.min(1, Number(style.opacity)))
+    : 1;
+  const visual = { opacity };
+  const foreground = reactColorToArgbHex(style && style.color);
+  const background = reactColorToArgbHex(style && style.backgroundColor);
+  const text = reactVisualText(fiber, props || {}, maxStringLength);
+  if (foreground) visual.foreground = foreground;
+  if (background) visual.background = background;
+  if (text) visual.text = text;
+
+  if (props && !props.secureTextEntry) {
+    const value = props.value ?? props.defaultValue;
+    if (value != null && ["string", "number", "boolean"].includes(typeof value)) {
+      visual.value = sanitizeString(String(value), maxStringLength);
+    }
+  }
+  return visual;
+}
+
 function nativeTagForFiber(fiber) {
   const stateNode = fiber && fiber.stateNode;
   if (!stateNode) {
@@ -1481,6 +1530,7 @@ function serializeFiber(fiber, context, depth) {
     tag: fiber.tag,
     key: fiber.key == null ? null : String(fiber.key),
     depth,
+    visual: createReactVisual(fiber, props, context.maxStringLength),
     children: [],
   };
 
@@ -1555,6 +1605,7 @@ function createShadowTreeNode(fiber, context, depth) {
     tag: fiber.tag,
     key: fiber.key == null ? null : String(fiber.key),
     depth,
+    visual: createReactVisual(fiber, props, context.maxStringLength),
     children: [],
   };
 
@@ -2181,6 +2232,14 @@ function connect(pairingPayload, options = {}) {
   return notifyAfterHostConnectionChange(() => nativeModule.connect(normalizePairingPayload(pairingPayload), options));
 }
 
+function scanPairingQrCode(options = {}) {
+  return notifyAfterHostConnectionChange(() => nativeModule.scanPairingQrCode(options));
+}
+
+function enrollFromQrCode(options = {}) {
+  return scanPairingQrCode(options);
+}
+
 function openSession(pairingPayload, options = {}) {
   return notifyAfterHostConnectionChange(() => nativeModule.openSession(normalizePairingPayload(pairingPayload), options));
 }
@@ -2238,6 +2297,8 @@ const Ansight = {
   trackRoute,
   setAppLifecycleState: (state) => nativeModule.setAppLifecycleState(state),
   connect,
+  enrollFromQrCode,
+  scanPairingQrCode,
   openSession,
   disconnect: () => notifyAfterHostConnectionChange(() => nativeModule.disconnect()),
   completeSession: () => notifyAfterHostConnectionChange(() => nativeModule.completeSession()),
@@ -2302,6 +2363,8 @@ module.exports.default = Ansight;
 module.exports.AnsightOptionsBuilder = AnsightOptionsBuilder;
 module.exports.createOptionsBuilder = createOptionsBuilder;
 module.exports.notifyHostConnectionConfigChanged = Ansight.notifyHostConnectionConfigChanged;
+module.exports.enrollFromQrCode = Ansight.enrollFromQrCode;
+module.exports.scanPairingQrCode = Ansight.scanPairingQrCode;
 module.exports.addHostConnectionStatusListener = addHostConnectionStatusListener;
 module.exports.addLogListener = addLogListener;
 module.exports.registerArtifactProvider = registerArtifactProvider;

package/ios/AnsightReactNative.swift

@@ -350,6 +350,24 @@ final class AnsightReactNative: RCTEventEmitter {
         }
     }
 
+    @objc(scanPairingQrCode:resolver:rejecter:)
+    func scanPairingQrCode(
+        _ options: NSDictionary?,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        Task {
+            let request = HostConnectionRequest.qrCode(
+                title: stringValue(options, "title") ?? "Scan Ansight Enrollment QR",
+                clientName: stringValue(options, "clientName"),
+                expectedAppId: stringValue(options, "expectedAppId"),
+                hostAddressOverride: stringValue(options, "hostAddressOverride"),
+                sourceDescription: "React Native native QR scanner"
+            )
+            resolve(hostConnectionResultDictionary(await AnsightRuntime.shared.connect(request)))
+        }
+    }
+
     @objc(openSession:options:resolver:rejecter:)
     func openSession(
         _ pairingPayload: NSString?,
@@ -411,7 +429,7 @@ final class AnsightReactNative: RCTEventEmitter {
         AnsightRuntime.shared.clearSavedPairing()
         resolve(hostConnectionResultDictionary(HostConnectionResult(
             success: true,
-            message: "Saved pairing config cleared.",
+            message: "Saved registration cleared.",
             kind: .savedConfig,
             source: .savedConfig
         )))
@@ -859,13 +877,6 @@ final class AnsightReactNative: RCTEventEmitter {
         let useNativeAllInOneDefaults = boolValue(dictionary, "useNativeAllInOneDefaults", defaultValue: false)
         var options = useNativeAllInOneDefaults ? AnsightOptions.ansightDeveloperDefaults : AnsightOptions()
 
-        if let value = stringValue(dictionary, "pairingConfigJson") {
-            if useNativeAllInOneDefaults {
-                options.hostConnection.bundledDeveloperConfigJson = value
-            } else {
-                options.hostConnection.bundledConfigJson = value
-            }
-        }
         if useNativeAllInOneDefaults && stringValue(dictionary, "toolGuard") == nil {
             options.toolGuard = .readOnly
         }
@@ -983,7 +994,6 @@ final class AnsightReactNative: RCTEventEmitter {
                     "allowCellularConnections",
                     defaultValue: options.hostConnection.allowCellularConnections
                 ),
-                bundledDeveloperConfigJson: stringValue(host, "bundledDeveloperConfigJson") ?? options.hostConnection.bundledDeveloperConfigJson,
                 bundledConfigJson: stringValue(host, "bundledConfigJson") ?? options.hostConnection.bundledConfigJson
             )
         }
@@ -1092,7 +1102,6 @@ final class AnsightReactNative: RCTEventEmitter {
             "executableTools": snapshot.executableTools,
             "toolDiscoveryEnabled": snapshot.toolDiscoveryEnabled,
             "toolExecutionEnabled": snapshot.toolExecutionEnabled,
-            "embeddedDeveloperPairingAvailable": snapshot.embeddedDeveloperPairingAvailable,
             "detectedBundledTools": snapshot.detectedBundledTools,
             "touchesRecorded": snapshot.touchesCaptured,
             "touchesCaptured": snapshot.touchesCaptured,
@@ -1177,7 +1186,6 @@ final class AnsightReactNative: RCTEventEmitter {
         }
         if let session = result.openSession {
             dictionary["accepted"] = session.accepted
-            dictionary["usedEmbeddedDeveloperPairing"] = session.usedEmbeddedDeveloperPairing
             if let value = session.sessionId {
                 dictionary["sessionId"] = value
             }
@@ -1208,7 +1216,6 @@ final class AnsightReactNative: RCTEventEmitter {
             "success": result.success,
             "message": result.message,
             "accepted": result.accepted,
-            "usedEmbeddedDeveloperPairing": result.usedEmbeddedDeveloperPairing,
         ]
         if let value = result.sessionId {
             dictionary["sessionId"] = value
@@ -1300,7 +1307,6 @@ final class AnsightReactNative: RCTEventEmitter {
                 "connectionProfileRetentionSeconds": options.hostConnection.connectionProfileRetentionSeconds,
                 "discoveryPort": options.hostConnection.discoveryPort as Any,
                 "allowCellularConnections": options.hostConnection.allowCellularConnections,
-                "hasBundledDeveloperConfigJson": options.hostConnection.bundledDeveloperConfigJson != nil,
                 "hasBundledConfigJson": options.hostConnection.bundledConfigJson != nil,
             ],
         ]

package/ios/AnsightReactNativeMemorySampler.mm

@@ -12,10 +12,6 @@
 #include <string>
 #include <unordered_map>
 
-@interface RCTBridge ()
-- (void)invokeAsync:(std::function<void()> &&)func;
-@end
-
 namespace {
 int64_t heapValue(
     const std::unordered_map<std::string, int64_t>& heapInfo,
@@ -89,7 +85,7 @@ int64_t heapValue(
 
   __weak AnsightReactNativeMemorySampler *weakSelf = self;
   __weak RCTBridge *weakBridge = bridge;
-  [bridge invokeAsync:[weakSelf, weakBridge]() {
+  [bridge dispatchBlock:^{
     AnsightReactNativeMemorySampler *strongSelf = weakSelf;
     RCTBridge *strongBridge = weakBridge;
     if (!strongSelf || !strongBridge) {
@@ -101,6 +97,9 @@ int64_t heapValue(
 
     @try {
       try {
+        // RCTBridgeProxy implements both dispatchBlock:queue: and runtime, so
+        // this works with the New Architecture without relying on the legacy
+        // RCTCxxBridge-only invokeAsync: selector.
         RCTCxxBridge *cxxBridge = (RCTCxxBridge *)strongBridge;
         auto *runtime = reinterpret_cast<facebook::jsi::Runtime *>(cxxBridge.runtime);
         if (runtime) {
@@ -124,7 +123,7 @@ int64_t heapValue(
     }
 
     strongSelf->_refreshScheduled.store(false);
-  }];
+  } queue:RCTJSThread];
 }
 
 @end

package/ios/AnsightReactNativeModule.m

@@ -47,6 +47,10 @@ RCT_EXTERN_METHOD(connect:(NSString *)pairingPayload
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(scanPairingQrCode:(NSDictionary *)options
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(openSession:(NSString *)pairingPayload
                   options:(NSDictionary *)options
                   resolver:(RCTPromiseResolveBlock)resolve

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ansight/react-native",
-  "version": "1.0.2-preview.8",
+  "version": "1.2.0-preview.1",
   "description": "React Native bridge for the Ansight mobile SDK.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -25,6 +25,8 @@
     "README.md",
     "index.js",
     "index.d.ts",
+    "app.plugin.js",
+    "expo-plugin.js",
     "tsconfig.json",
     "AnsightReactNative.podspec",
     "react-native.config.js"
@@ -32,6 +34,7 @@
   "keywords": [
     "ansight",
     "react-native",
+    "expo",
     "sdk",
     "debugging",
     "inspection"
@@ -41,7 +44,7 @@
     "react-native": ">=0.72"
   },
   "scripts": {
-    "check": "node --check index.js && tsc --noEmit",
+    "check": "node --check index.js && node --check app.plugin.js && node --check expo-plugin.js && tsc --noEmit",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {