@grafana/faro-react-native 1.1.0 → 1.2.0

package/dist/esm/instrumentations/errors/stackTraceParser.js

@@ -21,67 +21,113 @@ const REACT_NATIVE_RELEASE_REGEX = /^(.+?)@(\d+):(\d+)$/;
 const REACT_NATIVE_ANONYMOUS_REGEX = /^\s*at\s+anonymous\s+\((.+?):(\d+):(\d+)\)$/;
 const METRO_BUNDLER_REGEX = /^\s*at\s+(?:Object\.)?(.+?)\s+\((.+?):(\d+):(\d+)\)$/;
 /**
- * Parse a single stack trace line into a structured frame
+ * Hermes (Android release) often reports the bundle segment as `address at index.android.bundle`
+ * inside parentheses. The collector hashes `frame.filename` for uploaded maps; it must match the
+ * source map `file` field (e.g. `index.android.bundle`), not the verbose Hermes label.
  */
-export function parseStackTraceLine(line) {
+export function normalizeHermesStackFilename(filename) {
+    var _a, _b;
+    const trimmed = filename.trim();
+    const m = /^address\s+at\s+(.+)$/i.exec(trimmed);
+    return (_b = (_a = m === null || m === void 0 ? void 0 : m[1]) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : filename;
+}
+/**
+ * iOS Simulator (and Android) stacks often carry full filesystem paths such as
+ * `…/Foo.app/main.jsbundle` while uploaded maps are keyed by the bundle basename (`main.jsbundle`)
+ * that matches Metro’s source map `file` field — same as ingest’s bundle lookup hashes.
+ */
+function collapseBundledArtifactPath(filename, releaseBasename) {
+    const key = releaseBasename.trim();
+    if (!key || filename === key) {
+        return filename;
+    }
+    const suffix = `/${key}`;
+    return filename.endsWith(suffix) ? key : filename;
+}
+const UNKNOWN_RELEASE_FILENAME = '<unknown>';
+/**
+ * Parse a single stack trace line into a structured frame and record how it was parsed.
+ */
+function parseStackTraceLineDetailed(line) {
     if (!line || typeof line !== 'string') {
-        return null;
+        return { frame: null, kind: 'unparsed' };
     }
     const trimmedLine = line.trim();
     if (!trimmedLine) {
-        return null;
+        return { frame: null, kind: 'unparsed' };
     }
     // Try standard React Native format: at functionName (file.js:123:45)
     let match = trimmedLine.match(REACT_NATIVE_STACK_REGEX);
     if (match && match[2] && match[3] && match[4]) {
         return {
-            function: match[1] || '<anonymous>',
-            filename: match[2],
-            lineno: parseInt(match[3], 10),
-            colno: parseInt(match[4], 10),
+            kind: 'react_native_paren',
+            frame: {
+                function: match[1] || '<anonymous>',
+                filename: normalizeHermesStackFilename(match[2]),
+                lineno: parseInt(match[3], 10),
+                colno: parseInt(match[4], 10),
+            },
         };
     }
     // Try Metro bundler format: at Object.functionName (/path/to/file.js:123:456)
     match = trimmedLine.match(METRO_BUNDLER_REGEX);
     if (match && match[2] && match[3] && match[4]) {
         return {
-            function: match[1] || '<anonymous>',
-            filename: match[2],
-            lineno: parseInt(match[3], 10),
-            colno: parseInt(match[4], 10),
+            kind: 'metro_paren',
+            frame: {
+                function: match[1] || '<anonymous>',
+                filename: normalizeHermesStackFilename(match[2]),
+                lineno: parseInt(match[3], 10),
+                colno: parseInt(match[4], 10),
+            },
         };
     }
     // Try anonymous format: at anonymous (file.js:123:45)
     match = trimmedLine.match(REACT_NATIVE_ANONYMOUS_REGEX);
     if (match && match[1] && match[2] && match[3]) {
         return {
-            function: '<anonymous>',
-            filename: match[1],
-            lineno: parseInt(match[2], 10),
-            colno: parseInt(match[3], 10),
+            kind: 'anonymous_paren',
+            frame: {
+                function: '<anonymous>',
+                filename: normalizeHermesStackFilename(match[1]),
+                lineno: parseInt(match[2], 10),
+                colno: parseInt(match[3], 10),
+            },
         };
     }
     // Try native format: at functionName (native)
     match = trimmedLine.match(REACT_NATIVE_NATIVE_REGEX);
     if (match) {
         return {
-            function: match[1] || '<native>',
-            filename: '<native>',
-            isNative: true,
+            kind: 'native',
+            frame: {
+                function: match[1] || '<native>',
+                filename: '<native>',
+                isNative: true,
+            },
         };
     }
     // Try release/minified format: functionName@123:456
     match = trimmedLine.match(REACT_NATIVE_RELEASE_REGEX);
     if (match && match[2] && match[3]) {
         return {
-            function: match[1] || '<anonymous>',
-            filename: '<unknown>',
-            lineno: parseInt(match[2], 10),
-            colno: parseInt(match[3], 10),
+            kind: 'release_func_at',
+            frame: {
+                function: match[1] || '<anonymous>',
+                filename: UNKNOWN_RELEASE_FILENAME,
+                lineno: parseInt(match[2], 10),
+                colno: parseInt(match[3], 10),
+                releaseLine: true,
+            },
         };
     }
-    // Couldn't parse this line
-    return null;
+    return { frame: null, kind: 'unparsed' };
+}
+/**
+ * Parse a single stack trace line into a structured frame
+ */
+export function parseStackTraceLine(line) {
+    return parseStackTraceLineDetailed(line).frame;
 }
 /**
  * Parse a full stack trace string into an array of structured frames
@@ -93,7 +139,7 @@ export function parseStackTrace(stackTrace) {
     const lines = stackTrace.split('\n');
     const frames = [];
     for (const line of lines) {
-        const frame = parseStackTraceLine(line);
+        const { frame } = parseStackTraceLineDetailed(line);
         if (frame) {
             frames.push(frame);
         }
@@ -103,24 +149,38 @@ export function parseStackTrace(stackTrace) {
 /**
  * Convert parsed stack frames to Faro's StackFrame format
  */
-export function toFaroStackFrames(parsedFrames) {
-    return parsedFrames.map((frame, _index) => ({
-        filename: frame.filename || '<unknown>',
-        function: frame.function || '<anonymous>',
-        lineno: frame.lineno,
-        colno: frame.colno,
-    }));
+export function toFaroStackFrames(parsedFrames, options) {
+    var _a;
+    const releaseName = (_a = options === null || options === void 0 ? void 0 : options.releaseBundleFilename) !== null && _a !== void 0 ? _a : 'bundle.js';
+    const keyedBasename = typeof (options === null || options === void 0 ? void 0 : options.releaseBundleFilename) === 'string' && options.releaseBundleFilename.trim() !== ''
+        ? options.releaseBundleFilename.trim()
+        : null;
+    return parsedFrames.map((frame, _index) => {
+        let filename = normalizeHermesStackFilename(frame.filename || '<unknown>');
+        if (frame.releaseLine) {
+            filename = releaseName;
+        }
+        else if (keyedBasename) {
+            filename = collapseBundledArtifactPath(filename, keyedBasename);
+        }
+        return {
+            filename,
+            function: frame.function || '<anonymous>',
+            lineno: frame.lineno,
+            colno: frame.colno,
+        };
+    });
 }
 /**
  * Extract and parse stack frames from an Error object
  */
-export function getStackFramesFromError(error) {
+export function getStackFramesFromError(error, options) {
     if (!error || !error.stack) {
         return [];
     }
     try {
         const parsedFrames = parseStackTrace(error.stack);
-        return toFaroStackFrames(parsedFrames);
+        return toFaroStackFrames(parsedFrames, options);
     }
     catch (_e) {
         // If parsing fails, return empty array
@@ -141,8 +201,8 @@ export function getPlatformErrorContext() {
 /**
  * Enhance error with React Native specific information
  */
-export function enhanceErrorWithContext(error, additionalContext) {
-    const stackFrames = getStackFramesFromError(error);
+export function enhanceErrorWithContext(error, additionalContext, stackParseOptions) {
+    const stackFrames = getStackFramesFromError(error, stackParseOptions);
     const platformContext = getPlatformErrorContext();
     return {
         error,

package/dist/esm/instrumentations/errors/stackTraceParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"stackTraceParser.js","sourceRoot":"","sources":["../../../../src/instrumentations/errors/stackTraceParser.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\nimport type { ExceptionStackFrame as StackFrame } from '@grafana/faro-core';\n\n// Declare global Hermes runtime\ndeclare const HermesInternal: object | undefined;\n\n/**\n * Parse React Native stack traces into structured stack frames\n *\n * React Native stack traces have different formats depending on platform and environment:\n *\n * iOS/Android (Dev):\n *   at functionName (file.js:123:45)\n *   at anonymous (native)\n *\n * iOS/Android (Release):\n *   functionName@123:456\n *   @[native code]\n *\n * Metro bundler:\n *   at Object.functionName (/path/to/file.js:123:456)\n */\n\nconst REACT_NATIVE_STACK_REGEX = /^\\s*at\\s+(.+?)\\s+\\((.+?):(\\d+):(\\d+)\\)$/;\nconst REACT_NATIVE_NATIVE_REGEX = /^\\s*at\\s+(.+?)\\s+\\(native\\)$/;\nconst REACT_NATIVE_RELEASE_REGEX = /^(.+?)@(\\d+):(\\d+)$/;\nconst REACT_NATIVE_ANONYMOUS_REGEX = /^\\s*at\\s+anonymous\\s+\\((.+?):(\\d+):(\\d+)\\)$/;\nconst METRO_BUNDLER_REGEX = /^\\s*at\\s+(?:Object\\.)?(.+?)\\s+\\((.+?):(\\d+):(\\d+)\\)$/;\n\nexport interface ParsedStackFrame {\n  function?: string;\n  filename?: string;\n  lineno?: number;\n  colno?: number;\n  isNative?: boolean;\n}\n\n/**\n * Parse a single stack trace line into a structured frame\n */\nexport function parseStackTraceLine(line: string): ParsedStackFrame | null {\n  if (!line || typeof line !== 'string') {\n    return null;\n  }\n\n  const trimmedLine = line.trim();\n  if (!trimmedLine) {\n    return null;\n  }\n\n  // Try standard React Native format: at functionName (file.js:123:45)\n  let match = trimmedLine.match(REACT_NATIVE_STACK_REGEX);\n  if (match && match[2] && match[3] && match[4]) {\n    return {\n      function: match[1] || '<anonymous>',\n      filename: match[2],\n      lineno: parseInt(match[3], 10),\n      colno: parseInt(match[4], 10),\n    };\n  }\n\n  // Try Metro bundler format: at Object.functionName (/path/to/file.js:123:456)\n  match = trimmedLine.match(METRO_BUNDLER_REGEX);\n  if (match && match[2] && match[3] && match[4]) {\n    return {\n      function: match[1] || '<anonymous>',\n      filename: match[2],\n      lineno: parseInt(match[3], 10),\n      colno: parseInt(match[4], 10),\n    };\n  }\n\n  // Try anonymous format: at anonymous (file.js:123:45)\n  match = trimmedLine.match(REACT_NATIVE_ANONYMOUS_REGEX);\n  if (match && match[1] && match[2] && match[3]) {\n    return {\n      function: '<anonymous>',\n      filename: match[1],\n      lineno: parseInt(match[2], 10),\n      colno: parseInt(match[3], 10),\n    };\n  }\n\n  // Try native format: at functionName (native)\n  match = trimmedLine.match(REACT_NATIVE_NATIVE_REGEX);\n  if (match) {\n    return {\n      function: match[1] || '<native>',\n      filename: '<native>',\n      isNative: true,\n    };\n  }\n\n  // Try release/minified format: functionName@123:456\n  match = trimmedLine.match(REACT_NATIVE_RELEASE_REGEX);\n  if (match && match[2] && match[3]) {\n    return {\n      function: match[1] || '<anonymous>',\n      filename: '<unknown>',\n      lineno: parseInt(match[2], 10),\n      colno: parseInt(match[3], 10),\n    };\n  }\n\n  // Couldn't parse this line\n  return null;\n}\n\n/**\n * Parse a full stack trace string into an array of structured frames\n */\nexport function parseStackTrace(stackTrace: string): ParsedStackFrame[] {\n  if (!stackTrace || typeof stackTrace !== 'string') {\n    return [];\n  }\n\n  const lines = stackTrace.split('\\n');\n  const frames: ParsedStackFrame[] = [];\n\n  for (const line of lines) {\n    const frame = parseStackTraceLine(line);\n    if (frame) {\n      frames.push(frame);\n    }\n  }\n\n  return frames;\n}\n\n/**\n * Convert parsed stack frames to Faro's StackFrame format\n */\nexport function toFaroStackFrames(parsedFrames: ParsedStackFrame[]): StackFrame[] {\n  return parsedFrames.map((frame, _index) => ({\n    filename: frame.filename || '<unknown>',\n    function: frame.function || '<anonymous>',\n    lineno: frame.lineno,\n    colno: frame.colno,\n  }));\n}\n\n/**\n * Extract and parse stack frames from an Error object\n */\nexport function getStackFramesFromError(error: Error): StackFrame[] {\n  if (!error || !error.stack) {\n    return [];\n  }\n\n  try {\n    const parsedFrames = parseStackTrace(error.stack);\n    return toFaroStackFrames(parsedFrames);\n  } catch (_e) {\n    // If parsing fails, return empty array\n    return [];\n  }\n}\n\n/**\n * Get platform-specific error context\n */\nexport function getPlatformErrorContext(): Record<string, string> {\n  return {\n    platform: Platform.OS,\n    platformVersion: Platform.Version?.toString() || 'unknown',\n    isHermes: typeof HermesInternal !== 'undefined' ? 'true' : 'false',\n  };\n}\n\n/**\n * Enhance error with React Native specific information\n */\nexport function enhanceErrorWithContext(\n  error: Error,\n  additionalContext?: Record<string, string>\n): {\n  error: Error;\n  stackFrames: StackFrame[];\n  context: Record<string, string>;\n} {\n  const stackFrames = getStackFramesFromError(error);\n  const platformContext = getPlatformErrorContext();\n\n  return {\n    error,\n    stackFrames,\n    context: {\n      ...platformContext,\n      ...additionalContext,\n    },\n  };\n}\n"]}
+{"version":3,"file":"stackTraceParser.js","sourceRoot":"","sources":["../../../../src/instrumentations/errors/stackTraceParser.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\nimport type { ExceptionStackFrame as StackFrame } from '@grafana/faro-core';\n\n// Declare global Hermes runtime\ndeclare const HermesInternal: object | undefined;\n\n/**\n * Parse React Native stack traces into structured stack frames\n *\n * React Native stack traces have different formats depending on platform and environment:\n *\n * iOS/Android (Dev):\n *   at functionName (file.js:123:45)\n *   at anonymous (native)\n *\n * iOS/Android (Release):\n *   functionName@123:456\n *   @[native code]\n *\n * Metro bundler:\n *   at Object.functionName (/path/to/file.js:123:456)\n */\n\nconst REACT_NATIVE_STACK_REGEX = /^\\s*at\\s+(.+?)\\s+\\((.+?):(\\d+):(\\d+)\\)$/;\nconst REACT_NATIVE_NATIVE_REGEX = /^\\s*at\\s+(.+?)\\s+\\(native\\)$/;\nconst REACT_NATIVE_RELEASE_REGEX = /^(.+?)@(\\d+):(\\d+)$/;\nconst REACT_NATIVE_ANONYMOUS_REGEX = /^\\s*at\\s+anonymous\\s+\\((.+?):(\\d+):(\\d+)\\)$/;\nconst METRO_BUNDLER_REGEX = /^\\s*at\\s+(?:Object\\.)?(.+?)\\s+\\((.+?):(\\d+):(\\d+)\\)$/;\n\n/**\n * Hermes (Android release) often reports the bundle segment as `address at index.android.bundle`\n * inside parentheses. The collector hashes `frame.filename` for uploaded maps; it must match the\n * source map `file` field (e.g. `index.android.bundle`), not the verbose Hermes label.\n */\nexport function normalizeHermesStackFilename(filename: string): string {\n  const trimmed = filename.trim();\n  const m = /^address\\s+at\\s+(.+)$/i.exec(trimmed);\n  return m?.[1]?.trim() ?? filename;\n}\n\n/**\n * iOS Simulator (and Android) stacks often carry full filesystem paths such as\n * `…/Foo.app/main.jsbundle` while uploaded maps are keyed by the bundle basename (`main.jsbundle`)\n * that matches Metro’s source map `file` field — same as ingest’s bundle lookup hashes.\n */\nfunction collapseBundledArtifactPath(filename: string, releaseBasename: string): string {\n  const key = releaseBasename.trim();\n  if (!key || filename === key) {\n    return filename;\n  }\n  const suffix = `/${key}`;\n  return filename.endsWith(suffix) ? key : filename;\n}\n\nexport interface ParsedStackFrame {\n  function?: string;\n  filename?: string;\n  lineno?: number;\n  colno?: number;\n  isNative?: boolean;\n  /** Set when the line matched Hermes/minified `func@line:col` (no path). */\n  releaseLine?: boolean;\n}\n\n/** Which parser branch handled a stack line (internal). */\ntype ParsedStackLineKind =\n  | 'react_native_paren'\n  | 'metro_paren'\n  | 'anonymous_paren'\n  | 'native'\n  | 'release_func_at'\n  | 'unparsed';\n\nconst UNKNOWN_RELEASE_FILENAME = '<unknown>';\n\nexport interface StackFrameParseOptions {\n  /**\n   * Hermes / minified RN release lines use `func@line:col` with no file path. Those frames are tagged\n   * with `releaseLine` and use this as `filename` (default `bundle.js`). Match the Metro plugin’s\n   * source map `file` field (or `sourceMapFile` option there).\n   */\n  releaseBundleFilename?: string;\n}\n\n/**\n * Parse a single stack trace line into a structured frame and record how it was parsed.\n */\nfunction parseStackTraceLineDetailed(line: string): { frame: ParsedStackFrame | null; kind: ParsedStackLineKind } {\n  if (!line || typeof line !== 'string') {\n    return { frame: null, kind: 'unparsed' };\n  }\n\n  const trimmedLine = line.trim();\n  if (!trimmedLine) {\n    return { frame: null, kind: 'unparsed' };\n  }\n\n  // Try standard React Native format: at functionName (file.js:123:45)\n  let match = trimmedLine.match(REACT_NATIVE_STACK_REGEX);\n  if (match && match[2] && match[3] && match[4]) {\n    return {\n      kind: 'react_native_paren',\n      frame: {\n        function: match[1] || '<anonymous>',\n        filename: normalizeHermesStackFilename(match[2]),\n        lineno: parseInt(match[3], 10),\n        colno: parseInt(match[4], 10),\n      },\n    };\n  }\n\n  // Try Metro bundler format: at Object.functionName (/path/to/file.js:123:456)\n  match = trimmedLine.match(METRO_BUNDLER_REGEX);\n  if (match && match[2] && match[3] && match[4]) {\n    return {\n      kind: 'metro_paren',\n      frame: {\n        function: match[1] || '<anonymous>',\n        filename: normalizeHermesStackFilename(match[2]),\n        lineno: parseInt(match[3], 10),\n        colno: parseInt(match[4], 10),\n      },\n    };\n  }\n\n  // Try anonymous format: at anonymous (file.js:123:45)\n  match = trimmedLine.match(REACT_NATIVE_ANONYMOUS_REGEX);\n  if (match && match[1] && match[2] && match[3]) {\n    return {\n      kind: 'anonymous_paren',\n      frame: {\n        function: '<anonymous>',\n        filename: normalizeHermesStackFilename(match[1]),\n        lineno: parseInt(match[2], 10),\n        colno: parseInt(match[3], 10),\n      },\n    };\n  }\n\n  // Try native format: at functionName (native)\n  match = trimmedLine.match(REACT_NATIVE_NATIVE_REGEX);\n  if (match) {\n    return {\n      kind: 'native',\n      frame: {\n        function: match[1] || '<native>',\n        filename: '<native>',\n        isNative: true,\n      },\n    };\n  }\n\n  // Try release/minified format: functionName@123:456\n  match = trimmedLine.match(REACT_NATIVE_RELEASE_REGEX);\n  if (match && match[2] && match[3]) {\n    return {\n      kind: 'release_func_at',\n      frame: {\n        function: match[1] || '<anonymous>',\n        filename: UNKNOWN_RELEASE_FILENAME,\n        lineno: parseInt(match[2], 10),\n        colno: parseInt(match[3], 10),\n        releaseLine: true,\n      },\n    };\n  }\n\n  return { frame: null, kind: 'unparsed' };\n}\n\n/**\n * Parse a single stack trace line into a structured frame\n */\nexport function parseStackTraceLine(line: string): ParsedStackFrame | null {\n  return parseStackTraceLineDetailed(line).frame;\n}\n\n/**\n * Parse a full stack trace string into an array of structured frames\n */\nexport function parseStackTrace(stackTrace: string): ParsedStackFrame[] {\n  if (!stackTrace || typeof stackTrace !== 'string') {\n    return [];\n  }\n\n  const lines = stackTrace.split('\\n');\n  const frames: ParsedStackFrame[] = [];\n\n  for (const line of lines) {\n    const { frame } = parseStackTraceLineDetailed(line);\n    if (frame) {\n      frames.push(frame);\n    }\n  }\n\n  return frames;\n}\n\n/**\n * Convert parsed stack frames to Faro's StackFrame format\n */\nexport function toFaroStackFrames(parsedFrames: ParsedStackFrame[], options?: StackFrameParseOptions): StackFrame[] {\n  const releaseName = options?.releaseBundleFilename ?? 'bundle.js';\n  const keyedBasename =\n    typeof options?.releaseBundleFilename === 'string' && options.releaseBundleFilename.trim() !== ''\n      ? options.releaseBundleFilename.trim()\n      : null;\n\n  return parsedFrames.map((frame, _index) => {\n    let filename = normalizeHermesStackFilename(frame.filename || '<unknown>');\n    if (frame.releaseLine) {\n      filename = releaseName;\n    } else if (keyedBasename) {\n      filename = collapseBundledArtifactPath(filename, keyedBasename);\n    }\n    return {\n      filename,\n      function: frame.function || '<anonymous>',\n      lineno: frame.lineno,\n      colno: frame.colno,\n    };\n  });\n}\n\n/**\n * Extract and parse stack frames from an Error object\n */\nexport function getStackFramesFromError(error: Error, options?: StackFrameParseOptions): StackFrame[] {\n  if (!error || !error.stack) {\n    return [];\n  }\n\n  try {\n    const parsedFrames = parseStackTrace(error.stack);\n    return toFaroStackFrames(parsedFrames, options);\n  } catch (_e) {\n    // If parsing fails, return empty array\n    return [];\n  }\n}\n\n/**\n * Get platform-specific error context\n */\nexport function getPlatformErrorContext(): Record<string, string> {\n  return {\n    platform: Platform.OS,\n    platformVersion: Platform.Version?.toString() || 'unknown',\n    isHermes: typeof HermesInternal !== 'undefined' ? 'true' : 'false',\n  };\n}\n\n/**\n * Enhance error with React Native specific information\n */\nexport function enhanceErrorWithContext(\n  error: Error,\n  additionalContext?: Record<string, string>,\n  stackParseOptions?: StackFrameParseOptions\n): {\n  error: Error;\n  stackFrames: StackFrame[];\n  context: Record<string, string>;\n} {\n  const stackFrames = getStackFramesFromError(error, stackParseOptions);\n  const platformContext = getPlatformErrorContext();\n\n  return {\n    error,\n    stackFrames,\n    context: {\n      ...platformContext,\n      ...additionalContext,\n    },\n  };\n}\n"]}

package/dist/types/config/types.d.ts

@@ -62,6 +62,11 @@ type ReactNativeConfigOverrides = {
     consoleCaptureOptions?: Config['consoleInstrumentation'];
     enableUserActions?: boolean;
     userActionsOptions?: Config['userActionsInstrumentation'];
+    /**
+     * Hermes / minified release stack lines omit a file path. This must match the Metro plugin
+     * source map top-level `file` (default `bundle.js`, or your `sourceMapFile` option there).
+     */
+    releaseBundleFilename?: string;
 };
 /**
  * React Native config: Config (omit replaced props) & overrides.

package/dist/types/generated/faroRNPackageMeta.d.ts

@@ -2,4 +2,4 @@
  * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.
  */
 export declare const FARO_REACT_NATIVE_NPM_NAME: "@grafana/faro-react-native";
-export declare const FARO_REACT_NATIVE_NPM_VERSION: "1.1.0";
+export declare const FARO_REACT_NATIVE_NPM_VERSION: "1.2.0";

package/dist/types/instrumentations/errors/index.d.ts

@@ -22,6 +22,11 @@ export interface ErrorsInstrumentationOptions {
      * Older errors are removed when this limit is reached
      */
     maxDeduplicationEntries?: number;
+    /**
+     * Bundle filename for Hermes/minified release lines (`func@line:col`).
+     * Must match the Metro plugin source map `file` field (default `bundle.js`).
+     */
+    releaseBundleFilename?: string;
 }
 /**
  * Errors instrumentation for React Native

package/dist/types/instrumentations/errors/stackTraceParser.d.ts

@@ -1,10 +1,26 @@
 import type { ExceptionStackFrame as StackFrame } from '@grafana/faro-core';
+/**
+ * Hermes (Android release) often reports the bundle segment as `address at index.android.bundle`
+ * inside parentheses. The collector hashes `frame.filename` for uploaded maps; it must match the
+ * source map `file` field (e.g. `index.android.bundle`), not the verbose Hermes label.
+ */
+export declare function normalizeHermesStackFilename(filename: string): string;
 export interface ParsedStackFrame {
     function?: string;
     filename?: string;
     lineno?: number;
     colno?: number;
     isNative?: boolean;
+    /** Set when the line matched Hermes/minified `func@line:col` (no path). */
+    releaseLine?: boolean;
+}
+export interface StackFrameParseOptions {
+    /**
+     * Hermes / minified RN release lines use `func@line:col` with no file path. Those frames are tagged
+     * with `releaseLine` and use this as `filename` (default `bundle.js`). Match the Metro plugin’s
+     * source map `file` field (or `sourceMapFile` option there).
+     */
+    releaseBundleFilename?: string;
 }
 /**
  * Parse a single stack trace line into a structured frame
@@ -17,11 +33,11 @@ export declare function parseStackTrace(stackTrace: string): ParsedStackFrame[];
 /**
  * Convert parsed stack frames to Faro's StackFrame format
  */
-export declare function toFaroStackFrames(parsedFrames: ParsedStackFrame[]): StackFrame[];
+export declare function toFaroStackFrames(parsedFrames: ParsedStackFrame[], options?: StackFrameParseOptions): StackFrame[];
 /**
  * Extract and parse stack frames from an Error object
  */
-export declare function getStackFramesFromError(error: Error): StackFrame[];
+export declare function getStackFramesFromError(error: Error, options?: StackFrameParseOptions): StackFrame[];
 /**
  * Get platform-specific error context
  */
@@ -29,7 +45,7 @@ export declare function getPlatformErrorContext(): Record<string, string>;
 /**
  * Enhance error with React Native specific information
  */
-export declare function enhanceErrorWithContext(error: Error, additionalContext?: Record<string, string>): {
+export declare function enhanceErrorWithContext(error: Error, additionalContext?: Record<string, string>, stackParseOptions?: StackFrameParseOptions): {
     error: Error;
     stackFrames: StackFrame[];
     context: Record<string, string>;

package/ios/faro-upload-composed-source-map.sh

@@ -0,0 +1,87 @@
+#!/bin/sh
+# Upload composed Hermes source map (iOS Release).
+# Invoked from an autolinked Xcode Run Script phase. Expects FARO_BUNDLE_ID,
+# FARO_SOURCEMAP_ENDPOINT, FARO_SOURCEMAP_APP_ID, FARO_SOURCEMAP_STACK_ID,
+# FARO_SOURCEMAP_API_KEY, and optional FARO_SKIP_SOURCEMAP_UPLOAD (same names as `faro-cli metro upload`).
+# Never fails the build — logs warnings and exits 0 when skipping.
+
+set -e
+
+# Source ios/.xcode.env then ios/.xcode.env.local before any FARO_* decisions so
+# skips and credentials can live there (local overrides base; matches RN with-environment.sh).
+if [ -n "${SRCROOT:-}" ]; then
+  if [ -f "$SRCROOT/.xcode.env" ]; then
+    set -a
+    # shellcheck disable=SC1090
+    . "$SRCROOT/.xcode.env"
+    set +a
+  fi
+  if [ -f "$SRCROOT/.xcode.env.local" ]; then
+    set -a
+    # shellcheck disable=SC1090
+    . "$SRCROOT/.xcode.env.local"
+    set +a
+  fi
+fi
+
+# Xcode CONFIGURATION is typically "Debug" or "Release"
+case "$(printf '%s' "${CONFIGURATION:-}" | tr '[:upper:]' '[:lower:]')" in
+  release) ;;
+  *)
+    echo "[Faro] Skipping composed source map upload (configuration: ${CONFIGURATION:-unknown}, not Release)."
+    exit 0
+    ;;
+esac
+
+case "${FARO_SKIP_SOURCEMAP_UPLOAD:-}" in
+  1 | true | TRUE)
+    echo "[Faro] Skipping composed source map upload (FARO_SKIP_SOURCEMAP_UPLOAD=${FARO_SKIP_SOURCEMAP_UPLOAD})."
+    exit 0
+    ;;
+esac
+
+# Application JS root (parent of ios/)
+JS_ROOT="${SRCROOT}/.."
+CLI_PATH="$JS_ROOT/node_modules/@grafana/faro-metro-plugin/bin/faro-upload-source-map.js"
+
+if [ ! -f "$CLI_PATH" ]; then
+  echo "warning: [Faro] Skipping composed source map upload — shim not found at ${CLI_PATH}. Install @grafana/faro-metro-plugin (devDependency) alongside @grafana/faro-react-native."
+  exit 0
+fi
+
+# React Native Hermes pipeline writes the composed map to SOURCEMAP_FILE when set in
+# Xcode build settings (see RN release / FE O11y docs). Fallback for common layouts.
+MAP="${SOURCEMAP_FILE:-}"
+if [ -z "$MAP" ]; then
+  MAP="${CONFIGURATION_BUILD_DIR}/main.jsbundle.map"
+fi
+
+if [ ! -f "$MAP" ]; then
+  echo "warning: [Faro] Skipping composed source map upload — map not found at ${MAP}."
+  echo "warning: [Faro] For iOS Release + Hermes, set SOURCEMAP_FILE in Xcode Release (e.g. \$(DERIVED_FILE_DIR)/main.jsbundle.map) so react-native-xcode.sh composes main.jsbundle.map."
+  exit 0
+fi
+
+MISSING=""
+[ -z "${FARO_BUNDLE_ID:-}" ] && MISSING="${MISSING}FARO_BUNDLE_ID "
+[ -z "${FARO_SOURCEMAP_ENDPOINT:-}" ] && MISSING="${MISSING}FARO_SOURCEMAP_ENDPOINT "
+[ -z "${FARO_SOURCEMAP_APP_ID:-}" ] && MISSING="${MISSING}FARO_SOURCEMAP_APP_ID "
+[ -z "${FARO_SOURCEMAP_STACK_ID:-}" ] && MISSING="${MISSING}FARO_SOURCEMAP_STACK_ID "
+[ -z "${FARO_SOURCEMAP_API_KEY:-}" ] && MISSING="${MISSING}FARO_SOURCEMAP_API_KEY "
+
+if [ -n "$MISSING" ]; then
+  echo "warning: [Faro] Skipping composed source map upload — missing env: ${MISSING}"
+  echo "warning: [Faro] Export FARO_BUNDLE_ID and FARO_SOURCEMAP_* in the shell running xcodebuild, or add them to ios/.xcode.env.local."
+  exit 0
+fi
+
+NODE_BIN="${NODE_BINARY:-node}"
+
+exec "$NODE_BIN" "$CLI_PATH" \
+  --verbose \
+  --map "$MAP" \
+  --endpoint "$FARO_SOURCEMAP_ENDPOINT" \
+  --app-id "$FARO_SOURCEMAP_APP_ID" \
+  --stack-id "$FARO_SOURCEMAP_STACK_ID" \
+  --api-key "$FARO_SOURCEMAP_API_KEY" \
+  --bundle-id "$FARO_BUNDLE_ID"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/faro-react-native",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Faro instrumentations, metas, transports for React Native.",
   "keywords": [
     "observability",
@@ -61,16 +61,12 @@
     "react-native-device-info": "^11.1.0"
   },
   "peerDependencies": {
-    "@grafana/faro-react-native-tracing": ">=1.0.0",
     "@react-navigation/native": ">=6.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
     "react-native-mmkv": ">=2.0.0"
   },
   "peerDependenciesMeta": {
-    "@grafana/faro-react-native-tracing": {
-      "optional": true
-    },
     "@react-navigation/native": {
       "optional": true
     },
@@ -79,13 +75,14 @@
     }
   },
   "devDependencies": {
-    "@types/node": "24.10.1",
-    "@types/react": "^19.1.1",
-    "@types/react-native": "^0.73.0",
-    "react-native-mmkv": "^4.3.1"
+    "@types/node": "24.12.3",
+    "@types/react": "19.2.14",
+    "@types/react-native": "0.73.0",
+    "react-native-mmkv": "4.3.1",
+    "react-native-nitro-modules": "0.35.6"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8ca367978d53ef163886a2e99690c6f8a61416dc"
+  "gitHead": "65b49f4c649e3400c74495257d33bd28d9af4b58"
 }

package/react-native.config.js

@@ -1,8 +1,16 @@
 module.exports = {
   dependency: {
     platforms: {
-      ios: {},
       android: {},
+      ios: {
+        scriptPhases: [
+          {
+            name: '[Faro] Upload composed source map (Release)',
+            path: './ios/faro-upload-composed-source-map.sh',
+            execution_position: 'any',
+          },
+        ],
+      },
     },
   },
 };

package/src/config/getRNInstrumentations.ts

@@ -79,7 +79,11 @@ export function getRNInstrumentations(config: Partial<ReactNativeConfig> = {}):
 
   // Error reporting (Flutter: enableFlutterErrorReporting)
   if (enableErrorReporting) {
-    instrumentations.push(new ErrorsInstrumentation());
+    instrumentations.push(
+      new ErrorsInstrumentation({
+        releaseBundleFilename: config.releaseBundleFilename,
+      })
+    );
   }
 
   // Console capture - not in Flutter SDK, RN-specific

package/src/config/makeRNConfig.test.ts

@@ -127,4 +127,15 @@ describe('makeRNConfig', () => {
       (cfg as { preloadedSessionDeviceAttributes?: { device_id: string } }).preloadedSessionDeviceAttributes?.device_id
     ).toBe('test-preloaded-id');
   });
+
+  it('uses releaseBundleFilename in default parseStacktrace when set', () => {
+    const cfg = makeRNConfig({
+      ...base,
+      releaseBundleFilename: 'main.jsbundle',
+    });
+    const err = new Error('x');
+    err.stack = 'g@1:2';
+    const parsed = cfg.parseStacktrace?.(err);
+    expect(parsed?.frames?.[0]?.filename).toBe('main.jsbundle');
+  });
 });

package/src/config/makeRNConfig.ts

@@ -65,9 +65,11 @@ function buildInstrumentations(config: ReactNativeConfig): Config['instrumentati
 /**
  * React Native stacktrace parser. Uses getStackFramesFromError for RN-specific formats.
  */
-const parseStacktrace: Config['parseStacktrace'] = (err) => ({
-  frames: getStackFramesFromError(err),
-});
+function createParseStacktrace(releaseBundleFilename: string | undefined): Config['parseStacktrace'] {
+  return (err) => ({
+    frames: getStackFramesFromError(err, { releaseBundleFilename }),
+  });
+}
 
 /**
  * Creates a full Faro config from React Native flag-based config.
@@ -86,6 +88,7 @@ export function makeRNConfig(
   const transports = buildTransports(config);
   const instrumentations = buildInstrumentations(config);
 
+  const releaseBundleFilename = config.releaseBundleFilename;
   return {
     app: config.app,
     ...(preloadedSessionDeviceAttributes != null && {
@@ -95,7 +98,7 @@ export function makeRNConfig(
     globalObjectKey: config.globalObjectKey ?? defaultGlobalObjectKey,
     internalLoggerLevel: config.internalLoggerLevel ?? InternalLoggerLevel.ERROR,
     isolate: config.isolate ?? false,
-    parseStacktrace: config.parseStacktrace ?? parseStacktrace,
+    parseStacktrace: config.parseStacktrace ?? createParseStacktrace(releaseBundleFilename),
     paused: config.paused ?? false,
     preventGlobalExposure: config.preventGlobalExposure ?? false,
     unpatchedConsole: config.unpatchedConsole ?? defaultUnpatchedConsole,

package/src/config/types.ts

@@ -70,6 +70,11 @@ type ReactNativeConfigOverrides = {
   consoleCaptureOptions?: Config['consoleInstrumentation'];
   enableUserActions?: boolean;
   userActionsOptions?: Config['userActionsInstrumentation'];
+  /**
+   * Hermes / minified release stack lines omit a file path. This must match the Metro plugin
+   * source map top-level `file` (default `bundle.js`, or your `sourceMapFile` option there).
+   */
+  releaseBundleFilename?: string;
 };
 
 /**

package/src/generated/faroRNPackageMeta.ts

@@ -2,4 +2,4 @@
  * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.
  */
 export const FARO_REACT_NATIVE_NPM_NAME = '@grafana/faro-react-native' as const;
-export const FARO_REACT_NATIVE_NPM_VERSION = '1.1.0' as const;
+export const FARO_REACT_NATIVE_NPM_VERSION = '1.2.0' as const;

package/src/initialize.test.ts

@@ -8,10 +8,17 @@ import { SessionInstrumentation } from './instrumentations/session';
 import * as sessionAttributes from './instrumentations/session/sessionAttributes';
 
 describe('initializeFaro', () => {
+  const preambleKey = '__faroBundleId_test';
+
   beforeEach(() => {
     jest.clearAllMocks();
     jest.clearAllTimers();
     delete (global as any).faro;
+    delete (globalThis as Record<string, unknown>)[preambleKey];
+  });
+
+  afterEach(() => {
+    delete (globalThis as Record<string, unknown>)[preambleKey];
   });
 
   it('should initialize Faro', async () => {
@@ -123,4 +130,22 @@ describe('initializeFaro', () => {
 
     spy.mockRestore();
   });
+
+  it('should set meta.app.bundleId from Faro Metro preamble global (__faroBundleId_<app.name>)', async () => {
+    (globalThis as Record<string, unknown>)[preambleKey] = 'release-bundle-from-metro';
+
+    const faro = await initializeFaro(
+      mockConfig({
+        url: 'http://localhost:12345/collect',
+        transports: [new MockTransport()],
+        instrumentations: [new SessionInstrumentation()],
+        sessionTracking: {
+          enabled: true,
+          persistent: false,
+        },
+      })
+    );
+
+    expect(faro.metas.value.app?.bundleId).toBe('release-bundle-from-metro');
+  });
 });