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

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

@@ -0,0 +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\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 { initializeFaro } from '@grafana/faro-react-native';\n * import { ErrorsInstrumentation } from '@grafana/faro-react-native';\n *\n * 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<ErrorsInstrumentationOptions>;\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    };\n  }\n\n  initialize(): void {\n    this.logInfo('Initializing errors instrumentation');\n\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          this.logDebug('Ignoring error based on ignoreErrors patterns', { message: error.message });\n          return;\n        }\n\n        // Check for duplicate errors\n        if (this.options.enableDeduplication && this.isDuplicateError(error)) {\n          this.logDebug('Ignoring duplicate error', { message: error.message });\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(error, {\n          mechanism: ErrorMechanism.UNCAUGHT,\n          isFatal: String(isFatal ?? false),\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          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        this.logError('Failed to report error to Faro', e);\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          this.logDebug('Ignoring unhandled rejection based on ignoreErrors patterns', { message: error.message });\n          return;\n        }\n\n        // Check for duplicate errors\n        if (this.options.enableDeduplication && this.isDuplicateError(error)) {\n          this.logDebug('Ignoring duplicate unhandled rejection', { message: error.message });\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(error, {\n          mechanism: ErrorMechanism.UNHANDLED_REJECTION,\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          stackFrames,\n        });\n\n        // Track error fingerprint for deduplication\n        if (this.options.enableDeduplication) {\n          this.addErrorFingerprint(error);\n        }\n      } catch (e) {\n        this.logError('Failed to report unhandled rejection to Faro', e);\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/cjs/instrumentations/errors/stackTraceParser.js

@@ -0,0 +1,173 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStackTraceLine = parseStackTraceLine;
+exports.parseStackTrace = parseStackTrace;
+exports.toFaroStackFrames = toFaroStackFrames;
+exports.getStackFramesFromError = getStackFramesFromError;
+exports.getPlatformErrorContext = getPlatformErrorContext;
+exports.enhanceErrorWithContext = enhanceErrorWithContext;
+var react_native_1 = require("react-native");
+/**
+ * Parse React Native stack traces into structured stack frames
+ *
+ * React Native stack traces have different formats depending on platform and environment:
+ *
+ * iOS/Android (Dev):
+ *   at functionName (file.js:123:45)
+ *   at anonymous (native)
+ *
+ * iOS/Android (Release):
+ *   functionName@123:456
+ *   @[native code]
+ *
+ * Metro bundler:
+ *   at Object.functionName (/path/to/file.js:123:456)
+ */
+var REACT_NATIVE_STACK_REGEX = /^\s*at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)$/;
+var REACT_NATIVE_NATIVE_REGEX = /^\s*at\s+(.+?)\s+\(native\)$/;
+var REACT_NATIVE_RELEASE_REGEX = /^(.+?)@(\d+):(\d+)$/;
+var REACT_NATIVE_ANONYMOUS_REGEX = /^\s*at\s+anonymous\s+\((.+?):(\d+):(\d+)\)$/;
+var METRO_BUNDLER_REGEX = /^\s*at\s+(?:Object\.)?(.+?)\s+\((.+?):(\d+):(\d+)\)$/;
+/**
+ * Parse a single stack trace line into a structured frame
+ */
+function parseStackTraceLine(line) {
+    if (!line || typeof line !== 'string') {
+        return null;
+    }
+    var trimmedLine = line.trim();
+    if (!trimmedLine) {
+        return null;
+    }
+    // Try standard React Native format: at functionName (file.js:123:45)
+    var 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),
+        };
+    }
+    // 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),
+        };
+    }
+    // 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),
+        };
+    }
+    // Try native format: at functionName (native)
+    match = trimmedLine.match(REACT_NATIVE_NATIVE_REGEX);
+    if (match) {
+        return {
+            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),
+        };
+    }
+    // Couldn't parse this line
+    return null;
+}
+/**
+ * Parse a full stack trace string into an array of structured frames
+ */
+function parseStackTrace(stackTrace) {
+    if (!stackTrace || typeof stackTrace !== 'string') {
+        return [];
+    }
+    var lines = stackTrace.split('\n');
+    var frames = [];
+    for (var _i = 0, lines_1 = lines; _i < lines_1.length; _i++) {
+        var line = lines_1[_i];
+        var frame = parseStackTraceLine(line);
+        if (frame) {
+            frames.push(frame);
+        }
+    }
+    return frames;
+}
+/**
+ * Convert parsed stack frames to Faro's StackFrame format
+ */
+function toFaroStackFrames(parsedFrames) {
+    return parsedFrames.map(function (frame, _index) { return ({
+        filename: frame.filename || '<unknown>',
+        function: frame.function || '<anonymous>',
+        lineno: frame.lineno,
+        colno: frame.colno,
+    }); });
+}
+/**
+ * Extract and parse stack frames from an Error object
+ */
+function getStackFramesFromError(error) {
+    if (!error || !error.stack) {
+        return [];
+    }
+    try {
+        var parsedFrames = parseStackTrace(error.stack);
+        return toFaroStackFrames(parsedFrames);
+    }
+    catch (_e) {
+        // If parsing fails, return empty array
+        return [];
+    }
+}
+/**
+ * Get platform-specific error context
+ */
+function getPlatformErrorContext() {
+    var _a;
+    return {
+        platform: react_native_1.Platform.OS,
+        platformVersion: ((_a = react_native_1.Platform.Version) === null || _a === void 0 ? void 0 : _a.toString()) || 'unknown',
+        isHermes: typeof HermesInternal !== 'undefined' ? 'true' : 'false',
+    };
+}
+/**
+ * Enhance error with React Native specific information
+ */
+function enhanceErrorWithContext(error, additionalContext) {
+    var stackFrames = getStackFramesFromError(error);
+    var platformContext = getPlatformErrorContext();
+    return {
+        error: error,
+        stackFrames: stackFrames,
+        context: __assign(__assign({}, platformContext), additionalContext),
+    };
+}
+//# sourceMappingURL=stackTraceParser.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameMonitoringInstrumentation = void 0;
+var instrumentation_1 = require("./instrumentation");
+Object.defineProperty(exports, "FrameMonitoringInstrumentation", { enumerable: true, get: function () { return instrumentation_1.FrameMonitoringInstrumentation; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/frameMonitoring/index.ts"],"names":[],"mappings":";;;AAAA,qDAAmE;AAA1D,iIAAA,8BAA8B,OAAA","sourcesContent":["export { FrameMonitoringInstrumentation } from './instrumentation';\nexport type { FrameMetrics, FrameMonitoringOptions } from './types';\n"]}

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

@@ -0,0 +1,321 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameMonitoringInstrumentation = void 0;
+var react_native_1 = require("react-native");
+var faro_core_1 = require("@grafana/faro-core");
+/**
+ * Default configuration values matching Flutter SDK's hardcoded values.
+ * These are React Native-specific advanced options for customization.
+ */
+var DEFAULT_TARGET_FPS = 60;
+var DEFAULT_FROZEN_FRAME_THRESHOLD_MS = 100;
+var DEFAULT_REFRESH_RATE_POLLING_INTERVAL = 30000;
+var DEFAULT_NORMALIZED_REFRESH_RATE = 60;
+/**
+ * Frame Monitoring Instrumentation for React Native.
+ *
+ * Monitors frame rendering performance and detects slow/frozen frames.
+ * Uses native CADisplayLink (iOS) and Choreographer (Android) for accurate metrics.
+ *
+ * ## Slow Frame Detection
+ * Slow frames are detected using **event-based grouping** to report user-perceptible jank:
+ * - Tracks consecutive frames below `targetFps` as a single "slow frame event"
+ * - Only counts events lasting ≥50ms (~3 frames at 60fps) to filter noise
+ * - This prevents reporting normal microsecond variations as slow frames
+ * - Reports meaningful performance degradation that affects user experience
+ *
+ * ## Frozen Frame Detection
+ * Frozen frames are individual frames exceeding `frozenFrameThresholdMs` (default 100ms).
+ * These represent severe jank where the app appears unresponsive.
+ *
+ * Sends measurements via Faro API:
+ * - `app_refresh_rate`: Current refresh rate in FPS
+ * - `app_frames_rate`: Number of slow frame events (not individual frames)
+ * - `app_frozen_frame`: Number of frozen frames (exceeding frozenFrameThresholdMs)
+ *
+ * @example
+ * ```typescript
+ * import { initializeFaro, FrameMonitoringInstrumentation } from '@grafana/faro-react-native';
+ *
+ * initializeFaro({
+ *   url: 'https://collector.example.com',
+ *   instrumentations: [
+ *     new FrameMonitoringInstrumentation({
+ *       targetFps: 60,
+ *       frozenFrameThresholdMs: 100,
+ *       refreshRatePollingInterval: 30000,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+var FrameMonitoringInstrumentation = /** @class */ (function (_super) {
+    __extends(FrameMonitoringInstrumentation, _super);
+    function FrameMonitoringInstrumentation(options) {
+        if (options === void 0) { options = {}; }
+        var _a, _b, _c, _d;
+        var _this = _super.call(this) || this;
+        _this.name = '@grafana/faro-react-native:instrumentation-frame-monitoring';
+        _this.version = faro_core_1.VERSION;
+        _this.pollingIntervalId = null;
+        _this.eventEmitter = null;
+        _this.eventSubscriptions = [];
+        _this.options = {
+            targetFps: (_a = options.targetFps) !== null && _a !== void 0 ? _a : DEFAULT_TARGET_FPS,
+            frozenFrameThresholdMs: (_b = options.frozenFrameThresholdMs) !== null && _b !== void 0 ? _b : DEFAULT_FROZEN_FRAME_THRESHOLD_MS,
+            refreshRatePollingInterval: (_c = options.refreshRatePollingInterval) !== null && _c !== void 0 ? _c : DEFAULT_REFRESH_RATE_POLLING_INTERVAL,
+            normalizedRefreshRate: (_d = options.normalizedRefreshRate) !== null && _d !== void 0 ? _d : DEFAULT_NORMALIZED_REFRESH_RATE,
+        };
+        return _this;
+    }
+    Object.defineProperty(FrameMonitoringInstrumentation.prototype, "refreshRateVitalsEnabled", {
+        /**
+         * Check if refresh rate vitals are enabled in Faro config.
+         * Reads from faro.config.refreshRateVitals (single source of truth).
+         */
+        get: function () {
+            var _a;
+            // Access config via this.config which is set by BaseInstrumentation after initialization
+            var config = this.config;
+            return (_a = config === null || config === void 0 ? void 0 : config.refreshRateVitals) !== null && _a !== void 0 ? _a : false;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    FrameMonitoringInstrumentation.prototype.initialize = function () {
+        this.logDebug('Initializing frame monitoring instrumentation');
+        var nativeModule = this.getNativeModule();
+        if (!nativeModule) {
+            this.logWarn('Native module not available for frame monitoring');
+            return;
+        }
+        // Start native frame monitoring with configuration
+        this.startNativeMonitoring(nativeModule);
+        // Set up event listeners for real-time frame events (Android pattern)
+        this.setupEventListeners(nativeModule);
+        // Set up polling for periodic metrics collection (iOS pattern)
+        this.startPolling();
+    };
+    FrameMonitoringInstrumentation.prototype.getNativeModule = function () {
+        var FaroReactNativeModule = react_native_1.NativeModules.FaroReactNativeModule;
+        if (!FaroReactNativeModule) {
+            return null;
+        }
+        return FaroReactNativeModule;
+    };
+    FrameMonitoringInstrumentation.prototype.startNativeMonitoring = function (nativeModule) {
+        try {
+            if (typeof nativeModule.startFrameMonitoring === 'function') {
+                nativeModule.startFrameMonitoring({
+                    targetFps: this.options.targetFps,
+                    frozenFrameThresholdMs: this.options.frozenFrameThresholdMs,
+                    normalizedRefreshRate: this.options.normalizedRefreshRate,
+                });
+                this.logDebug('Started native frame monitoring');
+            }
+        }
+        catch (error) {
+            this.logError('Failed to start native frame monitoring', error);
+        }
+    };
+    FrameMonitoringInstrumentation.prototype.setupEventListeners = function (nativeModule) {
+        var _this = this;
+        // Android uses event-based approach for frozen frames only
+        // Slow frames are retrieved via polling (like iOS) to avoid flooding
+        if (react_native_1.Platform.OS === 'android') {
+            try {
+                this.eventEmitter = new react_native_1.NativeEventEmitter(nativeModule);
+                // Listen for frozen frame events
+                var frozenFrameSubscription = this.eventEmitter.addListener('onFrozenFrame', function (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);
+                    }
+                });
+                this.eventSubscriptions.push(frozenFrameSubscription);
+                // Listen for refresh rate events (only when refreshRateVitals is enabled in config)
+                if (this.refreshRateVitalsEnabled) {
+                    var refreshRateSubscription = this.eventEmitter.addListener('onRefreshRate', function (refreshRate) {
+                        _this.handleRefreshRate(refreshRate);
+                    });
+                    this.eventSubscriptions.push(refreshRateSubscription);
+                }
+                this.logDebug('Set up Android frame event listeners');
+            }
+            catch (error) {
+                this.logError('Failed to set up frame event listeners', error);
+            }
+        }
+    };
+    FrameMonitoringInstrumentation.prototype.startPolling = function () {
+        var _this = this;
+        // Both iOS and Android use polling approach for slow frames
+        // This provides consistent behavior and avoids flooding with events
+        this.pollingIntervalId = setInterval(function () {
+            _this.pollFrameMetrics();
+        }, this.options.refreshRatePollingInterval);
+    };
+    FrameMonitoringInstrumentation.prototype.pollFrameMetrics = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var nativeModule, refreshRate, metrics, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        nativeModule = this.getNativeModule();
+                        if (!nativeModule) {
+                            return [2 /*return*/];
+                        }
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 6, , 7]);
+                        if (!this.refreshRateVitalsEnabled) return [3 /*break*/, 3];
+                        if (!(typeof nativeModule.getRefreshRate === 'function')) return [3 /*break*/, 3];
+                        return [4 /*yield*/, nativeModule.getRefreshRate()];
+                    case 2:
+                        refreshRate = _a.sent();
+                        if (refreshRate !== null && refreshRate > 0) {
+                            this.handleRefreshRate(refreshRate);
+                        }
+                        _a.label = 3;
+                    case 3:
+                        if (!(typeof nativeModule.getFrameMetrics === 'function')) return [3 /*break*/, 5];
+                        return [4 /*yield*/, nativeModule.getFrameMetrics()];
+                    case 4:
+                        metrics = (_a.sent());
+                        if (metrics) {
+                            if (this.refreshRateVitalsEnabled && metrics.refreshRate > 0) {
+                                this.handleRefreshRate(metrics.refreshRate);
+                            }
+                            if (metrics.slowFrames > 0) {
+                                this.handleSlowFrames(metrics.slowFrames);
+                            }
+                            if (metrics.frozenFrames > 0) {
+                                this.handleFrozenFrame(metrics.frozenFrames, metrics.frozenDurationMs);
+                            }
+                        }
+                        _a.label = 5;
+                    case 5: return [3 /*break*/, 7];
+                    case 6:
+                        error_1 = _a.sent();
+                        this.logError('Failed to poll frame metrics', error_1);
+                        return [3 /*break*/, 7];
+                    case 7: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    FrameMonitoringInstrumentation.prototype.handleRefreshRate = function (refreshRate) {
+        this.api.pushMeasurement({
+            type: 'app_refresh_rate',
+            values: { refresh_rate: refreshRate },
+        }, { skipDedupe: true });
+    };
+    FrameMonitoringInstrumentation.prototype.handleSlowFrames = function (count) {
+        // Note: Despite the name "slow_frames", this count represents slow frame EVENTS, not individual frames.
+        // Each event is a period of consecutive slow frames lasting ≥50ms (~3 frames at 60fps).
+        this.api.pushMeasurement({
+            type: 'app_frames_rate',
+            values: { slow_frames: count },
+        }, { skipDedupe: true });
+    };
+    FrameMonitoringInstrumentation.prototype.handleFrozenFrame = function (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 ".concat(react_native_1.Platform.OS.toUpperCase(), "] \uD83E\uDDCA SENDING frozen frame: count=").concat(count, ", duration=").concat(durationMs, "ms"));
+            this.api.pushMeasurement({
+                type: 'app_frozen_frame',
+                values: {
+                    frozen_frames: count,
+                    frozen_duration: durationMs,
+                },
+            }, { skipDedupe: true });
+        }
+    };
+    /**
+     * Clean up resources when instrumentation is disabled.
+     */
+    FrameMonitoringInstrumentation.prototype.unpatch = function () {
+        // Stop polling
+        if (this.pollingIntervalId !== null) {
+            clearInterval(this.pollingIntervalId);
+            this.pollingIntervalId = null;
+        }
+        // Remove event subscriptions
+        for (var _i = 0, _a = this.eventSubscriptions; _i < _a.length; _i++) {
+            var subscription = _a[_i];
+            subscription.remove();
+        }
+        this.eventSubscriptions = [];
+        this.eventEmitter = null;
+        // Stop native monitoring
+        var nativeModule = this.getNativeModule();
+        if (nativeModule && typeof nativeModule.stopFrameMonitoring === 'function') {
+            try {
+                nativeModule.stopFrameMonitoring();
+            }
+            catch (error) {
+                this.logError('Failed to stop native frame monitoring', error);
+            }
+        }
+        this.logDebug('Frame monitoring instrumentation stopped');
+    };
+    return FrameMonitoringInstrumentation;
+}(faro_core_1.BaseInstrumentation));
+exports.FrameMonitoringInstrumentation = FrameMonitoringInstrumentation;
+//# sourceMappingURL=instrumentation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../../../src/instrumentations/frameMonitoring/instrumentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeEventEmitter, NativeModules, Platform } from 'react-native';\n\nimport { BaseInstrumentation, VERSION } from '@grafana/faro-core';\n\nimport type { ReactNativeConfig } from '../../config/types';\n\nimport type { FrameMetrics, FrameMonitoringOptions } from './types';\n\n/**\n * Default configuration values matching Flutter SDK's hardcoded values.\n * These are React Native-specific advanced options for customization.\n */\nconst DEFAULT_TARGET_FPS = 60;\nconst DEFAULT_FROZEN_FRAME_THRESHOLD_MS = 100;\nconst DEFAULT_REFRESH_RATE_POLLING_INTERVAL = 30000;\nconst DEFAULT_NORMALIZED_REFRESH_RATE = 60;\n\n/**\n * Frame Monitoring Instrumentation for React Native.\n *\n * Monitors frame rendering performance and detects slow/frozen frames.\n * Uses native CADisplayLink (iOS) and Choreographer (Android) for accurate metrics.\n *\n * ## Slow Frame Detection\n * Slow frames are detected using **event-based grouping** to report user-perceptible jank:\n * - Tracks consecutive frames below `targetFps` as a single \"slow frame event\"\n * - Only counts events lasting ≥50ms (~3 frames at 60fps) to filter noise\n * - This prevents reporting normal microsecond variations as slow frames\n * - Reports meaningful performance degradation that affects user experience\n *\n * ## Frozen Frame Detection\n * Frozen frames are individual frames exceeding `frozenFrameThresholdMs` (default 100ms).\n * These represent severe jank where the app appears unresponsive.\n *\n * Sends measurements via Faro API:\n * - `app_refresh_rate`: Current refresh rate in FPS\n * - `app_frames_rate`: Number of slow frame events (not individual frames)\n * - `app_frozen_frame`: Number of frozen frames (exceeding frozenFrameThresholdMs)\n *\n * @example\n * ```typescript\n * import { initializeFaro, FrameMonitoringInstrumentation } from '@grafana/faro-react-native';\n *\n * initializeFaro({\n *   url: 'https://collector.example.com',\n *   instrumentations: [\n *     new FrameMonitoringInstrumentation({\n *       targetFps: 60,\n *       frozenFrameThresholdMs: 100,\n *       refreshRatePollingInterval: 30000,\n *     }),\n *   ],\n * });\n * ```\n */\nexport class FrameMonitoringInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-frame-monitoring';\n  readonly version = VERSION;\n\n  private readonly options: Required<FrameMonitoringOptions>;\n  private pollingIntervalId: ReturnType<typeof setInterval> | null = null;\n  private eventEmitter: NativeEventEmitter | null = null;\n  private eventSubscriptions: Array<{ remove: () => void }> = [];\n\n  constructor(options: FrameMonitoringOptions = {}) {\n    super();\n    this.options = {\n      targetFps: options.targetFps ?? DEFAULT_TARGET_FPS,\n      frozenFrameThresholdMs: options.frozenFrameThresholdMs ?? DEFAULT_FROZEN_FRAME_THRESHOLD_MS,\n      refreshRatePollingInterval: options.refreshRatePollingInterval ?? DEFAULT_REFRESH_RATE_POLLING_INTERVAL,\n      normalizedRefreshRate: options.normalizedRefreshRate ?? DEFAULT_NORMALIZED_REFRESH_RATE,\n    };\n  }\n\n  /**\n   * Check if refresh rate vitals are enabled in Faro config.\n   * Reads from faro.config.refreshRateVitals (single source of truth).\n   */\n  private get refreshRateVitalsEnabled(): boolean {\n    // Access config via this.config which is set by BaseInstrumentation after initialization\n    const config = this.config as ReactNativeConfig | undefined;\n    return config?.refreshRateVitals ?? false;\n  }\n\n  initialize(): void {\n    this.logDebug('Initializing frame monitoring instrumentation');\n\n    const nativeModule = this.getNativeModule();\n    if (!nativeModule) {\n      this.logWarn('Native module not available for frame monitoring');\n      return;\n    }\n\n    // Start native frame monitoring with configuration\n    this.startNativeMonitoring(nativeModule);\n\n    // Set up event listeners for real-time frame events (Android pattern)\n    this.setupEventListeners(nativeModule);\n\n    // Set up polling for periodic metrics collection (iOS pattern)\n    this.startPolling();\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 startNativeMonitoring(nativeModule: typeof NativeModules.FaroReactNativeModule): void {\n    try {\n      if (typeof nativeModule.startFrameMonitoring === 'function') {\n        nativeModule.startFrameMonitoring({\n          targetFps: this.options.targetFps,\n          frozenFrameThresholdMs: this.options.frozenFrameThresholdMs,\n          normalizedRefreshRate: this.options.normalizedRefreshRate,\n        });\n        this.logDebug('Started native frame monitoring');\n      }\n    } catch (error) {\n      this.logError('Failed to start native frame monitoring', error);\n    }\n  }\n\n  private setupEventListeners(nativeModule: typeof NativeModules.FaroReactNativeModule): void {\n    // Android uses event-based approach for frozen frames only\n    // Slow frames are retrieved via polling (like iOS) to avoid flooding\n    if (Platform.OS === 'android') {\n      try {\n        this.eventEmitter = new NativeEventEmitter(nativeModule);\n\n        // Listen for frozen frame events\n        const frozenFrameSubscription = this.eventEmitter.addListener(\n          'onFrozenFrame',\n          (data: number | { count: number; durationMs: number }) => {\n            // Support both formats: number (legacy) or object (with duration)\n            if (typeof data === 'number') {\n              this.handleFrozenFrame(data, 0);\n            } else {\n              this.handleFrozenFrame(data.count, data.durationMs || 0);\n            }\n          }\n        );\n        this.eventSubscriptions.push(frozenFrameSubscription);\n\n        // Listen for refresh rate events (only when refreshRateVitals is enabled in config)\n        if (this.refreshRateVitalsEnabled) {\n          const refreshRateSubscription = this.eventEmitter.addListener('onRefreshRate', (refreshRate: number) => {\n            this.handleRefreshRate(refreshRate);\n          });\n          this.eventSubscriptions.push(refreshRateSubscription);\n        }\n\n        this.logDebug('Set up Android frame event listeners');\n      } catch (error) {\n        this.logError('Failed to set up frame event listeners', error);\n      }\n    }\n  }\n\n  private startPolling(): void {\n    // Both iOS and Android use polling approach for slow frames\n    // This provides consistent behavior and avoids flooding with events\n    this.pollingIntervalId = setInterval(() => {\n      this.pollFrameMetrics();\n    }, this.options.refreshRatePollingInterval);\n  }\n\n  private async pollFrameMetrics(): Promise<void> {\n    const nativeModule = this.getNativeModule();\n    if (!nativeModule) {\n      return;\n    }\n\n    try {\n      // Get refresh rate (only send when refreshRateVitals is enabled in config)\n      if (this.refreshRateVitalsEnabled) {\n        if (typeof nativeModule.getRefreshRate === 'function') {\n          const refreshRate = await nativeModule.getRefreshRate();\n          if (refreshRate !== null && refreshRate > 0) {\n            this.handleRefreshRate(refreshRate);\n          }\n        }\n      }\n\n      // Get full frame metrics if available\n      if (typeof nativeModule.getFrameMetrics === 'function') {\n        const metrics = (await nativeModule.getFrameMetrics()) as FrameMetrics | null;\n        if (metrics) {\n          if (this.refreshRateVitalsEnabled && metrics.refreshRate > 0) {\n            this.handleRefreshRate(metrics.refreshRate);\n          }\n          if (metrics.slowFrames > 0) {\n            this.handleSlowFrames(metrics.slowFrames);\n          }\n          if (metrics.frozenFrames > 0) {\n            this.handleFrozenFrame(metrics.frozenFrames, metrics.frozenDurationMs);\n          }\n        }\n      }\n    } catch (error) {\n      this.logError('Failed to poll frame metrics', error);\n    }\n  }\n\n  private handleRefreshRate(refreshRate: number): void {\n    this.api.pushMeasurement(\n      {\n        type: 'app_refresh_rate',\n        values: { refresh_rate: refreshRate },\n      },\n      { skipDedupe: true }\n    );\n  }\n\n  private handleSlowFrames(count: number): void {\n    // Note: Despite the name \"slow_frames\", this count represents slow frame EVENTS, not individual frames.\n    // Each event is a period of consecutive slow frames lasting ≥50ms (~3 frames at 60fps).\n    this.api.pushMeasurement(\n      {\n        type: 'app_frames_rate',\n        values: { slow_frames: count },\n      },\n      { skipDedupe: true }\n    );\n  }\n\n  private handleFrozenFrame(count: number, durationMs: number): void {\n    // Only send frozen frame events if duration is greater than 0\n    // This filters out any erroneous 0ms frozen frames\n    if (durationMs > 0) {\n      // 🔍 TEMP DEBUG LOG - Remove after analysis\n      console.log(\n        `[Faro DEBUG ${Platform.OS.toUpperCase()}] 🧊 SENDING frozen frame: count=${count}, duration=${durationMs}ms`\n      );\n\n      this.api.pushMeasurement(\n        {\n          type: 'app_frozen_frame',\n          values: {\n            frozen_frames: count,\n            frozen_duration: durationMs,\n          },\n        },\n        { skipDedupe: true }\n      );\n    }\n  }\n\n  /**\n   * Clean up resources when instrumentation is disabled.\n   */\n  unpatch(): void {\n    // Stop polling\n    if (this.pollingIntervalId !== null) {\n      clearInterval(this.pollingIntervalId);\n      this.pollingIntervalId = null;\n    }\n\n    // Remove event subscriptions\n    for (const subscription of this.eventSubscriptions) {\n      subscription.remove();\n    }\n    this.eventSubscriptions = [];\n    this.eventEmitter = null;\n\n    // Stop native monitoring\n    const nativeModule = this.getNativeModule();\n    if (nativeModule && typeof nativeModule.stopFrameMonitoring === 'function') {\n      try {\n        nativeModule.stopFrameMonitoring();\n      } catch (error) {\n        this.logError('Failed to stop native frame monitoring', error);\n      }\n    }\n\n    this.logDebug('Frame monitoring instrumentation stopped');\n  }\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/instrumentations/frameMonitoring/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Configuration options for Frame Monitoring instrumentation.\n *\n * These are React Native-specific advanced options. The Flutter SDK uses fixed values\n * for these parameters (not configurable). Defaults here match Flutter's hardcoded values\n * for cross-platform consistency.\n *\n * Note: To enable frame monitoring, set `refreshRateVitals: true` in ReactNativeConfig.\n */\nexport interface FrameMonitoringOptions {\n  /**\n   * Target frames per second for slow frame detection.\n   * Frames rendering below this threshold are considered \"slow\".\n   * Default: 60 (Flutter SDK hardcoded value)\n   */\n  targetFps?: number;\n\n  /**\n   * Threshold in milliseconds for detecting frozen frames.\n   * Frames taking longer than this are considered \"frozen\".\n   * Default: 100ms (Flutter SDK uses 100_000_000 nanoseconds)\n   */\n  frozenFrameThresholdMs?: number;\n\n  /**\n   * Interval in milliseconds for collecting and sending frame metrics.\n   * Default: 30000 (30 seconds, aligned with fetchVitalsInterval)\n   */\n  refreshRatePollingInterval?: number;\n\n  /**\n   * Normalized refresh rate for ProMotion displays (120Hz, etc.).\n   * Used to normalize frame rates for high-refresh-rate displays to a standard baseline.\n   * Default: 60 (Flutter SDK's backendSupportedFrameRate)\n   */\n  normalizedRefreshRate?: number;\n}\n\n/**\n * Frame metrics collected by the instrumentation.\n */\nexport interface FrameMetrics {\n  /**\n   * Current refresh rate in FPS.\n   */\n  refreshRate: number;\n\n  /**\n   * Number of slow frames since last measurement.\n   */\n  slowFrames: number;\n\n  /**\n   * Number of frozen frames since last measurement.\n   */\n  frozenFrames: number;\n\n  /**\n   * Total duration of frozen frames in milliseconds.\n   */\n  frozenDurationMs: number;\n}\n\n/**\n * Native module methods for frame monitoring.\n */\nexport interface FrameMonitoringNativeModule {\n  /**\n   * Start frame monitoring.\n   */\n  startFrameMonitoring(config: {\n    targetFps: number;\n    frozenFrameThresholdMs: number;\n    normalizedRefreshRate: number;\n  }): void;\n\n  /**\n   * Stop frame monitoring.\n   */\n  stopFrameMonitoring(): void;\n\n  /**\n   * Get current frame metrics.\n   */\n  getFrameMetrics(): Promise<FrameMetrics | null>;\n\n  /**\n   * Get current refresh rate.\n   */\n  getRefreshRate(): Promise<number | null>;\n}\n"]}