@grafana/faro-react-native 1.2.0 → 1.3.0

package/src/instrumentations/session/sessionAttributes.ts

@@ -1,6 +1,10 @@
 import { Platform } from 'react-native';
 import DeviceInfo from 'react-native-device-info';
 
+import type { Meta } from '@grafana/faro-core';
+
+import { getInstallationId } from './installationId';
+
 /**
  * Session attributes for React Native
  * These attributes are automatically included with every telemetry event
@@ -25,22 +29,22 @@ export interface SessionAttributes {
   /** Detailed OS info (e.g., "iOS 17.0" or "Android 15 (SDK 35)") */
   device_os_detail?: string;
 
-  /** Device manufacturer (e.g., "apple", "samsung") */
+  /** Device manufacturer (e.g., "apple", "samsung", "Google") */
   device_manufacturer?: string;
 
-  /** Raw model identifier (e.g., "iPhone16,1", "SM-A155F") */
+  /** Device model in flat session attributes (e.g., "iPhone 15 Pro", "SM-A155F") */
   device_model?: string;
 
   /** Human-readable model name (e.g., "iPhone 15 Pro") */
   device_model_name?: string;
 
-  /** Device brand (e.g., "iPhone", "samsung") */
+  /** Device brand in flat session attributes (e.g., "Apple", "samsung") */
   device_brand?: string;
 
   /** Whether device is physical or emulator ("true" or "false") */
   device_is_physical?: string;
 
-  /** Unique device ID (UUID) */
+  /** Temporary flat attribute mirroring `app.installationId` during migration. */
   device_id?: string;
 
   /** Device type ("mobile" or "tablet") */
@@ -65,6 +69,11 @@ export interface SessionAttributes {
   device_carrier?: string;
 }
 
+export interface PreloadedMobileMeta {
+  sessionAttributes: SessionAttributes;
+  meta: Pick<Meta, 'app' | 'device' | 'os'>;
+}
+
 /**
  * React Native framework version from `Platform.constants` (host app runtime), not `@grafana/faro-react-native` semver.
  */
@@ -90,17 +99,42 @@ function getReactNativeVersion(): string {
   }
 }
 
-/**
- * Get device ID using react-native-device-info
- * Returns unique device identifier or 'unknown' on error
- */
-async function getDeviceId(): Promise<string> {
-  try {
-    // getUniqueId returns a UUID that persists across app installations
-    return await DeviceInfo.getUniqueId();
-  } catch (_error) {
-    return 'unknown';
+function getStructuredDeviceBrand(model: string, brand: string): string {
+  if (Platform.OS !== 'ios') {
+    return brand;
+  }
+
+  return model.toLowerCase().includes('ipad') ? 'iPad' : 'iPhone';
+}
+
+function getStructuredDeviceManufacturer(manufacturer: string): string {
+  return Platform.OS === 'ios' ? manufacturer.toLowerCase() : manufacturer;
+}
+
+function getStructuredDeviceModelIdentifier(model: string): string | undefined {
+  // Android getDeviceId() returns a board code, so use Build.MODEL for the Faro
+  // model identifier.
+  if (Platform.OS === 'android') {
+    return model;
+  }
+
+  // React Native reports iPhone and iPadOS apps as Platform.OS === 'ios'.
+  // react-native-device-info exposes the Apple hardware identifier here.
+  if (Platform.OS === 'ios') {
+    return DeviceInfo.getDeviceId();
   }
+
+  return undefined;
+}
+
+function getMobileDeviceType(isTablet: boolean): 'mobile' | 'tablet' | undefined {
+  // iPadOS is still reported as Platform.OS === 'ios'; DeviceInfo.isTablet()
+  // distinguishes iPad/tablet form factor from phone form factor.
+  if (Platform.OS === 'ios' || Platform.OS === 'android') {
+    return isTablet ? 'tablet' : 'mobile';
+  }
+
+  return undefined;
 }
 
 /**
@@ -124,6 +158,17 @@ async function getDeviceOsDetail(): Promise<string> {
   return `${systemName} ${systemVersion}`;
 }
 
+async function getDeviceOsBuildId(): Promise<string | undefined> {
+  try {
+    // RN device-info exposes a useful OS build id on both Android and iOS.
+    // Keep it omitted when unavailable instead of sending "unknown".
+    const buildId = await DeviceInfo.getBuildId();
+    return buildId && buildId !== 'unknown' ? buildId : undefined;
+  } catch (_error) {
+    return undefined;
+  }
+}
+
 /**
  * Session attributes without device props when async collection or DeviceInfo is unavailable.
  * No synchronous DeviceInfo reads — use {@link getSessionAttributes} or the package async `initializeFaro`.
@@ -151,20 +196,28 @@ export function minimalSessionDeviceAttributes(): SessionAttributes {
  * - device_carrier
  */
 export async function getSessionAttributes(): Promise<SessionAttributes> {
+  return (await collectMobileMeta()).sessionAttributes;
+}
+
+async function collectMobileMeta(): Promise<PreloadedMobileMeta> {
   try {
-    // Get device ID asynchronously
-    const deviceId = await getDeviceId();
-    const deviceOsDetail = await getDeviceOsDetail();
+    const [deviceOsDetail, deviceOsBuildId, installationId] = await Promise.all([
+      getDeviceOsDetail(),
+      getDeviceOsBuildId(),
+      getInstallationId(),
+    ]);
 
     // Get synchronous device info
     const systemName = DeviceInfo.getSystemName();
     const systemVersion = DeviceInfo.getSystemVersion();
     const manufacturer = DeviceInfo.getManufacturerSync();
     const model = DeviceInfo.getModel();
+    const modelIdentifier = getStructuredDeviceModelIdentifier(model);
     const deviceName = DeviceInfo.getDeviceNameSync();
     const brand = DeviceInfo.getBrand();
     const isEmulator = DeviceInfo.isEmulatorSync();
     const isTablet = DeviceInfo.isTablet();
+    const deviceType = getMobileDeviceType(isTablet);
 
     // Memory info
     const totalMemory = DeviceInfo.getTotalMemorySync();
@@ -221,8 +274,8 @@ export async function getSessionAttributes(): Promise<SessionAttributes> {
       device_model_name: deviceName,
       device_brand: brand,
       device_is_physical: String(!isEmulator),
-      device_id: deviceId,
-      device_type: isTablet ? 'tablet' : 'mobile',
+      ...(installationId ? { device_id: installationId } : {}),
+      ...(deviceType ? { device_type: deviceType } : {}),
       device_memory_total: String(totalMemory),
       device_memory_used: String(usedMemory),
       device_battery_level: batteryLevel,
@@ -230,20 +283,57 @@ export async function getSessionAttributes(): Promise<SessionAttributes> {
       device_low_power_mode: lowPowerMode,
       device_carrier: carrier,
     };
+    const appMeta = installationId ? { installationId } : {};
+    const structuredDeviceBrand = getStructuredDeviceBrand(model, brand);
+    const structuredDeviceManufacturer = getStructuredDeviceManufacturer(manufacturer);
+    const osMeta = {
+      ...(deviceOsBuildId ? { build_id: deviceOsBuildId } : {}),
+      detail: deviceOsDetail,
+      name: systemName,
+      version: systemVersion,
+    };
 
-    return attributes;
+    return {
+      sessionAttributes: attributes,
+      meta: {
+        app: appMeta,
+        device: {
+          brand: structuredDeviceBrand,
+          is_physical: !isEmulator,
+          manufacturer: structuredDeviceManufacturer,
+          ...(modelIdentifier ? { model_identifier: modelIdentifier } : {}),
+          model_name: model,
+          ...(deviceType ? { type: deviceType } : {}),
+        },
+        os: osMeta,
+      },
+    };
   } catch (_error) {
-    return minimalSessionDeviceAttributes();
+    const installationId = await getInstallationId();
+
+    return {
+      sessionAttributes: minimalSessionDeviceAttributes(),
+      meta: {
+        app: installationId ? { installationId } : {},
+      },
+    };
   }
 }
 
+/**
+ * Get structured mobile meta plus flat session attributes for async `initializeFaro`.
+ */
+export async function loadMobileMetaForInit(): Promise<PreloadedMobileMeta> {
+  return collectMobileMeta();
+}
+
 /**
  * Await full async session device attributes (battery, carrier, etc.), then fall back to
  * {@link minimalSessionDeviceAttributes} if anything throws. Used by async `initializeFaro`.
  */
 export async function loadSessionDeviceAttributesForInit(): Promise<SessionAttributes> {
   try {
-    return await getSessionAttributes();
+    return (await loadMobileMetaForInit()).sessionAttributes;
   } catch {
     return minimalSessionDeviceAttributes();
   }

package/src/metas/appBuildIdentity.test.ts

@@ -0,0 +1,48 @@
+import DeviceInfo from 'react-native-device-info';
+
+import { formatSymbolsBundleId, loadAppSymbolsBundleIdForInit } from './appBuildIdentity';
+
+describe('formatSymbolsBundleId', () => {
+  it('joins applicationId, versionCode and versionName with @', () => {
+    expect(formatSymbolsBundleId('com.example.myapp', '42', '1.0.0')).toBe('com.example.myapp@42@1.0.0');
+  });
+});
+
+describe('loadAppSymbolsBundleIdForInit', () => {
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('maps DeviceInfo build info to an encoded bundle id', async () => {
+    const bundleId = await loadAppSymbolsBundleIdForInit();
+
+    expect(bundleId).toBe('com.example.myapp@42@1.0.0');
+  });
+
+  it('coerces a numeric build number to a string in the bundle id', async () => {
+    (DeviceInfo.getBuildNumber as jest.Mock).mockReturnValueOnce(7);
+
+    const bundleId = await loadAppSymbolsBundleIdForInit();
+
+    expect(bundleId).toBe('com.example.myapp@7@1.0.0');
+  });
+
+  it('returns undefined when required fields are missing', async () => {
+    (DeviceInfo.getBundleId as jest.Mock).mockReturnValueOnce('');
+    (DeviceInfo.getBuildNumber as jest.Mock).mockReturnValueOnce('');
+
+    const bundleId = await loadAppSymbolsBundleIdForInit();
+
+    expect(bundleId).toBeUndefined();
+  });
+
+  it('returns undefined when DeviceInfo throws', async () => {
+    (DeviceInfo.getBundleId as jest.Mock).mockImplementationOnce(() => {
+      throw new Error('not available');
+    });
+
+    const bundleId = await loadAppSymbolsBundleIdForInit();
+
+    expect(bundleId).toBeUndefined();
+  });
+});

package/src/metas/appBuildIdentity.ts

@@ -0,0 +1,50 @@
+import DeviceInfo from 'react-native-device-info';
+
+import { globalObject } from '@grafana/faro-core';
+
+const BUNDLE_ID_SEPARATOR = '@';
+
+/** Metro / webpack preamble bundle id for JS source maps (`__faroBundleId_<appName>`). */
+export function getMetroInjectedBundleId(appName: string | undefined): string | undefined {
+  if (!appName) {
+    return undefined;
+  }
+  const key = `__faroBundleId_${appName}`;
+  const fromGlobal = (globalObject as Record<string, unknown>)[key];
+  if (typeof fromGlobal === 'string' && fromGlobal !== '') {
+    return fromGlobal;
+  }
+  return undefined;
+}
+
+/**
+ * Encodes the Android/iOS build identity used as `meta.app.bundleId` for
+ * server-side symbol retrace. Must match the symbols upload bundle id
+ * (`{applicationId}@{versionCode}@{versionName}`).
+ */
+export function formatSymbolsBundleId(applicationId: string, versionCode: string, versionName: string): string {
+  return `${applicationId}${BUNDLE_ID_SEPARATOR}${versionCode}${BUNDLE_ID_SEPARATOR}${versionName}`;
+}
+
+/**
+ * Reads the installed build's identity from `react-native-device-info` and
+ * returns the encoded bundle id when all parts are available.
+ *
+ * Values must match what the symbol uploader (Gradle plugin / faro-cli) sends
+ * for the same build so the collector can locate the mapping for retrace.
+ */
+export async function loadAppSymbolsBundleIdForInit(): Promise<string | undefined> {
+  try {
+    const applicationId = DeviceInfo.getBundleId();
+    const versionName = DeviceInfo.getVersion();
+    const versionCodeRaw = DeviceInfo.getBuildNumber();
+
+    if (!applicationId || versionCodeRaw === '' || versionCodeRaw == null || !versionName) {
+      return undefined;
+    }
+
+    return formatSymbolsBundleId(applicationId, String(versionCodeRaw), versionName);
+  } catch {
+    return undefined;
+  }
+}

package/src/testUtils/mockDeviceInfo.ts

@@ -6,10 +6,15 @@ export function mockDeviceInfo(): void {
     default: {
       getBrand: jest.fn(() => 'Apple'),
       getDeviceId: jest.fn(() => 'iPhone14,2'),
+      getDeviceNameSync: jest.fn(() => "Test's iPhone"),
+      getUniqueId: jest.fn(() => Promise.resolve('test-device-id')),
       getModel: jest.fn(() => 'iPhone 13 Pro'),
+      getManufacturerSync: jest.fn(() => 'Apple'),
       getSystemName: jest.fn(() => 'iOS'),
       getSystemVersion: jest.fn(() => '16.0'),
       getVersion: jest.fn(() => '1.0.0'),
+      getApiLevel: jest.fn(() => Promise.resolve(35)),
+      getBuildId: jest.fn(() => Promise.resolve('22B83')),
       isTablet: jest.fn(() => false),
       isEmulatorSync: jest.fn(() => false),
       getTotalMemorySync: jest.fn(() => 6442450944), // 6GB in bytes

package/src/testUtils/setupTests.ts

@@ -8,10 +8,17 @@ jest.mock('react-native-device-info', () => {
   const mockDeviceInfo = {
     getBrand: jest.fn(() => 'Apple'),
     getDeviceId: jest.fn(() => 'iPhone14,2'),
+    getDeviceNameSync: jest.fn(() => "Test's iPhone"),
+    getUniqueId: jest.fn(() => Promise.resolve('test-device-id')),
     getModel: jest.fn(() => 'iPhone 13 Pro'),
+    getManufacturerSync: jest.fn(() => 'Apple'),
     getSystemName: jest.fn(() => 'iOS'),
     getSystemVersion: jest.fn(() => '16.0'),
     getVersion: jest.fn(() => '1.0.0'),
+    getBundleId: jest.fn(() => 'com.example.myapp'),
+    getBuildNumber: jest.fn(() => '42'),
+    getApiLevel: jest.fn(() => Promise.resolve(35)),
+    getBuildId: jest.fn(() => Promise.resolve('22B83')),
     isTablet: jest.fn(() => false),
     isEmulatorSync: jest.fn(() => false),
     getTotalMemorySync: jest.fn(() => 6442450944), // 6GB in bytes

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

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

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

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

package/dist/types/instrumentations/crashReporting/instrumentation.d.ts

@@ -1,58 +0,0 @@
-import { BaseInstrumentation } from '@grafana/faro-core';
-import type { CrashReportingOptions } from './types';
-/**
- * Crash Reporting Instrumentation (Experimental).
- *
- * Retrieves crash reports from previous app sessions and sends them via Faro API.
- *
- * **Platform Support**:
- * - **Android**: Uses ApplicationExitInfo API (Android 11+ / API 30+)
- *   Captures: CRASH, CRASH_NATIVE, ANR, LOW_MEMORY, EXCESSIVE_RESOURCE_USAGE
- * - **iOS**: Uses PLCrashReporter (requires adding dependency to podspec)
- *   Captures: Signal crashes (SIGSEGV, SIGABRT, etc.) and Mach exceptions
- *
- * **Note**: This instrumentation only retrieves crash data from previous sessions.
- * The crash itself terminates the app, so the report is sent on next app launch.
- *
- * @example
- * ```typescript
- * import { initializeFaro, CrashReportingInstrumentation } from '@grafana/faro-react-native';
- *
- * initializeFaro({
- *   url: 'https://collector.example.com',
- *   instrumentations: [
- *     new CrashReportingInstrumentation(),
- *   ],
- * });
- * ```
- */
-export declare class CrashReportingInstrumentation extends BaseInstrumentation {
-    readonly name = "@grafana/faro-react-native:instrumentation-crash";
-    readonly version = "2.3.1";
-    private readonly options;
-    constructor(options?: CrashReportingOptions);
-    initialize(): Promise<void>;
-    /**
-     * Wait for session attributes to be populated.
-     *
-     * Crash reports are sent in a new session, so we need to wait for
-     * SessionInstrumentation to finish collecting device info, OS version, etc.
-     * before sending the crash report. Otherwise, the crash report will be missing
-     * session metadata.
-     *
-     * This checks for multiple device-specific attributes that are collected
-     * asynchronously (device_id, device_os_detail, device_model_name) to ensure
-     * the async getSessionAttributes() call has completed.
-     *
-     * @param maxWaitMs Maximum time to wait in milliseconds (default 10000ms)
-     */
-    private waitForSessionAttributes;
-    private getNativeModule;
-    private processCrashReports;
-    private sendCrashReport;
-    /**
-     * Build error message matching Flutter SDK format:
-     * "{reason}: {description}, status: {status}"
-     */
-    private getErrorMessage;
-}