react-native-inapp-inspector 1.1.35 → 2.0.0

package/dist/commonjs/index.js

@@ -37,7 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerComponentProfile = exports.getHermesMemoryStats = exports.measureAsync = exports.trackHeavyTask = exports.trackNavigationTransition = exports.trackComponentRender = exports.useNavigationProfiler = exports.useComponentProfiler = exports.usePerformanceTracker = exports.registerGAPlugin = exports.getEventCategory = exports.getLastActionForReducer = exports.clearActionHistory = exports.getActionHistory = exports.subscribeReduxState = exports.getReduxState = exports.inspectorReduxMiddleware = exports.connectReduxStore = exports.ErrorBoundary = exports.CrashTab = exports.computeCrashFingerprint = exports.recordUserActionBreadcrumb = exports.recordReduxBreadcrumb = exports.recordNetworkBreadcrumb = exports.recordNavigationBreadcrumb = exports.addCrashBreadcrumb = exports.recordCustomCrash = exports.parseCrashStackTrace = exports.exportCrashReport = exports.simulateTestCrash = exports.clearCrashRecords = exports.getCrashRecords = exports.emitCrashEvent = exports.subscribeCrashEvents = exports.setupGlobalCrashHandler = exports.getCollectionEnabled = exports.getDefaultEventParameters = exports.getCurrentUserId = exports.getCurrentUserProperties = exports.clearAnalyticsEvents = exports.subscribeAnalyticsEvents = exports.logAnalyticsEvent = exports.setupAnalyticsLogger = exports.subscribeConsoleLogs = exports.clearConsoleLogs = exports.setupConsoleLogger = exports.addAxiosInterceptors = exports.subscribeNetworkLogs = exports.clearNetworkLogs = exports.setupNetworkLogger = void 0;
-exports.BreadcrumbType = exports.CrashFilterType = exports.CrashDetailSubTab = exports.CrashExportFormat = exports.CrashType = exports.PerformanceSubTab = exports.BundleSubTab = exports.DiffResultType = exports.StackFrameType = exports.GAEventCategory = exports.AnalyticsEventSource = exports.ConsoleLogType = exports.LogFilter = exports.SettingsSubTab = exports.SettingsPage = exports.ModalAnimationType = exports.LocalFilter = exports.SortOrder = exports.StatusFilter = exports.Method = exports.ActiveTab = exports.InspectCatch = exports.InspectTrackTime = exports.InspectLog = exports.generateFixSnippet = exports.getInitialPerformanceEvents = exports.getInitialRenderProfiles = exports.getPerformanceEvents = exports.subscribePerformanceEvents = exports.clearPerformanceEvents = exports.logPerformanceEvent = exports.getRenderProfiles = exports.subscribeRenderProfiles = void 0;
+exports.BreadcrumbType = exports.CrashFilterType = exports.CrashDetailSubTab = exports.CrashExportFormat = exports.CrashType = exports.PerformanceSubTab = exports.BundleSubTab = exports.DiffResultType = exports.StackFrameType = exports.GAEventCategory = exports.AnalyticsEventSource = exports.ConsoleLogType = exports.LogFilter = exports.SettingsSubTab = exports.SettingsPage = exports.ModalAnimationType = exports.LocalFilter = exports.SortOrder = exports.StatusFilter = exports.Method = exports.ActiveTab = exports.isNativeModuleAvailable = exports.setNativeStorageItem = exports.getNativeStorageItem = exports.getNativeFpsMetrics = exports.stopNativeFpsMonitoring = exports.startNativeFpsMonitoring = exports.subscribeNativeDeviceShake = exports.subscribeNativeFloatingButtonPress = exports.setNativeFloatingButtonBadge = exports.hideNativeFloatingButton = exports.showNativeFloatingButton = exports.subscribeNativeCrashes = exports.enableNativeCrashProtection = exports.getNativeDeviceMetrics = exports.InspectCatch = exports.InspectTrackTime = exports.InspectLog = exports.generateFixSnippet = exports.getInitialPerformanceEvents = exports.getInitialRenderProfiles = exports.getPerformanceEvents = exports.subscribePerformanceEvents = exports.clearPerformanceEvents = exports.logPerformanceEvent = exports.getRenderProfiles = exports.subscribeRenderProfiles = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const native_1 = require("@react-navigation/native");
@@ -51,6 +51,7 @@ const InspectorContext_1 = require("./components/Inspector/InspectorContext");
 const helpers_1 = require("./helpers");
 // #5 — settings persistence
 const settingsStore_1 = require("./helpers/settingsStore");
+const NativeInspector_1 = require("./native/NativeInspector");
 // Network
 const networkLogger_1 = require("./customHooks/networkLogger");
 // Console
@@ -62,6 +63,7 @@ const analyticsLogger_1 = require("./customHooks/analyticsLogger");
 const reduxLogger_1 = require("./customHooks/reduxLogger");
 const performanceTracker_1 = require("./customHooks/performanceTracker");
 const bundleAnalyzer_1 = require("./customHooks/bundleAnalyzer");
+const NativeInspector_2 = require("./native/NativeInspector");
 const constants_1 = require("./constants");
 // Stylesheet
 const styles_1 = require("./styles");
@@ -214,6 +216,9 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         crash: false,
     });
     const [maxNetworkLogs, setMaxNetworkLogs] = (0, react_1.useState)(100);
+    const [maxAnalyticsEventsLimit, setMaxAnalyticsEventsLimit] = (0, react_1.useState)(250);
+    const [isAutoRamLimitEnabled, setIsAutoRamLimitEnabled] = (0, react_1.useState)(true);
+    const [deviceFreeRamMb, setDeviceFreeRamMb] = (0, react_1.useState)(1800);
     const [reduxAutoRefresh, setReduxAutoRefreshState] = (0, react_1.useState)(true);
     const [reduxExpandDepth, setReduxExpandDepth] = (0, react_1.useState)(1);
     // #6 — tab the inspector opens on. Shown with a DEFAULT badge in Settings.
@@ -229,6 +234,25 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         (0, crashHandler_1.setCrashModuleEnabled)(!!tabVisibility.crash);
         (0, bundleAnalyzer_1.setBundleModuleEnabled)(!!tabVisibility.bundle);
     }, [tabVisibility]);
+    // Query native hardware RAM and auto-tune limits if auto-RAM is active
+    (0, react_1.useEffect)(() => {
+        (0, NativeInspector_1.getNativeSystemMetrics)()
+            .then(metrics => {
+            if (metrics) {
+                const freeRam = metrics.totalPhysicalRamMb - metrics.residentRamMb;
+                const freeMb = Math.max(200, Math.round(freeRam > 0 ? freeRam : 1500));
+                setDeviceFreeRamMb(freeMb);
+                if (isAutoRamLimitEnabled) {
+                    const profile = (0, settingsStore_1.calculateRamBasedLimits)(freeMb);
+                    setMaxNetworkLogs(profile.maxNetworkLogs);
+                    setMaxConsoleLogs(profile.maxConsoleLogs);
+                    setMaxAnalyticsEventsLimit(profile.maxAnalyticsEvents);
+                    setMaxCrashLogs(profile.maxCrashRecords);
+                }
+            }
+        })
+            .catch(() => { });
+    }, [isAutoRamLimitEnabled]);
     const resetToDefaults = async () => {
         await (0, settingsStore_1.clearPersistedSettings)();
         setIsDark(false);
@@ -245,9 +269,12 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
             crash: false,
         });
         setDefaultTab('apis');
-        setMaxCrashLogs(100);
-        setMaxNetworkLogs(100);
-        setMaxConsoleLogs(200);
+        setIsAutoRamLimitEnabled(true);
+        const profile = (0, settingsStore_1.calculateRamBasedLimits)(deviceFreeRamMb);
+        setMaxCrashLogs(profile.maxCrashRecords);
+        setMaxNetworkLogs(profile.maxNetworkLogs);
+        setMaxConsoleLogs(profile.maxConsoleLogs);
+        setMaxAnalyticsEventsLimit(profile.maxAnalyticsEvents);
         setShowConsoleLevels({
             info: true,
             warn: true,
@@ -281,10 +308,16 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                 }));
             if (saved.defaultTab)
                 setDefaultTab(saved.defaultTab);
+            if (saved.isAutoRamLimitEnabled != null)
+                setIsAutoRamLimitEnabled(saved.isAutoRamLimitEnabled);
             if (saved.maxNetworkLogs != null)
                 setMaxNetworkLogs(saved.maxNetworkLogs);
             if (saved.maxConsoleLogs != null)
                 setMaxConsoleLogs(saved.maxConsoleLogs);
+            if (saved.maxAnalyticsEventsLimit != null)
+                setMaxAnalyticsEventsLimit(saved.maxAnalyticsEventsLimit);
+            if (saved.maxCrashLogs != null)
+                setMaxCrashLogs(saved.maxCrashLogs);
             if (saved.showConsoleLevels)
                 setShowConsoleLevels(saved.showConsoleLevels);
             if (saved.reduxAutoRefresh != null)
@@ -327,6 +360,9 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
             defaultTab,
             maxNetworkLogs,
             maxConsoleLogs,
+            maxAnalyticsEventsLimit,
+            maxCrashLogs,
+            isAutoRamLimitEnabled,
             showConsoleLevels,
             reduxAutoRefresh,
             reduxExpandDepth,
@@ -340,6 +376,9 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         defaultTab,
         maxNetworkLogs,
         maxConsoleLogs,
+        maxAnalyticsEventsLimit,
+        maxCrashLogs,
+        isAutoRamLimitEnabled,
         showConsoleLevels,
         reduxAutoRefresh,
         reduxExpandDepth,
@@ -414,13 +453,43 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
             return newVisibility;
         });
     };
+    const loadNativePage = (0, react_1.useCallback)(async (tabKey, query = '') => {
+        if (tabKey === 'apis' || tabKey === 'logs' || tabKey === 'analytics' || tabKey === 'crash') {
+            const pageData = await (0, NativeInspector_1.fetchNativeCachedPage)(tabKey, 0, 100, query);
+            if (pageData && pageData.items && pageData.items.length > 0) {
+                if (tabKey === 'apis')
+                    setLogs(pageData.items);
+                else if (tabKey === 'logs')
+                    setConsoleLogs(pageData.items);
+                else if (tabKey === 'analytics')
+                    setAnalyticsEvents(pageData.items);
+                else if (tabKey === 'crash')
+                    setCrashRecords(pageData.items);
+            }
+        }
+    }, []);
     const switchActiveTab = (0, react_1.useCallback)((key) => {
         if (key === 'redux' && !(0, reduxLogger_1.isReduxConnected)())
             return;
         if (key === 'analytics' && !(0, analyticsLogger_1.isAnalyticsConnected)())
             return;
-        setActiveTab(key);
-    }, []);
+        setSelected(null);
+        setSelectedEvent(null);
+        setSelectedLog(null);
+        setSelectedReduxSlice(null);
+        setSelectedReduxAction(null);
+        setSelectedCrash(null);
+        if (typeof react_1.default.startTransition === 'function') {
+            react_1.default.startTransition(() => {
+                setActiveTab(key);
+                loadNativePage(key);
+            });
+        }
+        else {
+            setActiveTab(key);
+            loadNativePage(key);
+        }
+    }, [loadNativePage]);
     const [selectedEvent, setSelectedEvent] = (0, react_1.useState)(null);
     const [analyticsSearch, setAnalyticsSearch] = (0, react_1.useState)('');
     const [analyticsFilters, setAnalyticsFilters] = (0, react_1.useState)({
@@ -668,6 +737,53 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         loop.start();
         return () => loop.stop();
     }, [unreadPulseAnim]);
+    const isNativeModule = (0, react_1.useMemo)(() => (0, NativeInspector_2.isNativeModuleAvailable)(), []);
+    const useNativeFab = (react_native_1.Platform.OS === 'ios' || react_native_1.Platform.OS === 'android') && isNativeModule;
+    // 100% Native Main-Thread Floating Button Lifecycle
+    (0, react_1.useEffect)(() => {
+        if (!useNativeFab || !isEnabled || !enabled) {
+            if (useNativeFab) {
+                (0, NativeInspector_2.hideNativeFloatingButton)();
+            }
+            return;
+        }
+        if (visible) {
+            (0, NativeInspector_2.hideNativeFloatingButton)();
+        }
+        else {
+            (0, NativeInspector_2.showNativeFloatingButton)();
+            (0, NativeInspector_2.setNativeFloatingButtonBadge)(logs.length > 0 || analyticsEvents.length > 0);
+        }
+    }, [
+        useNativeFab,
+        isEnabled,
+        enabled,
+        visible,
+        logs.length,
+        analyticsEvents.length,
+    ]);
+    // Subscribe to native UI-thread floating button tap events
+    (0, react_1.useEffect)(() => {
+        if (!useNativeFab)
+            return;
+        const unsubscribe = (0, NativeInspector_2.subscribeNativeFloatingButtonPress)(() => {
+            setVisible(true);
+        });
+        return () => {
+            unsubscribe();
+        };
+    }, [useNativeFab]);
+    // Subscribe to physical hardware shake events (or Cmd+Ctrl+Z on iOS simulator)
+    (0, react_1.useEffect)(() => {
+        if (!useNativeFab)
+            return;
+        const unsubscribe = (0, NativeInspector_2.subscribeNativeDeviceShake)(() => {
+            setVisible(prev => !prev);
+        });
+        return () => {
+            unsubscribe();
+        };
+    }, [useNativeFab]);
     const isVisibleRefObj = (0, react_1.useRef)(visible);
     // #6 — every time the inspector is opened, land on chosen default tab & sync latest logs
     (0, react_1.useEffect)(() => {
@@ -734,6 +850,9 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                 return;
             }
             const updated = (0, crashHandler_1.getCrashRecords)();
+            if (updated.length > 0) {
+                (0, NativeInspector_1.pushNativeLogRecord)('crash', JSON.stringify(updated[0]));
+            }
             if (isVisibleRef.current) {
                 setCrashRecords(updated);
             }
@@ -742,12 +861,16 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         // during the very first commit, which fires before effects are mounted).
         const pendingCrashes = (0, crashHandler_1.getCrashRecords)();
         if (pendingCrashes.length > 0) {
+            pendingCrashes.forEach(c => (0, NativeInspector_1.pushNativeLogRecord)('crash', JSON.stringify(c)));
             setCrashRecords(pendingCrashes);
         }
         let timeoutId;
         let isFirstNetworkCall = true;
         const unsubscribe = (0, networkLogger_1.subscribeNetworkLogs)((raw) => {
             latestNetworkLogsRef.current = raw;
+            if (raw.length > 0) {
+                (0, NativeInspector_1.pushNativeLogRecord)('apis', JSON.stringify(raw[0]));
+            }
             if (isNetworkPausedRef.current)
                 return;
             if (!isVisibleRef.current)
@@ -789,6 +912,9 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         let isFirstAnalyticsCall = true;
         const unsubscribeAnalytics = (0, analyticsLogger_1.subscribeAnalyticsEvents)((raw) => {
             latestAnalyticsEventsRef.current = raw;
+            if (raw.length > 0) {
+                (0, NativeInspector_1.pushNativeLogRecord)('analytics', JSON.stringify(raw[0]));
+            }
             if (isAnalyticsPausedRef.current)
                 return;
             if (!isVisibleRef.current)
@@ -828,6 +954,9 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         let isFirstConsoleCall = true;
         const unsubscribeConsole = (0, consoleLogger_1.subscribeConsoleLogs)((raw) => {
             latestConsoleLogsRef.current = raw;
+            if (raw.length > 0) {
+                (0, NativeInspector_1.pushNativeLogRecord)('logs', JSON.stringify(raw[0]));
+            }
             if (isConsolePausedRef.current)
                 return;
             if (!isVisibleRef.current)
@@ -898,6 +1027,10 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                         return true;
                     if (f === 'Failed')
                         return log.status === 0 || log.status == null;
+                    const codeNum = parseInt(f, 10);
+                    if (!isNaN(codeNum)) {
+                        return Number(log.status) === codeNum;
+                    }
                     return String(log.status)[0] === f[0];
                 });
                 if (!matched)
@@ -913,9 +1046,26 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                 if (!matchedMethod)
                     return false;
             }
-            // Search Bar Check
-            if (search && !log.url?.toLowerCase().includes(search.toLowerCase()))
-                return false;
+            // Comprehensive Search Bar Check
+            if (search && search.trim().length > 0) {
+                const queryTokens = search.trim().toLowerCase().split(/\s+/).filter(Boolean);
+                const routePath = logRouteMapRef.current.get(log.id)?.path || '';
+                const reqStr = typeof log.request === 'string' ? log.request : JSON.stringify(log.request || '');
+                const resStr = typeof log.response === 'string' ? log.response : JSON.stringify(log.response || '');
+                const searchTarget = [
+                    log.method || '',
+                    log.url || '',
+                    String(log.status ?? ''),
+                    routePath,
+                    reqStr,
+                    resStr,
+                    JSON.stringify(log.requestHeaders || ''),
+                    JSON.stringify(log.responseHeaders || ''),
+                ].join(' ').toLowerCase();
+                const isMatch = queryTokens.every(token => searchTarget.includes(token));
+                if (!isMatch)
+                    return false;
+            }
             return true;
         });
         if (sortOrder === 'oldest') {
@@ -1070,12 +1220,20 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
     const filteredAnalyticsEvents = (0, react_1.useMemo)(() => {
         let events = analyticsEvents;
         // Search query filter
-        if (analyticsSearch) {
-            const s = analyticsSearch.toLowerCase();
-            events = events.filter(e => e.name.toLowerCase().includes(s) ||
-                JSON.stringify(e.params || {}).toLowerCase().includes(s) ||
-                (e.screenName ?? '').toLowerCase().includes(s) ||
-                (e.pageTitle ?? '').toLowerCase().includes(s));
+        if (analyticsSearch && analyticsSearch.trim().length > 0) {
+            const queryTokens = analyticsSearch.trim().toLowerCase().split(/\s+/).filter(Boolean);
+            events = events.filter(e => {
+                const searchTarget = [
+                    e.name || '',
+                    JSON.stringify(e.params || ''),
+                    JSON.stringify(e.userProperties || ''),
+                    e.screenName || '',
+                    e.pageTitle || '',
+                    e.userId || '',
+                    e.source || '',
+                ].join(' ').toLowerCase();
+                return queryTokens.every(token => searchTarget.includes(token));
+            });
         }
         // Category filter
         if (analyticsFilters.categories.size > 0 && !analyticsFilters.categories.has('all')) {
@@ -1113,16 +1271,15 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         }
         // Payload complexity filter
         if (analyticsFilters.payloadComplexity !== 'all') {
-            events = events.filter(e => {
-                const count = e.params ? Object.keys(e.params).length : 0;
-                if (analyticsFilters.payloadComplexity === 'none')
-                    return count === 0;
-                if (analyticsFilters.payloadComplexity === 'simple')
-                    return count >= 1 && count <= 5;
-                if (analyticsFilters.payloadComplexity === 'heavy')
-                    return count > 5;
-                return true;
-            });
+            if (analyticsFilters.payloadComplexity === 'none') {
+                events = events.filter(e => !e.params || Object.keys(e.params).length === 0);
+            }
+            else if (analyticsFilters.payloadComplexity === 'simple') {
+                events = events.filter(e => e.params && Object.keys(e.params).length <= 3);
+            }
+            else if (analyticsFilters.payloadComplexity === 'heavy') {
+                events = events.filter(e => e.params && Object.keys(e.params).length > 3);
+            }
         }
         // Conversion / Goal events filter
         if (analyticsFilters.onlyConversions) {
@@ -1155,10 +1312,8 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         }
         // Has Revenue filter
         if (analyticsFilters.hasRevenue) {
-            events = events.filter(e => {
-                const val = e.params?.value ?? e.params?.price;
-                return val !== undefined && val !== null && Number(val) > 0;
-            });
+            events = events.filter(e => (e.params?.value != null && !isNaN(Number(e.params.value))) ||
+                (e.params?.price != null && !isNaN(Number(e.params.price))));
         }
         // Has Items filter
         if (analyticsFilters.hasItems) {
@@ -1223,16 +1378,23 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                 if (logFilters.has('user-log') && log.sourceMethod === 'log')
                     return true;
                 if (logFilters.has('analytics') &&
-                    log.message.toLowerCase().includes('[analytics error]'))
+                    log.message?.toLowerCase().includes('[analytics error]'))
                     return true;
                 return false;
             });
         }
-        // Search bar check
-        if (logSearch) {
-            const s = logSearch.toLowerCase();
-            result = result.filter(log => log.message.toLowerCase().includes(s) ||
-                (log.caller ?? '').toLowerCase().includes(s));
+        // Comprehensive Search bar check
+        if (logSearch && logSearch.trim().length > 0) {
+            const queryTokens = logSearch.trim().toLowerCase().split(/\s+/).filter(Boolean);
+            result = result.filter(log => {
+                const searchTarget = [
+                    log.message || '',
+                    log.caller || '',
+                    log.type || '',
+                    log.sourceMethod || '',
+                ].join(' ').toLowerCase();
+                return queryTokens.every(token => searchTarget.includes(token));
+            });
         }
         // #7 — apply sort order (newest/oldest first)
         result = [...result].sort((a, b) => logSortOrder === 'newest'
@@ -1269,10 +1431,17 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
     ]);
     const logCounts = (0, react_1.useMemo)(() => {
         let searchedLogs = visibleConsoleLogs;
-        if (logSearch) {
-            const s = logSearch.toLowerCase();
-            searchedLogs = visibleConsoleLogs.filter(log => log.message.toLowerCase().includes(s) ||
-                (log.caller ?? '').toLowerCase().includes(s));
+        if (logSearch && logSearch.trim().length > 0) {
+            const queryTokens = logSearch.trim().toLowerCase().split(/\s+/).filter(Boolean);
+            searchedLogs = visibleConsoleLogs.filter(log => {
+                const searchTarget = [
+                    log.message || '',
+                    log.caller || '',
+                    log.type || '',
+                    log.sourceMethod || '',
+                ].join(' ').toLowerCase();
+                return queryTokens.every(token => searchTarget.includes(token));
+            });
         }
         const total = visibleConsoleLogs.length;
         return {
@@ -1466,6 +1635,7 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         unreadPulseAnim,
         runClearAllWithAnimation,
         // ─── FAB / launcher ─────────────────────────────────────────────────
+        useNativeFab,
         fabPan,
         fabPanResponder,
         fabDraggedRef,
@@ -1583,6 +1753,11 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         setMaxNetworkLogs,
         maxConsoleLogs,
         setMaxConsoleLogs,
+        maxAnalyticsEventsLimit,
+        setMaxAnalyticsEventsLimit,
+        isAutoRamLimitEnabled,
+        setIsAutoRamLimitEnabled,
+        deviceFreeRamMb,
         reduxAutoRefresh,
         setReduxAutoRefreshState,
         reduxExpandDepth,
@@ -1678,6 +1853,21 @@ var decorators_1 = require("./decorators");
 Object.defineProperty(exports, "InspectLog", { enumerable: true, get: function () { return decorators_1.InspectLog; } });
 Object.defineProperty(exports, "InspectTrackTime", { enumerable: true, get: function () { return decorators_1.InspectTrackTime; } });
 Object.defineProperty(exports, "InspectCatch", { enumerable: true, get: function () { return decorators_1.InspectCatch; } });
+var NativeInspector_3 = require("./native/NativeInspector");
+Object.defineProperty(exports, "getNativeDeviceMetrics", { enumerable: true, get: function () { return NativeInspector_3.getNativeDeviceMetrics; } });
+Object.defineProperty(exports, "enableNativeCrashProtection", { enumerable: true, get: function () { return NativeInspector_3.enableNativeCrashProtection; } });
+Object.defineProperty(exports, "subscribeNativeCrashes", { enumerable: true, get: function () { return NativeInspector_3.subscribeNativeCrashes; } });
+Object.defineProperty(exports, "showNativeFloatingButton", { enumerable: true, get: function () { return NativeInspector_3.showNativeFloatingButton; } });
+Object.defineProperty(exports, "hideNativeFloatingButton", { enumerable: true, get: function () { return NativeInspector_3.hideNativeFloatingButton; } });
+Object.defineProperty(exports, "setNativeFloatingButtonBadge", { enumerable: true, get: function () { return NativeInspector_3.setNativeFloatingButtonBadge; } });
+Object.defineProperty(exports, "subscribeNativeFloatingButtonPress", { enumerable: true, get: function () { return NativeInspector_3.subscribeNativeFloatingButtonPress; } });
+Object.defineProperty(exports, "subscribeNativeDeviceShake", { enumerable: true, get: function () { return NativeInspector_3.subscribeNativeDeviceShake; } });
+Object.defineProperty(exports, "startNativeFpsMonitoring", { enumerable: true, get: function () { return NativeInspector_3.startNativeFpsMonitoring; } });
+Object.defineProperty(exports, "stopNativeFpsMonitoring", { enumerable: true, get: function () { return NativeInspector_3.stopNativeFpsMonitoring; } });
+Object.defineProperty(exports, "getNativeFpsMetrics", { enumerable: true, get: function () { return NativeInspector_3.getNativeFpsMetrics; } });
+Object.defineProperty(exports, "getNativeStorageItem", { enumerable: true, get: function () { return NativeInspector_3.getNativeStorageItem; } });
+Object.defineProperty(exports, "setNativeStorageItem", { enumerable: true, get: function () { return NativeInspector_3.setNativeStorageItem; } });
+Object.defineProperty(exports, "isNativeModuleAvailable", { enumerable: true, get: function () { return NativeInspector_3.isNativeModuleAvailable; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "ActiveTab", { enumerable: true, get: function () { return types_1.ActiveTab; } });
 Object.defineProperty(exports, "Method", { enumerable: true, get: function () { return types_1.Method; } });

package/dist/commonjs/native/NativeInspector.d.ts

@@ -0,0 +1,125 @@
+export interface NativeDeviceMetrics {
+    totalRAM?: number;
+    freeRAM?: number;
+    usedRAM?: number;
+    residentMemory?: number;
+    virtualMemory?: number;
+    isLowMemory?: boolean;
+    nativeHeapAllocated?: number;
+    nativeHeapSize?: number;
+    nativeHeapFree?: number;
+    freeStorage?: number;
+    totalStorage?: number;
+    batteryPercent?: number;
+    isCharging?: boolean;
+    deviceModel?: string;
+    deviceBrand?: string;
+    osVersion?: string;
+    apiLevel?: number;
+    cpuAbi?: string;
+}
+export interface NativeCrashEvent {
+    platform: 'android' | 'ios';
+    error: string;
+    name?: string;
+    stack?: string;
+    threadName?: string;
+    timestamp: number;
+}
+export declare const isNativeModuleAvailable: () => boolean;
+/**
+ * Retrieves low-level native hardware and system metrics (RAM, Heap, Disk, Battery, CPU).
+ */
+export declare const getNativeDeviceMetrics: () => Promise<NativeDeviceMetrics | null>;
+/**
+ * Enables native signal and uncaught exception protection in the iOS / Android runtime.
+ * Automatically ensures the native floating icon is shown and available before UI renders.
+ */
+export declare const enableNativeCrashProtection: (options?: {
+    showFloatingButton?: boolean;
+}) => Promise<boolean>;
+/**
+ * Subscribes to fatal native crash events caught by the iOS / Kotlin exception handlers.
+ */
+export declare const subscribeNativeCrashes: (callback: (event: NativeCrashEvent) => void) => (() => void);
+export interface FloatingButtonOptions {
+    size?: number;
+    x?: number;
+    y?: number;
+}
+/**
+ * Displays the 100% native main-thread floating overlay button.
+ * Dragging & touches run on the native UI thread, completely isolated from JS thread stalls.
+ */
+export declare const showNativeFloatingButton: (options?: FloatingButtonOptions) => Promise<boolean>;
+/**
+ * Hides the native floating overlay button.
+ */
+export declare const hideNativeFloatingButton: () => Promise<boolean>;
+/**
+ * Updates the badge/status dot on the native floating overlay button.
+ */
+export declare const setNativeFloatingButtonBadge: (hasBadge: boolean) => Promise<boolean>;
+/**
+ * Subscribes to tap events on the native floating button.
+ */
+export declare const subscribeNativeFloatingButtonPress: (callback: () => void) => (() => void);
+/**
+ * Starts hardware-accurate native UI thread FPS tracking (CADisplayLink / Choreographer).
+ */
+export declare const startNativeFpsMonitoring: () => Promise<boolean>;
+/**
+ * Stops native FPS tracking.
+ */
+export declare const stopNativeFpsMonitoring: () => Promise<boolean>;
+export interface NativeFpsMetrics {
+    fps: number;
+    targetFps: number;
+}
+/**
+ * Reads the latest live hardware FPS from CADisplayLink (iOS) or Choreographer (Android).
+ */
+export declare const getNativeFpsMetrics: () => Promise<NativeFpsMetrics>;
+/**
+ * Subscribes to physical hardware shake events (or Cmd+Ctrl+Z on iOS simulator).
+ */
+export declare const subscribeNativeDeviceShake: (callback: () => void) => (() => void);
+/**
+ * Reads a persisted value synchronously from native NSUserDefaults / SharedPreferences.
+ */
+export declare const getNativeStorageItem: (key: string) => Promise<string | null>;
+/**
+ * Persists a key-value pair to native NSUserDefaults / SharedPreferences with 0ms latency.
+ */
+export declare const setNativeStorageItem: (key: string, value: string | null) => Promise<boolean>;
+export type HapticStyle = 'light' | 'medium' | 'heavy' | 'success' | 'warning' | 'error';
+/**
+ * Triggers hardware native haptic feedback (iOS UIFeedbackGenerator / Android VibrationEffect).
+ */
+export declare const triggerNativeHaptic: (style?: HapticStyle) => Promise<boolean>;
+export interface NativeSystemMetrics {
+    thermalState: 'nominal' | 'fair' | 'serious' | 'critical';
+    residentRamMb: number;
+    totalPhysicalRamMb: number;
+    fps: number;
+    activeCpuCores: number;
+}
+/**
+ * Retrieves live system thermal state and RAM telemetry directly from native layer.
+ */
+export declare const getNativeSystemMetrics: () => Promise<NativeSystemMetrics | null>;
+/**
+ * Pushes a log payload to native background worker queues for instant native page caching.
+ */
+export declare const pushNativeLogRecord: (pageKey: "apis" | "logs" | "analytics" | "crash", jsonPayload: string) => Promise<boolean>;
+export interface NativeCachedPageResult<T = any> {
+    pageKey: string;
+    total: number;
+    offset: number;
+    items: T[];
+}
+/**
+ * Fetches pre-indexed, pre-sliced page data directly from native background memory queues.
+ * Delivers instantaneous 0ms page loading without blocking JS render thread.
+ */
+export declare const fetchNativeCachedPage: <T = any>(pageKey: "apis" | "logs" | "analytics" | "crash", offset?: number, limit?: number, query?: string) => Promise<NativeCachedPageResult<T> | null>;