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

package/README.md

@@ -47,7 +47,12 @@ initializeFaro({
   fetchVitalsInterval: 30000, // optional, ms
   frameMonitoringOptions: {}, // optional, when refreshRateVitals true
   enableTracing: false, // optional, requires @grafana/faro-react-native-tracing
-  tracingOptions: {}, // optional
+  tracingOptions: {
+    instrumentationOptions: {
+      // Traces fetch() by default. Enable this for axios/direct XHR apps.
+      enableXhrInstrumentation: false,
+    },
+  }, // optional
 
   // Instrumentation options - optional
   consoleCaptureOptions: {},
@@ -85,8 +90,8 @@ initializeFaro({
 - **App State Instrumentation** - Tracks when app goes to background/foreground
 - **Performance Instrumentation** - Monitors CPU usage, memory usage, and app startup time using native OS APIs
 - **Startup Instrumentation** - Automatically tracks app startup duration from process start
-- **HTTP Instrumentation** - Tracks HTTP requests (fetch) and correlates them with user actions
-- **XHR Instrumentation** - Tracks XMLHttpRequest calls (replaced by TracingInstrumentation when `enableTracing` is true)
+- **HTTP Instrumentation** - Tracks `fetch()` requests and correlates them with user actions
+- **XHR Instrumentation** - Tracks `XMLHttpRequest` calls when tracing is disabled; with `enableTracing: true`, enable XHR tracing via `tracingOptions.instrumentationOptions.enableXhrInstrumentation`
 
 **Enabled by default** (opt-out via config):
 
@@ -268,6 +273,47 @@ faro.api.pushEvent('purchase_completed', {
 });
 ```
 
+### Logging
+
+Send log messages with different severity levels using the `LogLevel` enum:
+
+```tsx
+import { faro, LogLevel } from '@grafana/faro-react-native';
+
+// Default level (LogLevel.LOG) when no level is specified
+faro.api.pushLog(['Application started']);
+
+// Explicit log levels
+faro.api.pushLog(['User signed in'], { level: LogLevel.INFO });
+faro.api.pushLog(['Cache hit ratio: 0.95'], { level: LogLevel.DEBUG });
+faro.api.pushLog(['Retrying request, attempt 3'], { level: LogLevel.WARN });
+faro.api.pushLog(['Payment processing failed'], { level: LogLevel.ERROR });
+faro.api.pushLog(['Entering auth flow'], { level: LogLevel.TRACE });
+```
+
+**Available log levels** (from `LogLevel` enum):
+
+| Level            | Description                                        |
+| ---------------- | -------------------------------------------------- |
+| `LogLevel.TRACE` | Fine-grained diagnostic information                |
+| `LogLevel.DEBUG` | Detailed information useful during development     |
+| `LogLevel.INFO`  | General informational messages                     |
+| `LogLevel.LOG`   | Standard log messages (default when omitted)       |
+| `LogLevel.WARN`  | Potentially harmful situations                     |
+| `LogLevel.ERROR` | Error events that might still allow the app to run |
+
+You can also attach additional context to log messages:
+
+```tsx
+faro.api.pushLog(['Order placed'], {
+  level: LogLevel.INFO,
+  context: {
+    orderId: 'order-456',
+    userId: 'user-123',
+  },
+});
+```
+
 ### Performance Measurements
 
 Track performance metrics:
@@ -1147,7 +1193,7 @@ See the [demo](../../demo) directory for a complete example application.
 
 - `initializeFaro(config: ReactNativeConfig): void` - Initialize the Faro SDK
 - `faro.api.pushEvent(name: string, attributes?: Record<string, string>)` - Track custom events
-- `faro.api.pushLog(message: string, options?: PushLogOptions)` - Send log messages
+- `faro.api.pushLog(message: string[], options?: PushLogOptions)` - Send log messages. Use `options.level` with the `LogLevel` enum (`TRACE`, `DEBUG`, `INFO`, `LOG`, `WARN`, `ERROR`) to set severity. Defaults to `LogLevel.LOG`.
 - `faro.api.pushError(error: Error, options?: PushErrorOptions)` - Report errors
 - `faro.api.pushMeasurement(measurement: Measurement)` - Track performance
 - `faro.api.setUser(user: User)` - Identify users

package/dist/cjs/config/getRNInstrumentations.js

@@ -97,13 +97,15 @@ function getRNInstrumentations(config) {
             instrumentations.push(new xhr_1.XHRInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));
         }
     }
-    // Performance vitals (CPU/memory)
-    var perfInstrumentation = new performance_1.PerformanceInstrumentation({
-        memoryUsageVitals: memoryUsageVitals,
-        cpuUsageVitals: cpuUsageVitals,
-        fetchVitalsInterval: fetchVitalsInterval,
-    });
-    instrumentations.push(perfInstrumentation);
+    // Performance vitals (CPU/memory) - only add if at least one metric is enabled
+    if (cpuUsageVitals || memoryUsageVitals) {
+        var perfInstrumentation = new performance_1.PerformanceInstrumentation({
+            memoryUsageVitals: memoryUsageVitals,
+            cpuUsageVitals: cpuUsageVitals,
+            fetchVitalsInterval: fetchVitalsInterval,
+        });
+        instrumentations.push(perfInstrumentation);
+    }
     // Startup tracking - always enabled
     instrumentations.push(new startup_1.StartupInstrumentation());
     // Frame monitoring: enabled when refreshRateVitals is true

package/dist/cjs/config/getRNInstrumentations.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRNInstrumentations.js","sourceRoot":"","sources":["../../../src/config/getRNInstrumentations.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\nimport type { Instrumentation, Patterns } from '@grafana/faro-core';\n\nimport { ANRInstrumentation } from '../instrumentations/anr';\nimport { AppStateInstrumentation } from '../instrumentations/appState';\nimport { ConsoleInstrumentation } from '../instrumentations/console';\nimport { CrashReportingInstrumentation } from '../instrumentations/crashReporting';\nimport { ErrorsInstrumentation } from '../instrumentations/errors';\nimport { FrameMonitoringInstrumentation } from '../instrumentations/frameMonitoring';\nimport { HttpInstrumentation } from '../instrumentations/http';\nimport { PerformanceInstrumentation } from '../instrumentations/performance';\nimport { SessionInstrumentation } from '../instrumentations/session';\nimport { StartupInstrumentation } from '../instrumentations/startup';\nimport { UserActionInstrumentation } from '../instrumentations/userActions';\nimport { ViewInstrumentation } from '../instrumentations/view';\nimport { XHRInstrumentation } from '../instrumentations/xhr';\n\nimport type { ReactNativeConfig } from './types';\n\n/** Convert Patterns (string | RegExp)[] to RegExp[] for instrumentations that require RegExp[]. */\nfunction toRegExpArray(patterns: Patterns): RegExp[] {\n  return patterns.map((p) => (typeof p === 'string' ? new RegExp(p.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')) : p));\n}\n\n/**\n * Returns the default set of instrumentations for React Native.\n *\n * Reads all options from the Faro config (single source of truth).\n * Property names are aligned with Flutter SDK FaroConfig:\n * - cpuUsageVitals, memoryUsageVitals, anrTracking, refreshRateVitals\n * - enableCrashReporting, enableErrorReporting\n * - fetchVitalsInterval, ignoreUrls\n *\n * @example\n * ```ts\n * const config: ReactNativeConfig = {\n *   app: { name: 'my-app', version: '1.0.0' },\n *   cpuUsageVitals: true,\n *   memoryUsageVitals: true,\n *   anrTracking: true,\n *   refreshRateVitals: true,\n *   enableCrashReporting: true,\n *   fetchVitalsInterval: 30000,\n *   instrumentations: getRNInstrumentations(config),\n * };\n * ```\n */\nexport function getRNInstrumentations(config: Partial<ReactNativeConfig> = {}): Instrumentation[] {\n  // Aligned with Flutter SDK FaroConfig defaults\n  const {\n    // Error & crash tracking\n    enableErrorReporting = true,\n    enableCrashReporting = false,\n    anrTracking = false,\n    anrOptions = {},\n\n    // Performance vitals\n    cpuUsageVitals = true,\n    memoryUsageVitals = true,\n    refreshRateVitals = false,\n    fetchVitalsInterval = 30000,\n    frameMonitoringOptions = {},\n\n    // Network\n    ignoreUrls = [],\n    enableHttpInstrumentation = {},\n\n    // Console and user actions\n    enableConsoleCapture = true,\n    enableUserActions = true,\n\n    // Tracing\n    enableTracing = false,\n    tracingOptions = {},\n  } = config;\n\n  const instrumentations: Instrumentation[] = [];\n\n  // Error reporting (Flutter: enableFlutterErrorReporting)\n  if (enableErrorReporting) {\n    instrumentations.push(new ErrorsInstrumentation());\n  }\n\n  // Console capture - not in Flutter SDK, RN-specific\n  if (enableConsoleCapture) {\n    instrumentations.push(new ConsoleInstrumentation());\n  }\n\n  // Sessions - always enabled in Flutter, same here\n  instrumentations.push(new SessionInstrumentation());\n\n  // Views - always enabled in Flutter, same here\n  instrumentations.push(new ViewInstrumentation());\n\n  // App state - always enabled in Flutter, same here\n  instrumentations.push(new AppStateInstrumentation());\n\n  // User actions - enabled by default, opt-out via enableUserActions\n  if (enableUserActions) {\n    instrumentations.push(new UserActionInstrumentation());\n  }\n\n  // HTTP/XHR tracking: when tracing is enabled, TracingInstrumentation patches fetch and XHR.\n  // When tracing is disabled, add HttpInstrumentation and/or XHRInstrumentation per enableHttpInstrumentation.\n  if (!enableTracing) {\n    const { fetch: enableFetch = true, xhr: enableXhr = true } = enableHttpInstrumentation;\n    const ignoredUrlsRegExp = toRegExpArray(ignoreUrls);\n    if (enableFetch) {\n      instrumentations.push(new HttpInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n    if (enableXhr) {\n      instrumentations.push(new XHRInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n  }\n\n  // Performance vitals (CPU/memory)\n  const perfInstrumentation = new PerformanceInstrumentation({\n    memoryUsageVitals,\n    cpuUsageVitals,\n    fetchVitalsInterval,\n  });\n  instrumentations.push(perfInstrumentation);\n\n  // Startup tracking - always enabled\n  instrumentations.push(new StartupInstrumentation());\n\n  // Frame monitoring: enabled when refreshRateVitals is true\n  // The instrumentation reads refreshRateVitals from faro.config (single source of truth)\n  if (refreshRateVitals) {\n    instrumentations.push(new FrameMonitoringInstrumentation(frameMonitoringOptions));\n  }\n\n  // ANR detection (Android only)\n  if (anrTracking && Platform.OS === 'android') {\n    instrumentations.push(new ANRInstrumentation(anrOptions));\n  }\n\n  // Crash reporting\n  if (enableCrashReporting) {\n    instrumentations.push(new CrashReportingInstrumentation());\n  }\n\n  if (enableTracing) {\n    try {\n      const { TracingInstrumentation } = require('@grafana/faro-react-native-tracing');\n      instrumentations.push(new TracingInstrumentation(tracingOptions));\n    } catch {\n      console.warn(\n        '[Faro] enableTracing is true but @grafana/faro-react-native-tracing is not installed. ' +\n          'Add it to use tracing: yarn add @grafana/faro-react-native-tracing'\n      );\n    }\n  }\n\n  return instrumentations;\n}\n"]}
+{"version":3,"file":"getRNInstrumentations.js","sourceRoot":"","sources":["../../../src/config/getRNInstrumentations.ts"],"names":[],"mappings":";;AAgDA,sDA8GC;AA9JD,6CAAwC;AAIxC,+CAA6D;AAC7D,yDAAuE;AACvE,uDAAqE;AACrE,qEAAmF;AACnF,qDAAmE;AACnE,uEAAqF;AACrF,iDAA+D;AAC/D,+DAA6E;AAC7E,uDAAqE;AACrE,uDAAqE;AACrE,+DAA4E;AAC5E,iDAA+D;AAC/D,+CAA6D;AAI7D,mGAAmG;AACnG,SAAS,aAAa,CAAC,QAAkB;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAlF,CAAkF,CAAC,CAAC;AACjH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,qBAAqB,CAAC,MAAuC;IAAvC,uBAAA,EAAA,WAAuC;IAC3E,+CAA+C;IAG7C;IADA,yBAAyB;IACzB,KAuBE,MAAM,qBAvBmB;IAD3B,yBAAyB;IACzB,oBAAoB,mBAAG,IAAI,KAAA,EAC3B,KAsBE,MAAM,qBAtBoB,EAA5B,oBAAoB,mBAAG,KAAK,KAAA,EAC5B,KAqBE,MAAM,YArBW,EAAnB,WAAW,mBAAG,KAAK,KAAA,EACnB,KAoBE,MAAM,WApBO,EAAf,UAAU,mBAAG,EAAE,KAAA;IAEf,qBAAqB;IACrB,KAiBE,MAAM,eAjBa;IADrB,qBAAqB;IACrB,cAAc,mBAAG,IAAI,KAAA,EACrB,KAgBE,MAAM,kBAhBgB,EAAxB,iBAAiB,mBAAG,IAAI,KAAA,EACxB,KAeE,MAAM,kBAfiB,EAAzB,iBAAiB,mBAAG,KAAK,KAAA,EACzB,KAcE,MAAM,oBAdmB,EAA3B,mBAAmB,mBAAG,KAAK,KAAA,EAC3B,KAaE,MAAM,uBAbmB,EAA3B,sBAAsB,mBAAG,EAAE,KAAA;IAE3B,UAAU;IACV,KAUE,MAAM,WAVO;IADf,UAAU;IACV,UAAU,mBAAG,EAAE,KAAA,EACf,KASE,MAAM,0BATsB,EAA9B,yBAAyB,mBAAG,EAAE,KAAA;IAE9B,2BAA2B;IAC3B,KAME,MAAM,qBANmB;IAD3B,2BAA2B;IAC3B,oBAAoB,mBAAG,IAAI,KAAA,EAC3B,KAKE,MAAM,kBALgB,EAAxB,iBAAiB,mBAAG,IAAI,KAAA;IAExB,UAAU;IACV,KAEE,MAAM,cAFa;IADrB,UAAU;IACV,aAAa,mBAAG,KAAK,KAAA,EACrB,KACE,MAAM,eADW,EAAnB,cAAc,mBAAG,EAAE,KAAA,CACV;IAEX,IAAM,gBAAgB,GAAsB,EAAE,CAAC;IAE/C,yDAAyD;IACzD,IAAI,oBAAoB,EAAE,CAAC;QACzB,gBAAgB,CAAC,IAAI,CAAC,IAAI,8BAAqB,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,oDAAoD;IACpD,IAAI,oBAAoB,EAAE,CAAC;QACzB,gBAAgB,CAAC,IAAI,CAAC,IAAI,gCAAsB,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,kDAAkD;IAClD,gBAAgB,CAAC,IAAI,CAAC,IAAI,gCAAsB,EAAE,CAAC,CAAC;IAEpD,+CAA+C;IAC/C,gBAAgB,CAAC,IAAI,CAAC,IAAI,0BAAmB,EAAE,CAAC,CAAC;IAEjD,mDAAmD;IACnD,gBAAgB,CAAC,IAAI,CAAC,IAAI,kCAAuB,EAAE,CAAC,CAAC;IAErD,mEAAmE;IACnE,IAAI,iBAAiB,EAAE,CAAC;QACtB,gBAAgB,CAAC,IAAI,CAAC,IAAI,uCAAyB,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,4FAA4F;IAC5F,6GAA6G;IAC7G,IAAI,CAAC,aAAa,EAAE,CAAC;QACX,IAAA,KAAqD,yBAAyB,MAArD,EAAlB,WAAW,mBAAG,IAAI,KAAA,EAAE,KAA0B,yBAAyB,IAA9B,EAAhB,SAAS,mBAAG,IAAI,KAAA,CAA+B;QACvF,IAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,WAAW,EAAE,CAAC;YAChB,gBAAgB,CAAC,IAAI,CAAC,IAAI,0BAAmB,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,gBAAgB,CAAC,IAAI,CAAC,IAAI,wBAAkB,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,IAAI,cAAc,IAAI,iBAAiB,EAAE,CAAC;QACxC,IAAM,mBAAmB,GAAG,IAAI,wCAA0B,CAAC;YACzD,iBAAiB,mBAAA;YACjB,cAAc,gBAAA;YACd,mBAAmB,qBAAA;SACpB,CAAC,CAAC;QACH,gBAAgB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC7C,CAAC;IAED,oCAAoC;IACpC,gBAAgB,CAAC,IAAI,CAAC,IAAI,gCAAsB,EAAE,CAAC,CAAC;IAEpD,2DAA2D;IAC3D,wFAAwF;IACxF,IAAI,iBAAiB,EAAE,CAAC;QACtB,gBAAgB,CAAC,IAAI,CAAC,IAAI,gDAA8B,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,+BAA+B;IAC/B,IAAI,WAAW,IAAI,uBAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7C,gBAAgB,CAAC,IAAI,CAAC,IAAI,wBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,kBAAkB;IAClB,IAAI,oBAAoB,EAAE,CAAC;QACzB,gBAAgB,CAAC,IAAI,CAAC,IAAI,8CAA6B,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC;YACK,IAAA,sBAAsB,GAAK,OAAO,CAAC,oCAAoC,CAAC,uBAAlD,CAAmD;YACjF,gBAAgB,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,CAAC,IAAI,CACV,wFAAwF;gBACtF,oEAAoE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC","sourcesContent":["import { Platform } from 'react-native';\n\nimport type { Instrumentation, Patterns } from '@grafana/faro-core';\n\nimport { ANRInstrumentation } from '../instrumentations/anr';\nimport { AppStateInstrumentation } from '../instrumentations/appState';\nimport { ConsoleInstrumentation } from '../instrumentations/console';\nimport { CrashReportingInstrumentation } from '../instrumentations/crashReporting';\nimport { ErrorsInstrumentation } from '../instrumentations/errors';\nimport { FrameMonitoringInstrumentation } from '../instrumentations/frameMonitoring';\nimport { HttpInstrumentation } from '../instrumentations/http';\nimport { PerformanceInstrumentation } from '../instrumentations/performance';\nimport { SessionInstrumentation } from '../instrumentations/session';\nimport { StartupInstrumentation } from '../instrumentations/startup';\nimport { UserActionInstrumentation } from '../instrumentations/userActions';\nimport { ViewInstrumentation } from '../instrumentations/view';\nimport { XHRInstrumentation } from '../instrumentations/xhr';\n\nimport type { ReactNativeConfig } from './types';\n\n/** Convert Patterns (string | RegExp)[] to RegExp[] for instrumentations that require RegExp[]. */\nfunction toRegExpArray(patterns: Patterns): RegExp[] {\n  return patterns.map((p) => (typeof p === 'string' ? new RegExp(p.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')) : p));\n}\n\n/**\n * Returns the default set of instrumentations for React Native.\n *\n * Reads all options from the Faro config (single source of truth).\n * Property names are aligned with Flutter SDK FaroConfig:\n * - cpuUsageVitals, memoryUsageVitals, anrTracking, refreshRateVitals\n * - enableCrashReporting, enableErrorReporting\n * - fetchVitalsInterval, ignoreUrls\n *\n * @example\n * ```ts\n * const config: ReactNativeConfig = {\n *   app: { name: 'my-app', version: '1.0.0' },\n *   cpuUsageVitals: true,\n *   memoryUsageVitals: true,\n *   anrTracking: true,\n *   refreshRateVitals: true,\n *   enableCrashReporting: true,\n *   fetchVitalsInterval: 30000,\n *   instrumentations: getRNInstrumentations(config),\n * };\n * ```\n */\nexport function getRNInstrumentations(config: Partial<ReactNativeConfig> = {}): Instrumentation[] {\n  // Aligned with Flutter SDK FaroConfig defaults\n  const {\n    // Error & crash tracking\n    enableErrorReporting = true,\n    enableCrashReporting = false,\n    anrTracking = false,\n    anrOptions = {},\n\n    // Performance vitals\n    cpuUsageVitals = true,\n    memoryUsageVitals = true,\n    refreshRateVitals = false,\n    fetchVitalsInterval = 30000,\n    frameMonitoringOptions = {},\n\n    // Network\n    ignoreUrls = [],\n    enableHttpInstrumentation = {},\n\n    // Console and user actions\n    enableConsoleCapture = true,\n    enableUserActions = true,\n\n    // Tracing\n    enableTracing = false,\n    tracingOptions = {},\n  } = config;\n\n  const instrumentations: Instrumentation[] = [];\n\n  // Error reporting (Flutter: enableFlutterErrorReporting)\n  if (enableErrorReporting) {\n    instrumentations.push(new ErrorsInstrumentation());\n  }\n\n  // Console capture - not in Flutter SDK, RN-specific\n  if (enableConsoleCapture) {\n    instrumentations.push(new ConsoleInstrumentation());\n  }\n\n  // Sessions - always enabled in Flutter, same here\n  instrumentations.push(new SessionInstrumentation());\n\n  // Views - always enabled in Flutter, same here\n  instrumentations.push(new ViewInstrumentation());\n\n  // App state - always enabled in Flutter, same here\n  instrumentations.push(new AppStateInstrumentation());\n\n  // User actions - enabled by default, opt-out via enableUserActions\n  if (enableUserActions) {\n    instrumentations.push(new UserActionInstrumentation());\n  }\n\n  // HTTP/XHR tracking: when tracing is enabled, TracingInstrumentation patches fetch and XHR.\n  // When tracing is disabled, add HttpInstrumentation and/or XHRInstrumentation per enableHttpInstrumentation.\n  if (!enableTracing) {\n    const { fetch: enableFetch = true, xhr: enableXhr = true } = enableHttpInstrumentation;\n    const ignoredUrlsRegExp = toRegExpArray(ignoreUrls);\n    if (enableFetch) {\n      instrumentations.push(new HttpInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n    if (enableXhr) {\n      instrumentations.push(new XHRInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n  }\n\n  // Performance vitals (CPU/memory) - only add if at least one metric is enabled\n  if (cpuUsageVitals || memoryUsageVitals) {\n    const perfInstrumentation = new PerformanceInstrumentation({\n      memoryUsageVitals,\n      cpuUsageVitals,\n      fetchVitalsInterval,\n    });\n    instrumentations.push(perfInstrumentation);\n  }\n\n  // Startup tracking - always enabled\n  instrumentations.push(new StartupInstrumentation());\n\n  // Frame monitoring: enabled when refreshRateVitals is true\n  // The instrumentation reads refreshRateVitals from faro.config (single source of truth)\n  if (refreshRateVitals) {\n    instrumentations.push(new FrameMonitoringInstrumentation(frameMonitoringOptions));\n  }\n\n  // ANR detection (Android only)\n  if (anrTracking && Platform.OS === 'android') {\n    instrumentations.push(new ANRInstrumentation(anrOptions));\n  }\n\n  // Crash reporting\n  if (enableCrashReporting) {\n    instrumentations.push(new CrashReportingInstrumentation());\n  }\n\n  if (enableTracing) {\n    try {\n      const { TracingInstrumentation } = require('@grafana/faro-react-native-tracing');\n      instrumentations.push(new TracingInstrumentation(tracingOptions));\n    } catch {\n      console.warn(\n        '[Faro] enableTracing is true but @grafana/faro-react-native-tracing is not installed. ' +\n          'Add it to use tracing: yarn add @grafana/faro-react-native-tracing'\n      );\n    }\n  }\n\n  return instrumentations;\n}\n"]}

package/dist/cjs/config/makeRNConfig.js

@@ -24,6 +24,7 @@ exports.makeRNConfig = makeRNConfig;
 var faro_core_1 = require("@grafana/faro-core");
 var stackTraceParser_1 = require("../instrumentations/errors/stackTraceParser");
 var sessionConstants_1 = require("../instrumentations/session/sessionManager/sessionConstants");
+var internalLogger_1 = require("../internalLogger");
 var page_1 = require("../metas/page");
 var screen_1 = require("../metas/screen");
 var sdk_1 = require("../metas/sdk");
@@ -53,7 +54,7 @@ function buildTransports(config) {
         apiKey: config.apiKey,
     }));
     if (enableTransports.console) {
-        builtTransports.push(new console_1.ConsoleTransport({ level: faro_core_1.LogLevel.DEBUG }));
+        builtTransports.push(new console_1.ConsoleTransport({ level: internalLogger_1.LogLevel.DEBUG }));
     }
     var extraTransports = (_a = config.transports) !== null && _a !== void 0 ? _a : [];
     return __spreadArray(__spreadArray([], builtTransports, true), extraTransports, true);
@@ -78,38 +79,21 @@ var parseStacktrace = function (err) { return ({
  *
  * Based on flags, builds instrumentations and transports automatically.
  * Client just enables what they need; makeRNConfig does the rest.
+ *
+ * @param preloadedSessionDeviceAttributes Device/session fields for session meta (passed from async `initializeFaro`).
  */
-function makeRNConfig(config) {
+function makeRNConfig(config, preloadedSessionDeviceAttributes) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     var defaultMetas = [(0, sdk_1.getSdkMeta)(), (0, page_1.getPageMeta)(), (0, screen_1.getScreenMeta)()];
     var customMetas = (_a = config.metas) !== null && _a !== void 0 ? _a : [];
     var transports = buildTransports(config);
     var instrumentations = buildInstrumentations(config);
-    return {
-        app: config.app,
-        dedupe: (_b = config.dedupe) !== null && _b !== void 0 ? _b : true,
-        globalObjectKey: (_c = config.globalObjectKey) !== null && _c !== void 0 ? _c : faro_core_1.defaultGlobalObjectKey,
-        internalLoggerLevel: (_d = config.internalLoggerLevel) !== null && _d !== void 0 ? _d : faro_core_1.InternalLoggerLevel.ERROR,
-        isolate: (_e = config.isolate) !== null && _e !== void 0 ? _e : false,
-        parseStacktrace: (_f = config.parseStacktrace) !== null && _f !== void 0 ? _f : parseStacktrace,
-        paused: (_g = config.paused) !== null && _g !== void 0 ? _g : false,
-        preventGlobalExposure: (_h = config.preventGlobalExposure) !== null && _h !== void 0 ? _h : false,
-        unpatchedConsole: (_j = config.unpatchedConsole) !== null && _j !== void 0 ? _j : faro_core_1.defaultUnpatchedConsole,
-        batching: {
+    return __assign(__assign({ app: config.app }, (preloadedSessionDeviceAttributes != null && {
+        preloadedSessionDeviceAttributes: preloadedSessionDeviceAttributes,
+    })), { dedupe: (_b = config.dedupe) !== null && _b !== void 0 ? _b : true, globalObjectKey: (_c = config.globalObjectKey) !== null && _c !== void 0 ? _c : faro_core_1.defaultGlobalObjectKey, internalLoggerLevel: (_d = config.internalLoggerLevel) !== null && _d !== void 0 ? _d : internalLogger_1.InternalLoggerLevel.ERROR, isolate: (_e = config.isolate) !== null && _e !== void 0 ? _e : false, parseStacktrace: (_f = config.parseStacktrace) !== null && _f !== void 0 ? _f : parseStacktrace, paused: (_g = config.paused) !== null && _g !== void 0 ? _g : false, preventGlobalExposure: (_h = config.preventGlobalExposure) !== null && _h !== void 0 ? _h : false, unpatchedConsole: (_j = config.unpatchedConsole) !== null && _j !== void 0 ? _j : faro_core_1.defaultUnpatchedConsole, batching: {
             enabled: false,
             sendTimeout: 250,
             itemLimit: 50,
-        },
-        sessionTracking: __assign(__assign({}, sessionConstants_1.defaultSessionTrackingConfig), config.sessionTracking),
-        metas: __spreadArray(__spreadArray([], defaultMetas, true), customMetas, true),
-        instrumentations: instrumentations,
-        transports: transports,
-        ignoreUrls: (_k = config.ignoreUrls) !== null && _k !== void 0 ? _k : [],
-        ignoreErrors: config.ignoreErrors,
-        beforeSend: config.beforeSend,
-        preserveOriginalError: config.preserveOriginalError,
-        userActionsInstrumentation: config.userActionsOptions,
-        consoleInstrumentation: config.consoleCaptureOptions,
-    };
+        }, sessionTracking: __assign(__assign({}, sessionConstants_1.defaultSessionTrackingConfig), config.sessionTracking), metas: __spreadArray(__spreadArray([], defaultMetas, true), customMetas, true), instrumentations: instrumentations, transports: transports, ignoreUrls: (_k = config.ignoreUrls) !== null && _k !== void 0 ? _k : [], ignoreErrors: config.ignoreErrors, beforeSend: config.beforeSend, preserveOriginalError: config.preserveOriginalError, userActionsInstrumentation: config.userActionsOptions, consoleInstrumentation: config.consoleCaptureOptions });
 }
 //# sourceMappingURL=makeRNConfig.js.map

package/dist/cjs/config/makeRNConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"makeRNConfig.js","sourceRoot":"","sources":["../../../src/config/makeRNConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultGlobalObjectKey, defaultUnpatchedConsole, InternalLoggerLevel, LogLevel } from '@grafana/faro-core';\nimport type { Config } from '@grafana/faro-core';\n\nimport { getStackFramesFromError } from '../instrumentations/errors/stackTraceParser';\nimport { defaultSessionTrackingConfig } from '../instrumentations/session/sessionManager/sessionConstants';\nimport { getPageMeta } from '../metas/page';\nimport { getScreenMeta } from '../metas/screen';\nimport { getSdkMeta } from '../metas/sdk';\nimport { ConsoleTransport } from '../transports/console';\nimport { FetchTransport } from '../transports/fetch';\nimport { OfflineTransport } from '../transports/offline';\n\nimport { getRNInstrumentations } from './getRNInstrumentations';\nimport type { ReactNativeConfig, ReactNativeSessionTrackingConfig } from './types';\n\nconst DEFAULT_OFFLINE_CACHE_MS = 3 * 24 * 60 * 60 * 1000; // 3 days\n\n/**\n * Builds transports. FetchTransport is always added when url is provided.\n * User can enable offline and console via enableTransports.\n */\nfunction buildTransports(config: ReactNativeConfig): Config['transports'] {\n  const { enableTransports = { offline: false, console: false } } = config;\n\n  if (!config.url) {\n    throw new Error('url is required. Provide the Faro collector URL.');\n  }\n\n  const builtTransports: Config['transports'] = [];\n\n  if (enableTransports.offline) {\n    builtTransports.push(\n      new OfflineTransport({\n        maxCacheDurationMs: DEFAULT_OFFLINE_CACHE_MS,\n      })\n    );\n  }\n\n  builtTransports.push(\n    new FetchTransport({\n      url: config.url,\n      apiKey: config.apiKey,\n    })\n  );\n\n  if (enableTransports.console) {\n    builtTransports.push(new ConsoleTransport({ level: LogLevel.DEBUG }));\n  }\n\n  const extraTransports = config.transports ?? [];\n  return [...builtTransports, ...extraTransports];\n}\n\n/**\n * Builds instrumentations from config flags.\n */\nfunction buildInstrumentations(config: ReactNativeConfig): Config['instrumentations'] {\n  const baseInstrumentations = getRNInstrumentations(config);\n  const extraInstrumentations = config.instrumentations ?? [];\n  return [...baseInstrumentations, ...extraInstrumentations];\n}\n\n/**\n * React Native stacktrace parser. Uses getStackFramesFromError for RN-specific formats.\n */\nconst parseStacktrace: Config['parseStacktrace'] = (err) => ({\n  frames: getStackFramesFromError(err),\n});\n\n/**\n * Creates a full Faro config from React Native flag-based config.\n *\n * Based on flags, builds instrumentations and transports automatically.\n * Client just enables what they need; makeRNConfig does the rest.\n */\nexport function makeRNConfig(config: ReactNativeConfig): Config {\n  const defaultMetas = [getSdkMeta(), getPageMeta(), getScreenMeta()];\n  const customMetas = config.metas ?? [];\n  const transports = buildTransports(config);\n  const instrumentations = buildInstrumentations(config);\n\n  return {\n    app: config.app,\n    dedupe: config.dedupe ?? true,\n    globalObjectKey: config.globalObjectKey ?? defaultGlobalObjectKey,\n    internalLoggerLevel: config.internalLoggerLevel ?? InternalLoggerLevel.ERROR,\n    isolate: config.isolate ?? false,\n    parseStacktrace: config.parseStacktrace ?? parseStacktrace,\n    paused: config.paused ?? false,\n    preventGlobalExposure: config.preventGlobalExposure ?? false,\n    unpatchedConsole: config.unpatchedConsole ?? defaultUnpatchedConsole,\n    batching: {\n      enabled: false,\n      sendTimeout: 250,\n      itemLimit: 50,\n    },\n    sessionTracking: {\n      ...defaultSessionTrackingConfig,\n      ...config.sessionTracking,\n    } as ReactNativeSessionTrackingConfig,\n    metas: [...defaultMetas, ...customMetas],\n    instrumentations,\n    transports,\n    ignoreUrls: config.ignoreUrls ?? [],\n    ignoreErrors: config.ignoreErrors,\n    beforeSend: config.beforeSend,\n    preserveOriginalError: config.preserveOriginalError,\n    userActionsInstrumentation: config.userActionsOptions,\n    consoleInstrumentation: config.consoleCaptureOptions,\n  };\n}\n"]}
+{"version":3,"file":"makeRNConfig.js","sourceRoot":"","sources":["../../../src/config/makeRNConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultGlobalObjectKey, defaultUnpatchedConsole } from '@grafana/faro-core';\nimport type { Config } from '@grafana/faro-core';\n\nimport { getStackFramesFromError } from '../instrumentations/errors/stackTraceParser';\nimport type { SessionAttributes } from '../instrumentations/session/sessionAttributes';\nimport { defaultSessionTrackingConfig } from '../instrumentations/session/sessionManager/sessionConstants';\nimport { InternalLoggerLevel, LogLevel } from '../internalLogger';\nimport { getPageMeta } from '../metas/page';\nimport { getScreenMeta } from '../metas/screen';\nimport { getSdkMeta } from '../metas/sdk';\nimport { ConsoleTransport } from '../transports/console';\nimport { FetchTransport } from '../transports/fetch';\nimport { OfflineTransport } from '../transports/offline';\n\nimport { getRNInstrumentations } from './getRNInstrumentations';\nimport type { ReactNativeConfig, ReactNativeFullConfig } from './types';\n\nconst DEFAULT_OFFLINE_CACHE_MS = 3 * 24 * 60 * 60 * 1000; // 3 days\n\n/**\n * Builds transports. FetchTransport is always added when url is provided.\n * User can enable offline and console via enableTransports.\n */\nfunction buildTransports(config: ReactNativeConfig): Config['transports'] {\n  const { enableTransports = { offline: false, console: false } } = config;\n\n  if (!config.url) {\n    throw new Error('url is required. Provide the Faro collector URL.');\n  }\n\n  const builtTransports: Config['transports'] = [];\n\n  if (enableTransports.offline) {\n    builtTransports.push(\n      new OfflineTransport({\n        maxCacheDurationMs: DEFAULT_OFFLINE_CACHE_MS,\n      })\n    );\n  }\n\n  builtTransports.push(\n    new FetchTransport({\n      url: config.url,\n      apiKey: config.apiKey,\n    })\n  );\n\n  if (enableTransports.console) {\n    builtTransports.push(new ConsoleTransport({ level: LogLevel.DEBUG }));\n  }\n\n  const extraTransports = config.transports ?? [];\n  return [...builtTransports, ...extraTransports];\n}\n\n/**\n * Builds instrumentations from config flags.\n */\nfunction buildInstrumentations(config: ReactNativeConfig): Config['instrumentations'] {\n  const baseInstrumentations = getRNInstrumentations(config);\n  const extraInstrumentations = config.instrumentations ?? [];\n  return [...baseInstrumentations, ...extraInstrumentations];\n}\n\n/**\n * React Native stacktrace parser. Uses getStackFramesFromError for RN-specific formats.\n */\nconst parseStacktrace: Config['parseStacktrace'] = (err) => ({\n  frames: getStackFramesFromError(err),\n});\n\n/**\n * Creates a full Faro config from React Native flag-based config.\n *\n * Based on flags, builds instrumentations and transports automatically.\n * Client just enables what they need; makeRNConfig does the rest.\n *\n * @param preloadedSessionDeviceAttributes Device/session fields for session meta (passed from async `initializeFaro`).\n */\nexport function makeRNConfig(\n  config: ReactNativeConfig,\n  preloadedSessionDeviceAttributes?: SessionAttributes\n): ReactNativeFullConfig {\n  const defaultMetas = [getSdkMeta(), getPageMeta(), getScreenMeta()];\n  const customMetas = config.metas ?? [];\n  const transports = buildTransports(config);\n  const instrumentations = buildInstrumentations(config);\n\n  return {\n    app: config.app,\n    ...(preloadedSessionDeviceAttributes != null && {\n      preloadedSessionDeviceAttributes,\n    }),\n    dedupe: config.dedupe ?? true,\n    globalObjectKey: config.globalObjectKey ?? defaultGlobalObjectKey,\n    internalLoggerLevel: config.internalLoggerLevel ?? InternalLoggerLevel.ERROR,\n    isolate: config.isolate ?? false,\n    parseStacktrace: config.parseStacktrace ?? parseStacktrace,\n    paused: config.paused ?? false,\n    preventGlobalExposure: config.preventGlobalExposure ?? false,\n    unpatchedConsole: config.unpatchedConsole ?? defaultUnpatchedConsole,\n    batching: {\n      enabled: false,\n      sendTimeout: 250,\n      itemLimit: 50,\n    },\n    sessionTracking: {\n      ...defaultSessionTrackingConfig,\n      ...config.sessionTracking,\n    },\n    metas: [...defaultMetas, ...customMetas],\n    instrumentations,\n    transports,\n    ignoreUrls: config.ignoreUrls ?? [],\n    ignoreErrors: config.ignoreErrors,\n    beforeSend: config.beforeSend,\n    preserveOriginalError: config.preserveOriginalError,\n    userActionsInstrumentation: config.userActionsOptions,\n    consoleInstrumentation: config.consoleCaptureOptions,\n  };\n}\n"]}

package/dist/cjs/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Config } from '@grafana/faro-core';\n\nimport type { ANRInstrumentationOptions } from '../instrumentations/anr';\nimport type { FrameMonitoringOptions } from '../instrumentations/frameMonitoring';\n\nimport type { Sampling } from './sampling';\n\n/**\n * React Native session tracking config.\n * Extends Config['sessionTracking'] with sampling (Flutter-style) and RN-specific props.\n * Excludes samplingRate and sampler in favor of sampling.\n */\nexport type ReactNativeSessionTrackingConfig = Omit<\n  NonNullable<Config['sessionTracking']>,\n  'samplingRate' | 'sampler'\n> & {\n  /**\n   * Session sampling. Use {@link SamplingRate} for fixed rate or\n   * {@link SamplingFunction} for dynamic sampling.\n   */\n  sampling?: Sampling;\n};\n\n/**\n * Flags for enabling optional built-in transports.\n * FetchTransport is always instantiated when url is provided.\n */\nexport interface EnableTransportsConfig {\n  /** Enable OfflineTransport for caching when offline (default: false) */\n  offline?: boolean;\n  /** Enable ConsoleTransport to log telemetry to Metro console for debugging (default: false) */\n  console?: boolean;\n}\n\n/** RN-specific config: overrides + new props. Omit faro-core props we replace with RN equivalents. */\ntype ReactNativeConfigOverrides = {\n  /** Application metadata (required) */\n  app: Config['app'];\n  sessionTracking?: ReactNativeSessionTrackingConfig;\n  url?: string;\n  apiKey?: string;\n  enableTransports?: EnableTransportsConfig;\n  /**\n   * Which HTTP instrumentations to enable. When tracing is disabled, these control\n   * HttpInstrumentation (fetch) and XHRInstrumentation (xhr). Default: both true.\n   */\n  enableHttpInstrumentation?: {\n    /** HttpInstrumentation - patches fetch API (default: true) */\n    fetch?: boolean;\n    /** XHRInstrumentation - patches XMLHttpRequest (default: true) */\n    xhr?: boolean;\n  };\n  enableTracing?: boolean;\n  /** Passed to TracingInstrumentation. See TracingInstrumentationOptions in @grafana/faro-react-native-tracing. */\n  tracingOptions?: Record<string, unknown>;\n  cpuUsageVitals?: boolean;\n  memoryUsageVitals?: boolean;\n  refreshRateVitals?: boolean;\n  fetchVitalsInterval?: number;\n  frameMonitoringOptions?: FrameMonitoringOptions;\n  enableErrorReporting?: boolean;\n  enableCrashReporting?: boolean;\n  anrTracking?: boolean;\n  anrOptions?: ANRInstrumentationOptions;\n  enableConsoleCapture?: boolean;\n  consoleCaptureOptions?: Config['consoleInstrumentation'];\n  enableUserActions?: boolean;\n  userActionsOptions?: Config['userActionsInstrumentation'];\n};\n\n/**\n * React Native config: Config (omit replaced props) & overrides.\n * Omit: sessionTracking, consoleInstrumentation, userActionsInstrumentation.\n * instrumentations and transports inherited from Config for extras (built-ins come from flags).\n */\nexport type ReactNativeConfig = Partial<\n  Omit<Config, 'sessionTracking' | 'consoleInstrumentation' | 'userActionsInstrumentation'>\n> &\n  ReactNativeConfigOverrides;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Config } from '@grafana/faro-core';\n\nimport type { ANRInstrumentationOptions } from '../instrumentations/anr';\nimport type { FrameMonitoringOptions } from '../instrumentations/frameMonitoring';\nimport type { SessionAttributes } from '../instrumentations/session/sessionAttributes';\n\nimport type { Sampling } from './sampling';\n\n/**\n * React Native session tracking config.\n * Extends Config['sessionTracking'] with sampling (Flutter-style) and RN-specific props.\n * Excludes samplingRate and sampler in favor of sampling.\n *\n * When `persistent` is true, sessions are stored with [react-native-mmkv](https://github.com/mrousavy/react-native-mmkv)\n * (synchronous). Add `react-native-mmkv` to your app and rebuild native projects.\n */\nexport type ReactNativeSessionTrackingConfig = Omit<\n  NonNullable<Config['sessionTracking']>,\n  'samplingRate' | 'sampler'\n> & {\n  /**\n   * Session sampling. Use {@link SamplingRate} for fixed rate or\n   * {@link SamplingFunction} for dynamic sampling.\n   */\n  sampling?: Sampling;\n};\n\n/**\n * Flags for enabling optional built-in transports.\n * FetchTransport is always instantiated when url is provided.\n */\nexport interface EnableTransportsConfig {\n  /** Enable OfflineTransport for caching when offline (default: false) */\n  offline?: boolean;\n  /** Enable ConsoleTransport to log telemetry to Metro console for debugging (default: false) */\n  console?: boolean;\n}\n\n/** RN-specific config: overrides + new props. Omit faro-core props we replace with RN equivalents. */\ntype ReactNativeConfigOverrides = {\n  /** Application metadata (required) */\n  app: Config['app'];\n  sessionTracking?: ReactNativeSessionTrackingConfig;\n  url?: string;\n  apiKey?: string;\n  enableTransports?: EnableTransportsConfig;\n  /**\n   * Which HTTP instrumentations to enable. When tracing is disabled, these control\n   * HttpInstrumentation (fetch) and XHRInstrumentation (xhr). Default: both true.\n   */\n  enableHttpInstrumentation?: {\n    /** HttpInstrumentation - patches fetch API (default: true) */\n    fetch?: boolean;\n    /** XHRInstrumentation - patches XMLHttpRequest (default: true) */\n    xhr?: boolean;\n  };\n  enableTracing?: boolean;\n  /** Passed to TracingInstrumentation. See TracingInstrumentationOptions in @grafana/faro-react-native-tracing. */\n  tracingOptions?: Record<string, unknown>;\n  cpuUsageVitals?: boolean;\n  memoryUsageVitals?: boolean;\n  refreshRateVitals?: boolean;\n  fetchVitalsInterval?: number;\n  frameMonitoringOptions?: FrameMonitoringOptions;\n  enableErrorReporting?: boolean;\n  enableCrashReporting?: boolean;\n  anrTracking?: boolean;\n  anrOptions?: ANRInstrumentationOptions;\n  enableConsoleCapture?: boolean;\n  consoleCaptureOptions?: Config['consoleInstrumentation'];\n  enableUserActions?: boolean;\n  userActionsOptions?: Config['userActionsInstrumentation'];\n};\n\n/**\n * React Native config: Config (omit replaced props) & overrides.\n * Omit: sessionTracking, consoleInstrumentation, userActionsInstrumentation.\n * instrumentations and transports inherited from Config for extras (built-ins come from flags).\n */\nexport type ReactNativeConfig = Partial<\n  Omit<Config, 'sessionTracking' | 'consoleInstrumentation' | 'userActionsInstrumentation'>\n> &\n  ReactNativeConfigOverrides;\n\n/**\n * Internal full config returned by `makeRNConfig`.\n * Extends faro-core `Config` with RN-specific fields that instrumentations need at init time.\n */\nexport type ReactNativeFullConfig = Config & {\n  preloadedSessionDeviceAttributes?: SessionAttributes;\n};\n"]}

package/dist/cjs/generated/faroRNPackageMeta.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FARO_REACT_NATIVE_NPM_VERSION = exports.FARO_REACT_NATIVE_NPM_NAME = void 0;
+/**
+ * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.
+ */
+exports.FARO_REACT_NATIVE_NPM_NAME = '@grafana/faro-react-native';
+exports.FARO_REACT_NATIVE_NPM_VERSION = '1.1.0';
+//# sourceMappingURL=faroRNPackageMeta.js.map

package/dist/cjs/generated/faroRNPackageMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faroRNPackageMeta.js","sourceRoot":"","sources":["../../../src/generated/faroRNPackageMeta.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,0BAA0B,GAAG,4BAAqC,CAAC;AACnE,QAAA,6BAA6B,GAAG,OAAgB,CAAC","sourcesContent":["/**\n * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.\n */\nexport const FARO_REACT_NATIVE_NPM_NAME = '@grafana/faro-react-native' as const;\nexport const FARO_REACT_NATIVE_NPM_VERSION = '1.1.0' as const;\n"]}

package/dist/cjs/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = exports.onNavigationStateChange = exports.getRouteName = exports.getCurrentRoute = exports.createNavigationStateChangeHandler = exports.useFaroNavigation = exports.ReactNativeNavigationIntegration = exports.setUserPersistence = exports.initializeUserPersistence = exports.getUserPersistence = exports.createUserPersistence = exports.setDataCollectionPolicy = exports.initializeDataCollectionPolicy = exports.getDataCollectionPolicy = exports.createDataCollectionPolicy = exports.OfflineTransport = exports.ConsoleTransport = exports.FetchTransport = exports.getSdkMeta = exports.getScreenMeta = exports.getPageMeta = exports.withFaroErrorBoundary = exports.FaroErrorBoundary = exports.notifyHttpRequestStart = exports.notifyHttpRequestEnd = exports.trackUserAction = exports.withFaroUserAction = exports.reactNativeLogArgsSerializer = exports.CrashReportingInstrumentation = exports.ANRInstrumentation = exports.FrameMonitoringInstrumentation = exports.StartupInstrumentation = exports.PerformanceInstrumentation = exports.XHRInstrumentation = exports.HttpInstrumentation = exports.UserActionInstrumentation = exports.AppStateInstrumentation = exports.ViewInstrumentation = exports.SessionInstrumentation = exports.ConsoleInstrumentation = exports.ErrorsInstrumentation = exports.ErrorMechanism = exports.getRNInstrumentations = exports.SamplingRate = exports.SamplingFunction = exports.faro = exports.initializeFaro = void 0;
+exports.LogLevel = exports.onNavigationStateChange = exports.getRouteName = exports.getCurrentRoute = exports.createNavigationStateChangeHandler = exports.useFaroNavigation = exports.ReactNativeNavigationIntegration = exports.setUserPersistence = exports.initializeUserPersistence = exports.getUserPersistence = exports.createUserPersistence = exports.setDataCollectionPolicy = exports.initializeDataCollectionPolicy = exports.getDataCollectionPolicy = exports.createDataCollectionPolicy = exports.OfflineTransport = exports.ConsoleTransport = exports.FetchTransport = exports.getSdkMeta = exports.getScreenMeta = exports.getPageMeta = exports.withFaroErrorBoundary = exports.FaroErrorBoundary = exports.notifyHttpRequestStart = exports.notifyHttpRequestEnd = exports.trackUserAction = exports.withFaroUserAction = exports.reactNativeLogArgsSerializer = exports.CrashReportingInstrumentation = exports.ANRInstrumentation = exports.FrameMonitoringInstrumentation = exports.StartupInstrumentation = exports.PerformanceInstrumentation = exports.XHRInstrumentation = exports.HttpInstrumentation = exports.UserActionInstrumentation = exports.AppStateInstrumentation = exports.ViewInstrumentation = exports.minimalSessionDeviceAttributes = exports.loadSessionDeviceAttributesForInit = exports.getSessionAttributes = exports.SessionInstrumentation = exports.ConsoleInstrumentation = exports.ErrorsInstrumentation = exports.ErrorMechanism = exports.getRNInstrumentations = exports.SamplingRate = exports.SamplingFunction = exports.faro = exports.initializeFaro = void 0;
+exports.defaultLogLevel = exports.allLogLevels = exports.InternalLoggerLevel = void 0;
 // Main entry point for @grafana/faro-react-native
 // Apply PerformanceObserver polyfill first to prevent iOS bad_variant_access crash
 var performanceObserverPolyfill_1 = require("./util/performanceObserverPolyfill");
@@ -24,6 +25,10 @@ var console_1 = require("./instrumentations/console");
 Object.defineProperty(exports, "ConsoleInstrumentation", { enumerable: true, get: function () { return console_1.ConsoleInstrumentation; } });
 var session_1 = require("./instrumentations/session");
 Object.defineProperty(exports, "SessionInstrumentation", { enumerable: true, get: function () { return session_1.SessionInstrumentation; } });
+var sessionAttributes_1 = require("./instrumentations/session/sessionAttributes");
+Object.defineProperty(exports, "getSessionAttributes", { enumerable: true, get: function () { return sessionAttributes_1.getSessionAttributes; } });
+Object.defineProperty(exports, "loadSessionDeviceAttributesForInit", { enumerable: true, get: function () { return sessionAttributes_1.loadSessionDeviceAttributesForInit; } });
+Object.defineProperty(exports, "minimalSessionDeviceAttributes", { enumerable: true, get: function () { return sessionAttributes_1.minimalSessionDeviceAttributes; } });
 var view_1 = require("./instrumentations/view");
 Object.defineProperty(exports, "ViewInstrumentation", { enumerable: true, get: function () { return view_1.ViewInstrumentation; } });
 var appState_1 = require("./instrumentations/appState");
@@ -94,7 +99,10 @@ Object.defineProperty(exports, "createNavigationStateChangeHandler", { enumerabl
 Object.defineProperty(exports, "getCurrentRoute", { enumerable: true, get: function () { return navigation_1.getCurrentRoute; } });
 Object.defineProperty(exports, "getRouteName", { enumerable: true, get: function () { return navigation_1.getRouteName; } });
 Object.defineProperty(exports, "onNavigationStateChange", { enumerable: true, get: function () { return navigation_1.onNavigationStateChange; } });
-// Export LogLevel enum (not just the type)
-var faro_core_2 = require("@grafana/faro-core");
-Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return faro_core_2.LogLevel; } });
+// Export LogLevel and InternalLoggerLevel from our local copy (avoid bundling faro-core's web code)
+var internalLogger_1 = require("./internalLogger");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return internalLogger_1.LogLevel; } });
+Object.defineProperty(exports, "InternalLoggerLevel", { enumerable: true, get: function () { return internalLogger_1.InternalLoggerLevel; } });
+Object.defineProperty(exports, "allLogLevels", { enumerable: true, get: function () { return internalLogger_1.allLogLevels; } });
+Object.defineProperty(exports, "defaultLogLevel", { enumerable: true, get: function () { return internalLogger_1.defaultLogLevel; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,kDAAkD;AAClD,mFAAmF;AACnF,kFAAsF;AACtF,IAAA,8DAAgC,GAAE,CAAC;AACnC,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,gDAA0C;AAAjC,iGAAA,IAAI,OAAA;AAKb,4CAA4C;AAC5C,8CAAwG;AAA/F,4GAAA,gBAAgB,OAAA;AAAE,wGAAA,YAAY,OAAA;AAEvC,iCAAiC;AACjC,wEAAuE;AAA9D,8HAAA,qBAAqB,OAAA;AAE9B,0BAA0B;AAC1B,oDAAkF;AAAzE,wGAAA,cAAc,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAE9C,sDAAoE;AAA3D,iHAAA,sBAAsB,OAAA;AAC/B,sDAAoE;AAA3D,iHAAA,sBAAsB,OAAA;AAC/B,gDAA8D;AAArD,2GAAA,mBAAmB,OAAA;AAC5B,wDAAsE;AAA7D,mHAAA,uBAAuB,OAAA;AAChC,8DAA2E;AAAlE,wHAAA,yBAAyB,OAAA;AAClC,gDAA8D;AAArD,2GAAA,mBAAmB,OAAA;AAC5B,8CAA4D;AAAnD,yGAAA,kBAAkB,OAAA;AAC3B,8DAA4E;AAAnE,yHAAA,0BAA0B,OAAA;AAEnC,sDAAoE;AAA3D,iHAAA,sBAAsB,OAAA;AAE/B,sEAAoF;AAA3E,iIAAA,8BAA8B,OAAA;AAEvC,8CAA4D;AAAnD,yGAAA,kBAAkB,OAAA;AAE3B,oEAAkF;AAAzE,+HAAA,6BAA6B,OAAA;AAGtC,2BAA2B;AAC3B,0DAAgF;AAAvE,qHAAA,4BAA4B,OAAA;AAErC,6BAA6B;AAC7B,wFAI2D;AAHzD,wHAAA,kBAAkB,OAAA;AAClB,qHAAA,eAAe,OAAA;AAGjB,wFAAiH;AAAxG,0HAAA,oBAAoB,OAAA;AAAE,4HAAA,sBAAsB,OAAA;AAGrD,wBAAwB;AACxB,uEAAsE;AAA7D,sHAAA,iBAAiB,OAAA;AAC1B,+EAA8E;AAArE,8HAAA,qBAAqB,OAAA;AAO9B,eAAe;AACf,qCAA2C;AAAlC,mGAAA,WAAW,OAAA;AACpB,yCAA+C;AAAtC,uGAAA,aAAa,OAAA;AACtB,mCAAyC;AAAhC,iGAAA,UAAU,OAAA;AAEnB,oBAAoB;AACpB,4CAAoD;AAA3C,uGAAA,cAAc,OAAA;AACvB,gDAAwD;AAA/C,2GAAA,gBAAgB,OAAA;AAEzB,gDAAwD;AAA/C,2GAAA,gBAAgB,OAAA;AAGzB,gCAAgC;AAChC,mDAK0B;AAJxB,4HAAA,0BAA0B,OAAA;AAC1B,yHAAA,uBAAuB,OAAA;AACvB,gIAAA,8BAA8B,OAAA;AAC9B,yHAAA,uBAAuB,OAAA;AAIzB,0BAA0B;AAC1B,qDAK2B;AAJzB,wHAAA,qBAAqB,OAAA;AACrB,qHAAA,kBAAkB,OAAA;AAClB,4HAAA,yBAAyB,OAAA;AACzB,qHAAA,kBAAkB,OAAA;AAIpB,8BAA8B;AAC9B,sCAAmE;AAA1D,sHAAA,gCAAgC,OAAA;AACzC,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,gIAAA,kCAAkC,OAAA;AAClC,6GAAA,eAAe,OAAA;AACf,0GAAA,YAAY,OAAA;AACZ,qHAAA,uBAAuB,OAAA;AAiBzB,2CAA2C;AAC3C,gDAA8C;AAArC,qGAAA,QAAQ,OAAA","sourcesContent":["// Main entry point for @grafana/faro-react-native\n// Apply PerformanceObserver polyfill first to prevent iOS bad_variant_access crash\nimport { applyPerformanceObserverPolyfill } from './util/performanceObserverPolyfill';\napplyPerformanceObserverPolyfill();\nexport { initializeFaro } from './initialize';\nexport { faro } from '@grafana/faro-core';\n\n// Export types\nexport type { EnableTransportsConfig, ReactNativeConfig, ReactNativeSessionTrackingConfig } from './config/types';\n\n// Export sampling (Flutter-style interface)\nexport { SamplingFunction, SamplingRate, type Sampling, type SamplingContext } from './config/sampling';\n\n// Export instrumentation helpers\nexport { getRNInstrumentations } from './config/getRNInstrumentations';\n\n// Export instrumentations\nexport { ErrorMechanism, ErrorsInstrumentation } from './instrumentations/errors';\nexport type { ErrorMechanismType, ErrorsInstrumentationOptions } from './instrumentations/errors';\nexport { ConsoleInstrumentation } from './instrumentations/console';\nexport { SessionInstrumentation } from './instrumentations/session';\nexport { ViewInstrumentation } from './instrumentations/view';\nexport { AppStateInstrumentation } from './instrumentations/appState';\nexport { UserActionInstrumentation } from './instrumentations/userActions';\nexport { HttpInstrumentation } from './instrumentations/http';\nexport { XHRInstrumentation } from './instrumentations/xhr';\nexport { PerformanceInstrumentation } from './instrumentations/performance';\nexport type { PerformanceInstrumentationOptions } from './instrumentations/performance/types';\nexport { StartupInstrumentation } from './instrumentations/startup';\nexport type { StartupInstrumentationOptions } from './instrumentations/startup/types';\nexport { FrameMonitoringInstrumentation } from './instrumentations/frameMonitoring';\nexport type { FrameMonitoringOptions } from './instrumentations/frameMonitoring';\nexport { ANRInstrumentation } from './instrumentations/anr';\nexport type { ANRInstrumentationOptions } from './instrumentations/anr';\nexport { CrashReportingInstrumentation } from './instrumentations/crashReporting';\nexport type { CrashReportingOptions } from './instrumentations/crashReporting';\n\n// Export console utilities\nexport { reactNativeLogArgsSerializer } from './instrumentations/console/utils';\n\n// Export user action helpers\nexport {\n  withFaroUserAction,\n  trackUserAction,\n  type WithFaroUserActionProps,\n} from './instrumentations/userActions/withFaroUserAction';\nexport { notifyHttpRequestEnd, notifyHttpRequestStart } from './instrumentations/userActions/httpRequestMonitor';\nexport type { HttpRequestMessagePayload } from './instrumentations/userActions/httpRequestMonitor';\n\n// Export error boundary\nexport { FaroErrorBoundary } from './errorBoundary/FaroErrorBoundary';\nexport { withFaroErrorBoundary } from './errorBoundary/withFaroErrorBoundary';\nexport type {\n  FaroErrorBoundaryProps,\n  FaroErrorBoundaryState,\n  FaroErrorBoundaryFallbackRender,\n} from './errorBoundary/types';\n\n// Export metas\nexport { getPageMeta } from './metas/page';\nexport { getScreenMeta } from './metas/screen';\nexport { getSdkMeta } from './metas/sdk';\n\n// Export transports\nexport { FetchTransport } from './transports/fetch';\nexport { ConsoleTransport } from './transports/console';\nexport type { ConsoleTransportOptions } from './transports/console';\nexport { OfflineTransport } from './transports/offline';\nexport type { OfflineTransportOptions } from './transports/offline';\n\n// Export data collection policy\nexport {\n  createDataCollectionPolicy,\n  getDataCollectionPolicy,\n  initializeDataCollectionPolicy,\n  setDataCollectionPolicy,\n} from './dataCollection';\nexport type { DataCollectionPolicy, DataCollectionPolicyOptions } from './dataCollection';\n\n// Export user persistence\nexport {\n  createUserPersistence,\n  getUserPersistence,\n  initializeUserPersistence,\n  setUserPersistence,\n} from './userPersistence';\nexport type { UserPersistence, UserPersistenceOptions } from './userPersistence';\n\n// Export navigation utilities\nexport { ReactNativeNavigationIntegration } from './navigation/v6';\nexport {\n  useFaroNavigation,\n  createNavigationStateChangeHandler,\n  getCurrentRoute,\n  getRouteName,\n  onNavigationStateChange,\n} from './navigation';\nexport type { ReactNavigationDependencies, ReactNavigationConfig } from './navigation/types';\n\n// Re-export core types and enums that consumers will need\nexport type {\n  Config,\n  Faro,\n  Instrumentation,\n  Meta,\n  Transport,\n  PushErrorOptions,\n  PushEventOptions,\n  PushLogOptions,\n  PushMeasurementOptions,\n} from '@grafana/faro-core';\n\n// Export LogLevel enum (not just the type)\nexport { LogLevel } from '@grafana/faro-core';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,kDAAkD;AAClD,mFAAmF;AACnF,kFAAsF;AACtF,IAAA,8DAAgC,GAAE,CAAC;AACnC,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,gDAA0C;AAAjC,iGAAA,IAAI,OAAA;AAKb,4CAA4C;AAC5C,8CAAwG;AAA/F,4GAAA,gBAAgB,OAAA;AAAE,wGAAA,YAAY,OAAA;AAEvC,iCAAiC;AACjC,wEAAuE;AAA9D,8HAAA,qBAAqB,OAAA;AAE9B,0BAA0B;AAC1B,oDAAkF;AAAzE,wGAAA,cAAc,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAE9C,sDAAoE;AAA3D,iHAAA,sBAAsB,OAAA;AAC/B,sDAAoE;AAA3D,iHAAA,sBAAsB,OAAA;AAC/B,kFAIsD;AAHpD,yHAAA,oBAAoB,OAAA;AACpB,uIAAA,kCAAkC,OAAA;AAClC,mIAAA,8BAA8B,OAAA;AAGhC,gDAA8D;AAArD,2GAAA,mBAAmB,OAAA;AAC5B,wDAAsE;AAA7D,mHAAA,uBAAuB,OAAA;AAChC,8DAA2E;AAAlE,wHAAA,yBAAyB,OAAA;AAClC,gDAA8D;AAArD,2GAAA,mBAAmB,OAAA;AAC5B,8CAA4D;AAAnD,yGAAA,kBAAkB,OAAA;AAC3B,8DAA4E;AAAnE,yHAAA,0BAA0B,OAAA;AAEnC,sDAAoE;AAA3D,iHAAA,sBAAsB,OAAA;AAE/B,sEAAoF;AAA3E,iIAAA,8BAA8B,OAAA;AAEvC,8CAA4D;AAAnD,yGAAA,kBAAkB,OAAA;AAE3B,oEAAkF;AAAzE,+HAAA,6BAA6B,OAAA;AAGtC,2BAA2B;AAC3B,0DAAgF;AAAvE,qHAAA,4BAA4B,OAAA;AAErC,6BAA6B;AAC7B,wFAI2D;AAHzD,wHAAA,kBAAkB,OAAA;AAClB,qHAAA,eAAe,OAAA;AAGjB,wFAAiH;AAAxG,0HAAA,oBAAoB,OAAA;AAAE,4HAAA,sBAAsB,OAAA;AAGrD,wBAAwB;AACxB,uEAAsE;AAA7D,sHAAA,iBAAiB,OAAA;AAC1B,+EAA8E;AAArE,8HAAA,qBAAqB,OAAA;AAO9B,eAAe;AACf,qCAA2C;AAAlC,mGAAA,WAAW,OAAA;AACpB,yCAA+C;AAAtC,uGAAA,aAAa,OAAA;AACtB,mCAAyC;AAAhC,iGAAA,UAAU,OAAA;AAEnB,oBAAoB;AACpB,4CAAoD;AAA3C,uGAAA,cAAc,OAAA;AACvB,gDAAwD;AAA/C,2GAAA,gBAAgB,OAAA;AAEzB,gDAAwD;AAA/C,2GAAA,gBAAgB,OAAA;AAGzB,gCAAgC;AAChC,mDAK0B;AAJxB,4HAAA,0BAA0B,OAAA;AAC1B,yHAAA,uBAAuB,OAAA;AACvB,gIAAA,8BAA8B,OAAA;AAC9B,yHAAA,uBAAuB,OAAA;AAIzB,0BAA0B;AAC1B,qDAK2B;AAJzB,wHAAA,qBAAqB,OAAA;AACrB,qHAAA,kBAAkB,OAAA;AAClB,4HAAA,yBAAyB,OAAA;AACzB,qHAAA,kBAAkB,OAAA;AAIpB,8BAA8B;AAC9B,sCAAmE;AAA1D,sHAAA,gCAAgC,OAAA;AACzC,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,gIAAA,kCAAkC,OAAA;AAClC,6GAAA,eAAe,OAAA;AACf,0GAAA,YAAY,OAAA;AACZ,qHAAA,uBAAuB,OAAA;AAiBzB,oGAAoG;AACpG,mDAAgG;AAAvF,0GAAA,QAAQ,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,iHAAA,eAAe,OAAA","sourcesContent":["// Main entry point for @grafana/faro-react-native\n// Apply PerformanceObserver polyfill first to prevent iOS bad_variant_access crash\nimport { applyPerformanceObserverPolyfill } from './util/performanceObserverPolyfill';\napplyPerformanceObserverPolyfill();\nexport { initializeFaro } from './initialize';\nexport { faro } from '@grafana/faro-core';\n\n// Export types\nexport type { EnableTransportsConfig, ReactNativeConfig, ReactNativeSessionTrackingConfig } from './config/types';\n\n// Export sampling (Flutter-style interface)\nexport { SamplingFunction, SamplingRate, type Sampling, type SamplingContext } from './config/sampling';\n\n// Export instrumentation helpers\nexport { getRNInstrumentations } from './config/getRNInstrumentations';\n\n// Export instrumentations\nexport { ErrorMechanism, ErrorsInstrumentation } from './instrumentations/errors';\nexport type { ErrorMechanismType, ErrorsInstrumentationOptions } from './instrumentations/errors';\nexport { ConsoleInstrumentation } from './instrumentations/console';\nexport { SessionInstrumentation } from './instrumentations/session';\nexport {\n  getSessionAttributes,\n  loadSessionDeviceAttributesForInit,\n  minimalSessionDeviceAttributes,\n} from './instrumentations/session/sessionAttributes';\nexport type { SessionAttributes } from './instrumentations/session/sessionAttributes';\nexport { ViewInstrumentation } from './instrumentations/view';\nexport { AppStateInstrumentation } from './instrumentations/appState';\nexport { UserActionInstrumentation } from './instrumentations/userActions';\nexport { HttpInstrumentation } from './instrumentations/http';\nexport { XHRInstrumentation } from './instrumentations/xhr';\nexport { PerformanceInstrumentation } from './instrumentations/performance';\nexport type { PerformanceInstrumentationOptions } from './instrumentations/performance/types';\nexport { StartupInstrumentation } from './instrumentations/startup';\nexport type { StartupInstrumentationOptions } from './instrumentations/startup/types';\nexport { FrameMonitoringInstrumentation } from './instrumentations/frameMonitoring';\nexport type { FrameMonitoringOptions } from './instrumentations/frameMonitoring';\nexport { ANRInstrumentation } from './instrumentations/anr';\nexport type { ANRInstrumentationOptions } from './instrumentations/anr';\nexport { CrashReportingInstrumentation } from './instrumentations/crashReporting';\nexport type { CrashReportingOptions } from './instrumentations/crashReporting';\n\n// Export console utilities\nexport { reactNativeLogArgsSerializer } from './instrumentations/console/utils';\n\n// Export user action helpers\nexport {\n  withFaroUserAction,\n  trackUserAction,\n  type WithFaroUserActionProps,\n} from './instrumentations/userActions/withFaroUserAction';\nexport { notifyHttpRequestEnd, notifyHttpRequestStart } from './instrumentations/userActions/httpRequestMonitor';\nexport type { HttpRequestMessagePayload } from './instrumentations/userActions/httpRequestMonitor';\n\n// Export error boundary\nexport { FaroErrorBoundary } from './errorBoundary/FaroErrorBoundary';\nexport { withFaroErrorBoundary } from './errorBoundary/withFaroErrorBoundary';\nexport type {\n  FaroErrorBoundaryProps,\n  FaroErrorBoundaryState,\n  FaroErrorBoundaryFallbackRender,\n} from './errorBoundary/types';\n\n// Export metas\nexport { getPageMeta } from './metas/page';\nexport { getScreenMeta } from './metas/screen';\nexport { getSdkMeta } from './metas/sdk';\n\n// Export transports\nexport { FetchTransport } from './transports/fetch';\nexport { ConsoleTransport } from './transports/console';\nexport type { ConsoleTransportOptions } from './transports/console';\nexport { OfflineTransport } from './transports/offline';\nexport type { OfflineTransportOptions } from './transports/offline';\n\n// Export data collection policy\nexport {\n  createDataCollectionPolicy,\n  getDataCollectionPolicy,\n  initializeDataCollectionPolicy,\n  setDataCollectionPolicy,\n} from './dataCollection';\nexport type { DataCollectionPolicy, DataCollectionPolicyOptions } from './dataCollection';\n\n// Export user persistence\nexport {\n  createUserPersistence,\n  getUserPersistence,\n  initializeUserPersistence,\n  setUserPersistence,\n} from './userPersistence';\nexport type { UserPersistence, UserPersistenceOptions } from './userPersistence';\n\n// Export navigation utilities\nexport { ReactNativeNavigationIntegration } from './navigation/v6';\nexport {\n  useFaroNavigation,\n  createNavigationStateChangeHandler,\n  getCurrentRoute,\n  getRouteName,\n  onNavigationStateChange,\n} from './navigation';\nexport type { ReactNavigationDependencies, ReactNavigationConfig } from './navigation/types';\n\n// Re-export core types and enums that consumers will need\nexport type {\n  Config,\n  Faro,\n  Instrumentation,\n  Meta,\n  Transport,\n  PushErrorOptions,\n  PushEventOptions,\n  PushLogOptions,\n  PushMeasurementOptions,\n} from '@grafana/faro-core';\n\n// Export LogLevel and InternalLoggerLevel from our local copy (avoid bundling faro-core's web code)\nexport { LogLevel, InternalLoggerLevel, allLogLevels, defaultLogLevel } from './internalLogger';\n"]}

package/dist/cjs/initialize.js

@@ -1,10 +1,61 @@
 "use strict";
+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.initializeFaro = initializeFaro;
 var faro_core_1 = require("@grafana/faro-core");
 var makeRNConfig_1 = require("./config/makeRNConfig");
+var sessionAttributes_1 = require("./instrumentations/session/sessionAttributes");
+/**
+ * Awaits async device/session attribute collection, then initializes Faro with core `initializeFaro`.
+ * On failure during collection, uses `minimalSessionDeviceAttributes` before init.
+ */
 function initializeFaro(config) {
-    var fullConfig = (0, makeRNConfig_1.makeRNConfig)(config);
-    return (0, faro_core_1.initializeFaro)(fullConfig);
+    return __awaiter(this, void 0, void 0, function () {
+        var preloadedSessionDeviceAttributes, fullConfig;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, sessionAttributes_1.loadSessionDeviceAttributesForInit)()];
+                case 1:
+                    preloadedSessionDeviceAttributes = _a.sent();
+                    fullConfig = (0, makeRNConfig_1.makeRNConfig)(config, preloadedSessionDeviceAttributes);
+                    return [2 /*return*/, (0, faro_core_1.initializeFaro)(fullConfig)];
+            }
+        });
+    });
 }
 //# sourceMappingURL=initialize.js.map

package/dist/cjs/initialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../../src/initialize.ts"],"names":[],"mappings":";;AAKA,wCAGC;AARD,gDAAqF;AAErF,sDAAqD;AAGrD,SAAgB,cAAc,CAAC,MAAyB;IACtD,IAAM,UAAU,GAAG,IAAA,2BAAY,EAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAA,0BAAkB,EAAC,UAAU,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import { type Faro, initializeFaro as initializeFaroCore } from '@grafana/faro-core';\n\nimport { makeRNConfig } from './config/makeRNConfig';\nimport type { ReactNativeConfig } from './config/types';\n\nexport function initializeFaro(config: ReactNativeConfig): Faro {\n  const fullConfig = makeRNConfig(config);\n  return initializeFaroCore(fullConfig);\n}\n"]}
+{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../../src/initialize.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,wCAIC;AAdD,gDAAqF;AAErF,sDAAqD;AAErD,kFAAkG;AAElG;;;GAGG;AACH,SAAsB,cAAc,CAAC,MAAyB;;;;;wBACnB,qBAAM,IAAA,sDAAkC,GAAE,EAAA;;oBAA7E,gCAAgC,GAAG,SAA0C;oBAC7E,UAAU,GAAG,IAAA,2BAAY,EAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;oBAC1E,sBAAO,IAAA,0BAAkB,EAAC,UAAU,CAAC,EAAC;;;;CACvC","sourcesContent":["import { type Faro, initializeFaro as initializeFaroCore } from '@grafana/faro-core';\n\nimport { makeRNConfig } from './config/makeRNConfig';\nimport type { ReactNativeConfig } from './config/types';\nimport { loadSessionDeviceAttributesForInit } from './instrumentations/session/sessionAttributes';\n\n/**\n * Awaits async device/session attribute collection, then initializes Faro with core `initializeFaro`.\n * On failure during collection, uses `minimalSessionDeviceAttributes` before init.\n */\nexport async function initializeFaro(config: ReactNativeConfig): Promise<Faro> {\n  const preloadedSessionDeviceAttributes = await loadSessionDeviceAttributesForInit();\n  const fullConfig = makeRNConfig(config, preloadedSessionDeviceAttributes);\n  return initializeFaroCore(fullConfig);\n}\n"]}

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

@@ -47,6 +47,7 @@ var ConsoleInstrumentation = /** @class */ (function (_super) {
         _this.originalConsole = {};
         _this.errorSerializer = utils_1.reactNativeLogArgsSerializer;
         _this.patchedLevels = [];
+        _this.isProcessing = false;
         return _this;
     }
     ConsoleInstrumentation.prototype.initialize = function () {
@@ -58,24 +59,32 @@ var ConsoleInstrumentation = /** @class */ (function (_super) {
         this.errorSerializer = serializeErrors
             ? ((_a = instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.errorSerializer) !== null && _a !== void 0 ? _a : faro_core_1.defaultErrorArgsSerializer)
             : utils_1.reactNativeLogArgsSerializer;
-        // Store original console methods
+        // Store original console methods - use unpatchedConsole from config if available
+        // to avoid capturing React Native's patched console (LogBox, DevTools)
+        var sourceConsole = (_b = this.config.unpatchedConsole) !== null && _b !== void 0 ? _b : console;
         faro_core_1.allLogLevels.forEach(function (level) {
-            _this.originalConsole[level] = console[level];
+            _this.originalConsole[level] = sourceConsole[level];
         });
         // Determine which levels to patch
         this.patchedLevels = faro_core_1.allLogLevels.filter(function (level) { var _a; return !((_a = instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.disabledLevels) !== null && _a !== void 0 ? _a : ConsoleInstrumentation.defaultDisabledLevels).includes(level); });
         // Patch console methods
         this.patchedLevels.forEach(function (level) {
             console[level] = function () {
-                var _a, _b;
+                var _a, _b, _c, _d;
                 var args = [];
                 for (var _i = 0; _i < arguments.length; _i++) {
                     args[_i] = arguments[_i];
                 }
+                // Prevent re-entry to avoid infinite loops
+                if (_this.isProcessing) {
+                    (_b = (_a = _this.originalConsole)[level]) === null || _b === void 0 ? void 0 : _b.call.apply(_b, __spreadArray([_a], args, false));
+                    return;
+                }
+                _this.isProcessing = true;
                 try {
                     if (level === faro_core_1.LogLevel.ERROR && !(instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.consoleErrorAsLog)) {
                         // Handle console.error as an error with advanced serialization
-                        var _c = (0, utils_1.getDetailsFromConsoleErrorArgs)(args, _this.errorSerializer), value = _c.value, type = _c.type, stackFrames = _c.stackFrames;
+                        var _e = (0, utils_1.getDetailsFromConsoleErrorArgs)(args, _this.errorSerializer), value = _e.value, type = _e.type, stackFrames = _e.stackFrames;
                         var context = { mechanism: const_1.ErrorMechanism.CONSOLE };
                         if (value && !type && !stackFrames) {
                             // Simple error without stack frames
@@ -92,7 +101,7 @@ var ConsoleInstrumentation = /** @class */ (function (_super) {
                     }
                     else if (level === faro_core_1.LogLevel.ERROR && (instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.consoleErrorAsLog)) {
                         // Handle console.error as a log with error details in context
-                        var _d = (0, utils_1.getDetailsFromConsoleErrorArgs)(args, _this.errorSerializer), value = _d.value, type = _d.type, stackFrames = _d.stackFrames;
+                        var _f = (0, utils_1.getDetailsFromConsoleErrorArgs)(args, _this.errorSerializer), value = _f.value, type = _f.type, stackFrames = _f.stackFrames;
                         _this.api.pushLog(value ? [ConsoleInstrumentation.consoleErrorPrefix + value] : args, {
                             level: level,
                             context: {
@@ -107,22 +116,16 @@ var ConsoleInstrumentation = /** @class */ (function (_super) {
                         _this.api.pushLog(args, { level: level });
                     }
                 }
-                catch (err) {
-                    // Use unpatchedConsole to avoid infinite loop
-                    _this.unpatchedConsole.error('[Faro Console] Error capturing log:', err);
-                    _this.logError(err);
+                catch (_err) {
+                    // Silently ignore errors to prevent infinite loops during bootstrap
                 }
                 finally {
-                    // Always call original console method
-                    (_b = (_a = _this.originalConsole)[level]) === null || _b === void 0 ? void 0 : _b.call.apply(_b, __spreadArray([_a], args, false));
+                    // Always call original console method (still protected by isProcessing flag)
+                    (_d = (_c = _this.originalConsole)[level]) === null || _d === void 0 ? void 0 : _d.call.apply(_d, __spreadArray([_c], args, false));
+                    _this.isProcessing = false;
                 }
             };
         });
-        this.logInfo('Console instrumentation initialized', {
-            patchedLevels: this.patchedLevels,
-            serializeErrors: serializeErrors,
-            consoleErrorAsLog: (_b = instrumentationOptions === null || instrumentationOptions === void 0 ? void 0 : instrumentationOptions.consoleErrorAsLog) !== null && _b !== void 0 ? _b : false,
-        });
     };
     /**
      * Restore original console methods
@@ -136,7 +139,6 @@ var ConsoleInstrumentation = /** @class */ (function (_super) {
             }
         });
         this.patchedLevels = [];
-        this.logInfo('Console instrumentation unpatched');
     };
     ConsoleInstrumentation.defaultDisabledLevels = [faro_core_1.LogLevel.DEBUG, faro_core_1.LogLevel.TRACE, faro_core_1.LogLevel.LOG];
     ConsoleInstrumentation.consoleErrorPrefix = 'console.error: ';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/console/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { allLogLevels, BaseInstrumentation, defaultErrorArgsSerializer, LogLevel, VERSION } from '@grafana/faro-core';\nimport type { LogArgsSerializer } from '@grafana/faro-core';\n\nimport { ErrorMechanism } from '../errors/const';\n\nimport { getDetailsFromConsoleErrorArgs, reactNativeLogArgsSerializer } from './utils';\n\n/**\n * Console instrumentation for React Native\n * Captures console logs and errors\n *\n * Features:\n * - Configurable log levels\n * - Advanced error serialization\n * - Option to treat console.error as log or error\n * - Unpatch support for cleanup\n */\nexport class ConsoleInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-console';\n  readonly version = VERSION;\n\n  static defaultDisabledLevels: LogLevel[] = [LogLevel.DEBUG, LogLevel.TRACE, LogLevel.LOG];\n  static consoleErrorPrefix = 'console.error: ';\n\n  private originalConsole: Partial<Console> = {};\n  private errorSerializer: LogArgsSerializer = reactNativeLogArgsSerializer;\n  private patchedLevels: LogLevel[] = [];\n\n  initialize(): void {\n    const instrumentationOptions = this.config.consoleInstrumentation;\n\n    // Configure error serialization\n    const serializeErrors = instrumentationOptions?.serializeErrors || !!instrumentationOptions?.errorSerializer;\n    this.errorSerializer = serializeErrors\n      ? (instrumentationOptions?.errorSerializer ?? defaultErrorArgsSerializer)\n      : reactNativeLogArgsSerializer;\n\n    // Store original console methods\n    allLogLevels.forEach((level) => {\n      this.originalConsole[level] = console[level];\n    });\n\n    // Determine which levels to patch\n    this.patchedLevels = allLogLevels.filter(\n      (level) =>\n        !(instrumentationOptions?.disabledLevels ?? ConsoleInstrumentation.defaultDisabledLevels).includes(level)\n    );\n\n    // Patch console methods\n    this.patchedLevels.forEach((level) => {\n      console[level] = (...args: unknown[]) => {\n        try {\n          if (level === LogLevel.ERROR && !instrumentationOptions?.consoleErrorAsLog) {\n            // Handle console.error as an error with advanced serialization\n            const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);\n\n            const context = { mechanism: ErrorMechanism.CONSOLE };\n\n            if (value && !type && !stackFrames) {\n              // Simple error without stack frames\n              this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + value), { context });\n            } else {\n              // Error with type and/or stack frames (type from error.name, matches Web SDK)\n              this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + (value ?? '')), {\n                context,\n                type,\n                stackFrames,\n              });\n            }\n          } else if (level === LogLevel.ERROR && instrumentationOptions?.consoleErrorAsLog) {\n            // Handle console.error as a log with error details in context\n            const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);\n\n            this.api.pushLog(value ? [ConsoleInstrumentation.consoleErrorPrefix + value] : args, {\n              level,\n              context: {\n                value: value ?? '',\n                type: type ?? '',\n                stackFrames: stackFrames?.length ? defaultErrorArgsSerializer(stackFrames) : '',\n              },\n            });\n          } else {\n            // Handle other log levels normally\n            this.api.pushLog(args, { level });\n          }\n        } catch (err) {\n          // Use unpatchedConsole to avoid infinite loop\n          this.unpatchedConsole.error('[Faro Console] Error capturing log:', err);\n          this.logError(err);\n        } finally {\n          // Always call original console method\n          this.originalConsole[level]?.(...args);\n        }\n      };\n    });\n\n    this.logInfo('Console instrumentation initialized', {\n      patchedLevels: this.patchedLevels,\n      serializeErrors,\n      consoleErrorAsLog: instrumentationOptions?.consoleErrorAsLog ?? false,\n    });\n  }\n\n  /**\n   * Restore original console methods\n   * Call this to clean up and unpatch the console\n   */\n  unpatch(): void {\n    this.patchedLevels.forEach((level) => {\n      if (this.originalConsole[level]) {\n        console[level] = this.originalConsole[level];\n      }\n    });\n\n    this.patchedLevels = [];\n    this.logInfo('Console instrumentation unpatched');\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/console/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { allLogLevels, BaseInstrumentation, defaultErrorArgsSerializer, LogLevel, VERSION } from '@grafana/faro-core';\nimport type { LogArgsSerializer } from '@grafana/faro-core';\n\nimport { ErrorMechanism } from '../errors/const';\n\nimport { getDetailsFromConsoleErrorArgs, reactNativeLogArgsSerializer } from './utils';\n\n/**\n * Console instrumentation for React Native\n * Captures console logs and errors\n *\n * Features:\n * - Configurable log levels\n * - Advanced error serialization\n * - Option to treat console.error as log or error\n * - Unpatch support for cleanup\n */\nexport class ConsoleInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-console';\n  readonly version = VERSION;\n\n  static defaultDisabledLevels: LogLevel[] = [LogLevel.DEBUG, LogLevel.TRACE, LogLevel.LOG];\n  static consoleErrorPrefix = 'console.error: ';\n\n  private originalConsole: Partial<Console> = {};\n  private errorSerializer: LogArgsSerializer = reactNativeLogArgsSerializer;\n  private patchedLevels: LogLevel[] = [];\n  private isProcessing = false;\n\n  initialize(): void {\n    const instrumentationOptions = this.config.consoleInstrumentation;\n\n    // Configure error serialization\n    const serializeErrors = instrumentationOptions?.serializeErrors || !!instrumentationOptions?.errorSerializer;\n    this.errorSerializer = serializeErrors\n      ? (instrumentationOptions?.errorSerializer ?? defaultErrorArgsSerializer)\n      : reactNativeLogArgsSerializer;\n\n    // Store original console methods - use unpatchedConsole from config if available\n    // to avoid capturing React Native's patched console (LogBox, DevTools)\n    const sourceConsole = this.config.unpatchedConsole ?? console;\n    allLogLevels.forEach((level) => {\n      this.originalConsole[level] = sourceConsole[level];\n    });\n\n    // Determine which levels to patch\n    this.patchedLevels = allLogLevels.filter(\n      (level) =>\n        !(instrumentationOptions?.disabledLevels ?? ConsoleInstrumentation.defaultDisabledLevels).includes(level)\n    );\n\n    // Patch console methods\n    this.patchedLevels.forEach((level) => {\n      console[level] = (...args: unknown[]) => {\n        // Prevent re-entry to avoid infinite loops\n        if (this.isProcessing) {\n          this.originalConsole[level]?.(...args);\n          return;\n        }\n\n        this.isProcessing = true;\n        try {\n          if (level === LogLevel.ERROR && !instrumentationOptions?.consoleErrorAsLog) {\n            // Handle console.error as an error with advanced serialization\n            const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);\n\n            const context = { mechanism: ErrorMechanism.CONSOLE };\n\n            if (value && !type && !stackFrames) {\n              // Simple error without stack frames\n              this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + value), { context });\n            } else {\n              // Error with type and/or stack frames (type from error.name, matches Web SDK)\n              this.api.pushError(new Error(ConsoleInstrumentation.consoleErrorPrefix + (value ?? '')), {\n                context,\n                type,\n                stackFrames,\n              });\n            }\n          } else if (level === LogLevel.ERROR && instrumentationOptions?.consoleErrorAsLog) {\n            // Handle console.error as a log with error details in context\n            const { value, type, stackFrames } = getDetailsFromConsoleErrorArgs(args, this.errorSerializer);\n\n            this.api.pushLog(value ? [ConsoleInstrumentation.consoleErrorPrefix + value] : args, {\n              level,\n              context: {\n                value: value ?? '',\n                type: type ?? '',\n                stackFrames: stackFrames?.length ? defaultErrorArgsSerializer(stackFrames) : '',\n              },\n            });\n          } else {\n            // Handle other log levels normally\n            this.api.pushLog(args, { level });\n          }\n        } catch (_err) {\n          // Silently ignore errors to prevent infinite loops during bootstrap\n        } finally {\n          // Always call original console method (still protected by isProcessing flag)\n          this.originalConsole[level]?.(...args);\n          this.isProcessing = false;\n        }\n      };\n    });\n  }\n\n  /**\n   * Restore original console methods\n   * Call this to clean up and unpatch the console\n   */\n  unpatch(): void {\n    this.patchedLevels.forEach((level) => {\n      if (this.originalConsole[level]) {\n        console[level] = this.originalConsole[level];\n      }\n    });\n\n    this.patchedLevels = [];\n  }\n}\n"]}