@grafana/faro-react-native 1.0.0-alpha.1

package/dist/esm/instrumentations/anr/instrumentation.js

@@ -0,0 +1,171 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { NativeModules, Platform } from 'react-native';
+import { BaseInstrumentation, VERSION } from '@grafana/faro-core';
+import { ErrorMechanism } from '../errors/const';
+/**
+ * Default timeout for ANR detection (5 seconds, matching Android's threshold)
+ */
+const DEFAULT_TIMEOUT = 5000;
+/**
+ * Default polling interval for ANR status (60 seconds, matching Flutter SDK)
+ */
+const DEFAULT_POLLING_INTERVAL = 60000;
+/**
+ * ANR (Application Not Responding) Detection Instrumentation.
+ *
+ * Detects when the main/UI thread is blocked for extended periods on Android.
+ * Uses a background thread that posts tasks to the main thread and monitors
+ * if they complete within the timeout.
+ *
+ * **Note**: ANR detection is only available on Android. iOS does not have
+ * the same ANR concept as Android's system watchdog.
+ *
+ * Sends telemetry via Faro API:
+ * - Measurement: `anr` with `anr_count` value (for dashboards)
+ * - Error: Each ANR with `type: 'ANR'`, stack trace, duration, timestamp (Sentry-aligned)
+ *
+ * @example
+ * ```typescript
+ * import { initializeFaro, ANRInstrumentation } from '@grafana/faro-react-native';
+ *
+ * initializeFaro({
+ *   url: 'https://collector.example.com',
+ *   instrumentations: [
+ *     new ANRInstrumentation({
+ *       timeout: 5000,        // 5 second threshold
+ *       pollingInterval: 60000, // Poll every 60 seconds
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export class ANRInstrumentation extends BaseInstrumentation {
+    constructor(options = {}) {
+        var _a, _b;
+        super();
+        this.name = '@grafana/faro-react-native:instrumentation-anr';
+        this.version = VERSION;
+        this.pollingIntervalId = null;
+        this.options = {
+            timeout: (_a = options.timeout) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT,
+            pollingInterval: (_b = options.pollingInterval) !== null && _b !== void 0 ? _b : DEFAULT_POLLING_INTERVAL,
+        };
+    }
+    initialize() {
+        // ANR detection is only available on Android
+        if (Platform.OS !== 'android') {
+            this.logDebug('ANR detection is only available on Android');
+            return;
+        }
+        const nativeModule = this.getNativeModule();
+        if (!nativeModule) {
+            this.logWarn('Native module not available for ANR detection');
+            return;
+        }
+        this.logDebug('Initializing ANR detection instrumentation');
+        // Start native ANR tracking
+        this.startNativeTracking(nativeModule);
+        // Set up polling for ANR status
+        this.pollingIntervalId = setInterval(() => {
+            this.checkANRStatus(nativeModule);
+        }, this.options.pollingInterval);
+    }
+    getNativeModule() {
+        const { FaroReactNativeModule } = NativeModules;
+        if (!FaroReactNativeModule) {
+            return null;
+        }
+        return FaroReactNativeModule;
+    }
+    startNativeTracking(nativeModule) {
+        try {
+            if (typeof nativeModule.startANRTracking === 'function') {
+                nativeModule.startANRTracking({
+                    timeout: this.options.timeout,
+                });
+                this.logDebug('Started native ANR tracking');
+            }
+        }
+        catch (error) {
+            this.logError('Failed to start native ANR tracking', error);
+        }
+    }
+    checkANRStatus(nativeModule) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (typeof nativeModule.getANRStatus !== 'function') {
+                    return;
+                }
+                const anrList = (yield nativeModule.getANRStatus());
+                if (anrList && anrList.length > 0) {
+                    // Push measurement for ANR count (matching Flutter pattern)
+                    this.api.pushMeasurement({
+                        type: 'anr',
+                        values: { anr_count: anrList.length },
+                    }, { skipDedupe: true });
+                    // Push each ANR as an error with type='ANR' for filtering (Sentry-aligned)
+                    for (const anrJson of anrList) {
+                        try {
+                            const anr = JSON.parse(anrJson);
+                            this.api.pushError(new Error('ANR (Application Not Responding)'), {
+                                context: {
+                                    duration: String(anr.duration),
+                                    mechanism: ErrorMechanism.ANR,
+                                    stacktrace: anr.stacktrace,
+                                    timestamp: String(anr.timestamp),
+                                },
+                                type: 'ANR',
+                            });
+                        }
+                        catch (_a) {
+                            // If parsing fails, still log the raw ANR
+                            this.api.pushError(new Error('ANR (Application Not Responding)'), {
+                                context: {
+                                    mechanism: ErrorMechanism.ANR,
+                                    raw: anrJson,
+                                },
+                                type: 'ANR',
+                            });
+                        }
+                    }
+                    this.logDebug(`Recorded ${anrList.length} ANR event(s)`);
+                }
+            }
+            catch (error) {
+                this.logError('Failed to check ANR status', error);
+            }
+        });
+    }
+    /**
+     * Clean up resources when instrumentation is disabled.
+     */
+    unpatch() {
+        // Stop polling
+        if (this.pollingIntervalId !== null) {
+            clearInterval(this.pollingIntervalId);
+            this.pollingIntervalId = null;
+        }
+        // Stop native tracking
+        if (Platform.OS === 'android') {
+            const nativeModule = this.getNativeModule();
+            if (nativeModule && typeof nativeModule.stopANRTracking === 'function') {
+                try {
+                    nativeModule.stopANRTracking();
+                }
+                catch (error) {
+                    this.logError('Failed to stop native ANR tracking', error);
+                }
+            }
+        }
+        this.logDebug('ANR instrumentation stopped');
+    }
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/esm/instrumentations/anr/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../../../src/instrumentations/anr/instrumentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeModules, Platform } from 'react-native';\n\nimport { BaseInstrumentation, VERSION } from '@grafana/faro-core';\n\nimport { ErrorMechanism } from '../errors/const';\n\nimport type { ANREvent, ANRInstrumentationOptions } from './types';\n\n/**\n * Default timeout for ANR detection (5 seconds, matching Android's threshold)\n */\nconst DEFAULT_TIMEOUT = 5000;\n\n/**\n * Default polling interval for ANR status (60 seconds, matching Flutter SDK)\n */\nconst DEFAULT_POLLING_INTERVAL = 60000;\n\n/**\n * ANR (Application Not Responding) Detection Instrumentation.\n *\n * Detects when the main/UI thread is blocked for extended periods on Android.\n * Uses a background thread that posts tasks to the main thread and monitors\n * if they complete within the timeout.\n *\n * **Note**: ANR detection is only available on Android. iOS does not have\n * the same ANR concept as Android's system watchdog.\n *\n * Sends telemetry via Faro API:\n * - Measurement: `anr` with `anr_count` value (for dashboards)\n * - Error: Each ANR with `type: 'ANR'`, stack trace, duration, timestamp (Sentry-aligned)\n *\n * @example\n * ```typescript\n * import { initializeFaro, ANRInstrumentation } from '@grafana/faro-react-native';\n *\n * initializeFaro({\n *   url: 'https://collector.example.com',\n *   instrumentations: [\n *     new ANRInstrumentation({\n *       timeout: 5000,        // 5 second threshold\n *       pollingInterval: 60000, // Poll every 60 seconds\n *     }),\n *   ],\n * });\n * ```\n */\nexport class ANRInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-anr';\n  readonly version = VERSION;\n\n  private readonly options: Required<ANRInstrumentationOptions>;\n  private pollingIntervalId: ReturnType<typeof setInterval> | null = null;\n\n  constructor(options: ANRInstrumentationOptions = {}) {\n    super();\n    this.options = {\n      timeout: options.timeout ?? DEFAULT_TIMEOUT,\n      pollingInterval: options.pollingInterval ?? DEFAULT_POLLING_INTERVAL,\n    };\n  }\n\n  initialize(): void {\n    // ANR detection is only available on Android\n    if (Platform.OS !== 'android') {\n      this.logDebug('ANR detection is only available on Android');\n      return;\n    }\n\n    const nativeModule = this.getNativeModule();\n    if (!nativeModule) {\n      this.logWarn('Native module not available for ANR detection');\n      return;\n    }\n\n    this.logDebug('Initializing ANR detection instrumentation');\n\n    // Start native ANR tracking\n    this.startNativeTracking(nativeModule);\n\n    // Set up polling for ANR status\n    this.pollingIntervalId = setInterval(() => {\n      this.checkANRStatus(nativeModule);\n    }, this.options.pollingInterval);\n  }\n\n  private getNativeModule(): typeof NativeModules.FaroReactNativeModule | null {\n    const { FaroReactNativeModule } = NativeModules;\n\n    if (!FaroReactNativeModule) {\n      return null;\n    }\n\n    return FaroReactNativeModule;\n  }\n\n  private startNativeTracking(nativeModule: typeof NativeModules.FaroReactNativeModule): void {\n    try {\n      if (typeof nativeModule.startANRTracking === 'function') {\n        nativeModule.startANRTracking({\n          timeout: this.options.timeout,\n        });\n        this.logDebug('Started native ANR tracking');\n      }\n    } catch (error) {\n      this.logError('Failed to start native ANR tracking', error);\n    }\n  }\n\n  private async checkANRStatus(nativeModule: typeof NativeModules.FaroReactNativeModule): Promise<void> {\n    try {\n      if (typeof nativeModule.getANRStatus !== 'function') {\n        return;\n      }\n\n      const anrList = (await nativeModule.getANRStatus()) as string[] | null;\n\n      if (anrList && anrList.length > 0) {\n        // Push measurement for ANR count (matching Flutter pattern)\n        this.api.pushMeasurement(\n          {\n            type: 'anr',\n            values: { anr_count: anrList.length },\n          },\n          { skipDedupe: true }\n        );\n\n        // Push each ANR as an error with type='ANR' for filtering (Sentry-aligned)\n        for (const anrJson of anrList) {\n          try {\n            const anr = JSON.parse(anrJson) as ANREvent;\n\n            this.api.pushError(new Error('ANR (Application Not Responding)'), {\n              context: {\n                duration: String(anr.duration),\n                mechanism: ErrorMechanism.ANR,\n                stacktrace: anr.stacktrace,\n                timestamp: String(anr.timestamp),\n              },\n              type: 'ANR',\n            });\n          } catch {\n            // If parsing fails, still log the raw ANR\n            this.api.pushError(new Error('ANR (Application Not Responding)'), {\n              context: {\n                mechanism: ErrorMechanism.ANR,\n                raw: anrJson,\n              },\n              type: 'ANR',\n            });\n          }\n        }\n\n        this.logDebug(`Recorded ${anrList.length} ANR event(s)`);\n      }\n    } catch (error) {\n      this.logError('Failed to check ANR status', error);\n    }\n  }\n\n  /**\n   * Clean up resources when instrumentation is disabled.\n   */\n  unpatch(): void {\n    // Stop polling\n    if (this.pollingIntervalId !== null) {\n      clearInterval(this.pollingIntervalId);\n      this.pollingIntervalId = null;\n    }\n\n    // Stop native tracking\n    if (Platform.OS === 'android') {\n      const nativeModule = this.getNativeModule();\n      if (nativeModule && typeof nativeModule.stopANRTracking === 'function') {\n        try {\n          nativeModule.stopANRTracking();\n        } catch (error) {\n          this.logError('Failed to stop native ANR tracking', error);\n        }\n      }\n    }\n\n    this.logDebug('ANR instrumentation stopped');\n  }\n}\n"]}

package/dist/esm/instrumentations/anr/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/instrumentations/anr/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/instrumentations/anr/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configuration options for ANR (Application Not Responding) detection.\n */\nexport interface ANRInstrumentationOptions {\n  /**\n   * Timeout in milliseconds for detecting ANR.\n   * If the main thread doesn't respond within this time, an ANR is recorded.\n   * Default: 5000 (5 seconds, matching Android's ANR threshold)\n   */\n  timeout?: number;\n\n  /**\n   * Interval in milliseconds for polling ANR status from native.\n   * Default: 60000 (60 seconds, matching Flutter SDK's default)\n   */\n  pollingInterval?: number;\n}\n\n/**\n * ANR event data from native module.\n */\nexport interface ANREvent {\n  /**\n   * Event type (always \"ANR\")\n   */\n  type: string;\n\n  /**\n   * Timestamp when ANR was detected\n   */\n  timestamp: number;\n\n  /**\n   * Stack trace of the main thread when ANR was detected\n   */\n  stacktrace: string;\n\n  /**\n   * Duration of the ANR in milliseconds\n   */\n  duration: number;\n}\n"]}

package/dist/esm/instrumentations/appState/index.js

@@ -0,0 +1,103 @@
+import { AppState } from 'react-native';
+import { BaseInstrumentation, dateNow, VERSION } from '@grafana/faro-core';
+// Event name aligned with Faro Flutter SDK (app_lifecycle_changed)
+export const EVENT_APP_STATE_CHANGED = 'app_lifecycle_changed';
+/**
+ * AppState instrumentation for React Native
+ * Tracks app foreground/background/inactive state changes
+ *
+ * Emits `app_lifecycle_changed` with React Native `AppState` values in `fromState` / `toState`
+ * (active, background, inactive, unknown, extension).
+ */
+export class AppStateInstrumentation extends BaseInstrumentation {
+    constructor() {
+        super(...arguments);
+        this.name = '@grafana/faro-react-native:instrumentation-appstate';
+        this.version = VERSION;
+        /**
+         * Handles app state changes and emits app_lifecycle_changed events
+         * with native AppState status strings. Includes duration and timestamp for time-in-state analysis.
+         */
+        this.handleAppStateChange = (nextAppState) => {
+            const previousState = this.currentState;
+            const now = dateNow();
+            const duration = this.stateStartTime ? now - this.stateStartTime : 0;
+            // Update state tracking
+            this.currentState = nextAppState;
+            this.stateStartTime = now;
+            // Log the state change (internal debug keeps RN state names)
+            this.logDebug('App state changed', {
+                from: previousState,
+                to: nextAppState,
+                duration,
+            });
+            // Emit app lifecycle change event (native RN AppState values + duration/timestamp)
+            const fromState = previousState !== undefined ? previousState : '';
+            const toState = nextAppState;
+            this.api.pushEvent(EVENT_APP_STATE_CHANGED, {
+                fromState,
+                toState,
+                duration: duration.toString(),
+                timestamp: now.toString(),
+            }, undefined, { skipDedupe: true });
+            // Additional logging for specific transitions
+            if (nextAppState === 'background') {
+                this.logInfo('App moved to background', { fromState: previousState, duration });
+            }
+            else if (nextAppState === 'active' && previousState === 'background') {
+                this.logInfo('App returned to foreground', { duration });
+            }
+            else if (nextAppState === 'inactive') {
+                this.logDebug('App became inactive', { fromState: previousState });
+            }
+        };
+    }
+    initialize() {
+        // Get initial app state
+        this.currentState = AppState.currentState;
+        this.stateStartTime = dateNow();
+        this.logInfo('AppState instrumentation initialized', {
+            initialState: this.currentState,
+        });
+        // Subscribe to app state changes
+        this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);
+    }
+    /**
+     * Get the current app state
+     */
+    getCurrentState() {
+        return this.currentState;
+    }
+    /**
+     * Get the duration the app has been in the current state (in milliseconds)
+     */
+    getCurrentStateDuration() {
+        if (!this.stateStartTime) {
+            return 0;
+        }
+        return dateNow() - this.stateStartTime;
+    }
+    /**
+     * Check if app is currently in the foreground (active state)
+     */
+    isActive() {
+        return this.currentState === 'active';
+    }
+    /**
+     * Check if app is currently in the background
+     */
+    isBackground() {
+        return this.currentState === 'background';
+    }
+    /**
+     * Cleanup: Remove app state listener
+     */
+    unpatch() {
+        if (this.appStateSubscription) {
+            this.appStateSubscription.remove();
+            this.appStateSubscription = undefined;
+            this.logInfo('AppState instrumentation unpatched');
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/instrumentations/appState/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/appState/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppState, type AppStateStatus } from 'react-native';\n\nimport { BaseInstrumentation, dateNow, VERSION } from '@grafana/faro-core';\n\n// Event name aligned with Faro Flutter SDK (app_lifecycle_changed)\nexport const EVENT_APP_STATE_CHANGED = 'app_lifecycle_changed';\n\n/**\n * AppState instrumentation for React Native\n * Tracks app foreground/background/inactive state changes\n *\n * Emits `app_lifecycle_changed` with React Native `AppState` values in `fromState` / `toState`\n * (active, background, inactive, unknown, extension).\n */\nexport class AppStateInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-appstate';\n  readonly version = VERSION;\n\n  private currentState: AppStateStatus | undefined;\n  private stateStartTime: number | undefined;\n  private appStateSubscription: ReturnType<typeof AppState.addEventListener> | undefined;\n\n  initialize(): void {\n    // Get initial app state\n    this.currentState = AppState.currentState;\n    this.stateStartTime = dateNow();\n\n    this.logInfo('AppState instrumentation initialized', {\n      initialState: this.currentState,\n    });\n\n    // Subscribe to app state changes\n    this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);\n  }\n\n  /**\n   * Handles app state changes and emits app_lifecycle_changed events\n   * with native AppState status strings. Includes duration and timestamp for time-in-state analysis.\n   */\n  private handleAppStateChange = (nextAppState: AppStateStatus): void => {\n    const previousState = this.currentState;\n    const now = dateNow();\n    const duration = this.stateStartTime ? now - this.stateStartTime : 0;\n\n    // Update state tracking\n    this.currentState = nextAppState;\n    this.stateStartTime = now;\n\n    // Log the state change (internal debug keeps RN state names)\n    this.logDebug('App state changed', {\n      from: previousState,\n      to: nextAppState,\n      duration,\n    });\n\n    // Emit app lifecycle change event (native RN AppState values + duration/timestamp)\n    const fromState = previousState !== undefined ? previousState : '';\n    const toState = nextAppState;\n    this.api.pushEvent(\n      EVENT_APP_STATE_CHANGED,\n      {\n        fromState,\n        toState,\n        duration: duration.toString(),\n        timestamp: now.toString(),\n      },\n      undefined,\n      { skipDedupe: true }\n    );\n\n    // Additional logging for specific transitions\n    if (nextAppState === 'background') {\n      this.logInfo('App moved to background', { fromState: previousState, duration });\n    } else if (nextAppState === 'active' && previousState === 'background') {\n      this.logInfo('App returned to foreground', { duration });\n    } else if (nextAppState === 'inactive') {\n      this.logDebug('App became inactive', { fromState: previousState });\n    }\n  };\n\n  /**\n   * Get the current app state\n   */\n  getCurrentState(): AppStateStatus | undefined {\n    return this.currentState;\n  }\n\n  /**\n   * Get the duration the app has been in the current state (in milliseconds)\n   */\n  getCurrentStateDuration(): number {\n    if (!this.stateStartTime) {\n      return 0;\n    }\n    return dateNow() - this.stateStartTime;\n  }\n\n  /**\n   * Check if app is currently in the foreground (active state)\n   */\n  isActive(): boolean {\n    return this.currentState === 'active';\n  }\n\n  /**\n   * Check if app is currently in the background\n   */\n  isBackground(): boolean {\n    return this.currentState === 'background';\n  }\n\n  /**\n   * Cleanup: Remove app state listener\n   */\n  unpatch(): void {\n    if (this.appStateSubscription) {\n      this.appStateSubscription.remove();\n      this.appStateSubscription = undefined;\n      this.logInfo('AppState instrumentation unpatched');\n    }\n  }\n}\n"]}

package/dist/esm/instrumentations/console/index.js

@@ -0,0 +1,109 @@
+import { allLogLevels, BaseInstrumentation, defaultErrorArgsSerializer, LogLevel, VERSION } from '@grafana/faro-core';
+import { ErrorMechanism } from '../errors/const';
+import { getDetailsFromConsoleErrorArgs, reactNativeLogArgsSerializer } from './utils';
+/**
+ * Console instrumentation for React Native
+ * Captures console logs and errors
+ *
+ * Features:
+ * - Configurable log levels
+ * - Advanced error serialization
+ * - Option to treat console.error as log or error
+ * - Unpatch support for cleanup
+ */
+export class ConsoleInstrumentation extends BaseInstrumentation {
+    constructor() {
+        super(...arguments);
+        this.name = '@grafana/faro-react-native:instrumentation-console';
+        this.version = VERSION;
+        this.originalConsole = {};
+        this.errorSerializer = reactNativeLogArgsSerializer;
+        this.patchedLevels = [];
+    }
+    initialize() {
+        var _a, _b;
+        const instrumentationOptions = this.config.consoleInstrumentation;
+        // Configure error serialization
+        const serializeErrors = (instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.serializeErrors) || !!(instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.errorSerializer);
+        this.errorSerializer = serializeErrors
+            ? ((_a = instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.errorSerializer) !== null && _a !== void 0 ? _a : defaultErrorArgsSerializer)
+            : reactNativeLogArgsSerializer;
+        // Store original console methods
+        allLogLevels.forEach((level) => {
+            this.originalConsole[level] = console[level];
+        });
+        // Determine which levels to patch
+        this.patchedLevels = allLogLevels.filter((level) => { var _a; return !((_a = instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.disabledLevels) !== null && _a !== void 0 ? _a : ConsoleInstrumentation.defaultDisabledLevels).includes(level); });
+        // Patch console methods
+        this.patchedLevels.forEach((level) => {
+            console[level] = (...args) => {
+                var _a, _b;
+                try {
+                    if (level === LogLevel.ERROR && !(instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.consoleErrorAsLog)) {
+                        // Handle console.error as an error with advanced serialization
+                        const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);
+                        const context = { mechanism: ErrorMechanism.CONSOLE };
+                        if (value && !type && !stackFrames) {
+                            // Simple error without stack frames
+                            this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + value), { context });
+                        }
+                        else {
+                            // Error with type and/or stack frames (type from error.name, matches Web SDK)
+                            this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + (value !== null && value !== void 0 ? value : '')), {
+                                context,
+                                type,
+                                stackFrames,
+                            });
+                        }
+                    }
+                    else if (level === LogLevel.ERROR && (instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.consoleErrorAsLog)) {
+                        // Handle console.error as a log with error details in context
+                        const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);
+                        this.api.pushLog(value ? [ConsoleInstrumentation.consoleErrorPrefix + value] : args, {
+                            level,
+                            context: {
+                                value: value !== null && value !== void 0 ? value : '',
+                                type: type !== null && type !== void 0 ? type : '',
+                                stackFrames: (stackFrames === null || stackFrames === void 0 ? void 0 : stackFrames.length) ? defaultErrorArgsSerializer(stackFrames) : '',
+                            },
+                        });
+                    }
+                    else {
+                        // Handle other log levels normally
+                        this.api.pushLog(args, { level });
+                    }
+                }
+                catch (err) {
+                    // Use unpatchedConsole to avoid infinite loop
+                    this.unpatchedConsole.error('[Faro Console] Error capturing log:', err);
+                    this.logError(err);
+                }
+                finally {
+                    // Always call original console method
+                    (_b = (_a = this.originalConsole)[level]) === null || _b === void 0 ? void 0 : _b.call(_a, ...args);
+                }
+            };
+        });
+        this.logInfo('Console instrumentation initialized', {
+            patchedLevels: this.patchedLevels,
+            serializeErrors,
+            consoleErrorAsLog: (_b = instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.consoleErrorAsLog) !== null && _b !== void 0 ? _b : false,
+        });
+    }
+    /**
+     * Restore original console methods
+     * Call this to clean up and unpatch the console
+     */
+    unpatch() {
+        this.patchedLevels.forEach((level) => {
+            if (this.originalConsole[level]) {
+                console[level] = this.originalConsole[level];
+            }
+        });
+        this.patchedLevels = [];
+        this.logInfo('Console instrumentation unpatched');
+    }
+}
+ConsoleInstrumentation.defaultDisabledLevels = [LogLevel.DEBUG, LogLevel.TRACE, LogLevel.LOG];
+ConsoleInstrumentation.consoleErrorPrefix = 'console.error: ';
+//# sourceMappingURL=index.js.map

package/dist/esm/instrumentations/console/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/console/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { allLogLevels, BaseInstrumentation, defaultErrorArgsSerializer, LogLevel, VERSION } from '@grafana/faro-core';\nimport type { LogArgsSerializer } from '@grafana/faro-core';\n\nimport { ErrorMechanism } from '../errors/const';\n\nimport { getDetailsFromConsoleErrorArgs, reactNativeLogArgsSerializer } from './utils';\n\n/**\n * Console instrumentation for React Native\n * Captures console logs and errors\n *\n * Features:\n * - Configurable log levels\n * - Advanced error serialization\n * - Option to treat console.error as log or error\n * - Unpatch support for cleanup\n */\nexport class ConsoleInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-console';\n  readonly version = VERSION;\n\n  static defaultDisabledLevels: LogLevel[] = [LogLevel.DEBUG, LogLevel.TRACE, LogLevel.LOG];\n  static consoleErrorPrefix = 'console.error: ';\n\n  private originalConsole: Partial<Console> = {};\n  private errorSerializer: LogArgsSerializer = reactNativeLogArgsSerializer;\n  private patchedLevels: LogLevel[] = [];\n\n  initialize(): void {\n    const instrumentationOptions = this.config.consoleInstrumentation;\n\n    // Configure error serialization\n    const serializeErrors = instrumentationOptions?.serializeErrors || !!instrumentationOptions?.errorSerializer;\n    this.errorSerializer = serializeErrors\n      ? (instrumentationOptions?.errorSerializer ?? defaultErrorArgsSerializer)\n      : reactNativeLogArgsSerializer;\n\n    // Store original console methods\n    allLogLevels.forEach((level) => {\n      this.originalConsole[level] = console[level];\n    });\n\n    // Determine which levels to patch\n    this.patchedLevels = allLogLevels.filter(\n      (level) =>\n        !(instrumentationOptions?.disabledLevels ?? ConsoleInstrumentation.defaultDisabledLevels).includes(level)\n    );\n\n    // Patch console methods\n    this.patchedLevels.forEach((level) => {\n      console[level] = (...args: unknown[]) => {\n        try {\n          if (level === LogLevel.ERROR && !instrumentationOptions?.consoleErrorAsLog) {\n            // Handle console.error as an error with advanced serialization\n            const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);\n\n            const context = { mechanism: ErrorMechanism.CONSOLE };\n\n            if (value && !type && !stackFrames) {\n              // Simple error without stack frames\n              this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + value), { context });\n            } else {\n              // Error with type and/or stack frames (type from error.name, matches Web SDK)\n              this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + (value ?? '')), {\n                context,\n                type,\n                stackFrames,\n              });\n            }\n          } else if (level === LogLevel.ERROR && instrumentationOptions?.consoleErrorAsLog) {\n            // Handle console.error as a log with error details in context\n            const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);\n\n            this.api.pushLog(value ? [ConsoleInstrumentation.consoleErrorPrefix + value] : args, {\n              level,\n              context: {\n                value: value ?? '',\n                type: type ?? '',\n                stackFrames: stackFrames?.length ? defaultErrorArgsSerializer(stackFrames) : '',\n              },\n            });\n          } else {\n            // Handle other log levels normally\n            this.api.pushLog(args, { level });\n          }\n        } catch (err) {\n          // Use unpatchedConsole to avoid infinite loop\n          this.unpatchedConsole.error('[Faro Console] Error capturing log:', err);\n          this.logError(err);\n        } finally {\n          // Always call original console method\n          this.originalConsole[level]?.(...args);\n        }\n      };\n    });\n\n    this.logInfo('Console instrumentation initialized', {\n      patchedLevels: this.patchedLevels,\n      serializeErrors,\n      consoleErrorAsLog: instrumentationOptions?.consoleErrorAsLog ?? false,\n    });\n  }\n\n  /**\n   * Restore original console methods\n   * Call this to clean up and unpatch the console\n   */\n  unpatch(): void {\n    this.patchedLevels.forEach((level) => {\n      if (this.originalConsole[level]) {\n        console[level] = this.originalConsole[level];\n      }\n    });\n\n    this.patchedLevels = [];\n    this.logInfo('Console instrumentation unpatched');\n  }\n}\n"]}

package/dist/esm/instrumentations/console/utils.js

@@ -0,0 +1,127 @@
+import { isError, isObject, isString } from '@grafana/faro-core';
+/**
+ * React Native-specific log args serializer that handles objects better
+ * Converts objects to JSON strings instead of [object Object]
+ */
+export const reactNativeLogArgsSerializer = (args) => args
+    .map((arg) => {
+    try {
+        // Handle null and undefined
+        if (arg === null)
+            return 'null';
+        if (arg === undefined)
+            return 'undefined';
+        // Handle Error objects
+        if (isError(arg)) {
+            return `${arg.name}: ${arg.message}`;
+        }
+        // Handle objects and arrays - stringify them
+        if (isObject(arg) || Array.isArray(arg)) {
+            try {
+                return JSON.stringify(arg);
+            }
+            catch (_a) {
+                return String(arg);
+            }
+        }
+        // Handle primitives
+        return String(arg);
+    }
+    catch (_err) {
+        return '';
+    }
+})
+    .join(' ');
+/**
+ * Gets stack frames from an Error object
+ * React Native errors have a `stack` property as a string
+ */
+function getStackFramesFromError(error) {
+    if (!error.stack) {
+        return [];
+    }
+    // Parse React Native stack trace format
+    // Example format:
+    // "Error: message\n    at functionName (file.js:10:5)\n    at anotherFunction (file.js:20:10)"
+    const stackFrames = [];
+    const lines = error.stack.split('\n').slice(1); // Skip first line (error message)
+    for (const line of lines) {
+        // Match patterns like:
+        // "    at functionName (file.js:10:5)"
+        // "    at file.js:10:5"
+        const match = line.match(/^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/);
+        if (match) {
+            const [, functionName, filename, lineNo, colNo] = match;
+            stackFrames.push({
+                filename: (filename === null || filename === void 0 ? void 0 : filename.trim()) || '<anonymous>',
+                function: (functionName === null || functionName === void 0 ? void 0 : functionName.trim()) || '<anonymous>',
+                lineno: lineNo ? parseInt(lineNo, 10) : undefined,
+                colno: colNo ? parseInt(colNo, 10) : undefined,
+            });
+        }
+    }
+    return stackFrames;
+}
+/**
+ * Extracts error details from Error object
+ */
+function getErrorDetails(error) {
+    var _a;
+    let value;
+    let type;
+    let stackFrames = [];
+    if (isError(error)) {
+        value = error.message;
+        type = error.name;
+        stackFrames = getStackFramesFromError(error);
+    }
+    else if (isObject(error)) {
+        // Handle error-like objects
+        value = String(error);
+        const errorObj = error;
+        type =
+            errorObj && typeof errorObj === 'object' && 'constructor' in errorObj
+                ? (_a = errorObj.constructor) === null || _a === void 0 ? void 0 : _a.name
+                : undefined;
+    }
+    return [value, type, stackFrames];
+}
+/**
+ * Extracts error details from an array of arguments
+ * Similar to web SDK's getDetailsFromErrorArgs but adapted for React Native
+ */
+export function getDetailsFromErrorArgs(args) {
+    const [firstArg] = args;
+    let value;
+    let type;
+    let stackFrames = [];
+    if (isError(firstArg)) {
+        [value, type, stackFrames] = getErrorDetails(firstArg);
+    }
+    else if (isString(firstArg)) {
+        value = firstArg;
+    }
+    else if (isObject(firstArg)) {
+        try {
+            value = JSON.stringify(firstArg);
+        }
+        catch (_a) {
+            value = String(firstArg);
+        }
+    }
+    return { value, type, stackFrames };
+}
+/**
+ * Gets error details from console.error arguments
+ * If first argument is an Error, extracts error details with stack frames
+ * Otherwise, uses the provided serializer to stringify the arguments
+ */
+export function getDetailsFromConsoleErrorArgs(args, serializer) {
+    if (isError(args[0])) {
+        return getDetailsFromErrorArgs(args);
+    }
+    else {
+        return { value: serializer(args) };
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/instrumentations/console/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/instrumentations/console/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { isError, isObject, isString } from '@grafana/faro-core';\nimport type { ExceptionStackFrame, LogArgsSerializer } from '@grafana/faro-core';\n\n/**\n * Error details extracted from console.error arguments\n */\nexport interface ErrorDetails {\n  value?: string;\n  type?: string;\n  stackFrames?: ExceptionStackFrame[];\n}\n\n/**\n * React Native-specific log args serializer that handles objects better\n * Converts objects to JSON strings instead of [object Object]\n */\nexport const reactNativeLogArgsSerializer: LogArgsSerializer = (args) =>\n  args\n    .map((arg) => {\n      try {\n        // Handle null and undefined\n        if (arg === null) return 'null';\n        if (arg === undefined) return 'undefined';\n\n        // Handle Error objects\n        if (isError(arg)) {\n          return `${arg.name}: ${arg.message}`;\n        }\n\n        // Handle objects and arrays - stringify them\n        if (isObject(arg) || Array.isArray(arg)) {\n          try {\n            return JSON.stringify(arg);\n          } catch {\n            return String(arg);\n          }\n        }\n\n        // Handle primitives\n        return String(arg);\n      } catch (_err) {\n        return '';\n      }\n    })\n    .join(' ');\n\n/**\n * Gets stack frames from an Error object\n * React Native errors have a `stack` property as a string\n */\nfunction getStackFramesFromError(error: Error): ExceptionStackFrame[] {\n  if (!error.stack) {\n    return [];\n  }\n\n  // Parse React Native stack trace format\n  // Example format:\n  // \"Error: message\\n    at functionName (file.js:10:5)\\n    at anotherFunction (file.js:20:10)\"\n\n  const stackFrames: ExceptionStackFrame[] = [];\n  const lines = error.stack.split('\\n').slice(1); // Skip first line (error message)\n\n  for (const line of lines) {\n    // Match patterns like:\n    // \"    at functionName (file.js:10:5)\"\n    // \"    at file.js:10:5\"\n    const match = line.match(/^\\s*at\\s+(?:(.+?)\\s+\\()?(.+?):(\\d+):(\\d+)\\)?$/);\n\n    if (match) {\n      const [, functionName, filename, lineNo, colNo] = match;\n\n      stackFrames.push({\n        filename: filename?.trim() || '<anonymous>',\n        function: functionName?.trim() || '<anonymous>',\n        lineno: lineNo ? parseInt(lineNo, 10) : undefined,\n        colno: colNo ? parseInt(colNo, 10) : undefined,\n      });\n    }\n  }\n\n  return stackFrames;\n}\n\n/**\n * Extracts error details from Error object\n */\nfunction getErrorDetails(error: Error): [string | undefined, string | undefined, ExceptionStackFrame[]] {\n  let value: string | undefined;\n  let type: string | undefined;\n  let stackFrames: ExceptionStackFrame[] = [];\n\n  if (isError(error)) {\n    value = error.message;\n    type = error.name;\n    stackFrames = getStackFramesFromError(error);\n  } else if (isObject(error)) {\n    // Handle error-like objects\n    value = String(error);\n    const errorObj = error as Record<string, unknown>;\n    type =\n      errorObj && typeof errorObj === 'object' && 'constructor' in errorObj\n        ? (errorObj.constructor as { name?: string })?.name\n        : undefined;\n  }\n\n  return [value, type, stackFrames];\n}\n\n/**\n * Extracts error details from an array of arguments\n * Similar to web SDK's getDetailsFromErrorArgs but adapted for React Native\n */\nexport function getDetailsFromErrorArgs(args: [unknown?, ...unknown[]]): ErrorDetails {\n  const [firstArg] = args;\n\n  let value: string | undefined;\n  let type: string | undefined;\n  let stackFrames: ExceptionStackFrame[] = [];\n\n  if (isError(firstArg)) {\n    [value, type, stackFrames] = getErrorDetails(firstArg);\n  } else if (isString(firstArg)) {\n    value = firstArg;\n  } else if (isObject(firstArg)) {\n    try {\n      value = JSON.stringify(firstArg);\n    } catch {\n      value = String(firstArg);\n    }\n  }\n\n  return { value, type, stackFrames };\n}\n\n/**\n * Gets error details from console.error arguments\n * If first argument is an Error, extracts error details with stack frames\n * Otherwise, uses the provided serializer to stringify the arguments\n */\nexport function getDetailsFromConsoleErrorArgs(\n  args: [unknown?, ...unknown[]],\n  serializer: LogArgsSerializer\n): ErrorDetails {\n  if (isError(args[0])) {\n    return getDetailsFromErrorArgs(args);\n  } else {\n    return { value: serializer(args) };\n  }\n}\n"]}

package/dist/esm/instrumentations/crashReporting/index.js

@@ -0,0 +1,2 @@
+export { CrashReportingInstrumentation } from './instrumentation';
+//# sourceMappingURL=index.js.map

package/dist/esm/instrumentations/crashReporting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export { CrashReportingInstrumentation } from './instrumentation';\nexport type { CrashReport, CrashReportingOptions } from './types';\n"]}