@grafana/faro-react-native 1.3.0 → 1.4.0

package/dist/esm/userPersistence/UserPersistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserPersistence.js","sourceRoot":"","sources":["../../../src/userPersistence/UserPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import AsyncStorage from '@react-native-async-storage/async-storage';\n\nimport type { MetaUser } from '@grafana/faro-core';\n\nimport type { UserPersistence, UserPersistenceOptions } from './types';\n\n/**\n * Default storage key for user data.\n */\nconst DEFAULT_STORAGE_KEY = 'faro_persisted_user';\n\n/**\n * UserPersistence implementation using AsyncStorage.\n *\n * Stores user information persistently so it can be restored on app restart.\n * This ensures early telemetry events include user identification.\n *\n * Implementation follows Flutter SDK's UserPersistence pattern:\n * - Uses AsyncStorage for persistence (matching Flutter's SharedPreferences)\n * - Stores user as JSON\n * - Handles null/cleared users\n *\n * @example\n * ```typescript\n * import { createUserPersistence } from '@grafana/faro-react-native';\n *\n * // Load user on app start\n * const persistence = createUserPersistence();\n * const user = await persistence.loadUser();\n *\n * if (user) {\n *   faro.api.setUser(user);\n * }\n *\n * // Save user when logged in\n * const loggedInUser = { id: '123', email: 'user@example.com' };\n * await persistence.saveUser(loggedInUser);\n *\n * // Clear on logout\n * await persistence.clearUser();\n * ```\n */\nexport class AsyncStorageUserPersistence implements UserPersistence {\n  private readonly storageKey: string;\n\n  constructor(options: UserPersistenceOptions = {}) {\n    this.storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n  }\n\n  async loadUser(): Promise<MetaUser | null> {\n    try {\n      const userJson = await AsyncStorage.getItem(this.storageKey);\n      if (userJson === null) {\n        return null;\n      }\n\n      const userData = JSON.parse(userJson);\n      if (!this.isValidMetaUser(userData)) {\n        return null;\n      }\n\n      return userData;\n    } catch {\n      return null;\n    }\n  }\n\n  async saveUser(user: MetaUser | null): Promise<void> {\n    try {\n      if (user === null || this.isCleared(user)) {\n        await this.clearUser();\n        return;\n      }\n\n      const userJson = JSON.stringify(user);\n      await AsyncStorage.setItem(this.storageKey, userJson);\n    } catch {\n      // Log failure but don't throw\n    }\n  }\n\n  async clearUser(): Promise<void> {\n    try {\n      await AsyncStorage.removeItem(this.storageKey);\n    } catch {\n      // Log failure but don't throw\n    }\n  }\n\n  async hasPersistedUser(): Promise<boolean> {\n    try {\n      const userJson = await AsyncStorage.getItem(this.storageKey);\n      return userJson !== null;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Check if user is cleared (all fields empty/undefined).\n   */\n  private isCleared(user: MetaUser): boolean {\n    return !user.id && !user.email && !user.username && !user.fullName && !user.roles;\n  }\n\n  /**\n   * Validate that the parsed object is a valid MetaUser.\n   */\n  private isValidMetaUser(obj: unknown): obj is MetaUser {\n    if (typeof obj !== 'object' || obj === null) {\n      return false;\n    }\n\n    // MetaUser has optional string fields, so any object is technically valid\n    // We just need to make sure it's an object\n    return true;\n  }\n}\n\n/**\n * Factory function to create a UserPersistence instance.\n */\nexport function createUserPersistence(options: UserPersistenceOptions = {}): UserPersistence {\n  return new AsyncStorageUserPersistence(options);\n}\n\n/**\n * Global user persistence instance.\n */\nlet globalUserPersistence: UserPersistence | null = null;\n\n/**\n * Initialize the global user persistence.\n */\nexport function initializeUserPersistence(options: UserPersistenceOptions = {}): UserPersistence {\n  globalUserPersistence = createUserPersistence(options);\n  return globalUserPersistence;\n}\n\n/**\n * Get the global user persistence instance.\n */\nexport function getUserPersistence(): UserPersistence | null {\n  return globalUserPersistence;\n}\n\n/**\n * Set a custom user persistence instance.\n */\nexport function setUserPersistence(persistence: UserPersistence | null): void {\n  globalUserPersistence = persistence;\n}\n"]}
+{"version":3,"file":"UserPersistence.js","sourceRoot":"","sources":["../../../src/userPersistence/UserPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import AsyncStorage from '@react-native-async-storage/async-storage';\n\nimport type { MetaUser } from '@grafana/faro-core';\n\nimport type { UserPersistence, UserPersistenceOptions } from './types';\n\n/**\n * Default storage key for user data.\n */\nconst DEFAULT_STORAGE_KEY = 'faro_persisted_user';\n\n/**\n * UserPersistence implementation using AsyncStorage.\n *\n * Stores user information persistently so it can be restored on app restart.\n * This ensures early telemetry events include user identification.\n *\n * Uses AsyncStorage for persistent user data across app sessions.\n * - Stores user as JSON\n * - Handles null/cleared users\n *\n * @example\n * ```typescript\n * import { createUserPersistence } from '@grafana/faro-react-native';\n *\n * // Load user on app start\n * const persistence = createUserPersistence();\n * const user = await persistence.loadUser();\n *\n * if (user) {\n *   faro.api.setUser(user);\n * }\n *\n * // Save user when logged in\n * const loggedInUser = { id: '123', email: 'user@example.com' };\n * await persistence.saveUser(loggedInUser);\n *\n * // Clear on logout\n * await persistence.clearUser();\n * ```\n */\nexport class AsyncStorageUserPersistence implements UserPersistence {\n  private readonly storageKey: string;\n\n  constructor(options: UserPersistenceOptions = {}) {\n    this.storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n  }\n\n  async loadUser(): Promise<MetaUser | null> {\n    try {\n      const userJson = await AsyncStorage.getItem(this.storageKey);\n      if (userJson === null) {\n        return null;\n      }\n\n      const userData = JSON.parse(userJson);\n      if (!this.isValidMetaUser(userData)) {\n        return null;\n      }\n\n      return userData;\n    } catch {\n      return null;\n    }\n  }\n\n  async saveUser(user: MetaUser | null): Promise<void> {\n    try {\n      if (user === null || this.isCleared(user)) {\n        await this.clearUser();\n        return;\n      }\n\n      const userJson = JSON.stringify(user);\n      await AsyncStorage.setItem(this.storageKey, userJson);\n    } catch {\n      // Log failure but don't throw\n    }\n  }\n\n  async clearUser(): Promise<void> {\n    try {\n      await AsyncStorage.removeItem(this.storageKey);\n    } catch {\n      // Log failure but don't throw\n    }\n  }\n\n  async hasPersistedUser(): Promise<boolean> {\n    try {\n      const userJson = await AsyncStorage.getItem(this.storageKey);\n      return userJson !== null;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Check if user is cleared (all fields empty/undefined).\n   */\n  private isCleared(user: MetaUser): boolean {\n    return !user.id && !user.email && !user.username && !user.fullName && !user.roles;\n  }\n\n  /**\n   * Validate that the parsed object is a valid MetaUser.\n   */\n  private isValidMetaUser(obj: unknown): obj is MetaUser {\n    if (typeof obj !== 'object' || obj === null) {\n      return false;\n    }\n\n    // MetaUser has optional string fields, so any object is technically valid\n    // We just need to make sure it's an object\n    return true;\n  }\n}\n\n/**\n * Factory function to create a UserPersistence instance.\n */\nexport function createUserPersistence(options: UserPersistenceOptions = {}): UserPersistence {\n  return new AsyncStorageUserPersistence(options);\n}\n\n/**\n * Global user persistence instance.\n */\nlet globalUserPersistence: UserPersistence | null = null;\n\n/**\n * Initialize the global user persistence.\n */\nexport function initializeUserPersistence(options: UserPersistenceOptions = {}): UserPersistence {\n  globalUserPersistence = createUserPersistence(options);\n  return globalUserPersistence;\n}\n\n/**\n * Get the global user persistence instance.\n */\nexport function getUserPersistence(): UserPersistence | null {\n  return globalUserPersistence;\n}\n\n/**\n * Set a custom user persistence instance.\n */\nexport function setUserPersistence(persistence: UserPersistence | null): void {\n  globalUserPersistence = persistence;\n}\n"]}

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

@@ -3,8 +3,7 @@ import type { ReactNativeConfig } from './types';
 /**
  * Returns the default set of instrumentations for React Native.
  *
- * Reads all options from the Faro config (single source of truth).
- * Property names are aligned with Flutter SDK FaroConfig:
+ * Reads all options from the Faro config (single source of truth):
  * - cpuUsageVitals, memoryUsageVitals, anrTracking, refreshRateVitals
  * - enableCrashReporting, enableErrorReporting
  * - fetchVitalsInterval, ignoreUrls

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

@@ -6,9 +6,6 @@ import type { Meta } from '@grafana/faro-core';
  * allowing sampling decisions based on session attributes, user info, app
  * environment, and other metadata.
  *
- * This aligns with the Faro Flutter SDK's `SamplingContext` which provides
- * `meta` to the sampler.
- *
  * @example
  * ```ts
  * sampling: SamplingFunction((context) => {

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

@@ -5,11 +5,13 @@ import type { PreloadedMobileMeta, SessionAttributes } from '../instrumentations
 import type { Sampling } from './sampling';
 /**
  * React Native session tracking config.
- * Extends Config['sessionTracking'] with sampling (Flutter-style) and RN-specific props.
+ * Extends Config['sessionTracking'] with sampling and RN-specific props.
  * Excludes samplingRate and sampler in favor of sampling.
  *
- * When `persistent` is true, sessions are stored with [react-native-mmkv](https://github.com/mrousavy/react-native-mmkv)
- * (synchronous). Add `react-native-mmkv` to your app and rebuild native projects.
+ * Persistence defaults to true and stores a minimal, versioned record with
+ * [react-native-mmkv](https://github.com/mrousavy/react-native-mmkv) (synchronous).
+ * Add `react-native-mmkv` to your app and rebuild native projects, or set
+ * `persistent` to false to use in-memory sessions.
  */
 export type ReactNativeSessionTrackingConfig = Omit<NonNullable<Config['sessionTracking']>, 'samplingRate' | 'sampler'> & {
     /**

package/dist/types/dataCollection/DataCollectionPolicy.d.ts

@@ -5,8 +5,7 @@ import type { DataCollectionPolicy, DataCollectionPolicyOptions } from './types'
  * Controls whether telemetry data is collected and sent.
  * The setting is persisted to AsyncStorage so it survives app restarts.
  *
- * Implementation follows Flutter SDK's DataCollectionPolicy pattern:
- * - Uses AsyncStorage for persistence (matching Flutter's SharedPreferences)
+ * Uses AsyncStorage for persisting data collection policy state.
  * - Provides enable/disable methods
  * - Initializes from persisted value or default
  *

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

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

package/dist/types/index.d.ts

@@ -6,7 +6,9 @@ export { getRNInstrumentations } from './config/getRNInstrumentations';
 export { ErrorMechanism, ErrorsInstrumentation } from './instrumentations/errors';
 export type { ErrorMechanismType, ErrorsInstrumentationOptions } from './instrumentations/errors';
 export { ConsoleInstrumentation } from './instrumentations/console';
-export { SessionInstrumentation } from './instrumentations/session';
+export { startNewSession, SessionInstrumentation } from './instrumentations/session';
+export { FaroSessionActivityBoundary, type FaroSessionActivityBoundaryProps, } from './instrumentations/session/FaroSessionActivityBoundary';
+export { notifySessionActivity } from './instrumentations/session/directSessionActivity';
 export { getSessionAttributes, loadMobileMetaForInit, loadSessionDeviceAttributesForInit, minimalSessionDeviceAttributes, } from './instrumentations/session/sessionAttributes';
 export type { PreloadedMobileMeta, SessionAttributes } from './instrumentations/session/sessionAttributes';
 export { ViewInstrumentation } from './instrumentations/view';
@@ -35,6 +37,7 @@ export { getPageMeta } from './metas/page';
 export { getScreenMeta } from './metas/screen';
 export { getSdkMeta } from './metas/sdk';
 export { FetchTransport } from './transports/fetch';
+export type { FetchTransportSendOutcome, FetchTransportSendResult } from './transports/fetch';
 export { ConsoleTransport } from './transports/console';
 export type { ConsoleTransportOptions } from './transports/console';
 export { OfflineTransport } from './transports/offline';

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

@@ -12,7 +12,7 @@ import type { ANRInstrumentationOptions } from './types';
  */
 export declare class ANRInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-anr";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     private readonly options;
     private pollingIntervalId;
     private anrEventSubscription;

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

@@ -10,7 +10,7 @@ export declare const EVENT_APP_STATE_CHANGED = "app_lifecycle_changed";
  */
 export declare class AppStateInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-appstate";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     private currentState;
     private stateStartTime;
     private appStateSubscription;

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

@@ -11,7 +11,7 @@ import { BaseInstrumentation, LogLevel } from '@grafana/faro-core';
  */
 export declare class ConsoleInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-console";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     static defaultDisabledLevels: LogLevel[];
     static consoleErrorPrefix: string;
     private originalConsole;

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

@@ -1,5 +1,12 @@
+import { NativeModules } from 'react-native';
 import { BaseInstrumentation } from '@grafana/faro-core';
+import type { ExceptionStackFrame } from '@grafana/faro-core';
 import type { CrashReport, CrashReportingOptions } from './types';
+interface CrashReportDetails {
+    context: Record<string, string>;
+    errorMessage: string;
+    stackFrames: ExceptionStackFrame[];
+}
 /**
  * Abstract base class for platform-specific crash reporting implementations.
  *
@@ -44,13 +51,16 @@ export declare abstract class BaseCrashReportingInstrumentation extends BaseInst
      * Platform-specific: Get warning message when trace is unavailable.
      */
     protected abstract getTraceUnavailableWarning(): string;
-    private waitForSessionAttributes;
-    private getNativeModule;
-    private processCrashReports;
-    private sendCrashReport;
+    protected prepareCrashReporting(_nativeModule: typeof NativeModules.FaroReactNativeModule): void | Promise<void>;
+    protected waitForSessionAttributes(maxWaitMs?: number): Promise<void>;
+    protected getNativeModule(): typeof NativeModules.FaroReactNativeModule | null;
+    protected processCrashReports(nativeModule: typeof NativeModules.FaroReactNativeModule): Promise<void>;
+    protected buildCrashReportDetails(crash: CrashReport): CrashReportDetails;
+    protected sendCrashReport(crash: CrashReport): void;
     logDebug(message: string, ...args: any[]): void;
     logInfo(message: string, ...args: any[]): void;
     logWarn(message: string, ...args: any[]): void;
     logError(message: string, ...args: any[]): void;
     unpatch(): void;
 }
+export {};

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

@@ -5,7 +5,7 @@ import type { CrashReportingOptions } from './types';
  */
 export declare class NoOpCrashReportingInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-crash-noop";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     constructor(_options?: CrashReportingOptions);
     initialize(): void;
     unpatch(): void;

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

@@ -0,0 +1,27 @@
+import { NativeModules } from 'react-native';
+import { BaseCrashReportingInstrumentation } from './BaseCrashReportingInstrumentation';
+/**
+ * Shared recovered-crash delivery contract for native platforms.
+ *
+ * Native code owns crash-time persistence. JavaScript owns validation, transport
+ * acceptance, and acknowledgement so retryable failures never delete a report.
+ */
+export declare abstract class RecoveredCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {
+    private nativeModule;
+    private supportsSessionReplay;
+    private metasListenerRegistered;
+    private lastRecordedSessionSignature;
+    private activeSessionId;
+    private activeSessionActivatedAtMs;
+    private activeSessionIsSampled;
+    private readonly recordSessionContextListener;
+    protected prepareCrashReporting(nativeModule: typeof NativeModules.FaroReactNativeModule): void;
+    protected processCrashReports(nativeModule: typeof NativeModules.FaroReactNativeModule): Promise<void>;
+    private recordSessionContext;
+    private replayCrashReport;
+    private buildRecoveredCrashItem;
+    private acknowledgeCrashReport;
+    private hasValidTimestamp;
+    private isWithinReplayWindow;
+    unpatch(): void;
+}

package/dist/types/instrumentations/crashReporting/android/AndroidCrashReportingInstrumentation.d.ts

@@ -1,4 +1,4 @@
-import { BaseCrashReportingInstrumentation } from '../BaseCrashReportingInstrumentation';
+import { RecoveredCrashReportingInstrumentation } from '../RecoveredCrashReportingInstrumentation';
 import type { CrashReport } from '../types';
 import { type ParsedAndroidCrashTrace } from './parseAndroidCrashTrace';
 /**
@@ -13,9 +13,9 @@ import { type ParsedAndroidCrashTrace } from './parseAndroidCrashTrace';
  *
  * ANRs are reported separately by ANRInstrumentation, not via ApplicationExitInfo replay.
  */
-export declare class AndroidCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {
+export declare class AndroidCrashReportingInstrumentation extends RecoveredCrashReportingInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-crash-android";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     protected parseCrashTrace(trace: string): ParsedAndroidCrashTrace | null;
     protected resolveCrashErrorMessage(crash: CrashReport, parsedTrace: ParsedAndroidCrashTrace | null): string;
     protected shouldSkipCrashReport(crash: CrashReport): boolean;

package/dist/types/instrumentations/crashReporting/ios/IosCrashReportingInstrumentation.d.ts

@@ -1,4 +1,4 @@
-import { BaseCrashReportingInstrumentation } from '../BaseCrashReportingInstrumentation';
+import { RecoveredCrashReportingInstrumentation } from '../RecoveredCrashReportingInstrumentation';
 import type { CrashReport } from '../types';
 import { type ParsedIosCrashTrace } from './parseIosCrashTrace';
 /**
@@ -15,9 +15,9 @@ import { type ParsedIosCrashTrace } from './parseIosCrashTrace';
  *
  * Stack frames are symbolicated on the native side before being surfaced.
  */
-export declare class IosCrashReportingInstrumentation extends BaseCrashReportingInstrumentation {
+export declare class IosCrashReportingInstrumentation extends RecoveredCrashReportingInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-crash-ios";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     protected parseCrashTrace(trace: string): ParsedIosCrashTrace | null;
     protected resolveCrashErrorMessage(crash: CrashReport, parsedTrace: ParsedIosCrashTrace | null): string;
     protected shouldSkipCrashReport(crash: CrashReport): boolean;

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

@@ -2,6 +2,7 @@
  * Crash report data structure returned from native module.
  */
 export interface CrashReport {
+    reportId?: string;
     trace?: string;
     signal?: string;
     timestamp?: number;
@@ -11,6 +12,11 @@ export interface CrashReport {
     importance?: number;
     reason?: string;
     status?: number;
+    sessionId?: string;
+    isSampled?: boolean;
+    appVersion?: string;
+    appRelease?: string;
+    appBundleId?: string;
 }
 /**
  * Configuration options for crash reporting instrumentation.

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

@@ -14,7 +14,7 @@ import type { FrameMonitoringOptions } from './types';
  * - Reports meaningful performance degradation that affects user experience
  *
  * ## Frozen Frame Detection
- * Frozen frames are individual frames exceeding `frozenFrameThresholdMs` (default 100ms).
+ * Frozen frames are individual frames exceeding `frozenFrameThresholdMs` (default 700ms).
  * These represent severe jank where the app appears unresponsive.
  *
  * Sends measurements via Faro API:
@@ -31,7 +31,7 @@ import type { FrameMonitoringOptions } from './types';
  *   instrumentations: [
  *     new FrameMonitoringInstrumentation({
  *       targetFps: 60,
- *       frozenFrameThresholdMs: 100,
+ *       frozenFrameThresholdMs: 700,
  *       refreshRatePollingInterval: 30000,
  *     }),
  *   ],
@@ -40,7 +40,7 @@ import type { FrameMonitoringOptions } from './types';
  */
 export declare class FrameMonitoringInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-frame-monitoring";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     private readonly options;
     private pollingIntervalId;
     private eventEmitter;

package/dist/types/instrumentations/frameMonitoring/types.d.ts

@@ -1,9 +1,7 @@
 /**
  * Configuration options for Frame Monitoring instrumentation.
  *
- * These are React Native-specific advanced options. The Flutter SDK uses fixed values
- * for these parameters (not configurable). Defaults here match Flutter's hardcoded values
- * for cross-platform consistency.
+ * Frozen frame threshold (700ms).
  *
  * Note: To enable frame monitoring, set `refreshRateVitals: true` in ReactNativeConfig.
  */
@@ -11,13 +9,13 @@ export interface FrameMonitoringOptions {
     /**
      * Target frames per second for slow frame detection.
      * Frames rendering below this threshold are considered "slow".
-     * Default: 60 (Flutter SDK hardcoded value)
+     * Default: 60
      */
     targetFps?: number;
     /**
      * Threshold in milliseconds for detecting frozen frames.
      * Frames taking longer than this are considered "frozen".
-     * Default: 100ms (Flutter SDK uses 100_000_000 nanoseconds)
+     * Default: 700ms (Android Vitals and OpenTelemetry Android slow rendering instrumentation)
      */
     frozenFrameThresholdMs?: number;
     /**
@@ -28,7 +26,7 @@ export interface FrameMonitoringOptions {
     /**
      * Normalized refresh rate for ProMotion displays (120Hz, etc.).
      * Used to normalize frame rates for high-refresh-rate displays to a standard baseline.
-     * Default: 60 (Flutter SDK's backendSupportedFrameRate)
+     * Default: 60
      */
     normalizedRefreshRate?: number;
 }

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

@@ -29,7 +29,7 @@ export type { HttpRequestPayload } from './utils';
  */
 export declare class HttpInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-http";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     private originalFetch?;
     private ignoredUrls;
     private requests;

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

@@ -7,8 +7,6 @@ import type { PerformanceInstrumentationOptions } from './types';
  * - 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)
@@ -43,7 +41,7 @@ import type { PerformanceInstrumentationOptions } from './types';
  */
 export declare class PerformanceInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-performance";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     private options;
     private intervalId;
     constructor(options?: PerformanceInstrumentationOptions);

package/dist/types/instrumentations/session/FaroSessionActivityBoundary.d.ts

@@ -0,0 +1,8 @@
+import { type PropsWithChildren } from 'react';
+import { type ViewProps } from 'react-native';
+export type FaroSessionActivityBoundaryProps = PropsWithChildren<ViewProps>;
+/**
+ * Records touch activity for the React Native subtree without emitting a user
+ * action or taking ownership of the responder.
+ */
+export declare function FaroSessionActivityBoundary({ children, onStartShouldSetResponderCapture, style, ...viewProps }: FaroSessionActivityBoundaryProps): import("react").JSX.Element;

package/dist/types/instrumentations/session/directSessionActivity.d.ts

@@ -0,0 +1,13 @@
+type DirectSessionActivityHandler = () => void;
+/** Clears a handler left by a previous SDK initialization. */
+export declare function clearDirectSessionActivityHandler(): void;
+/** Registers the active session manager as the direct-activity consumer. */
+export declare function registerDirectSessionActivityHandler(handler: DirectSessionActivityHandler): () => void;
+/**
+ * Refreshes session inactivity without emitting telemetry.
+ *
+ * This is a no-op until session tracking has initialized. Use it for direct
+ * interactions that do not pass through `FaroSessionActivityBoundary`.
+ */
+export declare function notifySessionActivity(): void;
+export {};

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

@@ -1,20 +1,39 @@
 import { BaseInstrumentation } from '@grafana/faro-core';
+/**
+ * Starts a new linked session at an application-defined boundary.
+ *
+ * Call this after changing or clearing the current user for logout, account
+ * changes, or another boundary that must not share a session. Calls made
+ * before Faro initializes, after teardown, or while session tracking is
+ * disabled have no effect.
+ */
+export declare function startNewSession(): void;
 /**
  * Session instrumentation for React Native
  * Manages persistent or volatile sessions with expiration and inactivity tracking
  */
 export declare class SessionInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-session";
-    readonly version = "2.7.0";
+    readonly version = "2.8.2";
     private notifiedSession;
     private sessionManagerInstance;
+    private isResettingSession;
+    private unregisterDirectSessionActivity;
+    private sessionMetaListenerMetas;
+    private beforeSendHookApi;
+    private beforeSendHook;
+    private beforeSendHookTransports;
     private getDefaultSessionDeviceAttributes;
-    private sendSessionStartEvent;
+    private readonly sendSessionStartEvent;
+    private registerSessionMetaListener;
     private createInitialSession;
     private registerBeforeSendHook;
     initialize(): void;
+    /** Starts a new linked session immediately. */
+    startNewSession(): void;
     /**
      * Clean up session manager listeners
      */
     unpatch(): void;
+    destroy(): void;
 }

package/dist/types/instrumentations/session/sessionActivity.d.ts

@@ -0,0 +1,9 @@
+import type { TransportItem } from '@grafana/faro-core';
+export declare enum SessionActivityKind {
+    Meaningful = "meaningful",
+    Passive = "passive"
+}
+/** Classifies how a transport item affects the session inactivity window. */
+export declare function classifySessionActivity(item: TransportItem): SessionActivityKind;
+/** Recovered crashes keep the session captured by the previous process. */
+export declare function isRecoveredCrashItem(item: TransportItem, currentSessionId: string | undefined): boolean;

package/dist/types/instrumentations/session/sessionAttributes.d.ts

@@ -3,8 +3,8 @@ import type { Meta } from '@grafana/faro-core';
  * Session attributes for React Native
  * These attributes are automatically included with every telemetry event
  *
- * Core attributes match Flutter SDK format, with additional mobile-specific
- * monitoring fields (memory, device type, battery, etc.)
+ * Core mobile session attributes, with additional monitoring fields
+ * (memory, device type, battery, etc.)
  *
  * SDK name, core version, and npm adapter are on Faro meta `sdk` (`getSdkMeta` in `metas/sdk.ts`).
  *
@@ -13,6 +13,8 @@ import type { Meta } from '@grafana/faro-core';
 export interface SessionAttributes {
     /** Host app's React Native framework version (e.g. "0.75.1") from `Platform.constants`. */
     react_native_version: string;
+    /** Stable Android process name or Apple bundle identifier for this runtime. */
+    process_name?: string;
     /** Operating system ("iOS" or "Android") */
     device_os?: string;
     /** OS version (e.g., "17.0" for iOS, "15" for Android) */
@@ -59,8 +61,9 @@ export declare function minimalSessionDeviceAttributes(): SessionAttributes;
  * Get all session attributes
  * These attributes are automatically included with every telemetry event
  *
- * Core attributes matching Flutter SDK:
+ * Core session attributes:
  * - react_native_version (RN framework in the host app)
+ * - process_name (Android process name or iOS bundle identifier)
  * - device_os, device_os_version, device_os_detail
  * - device_manufacturer, device_model, device_model_name
  * - device_brand, device_is_physical, device_id

package/dist/types/instrumentations/session/sessionManager/MmkvPersistentSessionsManager.d.ts

@@ -1,3 +1,5 @@
+import type { Metas } from '@grafana/faro-core';
+import { SessionActivityKind } from '../sessionActivity';
 import type { FaroUserSession } from './types';
 /** @internal */
 export declare function resetMmkvSingletonForTests(): void;
@@ -6,14 +8,25 @@ export declare function resetMmkvSingletonForTests(): void;
  * Used when `sessionTracking.persistent` is true.
  */
 export declare class MmkvPersistentSessionsManager {
+    private resetUserSession;
     private updateUserSession;
     private appStateSubscription;
-    private metaUnsubscribe;
-    constructor();
+    private activityWriteTimer;
+    private hasPendingActivityWrite;
+    private lastActivityWrite;
+    private wasBackgrounded;
+    private metaUpdateHandler;
+    private readonly metas;
+    constructor(metas?: Metas);
     static removeUserSession(): void;
     static storeUserSession(session: FaroUserSession): void;
+    private static setRuntimeSession;
+    private static persistSession;
     static fetchUserSession(): FaroUserSession | null;
-    updateSession: () => Promise<void>;
+    checkSession(activity: SessionActivityKind, currentSession?: FaroUserSession | null): FaroUserSession;
+    resetSession(): FaroUserSession;
+    private flushActivityWrite;
+    private recordUserSessionActivity;
     private handleAppStateChange;
     private init;
     unpatch(): void;

package/dist/types/instrumentations/session/sessionManager/VolatileSessionManager.d.ts

@@ -1,14 +1,20 @@
+import type { Metas } from '@grafana/faro-core';
+import { SessionActivityKind } from '../sessionActivity';
 import type { FaroUserSession } from './types';
 export declare class VolatileSessionsManager {
     private static volatileStorage;
+    private resetUserSession;
     private updateUserSession;
     private appStateSubscription;
-    private metaUnsubscribe;
-    constructor();
+    private wasBackgrounded;
+    private metaUpdateHandler;
+    private readonly metas;
+    constructor(metas?: Metas);
     static removeUserSession(): void;
     static storeUserSession(session: FaroUserSession): void;
     static fetchUserSession(): FaroUserSession | null;
-    updateSession: () => Promise<void>;
+    checkSession(activity: SessionActivityKind, currentSession?: FaroUserSession | null): FaroUserSession;
+    resetSession(): FaroUserSession;
     private handleAppStateChange;
     private init;
     /**

package/dist/types/instrumentations/session/sessionManager/persistentSessionRecord.d.ts

@@ -0,0 +1,4 @@
+import type { FaroUserSession } from './types';
+export declare const PERSISTED_SESSION_SCHEMA_VERSION = 1;
+export declare function serializePersistentSession(session: FaroUserSession): string;
+export declare function parsePersistentSession(serialized: string): FaroUserSession | null;

package/dist/types/instrumentations/session/sessionManager/sessionManagerUtils.d.ts

@@ -1,4 +1,5 @@
-import type { Meta } from '@grafana/faro-core';
+import type { Meta, MetaSession } from '@grafana/faro-core';
+import { SessionActivityKind } from '../sessionActivity';
 import type { FaroUserSession } from './types';
 type CreateUserSessionObjectParams = {
     sessionId?: string;
@@ -9,14 +10,25 @@ type CreateUserSessionObjectParams = {
 export declare function createUserSessionObject({ sessionId, started, lastActivity, isSampled: sampledValue, }?: CreateUserSessionObjectParams): FaroUserSession;
 export declare function isUserSessionValid(session: FaroUserSession | null): boolean;
 type GetUserSessionUpdaterParams = {
-    storeUserSession: (session: FaroUserSession) => void | Promise<void>;
-    fetchUserSession: () => FaroUserSession | null | Promise<FaroUserSession | null>;
+    storeUserSession: (session: FaroUserSession) => void;
+    fetchUserSession: () => FaroUserSession | null;
+    recordUserSessionActivity?: (session: FaroUserSession) => void;
 };
-export declare function getUserSessionUpdater({ fetchUserSession, storeUserSession, }: GetUserSessionUpdaterParams): () => Promise<void>;
+type GetUserSessionResetterParams = Pick<GetUserSessionUpdaterParams, 'fetchUserSession' | 'storeUserSession'>;
+export declare function getUserSessionResetter({ fetchUserSession, storeUserSession, }: GetUserSessionResetterParams): () => FaroUserSession;
+export declare function getUserSessionUpdater({ fetchUserSession, recordUserSessionActivity, storeUserSession, }: GetUserSessionUpdaterParams): (activity: SessionActivityKind, currentSession?: FaroUserSession | null) => FaroUserSession;
+/**
+ * Persistent storage serializes sessions with `stringifyExternalJson`, which
+ * drops keys whose value is `undefined`. A session meta carrying such a key
+ * never compares `deepEqual` to its own stored copy, so the sync handler would
+ * rewrite the session on every meta notification. Applying the same round-trip
+ * in memory keeps the two sides comparable, for attributes and overrides alike.
+ */
+export declare function toStorableSessionMeta(sessionMeta: MetaSession): MetaSession;
 export declare function addSessionMetadataToNextSession(newSession: FaroUserSession, previousSession: FaroUserSession | null): Required<FaroUserSession>;
 type GetUserSessionMetaUpdateHandlerParams = {
-    storeUserSession: (session: FaroUserSession) => void | Promise<void>;
-    fetchUserSession: () => FaroUserSession | null | Promise<FaroUserSession | null>;
+    storeUserSession: (session: FaroUserSession) => void;
+    fetchUserSession: () => FaroUserSession | null;
 };
-export declare function getSessionMetaUpdateHandler({ fetchUserSession, storeUserSession, }: GetUserSessionMetaUpdateHandlerParams): (meta: Meta) => Promise<void>;
+export declare function getSessionMetaUpdateHandler({ fetchUserSession, storeUserSession, }: GetUserSessionMetaUpdateHandlerParams): (meta: Meta) => void;
 export {};

package/dist/types/instrumentations/session/sessionManager/types.d.ts

@@ -1,4 +1,5 @@
 import type { MetaSession } from '@grafana/faro-core';
+import type { SessionActivityKind } from '../sessionActivity';
 import type { MmkvPersistentSessionsManager } from './MmkvPersistentSessionsManager';
 import type { VolatileSessionsManager } from './VolatileSessionManager';
 export interface FaroUserSession {
@@ -9,3 +10,8 @@ export interface FaroUserSession {
     sessionMeta?: MetaSession;
 }
 export type SessionManager = typeof VolatileSessionsManager | typeof MmkvPersistentSessionsManager;
+export interface SessionManagerInstance {
+    checkSession(activity: SessionActivityKind, currentSession?: FaroUserSession | null): FaroUserSession;
+    resetSession(): FaroUserSession;
+    unpatch(): void;
+}

package/dist/types/instrumentations/session/sessionProcess.d.ts

@@ -0,0 +1,17 @@
+export declare const MAIN_PROCESS_SESSION_STORAGE_ID = "grafana-faro-react-native-session";
+export interface SessionProcessInfo {
+    identifier: string;
+    isMain: boolean;
+}
+/** Stable native process identity used to isolate session chains. */
+export declare function getSessionProcessInfo(): SessionProcessInfo | null;
+/**
+ * Returns the MMKV instance ID owned by this runtime, or null when exclusive
+ * ownership cannot be established. The main process retains the legacy ID so
+ * upgrades keep their existing previous-session link.
+ */
+export declare function claimSessionPersistenceStorageId(): string | null;
+/** Releases storage ownership after MMKV initialization fails. */
+export declare function releaseSessionPersistenceOwnership(): boolean;
+/** @internal */
+export declare function resetSessionProcessForTests(): void;