@ansight/react-native 1.4.0 → 1.5.0

package/README.md

@@ -1,6 +1,14 @@
 # @ansight/react-native
 
-React Native bridge for the Ansight mobile SDK.
+Ansight gives coding agents the runtime evidence to verify their own work in
+React Native and Expo development builds. The SDK captures screenshots, visual trees, touches, logs,
+crashes and unhandled errors, HTTP requests, screen views and navigation, lifecycle events, app events, custom metrics, and sampled memory,
+FPS, frame timing, and battery while the app runs, and exposes app state,
+preferences, secure storage, files, SQLite, artifacts, and your own custom
+tools through guarded remote tools on request. Your agent reads all of it
+through the `ansight` CLI. Nothing leaves your machine unless you export or
+share it. See https://www.ansight.ai and the
+[getting started guide](https://www.ansight.ai/docs/getting-started).
 
 The package is intentionally thin: pairing, transport, telemetry, screen
 capture, touch capture, native tool discovery, and native tool execution are
@@ -80,8 +88,8 @@ bundle; its API requires the native Ansight module.
 
 This package version expects matching native SDK packages:
 
-- CocoaPods: `Ansight`, `AnsightObjC` version `1.4.0`
-- Maven: `ai.ansight:ansight-android:1.4.0`
+- CocoaPods: `Ansight`, `AnsightObjC` version `1.5.0`
+- Maven: `ai.ansight:ansight-android:1.5.0`
 
 ## Quickstart
 
@@ -672,3 +680,7 @@ 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 host feature surface as the
 baseline harness.
+
+## Purchase diagnostics
+
+See [purchase observations, adapters, and remote validation](../../docs/purchases.md) for the base SDK purchase suite.

package/android/build.gradle

@@ -67,6 +67,6 @@ repositories {
 dependencies {
   implementation("com.facebook.react:react-android")
   def ansightAndroidVersion =
-      findProperty("ansightAndroidVersion") ?: "1.4.0"
-  implementation("ai.ansight:ansight-android:1.4.0")
+      findProperty("ansightAndroidVersion") ?: "1.5.0"
+  implementation("ai.ansight:ansight-android:1.5.0")
 }

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

@@ -48,6 +48,8 @@ import ai.ansight.tools.filesystem.AndroidFileSystemRoot
 import ai.ansight.tools.filesystem.AndroidFileSystemToolsOptions
 import ai.ansight.tools.filesystem.withFileSystemTools
 import ai.ansight.tools.preferences.AndroidPreferencesToolsOptions
+import ai.ansight.tools.clipboard.ClipboardToolIds
+import ai.ansight.tools.clipboard.withClipboardTools
 import ai.ansight.tools.preferences.withPreferencesTools
 import ai.ansight.tools.reflection.AndroidReflectionToolsOptions
 import ai.ansight.tools.reflection.withReflectionTools
@@ -135,6 +137,13 @@ class AnsightReactNativeModule(
 
     override fun onHostDestroy() = Unit
 
+    @ReactMethod
+    fun purchaseCommand(json: String, promise: Promise) {
+        try { promise.resolve(ai.ansight.runtime.purchases.PurchaseDiagnostics.shared.command(json)) }
+        catch (error: ai.ansight.runtime.purchases.PurchaseEnvironmentException) { promise.reject(ai.ansight.runtime.purchases.PurchaseEnvironmentException.ERROR_CODE, error.message, error) }
+        catch (error: Exception) { promise.reject("purchases_command_failed", "Purchase command failed.", error) }
+    }
+
     @ReactMethod
     fun addListener(eventName: String) {
         listenerCount.incrementAndGet()
@@ -962,6 +971,11 @@ class AnsightReactNativeModule(
     ): AnsightOptions {
         val remoteTools = map.getMapOrNull("remoteTools")
         val builder = AnsightOptions.createBuilder(this)
+        val clipboardIds = setOf(ClipboardToolIds.GetText, ClipboardToolIds.HasText, ClipboardToolIds.SetText, ClipboardToolIds.Clear)
+        builder.withTools(initialTools.filterNot { it.definition.id in clipboardIds })
+        if (remoteTools.booleanValue("clipboard", true)) {
+            builder.withClipboardTools()
+        }
         if (remoteTools.toolSuiteEnabled("visualTree", enableVisualTreeToolsByDefault)) {
             builder.withVisualTreeTools()
         }

package/index.d.ts

@@ -1,3 +1,6 @@
+import type { PurchaseDiagnostics } from "./purchases";
+export * from "./purchases";
+export const purchases: PurchaseDiagnostics;
 export type AnsightLifecycleState = "unknown" | "foreground" | "background";
 export type AnsightToolPolicy = "read" | "write" | "critical";
 
@@ -144,6 +147,8 @@ export interface AnsightVisualTreeToolsOptions {
 }
 
 export interface AnsightRemoteToolsOptions {
+  /** Include native clipboard tools; defaults to true. */
+  clipboard?: boolean;
   visualTree?: boolean | AnsightVisualTreeToolsOptions;
   fileSystem?: AnsightFileSystemToolsOptions;
   database?: AnsightDatabaseToolsOptions;
@@ -392,6 +397,7 @@ export class AnsightOptionsBuilder {
   withoutVisualTreeTools(): this;
   withFileSystemTools(options?: AnsightFileSystemToolsOptions): this;
   withDatabaseTools(options?: AnsightDatabaseToolsOptions): this;
+  withClipboardTools(enabled?: boolean): this;
   withPreferencesTools(options?: AnsightPreferencesToolsOptions): this;
   withReflectionTools(options?: AnsightReflectionToolsOptions): this;
   build(): AnsightOptions;
@@ -676,6 +682,7 @@ export function installErrorHandlers(options?: { chain?: boolean }): () => void;
 export function createReactNavigationTracker(navigationRef: unknown, options?: { recordInitial?: boolean }): ReactNavigationTracker;
 
 declare const Ansight: {
+  purchases: PurchaseDiagnostics;
   initialize: typeof initialize;
   initializeAndActivate: typeof initializeAndActivate;
   activate: typeof activate;

package/index.js

@@ -608,6 +608,11 @@ class AnsightOptionsBuilder {
     return this;
   }
 
+  withClipboardTools(enabled = true) {
+    this._options.remoteTools = { ...this._options.remoteTools, clipboard: enabled };
+    return this;
+  }
+
   withPreferencesTools(options = {}) {
     this._options.remoteTools = {
       ...(this._options.remoteTools || {}),
@@ -2669,3 +2674,6 @@ module.exports.recordNetworkRequest = recordNetworkRequest;
 module.exports.installNetworkCapture = installNetworkCapture;
 module.exports.uninstallNetworkCapture = uninstallNetworkCapture;
 module.exports.sanitizeNetworkRequest = sanitizeNetworkRequest;
+
+module.exports.purchases = require("./purchases").createPurchaseDiagnostics((json) => nativeModule.purchaseCommand(json));
+module.exports.createPurchaseDiagnostics = require("./purchases").createPurchaseDiagnostics;

package/ios/AnsightReactNative.swift

@@ -4,6 +4,15 @@ import React
 
 @objc(AnsightReactNative)
 final class AnsightReactNative: RCTEventEmitter {
+    @objc(purchaseCommand:resolver:rejecter:)
+    func purchaseCommand(_ json: String, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        Task {
+            do { resolve(try await PurchaseDiagnostics.shared.commandAsync(json)) }
+            catch PurchaseDiagnosticsError.environmentNotAllowed { reject(PurchaseDiagnosticsError.environmentErrorCode, "Purchase interop is restricted to simulators and emulators.", PurchaseDiagnosticsError.environmentNotAllowed) }
+            catch { reject("purchases_command_failed", "Purchase command failed.", error) }
+        }
+    }
+
     private final class PendingToolCall {
         let semaphore = DispatchSemaphore(value: 0)
         var result: AnsightToolExecutionResult?
@@ -1153,6 +1162,7 @@ final class AnsightReactNative: RCTEventEmitter {
                 remoteTools?["visualTree"],
                 defaultValue: useNativeAllInOneDefaults
             ),
+            clipboard: boolValue(remoteTools, "clipboard", defaultValue: true),
             database: databaseToolsOptions(remoteTools?["database"] as? NSDictionary),
             fileSystem: fileSystemToolsOptions(remoteTools?["fileSystem"] as? NSDictionary),
             preferences: preferencesToolsOptions(remoteTools?["preferences"] as? NSDictionary),

package/ios/AnsightReactNativeModule.m

@@ -3,6 +3,10 @@
 
 @interface RCT_EXTERN_MODULE(AnsightReactNative, RCTEventEmitter)
 
+RCT_EXTERN_METHOD(purchaseCommand:(NSString *)json
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(initialize:(NSDictionary *)options
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ansight/react-native",
-  "version": "1.4.0",
-  "description": "React Native bridge for the Ansight mobile SDK.",
+  "version": "1.5.0",
+  "description": "React Native bridge for Ansight: runtime evidence from your app for coding agents. Screenshots, UI trees, logs, network, telemetry, and app state.",
   "main": "index.js",
   "types": "index.d.ts",
   "license": "SEE LICENSE IN LICENSE",
@@ -34,7 +34,9 @@
     "expo-plugin.js",
     "tsconfig.json",
     "AnsightReactNative.podspec",
-    "react-native.config.js"
+    "react-native.config.js",
+    "purchases.js",
+    "purchases.d.ts"
   ],
   "keywords": [
     "ansight",

package/purchases.d.ts

@@ -0,0 +1,61 @@
+export interface PurchaseObservation {
+  productId: string;
+  source: "store" | "app" | "backend";
+  transactionRef?: string | null;
+  observedAt?: number;
+  state?: "unknown" | "pending" | "purchased" | "cancelled" | "expired" | "revoked" | "failed" | "gracePeriod" | "billingRetry";
+  verification?: "unknown" | "verified" | "unverified";
+  entitled?: boolean | null;
+  deliveryCount?: number | null;
+  finished?: boolean | null;
+  acknowledged?: boolean | null;
+  consumed?: boolean | null;
+  expiresAt?: number | null;
+  gracePeriodExpiresAt?: number | null;
+  environment?: "unknown" | "xcode" | "sandbox" | "production";
+  productType?: "unknown" | "consumable" | "nonConsumable" | "subscription" | "nonRenewingSubscription";
+}
+export interface PurchaseProduct {
+  productId: string;
+  available: boolean;
+  observedAt?: number;
+  displayPrice?: string | null;
+  price?: string | null;
+  currencyCode?: string | null;
+  productType?: PurchaseObservation["productType"];
+}
+export interface PurchaseExpectations {
+  transactionRef?: string;
+  productId: string;
+  expectedEntitled: boolean;
+  requireVerified?: boolean;
+  requireBackendVerification?: boolean;
+  expectedDeliveryCount?: number;
+  maxAgeMilliseconds?: number;
+}
+export interface PurchaseSnapshot {
+  schema: "ansight.purchases.v1";
+  capturedAt: number;
+  droppedEvents: number;
+  coverage: "observedOnly";
+  observations: PurchaseObservation[];
+  products: PurchaseProduct[];
+}
+export interface PurchaseValidationReport extends PurchaseSnapshot {
+  status: "pass" | "fail" | "inconclusive";
+  checks: { source: string; status: "pass" | "fail" | "inconclusive"; reason: string }[];
+}
+export interface PurchaseDiagnostics {
+  createTransactionReference(identifier: string): Promise<{ transactionRef: string }>;
+  /** Register read-only remote tools after SDK initialization. */
+  register(): Promise<{ success: boolean }>;
+  record(observation: PurchaseObservation): Promise<{ success: boolean }>;
+  recordProduct(product: PurchaseProduct): Promise<{ success: boolean }>;
+  /** Clear evidence on account switch. Does not clear store transactions. */
+  clear(): Promise<{ success: boolean }>;
+  snapshot(productId?: string): Promise<PurchaseSnapshot>;
+  validate(expectations: PurchaseExpectations): Promise<PurchaseValidationReport>;
+  /** Apple only. Reads StoreKit 2 using known product IDs. */
+  refreshStoreKit(productIds: string[]): Promise<PurchaseSnapshot>;
+}
+export function createPurchaseDiagnostics(send: (json: string) => Promise<string>): PurchaseDiagnostics;

package/purchases.js

@@ -0,0 +1,17 @@
+"use strict";
+
+// All observation retention, validation and tools live in the native base SDK.
+function createPurchaseDiagnostics(send) {
+  const command = async (action, fields = {}) => JSON.parse(await send(JSON.stringify({ action, ...fields })));
+  return {
+    createTransactionReference: (identifier) => command("reference", { identifier }),
+    register: () => command("register"),
+    record: (observation) => command("record", { observation: { observedAt: Date.now(), ...observation } }),
+    recordProduct: (product) => command("recordProduct", { product: { observedAt: Date.now(), productType: "unknown", ...product } }),
+    clear: () => command("clear"),
+    snapshot: (productId) => command("purchases.get_state", { arguments: productId === undefined ? {} : { productId } }),
+    validate: (expectations) => command("purchases.validate", { arguments: expectations }),
+    refreshStoreKit: (productIds) => command("refreshStoreKit", { productIds }),
+  };
+}
+module.exports = { createPurchaseDiagnostics };