react-native-ai-devtools-sdk 0.2.0 → 0.2.1

package/README.md

@@ -63,6 +63,40 @@ The AI assistant can then inspect store state directly:
 execute_in_app with expression="globalThis.__RN_AI_DEVTOOLS__.stores.redux.getState()"
 ```
 
+### With navigation
+
+Pass your navigation reference for AI-powered navigation inspection:
+
+```js
+import { init } from 'react-native-ai-devtools-sdk';
+import { navigationRef } from './navigation';
+
+if (__DEV__) {
+  init({
+    navigation: navigationRef,
+  });
+}
+```
+
+### With custom references
+
+Use `custom` to expose any additional tools, services, or objects that don't belong to stores or navigation (e.g. AsyncStorage, MMKV, analytics):
+
+```js
+import { init } from 'react-native-ai-devtools-sdk';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { storage } from './mmkv';
+
+if (__DEV__) {
+  init({
+    custom: {
+      asyncStorage: AsyncStorage,
+      mmkv: storage,
+    },
+  });
+}
+```
+
 ### Configuration options
 
 ```js
@@ -79,6 +113,15 @@ init({
     queryClient: queryClient,
     userStore: useUserStore,
   },
+
+  // Navigation reference
+  navigation: navigationRef,
+
+  // Any additional references for AI access
+  custom: {
+    asyncStorage: AsyncStorage,
+    mmkv: storage,
+  },
 });
 ```
 
@@ -161,13 +204,20 @@ globalThis.__RN_AI_DEVTOOLS__ = {
   capabilities: {
     network: true,
     console: true,
-    stores: true,  // true if stores were passed
-    render: false,  // future: render profiling
+    stores: true,      // true if stores were passed
+    navigation: true,  // true if navigation was passed
+    render: false,     // future: render profiling
   },
 
   // State store references
   stores: { redux: store, queryClient: qc, ... },
 
+  // Navigation reference
+  navigation: navigationRef,
+
+  // Custom references (AsyncStorage, MMKV, etc.)
+  custom: { asyncStorage: AsyncStorage, mmkv: storage, ... },
+
   // Network
   getNetworkRequests(options?),  // { count, method, urlPattern, status }
   getNetworkRequest(id),          // full details including bodies

package/dist/global.d.ts

@@ -8,6 +8,8 @@ export interface ExposeGlobalOptions {
     networkBuffer: NetworkBuffer;
     consoleBuffer: ConsoleBuffer;
     stores: Record<string, unknown>;
+    navigation: unknown;
+    custom: Record<string, unknown>;
     capabilities: Capabilities;
 }
 export declare function exposeGlobal(options: ExposeGlobalOptions): void;

package/dist/global.js

@@ -2,11 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exposeGlobal = exposeGlobal;
 function exposeGlobal(options) {
-    const { networkBuffer, consoleBuffer, stores, capabilities } = options;
+    const { networkBuffer, consoleBuffer, stores, navigation, custom, capabilities } = options;
     const devtools = {
         version: '0.2.0',
         capabilities,
         stores,
+        navigation,
+        custom,
         getNetworkRequests: (opts) => networkBuffer.query(opts),
         getNetworkRequest: (id) => networkBuffer.get(id),
         getNetworkStats: () => networkBuffer.getStats(),

package/dist/index.js

@@ -19,16 +19,21 @@ function init(options) {
     const networkBuffer = new networkBuffer_1.NetworkBuffer(options?.maxNetworkEntries ?? 500);
     const consoleBuffer = new consoleBuffer_1.ConsoleBuffer(options?.maxConsoleEntries ?? 500);
     const stores = options?.stores ?? {};
+    const navigation = options?.navigation ?? null;
+    const custom = options?.custom ?? {};
     (0, networkInterceptor_1.patchFetch)(networkBuffer);
     (0, consoleInterceptor_1.patchConsole)(consoleBuffer);
     (0, global_1.exposeGlobal)({
         networkBuffer,
         consoleBuffer,
         stores,
+        navigation,
+        custom,
         capabilities: {
             network: true,
             console: true,
             stores: Object.keys(stores).length > 0,
+            navigation: navigation != null,
             render: false,
         },
     });

package/dist/types.d.ts

@@ -2,6 +2,9 @@ export interface InitOptions {
     maxNetworkEntries?: number;
     maxConsoleEntries?: number;
     stores?: Record<string, unknown>;
+    navigation?: unknown;
+    /** Named references to any additional tools, services, or objects (e.g. AsyncStorage, MMKV, analytics) that don't belong to stores or navigation. */
+    custom?: Record<string, unknown>;
 }
 export interface NetworkEntry {
     id: string;
@@ -49,12 +52,15 @@ export interface Capabilities {
     network: boolean;
     console: boolean;
     stores: boolean;
+    navigation: boolean;
     render: boolean;
 }
 export interface DevToolsGlobal {
     version: string;
     capabilities: Capabilities;
     stores: Record<string, unknown>;
+    navigation: unknown;
+    custom: Record<string, unknown>;
     getNetworkRequests: (options?: NetworkQueryOptions) => NetworkEntry[];
     getNetworkRequest: (id: string) => NetworkEntry | null;
     getNetworkStats: () => NetworkStats;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-ai-devtools-sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Lightweight SDK for react-native-ai-devtools — captures network requests for AI-powered debugging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,13 @@
     "test": "jest --config jest.config.js",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["react-native", "debugging", "ai", "network", "mcp"],
+  "keywords": [
+    "react-native",
+    "debugging",
+    "ai",
+    "network",
+    "mcp"
+  ],
   "author": "Ihor Zheludkov",
   "license": "MIT",
   "devDependencies": {
@@ -18,5 +24,9 @@
     "ts-jest": "^29.0.0",
     "typescript": "^5.0.0"
   },
-  "files": ["dist", "README.md", "LICENSE"]
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
 }