npm - @grafana/faro-react-native - Versions diffs - 1.3.1 → 1.4.0 - Mend

@grafana/faro-react-native 1.3.1 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (256) hide show

package/dist/esm/instrumentations/crashReporting/RecoveredCrashReportingInstrumentation.js ADDED Viewed

@@ -0,0 +1,230 @@
+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 } from 'react-native';
+import { TransportItemType } from '@grafana/faro-core';
+import { FetchTransport } from '../../transports/fetch';
+import { BaseCrashReportingInstrumentation } from './BaseCrashReportingInstrumentation';
+// Keep aligned with FaroCrashSessionStore.MAX_CONTEXT_AGE_MS on Android.
+const MAX_REPLAY_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Shared recovered-crash delivery contract for native platforms.
+ *
+ * Native code owns crash-time persistence. JavaScript owns validation, transport
+ * acceptance, and acknowledgement so retryable failures never delete a report.
+ */
+export class RecoveredCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {
+    constructor() {
+        super(...arguments);
+        this.nativeModule = null;
+        this.supportsSessionReplay = false;
+        this.metasListenerRegistered = false;
+        this.lastRecordedSessionSignature = null;
+        this.activeSessionId = null;
+        this.activeSessionActivatedAtMs = 0;
+        this.recordSessionContextListener = (meta) => {
+            this.recordSessionContext(meta);
+        };
+    }
+    prepareCrashReporting(nativeModule) {
+        this.supportsSessionReplay =
+            typeof nativeModule.recordCrashSessionContext === 'function' &&
+                typeof nativeModule.getPendingCrashReports === 'function' &&
+                typeof nativeModule.acknowledgeCrashReports === 'function';
+        if (!this.supportsSessionReplay) {
+            this.logWarn('Native module does not support original-session crash replay; using legacy crash reporting');
+            return;
+        }
+        this.nativeModule = nativeModule;
+        this.recordSessionContext(this.metas.value);
+        if (!this.metasListenerRegistered) {
+            this.metas.addListener(this.recordSessionContextListener);
+            this.metasListenerRegistered = true;
+        }
+    }
+    processCrashReports(nativeModule) {
+        const _super = Object.create(null, {
+            processCrashReports: { get: () => super.processCrashReports }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (!this.supportsSessionReplay) {
+                yield _super.processCrashReports.call(this, nativeModule);
+                return;
+            }
+            try {
+                const replayStartedAtMs = Date.now();
+                const crashReports = (yield nativeModule.getPendingCrashReports());
+                if (!(crashReports === null || crashReports === void 0 ? void 0 : crashReports.length)) {
+                    this.logDebug('No crash reports from previous session');
+                    return;
+                }
+                const processedReportIds = new Set();
+                for (const crashJson of crashReports) {
+                    let parsedCrash;
+                    try {
+                        parsedCrash = JSON.parse(crashJson);
+                    }
+                    catch (error) {
+                        this.logError('Failed to parse recovered crash report', error);
+                        continue;
+                    }
+                    if (!parsedCrash || typeof parsedCrash !== 'object' || Array.isArray(parsedCrash)) {
+                        this.logWarn('Skipping malformed recovered crash report');
+                        continue;
+                    }
+                    const crash = parsedCrash;
+                    const reportId = (_a = crash.reportId) === null || _a === void 0 ? void 0 : _a.trim();
+                    if (!reportId) {
+                        this.logWarn('Skipping malformed recovered crash report');
+                        continue;
+                    }
+                    if (!this.hasValidTimestamp(crash)) {
+                        this.logWarn(`Discarding malformed recovered crash ${reportId}`);
+                        yield this.acknowledgeCrashReport(nativeModule, reportId);
+                        continue;
+                    }
+                    if (processedReportIds.has(reportId)) {
+                        this.logDebug(`Skipping duplicate recovered crash report ${reportId}`);
+                        continue;
+                    }
+                    processedReportIds.add(reportId);
+                    if (!this.isWithinReplayWindow(crash.timestamp, replayStartedAtMs)) {
+                        yield this.acknowledgeCrashReport(nativeModule, reportId);
+                        continue;
+                    }
+                    if (this.shouldSkipCrashReport(crash)) {
+                        yield this.acknowledgeCrashReport(nativeModule, reportId);
+                        continue;
+                    }
+                    const sessionId = (_b = crash.sessionId) === null || _b === void 0 ? void 0 : _b.trim();
+                    if (!sessionId) {
+                        this.logWarn(`Discarding recovered crash ${reportId} because its original session context is unavailable`);
+                        yield this.acknowledgeCrashReport(nativeModule, reportId);
+                        continue;
+                    }
+                    const outcome = yield this.replayCrashReport(Object.assign(Object.assign({}, crash), { reportId,
+                        sessionId }));
+                    if (outcome === 'accepted' || outcome === 'filtered') {
+                        yield this.acknowledgeCrashReport(nativeModule, reportId);
+                    }
+                }
+            }
+            catch (error) {
+                this.logError('Failed to process recovered crash reports', error);
+            }
+        });
+    }
+    recordSessionContext(meta) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const sessionId = (_b = (_a = meta.session) === null || _a === void 0 ? void 0 : _a.id) === null || _b === void 0 ? void 0 : _b.trim();
+        if (!sessionId || !this.nativeModule) {
+            return;
+        }
+        if (this.activeSessionId !== sessionId) {
+            this.activeSessionId = sessionId;
+            this.activeSessionActivatedAtMs = Date.now();
+            this.activeSessionIsSampled = undefined;
+        }
+        const sampledValue = (_d = (_c = meta.session) === null || _c === void 0 ? void 0 : _c.attributes) === null || _d === void 0 ? void 0 : _d['isSampled'];
+        const incomingIsSampled = sampledValue === 'true' ? true : sampledValue === 'false' ? false : undefined;
+        if (incomingIsSampled !== undefined) {
+            this.activeSessionIsSampled = incomingIsSampled;
+        }
+        const isSampled = incomingIsSampled !== null && incomingIsSampled !== void 0 ? incomingIsSampled : this.activeSessionIsSampled;
+        const sessionContext = Object.assign(Object.assign(Object.assign(Object.assign({ sessionId, activatedAt: this.activeSessionActivatedAtMs }, (isSampled === undefined ? {} : { isSampled })), (((_e = meta.app) === null || _e === void 0 ? void 0 : _e.version) ? { appVersion: meta.app.version } : {})), (((_f = meta.app) === null || _f === void 0 ? void 0 : _f.release) ? { appRelease: meta.app.release } : {})), (((_g = meta.app) === null || _g === void 0 ? void 0 : _g.bundleId) ? { appBundleId: meta.app.bundleId } : {}));
+        const signature = JSON.stringify(sessionContext);
+        if (signature === this.lastRecordedSessionSignature) {
+            return;
+        }
+        try {
+            const stored = this.nativeModule.recordCrashSessionContext(sessionContext);
+            if (stored === true) {
+                this.lastRecordedSessionSignature = signature;
+            }
+        }
+        catch (error) {
+            this.logError('Failed to persist crash session context', error);
+        }
+    }
+    replayCrashReport(crash) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.transports.isPaused()) {
+                return 'retry';
+            }
+            const fetchTransport = this.transports.transports.find((transport) => transport instanceof FetchTransport);
+            if (!fetchTransport) {
+                this.logWarn('Fetch transport is unavailable; leaving recovered crash pending');
+                return 'retry';
+            }
+            // Recovered crashes intentionally bypass transport fan-out. Native storage
+            // handles retries, and only FetchTransport reports collector acceptance before ack.
+            let item = this.buildRecoveredCrashItem(crash);
+            try {
+                for (const hook of this.transports.getBeforeSendHooks()) {
+                    const modifiedItem = hook(item);
+                    // Match faro-core's filter(Boolean) behavior for invalid hook results.
+                    if (!modifiedItem) {
+                        return 'filtered';
+                    }
+                    item = modifiedItem;
+                }
+            }
+            catch (error) {
+                this.logError('Failed to apply beforeSend hook to recovered crash', error);
+                return 'retry';
+            }
+            const result = yield fetchTransport.sendWithResult([item]);
+            return result.outcome === 'accepted' ? 'accepted' : 'retry';
+        });
+    }
+    buildRecoveredCrashItem(crash) {
+        var _a;
+        const { context, errorMessage, stackFrames } = this.buildCrashReportDetails(crash);
+        const currentMeta = this.metas.value;
+        const isSampledAttribute = crash.isSampled === undefined ? undefined : { isSampled: String(crash.isSampled) };
+        // Current user, view, and page metadata belong to the restarted session.
+        const meta = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (currentMeta.sdk ? { sdk: Object.assign({}, currentMeta.sdk) } : {})), { app: Object.assign(Object.assign(Object.assign(Object.assign({}, ((_a = currentMeta.app) !== null && _a !== void 0 ? _a : {})), (crash.appVersion ? { version: crash.appVersion } : {})), (crash.appRelease ? { release: crash.appRelease } : {})), (crash.appBundleId ? { bundleId: crash.appBundleId } : {})) }), (currentMeta.os ? { os: Object.assign({}, currentMeta.os) } : {})), (currentMeta.device ? { device: Object.assign({}, currentMeta.device) } : {})), { session: Object.assign({ id: crash.sessionId }, (isSampledAttribute ? { attributes: isSampledAttribute } : {})) });
+        return {
+            type: TransportItemType.EXCEPTION,
+            meta,
+            payload: Object.assign({ type: 'crash', value: errorMessage, timestamp: new Date(crash.timestamp).toISOString(), context, fatal: true }, (stackFrames.length ? { stacktrace: { frames: stackFrames } } : {})),
+        };
+    }
+    acknowledgeCrashReport(nativeModule, reportId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield nativeModule.acknowledgeCrashReports([reportId]);
+            }
+            catch (error) {
+                this.logError(`Failed to acknowledge recovered crash ${reportId}`, error);
+            }
+        });
+    }
+    hasValidTimestamp(crash) {
+        return typeof crash.timestamp === 'number' && Number.isFinite(crash.timestamp) && crash.timestamp > 0;
+    }
+    isWithinReplayWindow(timestampMs, replayStartedAtMs) {
+        return timestampMs <= replayStartedAtMs && replayStartedAtMs - timestampMs <= MAX_REPLAY_AGE_MS;
+    }
+    unpatch() {
+        if (this.metasListenerRegistered) {
+            this.metas.removeListener(this.recordSessionContextListener);
+            this.metasListenerRegistered = false;
+        }
+        this.nativeModule = null;
+        this.supportsSessionReplay = false;
+        this.lastRecordedSessionSignature = null;
+        this.activeSessionId = null;
+        this.activeSessionActivatedAtMs = 0;
+        this.activeSessionIsSampled = undefined;
+        super.unpatch();
+    }
+}
+//# sourceMappingURL=RecoveredCrashReportingInstrumentation.js.map

package/dist/esm/instrumentations/crashReporting/RecoveredCrashReportingInstrumentation.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"RecoveredCrashReportingInstrumentation.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/RecoveredCrashReportingInstrumentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeModules } from 'react-native';\n\nimport { TransportItemType } from '@grafana/faro-core';\nimport type { ExceptionEvent, Meta, TransportItem } from '@grafana/faro-core';\n\nimport { FetchTransport } from '../../transports/fetch';\n\nimport { BaseCrashReportingInstrumentation } from './BaseCrashReportingInstrumentation';\nimport type { CrashReport } from './types';\n\n// Keep aligned with FaroCrashSessionStore.MAX_CONTEXT_AGE_MS on Android.\nconst MAX_REPLAY_AGE_MS = 7 * 24 * 60 * 60 * 1000;\n\ntype RecoveredCrashReport = CrashReport & {\n reportId: string;\n sessionId: string;\n timestamp: number;\n};\n\n/**\n * Shared recovered-crash delivery contract for native platforms.\n *\n * Native code owns crash-time persistence. JavaScript owns validation, transport\n * acceptance, and acknowledgement so retryable failures never delete a report.\n */\nexport abstract class RecoveredCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {\n private nativeModule: typeof NativeModules.FaroReactNativeModule | null = null;\n private supportsSessionReplay = false;\n private metasListenerRegistered = false;\n private lastRecordedSessionSignature: string | null = null;\n private activeSessionId: string | null = null;\n private activeSessionActivatedAtMs = 0;\n private activeSessionIsSampled: boolean | undefined;\n\n private readonly recordSessionContextListener = (meta: Meta): void => {\n this.recordSessionContext(meta);\n };\n\n protected override prepareCrashReporting(nativeModule: typeof NativeModules.FaroReactNativeModule): void {\n this.supportsSessionReplay =\n typeof nativeModule.recordCrashSessionContext === 'function' &&\n typeof nativeModule.getPendingCrashReports === 'function' &&\n typeof nativeModule.acknowledgeCrashReports === 'function';\n\n if (!this.supportsSessionReplay) {\n this.logWarn('Native module does not support original-session crash replay; using legacy crash reporting');\n return;\n }\n\n this.nativeModule = nativeModule;\n this.recordSessionContext(this.metas.value);\n if (!this.metasListenerRegistered) {\n this.metas.addListener(this.recordSessionContextListener);\n this.metasListenerRegistered = true;\n }\n }\n\n protected override async processCrashReports(\n nativeModule: typeof NativeModules.FaroReactNativeModule\n ): Promise<void> {\n if (!this.supportsSessionReplay) {\n await super.processCrashReports(nativeModule);\n return;\n }\n\n try {\n const replayStartedAtMs = Date.now();\n const crashReports = (await nativeModule.getPendingCrashReports()) as string[] | null;\n if (!crashReports?.length) {\n this.logDebug('No crash reports from previous session');\n return;\n }\n\n const processedReportIds = new Set<string>();\n for (const crashJson of crashReports) {\n let parsedCrash: unknown;\n try {\n parsedCrash = JSON.parse(crashJson);\n } catch (error) {\n this.logError('Failed to parse recovered crash report', error);\n continue;\n }\n if (!parsedCrash || typeof parsedCrash !== 'object' || Array.isArray(parsedCrash)) {\n this.logWarn('Skipping malformed recovered crash report');\n continue;\n }\n const crash = parsedCrash as CrashReport;\n\n const reportId = crash.reportId?.trim();\n if (!reportId) {\n this.logWarn('Skipping malformed recovered crash report');\n continue;\n }\n if (!this.hasValidTimestamp(crash)) {\n this.logWarn(`Discarding malformed recovered crash ${reportId}`);\n await this.acknowledgeCrashReport(nativeModule, reportId);\n continue;\n }\n if (processedReportIds.has(reportId)) {\n this.logDebug(`Skipping duplicate recovered crash report ${reportId}`);\n continue;\n }\n processedReportIds.add(reportId);\n\n if (!this.isWithinReplayWindow(crash.timestamp, replayStartedAtMs)) {\n await this.acknowledgeCrashReport(nativeModule, reportId);\n continue;\n }\n if (this.shouldSkipCrashReport(crash)) {\n await this.acknowledgeCrashReport(nativeModule, reportId);\n continue;\n }\n\n const sessionId = crash.sessionId?.trim();\n if (!sessionId) {\n this.logWarn(`Discarding recovered crash ${reportId} because its original session context is unavailable`);\n await this.acknowledgeCrashReport(nativeModule, reportId);\n continue;\n }\n\n const outcome = await this.replayCrashReport({\n ...crash,\n reportId,\n sessionId,\n });\n if (outcome === 'accepted' || outcome === 'filtered') {\n await this.acknowledgeCrashReport(nativeModule, reportId);\n }\n }\n } catch (error) {\n this.logError('Failed to process recovered crash reports', error);\n }\n }\n\n private recordSessionContext(meta: Meta): void {\n const sessionId = meta.session?.id?.trim();\n if (!sessionId || !this.nativeModule) {\n return;\n }\n\n if (this.activeSessionId !== sessionId) {\n this.activeSessionId = sessionId;\n this.activeSessionActivatedAtMs = Date.now();\n this.activeSessionIsSampled = undefined;\n }\n\n const sampledValue = meta.session?.attributes?.['isSampled'];\n const incomingIsSampled = sampledValue === 'true' ? true : sampledValue === 'false' ? false : undefined;\n if (incomingIsSampled !== undefined) {\n this.activeSessionIsSampled = incomingIsSampled;\n }\n const isSampled = incomingIsSampled ?? this.activeSessionIsSampled;\n const sessionContext = {\n sessionId,\n activatedAt: this.activeSessionActivatedAtMs,\n ...(isSampled === undefined ? {} : { isSampled }),\n ...(meta.app?.version ? { appVersion: meta.app.version } : {}),\n ...(meta.app?.release ? { appRelease: meta.app.release } : {}),\n ...(meta.app?.bundleId ? { appBundleId: meta.app.bundleId } : {}),\n };\n const signature = JSON.stringify(sessionContext);\n if (signature === this.lastRecordedSessionSignature) {\n return;\n }\n\n try {\n const stored = this.nativeModule.recordCrashSessionContext(sessionContext);\n if (stored === true) {\n this.lastRecordedSessionSignature = signature;\n }\n } catch (error) {\n this.logError('Failed to persist crash session context', error);\n }\n }\n\n private async replayCrashReport(crash: RecoveredCrashReport): Promise<'accepted' | 'filtered' | 'retry'> {\n if (this.transports.isPaused()) {\n return 'retry';\n }\n\n const fetchTransport = this.transports.transports.find(\n (transport): transport is FetchTransport => transport instanceof FetchTransport\n );\n if (!fetchTransport) {\n this.logWarn('Fetch transport is unavailable; leaving recovered crash pending');\n return 'retry';\n }\n\n // Recovered crashes intentionally bypass transport fan-out. Native storage\n // handles retries, and only FetchTransport reports collector acceptance before ack.\n let item: TransportItem = this.buildRecoveredCrashItem(crash);\n try {\n for (const hook of this.transports.getBeforeSendHooks()) {\n const modifiedItem = hook(item);\n // Match faro-core's filter(Boolean) behavior for invalid hook results.\n if (!modifiedItem) {\n return 'filtered';\n }\n item = modifiedItem;\n }\n } catch (error) {\n this.logError('Failed to apply beforeSend hook to recovered crash', error);\n return 'retry';\n }\n\n const result = await fetchTransport.sendWithResult([item]);\n return result.outcome === 'accepted' ? 'accepted' : 'retry';\n }\n\n private buildRecoveredCrashItem(crash: RecoveredCrashReport): TransportItem<ExceptionEvent> {\n const { context, errorMessage, stackFrames } = this.buildCrashReportDetails(crash);\n const currentMeta = this.metas.value;\n const isSampledAttribute = crash.isSampled === undefined ? undefined : { isSampled: String(crash.isSampled) };\n // Current user, view, and page metadata belong to the restarted session.\n const meta: Meta = {\n ...(currentMeta.sdk ? { sdk: { ...currentMeta.sdk } } : {}),\n app: {\n ...(currentMeta.app ?? {}),\n ...(crash.appVersion ? { version: crash.appVersion } : {}),\n ...(crash.appRelease ? { release: crash.appRelease } : {}),\n ...(crash.appBundleId ? { bundleId: crash.appBundleId } : {}),\n },\n ...(currentMeta.os ? { os: { ...currentMeta.os } } : {}),\n ...(currentMeta.device ? { device: { ...currentMeta.device } } : {}),\n session: {\n id: crash.sessionId,\n ...(isSampledAttribute ? { attributes: isSampledAttribute } : {}),\n },\n };\n\n return {\n type: TransportItemType.EXCEPTION,\n meta,\n payload: {\n type: 'crash',\n value: errorMessage,\n timestamp: new Date(crash.timestamp).toISOString(),\n context,\n fatal: true,\n ...(stackFrames.length ? { stacktrace: { frames: stackFrames } } : {}),\n },\n };\n }\n\n private async acknowledgeCrashReport(\n nativeModule: typeof NativeModules.FaroReactNativeModule,\n reportId: string\n ): Promise<void> {\n try {\n await nativeModule.acknowledgeCrashReports([reportId]);\n } catch (error) {\n this.logError(`Failed to acknowledge recovered crash ${reportId}`, error);\n }\n }\n\n private hasValidTimestamp(crash: CrashReport): crash is CrashReport & { timestamp: number } {\n return typeof crash.timestamp === 'number' && Number.isFinite(crash.timestamp) && crash.timestamp > 0;\n }\n\n private isWithinReplayWindow(timestampMs: number, replayStartedAtMs: number): boolean {\n return timestampMs <= replayStartedAtMs && replayStartedAtMs - timestampMs <= MAX_REPLAY_AGE_MS;\n }\n\n override unpatch(): void {\n if (this.metasListenerRegistered) {\n this.metas.removeListener(this.recordSessionContextListener);\n this.metasListenerRegistered = false;\n }\n this.nativeModule = null;\n this.supportsSessionReplay = false;\n this.lastRecordedSessionSignature = null;\n this.activeSessionId = null;\n this.activeSessionActivatedAtMs = 0;\n this.activeSessionIsSampled = undefined;\n super.unpatch();\n }\n}\n"]}

package/dist/esm/instrumentations/crashReporting/android/AndroidCrashReportingInstrumentation.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { VERSION } from '@grafana/faro-core';
-import { BaseCrashReportingInstrumentation } from '../BaseCrashReportingInstrumentation';
+import { RecoveredCrashReportingInstrumentation } from '../RecoveredCrashReportingInstrumentation';
 import { resolveCrashErrorMessage, shouldSkipCrashReport } from './crashErrorMessage';
 import { parseAndroidCrashTrace } from './parseAndroidCrashTrace';
 /**
@@ -14,7 +14,7 @@ import { parseAndroidCrashTrace } from './parseAndroidCrashTrace';
  *
  * ANRs are reported separately by ANRInstrumentation, not via ApplicationExitInfo replay.
  */
-export class AndroidCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {
+export class AndroidCrashReportingInstrumentation extends RecoveredCrashReportingInstrumentation {
     constructor() {
         super(...arguments);
         this.name = '@grafana/faro-react-native:instrumentation-crash-android';

package/dist/esm/instrumentations/crashReporting/android/AndroidCrashReportingInstrumentation.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AndroidCrashReportingInstrumentation.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/android/AndroidCrashReportingInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,~~iCAAiC~~,EAAE,MAAM,~~sCAAsC~~,CAAC;~~AAGzF~~,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAgC,MAAM,0BAA0B,CAAC;AAEhG;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oCAAqC,SAAQ,~~iCAAiC~~;~~IAA3F~~;;QACW,SAAI,GAAG,0DAA0D,CAAC;QAClE,YAAO,GAAG,OAAO,CAAC;IAuC7B,CAAC;IArCW,eAAe,CAAC,KAAa;QACrC,OAAO,sBAAsB,CAAC,KAAK,EAAE;YACnC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,qBAAqB;SAC1D,CAAC,CAAC;IACL,CAAC;IAES,wBAAwB,CAAC,KAAkB,EAAE,WAA2C;QAChG,OAAO,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAES,qBAAqB,CAAC,KAAkB;QAChD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,cAAc,CAAC,WAA2C;;QAClE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,gGAAgG;QAChG,OAAO,CAAC,GAAG,CAAC,MAAA,WAAW,CAAC,QAAQ,mCAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,WAAW,CAAC,MAAM,mCAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,WAAW,CAAC,YAAY,mCAAI,EAAE,CAAC,CAAC,CAAC;IAC/G,CAAC;IAES,oBAAoB,CAAC,WAA2C,EAAE,OAA+B;QACzG,yEAAyE;QACzE,gFAAgF;QAChF,IAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,aAAa,EAAE,CAAC;YAC/B,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW,CAAC,aAAa,CAAC;QAC7D,CAAC;IACH,CAAC;IAES,sBAAsB;QAC9B,OAAO,+GAA+G,CAAC;IACzH,CAAC;IAES,0BAA0B;QAClC,OAAO,8FAA8F,CAAC;IACxG,CAAC;CACF","sourcesContent":["import { VERSION } from '@grafana/faro-core';\n\nimport { ~~BaseCrashReportingInstrumentation~~ } from '../~~BaseCrashReportingInstrumentation~~';\nimport type { CrashReport } from '../types';\n\nimport { resolveCrashErrorMessage, shouldSkipCrashReport } from './crashErrorMessage';\nimport { parseAndroidCrashTrace, type ParsedAndroidCrashTrace } from './parseAndroidCrashTrace';\n\n/*\n Android Crash Reporting Instrumentation.\n \n Uses ApplicationExitInfo API (Android 11+ / API 30+) to retrieve crash reports\n * from previous sessions. Captures:\n * - CRASH: Java/Kotlin exception crashes\n * - CRASH_NATIVE: Native (NDK) crashes\n * - LOW_MEMORY: App killed due to low memory\n * - EXCESSIVE_RESOURCE_USAGE: App killed due to excessive resource usage\n \n ANRs are reported separately by ANRInstrumentation, not via ApplicationExitInfo replay.\n */\nexport class AndroidCrashReportingInstrumentation extends ~~BaseCrashReportingInstrumentation~~ {\n readonly name = '@grafana/faro-react-native:instrumentation-crash-android';\n readonly version = VERSION;\n\n protected parseCrashTrace(trace: string): ParsedAndroidCrashTrace \| null {\n return parseAndroidCrashTrace(trace, {\n releaseBundleFilename: this.options.releaseBundleFilename,\n });\n }\n\n protected resolveCrashErrorMessage(crash: CrashReport, parsedTrace: ParsedAndroidCrashTrace \| 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: ParsedAndroidCrashTrace \| null): any[] {\n if (!parsedTrace) {\n return [];\n }\n // Android has JS frames, Java/Kotlin frames (R8 retrace), and NDK tombstone rows (.so retrace).\n return [...(parsedTrace.jsFrames ?? []), ...(parsedTrace.frames ?? []), ...(parsedTrace.nativeFrames ?? [])];\n }\n\n protected buildPlatformContext(parsedTrace: ParsedAndroidCrashTrace \| null, context: Record<string, string>): void {\n // Store the native Java/Kotlin exception class separately for drill-down\n // Plugin overview metrics key off exception_type = 'crash', so keep that stable\n if (parsedTrace?.exceptionType) {\n context['nativeExceptionType'] = parsedTrace.exceptionType;\n }\n }\n\n protected getParseFailureWarning(): string {\n return 'Native crash trace present but no frames parsed; check Android trace format or UncaughtExceptionHandler cache';\n }\n\n protected getTraceUnavailableWarning(): string {\n return 'Native crash trace unavailable (ApplicationExitInfo traceInputStream was null at crash time)';\n }\n}\n"]}
1	+ {"version":3,"file":"AndroidCrashReportingInstrumentation.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/android/AndroidCrashReportingInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,sCAAsC,EAAE,MAAM,2CAA2C,CAAC;AAGnG,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAgC,MAAM,0BAA0B,CAAC;AAEhG;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oCAAqC,SAAQ,sCAAsC;IAAhG;;QACW,SAAI,GAAG,0DAA0D,CAAC;QAClE,YAAO,GAAG,OAAO,CAAC;IAuC7B,CAAC;IArCW,eAAe,CAAC,KAAa;QACrC,OAAO,sBAAsB,CAAC,KAAK,EAAE;YACnC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,qBAAqB;SAC1D,CAAC,CAAC;IACL,CAAC;IAES,wBAAwB,CAAC,KAAkB,EAAE,WAA2C;QAChG,OAAO,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAES,qBAAqB,CAAC,KAAkB;QAChD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,cAAc,CAAC,WAA2C;;QAClE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,gGAAgG;QAChG,OAAO,CAAC,GAAG,CAAC,MAAA,WAAW,CAAC,QAAQ,mCAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,WAAW,CAAC,MAAM,mCAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,WAAW,CAAC,YAAY,mCAAI,EAAE,CAAC,CAAC,CAAC;IAC/G,CAAC;IAES,oBAAoB,CAAC,WAA2C,EAAE,OAA+B;QACzG,yEAAyE;QACzE,gFAAgF;QAChF,IAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,aAAa,EAAE,CAAC;YAC/B,OAAO,CAAC,qBAAqB,CAAC,GAAG,WAAW,CAAC,aAAa,CAAC;QAC7D,CAAC;IACH,CAAC;IAES,sBAAsB;QAC9B,OAAO,+GAA+G,CAAC;IACzH,CAAC;IAES,0BAA0B;QAClC,OAAO,8FAA8F,CAAC;IACxG,CAAC;CACF","sourcesContent":["import { VERSION } from '@grafana/faro-core';\n\nimport { RecoveredCrashReportingInstrumentation } from '../RecoveredCrashReportingInstrumentation';\nimport type { CrashReport } from '../types';\n\nimport { resolveCrashErrorMessage, shouldSkipCrashReport } from './crashErrorMessage';\nimport { parseAndroidCrashTrace, type ParsedAndroidCrashTrace } from './parseAndroidCrashTrace';\n\n/*\n Android Crash Reporting Instrumentation.\n \n Uses ApplicationExitInfo API (Android 11+ / API 30+) to retrieve crash reports\n * from previous sessions. Captures:\n * - CRASH: Java/Kotlin exception crashes\n * - CRASH_NATIVE: Native (NDK) crashes\n * - LOW_MEMORY: App killed due to low memory\n * - EXCESSIVE_RESOURCE_USAGE: App killed due to excessive resource usage\n \n ANRs are reported separately by ANRInstrumentation, not via ApplicationExitInfo replay.\n */\nexport class AndroidCrashReportingInstrumentation extends RecoveredCrashReportingInstrumentation {\n readonly name = '@grafana/faro-react-native:instrumentation-crash-android';\n readonly version = VERSION;\n\n protected parseCrashTrace(trace: string): ParsedAndroidCrashTrace \| null {\n return parseAndroidCrashTrace(trace, {\n releaseBundleFilename: this.options.releaseBundleFilename,\n });\n }\n\n protected resolveCrashErrorMessage(crash: CrashReport, parsedTrace: ParsedAndroidCrashTrace \| 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: ParsedAndroidCrashTrace \| null): any[] {\n if (!parsedTrace) {\n return [];\n }\n // Android has JS frames, Java/Kotlin frames (R8 retrace), and NDK tombstone rows (.so retrace).\n return [...(parsedTrace.jsFrames ?? []), ...(parsedTrace.frames ?? []), ...(parsedTrace.nativeFrames ?? [])];\n }\n\n protected buildPlatformContext(parsedTrace: ParsedAndroidCrashTrace \| null, context: Record<string, string>): void {\n // Store the native Java/Kotlin exception class separately for drill-down\n // Plugin overview metrics key off exception_type = 'crash', so keep that stable\n if (parsedTrace?.exceptionType) {\n context['nativeExceptionType'] = parsedTrace.exceptionType;\n }\n }\n\n protected getParseFailureWarning(): string {\n return 'Native crash trace present but no frames parsed; check Android trace format or UncaughtExceptionHandler cache';\n }\n\n protected getTraceUnavailableWarning(): string {\n return 'Native crash trace unavailable (ApplicationExitInfo traceInputStream was null at crash time)';\n }\n}\n"]}

package/dist/esm/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { VERSION } from '@grafana/faro-core';
-import { BaseCrashReportingInstrumentation } from '../BaseCrashReportingInstrumentation';
+import { RecoveredCrashReportingInstrumentation } from '../RecoveredCrashReportingInstrumentation';
 import { resolveCrashErrorMessage, shouldSkipCrashReport } from './crashErrorMessage';
 import { parseIosCrashTrace } from './parseIosCrashTrace';
 /**
@@ -16,7 +16,7 @@ import { parseIosCrashTrace } from './parseIosCrashTrace';
  *
  * Stack frames are symbolicated on the native side before being surfaced.
  */
-export class IosCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {
+export class IosCrashReportingInstrumentation extends RecoveredCrashReportingInstrumentation {
     constructor() {
         super(...arguments);
         this.name = '@grafana/faro-react-native:instrumentation-crash-ios';

package/dist/esm/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"IosCrashReportingInstrumentation.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,~~iCAAiC~~,EAAE,MAAM,~~sCAAsC~~,CAAC;~~AAGzF~~,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAA4B,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gCAAiC,SAAQ,~~iCAAiC~~;~~IAAvF~~;;QACW,SAAI,GAAG,sDAAsD,CAAC;QAC9D,YAAO,GAAG,OAAO,CAAC;IAqC7B,CAAC;IAnCW,eAAe,CAAC,KAAa;QACrC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAES,wBAAwB,CAAC,KAAkB,EAAE,WAAuC;QAC5F,OAAO,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAES,qBAAqB,CAAC,KAAkB;QAChD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,cAAc,CAAC,WAAuC;;QAC9D,OAAO,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,EAAE,CAAC;IACnC,CAAC;IAES,oBAAoB,CAAC,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,sBAAsB;QAC9B,OAAO,mFAAmF,CAAC;IAC7F,CAAC;IAES,0BAA0B;QAClC,OAAO,+EAA+E,CAAC;IACzF,CAAC;CACF","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"]}
1	+ {"version":3,"file":"IosCrashReportingInstrumentation.js","sourceRoot":"","sources":["../../../../../src/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,sCAAsC,EAAE,MAAM,2CAA2C,CAAC;AAGnG,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAA4B,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gCAAiC,SAAQ,sCAAsC;IAA5F;;QACW,SAAI,GAAG,sDAAsD,CAAC;QAC9D,YAAO,GAAG,OAAO,CAAC;IAqC7B,CAAC;IAnCW,eAAe,CAAC,KAAa;QACrC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAES,wBAAwB,CAAC,KAAkB,EAAE,WAAuC;QAC5F,OAAO,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAES,qBAAqB,CAAC,KAAkB;QAChD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,cAAc,CAAC,WAAuC;;QAC9D,OAAO,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,EAAE,CAAC;IACnC,CAAC;IAES,oBAAoB,CAAC,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,sBAAsB;QAC9B,OAAO,mFAAmF,CAAC;IAC7F,CAAC;IAES,0BAA0B;QAClC,OAAO,+EAA+E,CAAC;IACzF,CAAC;CACF","sourcesContent":["import { VERSION } from '@grafana/faro-core';\n\nimport { RecoveredCrashReportingInstrumentation } from '../RecoveredCrashReportingInstrumentation';\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 RecoveredCrashReportingInstrumentation {\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/esm/instrumentations/crashReporting/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/types.ts"],"names":[],"mappings":"","sourcesContent":["/*\n Crash report data structure returned from native module.\n /\nexport interface CrashReport {\n trace?: string;\n signal?: string;\n timestamp?: number;\n description?: string;\n processName?: string;\n pid?: number;\n importance?: number;\n // iOS-specific fields\n reason?: string; // Signal name (e.g., 'SIGSEGV')\n status?: number; // Exit status code\n}\n\n/\n Configuration options for crash reporting instrumentation.\n /\nexport interface CrashReportingOptions {\n /\n Enable or disable crash reporting. Defaults to true.\n /\n enabled?: boolean;\n\n /\n Optional release bundle filename hint for R8 retracing.\n * e.g., \"index.android.bundle\"\n */\n releaseBundleFilename?: string;\n}\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/instrumentations/crashReporting/types.ts"],"names":[],"mappings":"","sourcesContent":["/*\n Crash report data structure returned from native module.\n /\nexport interface CrashReport {\n reportId?: string;\n trace?: string;\n signal?: string;\n timestamp?: number;\n description?: string;\n processName?: string;\n pid?: number;\n importance?: number;\n // iOS-specific fields\n reason?: string; // Signal name (e.g., 'SIGSEGV')\n status?: number; // Exit status code\n // Recovered-crash session context\n sessionId?: string;\n isSampled?: boolean;\n appVersion?: string;\n appRelease?: string;\n appBundleId?: string;\n}\n\n/\n Configuration options for crash reporting instrumentation.\n /\nexport interface CrashReportingOptions {\n /\n Enable or disable crash reporting. Defaults to true.\n /\n enabled?: boolean;\n\n /\n Optional release bundle filename hint for R8 retracing.\n * e.g., \"index.android.bundle\"\n */\n releaseBundleFilename?: string;\n}\n"]}

package/dist/esm/instrumentations/errors/index.js CHANGED Viewed

@@ -53,8 +53,13 @@ export class ErrorsInstrumentation extends BaseInstrumentation {
         // Store the original error handler
         this.originalErrorHandler = global.ErrorUtils.getGlobalHandler();
         // Set our custom handler
-        global.ErrorUtils.setGlobalHandler((error, isFatal) => {
+        global.ErrorUtils.setGlobalHandler((thrown, isFatal) => {
             try {
+                // JS can throw any value, so normalise before the Error-shaped paths
+                // below. String() can itself throw — on a null-prototype object, or one
+                // with a throwing toString — so keep it inside the try, or finally never
+                // runs and React Native's own handler never sees the crash.
+                const error = thrown instanceof Error ? thrown : new Error(String(thrown));
                 // Check if error should be ignored
                 if (this.shouldIgnoreError(error)) {
                     return;
@@ -71,7 +76,7 @@ export class ErrorsInstrumentation extends BaseInstrumentation {
                 this.api.pushError(enhancedError, {
                     type: enhancedError.name || 'Error',
                     context,
-                    fatal: isFatal !== null && isFatal !== void 0 ? isFatal : false,
+                    fatal: isFatal,
                     stackFrames,
                 });
                 // Track error fingerprint for deduplication
@@ -85,7 +90,7 @@ export class ErrorsInstrumentation extends BaseInstrumentation {
             finally {
                 // Always call the original handler to maintain normal error behavior
                 if (this.originalErrorHandler) {
-                    this.originalErrorHandler(error, isFatal);
+                    this.originalErrorHandler(thrown, isFatal);
                 }
             }
         });

package/dist/esm/instrumentations/errors/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/errors/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ErrorUtils } from 'react-native';\n\nimport { BaseInstrumentation } from '@grafana/faro-core';\n\nimport { ErrorMechanism, primitiveUnhandledType } from './const';\nexport { ErrorMechanism } from './const';\nexport type { ErrorMechanismType } from './const';\nimport { enhanceErrorWithContext } from './stackTraceParser';\n\n// Access the global ErrorUtils\ndeclare const global: {\n ErrorUtils: ErrorUtils;\n addEventListener?: (event: string, handler: (event: PromiseRejectionEvent) => void) => void;\n removeEventListener?: (event: string, handler: (event: PromiseRejectionEvent) => void) => void;\n};\n\ntype ErrorHandlerCallback = (error: Error \| unknown, isFatal?: boolean) => void;\n\nexport interface ErrorsInstrumentationOptions {\n /*\n Patterns to ignore errors by message\n * @example [/network timeout/i, /cancelled/i]\n /\n ignoreErrors?: RegExp[];\n\n /\n Enable error deduplication (default: true)\n * Prevents sending the same error multiple times within a time window\n /\n enableDeduplication?: boolean;\n\n /\n Deduplication time window in milliseconds (default: 5000)\n * Errors with same message/stack within this window are considered duplicates\n /\n deduplicationWindow?: number;\n\n /\n Maximum number of errors to track for deduplication (default: 50)\n * Older errors are removed when this limit is reached\n /\n maxDeduplicationEntries?: number;\n\n /\n Bundle filename for Hermes/minified release lines (`func@line:col`).\n * Must match the Metro plugin source map `file` field (default `bundle.js`).\n /\n releaseBundleFilename?: string;\n}\n\ninterface ErrorFingerprint {\n message: string;\n stack: string;\n timestamp: number;\n}\n\n/\n Errors instrumentation for React Native\n \n Features:\n * - Captures unhandled errors and promise rejections using ErrorUtils\n * - Parses React Native stack traces (dev, release, Metro bundler formats)\n * - Adds platform context (OS, version, Hermes engine)\n * - Error deduplication to prevent duplicate reports\n * - Configurable error filtering\n \n @example\n * ```tsx\n * import { ErrorsInstrumentation, initializeFaro } from '@grafana/faro-react-native';\n \n await initializeFaro({\n * // ...config\n * instrumentations: [\n * new ErrorsInstrumentation({\n * ignoreErrors: [/network timeout/i, /cancelled/i],\n * enableDeduplication: true,\n * deduplicationWindow: 5000,\n * }),\n * ],\n * });\n * ```\n /\nexport class ErrorsInstrumentation extends BaseInstrumentation {\n readonly name = '@grafana/faro-react-native-errors';\n readonly version = '1.0.0';\n\n private originalErrorHandler?: ErrorHandlerCallback;\n private unhandledRejectionListener?: (event: PromiseRejectionEvent) => void;\n private options: Required<Omit<ErrorsInstrumentationOptions, 'releaseBundleFilename'>> & {\n releaseBundleFilename?: string;\n };\n private errorFingerprints: ErrorFingerprint[] = [];\n\n constructor(options: ErrorsInstrumentationOptions = {}) {\n super();\n this.options = {\n ignoreErrors: options.ignoreErrors ?? [],\n enableDeduplication: options.enableDeduplication ?? true,\n deduplicationWindow: options.deduplicationWindow ?? 5000,\n maxDeduplicationEntries: options.maxDeduplicationEntries ?? 50,\n releaseBundleFilename: options.releaseBundleFilename,\n };\n }\n\n initialize(): void {\n // Capture unhandled JavaScript errors\n this.setupGlobalErrorHandler();\n\n // Capture unhandled promise rejections\n this.setupUnhandledRejectionHandler();\n }\n\n private setupGlobalErrorHandler(): void {\n // Store the original error handler\n this.originalErrorHandler = global.ErrorUtils.getGlobalHandler();\n\n // Set our custom handler\n global.ErrorUtils.setGlobalHandler((error: Error, isFatal?: boolean) => {\n try {\n // Check if error should be ignored\n if (this.shouldIgnoreError(error)) {\n return;\n }\n\n // Check for duplicate errors\n if (this.options.enableDeduplication && this.isDuplicateError(error)) {\n return;\n }\n\n // Enhance error with React Native context and stack frames\n const {\n error: enhancedError,\n stackFrames,\n context,\n } = enhanceErrorWithContext(\n error,\n {\n mechanism: ErrorMechanism.UNCAUGHT,\n },\n { releaseBundleFilename: this.options.releaseBundleFilename }\n );\n\n // Push error to Faro with enhanced data (type from error.name, matches Web SDK)\n this.api.pushError(enhancedError, {\n type: enhancedError.name \|\| 'Error',\n context,\n fatal: isFatal ?? false,\n stackFrames,\n });\n\n // Track error fingerprint for deduplication\n if (this.options.enableDeduplication) {\n this.addErrorFingerprint(error);\n }\n } catch (_e) {\n // Don't let error reporting cause more errors\n } finally {\n // Always call the original handler to maintain normal error behavior\n if (this.originalErrorHandler) {\n this.originalErrorHandler(error, isFatal);\n }\n }\n });\n }\n\n private setupUnhandledRejectionHandler(): void {\n // React Native supports the standard unhandledrejection event\n this.unhandledRejectionListener = (event: PromiseRejectionEvent) => {\n try {\n const reason = event.reason;\n\n // Convert reason to an Error if it isn't one (matches Web SDK approach)\n const isPrimitiveRejection = !(reason instanceof Error);\n let error: Error;\n if (reason instanceof Error) {\n error = reason;\n } else {\n error = new Error(\n `Unhandled Promise Rejection: ${typeof reason === 'object' ? JSON.stringify(reason) : String(reason)}`\n );\n }\n\n // Check if error should be ignored\n if (this.shouldIgnoreError(error)) {\n return;\n }\n\n // Check for duplicate errors\n if (this.options.enableDeduplication && this.isDuplicateError(error)) {\n return;\n }\n\n // Enhance error with React Native context and stack frames\n const {\n error: enhancedError,\n stackFrames,\n context,\n } = enhanceErrorWithContext(\n error,\n {\n mechanism: ErrorMechanism.UNHANDLED_REJECTION,\n },\n { releaseBundleFilename: this.options.releaseBundleFilename }\n );\n\n // Type: use actual error type for Error objects; 'UnhandledRejection' for primitives (Web SDK)\n const errorType = isPrimitiveRejection ? primitiveUnhandledType : enhancedError.name \|\| 'Error';\n\n this.api.pushError(enhancedError, {\n type: errorType,\n context,\n fatal: false,\n stackFrames,\n });\n\n // Track error fingerprint for deduplication\n if (this.options.enableDeduplication) {\n this.addErrorFingerprint(error);\n }\n } catch (_e) {\n // Don't let error reporting cause more errors\n }\n };\n\n // Add the listener\n global.addEventListener?.('unhandledrejection', this.unhandledRejectionListener);\n }\n\n /\n Check if error should be ignored based on ignoreErrors patterns\n /\n private shouldIgnoreError(error: Error): boolean {\n if (!error \|\| !error.message) {\n return false;\n }\n\n return this.options.ignoreErrors.some((pattern) => pattern.test(error.message));\n }\n\n /\n Check if error is a duplicate based on message and stack\n /\n private isDuplicateError(error: Error): boolean {\n const message = error.message \|\| '';\n const stack = error.stack \|\| '';\n const now = Date.now();\n\n // Clean up old entries first\n this.cleanupOldFingerprints(now);\n\n // Check if we've seen this error recently\n return this.errorFingerprints.some((fingerprint) => {\n return (\n fingerprint.message === message &&\n fingerprint.stack === stack &&\n now - fingerprint.timestamp < this.options.deduplicationWindow\n );\n });\n }\n\n /\n Add error fingerprint for deduplication tracking\n /\n private addErrorFingerprint(error: Error): void {\n const message = error.message \|\| '';\n const stack = error.stack \|\| '';\n const timestamp = Date.now();\n\n this.errorFingerprints.push({ message, stack, timestamp });\n\n // Limit the number of tracked fingerprints\n if (this.errorFingerprints.length > this.options.maxDeduplicationEntries) {\n this.errorFingerprints.shift();\n }\n }\n\n /\n Remove error fingerprints older than the deduplication window\n */\n private cleanupOldFingerprints(now: number): void {\n this.errorFingerprints = this.errorFingerprints.filter(\n (fingerprint) => now - fingerprint.timestamp < this.options.deduplicationWindow\n );\n }\n\n unpatch(): void {\n // Restore original error handler\n if (this.originalErrorHandler) {\n global.ErrorUtils.setGlobalHandler(this.originalErrorHandler);\n }\n\n // Remove unhandled rejection listener\n if (this.unhandledRejectionListener) {\n global.removeEventListener?.('unhandledrejection', this.unhandledRejectionListener);\n }\n\n // Clear deduplication tracking\n this.errorFingerprints = [];\n }\n}\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/errors/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ErrorUtils } from 'react-native';\n\nimport { BaseInstrumentation } from '@grafana/faro-core';\n\nimport { ErrorMechanism, primitiveUnhandledType } from './const';\nexport { ErrorMechanism } from './const';\nexport type { ErrorMechanismType } from './const';\nimport { enhanceErrorWithContext } from './stackTraceParser';\n\n// Access the global ErrorUtils\ndeclare const global: {\n ErrorUtils: ErrorUtils;\n addEventListener?: (event: string, handler: (event: PromiseRejectionEvent) => void) => void;\n removeEventListener?: (event: string, handler: (event: PromiseRejectionEvent) => void) => void;\n};\n\n// Mirrors RN's ErrorHandler: a thrown value is not necessarily an Error, and\n// isFatal is always supplied by the runtime.\ntype ErrorHandlerCallback = (error: unknown, isFatal: boolean) => void;\n\nexport interface ErrorsInstrumentationOptions {\n /*\n Patterns to ignore errors by message\n * @example [/network timeout/i, /cancelled/i]\n /\n ignoreErrors?: RegExp[];\n\n /\n Enable error deduplication (default: true)\n * Prevents sending the same error multiple times within a time window\n /\n enableDeduplication?: boolean;\n\n /\n Deduplication time window in milliseconds (default: 5000)\n * Errors with same message/stack within this window are considered duplicates\n /\n deduplicationWindow?: number;\n\n /\n Maximum number of errors to track for deduplication (default: 50)\n * Older errors are removed when this limit is reached\n /\n maxDeduplicationEntries?: number;\n\n /\n Bundle filename for Hermes/minified release lines (`func@line:col`).\n * Must match the Metro plugin source map `file` field (default `bundle.js`).\n /\n releaseBundleFilename?: string;\n}\n\ninterface ErrorFingerprint {\n message: string;\n stack: string;\n timestamp: number;\n}\n\n/\n Errors instrumentation for React Native\n \n Features:\n * - Captures unhandled errors and promise rejections using ErrorUtils\n * - Parses React Native stack traces (dev, release, Metro bundler formats)\n * - Adds platform context (OS, version, Hermes engine)\n * - Error deduplication to prevent duplicate reports\n * - Configurable error filtering\n \n @example\n * ```tsx\n * import { ErrorsInstrumentation, initializeFaro } from '@grafana/faro-react-native';\n \n await initializeFaro({\n * // ...config\n * instrumentations: [\n * new ErrorsInstrumentation({\n * ignoreErrors: [/network timeout/i, /cancelled/i],\n * enableDeduplication: true,\n * deduplicationWindow: 5000,\n * }),\n * ],\n * });\n * ```\n /\nexport class ErrorsInstrumentation extends BaseInstrumentation {\n readonly name = '@grafana/faro-react-native-errors';\n readonly version = '1.0.0';\n\n private originalErrorHandler?: ErrorHandlerCallback;\n private unhandledRejectionListener?: (event: PromiseRejectionEvent) => void;\n private options: Required<Omit<ErrorsInstrumentationOptions, 'releaseBundleFilename'>> & {\n releaseBundleFilename?: string;\n };\n private errorFingerprints: ErrorFingerprint[] = [];\n\n constructor(options: ErrorsInstrumentationOptions = {}) {\n super();\n this.options = {\n ignoreErrors: options.ignoreErrors ?? [],\n enableDeduplication: options.enableDeduplication ?? true,\n deduplicationWindow: options.deduplicationWindow ?? 5000,\n maxDeduplicationEntries: options.maxDeduplicationEntries ?? 50,\n releaseBundleFilename: options.releaseBundleFilename,\n };\n }\n\n initialize(): void {\n // Capture unhandled JavaScript errors\n this.setupGlobalErrorHandler();\n\n // Capture unhandled promise rejections\n this.setupUnhandledRejectionHandler();\n }\n\n private setupGlobalErrorHandler(): void {\n // Store the original error handler\n this.originalErrorHandler = global.ErrorUtils.getGlobalHandler();\n\n // Set our custom handler\n global.ErrorUtils.setGlobalHandler((thrown: unknown, isFatal: boolean) => {\n try {\n // JS can throw any value, so normalise before the Error-shaped paths\n // below. String() can itself throw — on a null-prototype object, or one\n // with a throwing toString — so keep it inside the try, or finally never\n // runs and React Native's own handler never sees the crash.\n const error = thrown instanceof Error ? thrown : new Error(String(thrown));\n\n // Check if error should be ignored\n if (this.shouldIgnoreError(error)) {\n return;\n }\n\n // Check for duplicate errors\n if (this.options.enableDeduplication && this.isDuplicateError(error)) {\n return;\n }\n\n // Enhance error with React Native context and stack frames\n const {\n error: enhancedError,\n stackFrames,\n context,\n } = enhanceErrorWithContext(\n error,\n {\n mechanism: ErrorMechanism.UNCAUGHT,\n },\n { releaseBundleFilename: this.options.releaseBundleFilename }\n );\n\n // Push error to Faro with enhanced data (type from error.name, matches Web SDK)\n this.api.pushError(enhancedError, {\n type: enhancedError.name \|\| 'Error',\n context,\n fatal: isFatal,\n stackFrames,\n });\n\n // Track error fingerprint for deduplication\n if (this.options.enableDeduplication) {\n this.addErrorFingerprint(error);\n }\n } catch (_e) {\n // Don't let error reporting cause more errors\n } finally {\n // Always call the original handler to maintain normal error behavior\n if (this.originalErrorHandler) {\n this.originalErrorHandler(thrown, isFatal);\n }\n }\n });\n }\n\n private setupUnhandledRejectionHandler(): void {\n // React Native supports the standard unhandledrejection event\n this.unhandledRejectionListener = (event: PromiseRejectionEvent) => {\n try {\n const reason = event.reason;\n\n // Convert reason to an Error if it isn't one (matches Web SDK approach)\n const isPrimitiveRejection = !(reason instanceof Error);\n let error: Error;\n if (reason instanceof Error) {\n error = reason;\n } else {\n error = new Error(\n `Unhandled Promise Rejection: ${typeof reason === 'object' ? JSON.stringify(reason) : String(reason)}`\n );\n }\n\n // Check if error should be ignored\n if (this.shouldIgnoreError(error)) {\n return;\n }\n\n // Check for duplicate errors\n if (this.options.enableDeduplication && this.isDuplicateError(error)) {\n return;\n }\n\n // Enhance error with React Native context and stack frames\n const {\n error: enhancedError,\n stackFrames,\n context,\n } = enhanceErrorWithContext(\n error,\n {\n mechanism: ErrorMechanism.UNHANDLED_REJECTION,\n },\n { releaseBundleFilename: this.options.releaseBundleFilename }\n );\n\n // Type: use actual error type for Error objects; 'UnhandledRejection' for primitives (Web SDK)\n const errorType = isPrimitiveRejection ? primitiveUnhandledType : enhancedError.name \|\| 'Error';\n\n this.api.pushError(enhancedError, {\n type: errorType,\n context,\n fatal: false,\n stackFrames,\n });\n\n // Track error fingerprint for deduplication\n if (this.options.enableDeduplication) {\n this.addErrorFingerprint(error);\n }\n } catch (_e) {\n // Don't let error reporting cause more errors\n }\n };\n\n // Add the listener\n global.addEventListener?.('unhandledrejection', this.unhandledRejectionListener);\n }\n\n /\n Check if error should be ignored based on ignoreErrors patterns\n /\n private shouldIgnoreError(error: Error): boolean {\n if (!error \|\| !error.message) {\n return false;\n }\n\n return this.options.ignoreErrors.some((pattern) => pattern.test(error.message));\n }\n\n /\n Check if error is a duplicate based on message and stack\n /\n private isDuplicateError(error: Error): boolean {\n const message = error.message \|\| '';\n const stack = error.stack \|\| '';\n const now = Date.now();\n\n // Clean up old entries first\n this.cleanupOldFingerprints(now);\n\n // Check if we've seen this error recently\n return this.errorFingerprints.some((fingerprint) => {\n return (\n fingerprint.message === message &&\n fingerprint.stack === stack &&\n now - fingerprint.timestamp < this.options.deduplicationWindow\n );\n });\n }\n\n /\n Add error fingerprint for deduplication tracking\n /\n private addErrorFingerprint(error: Error): void {\n const message = error.message \|\| '';\n const stack = error.stack \|\| '';\n const timestamp = Date.now();\n\n this.errorFingerprints.push({ message, stack, timestamp });\n\n // Limit the number of tracked fingerprints\n if (this.errorFingerprints.length > this.options.maxDeduplicationEntries) {\n this.errorFingerprints.shift();\n }\n }\n\n /\n Remove error fingerprints older than the deduplication window\n */\n private cleanupOldFingerprints(now: number): void {\n this.errorFingerprints = this.errorFingerprints.filter(\n (fingerprint) => now - fingerprint.timestamp < this.options.deduplicationWindow\n );\n }\n\n unpatch(): void {\n // Restore original error handler\n if (this.originalErrorHandler) {\n global.ErrorUtils.setGlobalHandler(this.originalErrorHandler);\n }\n\n // Remove unhandled rejection listener\n if (this.unhandledRejectionListener) {\n global.removeEventListener?.('unhandledrejection', this.unhandledRejectionListener);\n }\n\n // Clear deduplication tracking\n this.errorFingerprints = [];\n }\n}\n"]}

package/dist/esm/instrumentations/frameMonitoring/instrumentation.js CHANGED Viewed

@@ -10,11 +10,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 import { BaseInstrumentation, VERSION } from '@grafana/faro-core';
 /**
- * Default configuration values matching Flutter SDK's hardcoded values.
- * These are React Native-specific advanced options for customization.
+ * Default configuration values. Frozen frame threshold aligns with Android Vitals
+ * and OpenTelemetry Android slow rendering instrumentation (700ms).
  */
 const DEFAULT_TARGET_FPS = 60;
-const DEFAULT_FROZEN_FRAME_THRESHOLD_MS = 100;
+const DEFAULT_FROZEN_FRAME_THRESHOLD_MS = 700;
 const DEFAULT_REFRESH_RATE_POLLING_INTERVAL = 30000;
 const DEFAULT_NORMALIZED_REFRESH_RATE = 60;
 /**
@@ -31,7 +31,7 @@ const DEFAULT_NORMALIZED_REFRESH_RATE = 60;
  * - Reports meaningful performance degradation that affects user experience
  *
  * ## Frozen Frame Detection
- * Frozen frames are individual frames exceeding `frozenFrameThresholdMs` (default 100ms).
+ * Frozen frames are individual frames exceeding `frozenFrameThresholdMs` (default 700ms).
  * These represent severe jank where the app appears unresponsive.
  *
  * Sends measurements via Faro API:
@@ -48,7 +48,7 @@ const DEFAULT_NORMALIZED_REFRESH_RATE = 60;
  *   instrumentations: [
  *     new FrameMonitoringInstrumentation({
  *       targetFps: 60,
- *       frozenFrameThresholdMs: 100,
+ *       frozenFrameThresholdMs: 700,
  *       refreshRatePollingInterval: 30000,
  *     }),
  *   ],
@@ -90,7 +90,7 @@ export class FrameMonitoringInstrumentation extends BaseInstrumentation {
         }
         // Start native frame monitoring with configuration
         this.startNativeMonitoring(nativeModule);
-        // Set up event listeners for real-time frame events (Android pattern)
+        // Set up Android refresh rate events (throttled on native side); frozen/slow frames use polling
         this.setupEventListeners(nativeModule);
         // Set up polling for periodic metrics collection (iOS pattern)
         this.startPolling();
@@ -118,30 +118,20 @@ export class FrameMonitoringInstrumentation extends BaseInstrumentation {
         }
     }
     setupEventListeners(nativeModule) {
-        // Android uses event-based approach for frozen frames only
-        // Slow frames are retrieved via polling (like iOS) to avoid flooding
-        if (Platform.OS === 'android') {
+        // Android: refresh rate only. Slow and frozen frames are polled (same as iOS) to avoid duplicate reports.
+        if (Platform.OS === 'android' && this.refreshRateVitalsEnabled) {
             try {
                 this.eventEmitter = new NativeEventEmitter(nativeModule);
-                // Listen for frozen frame events
-                const frozenFrameSubscription = this.eventEmitter.addListener('onFrozenFrame', (data) => {
-                    // Support both formats: number (legacy) or object (with duration)
-                    if (typeof data === 'number') {
-                        this.handleFrozenFrame(data, 0);
-                    }
-                    else {
-                        this.handleFrozenFrame(data.count, data.durationMs || 0);
+                const refreshRateSubscription = this.eventEmitter.addListener('onRefreshRate', (...args) => {
+                    const [refreshRate] = args;
+                    if (typeof refreshRate !== 'number') {
+                        this.logWarn('Ignoring onRefreshRate event without a numeric payload');
+                        return;
                     }
+                    this.handleRefreshRate(refreshRate);
                 });
-                this.eventSubscriptions.push(frozenFrameSubscription);
-                // Listen for refresh rate events (only when refreshRateVitals is enabled in config)
-                if (this.refreshRateVitalsEnabled) {
-                    const refreshRateSubscription = this.eventEmitter.addListener('onRefreshRate', (refreshRate) => {
-                        this.handleRefreshRate(refreshRate);
-                    });
-                    this.eventSubscriptions.push(refreshRateSubscription);
-                }
-                this.logDebug('Set up Android frame event listeners');
+                this.eventSubscriptions.push(refreshRateSubscription);
+                this.logDebug('Set up Android refresh rate event listener');
             }
             catch (error) {
                 this.logError('Failed to set up frame event listeners', error);
@@ -149,8 +139,7 @@ export class FrameMonitoringInstrumentation extends BaseInstrumentation {
         }
     }
     startPolling() {
-        // Both iOS and Android use polling approach for slow frames
-        // This provides consistent behavior and avoids flooding with events
+        // Both iOS and Android use polling for slow and frozen frames (avoids duplicate reports on Android).
         this.pollingIntervalId = setInterval(() => {
             this.pollFrameMetrics();
         }, this.options.refreshRatePollingInterval);
@@ -207,11 +196,7 @@ export class FrameMonitoringInstrumentation extends BaseInstrumentation {
         }, { skipDedupe: true });
     }
     handleFrozenFrame(count, durationMs) {
-        // Only send frozen frame events if duration is greater than 0
-        // This filters out any erroneous 0ms frozen frames
         if (durationMs > 0) {
-            // 🔍 TEMP DEBUG LOG - Remove after analysis
-            console.log(`[Faro DEBUG ${Platform.OS.toUpperCase()}] 🧊 SENDING frozen frame: count=${count}, duration=${durationMs}ms`);
             this.api.pushMeasurement({
                 type: 'app_frozen_frame',
                 values: {