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

package/README.md

@@ -25,39 +25,26 @@ npx react-native run-android
 
 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.1.0-preview.1`
+- Maven: `ai.ansight:ansight-android:1.1.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 +79,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 +93,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 +110,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 +192,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();
 ```

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.1.0-preview.1"
+  implementation("ai.ansight:ansight-android:1.1.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 = 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,

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

@@ -35,16 +35,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 +374,9 @@ class AnsightOptionsBuilder {
     return this;
   }
 
-  withBundledHostConnection({ bundledDeveloperConfigJson = undefined, bundledConfigJson = undefined } = {}) {
+  withBundledHostConnection({ bundledConfigJson = undefined } = {}) {
     return this.configureHostConnection((hostConnection) => ({
       ...hostConnection,
-      bundledDeveloperConfigJson,
       bundledConfigJson,
     }));
   }
@@ -2181,6 +2171,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 +2236,8 @@ const Ansight = {
   trackRoute,
   setAppLifecycleState: (state) => nativeModule.setAppLifecycleState(state),
   connect,
+  enrollFromQrCode,
+  scanPairingQrCode,
   openSession,
   disconnect: () => notifyAfterHostConnectionChange(() => nativeModule.disconnect()),
   completeSession: () => notifyAfterHostConnectionChange(() => nativeModule.completeSession()),
@@ -2302,6 +2302,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/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.1.0-preview.1",
   "description": "React Native bridge for the Ansight mobile SDK.",
   "main": "index.js",
   "types": "index.d.ts",