react-native-debug-toolkit 3.3.4 → 3.5.0

package/lib/typescript/src/utils/createPersistedObservableStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPersistedObservableStore.d.ts","sourceRoot":"","sources":["../../../../src/utils/createPersistedObservableStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGtF,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACrE,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,wBAAwB,CAAC,CAAC,CAAC,CAsE7B"}
+{"version":3,"file":"createPersistedObservableStore.d.ts","sourceRoot":"","sources":["../../../../src/utils/createPersistedObservableStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACrE,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,wBAAwB,CAAC,CAAC,CAAC,CA4E7B"}

package/lib/typescript/src/utils/debugPreferences.d.ts

@@ -1,13 +1,10 @@
 export declare function setPreference(key: string, value: string): Promise<void>;
 export declare function getPreference(key: string): Promise<string | null>;
+export declare function removePreference(key: string): Promise<void>;
 export declare const KEYS: {
     readonly fabPosition: "@react_native_debug_toolkit/fab_position";
     readonly lastTab: "@react_native_debug_toolkit/last_tab";
-    readonly consoleLogs: "@react_native_debug_toolkit/console_logs";
-    readonly networkLogs: "@react_native_debug_toolkit/network_logs";
-    readonly trackLogs: "@react_native_debug_toolkit/track_logs";
     readonly computerHost: "@react_native_debug_toolkit/computer_host";
-    readonly metroPort: "@react_native_debug_toolkit/metro_port";
     readonly daemonPort: "@react_native_debug_toolkit/daemon_port";
 };
 //# sourceMappingURL=debugPreferences.d.ts.map

package/lib/typescript/src/utils/debugPreferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugPreferences.d.ts","sourceRoot":"","sources":["../../../../src/utils/debugPreferences.ts"],"names":[],"mappings":"AAkCA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7E;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BvE;AAED,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC"}
+{"version":3,"file":"debugPreferences.d.ts","sourceRoot":"","sources":["../../../../src/utils/debugPreferences.ts"],"names":[],"mappings":"AA0CA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7E;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BvE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBjE;AAED,eAAO,MAAM,IAAI;;;;;CAKP,CAAC"}

package/lib/typescript/src/utils/deviceReport.d.ts

@@ -20,6 +20,7 @@ export interface DebugDeviceReport {
     session?: SessionInfo;
     logs: Record<string, unknown[] | undefined>;
 }
+export declare function sanitizeDebugLogEntry(value: unknown, maxBodyBytes?: number): unknown;
 export declare function createDebugDeviceReport(options?: DebugDeviceReportOptions & {
     featureProvider?: FeatureDataProvider;
     session?: SessionInfo;

package/lib/typescript/src/utils/deviceReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceReport.d.ts","sourceRoot":"","sources":["../../../../src/utils/deviceReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAOpD,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;CAC7C;AAuID,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAAwB,GAAG;IAAE,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,GACxG,iBAAiB,CAyCnB"}
+{"version":3,"file":"deviceReport.d.ts","sourceRoot":"","sources":["../../../../src/utils/deviceReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAOpD,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;CAC7C;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAyB,GAAG,OAAO,CAEpG;AAuID,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAAwB,GAAG;IAAE,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,GACxG,iBAAiB,CAyCnB"}

package/lib/typescript/src/utils/logRuntime.d.ts

@@ -0,0 +1,13 @@
+import { SessionManager, type SessionManagerOptions } from './SessionManager';
+import { type StorageAdapter } from './StorageAdapter';
+export interface LogRuntimeContext {
+    logStorage: StorageAdapter;
+    sessionManager: SessionManager;
+}
+export interface LogRuntimeOptions extends SessionManagerOptions {
+    logStorage?: StorageAdapter;
+}
+export declare function createLogRuntime(options?: LogRuntimeOptions): LogRuntimeContext;
+export declare function setDefaultLogRuntime(runtime: LogRuntimeContext | null): void;
+export declare function getDefaultLogRuntime(): LogRuntimeContext;
+//# sourceMappingURL=logRuntime.d.ts.map

package/lib/typescript/src/utils/logRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logRuntime.d.ts","sourceRoot":"","sources":["../../../../src/utils/logRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,cAAc,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAID,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,iBAAiB,CASnF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE5E;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAMxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-debug-toolkit",
-  "version": "3.3.4",
+  "version": "3.5.0",
   "description": "A local-first React Native debug toolkit with Web Console, HTTP API, and MCP support for AI-readable app logs",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -10,9 +10,6 @@
     "lib",
     "bin",
     "node",
-    "scripts",
-    "app.plugin.js",
-    "dev-client.js",
     "ios",
     "android",
     "react-native-debug-toolkit.podspec",
@@ -57,12 +54,20 @@
   },
   "peerDependencies": {
     "@react-native-clipboard/clipboard": ">=1.0.0",
+    "@react-native-async-storage/async-storage": ">=1.0.0",
+    "react-native-mmkv": ">=2.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.72.0"
   },
   "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": true
+    },
     "@react-native-clipboard/clipboard": {
       "optional": true
+    },
+    "react-native-mmkv": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -96,7 +101,6 @@
     ]
   },
   "dependencies": {
-    "@babel/runtime": "^7.29.2",
-    "xcode": "^3.0.1"
+    "@babel/runtime": "^7.29.2"
   }
 }

package/src/constants/logLevels.ts

@@ -0,0 +1,13 @@
+export const LEVEL_COLORS: Record<string, string> = {
+  log: '#8E8E93',
+  info: '#007AFF',
+  warn: '#FF9500',
+  error: '#FF3B30',
+};
+
+export const LEVEL_ICONS: Record<string, string> = {
+  log: '●',
+  info: 'ℹ',
+  warn: '⚠',
+  error: '✕',
+};

package/src/core/initialize.ts

@@ -12,8 +12,15 @@ import type { TrackFeatureConfig } from '../features/track';
 import { createEnvironmentFeature } from '../features/environment';
 import { createClipboardFeature } from '../features/clipboard';
 import { createDevConnectFeature, restoreDevConnectSettingsToDaemon, nativeIsDebugBuild } from '../features/devConnect';
+import { createSessionHistoryFeature } from '../features/sessionHistory';
 import { daemonClient } from '../utils/DaemonClient';
 import type { AnyDebugFeature, BuiltInFeatureName } from '../types';
+import type { StorageAdapter } from '../utils/StorageAdapter';
+import {
+  createLogRuntime,
+  setDefaultLogRuntime,
+  type LogRuntimeContext,
+} from '../utils/logRuntime';
 
 const isDebugMode = __DEV__;
 
@@ -27,25 +34,31 @@ export interface FeatureConfigs {
   environment?: Parameters<typeof createEnvironmentFeature>[0];
   clipboard?: boolean;
   devConnect?: boolean;
+  sessionHistory?: boolean;
 }
 
 export interface InitializeOptions {
   features?: FeatureConfigs;
+  customFeatures?: AnyDebugFeature[];
   enabled?: boolean;
+  logStorage?: StorageAdapter;
+  maxLogSessions?: number;
 }
 
+type EnvironmentFeatureConfig = Parameters<typeof createEnvironmentFeature>[0];
+type BuiltInFeatureCreator = (config?: unknown, runtime?: LogRuntimeContext) => AnyDebugFeature;
+
 /** Registry mapping feature names to creator functions */
-// Config param requires `any` — each factory accepts a different config type.
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const featureRegistry: Record<BuiltInFeatureName, (config?: any) => AnyDebugFeature> = {
-  network: createNetworkFeature,
-  console: createConsoleLogFeature,
-  zustand: createZustandLogFeature,
-  navigation: createNavigationLogFeature,
-  track: createTrackFeature,
-  environment: createEnvironmentFeature,
-  clipboard: createClipboardFeature,
-  devConnect: createDevConnectFeature,
+const featureRegistry: Record<BuiltInFeatureName, BuiltInFeatureCreator> = {
+  network: (config, runtime) => createNetworkFeature(config as NetworkFeatureConfig | undefined, runtime),
+  console: (config, runtime) => createConsoleLogFeature(config as ConsoleFeatureConfig | undefined, runtime),
+  zustand: (config) => createZustandLogFeature(config as ZustandFeatureConfig | undefined),
+  navigation: (config) => createNavigationLogFeature(config as NavigationFeatureConfig | undefined),
+  track: (config, runtime) => createTrackFeature(config as TrackFeatureConfig | undefined, runtime),
+  environment: (config) => createEnvironmentFeature(config as EnvironmentFeatureConfig | undefined),
+  clipboard: () => createClipboardFeature(),
+  devConnect: () => createDevConnectFeature(),
+  sessionHistory: (_config, runtime) => createSessionHistoryFeature(runtime),
 };
 
 const DEFAULT_FEATURES: BuiltInFeatureName[] = [
@@ -56,14 +69,17 @@ const DEFAULT_FEATURES: BuiltInFeatureName[] = [
   'track',
   'clipboard',
   'devConnect',
+  'sessionHistory',
 ];
 
-function resolveFeatureConfigs(configs: FeatureConfigs): AnyDebugFeature[] {
+function resolveFeatureConfigs(configs: FeatureConfigs, runtime: LogRuntimeContext): AnyDebugFeature[] {
   const features: AnyDebugFeature[] = [];
   const entries = Object.entries(configs) as [BuiltInFeatureName, unknown][];
 
   for (const [name, config] of entries) {
-    if (config === false) continue;
+    if (config === false) {
+      continue;
+    }
 
     const creator = featureRegistry[name];
     if (!creator) {
@@ -72,17 +88,28 @@ function resolveFeatureConfigs(configs: FeatureConfigs): AnyDebugFeature[] {
     }
 
     if (config === true || config === undefined) {
-      features.push(creator());
+      features.push(creator(undefined, runtime));
     } else if (typeof config === 'object') {
-      features.push(creator(config as Record<string, unknown>));
+      features.push(creator(config as Record<string, unknown>, runtime));
     }
   }
 
   return features;
 }
 
-function resolveDefaultFeatures(): AnyDebugFeature[] {
-  return DEFAULT_FEATURES.map((name) => featureRegistry[name]!());
+function resolveDefaultFeatures(runtime: LogRuntimeContext): AnyDebugFeature[] {
+  return DEFAULT_FEATURES.map((name) => featureRegistry[name]!(undefined, runtime));
+}
+
+function appendCustomFeatures(
+  builtInFeatures: AnyDebugFeature[],
+  customFeatures?: AnyDebugFeature[],
+): AnyDebugFeature[] {
+  if (!customFeatures || customFeatures.length === 0) {
+    return builtInFeatures;
+  }
+
+  return [...builtInFeatures, ...customFeatures];
 }
 
 /**
@@ -111,19 +138,32 @@ export async function initializeDebugToolkit(
     }
   }
 
-  const resolvedFeatures = options?.features
-    ? resolveFeatureConfigs(options.features)
-    : resolveDefaultFeatures();
-
   try {
     DebugToolkit.setEnabled(enabled);
 
     if (!enabled) {
+      daemonClient.clearSessionProvider();
       DebugToolkit.reset();
       return DebugToolkit;
     }
 
+    const runtime = createLogRuntime({
+      logStorage: options?.logStorage,
+      maxSessions: options?.maxLogSessions,
+    });
+    setDefaultLogRuntime(runtime);
+    daemonClient.setSessionProvider(() => runtime.sessionManager.getCurrentSession());
+
+    const resolvedBuiltInFeatures = options?.features
+      ? resolveFeatureConfigs(options.features, runtime)
+      : resolveDefaultFeatures(runtime);
+    const resolvedFeatures = appendCustomFeatures(
+      resolvedBuiltInFeatures,
+      options?.customFeatures,
+    );
+
     DebugToolkit.replaceFeatures(resolvedFeatures);
+    runtime.sessionManager.initialize().catch(() => {});
 
     daemonClient.setEndpointDetector((url) => {
       addToBlacklist(url);

package/src/features/console/ConsoleLogTab.tsx

@@ -7,22 +7,9 @@ import { JsonView } from '../../ui/shared/JsonView';
 import { CopyButton } from '../../ui/shared/CopyButton';
 import { LogListScreen } from '../../ui/shared/LogListScreen';
 import { fmt } from '../../utils/copyToComputer';
+import { LEVEL_COLORS, LEVEL_ICONS } from '../../constants/logLevels';
 import type { ConsoleLogEntry, DebugFeatureRenderProps } from '../../types';
 
-const LEVEL_COLORS: Record<string, string> = {
-  log: '#8E8E93',
-  info: '#007AFF',
-  warn: '#FF9500',
-  error: '#FF3B30',
-};
-
-const LEVEL_ICONS: Record<string, string> = {
-  log: '●',
-  info: 'ℹ',
-  warn: '⚠',
-  error: '✕',
-};
-
 export const ConsoleLogTab: React.FC<DebugFeatureRenderProps<ConsoleLogEntry[]>> = React.memo(({ snapshot }) => (
   <LogListScreen
     data={snapshot}

package/src/features/console/index.ts

@@ -1,7 +1,7 @@
 import { ConsoleLogTab } from './ConsoleLogTab';
 import type { ConsoleLogEntry, DebugFeature } from '../../types';
 import { createPersistedObservableStore } from '../../utils/createPersistedObservableStore';
-import { KEYS } from '../../utils/debugPreferences';
+import { getDefaultLogRuntime, type LogRuntimeContext } from '../../utils/logRuntime';
 
 const LEVELS: ConsoleLogEntry['level'][] = ['log', 'info', 'warn', 'error'];
 
@@ -13,7 +13,9 @@ const consoleCapture = (() => {
 
   function stop(): void {
     refCount = Math.max(0, refCount - 1);
-    if (refCount > 0) return;
+    if (refCount > 0) {
+      return;
+    }
 
     LEVELS.forEach((level) => {
       const original = originalMethods[level];
@@ -78,10 +80,14 @@ export interface ConsoleFeatureConfig {
   maxLogs?: number;
 }
 
-export const createConsoleLogFeature = (config?: ConsoleFeatureConfig): DebugFeature<ConsoleLogEntry[]> => {
+export const createConsoleLogFeature = (
+  config?: ConsoleFeatureConfig,
+  runtime: LogRuntimeContext = getDefaultLogRuntime(),
+): DebugFeature<ConsoleLogEntry[]> => {
   const maxLogs = config?.maxLogs ?? DEFAULT_MAX_LOGS;
   const logStore = createPersistedObservableStore<ConsoleLogEntry>({
-    storageKey: KEYS.consoleLogs,
+    storage: runtime.logStorage,
+    storageKey: runtime.sessionManager.getLogStorageKey('console_logs'),
     maxPersist: 50,
   });
   let initialized = false;
@@ -92,7 +98,9 @@ export const createConsoleLogFeature = (config?: ConsoleFeatureConfig): DebugFea
     label: 'Console',
     renderContent: ConsoleLogTab,
     setup: () => {
-      if (initialized) return;
+      if (initialized) {
+        return;
+      }
 
       stopCapture = consoleCapture.start((entry) => {
         logStore.push({ ...entry, id: logStore.nextId() }, maxLogs);
@@ -100,13 +108,15 @@ export const createConsoleLogFeature = (config?: ConsoleFeatureConfig): DebugFea
       initialized = true;
     },
     getSnapshot: () => logStore.getData(),
-    clear: () => { logStore.clear(); },
+    clear: () => { logStore.clearPersisted(); },
     cleanup: () => {
-      if (!initialized) return;
+      if (!initialized) {
+        return;
+      }
 
       stopCapture?.();
       stopCapture = null;
-      logStore.clear();
+      logStore.dispose();
       initialized = false;
     },
     subscribe: (listener) => logStore.subscribe(listener),