react-native-inapp-inspector 2.3.5 → 2.3.6

package/dist/esm/helpers/index.js

@@ -1,9 +1,7 @@
 import { Platform, ToastAndroid, Alert, NativeModules, Linking, } from 'react-native';
 import Clipboard from '@react-native-clipboard/clipboard';
 import { showToast } from './toast';
-// Stylesheet
 import { AppColors } from '../styles/AppColors';
-// Constants
 import { DOMAIN_COLORS, DURATION_FAST_MS, DURATION_SLOW_MS } from '../constants';
 export * from './searchQueryParser';
 export * from './memoryManager';
@@ -83,7 +81,6 @@ export const copyToClipboard = (value, label) => {
             textToCopy = String(resolved);
         }
     }
-    // Use @react-native-clipboard/clipboard npm package
     try {
         if (typeof Clipboard?.setString === 'function') {
             Clipboard.setString(textToCopy);
@@ -97,12 +94,10 @@ export const copyToClipboard = (value, label) => {
             console.warn('[NetworkInspector] Clipboard.setString failed:', err);
         }
     }
-    // Trigger floating in-app bottom toast notification
     try {
         showToast(label ? `${label} copied to clipboard` : 'Copied to clipboard');
     }
     catch { }
-    // Native Android Toast fallback
     try {
         if (Platform.OS === 'android' && ToastAndroid?.show) {
             ToastAndroid.show(label ? `${label} copied to clipboard` : 'Copied to clipboard', ToastAndroid.SHORT);
@@ -215,7 +210,6 @@ export const getNavigationInfo = (state, path = []) => {
     return { path: resolved, params: route.params || null };
 };
 export const getLogPageName = (log, routeInfo) => {
-    // 1. If routeInfo has a valid path, resolve the leaf screen name
     const effectiveRoute = routeInfo || log?.routeInfo;
     if (effectiveRoute &&
         effectiveRoute.path &&
@@ -225,11 +219,10 @@ export const getLogPageName = (log, routeInfo) => {
             .map((s) => s.trim())
             .filter(Boolean);
         if (parts.length > 0) {
-            return parts[parts.length - 1]; // Leaf screen name, e.g. "HomeScreen", "ProfileScreen"
+            return parts[parts.length - 1];
         }
         return effectiveRoute.path;
     }
-    // 2. Extract screen / component name from log.caller stack trace
     if (log.caller && log.caller !== 'Unknown') {
         try {
             const match = log.caller.match(/([^/\\]+)\.(tsx|jsx|ts|js)/i);
@@ -254,7 +247,6 @@ export const getLogPageName = (log, routeInfo) => {
         }
         catch (e) { }
     }
-    // 3. Fallback to API resource / endpoint category from URL
     if (log.url) {
         try {
             const cleanUrl = log.url.split('?')[0].split('#')[0];
@@ -410,17 +402,13 @@ export const getBundleIdentifier = () => {
     return 'org.reactjs.native.example';
 };
 export const getAppName = () => {
-    // Try iOS via PlatformConstants
     const constants = NativeModules.PlatformConstants;
     if (constants && typeof constants.interfaceIdiom === 'string') {
-        // Fallback: try to parse from SourceCode
     }
-    // Try react-native-device-info
     const RNDeviceInfo = NativeModules.RNDeviceInfo;
     if (RNDeviceInfo && typeof RNDeviceInfo.appName === 'string') {
         return RNDeviceInfo.appName;
     }
-    // Try Expo
     const ExpoApplication = NativeModules.ExpoApplication;
     if (ExpoApplication && typeof ExpoApplication.applicationName === 'string') {
         return ExpoApplication.applicationName;
@@ -431,17 +419,14 @@ export const getAppName = () => {
         if (manifest.name)
             return manifest.name;
     }
-    // Android: try to get from AndroidInfoModule
     const AppInfo = NativeModules.AppInfo;
     if (AppInfo && typeof AppInfo.appName === 'string') {
         return AppInfo.appName;
     }
-    // Fallback: derive from bundle ID (last segment, cleaned up)
     const bundleId = getBundleIdentifier();
     if (bundleId && bundleId !== 'org.reactjs.native.example') {
         const parts = bundleId.split('.');
         const last = parts[parts.length - 1];
-        // Capitalize first letter
         return last ? last.charAt(0).toUpperCase() + last.slice(1) : 'App';
     }
     return 'App';
@@ -449,7 +434,6 @@ export const getAppName = () => {
 export const getAppVersionAndBuild = () => {
     let version = '';
     let build = '';
-    // 1. Try ExpoApplication / ExponentConstants
     const ExpoApplication = NativeModules.ExpoApplication;
     if (ExpoApplication) {
         if (typeof ExpoApplication.nativeAppVersion === 'string') {
@@ -476,7 +460,6 @@ export const getAppVersionAndBuild = () => {
             }
         }
     }
-    // 2. Try react-native-device-info
     const RNDeviceInfo = NativeModules.RNDeviceInfo;
     if (RNDeviceInfo) {
         if (!version) {
@@ -502,7 +485,6 @@ export const getAppVersionAndBuild = () => {
             }
         }
     }
-    // 3. Try PlatformConstants / Platform.constants
     const constants = Platform.constants || NativeModules.PlatformConstants;
     if (constants) {
         if (!version &&
@@ -518,7 +500,6 @@ export const getAppVersionAndBuild = () => {
             }
         }
     }
-    // 4. Try Android AppInfo
     const AppInfo = NativeModules.AppInfo;
     if (AppInfo) {
         if (!version && typeof AppInfo.versionName === 'string') {
@@ -528,7 +509,6 @@ export const getAppVersionAndBuild = () => {
             build = AppInfo.versionCode;
         }
     }
-    // Fallbacks
     if (!version)
         version = '1.0.0';
     if (!build)
@@ -553,7 +533,6 @@ export const handleOpenExternalLink = (url) => {
         },
     ]);
 };
-/** Formats a timestamp as HH:MM:SS (no milliseconds). */
 export const formatTimeShort = (ts) => {
     const d = new Date(ts);
     const hh = String(d.getHours()).padStart(2, '0');
@@ -561,7 +540,6 @@ export const formatTimeShort = (ts) => {
     const ss = String(d.getSeconds()).padStart(2, '0');
     return `${hh}:${mm}:${ss}`;
 };
-/** Formats a timestamp as HH:MM:SS.mmm (with milliseconds). */
 export const formatTime = (ts) => {
     const d = new Date(ts);
     const hh = String(d.getHours()).padStart(2, '0');
@@ -570,7 +548,6 @@ export const formatTime = (ts) => {
     const ms = String(d.getMilliseconds()).padStart(3, '0');
     return `${hh}:${mm}:${ss}.${ms}`;
 };
-/** Formats a relative gap like "+2s" / "+1m 5s" / "+350ms". */
 export const formatGap = (ms) => {
     if (ms < 1000)
         return `+${ms}ms`;
@@ -581,7 +558,6 @@ export const formatGap = (ms) => {
     const rem = s % 60;
     return rem > 0 ? `+${m}m ${rem}s` : `+${m}m`;
 };
-/** Finds the first JSON object/array embedded anywhere in a log message. */
 export const getJsonContent = (message) => {
     if (!message)
         return null;
@@ -601,12 +577,10 @@ export const getJsonContent = (message) => {
             }
         }
         catch (e) {
-            // Ignore
         }
     }
     return null;
 };
-/** Pretty-prints JSON data showing 3-4 lines with trailing "..." */
 export const getJsonPreviewText = (data, maxLines = 4) => {
     try {
         const formatted = JSON.stringify(data, null, 2);
@@ -629,17 +603,14 @@ export const getJsonPreviewText = (data, maxLines = 4) => {
         };
     }
 };
-/** Parses a stack trace line to extract function name, file name, extension (.tsx/.jsx/.ts), line, and column numbers */
 export const parseStackLine = (rawLine, isOrigin = false) => {
     let line = rawLine.trim().replace(/^at /, '');
-    // Format: func@file:line:col (JSC / Hermes format)
     if (line.includes('@')) {
         const atIndex = line.indexOf('@');
         const funcPart = line.substring(0, atIndex).trim();
         const pathPart = line.substring(atIndex + 1).trim();
         line = funcPart ? `${funcPart} (${pathPart})` : pathPart;
     }
-    // Check for "func (path:line:col)" or "path:line:col"
     const parenMatch = line.match(/^(.*?)\s*\((.*?)\)$/);
     let functionName = '<anonymous>';
     let locationPart = line;
@@ -647,13 +618,10 @@ export const parseStackLine = (rawLine, isOrigin = false) => {
         functionName = parenMatch[1].trim() || '<anonymous>';
         locationPart = parenMatch[2].trim();
     }
-    // Clean Babel/Hermes artifacts in function names like ?anon_0_, _callee$, etc.
     if (functionName.startsWith('?anon_') || functionName === '?') {
         functionName = 'anonymous';
     }
-    // Remove "address at " prefix if present in Hermes
     locationPart = locationPart.replace(/^address at /, '');
-    // Extract file, line, and col from locationPart (e.g. "path/to/file.tsx:42:15" or "http://...:42:15")
     const locMatch = locationPart.match(/^(.*?):(\d+):(\d+)$/);
     let fullPath = locationPart;
     let lineNumber;
@@ -663,16 +631,13 @@ export const parseStackLine = (rawLine, isOrigin = false) => {
         lineNumber = locMatch[2];
         columnNumber = locMatch[3];
     }
-    // Clean file name (remove query strings, packager urls, and parent paths)
     let cleanPath = fullPath
         .split('?')[0]
         .split('&')[0]
         .replace(/[)]+$/, '')
         .replace(/\/\/+$/, '');
-    // Remove protocol prefixes
     cleanPath = cleanPath.replace(/^(?:https?:\/\/[^\/]+\/|file:\/\/\/|webpack:\/\/\/?)/, '');
     const fileName = cleanPath.split('/').filter(Boolean).pop() || cleanPath;
-    // Determine file extension (.tsx, .jsx, .ts, .js)
     const extMatch = fileName.match(/\.([a-z0-9]+)$/i);
     const ext = extMatch ? extMatch[1].toLowerCase() : '';
     const fileExt = ext === 'tsx' || ext === 'jsx' || ext === 'ts' || ext === 'js'
@@ -709,7 +674,6 @@ export const parseStackLine = (rawLine, isOrigin = false) => {
         isNative ||
         functionName === 'asyncGeneratorStep' ||
         functionName === '_next';
-    // Format clean relative project path
     let relativePath = cleanPath;
     if (relativePath.includes('/example/')) {
         relativePath = relativePath.substring(relativePath.indexOf('/example/') + 9);
@@ -739,14 +703,12 @@ export const parseStackLine = (rawLine, isOrigin = false) => {
         copyableLocation,
     };
 };
-/** Opens a file and line number directly in VS Code / system editor */
 export const openInVSCode = (filePath, lineNumber, columnNumber) => {
     const numLine = lineNumber ? Number(lineNumber) : 1;
     const numCol = columnNumber ? Number(columnNumber) : 1;
     const line = lineNumber ? `:${lineNumber}` : '';
     const col = columnNumber ? `:${columnNumber}` : '';
     const cleanPath = filePath.replace(/^file:\/\//, '');
-    // 1. Notify Metro dev server on host to launch editor directly on local system
     let extractedOrigin = null;
     try {
         const scriptURL = NativeModules?.SourceCode?.scriptURL ||
@@ -783,20 +745,17 @@ export const openInVSCode = (filePath, lineNumber, columnNumber) => {
         }
         catch { }
     });
-    // 2. Also invoke native URL scheme handlers
     const vscodeUrl = `vscode://file/${cleanPath.replace(/^\/+/, '')}${line}${col}`;
     const cursorUrl = `cursor://file/${cleanPath.replace(/^\/+/, '')}${line}${col}`;
     const vscodeInsidersUrl = `vscode-insiders://file/${cleanPath.replace(/^\/+/, '')}${line}${col}`;
     Linking.openURL(vscodeUrl).catch(() => {
         Linking.openURL(cursorUrl).catch(() => {
             Linking.openURL(vscodeInsidersUrl).catch(() => {
-                // Fallback: Copy to clipboard so user can jump immediately
                 copyToClipboard(`${cleanPath}${line}${col}`, 'Location');
             });
         });
     });
 };
-// ─── Analytics Helpers ────────────────────────────────────────────────────────
 export const ANALYTICS_EVENT_PALETTE = [
     AppColors.googleBlue,
     AppColors.googleGreen,

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

@@ -10,19 +10,8 @@ export interface MemoryPruneSummary {
     triggeredBy: 'memory-warning' | 'manual' | 'ram-threshold';
 }
 type MemoryWarningListener = (summary: MemoryPruneSummary) => void;
-/**
- * Prunes all in-memory log stores to prevent OOM / memory pressure.
- * Keeps targetRetentionPct (default: 50%) of existing logs.
- */
 export declare const pruneAllLogs: (triggeredBy?: MemoryPruneSummary["triggeredBy"], targetRetentionPct?: number) => MemoryPruneSummary;
-/**
- * Starts listening to OS memory pressure warnings via AppState 'memoryWarning'.
- * Automatically prunes logs and notifies subscribers when memory is constrained.
- */
 export declare const setupMemoryWarningHandler: () => (() => void);
-/**
- * Subscribes to memory prune events.
- */
 export declare const subscribeMemoryWarning: (listener: MemoryWarningListener) => (() => void);
 export declare const getLastPruneTimestamp: () => number;
 export declare const isMemoryHandlerActive: () => boolean;

package/dist/esm/helpers/memoryManager.js

@@ -10,10 +10,6 @@ const memoryListeners = new Set();
 let appStateSubscription = null;
 let isMemoryWarningHandlerActive = false;
 let lastPruneTimestamp = 0;
-/**
- * Prunes all in-memory log stores to prevent OOM / memory pressure.
- * Keeps targetRetentionPct (default: 50%) of existing logs.
- */
 export const pruneAllLogs = (triggeredBy = 'manual', targetRetentionPct = 0.5) => {
     const targetPct = Math.max(0.1, Math.min(1.0, targetRetentionPct));
     const prunedNetwork = pruneNetworkLogs(undefined);
@@ -29,7 +25,6 @@ export const pruneAllLogs = (triggeredBy = 'manual', targetRetentionPct = 0.5) =
         prunedCrashes +
         prunedPerformance;
     lastPruneTimestamp = Date.now();
-    // Trigger Hermes/V8 Garbage Collection if exposed
     if (typeof globalThis.gc === 'function') {
         try {
             globalThis.gc();
@@ -59,10 +54,6 @@ export const pruneAllLogs = (triggeredBy = 'manual', targetRetentionPct = 0.5) =
     });
     return summary;
 };
-/**
- * Starts listening to OS memory pressure warnings via AppState 'memoryWarning'.
- * Automatically prunes logs and notifies subscribers when memory is constrained.
- */
 export const setupMemoryWarningHandler = () => {
     if (isMemoryWarningHandlerActive) {
         return () => { };
@@ -78,7 +69,6 @@ export const setupMemoryWarningHandler = () => {
         });
     }
     catch (e) {
-        // AppState memoryWarning might not be supported on all mock/test platforms
     }
     return () => {
         if (appStateSubscription) {
@@ -91,9 +81,6 @@ export const setupMemoryWarningHandler = () => {
         isMemoryWarningHandlerActive = false;
     };
 };
-/**
- * Subscribes to memory prune events.
- */
 export const subscribeMemoryWarning = (listener) => {
     memoryListeners.add(listener);
     return () => {

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

@@ -4,8 +4,4 @@ export interface SearchQueryOptions {
     isRegex?: boolean;
     isCaseSensitive?: boolean;
 }
-/**
- * Parses query strings like `method:POST is:error slow:>1s status:200 auth`
- * and checks whether a given NetworkLog matches all tokens against the specified scope.
- */
 export declare function matchNetworkLogQuery(log: NetworkLog, searchQuery: string, routePath?: string, options?: SearchQueryOptions): boolean;

package/dist/esm/helpers/searchQueryParser.js

@@ -1,11 +1,6 @@
-/**
- * Parses query strings like `method:POST is:error slow:>1s status:200 auth`
- * and checks whether a given NetworkLog matches all tokens against the specified scope.
- */
 export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
     if (!searchQuery || searchQuery.trim().length === 0)
         return true;
-    // Split tokens by spaces or commas while respecting quotes
     const rawTokens = searchQuery.trim().match(/(?:[^\s,"']+|"[^"]*"|'[^']*')+/g) || [];
     if (rawTokens.length === 0)
         return true;
@@ -40,7 +35,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
         ? JSON.stringify(log.responseHeaders)
         : '';
     const pathRaw = routePath || log?.routeInfo?.path || '';
-    // Construct search corpus based on active scope
     const getScopedCorpus = (caseSens) => {
         let parts = [];
         if (scope === 'url') {
@@ -87,7 +81,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
         if (!token)
             continue;
         const lowerToken = token.toLowerCase();
-        // 1. method:<VAL> or m:<VAL>
         if (lowerToken.startsWith('method:') || lowerToken.startsWith('m:')) {
             const targetMethod = lowerToken.replace(/^(method:|m:)/, '').trim();
             if (targetMethod.startsWith('!')) {
@@ -100,7 +93,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
             }
             continue;
         }
-        // 2. status:<VAL> or s:<VAL>
         if (lowerToken.startsWith('status:') || lowerToken.startsWith('s:')) {
             const val = lowerToken.replace(/^(status:|s:)/, '').trim();
             if (val === 'pending' || val === 'loading') {
@@ -144,7 +136,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
             }
             continue;
         }
-        // 3. is:<FLAG>
         if (lowerToken.startsWith('is:')) {
             const flag = lowerToken.slice(3).trim();
             if (flag === 'error' ||
@@ -202,7 +193,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
             }
             continue;
         }
-        // 4. slow:<DURATION> or dur:<DURATION> or duration:<DURATION>
         if (lowerToken.startsWith('slow:') ||
             lowerToken.startsWith('dur:') ||
             lowerToken.startsWith('duration:')) {
@@ -247,21 +237,18 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
             }
             continue;
         }
-        // 5. client:<CLIENT> or c:<CLIENT>
         if (lowerToken.startsWith('client:') || lowerToken.startsWith('c:')) {
             const targetClient = lowerToken.replace(/^(client:|c:)/, '').trim();
             if (!clientStr.includes(targetClient))
                 return false;
             continue;
         }
-        // 6. domain:<DOMAIN> or d:<DOMAIN>
         if (lowerToken.startsWith('domain:') || lowerToken.startsWith('d:')) {
             const targetDomain = lowerToken.replace(/^(domain:|d:)/, '').trim();
             if (!urlStr.includes(targetDomain))
                 return false;
             continue;
         }
-        // 7. path:<PATH> or p:<PATH> or page:<PAGE>
         if (lowerToken.startsWith('path:') ||
             lowerToken.startsWith('p:') ||
             lowerToken.startsWith('page:')) {
@@ -275,21 +262,18 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
             }
             continue;
         }
-        // 8. req:<TERM> or body:<TERM>
         if (lowerToken.startsWith('req:') || lowerToken.startsWith('body:')) {
             const target = lowerToken.replace(/^(req:|body:)/, '').trim();
             if (!reqStr.includes(target))
                 return false;
             continue;
         }
-        // 9. res:<TERM>
         if (lowerToken.startsWith('res:')) {
             const target = lowerToken.slice(4).trim();
             if (!resStr.includes(target))
                 return false;
             continue;
         }
-        // 10. header:<TERM> or h:<TERM>
         if (lowerToken.startsWith('header:') || lowerToken.startsWith('h:')) {
             const target = lowerToken.replace(/^(header:|h:)/, '').trim();
             if (!reqHeadersStr.includes(target) && !resHeadersStr.includes(target)) {
@@ -297,7 +281,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
             }
             continue;
         }
-        // 11. Generic Match (handles Regex, Case-sensitivity, and Scoped corpus)
         if (isRegex) {
             try {
                 const re = new RegExp(token, isCaseSensitive ? '' : 'i');
@@ -313,7 +296,6 @@ export function matchNetworkLogQuery(log, searchQuery, routePath, options) {
         else {
             const queryTerm = isCaseSensitive ? token : lowerToken;
             if (!targetCorpus.includes(queryTerm)) {
-                // Special case: if user typed "error" / "failed", check error status
                 if (queryTerm === 'error' ||
                     queryTerm === 'failed' ||
                     queryTerm === 'fail') {

package/dist/esm/helpers/settingsStore.js

@@ -1,10 +1,5 @@
-// #5 — Persistence layer for the inspector's settings selections.
-//
-// 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;
 export function setCustomStorage(storage) {
@@ -37,7 +32,6 @@ export async function loadSettings() {
             }
             return raw && typeof raw === 'object' ? raw : {};
         }
-        // In-memory fallback
         const raw = memory.get(SETTINGS_KEY);
         if (!raw)
             return {};
@@ -65,7 +59,6 @@ export function saveSettings(settings) {
         memory.set(SETTINGS_KEY, raw);
     }
     catch {
-        // ignore
     }
 }
 export async function clearPersistedSettings() {
@@ -89,7 +82,6 @@ export async function clearPersistedSettings() {
         memory.delete(SETTINGS_KEY);
     }
     catch {
-        // ignore
     }
 }
 export const isPersistentStorageAvailable = () => {

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

@@ -0,0 +1,2 @@
+export declare function setTelemetryEnabled(enabled: boolean): void;
+export declare function trackActiveTelemetryHeartbeat(telemetryEnabled?: boolean, environment?: string): Promise<void>;