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

package/dist/esm/instrumentations/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/http/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseInstrumentation, genShortID, VERSION } from '@grafana/faro-core';\n\nimport { notifyHttpRequestEnd, notifyHttpRequestStart } from '../userActions/httpRequestMonitor';\nimport { getPushEventOptionsWithActionContext } from '../utils/actionContext';\n\nimport { buildFetchEventAttributes } from './utils';\nimport type { HttpRequestPayload } from './utils';\n\nconst FARO_TRACING_FETCH_EVENT = 'faro.tracing.fetch';\n\nexport type { HttpRequestPayload } from './utils';\n\n/**\n * Compute request body size in bytes (best-effort).\n * FormData and ReadableStream do not expose length without consuming.\n */\nfunction getRequestSize(body: BodyInit | null | undefined): number | undefined {\n  if (body == null) return undefined;\n  if (typeof body === 'string') return new Blob([body]).size;\n  if (body instanceof ArrayBuffer) return body.byteLength;\n  if (ArrayBuffer.isView(body)) return body.byteLength;\n  if (typeof Blob !== 'undefined' && body instanceof Blob) return body.size;\n  if (body instanceof URLSearchParams) return new Blob([body.toString()]).size;\n  return undefined;\n}\n\n/**\n * HTTP instrumentation for React Native\n *\n * Tracks fetch API calls and emits faro.tracing.fetch events (Web SDK format).\n * Compatible with Grafana Frontend Observability HTTP insights.\n * Automatically captures:\n * - Request URL, method, and timing\n * - Response status codes (0 for network errors)\n * - Request duration\n * - Request/response size (bytes; best-effort)\n * - Network errors\n *\n * @example\n * ```tsx\n * import { initializeFaro } from '@grafana/faro-react-native';\n * import { HttpInstrumentation } from '@grafana/faro-react-native';\n *\n * initializeFaro({\n *   // ...config\n *   instrumentations: [\n *     new HttpInstrumentation({\n *       ignoredUrls: [/localhost/, /127\\.0\\.0\\.1/],\n *     }),\n *   ],\n * });\n * ```\n */\nexport class HttpInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-http';\n  readonly version = VERSION;\n\n  private originalFetch?: typeof fetch;\n  private ignoredUrls: RegExp[];\n  private requests: Map<string, HttpRequestPayload> = new Map();\n\n  constructor(options: { ignoredUrls?: RegExp[] } = {}) {\n    super();\n    this.ignoredUrls = options.ignoredUrls || [];\n  }\n\n  initialize(): void {\n    this.logInfo('HTTP instrumentation initialized');\n    this.patchFetch();\n  }\n\n  unpatch(): void {\n    if (this.originalFetch) {\n      global.fetch = this.originalFetch;\n      this.originalFetch = undefined;\n    }\n    this.requests.clear();\n  }\n\n  private isUrlIgnored(url: string): boolean {\n    // Ignore the Faro collector URL to avoid tracking our own telemetry\n    if (url.includes('grafana.net/collect')) {\n      return true;\n    }\n\n    // Check user-provided ignored URLs\n    if (this.ignoredUrls.some((pattern) => pattern.test(url))) {\n      return true;\n    }\n\n    // Check config ignore URLs (includes transport URLs)\n    const configIgnoreUrls = this.config?.ignoreUrls || [];\n    if (\n      configIgnoreUrls.some((pattern) => {\n        if (typeof pattern === 'string') {\n          return url.includes(pattern);\n        }\n        return pattern.test(url);\n      })\n    ) {\n      return true;\n    }\n\n    return false;\n  }\n\n  private patchFetch(): void {\n    if (this.originalFetch) {\n      return; // Already patched\n    }\n\n    this.originalFetch = global.fetch;\n    const self = this;\n\n    global.fetch = function (input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n      const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url || '';\n      // Extract method from Request object or init options\n      const requestMethod = typeof input !== 'string' && !(input instanceof URL) ? input.method : undefined;\n      const method = (init?.method || requestMethod || 'GET').toUpperCase();\n\n      if (self.isUrlIgnored(url)) {\n        return self.originalFetch!.call(this, input, init);\n      }\n\n      const requestId = genShortID();\n      const startTime = Date.now();\n      const body = init?.body;\n      const requestSize = getRequestSize(body);\n\n      const payload: HttpRequestPayload = {\n        url,\n        method,\n        requestId,\n        startTime,\n        requestSize,\n      };\n\n      self.requests.set(requestId, payload);\n\n      // Notify user action monitor\n      notifyHttpRequestStart(payload);\n\n      return self\n        .originalFetch!.call(this, input, init)\n        .then((response) => {\n          const endTime = Date.now();\n          const duration = endTime - startTime;\n          const contentLength = response.headers.get('content-length');\n          const responseSize = contentLength ? parseInt(contentLength, 10) : undefined;\n          payload.responseSize =\n            responseSize != null && !Number.isNaN(responseSize) && responseSize >= 0 ? responseSize : undefined;\n\n          payload.endTime = endTime;\n          payload.duration = duration;\n          payload.status = response.status;\n\n          // Notify user action monitor\n          notifyHttpRequestEnd(payload);\n\n          // Emit faro.tracing.fetch event (Web SDK format for Grafana HTTP insights)\n          // Include action context when active so HTTP errors show in user action table\n          const attributes = buildFetchEventAttributes(payload);\n          const pushOptions = getPushEventOptionsWithActionContext();\n          self.api?.pushEvent(FARO_TRACING_FETCH_EVENT, attributes, undefined, pushOptions);\n\n          self.logDebug(\n            `HTTP request → ${method} ${url} | status=${response.status} duration=${duration}ms` +\n              (requestSize != null ? ` request_size=${requestSize}` : '') +\n              (payload.responseSize != null ? ` response_size=${payload.responseSize}` : '')\n          );\n\n          self.requests.delete(requestId);\n          return response;\n        })\n        .catch((error) => {\n          const endTime = Date.now();\n          const duration = endTime - startTime;\n\n          payload.endTime = endTime;\n          payload.duration = duration;\n          payload.error = error?.message || 'Unknown error';\n\n          // Notify user action monitor\n          notifyHttpRequestEnd(payload);\n\n          // Emit faro.tracing.fetch event for failed request (status 0 = network error)\n          const attributes = buildFetchEventAttributes(payload);\n          const pushOptions = getPushEventOptionsWithActionContext();\n          self.api?.pushEvent(FARO_TRACING_FETCH_EVENT, attributes, undefined, pushOptions);\n\n          self.logDebug(\n            `HTTP request error → ${method} ${url} | error=${payload.error} duration=${duration}ms` +\n              (requestSize != null ? ` request_size=${requestSize}` : '')\n          );\n\n          self.requests.delete(requestId);\n          throw error;\n        });\n    };\n  }\n}\n"]}

package/dist/esm/instrumentations/http/utils.js

@@ -0,0 +1,43 @@
+/**
+ * Parse URL for scheme and host. Returns empty strings if parsing fails.
+ */
+export function parseUrlParts(url) {
+    try {
+        const parsed = new URL(url);
+        return {
+            scheme: parsed.protocol.replace(':', '') || 'http',
+            host: parsed.host || '',
+        };
+    }
+    catch (_a) {
+        return { scheme: 'http', host: '' };
+    }
+}
+/**
+ * Build Web SDK-style event attributes for faro.tracing.fetch.
+ * Aligns with Grafana HTTP insights and Frontend Observability plugin.
+ */
+export function buildFetchEventAttributes(payload) {
+    const { scheme, host } = parseUrlParts(payload.url);
+    const durationNs = payload.duration != null ? String(Math.round(payload.duration * 1000000)) : '';
+    const statusCode = payload.status != null ? String(payload.status) : '0';
+    const attrs = {
+        'http.url': payload.url,
+        'http.method': payload.method,
+        'http.scheme': scheme,
+        'http.host': host,
+        'http.status_code': statusCode,
+        duration_ns: durationNs,
+    };
+    if (payload.requestSize != null) {
+        attrs['http.request_size'] = String(payload.requestSize);
+    }
+    if (payload.responseSize != null) {
+        attrs['http.response_size'] = String(payload.responseSize);
+    }
+    if (payload.error) {
+        attrs['http.error'] = payload.error;
+    }
+    return attrs;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/instrumentations/http/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/instrumentations/http/utils.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM;YAClD,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;SACxB,CAAC;IACJ,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,OAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpG,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAEzE,MAAM,KAAK,GAA2B;QACpC,UAAU,EAAE,OAAO,CAAC,GAAG;QACvB,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,IAAI;QACjB,kBAAkB,EAAE,UAAU;QAC9B,WAAW,EAAE,UAAU;KACxB,CAAC;IAEF,IAAI,OAAO,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QACjC,KAAK,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["export interface HttpRequestPayload {\n  url: string;\n  method: string;\n  requestId: string;\n  startTime: number;\n  endTime?: number;\n  duration?: number;\n  status?: number;\n  error?: string;\n  requestSize?: number;\n  responseSize?: number;\n}\n\n/**\n * Parse URL for scheme and host. Returns empty strings if parsing fails.\n */\nexport function parseUrlParts(url: string): { scheme: string; host: string } {\n  try {\n    const parsed = new URL(url);\n    return {\n      scheme: parsed.protocol.replace(':', '') || 'http',\n      host: parsed.host || '',\n    };\n  } catch {\n    return { scheme: 'http', host: '' };\n  }\n}\n\n/**\n * Build Web SDK-style event attributes for faro.tracing.fetch.\n * Aligns with Grafana HTTP insights and Frontend Observability plugin.\n */\nexport function buildFetchEventAttributes(payload: HttpRequestPayload): Record<string, string> {\n  const { scheme, host } = parseUrlParts(payload.url);\n  const durationNs = payload.duration != null ? String(Math.round(payload.duration * 1_000_000)) : '';\n  const statusCode = payload.status != null ? String(payload.status) : '0';\n\n  const attrs: Record<string, string> = {\n    'http.url': payload.url,\n    'http.method': payload.method,\n    'http.scheme': scheme,\n    'http.host': host,\n    'http.status_code': statusCode,\n    duration_ns: durationNs,\n  };\n\n  if (payload.requestSize != null) {\n    attrs['http.request_size'] = String(payload.requestSize);\n  }\n  if (payload.responseSize != null) {\n    attrs['http.response_size'] = String(payload.responseSize);\n  }\n  if (payload.error) {\n    attrs['http.error'] = payload.error;\n  }\n\n  return attrs;\n}\n"]}

package/dist/esm/instrumentations/performance/index.js

@@ -0,0 +1,148 @@
+import { NativeModules } from 'react-native';
+import { BaseInstrumentation, VERSION } from '@grafana/faro-core';
+const { FaroReactNativeModule } = NativeModules;
+/**
+ * Measures React Native app performance metrics (CPU and Memory usage)
+ *
+ * Collects periodic performance metrics using native OS APIs:
+ * - iOS: task_info() for memory, host_statistics() for CPU
+ * - Android: /proc/[pid]/status for memory, /proc/[pid]/stat for CPU
+ *
+ * Implementation ported from Faro Flutter SDK with feature parity.
+ *
+ * **Key Features**:
+ * - ✅ NO manual setup required - OS tracks metrics automatically!
+ * - ✅ Periodic collection (default: every 30 seconds)
+ * - ✅ Configurable per-metric enable/disable
+ * - ✅ Differential CPU calculation (accurate usage percentages)
+ * - ✅ Memory usage in KB (Resident Set Size)
+ *
+ * **Metrics Captured**:
+ * - `mem_usage`: Current memory usage in KB (RSS - physical memory)
+ * - `cpu_usage`: Current CPU usage percentage (0-100+)
+ *
+ * **Requirements**:
+ * - iOS 13.4+ (any iOS that supports React Native)
+ * - Android API 21+ for CPU (Android 5.0 Lollipop, ~99% of devices)
+ * - Android any version for Memory
+ *
+ * @example
+ * ```tsx
+ * import { initializeFaro, getRNInstrumentations } from '@grafana/faro-react-native';
+ *
+ * initializeFaro({
+ *   url: 'https://your-collector.com',
+ *   instrumentations: [
+ *     ...getRNInstrumentations({
+ *       memoryUsageVitals: true,      // default: true
+ *       cpuUsageVitals: true,          // default: true
+ *       fetchVitalsInterval: 30000,    // default: 30s
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export class PerformanceInstrumentation extends BaseInstrumentation {
+    constructor(options = {}) {
+        var _a, _b, _c;
+        super();
+        this.name = '@grafana/faro-react-native:instrumentation-performance';
+        this.version = VERSION;
+        this.intervalId = null;
+        this.options = {
+            memoryUsageVitals: (_a = options.memoryUsageVitals) !== null && _a !== void 0 ? _a : true,
+            cpuUsageVitals: (_b = options.cpuUsageVitals) !== null && _b !== void 0 ? _b : true,
+            fetchVitalsInterval: (_c = options.fetchVitalsInterval) !== null && _c !== void 0 ? _c : 30000,
+        };
+    }
+    initialize() {
+        // Only start if at least one metric is enabled
+        if (!this.options.memoryUsageVitals && !this.options.cpuUsageVitals) {
+            this.logInfo('Performance monitoring disabled - no metrics enabled');
+            return;
+        }
+        // Check native module availability
+        if (!FaroReactNativeModule) {
+            this.logWarn('Native module not available. Performance instrumentation requires native module. ' +
+                'Run `cd ios && pod install` and rebuild the app.');
+            return;
+        }
+        // Start periodic collection
+        this.startPeriodicCollection();
+    }
+    startPeriodicCollection() {
+        // Collect immediately on initialization
+        this.collectMetrics();
+        // Then collect periodically
+        this.intervalId = setInterval(() => {
+            this.collectMetrics();
+        }, this.options.fetchVitalsInterval);
+        this.logInfo(`Performance monitoring started - collecting every ${this.options.fetchVitalsInterval}ms ` +
+            `(memory: ${this.options.memoryUsageVitals}, cpu: ${this.options.cpuUsageVitals})`);
+    }
+    collectMetrics() {
+        // Collect memory if enabled
+        if (this.options.memoryUsageVitals) {
+            this.collectMemoryUsage();
+        }
+        // Collect CPU if enabled
+        if (this.options.cpuUsageVitals) {
+            this.collectCpuUsage();
+        }
+    }
+    collectMemoryUsage() {
+        try {
+            if (!(FaroReactNativeModule === null || FaroReactNativeModule === void 0 ? void 0 : FaroReactNativeModule.getMemoryUsage)) {
+                this.logDebug('Memory: getMemoryUsage not available on native module');
+                return;
+            }
+            const memoryUsage = FaroReactNativeModule.getMemoryUsage();
+            if (memoryUsage == null || memoryUsage <= 0) {
+                this.logDebug('Memory: skipping - value is null or <= 0');
+                return;
+            }
+            this.logDebug(`Memory: pushing measurement with mem_usage = ${memoryUsage}`);
+            this.api.pushMeasurement({
+                type: 'app_memory',
+                values: { mem_usage: memoryUsage },
+            });
+        }
+        catch (error) {
+            this.logError('Failed to collect memory usage', error);
+        }
+    }
+    collectCpuUsage() {
+        try {
+            if (!(FaroReactNativeModule === null || FaroReactNativeModule === void 0 ? void 0 : FaroReactNativeModule.getCpuUsage)) {
+                this.logDebug('CPU: getCpuUsage not available on native module');
+                return;
+            }
+            const cpuUsage = FaroReactNativeModule.getCpuUsage();
+            this.logDebug(`CPU: raw value = ${cpuUsage}`);
+            // Validate CPU usage (Flutter SDK filters 0-100 range, but allows >100)
+            // Skip null, negative, or exactly 0 (baseline reading)
+            if (cpuUsage == null || cpuUsage <= 0) {
+                this.logDebug('CPU: skipping - value is null or <= 0');
+                return;
+            }
+            this.logDebug(`CPU: pushing measurement with cpu_usage = ${cpuUsage}`);
+            // Flutter SDK also filters values >= 100, but we allow them as they can be valid
+            // in multi-core scenarios where one core is maxed out
+            this.api.pushMeasurement({
+                type: 'app_cpu_usage',
+                values: { cpu_usage: cpuUsage },
+            });
+        }
+        catch (error) {
+            this.logError('Failed to collect CPU usage', error);
+        }
+    }
+    unpatch() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+            this.logInfo('Performance monitoring stopped');
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/instrumentations/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/performance/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeModules } from 'react-native';\n\nimport { BaseInstrumentation, VERSION } from '@grafana/faro-core';\n\nimport type { PerformanceInstrumentationOptions } from './types';\n\nconst { FaroReactNativeModule } = NativeModules;\n\n/**\n * Measures React Native app performance metrics (CPU and Memory usage)\n *\n * Collects periodic performance metrics using native OS APIs:\n * - iOS: task_info() for memory, host_statistics() for CPU\n * - Android: /proc/[pid]/status for memory, /proc/[pid]/stat for CPU\n *\n * Implementation ported from Faro Flutter SDK with feature parity.\n *\n * **Key Features**:\n * - ✅ NO manual setup required - OS tracks metrics automatically!\n * - ✅ Periodic collection (default: every 30 seconds)\n * - ✅ Configurable per-metric enable/disable\n * - ✅ Differential CPU calculation (accurate usage percentages)\n * - ✅ Memory usage in KB (Resident Set Size)\n *\n * **Metrics Captured**:\n * - `mem_usage`: Current memory usage in KB (RSS - physical memory)\n * - `cpu_usage`: Current CPU usage percentage (0-100+)\n *\n * **Requirements**:\n * - iOS 13.4+ (any iOS that supports React Native)\n * - Android API 21+ for CPU (Android 5.0 Lollipop, ~99% of devices)\n * - Android any version for Memory\n *\n * @example\n * ```tsx\n * import { initializeFaro, getRNInstrumentations } from '@grafana/faro-react-native';\n *\n * initializeFaro({\n *   url: 'https://your-collector.com',\n *   instrumentations: [\n *     ...getRNInstrumentations({\n *       memoryUsageVitals: true,      // default: true\n *       cpuUsageVitals: true,          // default: true\n *       fetchVitalsInterval: 30000,    // default: 30s\n *     }),\n *   ],\n * });\n * ```\n */\nexport class PerformanceInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-performance';\n  readonly version = VERSION;\n\n  private options: Required<PerformanceInstrumentationOptions>;\n  private intervalId: ReturnType<typeof setInterval> | null = null;\n\n  constructor(options: PerformanceInstrumentationOptions = {}) {\n    super();\n    this.options = {\n      memoryUsageVitals: options.memoryUsageVitals ?? true,\n      cpuUsageVitals: options.cpuUsageVitals ?? true,\n      fetchVitalsInterval: options.fetchVitalsInterval ?? 30000,\n    };\n  }\n\n  initialize(): void {\n    // Only start if at least one metric is enabled\n    if (!this.options.memoryUsageVitals && !this.options.cpuUsageVitals) {\n      this.logInfo('Performance monitoring disabled - no metrics enabled');\n      return;\n    }\n\n    // Check native module availability\n    if (!FaroReactNativeModule) {\n      this.logWarn(\n        'Native module not available. Performance instrumentation requires native module. ' +\n          'Run `cd ios && pod install` and rebuild the app.'\n      );\n      return;\n    }\n\n    // Start periodic collection\n    this.startPeriodicCollection();\n  }\n\n  private startPeriodicCollection(): void {\n    // Collect immediately on initialization\n    this.collectMetrics();\n\n    // Then collect periodically\n    this.intervalId = setInterval(() => {\n      this.collectMetrics();\n    }, this.options.fetchVitalsInterval);\n\n    this.logInfo(\n      `Performance monitoring started - collecting every ${this.options.fetchVitalsInterval}ms ` +\n        `(memory: ${this.options.memoryUsageVitals}, cpu: ${this.options.cpuUsageVitals})`\n    );\n  }\n\n  private collectMetrics(): void {\n    // Collect memory if enabled\n    if (this.options.memoryUsageVitals) {\n      this.collectMemoryUsage();\n    }\n\n    // Collect CPU if enabled\n    if (this.options.cpuUsageVitals) {\n      this.collectCpuUsage();\n    }\n  }\n\n  private collectMemoryUsage(): void {\n    try {\n      if (!FaroReactNativeModule?.getMemoryUsage) {\n        this.logDebug('Memory: getMemoryUsage not available on native module');\n        return;\n      }\n\n      const memoryUsage = FaroReactNativeModule.getMemoryUsage();\n      if (memoryUsage == null || memoryUsage <= 0) {\n        this.logDebug('Memory: skipping - value is null or <= 0');\n        return;\n      }\n\n      this.logDebug(`Memory: pushing measurement with mem_usage = ${memoryUsage}`);\n      this.api.pushMeasurement({\n        type: 'app_memory',\n        values: { mem_usage: memoryUsage },\n      });\n    } catch (error) {\n      this.logError('Failed to collect memory usage', error);\n    }\n  }\n\n  private collectCpuUsage(): void {\n    try {\n      if (!FaroReactNativeModule?.getCpuUsage) {\n        this.logDebug('CPU: getCpuUsage not available on native module');\n        return;\n      }\n\n      const cpuUsage = FaroReactNativeModule.getCpuUsage();\n      this.logDebug(`CPU: raw value = ${cpuUsage}`);\n\n      // Validate CPU usage (Flutter SDK filters 0-100 range, but allows >100)\n      // Skip null, negative, or exactly 0 (baseline reading)\n      if (cpuUsage == null || cpuUsage <= 0) {\n        this.logDebug('CPU: skipping - value is null or <= 0');\n        return;\n      }\n\n      this.logDebug(`CPU: pushing measurement with cpu_usage = ${cpuUsage}`);\n      // Flutter SDK also filters values >= 100, but we allow them as they can be valid\n      // in multi-core scenarios where one core is maxed out\n      this.api.pushMeasurement({\n        type: 'app_cpu_usage',\n        values: { cpu_usage: cpuUsage },\n      });\n    } catch (error) {\n      this.logError('Failed to collect CPU usage', error);\n    }\n  }\n\n  unpatch(): void {\n    if (this.intervalId) {\n      clearInterval(this.intervalId);\n      this.intervalId = null;\n      this.logInfo('Performance monitoring stopped');\n    }\n  }\n}\n"]}

package/dist/esm/instrumentations/performance/performanceUtils.js

@@ -0,0 +1,131 @@
+import { Platform } from 'react-native';
+/**
+ * Convert a numeric value to a performance timing string (rounded to nearest ms)
+ * Follows the same pattern as web SDK for consistency
+ */
+export function toPerformanceTimingString(value) {
+    if (value == null || typeof value !== 'number') {
+        return 'unknown';
+    }
+    // Round to nearest millisecond and ensure non-negative
+    return Math.round(value > 0 ? value : 0).toString();
+}
+/**
+ * Get current platform information
+ */
+export function getPlatformInfo() {
+    return {
+        platform: Platform.OS,
+        platformVersion: Platform.Version.toString(),
+    };
+}
+/**
+ * Get current timestamp in milliseconds
+ * Uses performance.now() for high-resolution timing
+ */
+export function now() {
+    if (typeof performance !== 'undefined' && performance.now) {
+        return performance.now();
+    }
+    return Date.now();
+}
+/**
+ * Simple performance marker for tracking timing
+ */
+export class PerformanceMarker {
+    constructor() {
+        this.startTime = now();
+    }
+    /**
+     * Mark the end time and return duration
+     */
+    end() {
+        this.endTime = now();
+        return this.getDuration();
+    }
+    /**
+     * Get duration in milliseconds
+     * If not ended, returns time elapsed so far
+     */
+    getDuration() {
+        var _a;
+        const end = (_a = this.endTime) !== null && _a !== void 0 ? _a : now();
+        return end - this.startTime;
+    }
+    /**
+     * Get the start time
+     */
+    getStartTime() {
+        return this.startTime;
+    }
+    /**
+     * Check if marker has been ended
+     */
+    hasEnded() {
+        return this.endTime !== undefined;
+    }
+}
+/**
+ * Global timing storage for tracking app lifecycle
+ */
+class PerformanceTimingStore {
+    constructor() {
+        this.timings = new Map();
+        this.markers = new Map();
+    }
+    /**
+     * Store a timing value
+     */
+    set(key, value) {
+        this.timings.set(key, value);
+    }
+    /**
+     * Get a timing value
+     */
+    get(key) {
+        return this.timings.get(key);
+    }
+    /**
+     * Start a performance marker
+     */
+    startMarker(key) {
+        const marker = new PerformanceMarker();
+        this.markers.set(key, marker);
+        return marker;
+    }
+    /**
+     * End a performance marker and return duration
+     */
+    endMarker(key) {
+        const marker = this.markers.get(key);
+        if (!marker) {
+            return undefined;
+        }
+        return marker.end();
+    }
+    /**
+     * Get a performance marker
+     */
+    getMarker(key) {
+        return this.markers.get(key);
+    }
+    /**
+     * Check if a marker exists
+     */
+    hasMarker(key) {
+        return this.markers.has(key);
+    }
+    /**
+     * Clear all timings and markers
+     */
+    clear() {
+        this.timings.clear();
+        this.markers.clear();
+    }
+}
+/**
+ * Global performance timing store
+ * Used to track app-wide performance metrics
+ */
+export const performanceStore = new PerformanceTimingStore();
+//# sourceMappingURL=performanceUtils.js.map

package/dist/esm/instrumentations/performance/performanceUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceUtils.js","sourceRoot":"","sources":["../../../../src/instrumentations/performance/performanceUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\n/**\n * Convert a numeric value to a performance timing string (rounded to nearest ms)\n * Follows the same pattern as web SDK for consistency\n */\nexport function toPerformanceTimingString(value: number | null | undefined): string {\n  if (value == null || typeof value !== 'number') {\n    return 'unknown';\n  }\n\n  // Round to nearest millisecond and ensure non-negative\n  return Math.round(value > 0 ? value : 0).toString();\n}\n\n/**\n * Get current platform information\n */\nexport function getPlatformInfo(): { platform: string; platformVersion: string } {\n  return {\n    platform: Platform.OS,\n    platformVersion: Platform.Version.toString(),\n  };\n}\n\n/**\n * Get current timestamp in milliseconds\n * Uses performance.now() for high-resolution timing\n */\nexport function now(): number {\n  if (typeof performance !== 'undefined' && performance.now) {\n    return performance.now();\n  }\n  return Date.now();\n}\n\n/**\n * Simple performance marker for tracking timing\n */\nexport class PerformanceMarker {\n  private startTime: number;\n  private endTime?: number;\n\n  constructor() {\n    this.startTime = now();\n  }\n\n  /**\n   * Mark the end time and return duration\n   */\n  end(): number {\n    this.endTime = now();\n    return this.getDuration();\n  }\n\n  /**\n   * Get duration in milliseconds\n   * If not ended, returns time elapsed so far\n   */\n  getDuration(): number {\n    const end = this.endTime ?? now();\n    return end - this.startTime;\n  }\n\n  /**\n   * Get the start time\n   */\n  getStartTime(): number {\n    return this.startTime;\n  }\n\n  /**\n   * Check if marker has been ended\n   */\n  hasEnded(): boolean {\n    return this.endTime !== undefined;\n  }\n}\n\n/**\n * Global timing storage for tracking app lifecycle\n */\nclass PerformanceTimingStore {\n  private timings: Map<string, number> = new Map();\n  private markers: Map<string, PerformanceMarker> = new Map();\n\n  /**\n   * Store a timing value\n   */\n  set(key: string, value: number): void {\n    this.timings.set(key, value);\n  }\n\n  /**\n   * Get a timing value\n   */\n  get(key: string): number | undefined {\n    return this.timings.get(key);\n  }\n\n  /**\n   * Start a performance marker\n   */\n  startMarker(key: string): PerformanceMarker {\n    const marker = new PerformanceMarker();\n    this.markers.set(key, marker);\n    return marker;\n  }\n\n  /**\n   * End a performance marker and return duration\n   */\n  endMarker(key: string): number | undefined {\n    const marker = this.markers.get(key);\n    if (!marker) {\n      return undefined;\n    }\n    return marker.end();\n  }\n\n  /**\n   * Get a performance marker\n   */\n  getMarker(key: string): PerformanceMarker | undefined {\n    return this.markers.get(key);\n  }\n\n  /**\n   * Check if a marker exists\n   */\n  hasMarker(key: string): boolean {\n    return this.markers.has(key);\n  }\n\n  /**\n   * Clear all timings and markers\n   */\n  clear(): void {\n    this.timings.clear();\n    this.markers.clear();\n  }\n}\n\n/**\n * Global performance timing store\n * Used to track app-wide performance metrics\n */\nexport const performanceStore = new PerformanceTimingStore();\n"]}

package/dist/esm/instrumentations/performance/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/instrumentations/performance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/instrumentations/performance/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface PerformanceInstrumentationOptions {\n  memoryUsageVitals?: boolean;\n  cpuUsageVitals?: boolean;\n  fetchVitalsInterval?: number;\n}\n"]}

package/dist/esm/instrumentations/session/index.js

@@ -0,0 +1,133 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { BaseInstrumentation, dateNow, EVENT_SESSION_START, genShortID, VERSION } from '@grafana/faro-core';
+import { getSessionAttributes } from './sessionAttributes';
+import { getSessionManagerByConfig, isSampled } from './sessionManager';
+import { PersistentSessionsManager } from './sessionManager/PersistentSessionsManager';
+import { MAX_SESSION_PERSISTENCE_TIME } from './sessionManager/sessionConstants';
+import { createUserSessionObject, isUserSessionValid } from './sessionManager/sessionManagerUtils';
+/**
+ * Session instrumentation for React Native
+ * Manages persistent or volatile sessions with expiration and inactivity tracking
+ */
+export class SessionInstrumentation extends BaseInstrumentation {
+    constructor() {
+        super(...arguments);
+        this.name = '@grafana/faro-react-native:instrumentation-session';
+        this.version = VERSION;
+    }
+    sendSessionStartEvent(meta) {
+        var _a;
+        const session = meta.session;
+        if (session && session.id !== ((_a = this.notifiedSession) === null || _a === void 0 ? void 0 : _a.id)) {
+            this.notifiedSession = session;
+            // no need to add attributes and session id, they are included as part of meta
+            // automatically
+            this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });
+        }
+    }
+    createInitialSession(SessionManager, sessionsConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g;
+            let storedUserSession = yield SessionManager.fetchUserSession();
+            const sessionsConfigTyped = sessionsConfig;
+            const maxPersistenceMs = (_a = sessionsConfigTyped.maxSessionPersistenceTime) !== null && _a !== void 0 ? _a : MAX_SESSION_PERSISTENCE_TIME;
+            if (sessionsConfig.persistent && storedUserSession) {
+                const now = dateNow();
+                const shouldClearPersistentSession = storedUserSession.lastActivity < now - maxPersistenceMs;
+                if (shouldClearPersistentSession) {
+                    yield PersistentSessionsManager.removeUserSession();
+                    storedUserSession = null;
+                }
+            }
+            // Get default session attributes (device info, SDK version, etc.)
+            // These match the Flutter SDK's default session attributes
+            const defaultAttributes = yield getSessionAttributes();
+            let emitSessionStartOnInit;
+            let initialSession;
+            if (isUserSessionValid(storedUserSession)) {
+                const sessionId = storedUserSession === null || storedUserSession === void 0 ? void 0 : storedUserSession.sessionId;
+                initialSession = createUserSessionObject({
+                    sessionId,
+                    isSampled: storedUserSession.isSampled || false,
+                    started: storedUserSession === null || storedUserSession === void 0 ? void 0 : storedUserSession.started,
+                });
+                const storedUserSessionMeta = storedUserSession === null || storedUserSession === void 0 ? void 0 : storedUserSession.sessionMeta;
+                // For resumed sessions we want to merge the previous overrides with the configured ones.
+                // If the same key is present in both, the new one will override the old one.
+                const overrides = Object.assign(Object.assign({}, (_b = sessionsConfig.session) === null || _b === void 0 ? void 0 : _b.overrides), storedUserSessionMeta === null || storedUserSessionMeta === void 0 ? void 0 : storedUserSessionMeta.overrides);
+                initialSession.sessionMeta = Object.assign(Object.assign({}, sessionsConfig.session), { id: sessionId, attributes: Object.assign(Object.assign(Object.assign(Object.assign({}, (_c = sessionsConfig.session) === null || _c === void 0 ? void 0 : _c.attributes), storedUserSessionMeta === null || storedUserSessionMeta === void 0 ? void 0 : storedUserSessionMeta.attributes), defaultAttributes), { 
+                        // For valid resumed sessions we do not want to recalculate the sampling decision on each init phase.
+                        isSampled: initialSession.isSampled.toString() }), overrides });
+                emitSessionStartOnInit = false;
+            }
+            else {
+                const sessionId = (_e = (_d = sessionsConfig.session) === null || _d === void 0 ? void 0 : _d.id) !== null && _e !== void 0 ? _e : genShortID();
+                initialSession = createUserSessionObject({
+                    sessionId,
+                    isSampled: isSampled(),
+                });
+                const overrides = (_f = sessionsConfig.session) === null || _f === void 0 ? void 0 : _f.overrides;
+                initialSession.sessionMeta = Object.assign({ id: sessionId, attributes: Object.assign(Object.assign({ isSampled: initialSession.isSampled.toString() }, (_g = sessionsConfig.session) === null || _g === void 0 ? void 0 : _g.attributes), defaultAttributes) }, (overrides ? { overrides } : {}));
+                emitSessionStartOnInit = true;
+            }
+            return { initialSession, emitSessionStartOnInit };
+        });
+    }
+    registerBeforeSendHook(SessionManager) {
+        var _a;
+        const { updateSession } = new SessionManager();
+        (_a = this.transports) === null || _a === void 0 ? void 0 : _a.addBeforeSendHooks((item) => {
+            var _a, _b, _c;
+            updateSession();
+            const attributes = (_a = item.meta.session) === null || _a === void 0 ? void 0 : _a.attributes;
+            if (attributes && (attributes === null || attributes === void 0 ? void 0 : attributes['isSampled']) === 'true') {
+                let newItem = JSON.parse(JSON.stringify(item));
+                const newAttributes = (_b = newItem.meta.session) === null || _b === void 0 ? void 0 : _b.attributes;
+                newAttributes === null || newAttributes === void 0 ? true : delete newAttributes['isSampled'];
+                if (Object.keys(newAttributes !== null && newAttributes !== void 0 ? newAttributes : {}).length === 0) {
+                    (_c = newItem.meta.session) === null || _c === void 0 ? true : delete _c.attributes;
+                }
+                return newItem;
+            }
+            return null;
+        });
+    }
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.logDebug('init session instrumentation');
+            const sessionTrackingConfig = this.config.sessionTracking;
+            if (sessionTrackingConfig === null || sessionTrackingConfig === void 0 ? void 0 : sessionTrackingConfig.enabled) {
+                const SessionManager = getSessionManagerByConfig(sessionTrackingConfig);
+                this.registerBeforeSendHook(SessionManager);
+                const { initialSession, emitSessionStartOnInit } = yield this.createInitialSession(SessionManager, sessionTrackingConfig);
+                yield SessionManager.storeUserSession(initialSession);
+                const initialSessionMeta = initialSession.sessionMeta;
+                this.notifiedSession = initialSessionMeta;
+                this.api.setSession(initialSessionMeta);
+                // Store the session manager instance for cleanup
+                this.sessionManagerInstance = new SessionManager();
+                if (emitSessionStartOnInit) {
+                    this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });
+                }
+            }
+            this.metas.addListener(this.sendSessionStartEvent.bind(this));
+        });
+    }
+    /**
+     * Clean up session manager listeners
+     */
+    unpatch() {
+        if (this.sessionManagerInstance && 'unpatch' in this.sessionManagerInstance) {
+            this.sessionManagerInstance.unpatch();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/instrumentations/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/session/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseInstrumentation, dateNow, EVENT_SESSION_START, genShortID, VERSION } from '@grafana/faro-core';\nimport type { Config, Meta, MetaSession, TransportItem } from '@grafana/faro-core';\n\nimport type { ReactNativeSessionTrackingConfig } from '../../config/types';\n\nimport { getSessionAttributes } from './sessionAttributes';\nimport { type FaroUserSession, getSessionManagerByConfig, isSampled } from './sessionManager';\nimport { PersistentSessionsManager } from './sessionManager/PersistentSessionsManager';\nimport { MAX_SESSION_PERSISTENCE_TIME } from './sessionManager/sessionConstants';\nimport { createUserSessionObject, isUserSessionValid } from './sessionManager/sessionManagerUtils';\nimport type { SessionManager } from './sessionManager/types';\n\n/**\n * Session instrumentation for React Native\n * Manages persistent or volatile sessions with expiration and inactivity tracking\n */\nexport class SessionInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-session';\n  readonly version = VERSION;\n\n  // previously notified session, to ensure we don't send session start\n  // event twice for the same session\n  private notifiedSession: MetaSession | undefined;\n  private sessionManagerInstance: InstanceType<SessionManager> | undefined;\n\n  private sendSessionStartEvent(meta: Meta): void {\n    const session = meta.session;\n\n    if (session && session.id !== this.notifiedSession?.id) {\n      this.notifiedSession = session;\n      // no need to add attributes and session id, they are included as part of meta\n      // automatically\n      this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });\n    }\n  }\n\n  private async createInitialSession(\n    SessionManager: SessionManager,\n    sessionsConfig: Required<Config>['sessionTracking']\n  ): Promise<{\n    initialSession: FaroUserSession;\n    emitSessionStartOnInit: boolean;\n  }> {\n    let storedUserSession: FaroUserSession | null = await SessionManager.fetchUserSession();\n\n    const sessionsConfigTyped = sessionsConfig as ReactNativeSessionTrackingConfig;\n    const maxPersistenceMs = sessionsConfigTyped.maxSessionPersistenceTime ?? MAX_SESSION_PERSISTENCE_TIME;\n\n    if (sessionsConfig.persistent && storedUserSession) {\n      const now = dateNow();\n      const shouldClearPersistentSession = storedUserSession.lastActivity < now - maxPersistenceMs;\n\n      if (shouldClearPersistentSession) {\n        await PersistentSessionsManager.removeUserSession();\n        storedUserSession = null;\n      }\n    }\n\n    // Get default session attributes (device info, SDK version, etc.)\n    // These match the Flutter SDK's default session attributes\n    const defaultAttributes = await getSessionAttributes();\n\n    let emitSessionStartOnInit: boolean;\n    let initialSession: FaroUserSession;\n\n    if (isUserSessionValid(storedUserSession)) {\n      const sessionId = storedUserSession?.sessionId;\n\n      initialSession = createUserSessionObject({\n        sessionId,\n        isSampled: storedUserSession!.isSampled || false,\n        started: storedUserSession?.started,\n      });\n\n      const storedUserSessionMeta = storedUserSession?.sessionMeta;\n\n      // For resumed sessions we want to merge the previous overrides with the configured ones.\n      // If the same key is present in both, the new one will override the old one.\n      const overrides = { ...sessionsConfig.session?.overrides, ...storedUserSessionMeta?.overrides };\n\n      initialSession.sessionMeta = {\n        ...sessionsConfig.session,\n        id: sessionId,\n        attributes: {\n          // Start with custom attributes from config\n          ...sessionsConfig.session?.attributes,\n          // Merge with stored attributes\n          ...storedUserSessionMeta?.attributes,\n          // Default attributes take precedence (matching Flutter SDK behavior)\n          ...defaultAttributes,\n          // For valid resumed sessions we do not want to recalculate the sampling decision on each init phase.\n          isSampled: initialSession.isSampled.toString(),\n        },\n        overrides,\n      };\n\n      emitSessionStartOnInit = false;\n    } else {\n      const sessionId = sessionsConfig.session?.id ?? genShortID();\n\n      initialSession = createUserSessionObject({\n        sessionId,\n        isSampled: isSampled(),\n      });\n\n      const overrides = sessionsConfig.session?.overrides;\n\n      initialSession.sessionMeta = {\n        id: sessionId,\n        attributes: {\n          isSampled: initialSession.isSampled.toString(),\n          // Start with custom attributes from config\n          ...sessionsConfig.session?.attributes,\n          // Default attributes take precedence (matching Flutter SDK behavior)\n          ...defaultAttributes,\n        },\n        // new session we don't care about previous overrides\n        ...(overrides ? { overrides } : {}),\n      };\n\n      emitSessionStartOnInit = true;\n    }\n\n    return { initialSession, emitSessionStartOnInit };\n  }\n\n  private registerBeforeSendHook(SessionManager: SessionManager) {\n    const { updateSession } = new SessionManager();\n\n    this.transports?.addBeforeSendHooks((item: TransportItem) => {\n      updateSession();\n\n      const attributes = item.meta.session?.attributes;\n\n      if (attributes && attributes?.['isSampled'] === 'true') {\n        let newItem: TransportItem = JSON.parse(JSON.stringify(item));\n\n        const newAttributes = newItem.meta.session?.attributes;\n        delete newAttributes?.['isSampled'];\n\n        if (Object.keys(newAttributes ?? {}).length === 0) {\n          delete newItem.meta.session?.attributes;\n        }\n\n        return newItem;\n      }\n\n      return null;\n    });\n  }\n\n  async initialize(): Promise<void> {\n    this.logDebug('init session instrumentation');\n\n    const sessionTrackingConfig = this.config.sessionTracking;\n\n    if (sessionTrackingConfig?.enabled) {\n      const SessionManager = getSessionManagerByConfig(sessionTrackingConfig);\n\n      this.registerBeforeSendHook(SessionManager);\n\n      const { initialSession, emitSessionStartOnInit } = await this.createInitialSession(\n        SessionManager,\n        sessionTrackingConfig\n      );\n\n      await SessionManager.storeUserSession(initialSession);\n\n      const initialSessionMeta = initialSession.sessionMeta;\n\n      this.notifiedSession = initialSessionMeta;\n      this.api.setSession(initialSessionMeta);\n\n      // Store the session manager instance for cleanup\n      this.sessionManagerInstance = new SessionManager();\n\n      if (emitSessionStartOnInit) {\n        this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });\n      }\n    }\n\n    this.metas.addListener(this.sendSessionStartEvent.bind(this));\n  }\n\n  /**\n   * Clean up session manager listeners\n   */\n  unpatch(): void {\n    if (this.sessionManagerInstance && 'unpatch' in this.sessionManagerInstance) {\n      this.sessionManagerInstance.unpatch();\n    }\n  }\n}\n"]}