@grafana/faro-react-native 1.2.0 → 1.3.0

package/dist/cjs/instrumentations/crashReporting/android/crashErrorMessage.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCrashErrorMessage = resolveCrashErrorMessage;
+exports.isAnrTimeoutDescription = isAnrTimeoutDescription;
+exports.shouldSkipCrashReport = shouldSkipCrashReport;
+exports.shouldSkipLowSignalCrashReport = shouldSkipLowSignalCrashReport;
+exports.buildFallbackCrashMessage = buildFallbackCrashMessage;
+var parseAndroidCrashTrace_1 = require("./parseAndroidCrashTrace");
+/**
+ * Human-readable exception value for ApplicationExitInfo crash reports.
+ * Priority: parsed trace message → exception class → description → generic fallback.
+ */
+function resolveCrashErrorMessage(crash, parsedTrace) {
+    var _a, _b, _c;
+    var fromTrace = (_a = parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.exceptionMessage) === null || _a === void 0 ? void 0 : _a.trim();
+    if (fromTrace) {
+        return fromTrace;
+    }
+    var fromType = (_b = parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.exceptionType) === null || _b === void 0 ? void 0 : _b.trim();
+    if (fromType && (0, parseAndroidCrashTrace_1.isPlausibleJavaExceptionIdentifier)(fromType)) {
+        return fromType;
+    }
+    var fromDescriptionType = exceptionTypeFromDescription(crash.description);
+    if (fromDescriptionType) {
+        return fromDescriptionType;
+    }
+    var fromDescription = (_c = crash.description) === null || _c === void 0 ? void 0 : _c.trim();
+    if (fromDescription && !isGenericCrashDescription(fromDescription)) {
+        return fromDescription;
+    }
+    var fallback = buildFallbackCrashMessage(crash);
+    return fallback.trim() || crash.reason || 'Application crash';
+}
+var ANR_TIMEOUT_DESCRIPTION_PATTERN = /input dispatching timed out|not responding|application not responding/i;
+/**
+ * Android ANR watchdog descriptions from ApplicationExitInfo (any app).
+ */
+function isAnrTimeoutDescription(description) {
+    var trimmed = description === null || description === void 0 ? void 0 : description.trim();
+    if (!trimmed) {
+        return false;
+    }
+    return ANR_TIMEOUT_DESCRIPTION_PATTERN.test(trimmed);
+}
+/**
+ * Skip duplicate ApplicationExitInfo rows that have no stack and no useful title,
+ * and ANR incidents mis-tagged as previous-session crashes.
+ */
+function shouldSkipCrashReport(crash) {
+    if (isAnrTimeoutDescription(crash.description)) {
+        return true;
+    }
+    return shouldSkipLowSignalCrashReport(crash);
+}
+/**
+ * Skip duplicate ApplicationExitInfo rows that have no stack and no useful title.
+ * These surface in the plugin as a second generic `crash` row for a single button press.
+ */
+function shouldSkipLowSignalCrashReport(crash) {
+    var _a, _b;
+    if ((_a = crash.trace) === null || _a === void 0 ? void 0 : _a.trim()) {
+        return false;
+    }
+    var description = (_b = crash.description) === null || _b === void 0 ? void 0 : _b.trim();
+    if (description && !isGenericCrashDescription(description)) {
+        return false;
+    }
+    return true;
+}
+/** Extract `java.lang.NullPointerException` from ApplicationExitInfo description text. */
+function exceptionTypeFromDescription(description) {
+    var _a;
+    var trimmed = description === null || description === void 0 ? void 0 : description.trim();
+    if (!trimmed || isGenericCrashDescription(trimmed)) {
+        return undefined;
+    }
+    var match = trimmed.match(/^([\w.$]+)(?::(.*))?$/);
+    var candidate = (_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (!candidate || !(0, parseAndroidCrashTrace_1.isPlausibleJavaExceptionIdentifier)(candidate)) {
+        return undefined;
+    }
+    return candidate;
+}
+function isGenericCrashDescription(description) {
+    var normalized = description.trim().toLowerCase();
+    return (normalized === 'crash' ||
+        normalized === 'native crash' ||
+        normalized === 'application crash' ||
+        normalized === 'application crash (java/kotlin)' ||
+        normalized === 'application crash (native)');
+}
+/** Generic fallback when the trace carries no parseable message or type. */
+function buildFallbackCrashMessage(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);
+}
+//# sourceMappingURL=crashErrorMessage.js.map

package/dist/cjs/instrumentations/crashReporting/android/crashErrorMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crashErrorMessage.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/android/crashErrorMessage.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CrashReport } from '../types';\n\nimport { isPlausibleJavaExceptionIdentifier } from './parseAndroidCrashTrace';\nimport type { ParsedAndroidCrashTrace } from './parseAndroidCrashTrace';\n\n/**\n * Human-readable exception value for ApplicationExitInfo crash reports.\n * Priority: parsed trace message → exception class → description → generic fallback.\n */\nexport function resolveCrashErrorMessage(crash: CrashReport, parsedTrace: ParsedAndroidCrashTrace | null): string {\n  const fromTrace = parsedTrace?.exceptionMessage?.trim();\n  if (fromTrace) {\n    return fromTrace;\n  }\n\n  const fromType = parsedTrace?.exceptionType?.trim();\n  if (fromType && isPlausibleJavaExceptionIdentifier(fromType)) {\n    return fromType;\n  }\n\n  const fromDescriptionType = exceptionTypeFromDescription(crash.description);\n  if (fromDescriptionType) {\n    return fromDescriptionType;\n  }\n\n  const fromDescription = crash.description?.trim();\n  if (fromDescription && !isGenericCrashDescription(fromDescription)) {\n    return fromDescription;\n  }\n\n  const fallback = buildFallbackCrashMessage(crash);\n  return fallback.trim() || crash.reason || 'Application crash';\n}\n\nconst ANR_TIMEOUT_DESCRIPTION_PATTERN = /input dispatching timed out|not responding|application not responding/i;\n\n/**\n * Android ANR watchdog descriptions from ApplicationExitInfo (any app).\n */\nexport function isAnrTimeoutDescription(description: string | undefined): boolean {\n  const trimmed = description?.trim();\n  if (!trimmed) {\n    return false;\n  }\n  return ANR_TIMEOUT_DESCRIPTION_PATTERN.test(trimmed);\n}\n\n/**\n * Skip duplicate ApplicationExitInfo rows that have no stack and no useful title,\n * and ANR incidents mis-tagged as previous-session crashes.\n */\nexport function shouldSkipCrashReport(crash: CrashReport): boolean {\n  if (isAnrTimeoutDescription(crash.description)) {\n    return true;\n  }\n\n  return shouldSkipLowSignalCrashReport(crash);\n}\n\n/**\n * Skip duplicate ApplicationExitInfo rows that have no stack and no useful title.\n * These surface in the plugin as a second generic `crash` row for a single button press.\n */\nexport function shouldSkipLowSignalCrashReport(crash: CrashReport): boolean {\n  if (crash.trace?.trim()) {\n    return false;\n  }\n\n  const description = crash.description?.trim();\n  if (description && !isGenericCrashDescription(description)) {\n    return false;\n  }\n\n  return true;\n}\n\n/** Extract `java.lang.NullPointerException` from ApplicationExitInfo description text. */\nfunction exceptionTypeFromDescription(description: string | undefined): string | undefined {\n  const trimmed = description?.trim();\n  if (!trimmed || isGenericCrashDescription(trimmed)) {\n    return undefined;\n  }\n\n  const match = trimmed.match(/^([\\w.$]+)(?::(.*))?$/);\n  const candidate = match?.[1]?.trim();\n  if (!candidate || !isPlausibleJavaExceptionIdentifier(candidate)) {\n    return undefined;\n  }\n\n  return candidate;\n}\n\nfunction isGenericCrashDescription(description: string): boolean {\n  const normalized = description.trim().toLowerCase();\n  return (\n    normalized === 'crash' ||\n    normalized === 'native crash' ||\n    normalized === 'application crash' ||\n    normalized === 'application crash (java/kotlin)' ||\n    normalized === 'application crash (native)'\n  );\n}\n\n/** Generic fallback when the trace carries no parseable message or type. */\nexport function buildFallbackCrashMessage(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"]}

package/dist/cjs/instrumentations/crashReporting/android/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldSkipCrashReport = exports.resolveCrashErrorMessage = exports.normalizeJavaStackTraceForRetrace = exports.parseAndroidCrashTrace = exports.AndroidCrashReportingInstrumentation = void 0;
+var AndroidCrashReportingInstrumentation_1 = require("./AndroidCrashReportingInstrumentation");
+Object.defineProperty(exports, "AndroidCrashReportingInstrumentation", { enumerable: true, get: function () { return AndroidCrashReportingInstrumentation_1.AndroidCrashReportingInstrumentation; } });
+var parseAndroidCrashTrace_1 = require("./parseAndroidCrashTrace");
+Object.defineProperty(exports, "parseAndroidCrashTrace", { enumerable: true, get: function () { return parseAndroidCrashTrace_1.parseAndroidCrashTrace; } });
+Object.defineProperty(exports, "normalizeJavaStackTraceForRetrace", { enumerable: true, get: function () { return parseAndroidCrashTrace_1.normalizeJavaStackTraceForRetrace; } });
+var crashErrorMessage_1 = require("./crashErrorMessage");
+Object.defineProperty(exports, "resolveCrashErrorMessage", { enumerable: true, get: function () { return crashErrorMessage_1.resolveCrashErrorMessage; } });
+Object.defineProperty(exports, "shouldSkipCrashReport", { enumerable: true, get: function () { return crashErrorMessage_1.shouldSkipCrashReport; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/instrumentations/crashReporting/android/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/android/index.ts"],"names":[],"mappings":";;;AAAA,+FAA8F;AAArF,4JAAA,oCAAoC,OAAA;AAC7C,mEAAqG;AAA5F,gIAAA,sBAAsB,OAAA;AAAE,2IAAA,iCAAiC,OAAA;AAElE,yDAAsF;AAA7E,6HAAA,wBAAwB,OAAA;AAAE,0HAAA,qBAAqB,OAAA","sourcesContent":["export { AndroidCrashReportingInstrumentation } from './AndroidCrashReportingInstrumentation';\nexport { parseAndroidCrashTrace, normalizeJavaStackTraceForRetrace } from './parseAndroidCrashTrace';\nexport type { ParsedAndroidCrashTrace, AndroidCrashStackFrame } from './parseAndroidCrashTrace';\nexport { resolveCrashErrorMessage, shouldSkipCrashReport } from './crashErrorMessage';\n"]}

package/dist/cjs/instrumentations/crashReporting/android/nativeTombstoneTrace.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.looksLikeNativeTombstoneTrace = looksLikeNativeTombstoneTrace;
+/** Detect Android tombstone backtrace lines used for NDK native retrace. */
+function looksLikeNativeTombstoneTrace(trace) {
+    if (!(trace === null || trace === void 0 ? void 0 : trace.trim())) {
+        return false;
+    }
+    return trace.split('\n').some(function (line) { return /^\s*#\d+\s+pc\s+(?:0x)?[0-9a-fA-F]+\s+\S+/i.test(line); });
+}
+//# sourceMappingURL=nativeTombstoneTrace.js.map

package/dist/cjs/instrumentations/crashReporting/android/nativeTombstoneTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeTombstoneTrace.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/android/nativeTombstoneTrace.ts"],"names":[],"mappings":";;AACA,sEAMC;AAPD,4EAA4E;AAC5E,SAAgB,6BAA6B,CAAC,KAAyB;IACrE,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,EAAE,CAAA,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAC,IAAI,IAAK,OAAA,4CAA4C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAvD,CAAuD,CAAC,CAAC;AACnG,CAAC","sourcesContent":["/** Detect Android tombstone backtrace lines used for NDK native retrace. */\nexport function looksLikeNativeTombstoneTrace(trace: string | undefined): boolean {\n  if (!trace?.trim()) {\n    return false;\n  }\n\n  return trace.split('\\n').some((line) => /^\\s*#\\d+\\s+pc\\s+(?:0x)?[0-9a-fA-F]+\\s+\\S+/i.test(line));\n}\n"]}

package/dist/cjs/instrumentations/crashReporting/android/parseAndroidCrashTrace.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTombstoneSectionLabel = isTombstoneSectionLabel;
+exports.isPlausibleJavaExceptionIdentifier = isPlausibleJavaExceptionIdentifier;
+exports.normalizeJavaStackTraceForRetrace = normalizeJavaStackTraceForRetrace;
+exports.normalizeCrashTraceExceptionMessage = normalizeCrashTraceExceptionMessage;
+exports.parseAndroidCrashTrace = parseAndroidCrashTrace;
+var stackTraceParser_1 = require("../../errors/stackTraceParser");
+// Mirrors pkg/exporter/androidretrace/mapping.go frameLine / exceptionHeader.
+var FRAME_LINE = /^\s*at\s+([\w$.]+)\.([\w$<>]+)\(([^):]*)(?::(\d+))?\)\s*$/;
+// Thread.getStackTrace() / legacy ANRTracker lines without the "at " prefix.
+var THREAD_STACK_FRAME_LINE = /^\s*([\w$.]+)\.([\w$<>]+)\(([^):]*)(?::(\d+))?\)\s*$/;
+var EXCEPTION_HEADER = /^\s*(?:Caused by:\s*)?([\w$.]+)(?::(.*))?$/;
+// Mirrors pkg/exporter/androidretrace/native_frame.go nativeFrameLine.
+var NATIVE_TOMBSTONE_FRAME_LINE = /^\s*#(\d+)\s+pc\s+(?:0x)?([0-9a-fA-F]+)\s+(\S+)(?:\s+\(([^)]+)\))?/i;
+var TOMBSTONE_SECTION_LABELS = new Set(['backtrace', 'stack', 'build id', 'memory map', 'memory near', 'abi']);
+/** Tombstone section headers and metadata must not become exception_type / nativeExceptionType. */
+function isTombstoneSectionLabel(value) {
+    return TOMBSTONE_SECTION_LABELS.has(value.trim().toLowerCase());
+}
+function isTombstoneMetadataLine(line) {
+    var trimmed = line.trim();
+    if (!trimmed) {
+        return true;
+    }
+    if (trimmed.startsWith('***')) {
+        return true;
+    }
+    if (/^ABI:/i.test(trimmed)) {
+        return true;
+    }
+    if (/^signal\s+/i.test(trimmed)) {
+        return true;
+    }
+    if (/^pid:/i.test(trimmed)) {
+        return true;
+    }
+    if (isTombstoneSectionLabel(trimmed.replace(/:$/, ''))) {
+        return true;
+    }
+    return false;
+}
+function nativeLibBasename(token) {
+    var bang = token.lastIndexOf('!');
+    if (bang >= 0) {
+        token = token.slice(bang + 1);
+    }
+    var slash = token.lastIndexOf('/');
+    return slash >= 0 ? token.slice(slash + 1) : token;
+}
+function parseNativeTombstoneFrameLine(line) {
+    var _a, _b;
+    var match = line.match(NATIVE_TOMBSTONE_FRAME_LINE);
+    if (!match) {
+        return null;
+    }
+    var library = (_a = match[3]) !== null && _a !== void 0 ? _a : '';
+    var suffix = (_b = match[4]) === null || _b === void 0 ? void 0 : _b.trim();
+    var fn = '<unknown>';
+    if (suffix) {
+        var fnMatch = suffix.match(/^([A-Za-z_][A-Za-z0-9_]*)(?:\+(\d+))?$/);
+        if ((fnMatch === null || fnMatch === void 0 ? void 0 : fnMatch[1]) && fnMatch[1] !== 'BuildId' && fnMatch[1] !== 'offset') {
+            fn = fnMatch[1];
+        }
+    }
+    return {
+        module: nativeLibBasename(library),
+        function: fn,
+        filename: nativeLibBasename(library),
+    };
+}
+/** Reject version tokens (e.g. "18.2213") and other non-class header lines. */
+function isPlausibleJavaExceptionIdentifier(value) {
+    var trimmed = value.trim();
+    if (!trimmed || !/[a-zA-Z]/.test(trimmed)) {
+        return false;
+    }
+    if (/^\d+(\.\d+)+$/.test(trimmed)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Normalize raw Java thread stacks (e.g. ANRTracker) to Log.getStackTraceString shape
+ * so collector R8 retrace (mapping.RetraceText) can rewrite frame lines.
+ */
+function normalizeJavaStackTraceForRetrace(trace) {
+    return trace
+        .split('\n')
+        .map(function (line) {
+        var trimmed = line.trim();
+        if (!trimmed) {
+            return line;
+        }
+        if (/^\s*at\s+/.test(line)) {
+            return line;
+        }
+        if (THREAD_STACK_FRAME_LINE.test(trimmed)) {
+            return "    at ".concat(trimmed);
+        }
+        return line;
+    })
+        .join('\n');
+}
+/**
+ * Normalize exception text from ApplicationExitInfo / Log.getStackTraceString headers.
+ *
+ * React Native fatal JS errors embed the JS message in a fixed header shape
+ * (`Error: <message>, stack:`) regardless of the wrapping Java exception class.
+ * Match on that shape instead of the exception type name.
+ */
+var RN_FATAL_JS_ERROR_HEADER = /^Error:\s*(.+?),\s*stack:\s*$/i;
+function normalizeCrashTraceExceptionMessage(rawMessage) {
+    var _a;
+    if (!(rawMessage === null || rawMessage === void 0 ? void 0 : rawMessage.trim())) {
+        return undefined;
+    }
+    var message = rawMessage.trim();
+    var rnFatalMatch = message.match(RN_FATAL_JS_ERROR_HEADER);
+    return ((_a = rnFatalMatch === null || rnFatalMatch === void 0 ? void 0 : rnFatalMatch[1]) !== null && _a !== void 0 ? _a : message).trim() || undefined;
+}
+function parseJsFrameLine(line, options) {
+    var _a;
+    var parsed = (0, stackTraceParser_1.parseStackTraceLine)(line);
+    if (!parsed) {
+        return null;
+    }
+    return (_a = (0, stackTraceParser_1.toFaroStackFrames)([parsed], options)[0]) !== null && _a !== void 0 ? _a : null;
+}
+/**
+ * Parse a raw Android crash trace into structured stack frames for pushError().
+ */
+function parseAndroidCrashTrace(trace, options) {
+    var trimmed = trace.trim();
+    if (!trimmed) {
+        return null;
+    }
+    var lines = trimmed.split('\n');
+    var jsFrames = [];
+    var frames = [];
+    var nativeFrames = [];
+    var exceptionType;
+    var exceptionMessage;
+    lines.forEach(function (line) {
+        var _a;
+        var nativeFrame = parseNativeTombstoneFrameLine(line);
+        if (nativeFrame) {
+            nativeFrames.push(nativeFrame);
+            return;
+        }
+        var frameMatch = (_a = line.match(FRAME_LINE)) !== null && _a !== void 0 ? _a : line.trim().match(THREAD_STACK_FRAME_LINE);
+        if (frameMatch) {
+            var module_1 = frameMatch[1], method = frameMatch[2], filename = frameMatch[3], lineNo = frameMatch[4];
+            frames.push({
+                module: module_1 !== null && module_1 !== void 0 ? module_1 : '',
+                function: method !== null && method !== void 0 ? method : '<unknown>',
+                filename: (filename === null || filename === void 0 ? void 0 : filename.trim()) || 'SourceFile',
+                lineno: lineNo ? parseInt(lineNo, 10) : undefined,
+            });
+            return;
+        }
+        var jsFrame = parseJsFrameLine(line, options);
+        if (jsFrame) {
+            jsFrames.push(jsFrame);
+            return;
+        }
+        var headerMatch = line.match(EXCEPTION_HEADER);
+        if (!isTombstoneMetadataLine(line) &&
+            (headerMatch === null || headerMatch === void 0 ? void 0 : headerMatch[1]) &&
+            isPlausibleJavaExceptionIdentifier(headerMatch[1]) &&
+            !isTombstoneSectionLabel(headerMatch[1])) {
+            exceptionType = headerMatch[1];
+            exceptionMessage = normalizeCrashTraceExceptionMessage(headerMatch[2]);
+        }
+    });
+    if (frames.length === 0 && jsFrames.length === 0 && nativeFrames.length === 0 && !exceptionType) {
+        return null;
+    }
+    return { exceptionType: exceptionType, exceptionMessage: exceptionMessage, jsFrames: jsFrames, frames: frames, nativeFrames: nativeFrames };
+}
+//# sourceMappingURL=parseAndroidCrashTrace.js.map

package/dist/cjs/instrumentations/crashReporting/android/parseAndroidCrashTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAndroidCrashTrace.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/android/parseAndroidCrashTrace.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExceptionStackFrame } from '@grafana/faro-core';\n\nimport { parseStackTraceLine, toFaroStackFrames } from '../../errors/stackTraceParser';\n\n/**\n * Android ApplicationExitInfo traces use Java/Kotlin stack-trace formatting.\n * Faro ingest expects structured frames with `module` (obfuscated class) so the\n * collector can R8-retrace them — not the JS call stack from sendCrashReport().\n *\n * Fatal RN JS errors also embed a short Hermes/Metro stack before native frames\n * (e.g. `anonymous@1:1390953`). Those lines are parsed as JS frames (no `module`)\n * so the collector can source-map them to files like DebugScreen.tsx.\n */\nexport interface AndroidCrashStackFrame extends ExceptionStackFrame {\n  module: string;\n}\n\nexport interface ParseAndroidCrashTraceOptions {\n  releaseBundleFilename?: string;\n}\n\nexport interface NativeTombstoneStackFrame extends ExceptionStackFrame {\n  /** Unstripped .so basename (e.g. libappmodules.so) for NDK retrace on the collector. */\n  module: string;\n}\n\nexport interface ParsedAndroidCrashTrace {\n  exceptionType?: string;\n  /** Human-readable message from the trace header (e.g. the JS error text). */\n  exceptionMessage?: string;\n  /** JS/Hermes frames from the embedded RN stack (source-map targets). */\n  jsFrames: ExceptionStackFrame[];\n  /** Native Java/Kotlin frames (Android R8 retrace targets). */\n  frames: AndroidCrashStackFrame[];\n  /** NDK tombstone #NN pc lines (server-side .so retrace targets). */\n  nativeFrames: NativeTombstoneStackFrame[];\n}\n\n// Mirrors pkg/exporter/androidretrace/mapping.go frameLine / exceptionHeader.\nconst FRAME_LINE = /^\\s*at\\s+([\\w$.]+)\\.([\\w$<>]+)\\(([^):]*)(?::(\\d+))?\\)\\s*$/;\n// Thread.getStackTrace() / legacy ANRTracker lines without the \"at \" prefix.\nconst THREAD_STACK_FRAME_LINE = /^\\s*([\\w$.]+)\\.([\\w$<>]+)\\(([^):]*)(?::(\\d+))?\\)\\s*$/;\nconst EXCEPTION_HEADER = /^\\s*(?:Caused by:\\s*)?([\\w$.]+)(?::(.*))?$/;\n// Mirrors pkg/exporter/androidretrace/native_frame.go nativeFrameLine.\nconst NATIVE_TOMBSTONE_FRAME_LINE = /^\\s*#(\\d+)\\s+pc\\s+(?:0x)?([0-9a-fA-F]+)\\s+(\\S+)(?:\\s+\\(([^)]+)\\))?/i;\n\nconst TOMBSTONE_SECTION_LABELS = new Set(['backtrace', 'stack', 'build id', 'memory map', 'memory near', 'abi']);\n\n/** Tombstone section headers and metadata must not become exception_type / nativeExceptionType. */\nexport function isTombstoneSectionLabel(value: string): boolean {\n  return TOMBSTONE_SECTION_LABELS.has(value.trim().toLowerCase());\n}\n\nfunction isTombstoneMetadataLine(line: string): boolean {\n  const trimmed = line.trim();\n  if (!trimmed) {\n    return true;\n  }\n  if (trimmed.startsWith('***')) {\n    return true;\n  }\n  if (/^ABI:/i.test(trimmed)) {\n    return true;\n  }\n  if (/^signal\\s+/i.test(trimmed)) {\n    return true;\n  }\n  if (/^pid:/i.test(trimmed)) {\n    return true;\n  }\n  if (isTombstoneSectionLabel(trimmed.replace(/:$/, ''))) {\n    return true;\n  }\n  return false;\n}\n\nfunction nativeLibBasename(token: string): string {\n  const bang = token.lastIndexOf('!');\n  if (bang >= 0) {\n    token = token.slice(bang + 1);\n  }\n  const slash = token.lastIndexOf('/');\n  return slash >= 0 ? token.slice(slash + 1) : token;\n}\n\nfunction parseNativeTombstoneFrameLine(line: string): NativeTombstoneStackFrame | null {\n  const match = line.match(NATIVE_TOMBSTONE_FRAME_LINE);\n  if (!match) {\n    return null;\n  }\n\n  const library = match[3] ?? '';\n  const suffix = match[4]?.trim();\n  let fn = '<unknown>';\n  if (suffix) {\n    const fnMatch = suffix.match(/^([A-Za-z_][A-Za-z0-9_]*)(?:\\+(\\d+))?$/);\n    if (fnMatch?.[1] && fnMatch[1] !== 'BuildId' && fnMatch[1] !== 'offset') {\n      fn = fnMatch[1];\n    }\n  }\n\n  return {\n    module: nativeLibBasename(library),\n    function: fn,\n    filename: nativeLibBasename(library),\n  };\n}\n\n/** Reject version tokens (e.g. \"18.2213\") and other non-class header lines. */\nexport function isPlausibleJavaExceptionIdentifier(value: string): boolean {\n  const trimmed = value.trim();\n  if (!trimmed || !/[a-zA-Z]/.test(trimmed)) {\n    return false;\n  }\n  if (/^\\d+(\\.\\d+)+$/.test(trimmed)) {\n    return false;\n  }\n  return true;\n}\n\n/**\n * Normalize raw Java thread stacks (e.g. ANRTracker) to Log.getStackTraceString shape\n * so collector R8 retrace (mapping.RetraceText) can rewrite frame lines.\n */\nexport function normalizeJavaStackTraceForRetrace(trace: string): string {\n  return trace\n    .split('\\n')\n    .map((line) => {\n      const trimmed = line.trim();\n      if (!trimmed) {\n        return line;\n      }\n      if (/^\\s*at\\s+/.test(line)) {\n        return line;\n      }\n      if (THREAD_STACK_FRAME_LINE.test(trimmed)) {\n        return `    at ${trimmed}`;\n      }\n      return line;\n    })\n    .join('\\n');\n}\n\n/**\n * Normalize exception text from ApplicationExitInfo / Log.getStackTraceString headers.\n *\n * React Native fatal JS errors embed the JS message in a fixed header shape\n * (`Error: <message>, stack:`) regardless of the wrapping Java exception class.\n * Match on that shape instead of the exception type name.\n */\nconst RN_FATAL_JS_ERROR_HEADER = /^Error:\\s*(.+?),\\s*stack:\\s*$/i;\n\nexport function normalizeCrashTraceExceptionMessage(rawMessage: string | undefined): string | undefined {\n  if (!rawMessage?.trim()) {\n    return undefined;\n  }\n\n  const message = rawMessage.trim();\n  const rnFatalMatch = message.match(RN_FATAL_JS_ERROR_HEADER);\n\n  return (rnFatalMatch?.[1] ?? message).trim() || undefined;\n}\n\nfunction parseJsFrameLine(line: string, options?: ParseAndroidCrashTraceOptions): ExceptionStackFrame | null {\n  const parsed = parseStackTraceLine(line);\n  if (!parsed) {\n    return null;\n  }\n\n  return toFaroStackFrames([parsed], options)[0] ?? null;\n}\n\n/**\n * Parse a raw Android crash trace into structured stack frames for pushError().\n */\nexport function parseAndroidCrashTrace(\n  trace: string,\n  options?: ParseAndroidCrashTraceOptions\n): ParsedAndroidCrashTrace | null {\n  const trimmed = trace.trim();\n  if (!trimmed) {\n    return null;\n  }\n\n  const lines = trimmed.split('\\n');\n  const jsFrames: ExceptionStackFrame[] = [];\n  const frames: AndroidCrashStackFrame[] = [];\n  const nativeFrames: NativeTombstoneStackFrame[] = [];\n  let exceptionType: string | undefined;\n  let exceptionMessage: string | undefined;\n\n  lines.forEach((line) => {\n    const nativeFrame = parseNativeTombstoneFrameLine(line);\n    if (nativeFrame) {\n      nativeFrames.push(nativeFrame);\n      return;\n    }\n\n    const frameMatch = line.match(FRAME_LINE) ?? line.trim().match(THREAD_STACK_FRAME_LINE);\n\n    if (frameMatch) {\n      const [, module, method, filename, lineNo] = frameMatch;\n      frames.push({\n        module: module ?? '',\n        function: method ?? '<unknown>',\n        filename: filename?.trim() || 'SourceFile',\n        lineno: lineNo ? parseInt(lineNo, 10) : undefined,\n      });\n      return;\n    }\n\n    const jsFrame = parseJsFrameLine(line, options);\n    if (jsFrame) {\n      jsFrames.push(jsFrame);\n      return;\n    }\n\n    const headerMatch = line.match(EXCEPTION_HEADER);\n    if (\n      !isTombstoneMetadataLine(line) &&\n      headerMatch?.[1] &&\n      isPlausibleJavaExceptionIdentifier(headerMatch[1]) &&\n      !isTombstoneSectionLabel(headerMatch[1])\n    ) {\n      exceptionType = headerMatch[1];\n      exceptionMessage = normalizeCrashTraceExceptionMessage(headerMatch[2]);\n    }\n  });\n\n  if (frames.length === 0 && jsFrames.length === 0 && nativeFrames.length === 0 && !exceptionType) {\n    return null;\n  }\n\n  return { exceptionType, exceptionMessage, jsFrames, frames, nativeFrames };\n}\n"]}

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

@@ -1,6 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CrashReportingInstrumentation = void 0;
-var instrumentation_1 = require("./instrumentation");
-Object.defineProperty(exports, "CrashReportingInstrumentation", { enumerable: true, get: function () { return instrumentation_1.CrashReportingInstrumentation; } });
+var react_native_1 = require("react-native");
+var android_1 = require("./android");
+var ios_1 = require("./ios");
+var NoOpCrashReportingInstrumentation_1 = require("./NoOpCrashReportingInstrumentation");
+function resolveCrashReportingInstrumentation() {
+    if (react_native_1.Platform.OS === 'android') {
+        return android_1.AndroidCrashReportingInstrumentation;
+    }
+    if (react_native_1.Platform.OS === 'ios') {
+        // React Native reports both iPhone and iPadOS as "ios".
+        return ios_1.IosCrashReportingInstrumentation;
+    }
+    return NoOpCrashReportingInstrumentation_1.NoOpCrashReportingInstrumentation;
+}
+/**
+ * Platform-aware crash reporting instrumentation export.
+ *
+ * At module load time, determines the platform and exports the correct implementation:
+ * - Android: Uses ApplicationExitInfo API to retrieve crashes
+ * - iOS: Uses PLCrashReporter to retrieve crashes
+ * - Other: No-op stub (web, macOS, Windows, etc.)
+ *
+ * Usage:
+ * ```ts
+ * import { CrashReportingInstrumentation } from '@grafana/faro-react-native/instrumentation-crash';
+ *
+ * const faro = initializeFaro({
+ *   // ...
+ *   instrumentations: [
+ *     new CrashReportingInstrumentation(),
+ *   ],
+ * });
+ * ```
+ */
+exports.CrashReportingInstrumentation = resolveCrashReportingInstrumentation();
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/index.ts"],"names":[],"mappings":";;;AAAA,qDAAkE;AAAzD,gIAAA,6BAA6B,OAAA","sourcesContent":["export { CrashReportingInstrumentation } from './instrumentation';\nexport type { CrashReport, CrashReportingOptions } from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/index.ts"],"names":[],"mappings":";;;AAAA,6CAAwC;AAExC,qCAAiE;AACjE,6BAAyD;AACzD,yFAAwF;AAExF,SAAS,oCAAoC;IAC3C,IAAI,uBAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,8CAAoC,CAAC;IAC9C,CAAC;IAED,IAAI,uBAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,wDAAwD;QACxD,OAAO,sCAAgC,CAAC;IAC1C,CAAC;IAED,OAAO,qEAAiC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,6BAA6B,GAAG,oCAAoC,EAAE,CAAC","sourcesContent":["import { Platform } from 'react-native';\n\nimport { AndroidCrashReportingInstrumentation } from './android';\nimport { IosCrashReportingInstrumentation } from './ios';\nimport { NoOpCrashReportingInstrumentation } from './NoOpCrashReportingInstrumentation';\n\nfunction resolveCrashReportingInstrumentation() {\n  if (Platform.OS === 'android') {\n    return AndroidCrashReportingInstrumentation;\n  }\n\n  if (Platform.OS === 'ios') {\n    // React Native reports both iPhone and iPadOS as \"ios\".\n    return IosCrashReportingInstrumentation;\n  }\n\n  return NoOpCrashReportingInstrumentation;\n}\n\n/**\n * Platform-aware crash reporting instrumentation export.\n *\n * At module load time, determines the platform and exports the correct implementation:\n * - Android: Uses ApplicationExitInfo API to retrieve crashes\n * - iOS: Uses PLCrashReporter to retrieve crashes\n * - Other: No-op stub (web, macOS, Windows, etc.)\n *\n * Usage:\n * ```ts\n * import { CrashReportingInstrumentation } from '@grafana/faro-react-native/instrumentation-crash';\n *\n * const faro = initializeFaro({\n *   // ...\n *   instrumentations: [\n *     new CrashReportingInstrumentation(),\n *   ],\n * });\n * ```\n */\nexport const CrashReportingInstrumentation = resolveCrashReportingInstrumentation();\n\n// Export public API types\nexport type { CrashReportingOptions } from './types';\n"]}

package/dist/cjs/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.js

@@ -0,0 +1,78 @@
+"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.IosCrashReportingInstrumentation = void 0;
+var faro_core_1 = require("@grafana/faro-core");
+var BaseCrashReportingInstrumentation_1 = require("../BaseCrashReportingInstrumentation");
+var crashErrorMessage_1 = require("./crashErrorMessage");
+var parseIosCrashTrace_1 = require("./parseIosCrashTrace");
+/**
+ * iOS Crash Reporting Instrumentation.
+ *
+ * Uses PLCrashReporter to capture native crashes from previous sessions:
+ * - SIGSEGV: Segmentation fault / invalid memory access
+ * - SIGABRT: Abnormal termination (e.g., assertion failure, uncaught exception)
+ * - SIGBUS: Bus error / alignment/hardware error
+ * - SIGILL: Illegal instruction
+ * - SIGFPE: Floating point exception
+ * - SIGTRAP: Breakpoint/debugger trap
+ * - Mach exceptions (EXC_BAD_ACCESS, EXC_CRASH, etc.)
+ *
+ * Stack frames are symbolicated on the native side before being surfaced.
+ */
+var IosCrashReportingInstrumentation = /** @class */ (function (_super) {
+    __extends(IosCrashReportingInstrumentation, _super);
+    function IosCrashReportingInstrumentation() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.name = '@grafana/faro-react-native:instrumentation-crash-ios';
+        _this.version = faro_core_1.VERSION;
+        return _this;
+    }
+    IosCrashReportingInstrumentation.prototype.parseCrashTrace = function (trace) {
+        return (0, parseIosCrashTrace_1.parseIosCrashTrace)(trace);
+    };
+    IosCrashReportingInstrumentation.prototype.resolveCrashErrorMessage = function (crash, parsedTrace) {
+        return (0, crashErrorMessage_1.resolveCrashErrorMessage)(crash, parsedTrace);
+    };
+    IosCrashReportingInstrumentation.prototype.shouldSkipCrashReport = function (crash) {
+        return (0, crashErrorMessage_1.shouldSkipCrashReport)(crash);
+    };
+    IosCrashReportingInstrumentation.prototype.getStackFrames = function (parsedTrace) {
+        var _a;
+        return (_a = parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.frames) !== null && _a !== void 0 ? _a : [];
+    };
+    IosCrashReportingInstrumentation.prototype.buildPlatformContext = function (parsedTrace, context) {
+        if (parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.exceptionName) {
+            context['nativeExceptionName'] = parsedTrace.exceptionName;
+        }
+        if (parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.signalName) {
+            context['signalName'] = parsedTrace.signalName;
+        }
+        if (parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.signalDescription) {
+            context['signalDescription'] = parsedTrace.signalDescription;
+        }
+    };
+    IosCrashReportingInstrumentation.prototype.getParseFailureWarning = function () {
+        return 'Native crash trace present but no frames parsed; check iOS PLCrashReporter format';
+    };
+    IosCrashReportingInstrumentation.prototype.getTraceUnavailableWarning = function () {
+        return 'Native crash trace unavailable (PLCrashReporter trace was null at crash time)';
+    };
+    return IosCrashReportingInstrumentation;
+}(BaseCrashReportingInstrumentation_1.BaseCrashReportingInstrumentation));
+exports.IosCrashReportingInstrumentation = IosCrashReportingInstrumentation;
+//# sourceMappingURL=IosCrashReportingInstrumentation.js.map

package/dist/cjs/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IosCrashReportingInstrumentation.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,gDAA6C;AAE7C,0FAAyF;AAGzF,yDAAsF;AACtF,2DAAoF;AAEpF;;;;;;;;;;;;;GAaG;AACH;IAAsD,oDAAiC;IAAvF;;QACW,UAAI,GAAG,sDAAsD,CAAC;QAC9D,aAAO,GAAG,mBAAO,CAAC;;IAqC7B,CAAC;IAnCW,0DAAe,GAAzB,UAA0B,KAAa;QACrC,OAAO,IAAA,uCAAkB,EAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAES,mEAAwB,GAAlC,UAAmC,KAAkB,EAAE,WAAuC;QAC5F,OAAO,IAAA,4CAAwB,EAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAES,gEAAqB,GAA/B,UAAgC,KAAkB;QAChD,OAAO,IAAA,yCAAqB,EAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,yDAAc,GAAxB,UAAyB,WAAuC;;QAC9D,OAAO,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,EAAE,CAAC;IACnC,CAAC;IAES,+DAAoB,GAA9B,UAA+B,WAAuC,EAAE,OAA+B;QACrG,IAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,aAAa,EAAE,CAAC;YAC/B,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW,CAAC,aAAa,CAAC;QAC7D,CAAC;QACD,IAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,UAAU,EAAE,CAAC;YAC5B,OAAO,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC;QACjD,CAAC;QACD,IAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,iBAAiB,EAAE,CAAC;YACnC,OAAO,CAAC,mBAAmB,CAAC,GAAG,WAAW,CAAC,iBAAiB,CAAC;QAC/D,CAAC;IACH,CAAC;IAES,iEAAsB,GAAhC;QACE,OAAO,mFAAmF,CAAC;IAC7F,CAAC;IAES,qEAA0B,GAApC;QACE,OAAO,+EAA+E,CAAC;IACzF,CAAC;IACH,uCAAC;AAAD,CAAC,AAvCD,CAAsD,qEAAiC,GAuCtF;AAvCY,4EAAgC","sourcesContent":["import { VERSION } from '@grafana/faro-core';\n\nimport { BaseCrashReportingInstrumentation } from '../BaseCrashReportingInstrumentation';\nimport type { CrashReport } from '../types';\n\nimport { resolveCrashErrorMessage, shouldSkipCrashReport } from './crashErrorMessage';\nimport { type ParsedIosCrashTrace, parseIosCrashTrace } from './parseIosCrashTrace';\n\n/**\n * iOS Crash Reporting Instrumentation.\n *\n * Uses PLCrashReporter to capture native crashes from previous sessions:\n * - SIGSEGV: Segmentation fault / invalid memory access\n * - SIGABRT: Abnormal termination (e.g., assertion failure, uncaught exception)\n * - SIGBUS: Bus error / alignment/hardware error\n * - SIGILL: Illegal instruction\n * - SIGFPE: Floating point exception\n * - SIGTRAP: Breakpoint/debugger trap\n * - Mach exceptions (EXC_BAD_ACCESS, EXC_CRASH, etc.)\n *\n * Stack frames are symbolicated on the native side before being surfaced.\n */\nexport class IosCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-crash-ios';\n  readonly version = VERSION;\n\n  protected parseCrashTrace(trace: string): ParsedIosCrashTrace | null {\n    return parseIosCrashTrace(trace);\n  }\n\n  protected resolveCrashErrorMessage(crash: CrashReport, parsedTrace: ParsedIosCrashTrace | null): string {\n    return resolveCrashErrorMessage(crash, parsedTrace);\n  }\n\n  protected shouldSkipCrashReport(crash: CrashReport): boolean {\n    return shouldSkipCrashReport(crash);\n  }\n\n  protected getStackFrames(parsedTrace: ParsedIosCrashTrace | null): any[] {\n    return parsedTrace?.frames ?? [];\n  }\n\n  protected buildPlatformContext(parsedTrace: ParsedIosCrashTrace | null, context: Record<string, string>): void {\n    if (parsedTrace?.exceptionName) {\n      context['nativeExceptionName'] = parsedTrace.exceptionName;\n    }\n    if (parsedTrace?.signalName) {\n      context['signalName'] = parsedTrace.signalName;\n    }\n    if (parsedTrace?.signalDescription) {\n      context['signalDescription'] = parsedTrace.signalDescription;\n    }\n  }\n\n  protected getParseFailureWarning(): string {\n    return 'Native crash trace present but no frames parsed; check iOS PLCrashReporter format';\n  }\n\n  protected getTraceUnavailableWarning(): string {\n    return 'Native crash trace unavailable (PLCrashReporter trace was null at crash time)';\n  }\n}\n"]}

package/dist/cjs/instrumentations/crashReporting/ios/crashErrorMessage.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCrashErrorMessage = resolveCrashErrorMessage;
+exports.shouldSkipCrashReport = shouldSkipCrashReport;
+exports.buildFallbackCrashMessage = buildFallbackCrashMessage;
+/**
+ * Human-readable exception value for iOS PLCrashReporter crash reports.
+ * Priority: exception reason → signal description → signal name → fallback.
+ */
+function resolveCrashErrorMessage(crash, parsedTrace) {
+    var _a, _b, _c, _d, _e;
+    // iOS uncaught exceptions (NSException) have name and reason
+    if ((parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.exceptionName) || (parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.exceptionReason)) {
+        var name_1 = parsedTrace.exceptionName || 'Exception';
+        var reason_1 = (_a = parsedTrace.exceptionReason) === null || _a === void 0 ? void 0 : _a.trim();
+        if (reason_1) {
+            return "".concat(name_1, ": ").concat(reason_1);
+        }
+        return name_1;
+    }
+    // Use signal description if available from parsed trace
+    if ((_b = parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.signalDescription) === null || _b === void 0 ? void 0 : _b.trim()) {
+        return parsedTrace.signalDescription.trim();
+    }
+    // Use signal name from parsed trace
+    if ((_c = parsedTrace === null || parsedTrace === void 0 ? void 0 : parsedTrace.signalName) === null || _c === void 0 ? void 0 : _c.trim()) {
+        var signalName = parsedTrace.signalName.trim();
+        var description_1 = SIGNAL_DESCRIPTIONS[signalName];
+        return description_1 || signalName;
+    }
+    // Check crash description - use if meaningful
+    var description = (_d = crash.description) === null || _d === void 0 ? void 0 : _d.trim();
+    if (description && !isGenericCrashDescription(description)) {
+        return description;
+    }
+    // Check if we have a known signal reason
+    var reason = (_e = crash.reason) === null || _e === void 0 ? void 0 : _e.trim();
+    if (reason && SIGNAL_DESCRIPTIONS[reason]) {
+        // If description is explicitly generic, use full format
+        if (description && isGenericCrashDescription(description)) {
+            return buildFallbackCrashMessage(crash);
+        }
+        // No description - use simple signal description
+        return SIGNAL_DESCRIPTIONS[reason];
+    }
+    // Final fallback: format with signal name, description, and status
+    return buildFallbackCrashMessage(crash);
+}
+/**
+ * Skip crash reports that have no useful information.
+ * iOS crashes should always have either a trace or a signal.
+ */
+function shouldSkipCrashReport(crash) {
+    var _a, _b, _c;
+    if ((_a = crash.trace) === null || _a === void 0 ? void 0 : _a.trim()) {
+        return false;
+    }
+    if ((_b = crash.signal) === null || _b === void 0 ? void 0 : _b.trim()) {
+        return false;
+    }
+    var description = (_c = crash.description) === null || _c === void 0 ? void 0 : _c.trim();
+    if (description && !isGenericCrashDescription(description)) {
+        return false;
+    }
+    return true;
+}
+/** BSD signal names to human-readable descriptions */
+var SIGNAL_DESCRIPTIONS = {
+    SIGHUP: 'Hangup',
+    SIGINT: 'Interrupt',
+    SIGQUIT: 'Quit',
+    SIGILL: 'Illegal instruction',
+    SIGTRAP: 'Trace/BPT trap',
+    SIGABRT: 'Abort trap',
+    SIGEMT: 'EMT trap',
+    SIGFPE: 'Floating point exception',
+    SIGKILL: 'Killed',
+    SIGBUS: 'Bus error',
+    SIGSEGV: 'Segmentation fault',
+    SIGSYS: 'Bad system call',
+    SIGPIPE: 'Broken pipe',
+    SIGALRM: 'Alarm clock',
+    SIGTERM: 'Terminated',
+};
+function isGenericCrashDescription(description) {
+    var normalized = description.trim().toLowerCase();
+    return normalized === 'crash' || normalized === 'application crash' || normalized === 'signal crash';
+}
+/** Generic fallback when the trace carries no parseable signal or description. */
+function buildFallbackCrashMessage(crash) {
+    var _a;
+    var reason = crash.reason || 'UNKNOWN';
+    var status = (_a = crash.status) !== null && _a !== void 0 ? _a : 0;
+    var description;
+    if (SIGNAL_DESCRIPTIONS[reason]) {
+        description = SIGNAL_DESCRIPTIONS[reason];
+    }
+    else {
+        description = crash.description || 'Application crash';
+    }
+    return "".concat(reason, ": ").concat(description, ", status: ").concat(status);
+}
+//# sourceMappingURL=crashErrorMessage.js.map