react-native-inapp-inspector 2.0.1 → 2.0.3

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

@@ -0,0 +1,99 @@
+export declare const GA4_MEASUREMENT_ID = "G-XXXXXXXXXX";
+export declare const GA4_API_SECRET = "YOUR_GA4_API_SECRET";
+/**
+ * Asynchronously loads host application and device metadata (strictly non-PII/technical).
+ */
+export declare function loadAppDiagnosticsAsync(): Promise<Record<string, any>>;
+/**
+ * Returns the developer's telemetry consent status.
+ */
+export declare function getTelemetryConsentStatus(): Promise<'granted' | 'declined' | 'undetermined'>;
+/**
+ * Saves the developer's telemetry consent choice.
+ */
+export declare function setTelemetryConsent(granted: boolean): Promise<void>;
+/**
+ * Checks if the user or environment has opted out of telemetry.
+ */
+export declare function isTelemetryOptedOut(explicitSetting?: boolean): boolean;
+/**
+ * Track an anonymous event via GA4 Measurement Protocol.
+ */
+export declare function trackTelemetryEvent(eventName: string, params?: Record<string, any>, options?: {
+    telemetry?: boolean;
+    force?: boolean;
+}): Promise<void>;
+/**
+ * 1. Session initialization heartbeat ping.
+ */
+export declare function sendSessionTelemetryPing(options?: {
+    telemetry?: boolean;
+    environment?: string;
+    hasNavigation?: boolean;
+    hasAppIcon?: boolean;
+    force?: boolean;
+}): Promise<void>;
+/**
+ * 2. Track when the inspector modal is opened.
+ */
+export declare function trackInspectorOpen(options?: {
+    activeTab?: string;
+    openSource?: 'fab' | 'shake' | 'programmatic';
+    telemetry?: boolean;
+}): void;
+/**
+ * 3. Track when the inspector modal is closed.
+ */
+export declare function trackInspectorClose(options?: {
+    telemetry?: boolean;
+}): void;
+/**
+ * 4. Track tab / page view navigation inside the inspector.
+ */
+export declare function trackTabSwitch(tabName: string, options?: {
+    telemetry?: boolean;
+    fromTab?: string;
+}): void;
+/**
+ * 5. Track network API interaction (inspect details, copy cURL, retry).
+ */
+export declare function trackNetworkInteraction(action: 'view_detail' | 'copy_curl' | 'retry_request' | 'copy_url' | 'clear_logs' | 'export_har', options?: {
+    method?: string;
+    statusCode?: number;
+    durationMs?: number;
+    telemetry?: boolean;
+}): void;
+/**
+ * 6. Track Redux / State management interaction.
+ */
+export declare function trackReduxInteraction(action: 'view_diff' | 'view_state' | 'view_action' | 'filter_reducer', options?: {
+    reducerName?: string;
+    telemetry?: boolean;
+}): void;
+/**
+ * 7. Track Crash & Exception interaction.
+ */
+export declare function trackCrashInteraction(action: 'view_crash_detail' | 'share_crash_report' | 'copy_stacktrace' | 'clear_crashes', options?: {
+    crashType?: string;
+    telemetry?: boolean;
+}): void;
+/**
+ * 8. Track Performance monitoring tab interaction.
+ */
+export declare function trackPerformanceInteraction(subTab: 'fps' | 'memory' | 'rerenders' | 'bundles', options?: {
+    telemetry?: boolean;
+}): void;
+/**
+ * 9. Track search queries and filter applications.
+ */
+export declare function trackSearchOrFilter(target: 'apis' | 'console' | 'redux' | 'crashes' | 'analytics', actionType: 'search_query' | 'status_filter' | 'method_filter' | 'tag_filter', options?: {
+    filterValue?: string;
+    telemetry?: boolean;
+}): void;
+/**
+ * 10. Track when logs / reports are exported or shared.
+ */
+export declare function trackLogExport(exportType: 'logs_json' | 'logs_har' | 'curl' | 'crash_report', options?: {
+    telemetry?: boolean;
+    count?: number;
+}): void;

package/dist/commonjs/helpers/telemetry.js

@@ -0,0 +1,398 @@
+"use strict";
+// ─── Google Analytics 4 (GA4) Measurement Protocol Telemetry ───────────────
+//
+// Comprehensive, anonymous usage telemetry for react-native-inapp-inspector.
+//
+// - NEVER collects user PII, auth tokens, device names, or network payload bodies.
+// - Zero main-thread blocking; 100% fail-safe fire-and-forget.
+// - Full environment diagnostics (Hermes, New Arch, RN version, screen size, UI mode).
+// - Tracks developer interactions: tab switches, page views, search, exports, retries.
+// - Supports opt-out via `telemetry={false}` or `DO_NOT_TRACK=1`.
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GA4_API_SECRET = exports.GA4_MEASUREMENT_ID = void 0;
+exports.loadAppDiagnosticsAsync = loadAppDiagnosticsAsync;
+exports.getTelemetryConsentStatus = getTelemetryConsentStatus;
+exports.setTelemetryConsent = setTelemetryConsent;
+exports.isTelemetryOptedOut = isTelemetryOptedOut;
+exports.trackTelemetryEvent = trackTelemetryEvent;
+exports.sendSessionTelemetryPing = sendSessionTelemetryPing;
+exports.trackInspectorOpen = trackInspectorOpen;
+exports.trackInspectorClose = trackInspectorClose;
+exports.trackTabSwitch = trackTabSwitch;
+exports.trackNetworkInteraction = trackNetworkInteraction;
+exports.trackReduxInteraction = trackReduxInteraction;
+exports.trackCrashInteraction = trackCrashInteraction;
+exports.trackPerformanceInteraction = trackPerformanceInteraction;
+exports.trackSearchOrFilter = trackSearchOrFilter;
+exports.trackLogExport = trackLogExport;
+const react_native_1 = require("react-native");
+const constants_1 = require("../constants");
+const NativeInspector_1 = require("../native/NativeInspector");
+// ─── GA4 Measurement Protocol Configuration ──────────────────────────────────
+// Automatically replaced at build-time from .env by scripts/inject-telemetry.js
+exports.GA4_MEASUREMENT_ID = 'G-XXXXXXXXXX';
+exports.GA4_API_SECRET = 'YOUR_GA4_API_SECRET';
+const GA4_ENDPOINT = 'https://www.google-analytics.com/mp/collect';
+const CLIENT_ID_KEY = 'telemetry_client_id';
+// Stable session ID created once per JavaScript runtime instance
+const CURRENT_SESSION_ID = String(Math.floor(Date.now() / 1000));
+let hasPingedSession = false;
+let cachedClientId = null;
+let lastModalOpenTimestamp = 0;
+let cachedAppDiagnostics = null;
+/**
+ * Generates an anonymous, pseudorandom UUIDv4-like string for client grouping.
+ * Contains zero hardware or personal identifiers.
+ */
+function generateAnonymousClientId() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Retrieves or generates the anonymous client identifier.
+ */
+async function getOrCreateClientId() {
+    if (cachedClientId)
+        return cachedClientId;
+    try {
+        const stored = await (0, NativeInspector_1.getNativeStorageItem)(CLIENT_ID_KEY);
+        if (stored && typeof stored === 'string' && stored.length > 0) {
+            cachedClientId = stored;
+            return stored;
+        }
+    }
+    catch {
+        // Fallback to memory
+    }
+    const newId = generateAnonymousClientId();
+    cachedClientId = newId;
+    try {
+        await (0, NativeInspector_1.setNativeStorageItem)(CLIENT_ID_KEY, newId);
+    }
+    catch {
+        // Silently ignore storage errors
+    }
+    return newId;
+}
+/**
+ * Asynchronously loads host application and device metadata (strictly non-PII/technical).
+ */
+async function loadAppDiagnosticsAsync() {
+    if (cachedAppDiagnostics)
+        return cachedAppDiagnostics;
+    try {
+        const metrics = await (0, NativeInspector_1.getNativeDeviceMetrics)();
+        cachedAppDiagnostics = {
+            app_name: metrics?.appName ||
+                react_native_1.Platform.constants?.appName ||
+                'unknown',
+            app_version: metrics?.appVersion ||
+                react_native_1.Platform.constants?.appVersion ||
+                'unknown',
+            app_build: metrics?.appBuild || 'unknown',
+            app_bundle_id: metrics?.appBundleId || metrics?.appPackageName || 'unknown',
+            device_brand: metrics?.deviceBrand ||
+                react_native_1.Platform.constants?.Brand ||
+                react_native_1.Platform.constants?.systemName ||
+                'unknown',
+            device_model: metrics?.deviceModel ||
+                react_native_1.Platform.constants?.Model ||
+                react_native_1.Platform.constants?.interfaceIdiom ||
+                'unknown',
+        };
+    }
+    catch {
+        cachedAppDiagnostics = {
+            app_name: react_native_1.Platform.constants?.appName || 'unknown',
+            app_version: react_native_1.Platform.constants?.appVersion || 'unknown',
+            app_build: 'unknown',
+            app_bundle_id: 'unknown',
+            device_brand: react_native_1.Platform.constants?.Brand || 'unknown',
+            device_model: react_native_1.Platform.constants?.Model || 'unknown',
+        };
+    }
+    return cachedAppDiagnostics;
+}
+/**
+ * Extracts React Native framework version string (e.g. "0.81.4").
+ */
+function getReactNativeVersion() {
+    try {
+        const constants = react_native_1.Platform.constants;
+        if (constants && constants.reactNativeVersion) {
+            const { major, minor, patch, prerelease } = constants.reactNativeVersion;
+            return `${major}.${minor}.${patch}${prerelease ? `-${prerelease}` : ''}`;
+        }
+    }
+    catch {
+        // Fallback
+    }
+    return 'unknown';
+}
+/**
+ * Collects complete anonymous device, host app & runtime environment diagnostics.
+ */
+function getEnvironmentDiagnostics(extraParams = {}) {
+    const isHermes = Boolean(global.HermesInternal);
+    const isNewArch = Boolean(global._RN_FABRIC_ENABLED || global.__turboModuleProxy);
+    const isNativeLinked = (0, NativeInspector_1.isNativeModuleAvailable)();
+    const rnVersion = getReactNativeVersion();
+    const isExpo = Boolean(global?.expo?.modules?.ExponentConstants ||
+        global?.__expo ||
+        (typeof process !== 'undefined' &&
+            process?.env?.EXPO_PUBLIC_PROJECT_ROOT));
+    let screenResolution = 'unknown';
+    let fontScale = 1;
+    try {
+        const { width, height, scale, fontScale: fs } = react_native_1.Dimensions.get('window');
+        screenResolution = `${Math.round(width)}x${Math.round(height)}@${scale}x`;
+        fontScale = fs || 1;
+    }
+    catch {
+        // Ignore dimension errors
+    }
+    let colorScheme = 'unknown';
+    try {
+        colorScheme = react_native_1.Appearance.getColorScheme() || 'unspecified';
+    }
+    catch {
+        // Ignore appearance errors
+    }
+    const appMeta = cachedAppDiagnostics || {
+        app_name: react_native_1.Platform.constants?.appName || 'unknown',
+        app_version: react_native_1.Platform.constants?.appVersion || 'unknown',
+        app_build: 'unknown',
+        app_bundle_id: 'unknown',
+        device_brand: react_native_1.Platform.constants?.Brand ||
+            react_native_1.Platform.constants?.systemName ||
+            'unknown',
+        device_model: react_native_1.Platform.constants?.Model ||
+            react_native_1.Platform.constants?.interfaceIdiom ||
+            'unknown',
+    };
+    return {
+        session_id: CURRENT_SESSION_ID,
+        engagement_time_msec: 100,
+        lib_version: constants_1.LIB_VERSION,
+        platform: react_native_1.Platform.OS,
+        os_version: String(react_native_1.Platform.Version),
+        rn_version: rnVersion,
+        is_hermes: isHermes,
+        is_new_arch: isNewArch,
+        is_native_linked: isNativeLinked,
+        is_expo: isExpo,
+        is_dev: Boolean(typeof __DEV__ !== 'undefined' && __DEV__),
+        screen_resolution: screenResolution,
+        font_scale: fontScale,
+        color_scheme: colorScheme,
+        ...appMeta,
+        ...extraParams,
+    };
+}
+const CONSENT_STORAGE_KEY = 'telemetry_consent_status';
+let cachedConsentStatus = null;
+/**
+ * Returns the developer's telemetry consent status.
+ */
+async function getTelemetryConsentStatus() {
+    if (cachedConsentStatus)
+        return cachedConsentStatus;
+    try {
+        const stored = await (0, NativeInspector_1.getNativeStorageItem)(CONSENT_STORAGE_KEY);
+        if (stored === 'granted' || stored === 'declined') {
+            cachedConsentStatus = stored;
+            return stored;
+        }
+    }
+    catch {
+        // Fallback
+    }
+    return 'undetermined';
+}
+/**
+ * Saves the developer's telemetry consent choice.
+ */
+async function setTelemetryConsent(granted) {
+    const status = granted ? 'granted' : 'declined';
+    cachedConsentStatus = status;
+    try {
+        await (0, NativeInspector_1.setNativeStorageItem)(CONSENT_STORAGE_KEY, status);
+    }
+    catch {
+        // Ignore storage errors
+    }
+}
+/**
+ * Checks if the user or environment has opted out of telemetry.
+ */
+function isTelemetryOptedOut(explicitSetting) {
+    if (explicitSetting === false)
+        return true;
+    if (cachedConsentStatus === 'declined')
+        return true;
+    try {
+        if (typeof process !== 'undefined' &&
+            process?.env &&
+            (process.env.DO_NOT_TRACK === '1' || process.env.DISABLE_TELEMETRY === '1')) {
+            return true;
+        }
+    }
+    catch {
+        // Ignore environments where process is undefined or restricted
+    }
+    return false;
+}
+/**
+ * Track an anonymous event via GA4 Measurement Protocol.
+ */
+async function trackTelemetryEvent(eventName, params = {}, options) {
+    if (isTelemetryOptedOut(options?.telemetry))
+        return;
+    // Don't send if credentials haven't been configured yet
+    if (!exports.GA4_MEASUREMENT_ID ||
+        exports.GA4_MEASUREMENT_ID === 'G-XXXXXXXXXX' ||
+        !exports.GA4_API_SECRET ||
+        exports.GA4_API_SECRET === 'YOUR_GA4_API_SECRET') {
+        return;
+    }
+    try {
+        const clientId = await getOrCreateClientId();
+        await loadAppDiagnosticsAsync();
+        const eventParams = getEnvironmentDiagnostics(params);
+        const payload = {
+            client_id: clientId,
+            events: [
+                {
+                    name: eventName,
+                    params: eventParams,
+                },
+            ],
+        };
+        const url = `${GA4_ENDPOINT}?measurement_id=${encodeURIComponent(exports.GA4_MEASUREMENT_ID)}&api_secret=${encodeURIComponent(exports.GA4_API_SECRET)}`;
+        fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        }).catch(() => {
+            // If offline on initial cold start, allow a single delayed retry
+            if (eventName === 'inspector_session_init') {
+                hasPingedSession = false;
+                setTimeout(() => {
+                    sendSessionTelemetryPing(options);
+                }, 8000);
+            }
+        });
+    }
+    catch {
+        // Fail silently
+    }
+}
+/**
+ * 1. Session initialization heartbeat ping.
+ */
+async function sendSessionTelemetryPing(options) {
+    if (hasPingedSession && !options?.force)
+        return;
+    if (isTelemetryOptedOut(options?.telemetry))
+        return;
+    hasPingedSession = true;
+    await trackTelemetryEvent('inspector_session_init', {
+        environment: options?.environment || 'unknown',
+        has_navigation: Boolean(options?.hasNavigation),
+        has_app_icon: Boolean(options?.hasAppIcon),
+    }, options);
+}
+/**
+ * 2. Track when the inspector modal is opened.
+ */
+function trackInspectorOpen(options) {
+    lastModalOpenTimestamp = Date.now();
+    trackTelemetryEvent('inspector_open', {
+        open_source: options?.openSource || 'fab',
+        active_tab: options?.activeTab || 'apis',
+    }, options);
+}
+/**
+ * 3. Track when the inspector modal is closed.
+ */
+function trackInspectorClose(options) {
+    const durationSec = lastModalOpenTimestamp > 0
+        ? Math.round((Date.now() - lastModalOpenTimestamp) / 1000)
+        : 0;
+    trackTelemetryEvent('inspector_close', {
+        open_duration_seconds: durationSec,
+    }, options);
+}
+/**
+ * 4. Track tab / page view navigation inside the inspector.
+ */
+function trackTabSwitch(tabName, options) {
+    trackTelemetryEvent('page_view', {
+        page_title: `Tab: ${tabName}`,
+        page_location: `inapp-inspector://tab/${tabName}`,
+        tab_name: tabName,
+        from_tab: options?.fromTab || 'unknown',
+    }, options);
+}
+/**
+ * 5. Track network API interaction (inspect details, copy cURL, retry).
+ */
+function trackNetworkInteraction(action, options) {
+    trackTelemetryEvent('network_interaction', {
+        action_type: action,
+        http_method: options?.method || 'GET',
+        status_code: options?.statusCode || 0,
+        duration_ms: options?.durationMs || 0,
+    }, options);
+}
+/**
+ * 6. Track Redux / State management interaction.
+ */
+function trackReduxInteraction(action, options) {
+    trackTelemetryEvent('redux_interaction', {
+        action_type: action,
+        reducer_name: options?.reducerName || 'root',
+    }, options);
+}
+/**
+ * 7. Track Crash & Exception interaction.
+ */
+function trackCrashInteraction(action, options) {
+    trackTelemetryEvent('crash_interaction', {
+        action_type: action,
+        crash_type: options?.crashType || 'js_exception',
+    }, options);
+}
+/**
+ * 8. Track Performance monitoring tab interaction.
+ */
+function trackPerformanceInteraction(subTab, options) {
+    trackTelemetryEvent('performance_interaction', {
+        sub_tab: subTab,
+    }, options);
+}
+/**
+ * 9. Track search queries and filter applications.
+ */
+function trackSearchOrFilter(target, actionType, options) {
+    trackTelemetryEvent('search_and_filter', {
+        target_tab: target,
+        action_type: actionType,
+        filter_value: options?.filterValue || 'all',
+    }, options);
+}
+/**
+ * 10. Track when logs / reports are exported or shared.
+ */
+function trackLogExport(exportType, options) {
+    trackTelemetryEvent('log_export', {
+        export_type: exportType,
+        item_count: options?.count || 1,
+    }, options);
+}

package/dist/commonjs/index.d.ts

@@ -13,4 +13,6 @@ export { getEventCategory, registerGAPlugin, type GAPlugin, } from './helpers/ga
 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 { sendSessionTelemetryPing, trackTelemetryEvent, trackInspectorOpen, trackTabSwitch, trackLogExport, GA4_MEASUREMENT_ID, GA4_API_SECRET, } from './helpers';
+export { BrandSquareIcon, BrandCircleIcon, } from './components/NetworkIcons';
 export { ActiveTab, Method, StatusFilter, SortOrder, LocalFilter, ModalAnimationType, SettingsPage, SettingsSubTab, LogFilter, ConsoleLogType, AnalyticsEventSource, GAEventCategory, StackFrameType, DiffResultType, BundleSubTab, PerformanceSubTab, CrashType, CrashExportFormat, CrashDetailSubTab, CrashFilterType, BreadcrumbType, } from './types';

package/dist/commonjs/index.js

@@ -37,7 +37,8 @@ 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.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;
+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.BrandCircleIcon = exports.BrandSquareIcon = exports.GA4_API_SECRET = exports.GA4_MEASUREMENT_ID = exports.trackLogExport = exports.trackTabSwitch = exports.trackInspectorOpen = exports.trackTelemetryEvent = exports.sendSessionTelemetryPing = 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;
+exports.BreadcrumbType = exports.CrashFilterType = exports.CrashDetailSubTab = exports.CrashExportFormat = exports.CrashType = exports.PerformanceSubTab = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const native_1 = require("@react-navigation/native");
@@ -67,7 +68,7 @@ const NativeInspector_2 = require("./native/NativeInspector");
 const constants_1 = require("./constants");
 // Stylesheet
 const styles_1 = require("./styles");
-const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigationRef, appIcon, environment, }) => {
+const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigationRef, appIcon, environment, initialVisible, visible: controlledVisible, }) => {
     // Set custom storage synchronously during render phase
     (0, settingsStore_1.setCustomStorage)(storage || null);
     const [isDark, setIsDark] = (0, react_1.useState)(false);
@@ -79,7 +80,12 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
     const [modalHeightPercent, setModalHeightPercent] = (0, react_1.useState)(90);
     const [modalAnimationType, setModalAnimationType] = (0, react_1.useState)('slide');
     const [logs, setLogs] = (0, react_1.useState)([]);
-    const [visible, setVisible] = (0, react_1.useState)(false);
+    const [visible, setVisible] = (0, react_1.useState)(initialVisible ?? controlledVisible ?? false);
+    (0, react_1.useEffect)(() => {
+        if (controlledVisible !== undefined) {
+            setVisible(controlledVisible);
+        }
+    }, [controlledVisible]);
     const [isReady, setIsReady] = (0, react_1.useState)(false);
     const [selected, setSelected] = (0, react_1.useState)(null);
     const [selectedLogs, setSelectedLogs] = (0, react_1.useState)(new Set());
@@ -224,6 +230,7 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
     // #6 — tab the inspector opens on. Shown with a DEFAULT badge in Settings.
     const [defaultTab, setDefaultTab] = (0, react_1.useState)('apis');
     const [showDuplicateLogs, setShowDuplicateLogs] = (0, react_1.useState)(false);
+    const [showUpdateToast, setShowUpdateToast] = (0, react_1.useState)(true);
     // Synchronize runtime background listeners with active settings
     (0, react_1.useEffect)(() => {
         (0, networkLogger_1.setNetworkModuleEnabled)(!!tabVisibility.apis);
@@ -283,6 +290,7 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         setReduxAutoRefreshState(true);
         setReduxExpandDepth(1);
         setShowDuplicateLogs(false);
+        setShowUpdateToast(true);
         react_native_1.Alert.alert('Settings Reset', 'All settings have been reset to default values.');
     };
     // #5 — hydrate persisted settings once, then auto-save on any change.
@@ -326,6 +334,8 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                 setReduxExpandDepth(saved.reduxExpandDepth);
             if (saved.showDuplicateLogs != null)
                 setShowDuplicateLogs(saved.showDuplicateLogs);
+            if (saved.showUpdateToast != null)
+                setShowUpdateToast(saved.showUpdateToast);
             if (saved.defaultTab) {
                 const dt = saved.defaultTab;
                 const vis = {
@@ -367,6 +377,7 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
             reduxAutoRefresh,
             reduxExpandDepth,
             showDuplicateLogs,
+            showUpdateToast,
         });
     }, [
         isDark,
@@ -739,6 +750,14 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
     }, [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;
+    // Send anonymous initialization heartbeat to GA4 Measurement Protocol
+    (0, react_1.useEffect)(() => {
+        (0, helpers_1.sendSessionTelemetryPing)({
+            environment,
+            hasNavigation: Boolean(navigationRef),
+            hasAppIcon: Boolean(appIcon),
+        });
+    }, [environment, navigationRef, appIcon]);
     // 100% Native Main-Thread Floating Button Lifecycle
     (0, react_1.useEffect)(() => {
         if (!useNativeFab || !isEnabled || !enabled) {
@@ -793,6 +812,8 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
                 ? defaultTab
                 : 'apis';
             setActiveTab(target);
+            // Track inspector opened event in GA4
+            (0, helpers_1.trackInspectorOpen)({ activeTab: target });
             // Instant synchronization of data collected while modal was closed
             if (latestNetworkLogsRef.current.length > 0) {
                 const deduped = (0, helpers_1.deduplicateLogs)(latestNetworkLogsRef.current);
@@ -1732,6 +1753,8 @@ const NetworkInspector = ({ enabled = true, isEnabled = true, storage, navigatio
         setIsDark,
         showDuplicateLogs,
         setShowDuplicateLogs,
+        showUpdateToast,
+        setShowUpdateToast,
         showConsoleLevels,
         setShowConsoleLevels,
         resetToDefaults,
@@ -1855,6 +1878,17 @@ Object.defineProperty(exports, "getNativeFpsMetrics", { enumerable: true, get: f
 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 helpers_2 = require("./helpers");
+Object.defineProperty(exports, "sendSessionTelemetryPing", { enumerable: true, get: function () { return helpers_2.sendSessionTelemetryPing; } });
+Object.defineProperty(exports, "trackTelemetryEvent", { enumerable: true, get: function () { return helpers_2.trackTelemetryEvent; } });
+Object.defineProperty(exports, "trackInspectorOpen", { enumerable: true, get: function () { return helpers_2.trackInspectorOpen; } });
+Object.defineProperty(exports, "trackTabSwitch", { enumerable: true, get: function () { return helpers_2.trackTabSwitch; } });
+Object.defineProperty(exports, "trackLogExport", { enumerable: true, get: function () { return helpers_2.trackLogExport; } });
+Object.defineProperty(exports, "GA4_MEASUREMENT_ID", { enumerable: true, get: function () { return helpers_2.GA4_MEASUREMENT_ID; } });
+Object.defineProperty(exports, "GA4_API_SECRET", { enumerable: true, get: function () { return helpers_2.GA4_API_SECRET; } });
+var NetworkIcons_1 = require("./components/NetworkIcons");
+Object.defineProperty(exports, "BrandSquareIcon", { enumerable: true, get: function () { return NetworkIcons_1.BrandSquareIcon; } });
+Object.defineProperty(exports, "BrandCircleIcon", { enumerable: true, get: function () { return NetworkIcons_1.BrandCircleIcon; } });
 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

@@ -17,6 +17,11 @@ export interface NativeDeviceMetrics {
     osVersion?: string;
     apiLevel?: number;
     cpuAbi?: string;
+    appName?: string;
+    appVersion?: string;
+    appBuild?: string;
+    appBundleId?: string;
+    appPackageName?: string;
 }
 export interface NativeCrashEvent {
     platform: 'android' | 'ios';

package/dist/commonjs/native/NativeInspector.js

@@ -12,8 +12,9 @@ const isNativeModuleAvailable = () => {
     return !!NativeModule;
 };
 exports.isNativeModuleAvailable = isNativeModuleAvailable;
-const nativeEmitter = (0, exports.isNativeModuleAvailable)()
-    ? new react_native_1.NativeEventEmitter(NativeModule)
+const eventTarget = react_native_1.NativeModules.NetworkInspectorModule || NativeNetworkInspector_1.default;
+const nativeEmitter = eventTarget
+    ? new react_native_1.NativeEventEmitter(eventTarget)
     : null;
 /**
  * Retrieves low-level native hardware and system metrics (RAM, Heap, Disk, Battery, CPU).

package/dist/commonjs/types/interfaces.d.ts

@@ -151,6 +151,7 @@ export interface PersistedSettings {
     reduxAutoRefresh?: boolean;
     reduxExpandDepth?: number;
     showDuplicateLogs?: boolean;
+    showUpdateToast?: boolean;
 }
 export interface NetworkInspectorProps {
     enabled?: boolean;
@@ -160,6 +161,8 @@ export interface NetworkInspectorProps {
     navigationRef?: any;
     appIcon?: any;
     environment?: 'DEV' | 'UAT' | 'PrePROD' | 'PROD' | 'QA' | 'Staging' | string;
+    initialVisible?: boolean;
+    visible?: boolean;
 }
 export interface NavigationTrackerProps {
     onStateChange: (state: any) => void;
@@ -301,6 +304,8 @@ export interface InspectorContextValue {
     setIsDark: React.Dispatch<React.SetStateAction<boolean>>;
     showDuplicateLogs: boolean;
     setShowDuplicateLogs: React.Dispatch<React.SetStateAction<boolean>>;
+    showUpdateToast: boolean;
+    setShowUpdateToast: React.Dispatch<React.SetStateAction<boolean>>;
     showConsoleLevels: {
         info: boolean;
         warn: boolean;