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

package/dist/cjs/instrumentations/crashReporting/instrumentation.js

@@ -0,0 +1,329 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+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());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrashReportingInstrumentation = void 0;
+var react_native_1 = require("react-native");
+var faro_core_1 = require("@grafana/faro-core");
+var const_1 = require("../errors/const");
+/**
+ * Crash Reporting Instrumentation (Experimental).
+ *
+ * Retrieves crash reports from previous app sessions and sends them via Faro API.
+ *
+ * **Platform Support**:
+ * - **Android**: Uses ApplicationExitInfo API (Android 11+ / API 30+)
+ *   Captures: CRASH, CRASH_NATIVE, ANR, LOW_MEMORY, EXCESSIVE_RESOURCE_USAGE
+ * - **iOS**: Uses PLCrashReporter (requires adding dependency to podspec)
+ *   Captures: Signal crashes (SIGSEGV, SIGABRT, etc.) and Mach exceptions
+ *
+ * **Note**: This instrumentation only retrieves crash data from previous sessions.
+ * The crash itself terminates the app, so the report is sent on next app launch.
+ *
+ * @example
+ * ```typescript
+ * import { initializeFaro, CrashReportingInstrumentation } from '@grafana/faro-react-native';
+ *
+ * initializeFaro({
+ *   url: 'https://collector.example.com',
+ *   instrumentations: [
+ *     new CrashReportingInstrumentation(),
+ *   ],
+ * });
+ * ```
+ */
+var CrashReportingInstrumentation = /** @class */ (function (_super) {
+    __extends(CrashReportingInstrumentation, _super);
+    function CrashReportingInstrumentation(options) {
+        if (options === void 0) { options = {}; }
+        var _a;
+        var _this = _super.call(this) || this;
+        _this.name = '@grafana/faro-react-native:instrumentation-crash';
+        _this.version = faro_core_1.VERSION;
+        _this.options = {
+            enabled: (_a = options.enabled) !== null && _a !== void 0 ? _a : true,
+        };
+        return _this;
+    }
+    CrashReportingInstrumentation.prototype.initialize = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var nativeModule;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.options.enabled) {
+                            this.logDebug('Crash reporting is disabled');
+                            return [2 /*return*/];
+                        }
+                        nativeModule = this.getNativeModule();
+                        if (!nativeModule) {
+                            this.logWarn('Native module not available for crash reporting');
+                            return [2 /*return*/];
+                        }
+                        this.logDebug('Initializing crash reporting instrumentation');
+                        // Wait for session attributes to be populated before sending crash reports
+                        // This ensures crash reports include full session metadata
+                        return [4 /*yield*/, this.waitForSessionAttributes()];
+                    case 1:
+                        // Wait for session attributes to be populated before sending crash reports
+                        // This ensures crash reports include full session metadata
+                        _a.sent();
+                        // Get crash reports from previous session
+                        return [4 /*yield*/, this.processCrashReports(nativeModule)];
+                    case 2:
+                        // Get crash reports from previous session
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Wait for session attributes to be populated.
+     *
+     * Crash reports are sent in a new session, so we need to wait for
+     * SessionInstrumentation to finish collecting device info, OS version, etc.
+     * before sending the crash report. Otherwise, the crash report will be missing
+     * session metadata.
+     *
+     * This checks for multiple device-specific attributes that are collected
+     * asynchronously (device_id, device_os_detail, device_model_name) to ensure
+     * the async getSessionAttributes() call has completed.
+     *
+     * @param maxWaitMs Maximum time to wait in milliseconds (default 10000ms)
+     */
+    CrashReportingInstrumentation.prototype.waitForSessionAttributes = function () {
+        return __awaiter(this, arguments, void 0, function (maxWaitMs) {
+            var startTime, pollInterval, checkCount, sessionAttrs, attrCount, attrKeys, hasDeviceId, hasDeviceOsDetail, hasDeviceModelName, elapsed, finalAttrs, finalAttrCount, finalAttrKeys;
+            var _a, _b, _c, _d, _e, _f;
+            if (maxWaitMs === void 0) { maxWaitMs = 10000; }
+            return __generator(this, function (_g) {
+                switch (_g.label) {
+                    case 0:
+                        startTime = Date.now();
+                        pollInterval = 200;
+                        checkCount = 0;
+                        _g.label = 1;
+                    case 1:
+                        if (!(Date.now() - startTime < maxWaitMs)) return [3 /*break*/, 3];
+                        checkCount++;
+                        try {
+                            sessionAttrs = (_c = (_b = (_a = this.metas) === null || _a === void 0 ? void 0 : _a.value) === null || _b === void 0 ? void 0 : _b.session) === null || _c === void 0 ? void 0 : _c.attributes;
+                            if (sessionAttrs) {
+                                attrCount = Object.keys(sessionAttrs).length;
+                                attrKeys = JSON.stringify(Object.keys(sessionAttrs));
+                                hasDeviceId = 'device_id' in sessionAttrs && sessionAttrs['device_id'] !== 'unknown';
+                                hasDeviceOsDetail = 'device_os_detail' in sessionAttrs && sessionAttrs['device_os_detail'] !== 'unknown';
+                                hasDeviceModelName = 'device_model_name' in sessionAttrs;
+                                if (hasDeviceId && hasDeviceOsDetail && hasDeviceModelName) {
+                                    elapsed = Date.now() - startTime;
+                                    this.logDebug("Session attributes ready after ".concat(elapsed, "ms (").concat(checkCount, " checks, ").concat(attrCount, " attrs)"));
+                                    return [2 /*return*/];
+                                }
+                                else {
+                                    this.logDebug("Check #".concat(checkCount, ": Found ").concat(attrCount, " session attributes: ").concat(attrKeys, " but still missing required attrs - device_id:").concat(hasDeviceId, ", device_os_detail:").concat(hasDeviceOsDetail, ", device_model_name:").concat(hasDeviceModelName));
+                                }
+                            }
+                            else {
+                                this.logDebug("Check #".concat(checkCount, ": No session attributes available yet"));
+                            }
+                        }
+                        catch (error) {
+                            // Continue waiting if we can't access metas yet
+                            this.logDebug("Check #".concat(checkCount, ": Error accessing metas: ").concat(error));
+                        }
+                        // Wait before next check
+                        return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, pollInterval); })];
+                    case 2:
+                        // Wait before next check
+                        _g.sent();
+                        return [3 /*break*/, 1];
+                    case 3:
+                        finalAttrs = (_f = (_e = (_d = this.metas) === null || _d === void 0 ? void 0 : _d.value) === null || _e === void 0 ? void 0 : _e.session) === null || _f === void 0 ? void 0 : _f.attributes;
+                        finalAttrCount = finalAttrs ? Object.keys(finalAttrs).length : 0;
+                        finalAttrKeys = finalAttrs ? JSON.stringify(Object.keys(finalAttrs)) : 'none';
+                        this.logWarn("Session attributes not ready after ".concat(maxWaitMs, "ms timeout (").concat(checkCount, " checks, ").concat(finalAttrCount, " attrs: ").concat(finalAttrKeys, "). Sending crash report anyway."));
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    CrashReportingInstrumentation.prototype.getNativeModule = function () {
+        var FaroReactNativeModule = react_native_1.NativeModules.FaroReactNativeModule;
+        if (!FaroReactNativeModule) {
+            return null;
+        }
+        return FaroReactNativeModule;
+    };
+    CrashReportingInstrumentation.prototype.processCrashReports = function (nativeModule) {
+        return __awaiter(this, void 0, void 0, function () {
+            var crashReports, _i, crashReports_1, crashJson, crash, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        if (typeof nativeModule.getCrashReport !== 'function') {
+                            this.logDebug('getCrashReport method not available');
+                            return [2 /*return*/];
+                        }
+                        this.logDebug('Attempting to retrieve crash reports from native module');
+                        return [4 /*yield*/, nativeModule.getCrashReport()];
+                    case 1:
+                        crashReports = (_a.sent());
+                        if (!crashReports || crashReports.length === 0) {
+                            this.logDebug('No crash reports from previous session');
+                            return [2 /*return*/];
+                        }
+                        this.logDebug("Processing ".concat(crashReports.length, " crash report(s) from previous session"));
+                        for (_i = 0, crashReports_1 = crashReports; _i < crashReports_1.length; _i++) {
+                            crashJson = crashReports_1[_i];
+                            try {
+                                this.logDebug("Parsing crash report JSON: ".concat(crashJson.substring(0, 200), "..."));
+                                crash = JSON.parse(crashJson);
+                                this.sendCrashReport(crash);
+                            }
+                            catch (parseError) {
+                                // If parsing fails, still try to report something
+                                this.logError('Failed to parse crash report JSON', parseError);
+                                this.api.pushError(new Error('Application crash (parse error)'), {
+                                    context: {
+                                        mechanism: const_1.ErrorMechanism.CRASH,
+                                        parseError: String(parseError),
+                                        raw: crashJson.substring(0, 500), // Limit size
+                                    },
+                                    type: 'crash',
+                                });
+                            }
+                        }
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_1 = _a.sent();
+                        this.logError('Failed to process crash reports', error_1);
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    CrashReportingInstrumentation.prototype.sendCrashReport = function (crash) {
+        var errorMessage = this.getErrorMessage(crash);
+        var error = new Error(errorMessage);
+        // Build context from crash data (matching Flutter pattern)
+        var context = {
+            mechanism: const_1.ErrorMechanism.CRASH,
+        };
+        if (crash.trace) {
+            context['trace'] = crash.trace;
+        }
+        if (crash.signal) {
+            context['signal'] = crash.signal;
+        }
+        if (crash.timestamp) {
+            context['timestamp'] = String(crash.timestamp);
+        }
+        if (crash.description) {
+            context['description'] = crash.description;
+        }
+        if (crash.processName) {
+            context['processName'] = crash.processName;
+        }
+        if (crash.pid) {
+            context['pid'] = String(crash.pid);
+        }
+        if (crash.importance !== undefined) {
+            context['importance'] = String(crash.importance);
+        }
+        // Push as error via Faro API (matching Flutter pattern)
+        this.api.pushError(error, {
+            type: 'crash',
+            context: context,
+        });
+        this.logDebug("Reported crash: ".concat(crash.reason, " at ").concat(crash.timestamp));
+    };
+    /**
+     * Build error message matching Flutter SDK format:
+     * "{reason}: {description}, status: {status}"
+     */
+    CrashReportingInstrumentation.prototype.getErrorMessage = function (crash) {
+        var _a;
+        var reason = crash.reason || 'UNKNOWN';
+        var status = (_a = crash.status) !== null && _a !== void 0 ? _a : 0;
+        var description;
+        switch (crash.reason) {
+            case 'ANR':
+                description = 'Application Not Responding';
+                break;
+            case 'CRASH':
+                description = 'Application crash (Java/Kotlin)';
+                break;
+            case 'CRASH_NATIVE':
+                description = 'Application crash (Native)';
+                break;
+            case 'LOW_MEMORY':
+                description = 'Application terminated due to low memory';
+                break;
+            case 'EXCESSIVE_RESOURCE_USAGE':
+                description = 'Application terminated due to excessive resource usage';
+                break;
+            case 'INITIALIZATION_FAILURE':
+                description = 'Application failed to initialize';
+                break;
+            default:
+                description = crash.description || 'Application crash';
+                break;
+        }
+        return "".concat(reason, ": ").concat(description, ", status: ").concat(status);
+    };
+    return CrashReportingInstrumentation;
+}(faro_core_1.BaseInstrumentation));
+exports.CrashReportingInstrumentation = CrashReportingInstrumentation;
+//# sourceMappingURL=instrumentation.js.map

package/dist/cjs/instrumentations/crashReporting/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/instrumentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeModules } from 'react-native';\n\nimport { BaseInstrumentation, VERSION } from '@grafana/faro-core';\n\nimport { ErrorMechanism } from '../errors/const';\n\nimport type { CrashReport, CrashReportingOptions } from './types';\n\n/**\n * Crash Reporting Instrumentation (Experimental).\n *\n * Retrieves crash reports from previous app sessions and sends them via Faro API.\n *\n * **Platform Support**:\n * - **Android**: Uses ApplicationExitInfo API (Android 11+ / API 30+)\n *   Captures: CRASH, CRASH_NATIVE, ANR, LOW_MEMORY, EXCESSIVE_RESOURCE_USAGE\n * - **iOS**: Uses PLCrashReporter (requires adding dependency to podspec)\n *   Captures: Signal crashes (SIGSEGV, SIGABRT, etc.) and Mach exceptions\n *\n * **Note**: This instrumentation only retrieves crash data from previous sessions.\n * The crash itself terminates the app, so the report is sent on next app launch.\n *\n * @example\n * ```typescript\n * import { initializeFaro, CrashReportingInstrumentation } from '@grafana/faro-react-native';\n *\n * initializeFaro({\n *   url: 'https://collector.example.com',\n *   instrumentations: [\n *     new CrashReportingInstrumentation(),\n *   ],\n * });\n * ```\n */\nexport class CrashReportingInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-crash';\n  readonly version = VERSION;\n\n  private readonly options: Required<CrashReportingOptions>;\n\n  constructor(options: CrashReportingOptions = {}) {\n    super();\n    this.options = {\n      enabled: options.enabled ?? true,\n    };\n  }\n\n  async initialize(): Promise<void> {\n    if (!this.options.enabled) {\n      this.logDebug('Crash reporting is disabled');\n      return;\n    }\n\n    const nativeModule = this.getNativeModule();\n    if (!nativeModule) {\n      this.logWarn('Native module not available for crash reporting');\n      return;\n    }\n\n    this.logDebug('Initializing crash reporting instrumentation');\n\n    // Wait for session attributes to be populated before sending crash reports\n    // This ensures crash reports include full session metadata\n    await this.waitForSessionAttributes();\n\n    // Get crash reports from previous session\n    await this.processCrashReports(nativeModule);\n  }\n\n  /**\n   * Wait for session attributes to be populated.\n   *\n   * Crash reports are sent in a new session, so we need to wait for\n   * SessionInstrumentation to finish collecting device info, OS version, etc.\n   * before sending the crash report. Otherwise, the crash report will be missing\n   * session metadata.\n   *\n   * This checks for multiple device-specific attributes that are collected\n   * asynchronously (device_id, device_os_detail, device_model_name) to ensure\n   * the async getSessionAttributes() call has completed.\n   *\n   * @param maxWaitMs Maximum time to wait in milliseconds (default 10000ms)\n   */\n  private async waitForSessionAttributes(maxWaitMs = 10000): Promise<void> {\n    const startTime = Date.now();\n    const pollInterval = 200; // Check every 200ms\n    let checkCount = 0;\n\n    while (Date.now() - startTime < maxWaitMs) {\n      checkCount++;\n      try {\n        // Check if session attributes are populated\n        const sessionAttrs = this.metas?.value?.session?.attributes;\n\n        if (sessionAttrs) {\n          const attrCount = Object.keys(sessionAttrs).length;\n          const attrKeys = JSON.stringify(Object.keys(sessionAttrs));\n\n          // Look for multiple device-specific attributes that indicate full async collection is done.\n          // getSessionAttributes() collects these asynchronously:\n          // - device_id (async getDeviceId)\n          // - device_os_detail (async getDeviceOsDetail)\n          // - device_model_name (DeviceInfo.getDeviceNameSync)\n          // All three should be present when collection is complete.\n          const hasDeviceId = 'device_id' in sessionAttrs && sessionAttrs['device_id'] !== 'unknown';\n          const hasDeviceOsDetail =\n            'device_os_detail' in sessionAttrs && sessionAttrs['device_os_detail'] !== 'unknown';\n          const hasDeviceModelName = 'device_model_name' in sessionAttrs;\n\n          if (hasDeviceId && hasDeviceOsDetail && hasDeviceModelName) {\n            const elapsed = Date.now() - startTime;\n            this.logDebug(`Session attributes ready after ${elapsed}ms (${checkCount} checks, ${attrCount} attrs)`);\n            return;\n          } else {\n            this.logDebug(\n              `Check #${checkCount}: Found ${attrCount} session attributes: ${attrKeys} but still missing required attrs - device_id:${hasDeviceId}, device_os_detail:${hasDeviceOsDetail}, device_model_name:${hasDeviceModelName}`\n            );\n          }\n        } else {\n          this.logDebug(`Check #${checkCount}: No session attributes available yet`);\n        }\n      } catch (error) {\n        // Continue waiting if we can't access metas yet\n        this.logDebug(`Check #${checkCount}: Error accessing metas: ${error}`);\n      }\n\n      // Wait before next check\n      await new Promise((resolve) => setTimeout(resolve, pollInterval));\n    }\n\n    // Timeout reached - log warning but continue\n    const finalAttrs = this.metas?.value?.session?.attributes;\n    const finalAttrCount = finalAttrs ? Object.keys(finalAttrs).length : 0;\n    const finalAttrKeys = finalAttrs ? JSON.stringify(Object.keys(finalAttrs)) : 'none';\n    this.logWarn(\n      `Session attributes not ready after ${maxWaitMs}ms timeout (${checkCount} checks, ${finalAttrCount} attrs: ${finalAttrKeys}). Sending crash report anyway.`\n    );\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 async processCrashReports(nativeModule: typeof NativeModules.FaroReactNativeModule): Promise<void> {\n    try {\n      if (typeof nativeModule.getCrashReport !== 'function') {\n        this.logDebug('getCrashReport method not available');\n        return;\n      }\n\n      this.logDebug('Attempting to retrieve crash reports from native module');\n      const crashReports = (await nativeModule.getCrashReport()) as string[] | null;\n\n      if (!crashReports || crashReports.length === 0) {\n        this.logDebug('No crash reports from previous session');\n        return;\n      }\n\n      this.logDebug(`Processing ${crashReports.length} crash report(s) from previous session`);\n\n      for (const crashJson of crashReports) {\n        try {\n          this.logDebug(`Parsing crash report JSON: ${crashJson.substring(0, 200)}...`);\n          const crash = JSON.parse(crashJson) as CrashReport;\n          this.sendCrashReport(crash);\n        } catch (parseError) {\n          // If parsing fails, still try to report something\n          this.logError('Failed to parse crash report JSON', parseError);\n          this.api.pushError(new Error('Application crash (parse error)'), {\n            context: {\n              mechanism: ErrorMechanism.CRASH,\n              parseError: String(parseError),\n              raw: crashJson.substring(0, 500), // Limit size\n            },\n            type: 'crash',\n          });\n        }\n      }\n    } catch (error) {\n      this.logError('Failed to process crash reports', error);\n    }\n  }\n\n  private sendCrashReport(crash: CrashReport): void {\n    const errorMessage = this.getErrorMessage(crash);\n    const error = new Error(errorMessage);\n\n    // Build context from crash data (matching Flutter pattern)\n    const context: Record<string, string> = {\n      mechanism: ErrorMechanism.CRASH,\n    };\n\n    if (crash.trace) {\n      context['trace'] = crash.trace;\n    }\n    if (crash.signal) {\n      context['signal'] = crash.signal;\n    }\n    if (crash.timestamp) {\n      context['timestamp'] = String(crash.timestamp);\n    }\n    if (crash.description) {\n      context['description'] = crash.description;\n    }\n    if (crash.processName) {\n      context['processName'] = crash.processName;\n    }\n    if (crash.pid) {\n      context['pid'] = String(crash.pid);\n    }\n    if (crash.importance !== undefined) {\n      context['importance'] = String(crash.importance);\n    }\n\n    // Push as error via Faro API (matching Flutter pattern)\n    this.api.pushError(error, {\n      type: 'crash',\n      context,\n    });\n\n    this.logDebug(`Reported crash: ${crash.reason} at ${crash.timestamp}`);\n  }\n\n  /**\n   * Build error message matching Flutter SDK format:\n   * \"{reason}: {description}, status: {status}\"\n   */\n  private getErrorMessage(crash: CrashReport): string {\n    const reason = crash.reason || 'UNKNOWN';\n    const status = crash.status ?? 0;\n\n    let description: string;\n    switch (crash.reason) {\n      case 'ANR':\n        description = 'Application Not Responding';\n        break;\n      case 'CRASH':\n        description = 'Application crash (Java/Kotlin)';\n        break;\n      case 'CRASH_NATIVE':\n        description = 'Application crash (Native)';\n        break;\n      case 'LOW_MEMORY':\n        description = 'Application terminated due to low memory';\n        break;\n      case 'EXCESSIVE_RESOURCE_USAGE':\n        description = 'Application terminated due to excessive resource usage';\n        break;\n      case 'INITIALIZATION_FAILURE':\n        description = 'Application failed to initialize';\n        break;\n      default:\n        description = crash.description || 'Application crash';\n        break;\n    }\n\n    return `${reason}: ${description}, status: ${status}`;\n  }\n}\n"]}

package/dist/cjs/instrumentations/crashReporting/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/instrumentations/crashReporting/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configuration options for Crash Reporting instrumentation.\n *\n * **Platform Support**:\n * - **Android**: Uses ApplicationExitInfo API (Android 11+ / API 30+)\n *   Captures: CRASH, CRASH_NATIVE, ANR, LOW_MEMORY, EXCESSIVE_RESOURCE_USAGE\n * - **iOS**: Uses PLCrashReporter (automatically included via podspec)\n *   Captures: Signal crashes (SIGSEGV, SIGABRT, etc.) and Mach exceptions\n */\nexport interface CrashReportingOptions {\n  /**\n   * Whether to enable crash reporting.\n   * Default: true\n   */\n  enabled?: boolean;\n}\n\n/**\n * Crash report data from native module.\n *\n * Field names match Faro Flutter SDK for consistency across mobile platforms.\n * Both Android (ApplicationExitInfo) and iOS (PLCrashReporter) produce JSON\n * matching this interface.\n */\nexport interface CrashReport {\n  /**\n   * Reason for the crash (e.g., \"CRASH\", \"CRASH_NATIVE\", \"ANR\", \"LOW_MEMORY\")\n   */\n  reason: string;\n\n  /**\n   * Timestamp when the crash occurred (milliseconds since epoch)\n   */\n  timestamp: number;\n\n  /**\n   * Exit status code\n   */\n  status?: number;\n\n  /**\n   * Description of the crash\n   */\n  description?: string;\n\n  /**\n   * Process importance level\n   */\n  importance?: number;\n\n  /**\n   * Process ID\n   */\n  pid?: number;\n\n  /**\n   * Process name\n   */\n  processName?: string;\n\n  /**\n   * Stack trace (if available)\n   */\n  trace?: string;\n\n  /**\n   * Signal name (for iOS crashes)\n   */\n  signal?: string;\n}\n"]}

package/dist/cjs/instrumentations/errors/const.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.primitiveUnhandledType = exports.ErrorMechanism = void 0;
+/**
+ * Error mechanism values (source of the error).
+ * Aligns with Web SDK and market conventions (Datadog error.source, Sentry mechanism.type).
+ */
+exports.ErrorMechanism = {
+    UNCAUGHT: 'uncaught',
+    UNHANDLED_REJECTION: 'unhandledrejection',
+    CONSOLE: 'console',
+    /** Used by CrashReportingInstrumentation */
+    CRASH: 'crash',
+    /** Used by ANRInstrumentation */
+    ANR: 'anr',
+};
+/** Type for non-Error promise rejections (primitives, plain objects). Matches Web SDK. */
+exports.primitiveUnhandledType = 'UnhandledRejection';
+//# sourceMappingURL=const.js.map

package/dist/cjs/instrumentations/errors/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../../../src/instrumentations/errors/const.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,cAAc,GAAG;IAC5B,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,oBAAoB;IACzC,OAAO,EAAE,SAAS;IAClB,4CAA4C;IAC5C,KAAK,EAAE,OAAO;IACd,iCAAiC;IACjC,GAAG,EAAE,KAAK;CACF,CAAC;AAIX,0FAA0F;AAC7E,QAAA,sBAAsB,GAAG,oBAAoB,CAAC","sourcesContent":["/**\n * Error mechanism values (source of the error).\n * Aligns with Web SDK and market conventions (Datadog error.source, Sentry mechanism.type).\n */\nexport const ErrorMechanism = {\n  UNCAUGHT: 'uncaught',\n  UNHANDLED_REJECTION: 'unhandledrejection',\n  CONSOLE: 'console',\n  /** Used by CrashReportingInstrumentation */\n  CRASH: 'crash',\n  /** Used by ANRInstrumentation */\n  ANR: 'anr',\n} as const;\n\nexport type ErrorMechanismType = (typeof ErrorMechanism)[keyof typeof ErrorMechanism];\n\n/** Type for non-Error promise rejections (primitives, plain objects). Matches Web SDK. */\nexport const primitiveUnhandledType = 'UnhandledRejection';\n"]}

package/dist/cjs/instrumentations/errors/index.js

@@ -0,0 +1,231 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorsInstrumentation = exports.ErrorMechanism = void 0;
+var faro_core_1 = require("@grafana/faro-core");
+var const_1 = require("./const");
+var const_2 = require("./const");
+Object.defineProperty(exports, "ErrorMechanism", { enumerable: true, get: function () { return const_2.ErrorMechanism; } });
+var stackTraceParser_1 = require("./stackTraceParser");
+/**
+ * Errors instrumentation for React Native
+ *
+ * Features:
+ * - Captures unhandled errors and promise rejections using ErrorUtils
+ * - Parses React Native stack traces (dev, release, Metro bundler formats)
+ * - Adds platform context (OS, version, Hermes engine)
+ * - Error deduplication to prevent duplicate reports
+ * - Configurable error filtering
+ *
+ * @example
+ * ```tsx
+ * import { initializeFaro } from '@grafana/faro-react-native';
+ * import { ErrorsInstrumentation } from '@grafana/faro-react-native';
+ *
+ * initializeFaro({
+ *   // ...config
+ *   instrumentations: [
+ *     new ErrorsInstrumentation({
+ *       ignoreErrors: [/network timeout/i, /cancelled/i],
+ *       enableDeduplication: true,
+ *       deduplicationWindow: 5000,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+var ErrorsInstrumentation = /** @class */ (function (_super) {
+    __extends(ErrorsInstrumentation, _super);
+    function ErrorsInstrumentation(options) {
+        if (options === void 0) { options = {}; }
+        var _a, _b, _c, _d;
+        var _this = _super.call(this) || this;
+        _this.name = '@grafana/faro-react-native-errors';
+        _this.version = '1.0.0';
+        _this.errorFingerprints = [];
+        _this.options = {
+            ignoreErrors: (_a = options.ignoreErrors) !== null && _a !== void 0 ? _a : [],
+            enableDeduplication: (_b = options.enableDeduplication) !== null && _b !== void 0 ? _b : true,
+            deduplicationWindow: (_c = options.deduplicationWindow) !== null && _c !== void 0 ? _c : 5000,
+            maxDeduplicationEntries: (_d = options.maxDeduplicationEntries) !== null && _d !== void 0 ? _d : 50,
+        };
+        return _this;
+    }
+    ErrorsInstrumentation.prototype.initialize = function () {
+        this.logInfo('Initializing errors instrumentation');
+        // Capture unhandled JavaScript errors
+        this.setupGlobalErrorHandler();
+        // Capture unhandled promise rejections
+        this.setupUnhandledRejectionHandler();
+    };
+    ErrorsInstrumentation.prototype.setupGlobalErrorHandler = function () {
+        var _this = this;
+        // Store the original error handler
+        this.originalErrorHandler = global.ErrorUtils.getGlobalHandler();
+        // Set our custom handler
+        global.ErrorUtils.setGlobalHandler(function (error, isFatal) {
+            try {
+                // Check if error should be ignored
+                if (_this.shouldIgnoreError(error)) {
+                    _this.logDebug('Ignoring error based on ignoreErrors patterns', { message: error.message });
+                    return;
+                }
+                // Check for duplicate errors
+                if (_this.options.enableDeduplication && _this.isDuplicateError(error)) {
+                    _this.logDebug('Ignoring duplicate error', { message: error.message });
+                    return;
+                }
+                // Enhance error with React Native context and stack frames
+                var _a = (0, stackTraceParser_1.enhanceErrorWithContext)(error, {
+                    mechanism: const_1.ErrorMechanism.UNCAUGHT,
+                    isFatal: String(isFatal !== null && isFatal !== void 0 ? isFatal : false),
+                }), enhancedError = _a.error, stackFrames = _a.stackFrames, context = _a.context;
+                // Push error to Faro with enhanced data (type from error.name, matches Web SDK)
+                _this.api.pushError(enhancedError, {
+                    type: enhancedError.name || 'Error',
+                    context: context,
+                    stackFrames: stackFrames,
+                });
+                // Track error fingerprint for deduplication
+                if (_this.options.enableDeduplication) {
+                    _this.addErrorFingerprint(error);
+                }
+            }
+            catch (e) {
+                // Don't let error reporting cause more errors
+                _this.logError('Failed to report error to Faro', e);
+            }
+            finally {
+                // Always call the original handler to maintain normal error behavior
+                if (_this.originalErrorHandler) {
+                    _this.originalErrorHandler(error, isFatal);
+                }
+            }
+        });
+    };
+    ErrorsInstrumentation.prototype.setupUnhandledRejectionHandler = function () {
+        var _this = this;
+        var _a;
+        // React Native supports the standard unhandledrejection event
+        this.unhandledRejectionListener = function (event) {
+            try {
+                var reason = event.reason;
+                // Convert reason to an Error if it isn't one (matches Web SDK approach)
+                var isPrimitiveRejection = !(reason instanceof Error);
+                var error = void 0;
+                if (reason instanceof Error) {
+                    error = reason;
+                }
+                else {
+                    error = new Error("Unhandled Promise Rejection: ".concat(typeof reason === 'object' ? JSON.stringify(reason) : String(reason)));
+                }
+                // Check if error should be ignored
+                if (_this.shouldIgnoreError(error)) {
+                    _this.logDebug('Ignoring unhandled rejection based on ignoreErrors patterns', { message: error.message });
+                    return;
+                }
+                // Check for duplicate errors
+                if (_this.options.enableDeduplication && _this.isDuplicateError(error)) {
+                    _this.logDebug('Ignoring duplicate unhandled rejection', { message: error.message });
+                    return;
+                }
+                // Enhance error with React Native context and stack frames
+                var _a = (0, stackTraceParser_1.enhanceErrorWithContext)(error, {
+                    mechanism: const_1.ErrorMechanism.UNHANDLED_REJECTION,
+                }), enhancedError = _a.error, stackFrames = _a.stackFrames, context = _a.context;
+                // Type: use actual error type for Error objects; 'UnhandledRejection' for primitives (Web SDK)
+                var errorType = isPrimitiveRejection ? const_1.primitiveUnhandledType : enhancedError.name || 'Error';
+                _this.api.pushError(enhancedError, {
+                    type: errorType,
+                    context: context,
+                    stackFrames: stackFrames,
+                });
+                // Track error fingerprint for deduplication
+                if (_this.options.enableDeduplication) {
+                    _this.addErrorFingerprint(error);
+                }
+            }
+            catch (e) {
+                _this.logError('Failed to report unhandled rejection to Faro', e);
+            }
+        };
+        // Add the listener
+        (_a = global.addEventListener) === null || _a === void 0 ? void 0 : _a.call(global, 'unhandledrejection', this.unhandledRejectionListener);
+    };
+    /**
+     * Check if error should be ignored based on ignoreErrors patterns
+     */
+    ErrorsInstrumentation.prototype.shouldIgnoreError = function (error) {
+        if (!error || !error.message) {
+            return false;
+        }
+        return this.options.ignoreErrors.some(function (pattern) { return pattern.test(error.message); });
+    };
+    /**
+     * Check if error is a duplicate based on message and stack
+     */
+    ErrorsInstrumentation.prototype.isDuplicateError = function (error) {
+        var _this = this;
+        var message = error.message || '';
+        var stack = error.stack || '';
+        var now = Date.now();
+        // Clean up old entries first
+        this.cleanupOldFingerprints(now);
+        // Check if we've seen this error recently
+        return this.errorFingerprints.some(function (fingerprint) {
+            return (fingerprint.message === message &&
+                fingerprint.stack === stack &&
+                now - fingerprint.timestamp < _this.options.deduplicationWindow);
+        });
+    };
+    /**
+     * Add error fingerprint for deduplication tracking
+     */
+    ErrorsInstrumentation.prototype.addErrorFingerprint = function (error) {
+        var message = error.message || '';
+        var stack = error.stack || '';
+        var timestamp = Date.now();
+        this.errorFingerprints.push({ message: message, stack: stack, timestamp: timestamp });
+        // Limit the number of tracked fingerprints
+        if (this.errorFingerprints.length > this.options.maxDeduplicationEntries) {
+            this.errorFingerprints.shift();
+        }
+    };
+    /**
+     * Remove error fingerprints older than the deduplication window
+     */
+    ErrorsInstrumentation.prototype.cleanupOldFingerprints = function (now) {
+        var _this = this;
+        this.errorFingerprints = this.errorFingerprints.filter(function (fingerprint) { return now - fingerprint.timestamp < _this.options.deduplicationWindow; });
+    };
+    ErrorsInstrumentation.prototype.unpatch = function () {
+        var _a;
+        // Restore original error handler
+        if (this.originalErrorHandler) {
+            global.ErrorUtils.setGlobalHandler(this.originalErrorHandler);
+        }
+        // Remove unhandled rejection listener
+        if (this.unhandledRejectionListener) {
+            (_a = global.removeEventListener) === null || _a === void 0 ? void 0 : _a.call(global, 'unhandledrejection', this.unhandledRejectionListener);
+        }
+        // Clear deduplication tracking
+        this.errorFingerprints = [];
+    };
+    return ErrorsInstrumentation;
+}(faro_core_1.BaseInstrumentation));
+exports.ErrorsInstrumentation = ErrorsInstrumentation;
+//# sourceMappingURL=index.js.map