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

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

@@ -0,0 +1,209 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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.SessionInstrumentation = void 0;
+var faro_core_1 = require("@grafana/faro-core");
+var sessionAttributes_1 = require("./sessionAttributes");
+var sessionManager_1 = require("./sessionManager");
+var PersistentSessionsManager_1 = require("./sessionManager/PersistentSessionsManager");
+var sessionConstants_1 = require("./sessionManager/sessionConstants");
+var sessionManagerUtils_1 = require("./sessionManager/sessionManagerUtils");
+/**
+ * Session instrumentation for React Native
+ * Manages persistent or volatile sessions with expiration and inactivity tracking
+ */
+var SessionInstrumentation = /** @class */ (function (_super) {
+    __extends(SessionInstrumentation, _super);
+    function SessionInstrumentation() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.name = '@grafana/faro-react-native:instrumentation-session';
+        _this.version = faro_core_1.VERSION;
+        return _this;
+    }
+    SessionInstrumentation.prototype.sendSessionStartEvent = function (meta) {
+        var _a;
+        var session = meta.session;
+        if (session && session.id !== ((_a = this.notifiedSession) === null || _a === void 0 ? void 0 : _a.id)) {
+            this.notifiedSession = session;
+            // no need to add attributes and session id, they are included as part of meta
+            // automatically
+            this.api.pushEvent(faro_core_1.EVENT_SESSION_START, {}, undefined, { skipDedupe: true });
+        }
+    };
+    SessionInstrumentation.prototype.createInitialSession = function (SessionManager, sessionsConfig) {
+        return __awaiter(this, void 0, void 0, function () {
+            var storedUserSession, sessionsConfigTyped, maxPersistenceMs, now, shouldClearPersistentSession, defaultAttributes, emitSessionStartOnInit, initialSession, sessionId, storedUserSessionMeta, overrides, sessionId, overrides;
+            var _a, _b, _c, _d, _e, _f, _g;
+            return __generator(this, function (_h) {
+                switch (_h.label) {
+                    case 0: return [4 /*yield*/, SessionManager.fetchUserSession()];
+                    case 1:
+                        storedUserSession = _h.sent();
+                        sessionsConfigTyped = sessionsConfig;
+                        maxPersistenceMs = (_a = sessionsConfigTyped.maxSessionPersistenceTime) !== null && _a !== void 0 ? _a : sessionConstants_1.MAX_SESSION_PERSISTENCE_TIME;
+                        if (!(sessionsConfig.persistent && storedUserSession)) return [3 /*break*/, 3];
+                        now = (0, faro_core_1.dateNow)();
+                        shouldClearPersistentSession = storedUserSession.lastActivity < now - maxPersistenceMs;
+                        if (!shouldClearPersistentSession) return [3 /*break*/, 3];
+                        return [4 /*yield*/, PersistentSessionsManager_1.PersistentSessionsManager.removeUserSession()];
+                    case 2:
+                        _h.sent();
+                        storedUserSession = null;
+                        _h.label = 3;
+                    case 3: return [4 /*yield*/, (0, sessionAttributes_1.getSessionAttributes)()];
+                    case 4:
+                        defaultAttributes = _h.sent();
+                        if ((0, sessionManagerUtils_1.isUserSessionValid)(storedUserSession)) {
+                            sessionId = storedUserSession === null || storedUserSession === void 0 ? void 0 : storedUserSession.sessionId;
+                            initialSession = (0, sessionManagerUtils_1.createUserSessionObject)({
+                                sessionId: sessionId,
+                                isSampled: storedUserSession.isSampled || false,
+                                started: storedUserSession === null || storedUserSession === void 0 ? void 0 : storedUserSession.started,
+                            });
+                            storedUserSessionMeta = storedUserSession === null || storedUserSession === void 0 ? void 0 : storedUserSession.sessionMeta;
+                            overrides = __assign(__assign({}, (_b = sessionsConfig.session) === null || _b === void 0 ? void 0 : _b.overrides), storedUserSessionMeta === null || storedUserSessionMeta === void 0 ? void 0 : storedUserSessionMeta.overrides);
+                            initialSession.sessionMeta = __assign(__assign({}, sessionsConfig.session), { id: sessionId, attributes: __assign(__assign(__assign(__assign({}, (_c = sessionsConfig.session) === null || _c === void 0 ? void 0 : _c.attributes), storedUserSessionMeta === null || storedUserSessionMeta === void 0 ? void 0 : storedUserSessionMeta.attributes), defaultAttributes), { 
+                                    // For valid resumed sessions we do not want to recalculate the sampling decision on each init phase.
+                                    isSampled: initialSession.isSampled.toString() }), overrides: overrides });
+                            emitSessionStartOnInit = false;
+                        }
+                        else {
+                            sessionId = (_e = (_d = sessionsConfig.session) === null || _d === void 0 ? void 0 : _d.id) !== null && _e !== void 0 ? _e : (0, faro_core_1.genShortID)();
+                            initialSession = (0, sessionManagerUtils_1.createUserSessionObject)({
+                                sessionId: sessionId,
+                                isSampled: (0, sessionManager_1.isSampled)(),
+                            });
+                            overrides = (_f = sessionsConfig.session) === null || _f === void 0 ? void 0 : _f.overrides;
+                            initialSession.sessionMeta = __assign({ id: sessionId, attributes: __assign(__assign({ isSampled: initialSession.isSampled.toString() }, (_g = sessionsConfig.session) === null || _g === void 0 ? void 0 : _g.attributes), defaultAttributes) }, (overrides ? { overrides: overrides } : {}));
+                            emitSessionStartOnInit = true;
+                        }
+                        return [2 /*return*/, { initialSession: initialSession, emitSessionStartOnInit: emitSessionStartOnInit }];
+                }
+            });
+        });
+    };
+    SessionInstrumentation.prototype.registerBeforeSendHook = function (SessionManager) {
+        var _a;
+        var updateSession = new SessionManager().updateSession;
+        (_a = this.transports) === null || _a === void 0 ? void 0 : _a.addBeforeSendHooks(function (item) {
+            var _a, _b, _c;
+            updateSession();
+            var attributes = (_a = item.meta.session) === null || _a === void 0 ? void 0 : _a.attributes;
+            if (attributes && (attributes === null || attributes === void 0 ? void 0 : attributes['isSampled']) === 'true') {
+                var newItem = JSON.parse(JSON.stringify(item));
+                var newAttributes = (_b = newItem.meta.session) === null || _b === void 0 ? void 0 : _b.attributes;
+                newAttributes === null || newAttributes === void 0 ? true : delete newAttributes['isSampled'];
+                if (Object.keys(newAttributes !== null && newAttributes !== void 0 ? newAttributes : {}).length === 0) {
+                    (_c = newItem.meta.session) === null || _c === void 0 ? true : delete _c.attributes;
+                }
+                return newItem;
+            }
+            return null;
+        });
+    };
+    SessionInstrumentation.prototype.initialize = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var sessionTrackingConfig, SessionManager, _a, initialSession, emitSessionStartOnInit, initialSessionMeta;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        this.logDebug('init session instrumentation');
+                        sessionTrackingConfig = this.config.sessionTracking;
+                        if (!(sessionTrackingConfig === null || sessionTrackingConfig === void 0 ? void 0 : sessionTrackingConfig.enabled)) return [3 /*break*/, 3];
+                        SessionManager = (0, sessionManager_1.getSessionManagerByConfig)(sessionTrackingConfig);
+                        this.registerBeforeSendHook(SessionManager);
+                        return [4 /*yield*/, this.createInitialSession(SessionManager, sessionTrackingConfig)];
+                    case 1:
+                        _a = _b.sent(), initialSession = _a.initialSession, emitSessionStartOnInit = _a.emitSessionStartOnInit;
+                        return [4 /*yield*/, SessionManager.storeUserSession(initialSession)];
+                    case 2:
+                        _b.sent();
+                        initialSessionMeta = initialSession.sessionMeta;
+                        this.notifiedSession = initialSessionMeta;
+                        this.api.setSession(initialSessionMeta);
+                        // Store the session manager instance for cleanup
+                        this.sessionManagerInstance = new SessionManager();
+                        if (emitSessionStartOnInit) {
+                            this.api.pushEvent(faro_core_1.EVENT_SESSION_START, {}, undefined, { skipDedupe: true });
+                        }
+                        _b.label = 3;
+                    case 3:
+                        this.metas.addListener(this.sendSessionStartEvent.bind(this));
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Clean up session manager listeners
+     */
+    SessionInstrumentation.prototype.unpatch = function () {
+        if (this.sessionManagerInstance && 'unpatch' in this.sessionManagerInstance) {
+            this.sessionManagerInstance.unpatch();
+        }
+    };
+    return SessionInstrumentation;
+}(faro_core_1.BaseInstrumentation));
+exports.SessionInstrumentation = SessionInstrumentation;
+//# sourceMappingURL=index.js.map

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

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

package/dist/cjs/instrumentations/session/sessionAttributes.js

@@ -0,0 +1,257 @@
+"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 };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionAttributes = getSessionAttributes;
+var react_native_1 = require("react-native");
+var react_native_device_info_1 = __importDefault(require("react-native-device-info"));
+var faro_core_1 = require("@grafana/faro-core");
+/**
+ * Get React Native version from Platform
+ * Returns "unknown" if not available
+ */
+function getReactNativeVersion() {
+    try {
+        // Platform.constants.reactNativeVersion is an object like { major: 0, minor: 75, patch: 1 }
+        var version = react_native_1.Platform.constants.reactNativeVersion;
+        if (version && typeof version === 'object') {
+            var _a = version, major = _a.major, minor = _a.minor, patch = _a.patch, prerelease = _a.prerelease;
+            var versionString = "".concat(major, ".").concat(minor, ".").concat(patch);
+            if (prerelease) {
+                versionString += "-rc.".concat(prerelease);
+            }
+            return versionString;
+        }
+        return 'unknown';
+    }
+    catch (_error) {
+        return 'unknown';
+    }
+}
+/**
+ * Get device ID using react-native-device-info
+ * Returns unique device identifier or 'unknown' on error
+ */
+function getDeviceId() {
+    return __awaiter(this, void 0, void 0, function () {
+        var _error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, react_native_device_info_1.default.getUniqueId()];
+                case 1: 
+                // getUniqueId returns a UUID that persists across app installations
+                return [2 /*return*/, _a.sent()];
+                case 2:
+                    _error_1 = _a.sent();
+                    return [2 /*return*/, 'unknown'];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Get OS detail string matching Flutter SDK format
+ * iOS: "iOS 17.0"
+ * Android: "Android 15 (SDK 35)"
+ */
+function getDeviceOsDetail() {
+    return __awaiter(this, void 0, void 0, function () {
+        var systemName, systemVersion, apiLevel, _error_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    systemName = react_native_device_info_1.default.getSystemName();
+                    systemVersion = react_native_device_info_1.default.getSystemVersion();
+                    if (!(react_native_1.Platform.OS === 'android')) return [3 /*break*/, 4];
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, react_native_device_info_1.default.getApiLevel()];
+                case 2:
+                    apiLevel = _a.sent();
+                    return [2 /*return*/, "".concat(systemName, " ").concat(systemVersion, " (SDK ").concat(apiLevel, ")")];
+                case 3:
+                    _error_2 = _a.sent();
+                    return [2 /*return*/, "".concat(systemName, " ").concat(systemVersion)];
+                case 4: return [2 /*return*/, "".concat(systemName, " ").concat(systemVersion)];
+            }
+        });
+    });
+}
+/**
+ * Get all session attributes
+ * These attributes are automatically included with every telemetry event
+ *
+ * Core attributes matching Flutter SDK:
+ * - faro_sdk_version, react_native_version
+ * - device_os, device_os_version, device_os_detail
+ * - device_manufacturer, device_model, device_model_name
+ * - device_brand, device_is_physical, device_id
+ *
+ * Additional monitoring attributes:
+ * - device_type (mobile/tablet)
+ * - device_memory_total, device_memory_used
+ * - device_battery_level, device_is_charging, device_low_power_mode
+ * - device_carrier
+ */
+function getSessionAttributes() {
+    return __awaiter(this, void 0, void 0, function () {
+        var deviceId, deviceOsDetail, systemName, systemVersion, manufacturer, model, deviceName, brand, isEmulator, isTablet, totalMemory, usedMemory, reactNativeVersion, batteryLevel, isCharging, lowPowerMode, carrier, battery, _error_3, _a, _error_4, _b, _error_5, carrierName, _error_6, attributes, _error_7;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    _c.trys.push([0, 17, , 18]);
+                    return [4 /*yield*/, getDeviceId()];
+                case 1:
+                    deviceId = _c.sent();
+                    return [4 /*yield*/, getDeviceOsDetail()];
+                case 2:
+                    deviceOsDetail = _c.sent();
+                    systemName = react_native_device_info_1.default.getSystemName();
+                    systemVersion = react_native_device_info_1.default.getSystemVersion();
+                    manufacturer = react_native_device_info_1.default.getManufacturerSync();
+                    model = react_native_device_info_1.default.getModel();
+                    deviceName = react_native_device_info_1.default.getDeviceNameSync();
+                    brand = react_native_device_info_1.default.getBrand();
+                    isEmulator = react_native_device_info_1.default.isEmulatorSync();
+                    isTablet = react_native_device_info_1.default.isTablet();
+                    totalMemory = react_native_device_info_1.default.getTotalMemorySync();
+                    usedMemory = react_native_device_info_1.default.getUsedMemorySync();
+                    reactNativeVersion = getReactNativeVersion();
+                    batteryLevel = void 0;
+                    isCharging = void 0;
+                    lowPowerMode = void 0;
+                    carrier = void 0;
+                    _c.label = 3;
+                case 3:
+                    _c.trys.push([3, 5, , 6]);
+                    return [4 /*yield*/, react_native_device_info_1.default.getBatteryLevel()];
+                case 4:
+                    battery = _c.sent();
+                    if (battery >= 0) {
+                        batteryLevel = String(Math.round(battery * 100));
+                    }
+                    return [3 /*break*/, 6];
+                case 5:
+                    _error_3 = _c.sent();
+                    return [3 /*break*/, 6];
+                case 6:
+                    _c.trys.push([6, 8, , 9]);
+                    _a = String;
+                    return [4 /*yield*/, react_native_device_info_1.default.isBatteryCharging()];
+                case 7:
+                    isCharging = _a.apply(void 0, [_c.sent()]);
+                    return [3 /*break*/, 9];
+                case 8:
+                    _error_4 = _c.sent();
+                    return [3 /*break*/, 9];
+                case 9:
+                    _c.trys.push([9, 12, , 13]);
+                    if (!('isPowerSaveMode' in react_native_device_info_1.default)) return [3 /*break*/, 11];
+                    _b = String;
+                    return [4 /*yield*/, react_native_device_info_1.default.isPowerSaveMode()];
+                case 10:
+                    lowPowerMode = _b.apply(void 0, [_c.sent()]);
+                    _c.label = 11;
+                case 11: return [3 /*break*/, 13];
+                case 12:
+                    _error_5 = _c.sent();
+                    return [3 /*break*/, 13];
+                case 13:
+                    _c.trys.push([13, 15, , 16]);
+                    return [4 /*yield*/, react_native_device_info_1.default.getCarrier()];
+                case 14:
+                    carrierName = _c.sent();
+                    if (carrierName && carrierName !== 'unknown') {
+                        carrier = carrierName;
+                    }
+                    return [3 /*break*/, 16];
+                case 15:
+                    _error_6 = _c.sent();
+                    return [3 /*break*/, 16];
+                case 16:
+                    attributes = {
+                        faro_sdk_version: faro_core_1.VERSION,
+                        react_native_version: reactNativeVersion,
+                        device_os: systemName,
+                        device_os_version: systemVersion,
+                        device_os_detail: deviceOsDetail,
+                        device_manufacturer: manufacturer.toLowerCase(),
+                        device_model: model,
+                        device_model_name: deviceName,
+                        device_brand: brand,
+                        device_is_physical: String(!isEmulator),
+                        device_id: deviceId,
+                        device_type: isTablet ? 'tablet' : 'mobile',
+                        device_memory_total: String(totalMemory),
+                        device_memory_used: String(usedMemory),
+                        device_battery_level: batteryLevel,
+                        device_is_charging: isCharging,
+                        device_low_power_mode: lowPowerMode,
+                        device_carrier: carrier,
+                    };
+                    return [2 /*return*/, attributes];
+                case 17:
+                    _error_7 = _c.sent();
+                    // If anything fails, return minimal attributes
+                    return [2 /*return*/, {
+                            faro_sdk_version: faro_core_1.VERSION,
+                            react_native_version: getReactNativeVersion(),
+                            device_os: react_native_1.Platform.OS === 'ios' ? 'iOS' : 'Android',
+                            device_os_version: 'unknown',
+                            device_os_detail: 'unknown',
+                            device_manufacturer: 'unknown',
+                            device_model: 'unknown',
+                            device_model_name: 'unknown',
+                            device_brand: 'unknown',
+                            device_is_physical: 'true',
+                            device_id: 'unknown',
+                            device_type: 'mobile',
+                            device_memory_total: '0',
+                            device_memory_used: '0',
+                        }];
+                case 18: return [2 /*return*/];
+            }
+        });
+    });
+}
+//# sourceMappingURL=sessionAttributes.js.map

package/dist/cjs/instrumentations/session/sessionAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionAttributes.js","sourceRoot":"","sources":["../../../../src/instrumentations/session/sessionAttributes.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\nimport DeviceInfo from 'react-native-device-info';\n\nimport { VERSION } from '@grafana/faro-core';\n\n/**\n * Session attributes for React Native\n * These attributes are automatically included with every telemetry event\n *\n * Core attributes match Flutter SDK format, with additional mobile-specific\n * monitoring fields (memory, device type, battery, etc.)\n */\nexport interface SessionAttributes {\n  /** SDK version (e.g., \"2.0.2\") */\n  faro_sdk_version: string;\n\n  /** React Native version (e.g., \"0.75.1\") */\n  react_native_version: string;\n\n  /** Operating system (\"iOS\" or \"Android\") */\n  device_os: string;\n\n  /** OS version (e.g., \"17.0\" for iOS, \"15\" for Android) */\n  device_os_version: string;\n\n  /** Detailed OS info (e.g., \"iOS 17.0\" or \"Android 15 (SDK 35)\") */\n  device_os_detail: string;\n\n  /** Device manufacturer (e.g., \"apple\", \"samsung\") */\n  device_manufacturer: string;\n\n  /** Raw model identifier (e.g., \"iPhone16,1\", \"SM-A155F\") */\n  device_model: string;\n\n  /** Human-readable model name (e.g., \"iPhone 15 Pro\") */\n  device_model_name: string;\n\n  /** Device brand (e.g., \"iPhone\", \"samsung\") */\n  device_brand: string;\n\n  /** Whether device is physical or emulator (\"true\" or \"false\") */\n  device_is_physical: string;\n\n  /** Unique device ID (UUID) */\n  device_id: string;\n\n  /** Device type (\"mobile\" or \"tablet\") */\n  device_type: string;\n\n  /** Total device memory in bytes */\n  device_memory_total: string;\n\n  /** Currently used memory in bytes */\n  device_memory_used: string;\n\n  /** Battery level percentage (e.g., \"85\") - empty if unavailable */\n  device_battery_level?: string;\n\n  /** Whether device is charging (\"true\" or \"false\") - empty if unavailable */\n  device_is_charging?: string;\n\n  /** Whether low power mode is enabled (\"true\" or \"false\") - empty if unavailable */\n  device_low_power_mode?: string;\n\n  /** Mobile carrier name (e.g., \"Verizon\") - empty if unavailable */\n  device_carrier?: string;\n}\n\n/**\n * Get React Native version from Platform\n * Returns \"unknown\" if not available\n */\nfunction getReactNativeVersion(): string {\n  try {\n    // Platform.constants.reactNativeVersion is an object like { major: 0, minor: 75, patch: 1 }\n    const version = Platform.constants.reactNativeVersion;\n    if (version && typeof version === 'object') {\n      const { major, minor, patch, prerelease } = version as {\n        major: number;\n        minor: number;\n        patch: number;\n        prerelease?: number;\n      };\n      let versionString = `${major}.${minor}.${patch}`;\n      if (prerelease) {\n        versionString += `-rc.${prerelease}`;\n      }\n      return versionString;\n    }\n    return 'unknown';\n  } catch (_error) {\n    return 'unknown';\n  }\n}\n\n/**\n * Get device ID using react-native-device-info\n * Returns unique device identifier or 'unknown' on error\n */\nasync function getDeviceId(): Promise<string> {\n  try {\n    // getUniqueId returns a UUID that persists across app installations\n    return await DeviceInfo.getUniqueId();\n  } catch (_error) {\n    return 'unknown';\n  }\n}\n\n/**\n * Get OS detail string matching Flutter SDK format\n * iOS: \"iOS 17.0\"\n * Android: \"Android 15 (SDK 35)\"\n */\nasync function getDeviceOsDetail(): Promise<string> {\n  const systemName = DeviceInfo.getSystemName();\n  const systemVersion = DeviceInfo.getSystemVersion();\n\n  if (Platform.OS === 'android') {\n    try {\n      const apiLevel = await DeviceInfo.getApiLevel();\n      return `${systemName} ${systemVersion} (SDK ${apiLevel})`;\n    } catch (_error) {\n      return `${systemName} ${systemVersion}`;\n    }\n  }\n\n  return `${systemName} ${systemVersion}`;\n}\n\n/**\n * Get all session attributes\n * These attributes are automatically included with every telemetry event\n *\n * Core attributes matching Flutter SDK:\n * - faro_sdk_version, react_native_version\n * - device_os, device_os_version, device_os_detail\n * - device_manufacturer, device_model, device_model_name\n * - device_brand, device_is_physical, device_id\n *\n * Additional monitoring attributes:\n * - device_type (mobile/tablet)\n * - device_memory_total, device_memory_used\n * - device_battery_level, device_is_charging, device_low_power_mode\n * - device_carrier\n */\nexport async function getSessionAttributes(): Promise<SessionAttributes> {\n  try {\n    // Get device ID asynchronously\n    const deviceId = await getDeviceId();\n    const deviceOsDetail = await getDeviceOsDetail();\n\n    // Get synchronous device info\n    const systemName = DeviceInfo.getSystemName();\n    const systemVersion = DeviceInfo.getSystemVersion();\n    const manufacturer = DeviceInfo.getManufacturerSync();\n    const model = DeviceInfo.getModel();\n    const deviceName = DeviceInfo.getDeviceNameSync();\n    const brand = DeviceInfo.getBrand();\n    const isEmulator = DeviceInfo.isEmulatorSync();\n    const isTablet = DeviceInfo.isTablet();\n\n    // Memory info\n    const totalMemory = DeviceInfo.getTotalMemorySync();\n    const usedMemory = DeviceInfo.getUsedMemorySync();\n\n    // React Native version (equivalent to dart_version in Flutter)\n    const reactNativeVersion = getReactNativeVersion();\n\n    // Try to get async device info (battery, carrier)\n    let batteryLevel: string | undefined;\n    let isCharging: string | undefined;\n    let lowPowerMode: string | undefined;\n    let carrier: string | undefined;\n\n    try {\n      const battery = await DeviceInfo.getBatteryLevel();\n      if (battery >= 0) {\n        batteryLevel = String(Math.round(battery * 100));\n      }\n    } catch (_error) {\n      // Battery info not available\n    }\n\n    try {\n      isCharging = String(await DeviceInfo.isBatteryCharging());\n    } catch (_error) {\n      // Charging status not available\n    }\n\n    try {\n      if ('isPowerSaveMode' in DeviceInfo) {\n        lowPowerMode = String(\n          await (DeviceInfo as typeof DeviceInfo & { isPowerSaveMode: () => Promise<boolean> }).isPowerSaveMode()\n        );\n      }\n    } catch (_error) {\n      // Low power mode not available\n    }\n\n    try {\n      const carrierName = await DeviceInfo.getCarrier();\n      if (carrierName && carrierName !== 'unknown') {\n        carrier = carrierName;\n      }\n    } catch (_error) {\n      // Carrier not available\n    }\n\n    const attributes: SessionAttributes = {\n      faro_sdk_version: VERSION,\n      react_native_version: reactNativeVersion,\n      device_os: systemName,\n      device_os_version: systemVersion,\n      device_os_detail: deviceOsDetail,\n      device_manufacturer: manufacturer.toLowerCase(),\n      device_model: model,\n      device_model_name: deviceName,\n      device_brand: brand,\n      device_is_physical: String(!isEmulator),\n      device_id: deviceId,\n      device_type: isTablet ? 'tablet' : 'mobile',\n      device_memory_total: String(totalMemory),\n      device_memory_used: String(usedMemory),\n      device_battery_level: batteryLevel,\n      device_is_charging: isCharging,\n      device_low_power_mode: lowPowerMode,\n      device_carrier: carrier,\n    };\n\n    return attributes;\n  } catch (_error) {\n    // If anything fails, return minimal attributes\n    return {\n      faro_sdk_version: VERSION,\n      react_native_version: getReactNativeVersion(),\n      device_os: Platform.OS === 'ios' ? 'iOS' : 'Android',\n      device_os_version: 'unknown',\n      device_os_detail: 'unknown',\n      device_manufacturer: 'unknown',\n      device_model: 'unknown',\n      device_model_name: 'unknown',\n      device_brand: 'unknown',\n      device_is_physical: 'true',\n      device_id: 'unknown',\n      device_type: 'mobile',\n      device_memory_total: '0',\n      device_memory_used: '0',\n    };\n  }\n}\n"]}