@ansight/react-native 1.0.2-preview.2 → 1.0.2-preview.4

package/README.md

@@ -25,8 +25,8 @@ npx react-native run-android
 
 This package version expects matching native SDK packages:
 
-- CocoaPods: `Ansight`, `AnsightObjC` version `1.0.2-preview.2`
-- Maven: `ai.ansight:ansight-android:1.0.2-preview.2`
+- CocoaPods: `Ansight`, `AnsightObjC` version `1.0.2-preview.4`
+- Maven: `ai.ansight:ansight-android:1.0.2-preview.4`
 
 ## Quickstart
 
@@ -38,6 +38,13 @@ const isDevelopmentOnly = __DEV__;
 await Ansight.initializeAndActivate({
   useNativeAllInOneDefaults: isDevelopmentOnly,
   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,
@@ -59,6 +66,14 @@ does not infer whether the app is a debug build. Gate it with the app's own
 condition, such as React Native's `__DEV__`, and configure `toolGuard`, capture
 options, host auto-probe, and host connection separately.
 
+Host auto-probe uses the native iOS/Android remembered-host retry behavior.
+When enabled and the runtime is active, it retries previous host connections so
+the app can reconnect after the host disappears and later reappears. Probing
+pauses while a live session is connected and resumes after
+`reconnectDelayMilliseconds` when that session is lost. Use
+`withoutHostAutoProbe()` or set `hostAutoProbe.enabled` to `false` for flows
+where reconnects should only happen after an explicit app action.
+
 > **Important:** Screen capture will result in an FPS drop while native frames
 > are rendered, encoded, and sent. Use conservative interval, quality, and
 > max-width settings, and disable `sessionJpegCapture` for performance-focused
@@ -86,7 +101,7 @@ The TypeScript `AnsightOptions` surface mirrors Android `AnsightOptions`, iOS
 | `lifecycleCapture` | Native lifecycle and screen-view capture options. |
 | `toolGuard` | `"disabled"`, `"readOnly"`, `"readWrite"`, or `"fullAccess"`. |
 | `customProperties` | Grouped string properties sent with `session.open`. |
-| `hostAutoProbe` | Automatic host reconnect loop settings. |
+| `hostAutoProbe` | Remembered-host retry settings for reconnecting after the host disappears and later reappears. |
 | `hostConnection` | Saved, bundled, and developer pairing settings. |
 | `secureStorage` | Compatibility alias for native secure-storage allow-list settings. |
 | `remoteTools` | Native visual tree, file, database, preferences, reflection, and secure-storage tool options. |
@@ -112,6 +127,9 @@ await Ansight.initializeAndActivate({
   },
   hostAutoProbe: {
     enabled: true,
+    initialDelayMilliseconds: 1000,
+    probeIntervalMilliseconds: 5000,
+    reconnectDelayMilliseconds: 10000,
     clientName: "My React Native App",
   },
 });
@@ -157,6 +175,12 @@ await Ansight.initializeAndActivate(
 );
 ```
 
+`reflect.list_roots` reports a `hostRuntime` descriptor on each root. Current
+React Native reflection roots are hosted by the native iOS or Android runtime;
+future JavaScript reflection roots should report `kind: "javascript"` and
+`bridge: "react-native"` so callers can route reflection requests to the
+correct runtime boundary.
+
 `secureStorage.preferencesName` is Android-specific. `secureStorage.appleService`
 is iOS-specific. The top-level `secureStorage` option is still accepted as a
 compatibility alias for `remoteTools.secureStorage`.
@@ -175,7 +199,7 @@ await Ansight.connect(null, {
 Automatic connection tries:
 
 1. `hostConnection.bundledDeveloperConfigJson`
-2. native cached host profiles where implemented
+2. native remembered host profiles, newest first
 3. saved pairing config
 4. `hostConnection.bundledConfigJson`
 

package/android/build.gradle

@@ -66,5 +66,5 @@ repositories {
 
 dependencies {
   implementation("com.facebook.react:react-android")
-  implementation("ai.ansight:ansight-android:1.0.2-preview.2")
+  implementation("ai.ansight:ansight-android:1.0.2-preview.4")
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ansight/react-native",
-  "version": "1.0.2-preview.2",
+  "version": "1.0.2-preview.4",
   "description": "React Native bridge for the Ansight mobile SDK.",
   "main": "index.js",
   "types": "index.d.ts",