react-native-inapp-inspector 1.1.34 → 2.0.0

package/dist/esm/customHooks/performanceTracker.d.ts

@@ -77,6 +77,8 @@ export declare function getCallerSourceFile(fallbackName?: string): string;
 export declare const getInitialRenderProfiles: () => ComponentRenderProfile[];
 export declare const getInitialPerformanceEvents: () => PerformanceEvent[];
 export declare const INITIAL_EVENTS: PerformanceEvent[];
+export declare const setPerformanceModuleEnabled: (enabled: boolean) => void;
+export declare const getPerformanceModuleEnabled: () => boolean;
 export declare const subscribeRenderProfiles: (listener: (profiles: ComponentRenderProfile[]) => void) => () => void;
 export declare const getRenderProfiles: () => ComponentRenderProfile[];
 export declare const registerComponentProfile: (profile: ComponentRenderProfile) => void;
@@ -129,7 +131,7 @@ export declare const useComponentProfiler: (componentName: string, options?: {
     sourceFile?: string;
     propsToCompare?: Record<string, any>;
 }) => void;
-export declare const usePerformanceTracker: () => {
+export declare const usePerformanceTracker: (enabled?: boolean) => {
     isRecording: boolean;
     setIsRecording: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     currentFps: number;

package/dist/esm/customHooks/performanceTracker.js

@@ -170,6 +170,11 @@ export function getCallerSourceFile(fallbackName) {
 export const getInitialRenderProfiles = () => [];
 export const getInitialPerformanceEvents = () => [];
 export const INITIAL_EVENTS = [];
+let isPerformanceModuleEnabled = false;
+export const setPerformanceModuleEnabled = (enabled) => {
+    isPerformanceModuleEnabled = enabled;
+};
+export const getPerformanceModuleEnabled = () => isPerformanceModuleEnabled;
 const globalRenderRegistry = new Map();
 const renderListeners = new Set();
 const notifyRenderListeners = () => {
@@ -190,10 +195,14 @@ export const subscribeRenderProfiles = (listener) => {
 };
 export const getRenderProfiles = () => Array.from(globalRenderRegistry.values());
 export const registerComponentProfile = (profile) => {
+    if (!isPerformanceModuleEnabled)
+        return;
     globalRenderRegistry.set(profile.name, profile);
     notifyRenderListeners();
 };
 export const trackComponentRender = (params) => {
+    if (!isPerformanceModuleEnabled)
+        return;
     const existing = globalRenderRegistry.get(params.name);
     const now = Date.now();
     const renderTimeMs = params.renderTimeMs ?? 1.5;
@@ -434,7 +443,8 @@ export const useComponentProfiler = (componentName, options) => {
         });
     });
 };
-export const usePerformanceTracker = () => {
+export const usePerformanceTracker = (enabled = true) => {
+    const isTrackerActive = enabled && isPerformanceModuleEnabled;
     const [isRecording, setIsRecording] = useState(true);
     const [currentFps, setCurrentFps] = useState(60);
     const [minFps, setMinFps] = useState(60);
@@ -448,6 +458,8 @@ export const usePerformanceTracker = () => {
     const [renderProfiles, setRenderProfiles] = useState(() => getRenderProfiles());
     const [events, setEvents] = useState(() => getPerformanceEvents());
     useEffect(() => {
+        if (!isTrackerActive)
+            return;
         const unsubRender = subscribeRenderProfiles(profiles => {
             setRenderProfiles(profiles);
         });
@@ -458,13 +470,13 @@ export const usePerformanceTracker = () => {
             unsubRender();
             unsubEvents();
         };
-    }, []);
+    }, [isTrackerActive]);
     const lastFrameTimeRef = useRef(Date.now());
     const rafIdRef = useRef(null);
     const appStartTimestampRef = useRef(Date.now());
     // Live Frame Measurement Loop
     useEffect(() => {
-        if (!isRecording)
+        if (!isTrackerActive || !isRecording)
             return;
         let isMounted = true;
         let frameCount = 0;

package/dist/esm/customHooks/reduxLogger.d.ts

@@ -1,5 +1,7 @@
 import { ReduxHistoryEntry } from '../types';
 export { ReduxHistoryEntry };
+export declare const setReduxModuleEnabled: (enabled: boolean) => void;
+export declare const getReduxModuleEnabled: () => boolean;
 export declare const isReduxConnected: () => boolean;
 export declare const getReduxState: () => any;
 export declare const setReduxAutoRefresh: (val: boolean) => void;

package/dist/esm/customHooks/reduxLogger.js

@@ -15,6 +15,11 @@ import { parseStackLine } from '../helpers';
 let currentReduxState = null;
 const listeners = new Set();
 let globalReduxAutoRefresh = true;
+let isReduxModuleEnabled = false;
+export const setReduxModuleEnabled = (enabled) => {
+    isReduxModuleEnabled = enabled;
+};
+export const getReduxModuleEnabled = () => isReduxModuleEnabled;
 let lastActionForReducer = {};
 let actionHistory = [];
 const MAX_HISTORY = 50;
@@ -163,6 +168,8 @@ function extractSliceName(actionType, affectedSlices) {
     return undefined;
 }
 function recordAction(action, prevState, nextState, rawStack) {
+    if (!isReduxModuleEnabled)
+        return;
     const stack = rawStack || new Error().stack || '';
     const type = actionTypeOf(action);
     const payload = action && typeof action === 'object' && action.payload !== undefined

package/dist/esm/helpers/index.js

@@ -156,9 +156,18 @@ export const getFetchCommand = (log) => {
 export const deduplicateLogs = (raw) => {
     const map = new Map();
     raw.forEach(entry => {
-        if (!map.has(entry.id) || entry.status != null) {
+        if (!map.has(entry.id)) {
             map.set(entry.id, entry);
         }
+        else {
+            const existing = map.get(entry.id);
+            if (existing.status == null && entry.status != null) {
+                map.set(entry.id, entry);
+            }
+            else if ((entry.startTime ?? 0) >= (existing.startTime ?? 0)) {
+                map.set(entry.id, entry);
+            }
+        }
     });
     return Array.from(map.values()).sort((a, b) => b.id - a.id);
 };

package/dist/esm/helpers/settingsStore.d.ts

@@ -6,3 +6,12 @@ export declare function saveSettings(settings: PersistedSettings): void;
 export declare function clearPersistedSettings(): Promise<void>;
 export declare const isPersistentStorageAvailable: () => boolean;
 export declare function getCustomStorage(): InspectorStorage | null;
+export interface RamLimitsProfile {
+    maxNetworkLogs: number;
+    maxConsoleLogs: number;
+    maxAnalyticsEvents: number;
+    maxCrashRecords: number;
+    profileName: 'High-End' | 'Standard' | 'Compact' | 'Ultra-Light';
+    freeRamMb: number;
+}
+export declare function calculateRamBasedLimits(freeRamMb: number): RamLimitsProfile;

package/dist/esm/helpers/settingsStore.js

@@ -3,6 +3,7 @@
 // Backed by iOS Settings (NSUserDefaults) for iOS, or custom storage if passed (e.g. AsyncStorage/MMKV).
 // Contains an in-memory fallback for Android or Jest test environments.
 import { Platform, Settings } from 'react-native';
+import { getNativeStorageItem, setNativeStorageItem, isNativeModuleAvailable, } from '../native/NativeInspector';
 // In-memory fallback (settings survive for the app session only).
 const memory = new Map();
 let customStorage = null;
@@ -19,6 +20,13 @@ export async function loadSettings() {
             const parsed = JSON.parse(raw);
             return parsed && typeof parsed === 'object' ? parsed : {};
         }
+        if (isNativeModuleAvailable()) {
+            const raw = await getNativeStorageItem(SETTINGS_KEY);
+            if (raw) {
+                const parsed = JSON.parse(raw);
+                return parsed && typeof parsed === 'object' ? parsed : {};
+            }
+        }
         if (Platform.OS === 'ios') {
             const raw = Settings.get(SETTINGS_KEY);
             if (!raw)
@@ -29,7 +37,7 @@ export async function loadSettings() {
             }
             return raw && typeof raw === 'object' ? raw : {};
         }
-        // Android/fallback: memory
+        // In-memory fallback
         const raw = memory.get(SETTINGS_KEY);
         if (!raw)
             return {};
@@ -47,11 +55,13 @@ export function saveSettings(settings) {
             customStorage.setItem(SETTINGS_KEY, raw);
             return;
         }
+        if (isNativeModuleAvailable()) {
+            setNativeStorageItem(SETTINGS_KEY, raw);
+        }
         if (Platform.OS === 'ios') {
             Settings.set({ [SETTINGS_KEY]: raw });
             return;
         }
-        // Android/fallback: memory
         memory.set(SETTINGS_KEY, raw);
     }
     catch {
@@ -69,6 +79,9 @@ export async function clearPersistedSettings() {
             }
             return;
         }
+        if (isNativeModuleAvailable()) {
+            await setNativeStorageItem(SETTINGS_KEY, null);
+        }
         if (Platform.OS === 'ios') {
             Settings.set({ [SETTINGS_KEY]: null });
             return;
@@ -80,8 +93,50 @@ export async function clearPersistedSettings() {
     }
 }
 export const isPersistentStorageAvailable = () => {
-    return customStorage !== null || Platform.OS === 'ios';
+    return customStorage !== null || isNativeModuleAvailable() || Platform.OS === 'ios';
 };
 export function getCustomStorage() {
     return customStorage;
 }
+export function calculateRamBasedLimits(freeRamMb) {
+    if (freeRamMb >= 3000) {
+        return {
+            maxNetworkLogs: 1000,
+            maxConsoleLogs: 1500,
+            maxAnalyticsEvents: 500,
+            maxCrashRecords: 100,
+            profileName: 'High-End',
+            freeRamMb,
+        };
+    }
+    else if (freeRamMb >= 1500) {
+        return {
+            maxNetworkLogs: 500,
+            maxConsoleLogs: 750,
+            maxAnalyticsEvents: 250,
+            maxCrashRecords: 50,
+            profileName: 'Standard',
+            freeRamMb,
+        };
+    }
+    else if (freeRamMb >= 600) {
+        return {
+            maxNetworkLogs: 200,
+            maxConsoleLogs: 300,
+            maxAnalyticsEvents: 100,
+            maxCrashRecords: 25,
+            profileName: 'Compact',
+            freeRamMb,
+        };
+    }
+    else {
+        return {
+            maxNetworkLogs: 100,
+            maxConsoleLogs: 150,
+            maxAnalyticsEvents: 50,
+            maxCrashRecords: 15,
+            profileName: 'Ultra-Light',
+            freeRamMb,
+        };
+    }
+}

package/dist/esm/i18n/locales/en.json

@@ -39,12 +39,35 @@
         "redux": "Redux"
     },
     "settings": {
-        "mainTitle": "Settings",
+        "mainTitle": "Settings & Modules",
+        "mainSubtitle": "Manage modules and preferences",
         "requiredBadge": "REQUIRED",
         "defaultBadge": "DEFAULT",
         "notConnectedBadge": "NOT CONNECTED",
         "notDetectedBadge": "NOT DETECTED",
         "readOnlyBadge": "READ ONLY",
+        "coreBadge": "CORE",
+        "activeBadge": "ACTIVE",
+        "dormantBadge": "DORMANT",
+        "protectedBadge": "PROTECTED",
+        "modulesAndTools": "Modules & Tools",
+        "uiPreferences": "UI Preferences",
+        "zeroOverheadTitle": "Zero Background Overhead",
+        "zeroOverheadDesc": "Check the modules you wish to activate. Disabled modules consume 0% CPU & memory until saved.",
+        "unsavedPending": "● Unsaved selections pending",
+        "allSynchronized": "All modules synchronized",
+        "modulesActive": "{{active}} of {{total}} Modules Active",
+        "saveChanges": "Save Changes",
+        "settingsSaved": "Settings Saved",
+        "settingsSavedDesc": "Active module configurations have been successfully updated.",
+        "configure": "Configure",
+        "appearanceTheme": "APPEARANCE & THEME",
+        "windowLayout": "WINDOW & LAYOUT",
+        "startupDefault": "STARTUP & DEFAULT SCREEN",
+        "logFiltersDeduplication": "LOG FILTERS & DEDUPLICATION",
+        "resetSettings": "Reset All Settings",
+        "resetSettingsDesc": "Wipe customized preferences back to default",
+        "reset": "Reset",
         "reduxNotConnectedTip": "Redux store is not connected. Call connectReduxStore(store) or use inspectorReduxMiddleware to enable.",
         "analyticsNotConnectedTip": "Analytics is not initialized. Call setupAnalyticsLogger(analytics()) to enable.",
         "tabVisibility": "Tab Visibility",
@@ -55,7 +78,7 @@
             "title": "APIs Settings",
             "total": "Total: {{count}}",
             "maxRequestLogs": "Max Request Logs",
-            "maxRequestLogsDescription": "How many network requests to keep in memory",
+            "maxRequestLogsDescription": "Buffer size of network requests preserved in memory",
             "clearNetworkLogs": "Clear Network Logs",
             "clearNetworkLogsDescription": "{{count}} requests stored",
             "networkLogsCleared": "Network logs cleared.",
@@ -69,56 +92,91 @@
             "title": "Logs Settings",
             "total": "Total: {{count}}",
             "maxConsoleLogs": "Max Console Logs",
-            "maxConsoleLogsDescription": "How many console logs to keep in memory",
-            "logLevels": "Log Levels",
-            "logLevelsDescription": "Which console levels to capture",
-            "showInfo": "Show info logs",
-            "showWarn": "Show warn logs",
-            "showError": "Show error logs",
+            "maxConsoleLogsDescription": "How many console messages to retain",
+            "logLevels": "Log Severities",
+            "logLevelsDescription": "Select which severities to capture in Logs",
+            "showInfo": "Show Info logs",
+            "showInfoDesc": "Informational logs & debug prints",
+            "showWarn": "Show Warning logs",
+            "showWarnDesc": "Warning notices & deprecations",
+            "showError": "Show Error logs",
+            "showErrorDesc": "Runtime errors & exceptions",
             "clearConsoleLogs": "Clear Console Logs",
             "clearConsoleLogsDescription": "{{count}} logs stored",
             "consoleLogsCleared": "Console logs cleared."
         },
         "analytics": {
             "title": "Analytics Settings",
-            "total": "Total: {{count}}",
-            "maxAnalyticsEvents": "Max Analytics Events",
-            "maxAnalyticsEventsDescription": "How many analytics events to keep in memory",
-            "clearAnalyticsEvents": "Clear Analytics Events",
-            "clearAnalyticsEventsDescription": "{{count}} events stored",
+            "total": "Events: {{count}}",
+            "maxAnalyticsEvents": "Events Captured",
+            "maxAnalyticsEventsDescription": "{{count}} analytics events stored in buffer",
+            "clearAnalyticsEvents": "Clear Analytics History",
+            "clearAnalyticsEventsDescription": "Wipe all captured telemetry events",
             "analyticsEventsCleared": "Analytics events cleared."
         },
         "redux": {
             "title": "Redux Settings",
             "reducers": "Reducers: {{count}}",
             "autoRefresh": "Auto-refresh Store",
-            "autoRefreshDescription": "Automatically capture Redux store state updates",
+            "autoRefreshDescription": "Capture Redux store state tree on every dispatch",
             "defaultJsonExpandDepth": "Default JSON Expand Depth",
             "defaultJsonExpandDepthDescription": "Initial depth of Redux state tree to auto-expand",
             "clearReduxState": "Clear Redux State",
-            "clearReduxStateDescription": "Reset state snapshot in inspector",
-            "clearReduxStateEmpty": "No store snapshot stored",
+            "clearReduxStateDescription": "Reset current state snapshot in inspector",
+            "clearReduxStateEmpty": "No store snapshot recorded",
             "reduxStateCleared": "Redux state snapshot cleared.",
             "clearReduxTimeline": "Clear Redux Timeline",
             "clearReduxTimelineDescription": "Remove all captured action history",
             "reduxTimelineCleared": "Redux action history cleared."
         },
+        "bundle": {
+            "title": "Bundle Settings",
+            "sourceBundler": "Metro Source Bundler",
+            "sourceBundlerDesc": "Parses live module trees and calculates binary size breakdowns",
+            "clearCache": "Clear Bundle Cache",
+            "clearCacheDesc": "Force re-fetching and parsing of JS bundle",
+            "cacheCleared": "Bundle analysis cache cleared."
+        },
+        "performance": {
+            "title": "Performance Settings",
+            "frameMeasurement": "Live Frame Measurement",
+            "frameMeasurementDesc": "Samples UI/JS frame rates & detects wasteful re-renders",
+            "clearEvents": "Clear Performance Events",
+            "clearEventsDesc": "Reset recorded jank and FPS drops history",
+            "eventsCleared": "Performance events cleared."
+        },
+        "crash": {
+            "title": "Crash Settings",
+            "maxCrashLogs": "Max Crash Logs",
+            "maxCrashLogsDesc": "How many crash records to preserve in history",
+            "globalGuard": "Global Crash Guard",
+            "globalGuardDesc": "Intercepts native, JS, and render errors directly",
+            "clearHistory": "Clear Crash History",
+            "clearHistoryDesc": "{{count}} crash logs stored",
+            "historyCleared": "Crash logs cleared."
+        },
         "general": {
-            "darkMode": "Dark Mode",
-            "darkModeDescription": "Switch the inspector to a dark color scheme",
-            "modalHeight": "Modal Height",
-            "modalHeightDescription": "Height of the inspector overlay",
-            "modalAnimation": "Modal Animation",
-            "modalAnimationDescription": "Animation used when opening the inspector",
+            "darkMode": "Dark Mode Theme",
+            "darkModeDescription": "Toggle sleek dark aesthetic or light contrast",
+            "modalHeight": "Inspector Window Height",
+            "modalHeightDescription": "Modal screen coverage percentage",
+            "modalAnimation": "Transition Animation",
+            "modalAnimationDescription": "Entrance and dismissal presentation style",
             "duplicateLogs": "Show Duplicate Logs",
-            "duplicateLogsDescription": "Group consecutive identical console logs",
+            "duplicateLogsDescription": "Off: Identical repeated entries collapse into ×N badges",
+            "defaultOpeningTab": "Default Opening Tab",
+            "defaultOpeningTabDesc": "Initial tab active when launcher button is tapped",
+            "activeConsoleLogLevels": "Active Console Log Levels",
+            "activeConsoleLogLevelsDesc": "Select which severities to capture in Logs",
             "resetToDefaults": "Reset to Defaults",
             "resetToDefaultsDescription": "Restore all inspector settings",
             "resetConfirmationTitle": "Settings Reset",
             "resetConfirmationMessage": "All settings have been reset to default values.",
             "storageStatus": "Persistent Storage",
-            "storageStatusEnabled": "Settings persist across app restarts",
-            "storageStatusDisabled": "Using in-memory storage (Android)"
+            "storageStatusEnabled": "Settings Storage: Persistent ({{type}})",
+            "storageStatusEnabledDesc": "Your preferences and module visibility persist across app reboots.",
+            "storageStatusDisabled": "Settings Storage: In-Memory (Temporary)",
+            "storageStatusDisabledDesc": "Preferences reset on app kill. Pass custom storage to <NetworkInspector storage={...} /> to persist on Android."
         }
     },
     "network": {
@@ -178,10 +236,20 @@
         "noMatchingHeaders": "No matching headers",
         "diffHidden": "{ Diff hidden }",
         "noDiff": "No differences from previous API.",
+        "healthTitle": "Network Health & Telemetry",
+        "successRate": "Success Rate",
+        "avgLatency": "Avg Latency",
+        "p95Latency": "P95 Latency",
+        "bandwidth": "Bandwidth",
+        "fastest": "Fastest",
+        "slowest": "Slowest",
+        "timingWaterfall": "Timing Waterfall & Latency",
+        "throughput": "Throughput",
+        "performanceTier": "Performance Tier",
         "perf": {
-            "fast": "Fast",
-            "moderate": "Moderate",
-            "slow": "Slow"
+            "fast": "Fast (< 200ms)",
+            "moderate": "Moderate (200-800ms)",
+            "slow": "Slow (> 800ms)"
         },
         "jsonViewer": {
             "pretty": "Pretty",

package/dist/esm/index.d.ts

@@ -12,4 +12,5 @@ export { connectReduxStore, inspectorReduxMiddleware, getReduxState, subscribeRe
 export { getEventCategory, registerGAPlugin, type GAPlugin, } from './helpers/gaAnalyticsRegistry';
 export { usePerformanceTracker, useComponentProfiler, useNavigationProfiler, trackComponentRender, trackNavigationTransition, trackHeavyTask, measureAsync, getHermesMemoryStats, registerComponentProfile, subscribeRenderProfiles, getRenderProfiles, logPerformanceEvent, clearPerformanceEvents, subscribePerformanceEvents, getPerformanceEvents, getInitialRenderProfiles, getInitialPerformanceEvents, generateFixSnippet, } from './customHooks/performanceTracker';
 export { InspectLog, InspectTrackTime, InspectCatch, type InspectLogOptions, } from './decorators';
+export { getNativeDeviceMetrics, enableNativeCrashProtection, subscribeNativeCrashes, showNativeFloatingButton, hideNativeFloatingButton, setNativeFloatingButtonBadge, subscribeNativeFloatingButtonPress, subscribeNativeDeviceShake, startNativeFpsMonitoring, stopNativeFpsMonitoring, getNativeFpsMetrics, getNativeStorageItem, setNativeStorageItem, isNativeModuleAvailable, type NativeDeviceMetrics, type NativeCrashEvent, type FloatingButtonOptions, type NativeFpsMetrics, } from './native/NativeInspector';
 export { ActiveTab, Method, StatusFilter, SortOrder, LocalFilter, ModalAnimationType, SettingsPage, SettingsSubTab, LogFilter, ConsoleLogType, AnalyticsEventSource, GAEventCategory, StackFrameType, DiffResultType, BundleSubTab, PerformanceSubTab, CrashType, CrashExportFormat, CrashDetailSubTab, CrashFilterType, BreadcrumbType, } from './types';