react-native-ai-devtools-sdk 0.2.0 → 0.3.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/consoleBuffer.d.ts

@@ -1,13 +1,9 @@
-import { ConsoleEntry, ConsoleQueryOptions } from './types';
+import { ConsoleEntry } from './types';
 export declare class ConsoleBuffer {
     private entries;
     private maxSize;
     constructor(maxSize?: number);
     add(entry: ConsoleEntry): void;
-    query(options?: ConsoleQueryOptions): ConsoleEntry[];
-    getStats(): {
-        total: number;
-        byLevel: Record<string, number>;
-    };
+    getAll(): ConsoleEntry[];
     clear(): number;
 }

package/dist/consoleBuffer.js

@@ -12,26 +12,8 @@ class ConsoleBuffer {
         }
         this.entries.push(entry);
     }
-    query(options) {
-        let results = [...this.entries].reverse();
-        if (options?.level) {
-            results = results.filter((e) => e.level === options.level);
-        }
-        if (options?.text) {
-            const text = options.text.toLowerCase();
-            results = results.filter((e) => e.message.toLowerCase().includes(text));
-        }
-        if (options?.count != null && options.count > 0) {
-            results = results.slice(0, options.count);
-        }
-        return results;
-    }
-    getStats() {
-        const byLevel = {};
-        for (const entry of this.entries) {
-            byLevel[entry.level] = (byLevel[entry.level] || 0) + 1;
-        }
-        return { total: this.entries.length, byLevel };
+    getAll() {
+        return [...this.entries];
     }
     clear() {
         const count = this.entries.length;

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,16 +2,16 @@
 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',
+        version: '0.3.0',
         capabilities,
         stores,
-        getNetworkRequests: (opts) => networkBuffer.query(opts),
-        getNetworkRequest: (id) => networkBuffer.get(id),
-        getNetworkStats: () => networkBuffer.getStats(),
+        navigation,
+        custom,
+        getNetworkEntries: () => networkBuffer.getAll(),
+        getConsoleEntries: () => consoleBuffer.getAll(),
         clearNetwork: () => networkBuffer.clear(),
-        getConsoleLogs: (opts) => consoleBuffer.query(opts),
         clearConsole: () => consoleBuffer.clear(),
     };
     globalThis.__RN_AI_DEVTOOLS__ = devtools;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { InitOptions } from './types';
-export type { InitOptions, NetworkEntry, NetworkQueryOptions, NetworkStats, ConsoleEntry, ConsoleQueryOptions, Capabilities, DevToolsGlobal, } from './types';
+export type { InitOptions, NetworkEntry, ConsoleEntry, Capabilities, DevToolsGlobal, } from './types';
 export declare function init(options?: InitOptions): void;
 export declare function _resetForTesting(): void;

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/networkBuffer.d.ts

@@ -1,4 +1,4 @@
-import { NetworkEntry, NetworkQueryOptions, NetworkStats } from './types';
+import { NetworkEntry } from './types';
 export declare class NetworkBuffer {
     private entries;
     private order;
@@ -7,7 +7,6 @@ export declare class NetworkBuffer {
     add(entry: NetworkEntry): void;
     update(id: string, updates: Partial<NetworkEntry>): void;
     get(id: string): NetworkEntry | null;
-    query(options?: NetworkQueryOptions): NetworkEntry[];
-    getStats(): NetworkStats;
+    getAll(): NetworkEntry[];
     clear(): number;
 }

package/dist/networkBuffer.js

@@ -27,66 +27,8 @@ class NetworkBuffer {
     get(id) {
         return this.entries.get(id) ?? null;
     }
-    query(options) {
-        let results = Array.from(this.order)
-            .map((id) => this.entries.get(id))
-            .reverse();
-        if (options?.method) {
-            const method = options.method.toUpperCase();
-            results = results.filter((e) => e.method === method);
-        }
-        if (options?.urlPattern) {
-            const pattern = options.urlPattern.toLowerCase();
-            results = results.filter((e) => e.url.toLowerCase().includes(pattern));
-        }
-        if (options?.status != null) {
-            results = results.filter((e) => e.status === options.status);
-        }
-        if (options?.count != null && options.count > 0) {
-            results = results.slice(0, options.count);
-        }
-        return results;
-    }
-    getStats() {
-        const all = Array.from(this.entries.values());
-        const completed = all.filter((e) => e.completed && !e.error);
-        const errors = all.filter((e) => !!e.error);
-        const durations = completed
-            .map((e) => e.duration)
-            .filter((d) => d != null);
-        const avgDuration = durations.length > 0
-            ? durations.reduce((sum, d) => sum + d, 0) / durations.length
-            : null;
-        const byMethod = {};
-        for (const entry of all) {
-            byMethod[entry.method] = (byMethod[entry.method] || 0) + 1;
-        }
-        const byStatus = {};
-        for (const entry of all) {
-            if (entry.status != null) {
-                const group = `${Math.floor(entry.status / 100)}xx`;
-                byStatus[group] = (byStatus[group] || 0) + 1;
-            }
-        }
-        const byDomain = {};
-        for (const entry of all) {
-            try {
-                const domain = new URL(entry.url).hostname;
-                byDomain[domain] = (byDomain[domain] || 0) + 1;
-            }
-            catch {
-                // skip malformed URLs
-            }
-        }
-        return {
-            total: all.length,
-            completed: completed.length,
-            errors: errors.length,
-            avgDuration,
-            byMethod,
-            byStatus,
-            byDomain,
-        };
+    getAll() {
+        return this.order.map((id) => this.entries.get(id));
     }
     clear() {
         const count = this.entries.size;

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;
@@ -19,46 +22,27 @@ export interface NetworkEntry {
     error?: string;
     completed: boolean;
 }
-export interface NetworkQueryOptions {
-    count?: number;
-    method?: string;
-    urlPattern?: string;
-    status?: number;
-}
-export interface NetworkStats {
-    total: number;
-    completed: number;
-    errors: number;
-    avgDuration: number | null;
-    byMethod: Record<string, number>;
-    byStatus: Record<string, number>;
-    byDomain: Record<string, number>;
-}
 export interface ConsoleEntry {
     id: string;
     timestamp: number;
     level: 'log' | 'warn' | 'error' | 'info' | 'debug';
     message: string;
 }
-export interface ConsoleQueryOptions {
-    count?: number;
-    level?: 'log' | 'warn' | 'error' | 'info' | 'debug';
-    text?: string;
-}
 export interface Capabilities {
     network: boolean;
     console: boolean;
     stores: boolean;
+    navigation: boolean;
     render: boolean;
 }
 export interface DevToolsGlobal {
     version: string;
     capabilities: Capabilities;
     stores: Record<string, unknown>;
-    getNetworkRequests: (options?: NetworkQueryOptions) => NetworkEntry[];
-    getNetworkRequest: (id: string) => NetworkEntry | null;
-    getNetworkStats: () => NetworkStats;
+    navigation: unknown;
+    custom: Record<string, unknown>;
+    getNetworkEntries: () => NetworkEntry[];
+    getConsoleEntries: () => ConsoleEntry[];
     clearNetwork: () => number;
-    getConsoleLogs: (options?: ConsoleQueryOptions) => ConsoleEntry[];
     clearConsole: () => number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-ai-devtools-sdk",
-  "version": "0.2.0",
+  "version": "0.3.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"
+  ]
 }