react-native-inapp-inspector 2.2.4 → 2.2.6

package/dist/commonjs/helpers/telemetry.js

@@ -1,398 +0,0 @@
-"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-3QGMQVZX5V';
-exports.GA4_API_SECRET = 'C46RQZ3PTfmHDnLnvU3KIg';
-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-3QGMQVZX5V' ||
-        !exports.GA4_API_SECRET ||
-        exports.GA4_API_SECRET === 'C46RQZ3PTfmHDnLnvU3KIg') {
-        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/esm/components/Inspector/TelemetryConsentModal.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-export declare const TelemetryConsentModal: () => React.JSX.Element;
-export default TelemetryConsentModal;