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

package/dist/cjs/instrumentations/utils/actionContext.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPushEventOptionsWithActionContext = getPushEventOptionsWithActionContext;
+var faro_core_1 = require("@grafana/faro-core");
+/**
+ * PushEvent options with action context for linking events to user actions.
+ * When an active user action exists, adds payload.action so events appear in
+ * Grafana's user action table (e.g. HTTP Errors column).
+ */
+function getPushEventOptionsWithActionContext() {
+    var _a, _b, _c;
+    try {
+        var currentAction = (_b = (_a = faro_core_1.faro.api) === null || _a === void 0 ? void 0 : _a.getActiveUserAction) === null || _b === void 0 ? void 0 : _b.call(_a);
+        var state = (_c = currentAction === null || currentAction === void 0 ? void 0 : currentAction.getState) === null || _c === void 0 ? void 0 : _c.call(currentAction);
+        if (currentAction && (state === faro_core_1.UserActionState.Started || state === faro_core_1.UserActionState.Halted)) {
+            var name_1 = currentAction.name;
+            var parentId_1 = currentAction.parentId;
+            return {
+                customPayloadTransformer: function (payload) {
+                    payload.action = { name: name_1, parentId: parentId_1 };
+                    return payload;
+                },
+            };
+        }
+    }
+    catch (_) {
+        // Silently fail - don't log to avoid instrumentation loops
+    }
+    return undefined;
+}
+//# sourceMappingURL=actionContext.js.map

package/dist/cjs/instrumentations/utils/actionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionContext.js","sourceRoot":"","sources":["../../../../src/instrumentations/utils/actionContext.ts"],"names":[],"mappings":";;AAaA,oFAkBC;AA/BD,gDAM4B;AAE5B;;;;GAIG;AACH,SAAgB,oCAAoC;;IAClD,IAAI,CAAC;QACH,IAAM,aAAa,GAAG,MAAA,MAAA,gBAAI,CAAC,GAAG,0CAAE,mBAAmB,kDAAI,CAAC;QACxD,IAAM,KAAK,GAAG,MAAC,aAAwD,aAAxD,aAAa,uBAAb,aAAa,CAA6C,QAAQ,6DAAI,CAAC;QACtF,IAAI,aAAa,IAAI,CAAC,KAAK,KAAK,2BAAe,CAAC,OAAO,IAAI,KAAK,KAAK,2BAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7F,IAAM,MAAI,GAAG,aAAa,CAAC,IAAI,CAAC;YAChC,IAAM,UAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;YACxC,OAAO;gBACL,wBAAwB,EAAE,UAAC,OAAmB;oBAC5C,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,QAAA,EAAE,QAAQ,YAAA,EAAE,CAAC;oBACpC,OAAO,OAAO,CAAC;gBACjB,CAAC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,2DAA2D;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import {\n  type EventEvent,\n  faro,\n  type PushEventOptions,\n  type UserActionInternalInterface,\n  UserActionState,\n} from '@grafana/faro-core';\n\n/**\n * PushEvent options with action context for linking events to user actions.\n * When an active user action exists, adds payload.action so events appear in\n * Grafana's user action table (e.g. HTTP Errors column).\n */\nexport function getPushEventOptionsWithActionContext(): PushEventOptions | undefined {\n  try {\n    const currentAction = faro.api?.getActiveUserAction?.();\n    const state = (currentAction as unknown as UserActionInternalInterface)?.getState?.();\n    if (currentAction && (state === UserActionState.Started || state === UserActionState.Halted)) {\n      const name = currentAction.name;\n      const parentId = currentAction.parentId;\n      return {\n        customPayloadTransformer: (payload: EventEvent): EventEvent => {\n          payload.action = { name, parentId };\n          return payload;\n        },\n      };\n    }\n  } catch (_) {\n    // Silently fail - don't log to avoid instrumentation loops\n  }\n  return undefined;\n}\n"]}

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

@@ -0,0 +1,64 @@
+"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 __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewInstrumentation = void 0;
+var faro_core_1 = require("@grafana/faro-core");
+/**
+ * View instrumentation for React Native
+ * Tracks screen/view changes
+ *
+ * This instrumentation listens to meta changes and emits VIEW_CHANGED events
+ * when the screen/view changes. The actual screen tracking is handled by
+ * the navigation integration utilities (useFaroNavigation hook).
+ */
+var ViewInstrumentation = /** @class */ (function (_super) {
+    __extends(ViewInstrumentation, _super);
+    function ViewInstrumentation() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.name = '@grafana/faro-react-native:instrumentation-view';
+        _this.version = faro_core_1.VERSION;
+        return _this;
+    }
+    ViewInstrumentation.prototype.sendViewChangedEvent = function (meta) {
+        var _a, _b, _c, _d;
+        var view = meta.view;
+        if (view && view.name !== ((_a = this.notifiedView) === null || _a === void 0 ? void 0 : _a.name)) {
+            this.api.pushEvent(faro_core_1.EVENT_VIEW_CHANGED, {
+                fromView: (_c = (_b = this.notifiedView) === null || _b === void 0 ? void 0 : _b.name) !== null && _c !== void 0 ? _c : faro_core_1.unknownString,
+                toView: (_d = view.name) !== null && _d !== void 0 ? _d : faro_core_1.unknownString,
+            }, undefined, { skipDedupe: true });
+            this.notifiedView = view;
+        }
+    };
+    ViewInstrumentation.prototype.initialize = function () {
+        var unsubscribe = this.metas.addListener(this.sendViewChangedEvent.bind(this));
+        this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : undefined;
+        this.logInfo('View instrumentation initialized');
+    };
+    /**
+     * Clean up meta listener
+     */
+    ViewInstrumentation.prototype.unpatch = function () {
+        if (this.metaUnsubscribe) {
+            this.metaUnsubscribe();
+            this.metaUnsubscribe = undefined;
+        }
+    };
+    return ViewInstrumentation;
+}(faro_core_1.BaseInstrumentation));
+exports.ViewInstrumentation = ViewInstrumentation;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/view/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,gDAAqG;AAGrG;;;;;;;GAOG;AACH;IAAyC,uCAAmB;IAA5D;;QACW,UAAI,GAAG,iDAAiD,CAAC;QACzD,aAAO,GAAG,mBAAO,CAAC;;IAwC7B,CAAC;IAjCS,kDAAoB,GAA5B,UAA6B,IAAU;;QACrC,IAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEvB,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,MAAK,MAAA,IAAI,CAAC,YAAY,0CAAE,IAAI,CAAA,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,SAAS,CAChB,8BAAkB,EAClB;gBACE,QAAQ,EAAE,MAAA,MAAA,IAAI,CAAC,YAAY,0CAAE,IAAI,mCAAI,yBAAa;gBAClD,MAAM,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,yBAAa;aACnC,EACD,SAAS,EACT,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;YAEF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,wCAAU,GAAV;QACE,IAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,eAAe,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,qCAAO,GAAP;QACE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;IACH,CAAC;IACH,0BAAC;AAAD,CAAC,AA1CD,CAAyC,+BAAmB,GA0C3D;AA1CY,kDAAmB","sourcesContent":["import { BaseInstrumentation, EVENT_VIEW_CHANGED, unknownString, VERSION } from '@grafana/faro-core';\nimport type { Meta, MetaView } from '@grafana/faro-core';\n\n/**\n * View instrumentation for React Native\n * Tracks screen/view changes\n *\n * This instrumentation listens to meta changes and emits VIEW_CHANGED events\n * when the screen/view changes. The actual screen tracking is handled by\n * the navigation integration utilities (useFaroNavigation hook).\n */\nexport class ViewInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-view';\n  readonly version = VERSION;\n\n  // previously notified view, to ensure we don't send view changed\n  // event twice for the same view\n  private notifiedView: MetaView | undefined;\n  private metaUnsubscribe: (() => void) | undefined;\n\n  private sendViewChangedEvent(meta: Meta): void {\n    const view = meta.view;\n\n    if (view && view.name !== this.notifiedView?.name) {\n      this.api.pushEvent(\n        EVENT_VIEW_CHANGED,\n        {\n          fromView: this.notifiedView?.name ?? unknownString,\n          toView: view.name ?? unknownString,\n        },\n        undefined,\n        { skipDedupe: true }\n      );\n\n      this.notifiedView = view;\n    }\n  }\n\n  initialize(): void {\n    const unsubscribe = this.metas.addListener(this.sendViewChangedEvent.bind(this));\n    this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : undefined;\n    this.logInfo('View instrumentation initialized');\n  }\n\n  /**\n   * Clean up meta listener\n   */\n  unpatch(): void {\n    if (this.metaUnsubscribe) {\n      this.metaUnsubscribe();\n      this.metaUnsubscribe = undefined;\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,198 @@
+"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 __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XHRInstrumentation = void 0;
+var faro_core_1 = require("@grafana/faro-core");
+var utils_1 = require("../http/utils");
+var httpRequestMonitor_1 = require("../userActions/httpRequestMonitor");
+var actionContext_1 = require("../utils/actionContext");
+var FARO_TRACING_FETCH_EVENT = 'faro.tracing.fetch';
+/**
+ * Get request body size from XHR send argument (best-effort).
+ */
+function getXhrRequestSize(body) {
+    if (body == null)
+        return undefined;
+    if (typeof body === 'string')
+        return new Blob([body]).size;
+    if (body instanceof ArrayBuffer)
+        return body.byteLength;
+    if (ArrayBuffer.isView(body))
+        return body.byteLength;
+    if (typeof Blob !== 'undefined' && body instanceof Blob)
+        return body.size;
+    if (body instanceof URLSearchParams)
+        return new Blob([body.toString()]).size;
+    if (typeof FormData !== 'undefined' && body instanceof FormData)
+        return undefined;
+    return undefined;
+}
+/**
+ * Resolve URL to string (handles relative URLs - best effort).
+ */
+function resolveUrl(url) {
+    var _a;
+    if (typeof url === 'string')
+        return url;
+    return (_a = url === null || url === void 0 ? void 0 : url.href) !== null && _a !== void 0 ? _a : '';
+}
+/**
+ * XMLHttpRequest instrumentation for React Native
+ *
+ * Tracks XHR and axios (which uses XHR) calls and emits faro.tracing.fetch events.
+ * Same format as HttpInstrumentation for Grafana HTTP insights compatibility.
+ */
+var XHRInstrumentation = /** @class */ (function (_super) {
+    __extends(XHRInstrumentation, _super);
+    function XHRInstrumentation(options) {
+        if (options === void 0) { options = {}; }
+        var _this = _super.call(this) || this;
+        _this.name = '@grafana/faro-react-native:instrumentation-xhr';
+        _this.version = faro_core_1.VERSION;
+        _this.requests = new Map();
+        _this.ignoredUrls = options.ignoredUrls || [];
+        return _this;
+    }
+    XHRInstrumentation.prototype.initialize = function () {
+        this.logInfo('XHR instrumentation initialized');
+        this.patchXHR();
+    };
+    XHRInstrumentation.prototype.unpatch = function () {
+        var proto = XMLHttpRequest.prototype;
+        if (this.originalOpen) {
+            proto.open = this.originalOpen;
+            this.originalOpen = undefined;
+        }
+        if (this.originalSend) {
+            proto.send = this.originalSend;
+            this.originalSend = undefined;
+        }
+        this.requests.clear();
+    };
+    XHRInstrumentation.prototype.isUrlIgnored = function (url) {
+        var _a;
+        if (url.includes('grafana.net/collect'))
+            return true;
+        if (this.ignoredUrls.some(function (p) { return p.test(url); }))
+            return true;
+        var configIgnoreUrls = ((_a = this.config) === null || _a === void 0 ? void 0 : _a.ignoreUrls) || [];
+        if (configIgnoreUrls.some(function (pattern) {
+            if (typeof pattern === 'string')
+                return url.includes(pattern);
+            return pattern.test(url);
+        })) {
+            return true;
+        }
+        return false;
+    };
+    XHRInstrumentation.prototype.patchXHR = function () {
+        if (this.originalOpen)
+            return;
+        var proto = XMLHttpRequest.prototype;
+        var self = this;
+        this.originalOpen = proto.open;
+        proto.open = function (method, url, _async, _user, _password) {
+            if (_async === void 0) { _async = true; }
+            this._faroMethod = (method || 'GET').toUpperCase();
+            this._faroUrl = resolveUrl(url);
+            return self.originalOpen.apply(this, [method, url, _async, _user, _password]);
+        };
+        this.originalSend = proto.send;
+        proto.send = function (body) {
+            var _this = this;
+            var _a, _b;
+            var url = (_a = this._faroUrl) !== null && _a !== void 0 ? _a : '';
+            var method = (_b = this._faroMethod) !== null && _b !== void 0 ? _b : 'GET';
+            if (self.isUrlIgnored(url)) {
+                return self.originalSend.apply(this, [body]);
+            }
+            var requestId = (0, faro_core_1.genShortID)();
+            var startTime = Date.now();
+            var requestSize = getXhrRequestSize(body);
+            var payload = {
+                url: url,
+                method: method,
+                requestId: requestId,
+                startTime: startTime,
+                requestSize: requestSize,
+            };
+            self.requests.set(requestId, payload);
+            this._faroRequestId = requestId;
+            this._faroStartTime = startTime;
+            this._faroHandled = false;
+            (0, httpRequestMonitor_1.notifyHttpRequestStart)(payload);
+            var handleComplete = function () {
+                var _a, _b, _c;
+                if (_this._faroHandled)
+                    return;
+                _this._faroHandled = true;
+                var endTime = Date.now();
+                var duration = endTime - ((_a = _this._faroStartTime) !== null && _a !== void 0 ? _a : startTime);
+                var status = _this.status;
+                var contentLength = (_b = _this.getResponseHeader) === null || _b === void 0 ? void 0 : _b.call(_this, 'content-length');
+                var responseSize = contentLength != null
+                    ? (function () {
+                        var n = parseInt(contentLength, 10);
+                        return !Number.isNaN(n) && n >= 0 ? n : undefined;
+                    })()
+                    : undefined;
+                payload.endTime = endTime;
+                payload.duration = duration;
+                payload.status = status;
+                payload.responseSize = responseSize;
+                if (_this.status === 0) {
+                    payload.error = _this.statusText || 'Network request failed';
+                }
+                (0, httpRequestMonitor_1.notifyHttpRequestEnd)(payload);
+                var attributes = (0, utils_1.buildFetchEventAttributes)(payload);
+                var pushOptions = (0, actionContext_1.getPushEventOptionsWithActionContext)();
+                (_c = self.api) === null || _c === void 0 ? void 0 : _c.pushEvent(FARO_TRACING_FETCH_EVENT, attributes, undefined, pushOptions);
+                self.logDebug("XHR request \u2192 ".concat(method, " ").concat(url, " | status=").concat(status, " duration=").concat(duration, "ms") +
+                    (requestSize != null ? " request_size=".concat(requestSize) : '') +
+                    (payload.responseSize != null ? " response_size=".concat(payload.responseSize) : ''));
+                self.requests.delete(requestId);
+            };
+            var originalOnReadyStateChange = this.onreadystatechange;
+            this.onreadystatechange = function (ev) {
+                if (this.readyState === 4) {
+                    handleComplete.call(this);
+                }
+                if (originalOnReadyStateChange) {
+                    originalOnReadyStateChange.call(this, ev);
+                }
+            };
+            this.addEventListener('load', handleComplete);
+            this.addEventListener('error', function () {
+                if (!this._faroHandled) {
+                    payload.error = 'Network request failed';
+                    handleComplete.call(this);
+                }
+            }.bind(this));
+            this.addEventListener('abort', function () {
+                if (!this._faroHandled) {
+                    payload.error = 'Request aborted';
+                    payload.status = 0;
+                    handleComplete.call(this);
+                }
+            }.bind(this));
+            return self.originalSend.apply(this, [body]);
+        };
+    };
+    return XHRInstrumentation;
+}(faro_core_1.BaseInstrumentation));
+exports.XHRInstrumentation = XHRInstrumentation;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/xhr/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseInstrumentation, genShortID, VERSION } from '@grafana/faro-core';\n\nimport { buildFetchEventAttributes } from '../http/utils';\nimport type { HttpRequestPayload } from '../http/utils';\nimport { notifyHttpRequestEnd, notifyHttpRequestStart } from '../userActions/httpRequestMonitor';\nimport { getPushEventOptionsWithActionContext } from '../utils/actionContext';\n\nconst FARO_TRACING_FETCH_EVENT = 'faro.tracing.fetch';\n\n/**\n * Get request body size from XHR send argument (best-effort).\n */\nfunction getXhrRequestSize(body: Document | XMLHttpRequestBodyInit | null | undefined): number | undefined {\n  if (body == null) return undefined;\n  if (typeof body === 'string') return new Blob([body]).size;\n  if (body instanceof ArrayBuffer) return body.byteLength;\n  if (ArrayBuffer.isView(body)) return body.byteLength;\n  if (typeof Blob !== 'undefined' && body instanceof Blob) return body.size;\n  if (body instanceof URLSearchParams) return new Blob([body.toString()]).size;\n  if (typeof FormData !== 'undefined' && body instanceof FormData) return undefined;\n  return undefined;\n}\n\n/**\n * Resolve URL to string (handles relative URLs - best effort).\n */\nfunction resolveUrl(url: string | URL): string {\n  if (typeof url === 'string') return url;\n  return url?.href ?? '';\n}\n\ntype XHRExtended = XMLHttpRequest & {\n  _faroMethod?: string;\n  _faroUrl?: string;\n  _faroRequestId?: string;\n  _faroStartTime?: number;\n  _faroHandled?: boolean;\n};\n\n/**\n * XMLHttpRequest instrumentation for React Native\n *\n * Tracks XHR and axios (which uses XHR) calls and emits faro.tracing.fetch events.\n * Same format as HttpInstrumentation for Grafana HTTP insights compatibility.\n */\nexport class XHRInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-xhr';\n  readonly version = VERSION;\n\n  private originalOpen?: typeof XMLHttpRequest.prototype.open;\n  private originalSend?: typeof XMLHttpRequest.prototype.send;\n  private ignoredUrls: RegExp[];\n  private requests: Map<string, HttpRequestPayload> = new Map();\n\n  constructor(options: { ignoredUrls?: RegExp[] } = {}) {\n    super();\n    this.ignoredUrls = options.ignoredUrls || [];\n  }\n\n  initialize(): void {\n    this.logInfo('XHR instrumentation initialized');\n    this.patchXHR();\n  }\n\n  unpatch(): void {\n    const proto = XMLHttpRequest.prototype;\n    if (this.originalOpen) {\n      proto.open = this.originalOpen;\n      this.originalOpen = undefined;\n    }\n    if (this.originalSend) {\n      proto.send = this.originalSend;\n      this.originalSend = undefined;\n    }\n    this.requests.clear();\n  }\n\n  private isUrlIgnored(url: string): boolean {\n    if (url.includes('grafana.net/collect')) return true;\n    if (this.ignoredUrls.some((p) => p.test(url))) return true;\n    const configIgnoreUrls = this.config?.ignoreUrls || [];\n    if (\n      configIgnoreUrls.some((pattern) => {\n        if (typeof pattern === 'string') return url.includes(pattern);\n        return pattern.test(url);\n      })\n    ) {\n      return true;\n    }\n    return false;\n  }\n\n  private patchXHR(): void {\n    if (this.originalOpen) return;\n\n    const proto = XMLHttpRequest.prototype;\n    const self = this;\n\n    this.originalOpen = proto.open;\n    proto.open = function (\n      this: XHRExtended,\n      method: string,\n      url: string | URL,\n      _async = true,\n      _user?: string,\n      _password?: string\n    ): void {\n      this._faroMethod = (method || 'GET').toUpperCase();\n      this._faroUrl = resolveUrl(url);\n      return self.originalOpen!.apply(this, [method, url, _async, _user as string, _password as string] as Parameters<\n        typeof XMLHttpRequest.prototype.open\n      >);\n    };\n\n    this.originalSend = proto.send;\n    proto.send = function (this: XHRExtended, body?: Document | XMLHttpRequestBodyInit | null): void {\n      const url = this._faroUrl ?? '';\n      const method = this._faroMethod ?? 'GET';\n\n      if (self.isUrlIgnored(url)) {\n        return self.originalSend!.apply(this, [body]);\n      }\n\n      const requestId = genShortID();\n      const startTime = Date.now();\n      const requestSize = getXhrRequestSize(body);\n\n      const payload: HttpRequestPayload = {\n        url,\n        method,\n        requestId,\n        startTime,\n        requestSize,\n      };\n      self.requests.set(requestId, payload);\n      this._faroRequestId = requestId;\n      this._faroStartTime = startTime;\n      this._faroHandled = false;\n\n      notifyHttpRequestStart(payload);\n\n      const handleComplete = (): void => {\n        if (this._faroHandled) return;\n        this._faroHandled = true;\n\n        const endTime = Date.now();\n        const duration = endTime - (this._faroStartTime ?? startTime);\n        const status = this.status;\n        const contentLength = this.getResponseHeader?.('content-length');\n        const responseSize =\n          contentLength != null\n            ? (() => {\n                const n = parseInt(contentLength, 10);\n                return !Number.isNaN(n) && n >= 0 ? n : undefined;\n              })()\n            : undefined;\n\n        payload.endTime = endTime;\n        payload.duration = duration;\n        payload.status = status;\n        payload.responseSize = responseSize;\n\n        if (this.status === 0) {\n          payload.error = this.statusText || 'Network request failed';\n        }\n\n        notifyHttpRequestEnd(payload);\n\n        const attributes = buildFetchEventAttributes(payload);\n        const pushOptions = getPushEventOptionsWithActionContext();\n        self.api?.pushEvent(FARO_TRACING_FETCH_EVENT, attributes, undefined, pushOptions);\n\n        self.logDebug(\n          `XHR request → ${method} ${url} | status=${status} duration=${duration}ms` +\n            (requestSize != null ? ` request_size=${requestSize}` : '') +\n            (payload.responseSize != null ? ` response_size=${payload.responseSize}` : '')\n        );\n\n        self.requests.delete(requestId);\n      };\n\n      const originalOnReadyStateChange = this.onreadystatechange;\n      this.onreadystatechange = function (this: XMLHttpRequest, ev: Event): void {\n        if (this.readyState === 4) {\n          handleComplete.call(this);\n        }\n        if (originalOnReadyStateChange) {\n          originalOnReadyStateChange.call(this, ev);\n        }\n      };\n\n      this.addEventListener('load', handleComplete);\n      this.addEventListener(\n        'error',\n        function (this: XHRExtended) {\n          if (!this._faroHandled) {\n            payload.error = 'Network request failed';\n            handleComplete.call(this);\n          }\n        }.bind(this)\n      );\n      this.addEventListener(\n        'abort',\n        function (this: XHRExtended) {\n          if (!this._faroHandled) {\n            payload.error = 'Request aborted';\n            payload.status = 0;\n            handleComplete.call(this);\n          }\n        }.bind(this)\n      );\n\n      return self.originalSend!.apply(this, [body]);\n    };\n  }\n}\n"]}

package/dist/cjs/metas/page.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPageMeta = getPageMeta;
+/**
+ * Returns empty page meta for React Native.
+ * This overrides the default page meta from faro-core which is web-specific.
+ * In React Native, we use view meta for screen tracking instead.
+ */
+function getPageMeta() {
+    return function () { return ({
+        page: {},
+    }); };
+}
+//# sourceMappingURL=page.js.map

package/dist/cjs/metas/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/metas/page.ts"],"names":[],"mappings":";;AAOA,kCAIC;AATD;;;;GAIG;AACH,SAAgB,WAAW;IACzB,OAAO,cAA2B,OAAA,CAAC;QACjC,IAAI,EAAE,EAAE;KACT,CAAC,EAFgC,CAEhC,CAAC;AACL,CAAC","sourcesContent":["import type { MetaPage } from '@grafana/faro-core';\n\n/**\n * Returns empty page meta for React Native.\n * This overrides the default page meta from faro-core which is web-specific.\n * In React Native, we use view meta for screen tracking instead.\n */\nexport function getPageMeta() {\n  return (): { page?: MetaPage } => ({\n    page: {},\n  });\n}\n"]}

package/dist/cjs/metas/screen.js

@@ -0,0 +1,58 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getScreenMeta = void 0;
+exports.createScreenMeta = createScreenMeta;
+exports.setCurrentScreen = setCurrentScreen;
+exports.getCurrentScreen = getCurrentScreen;
+var faro_core_1 = require("@grafana/faro-core");
+var currentScreen;
+var screenId;
+/**
+ * Screen meta for React Native
+ * Tracks the current screen name instead of URL (as in web page meta)
+ */
+function createScreenMeta(_a) {
+    var _b = _a === void 0 ? {} : _a, generateScreenId = _b.generateScreenId, initialScreenMeta = _b.initialScreenMeta;
+    var screenMeta = function () {
+        var screenName = currentScreen || 'unknown';
+        if (generateScreenId !== undefined && (0, faro_core_1.isFunction)(generateScreenId) && currentScreen !== screenName) {
+            screenId = generateScreenId(screenName);
+        }
+        return {
+            page: __assign(__assign({ url: "screen://".concat(screenName) }, (screenId ? { id: screenId } : {})), initialScreenMeta),
+        };
+    };
+    return screenMeta;
+}
+/**
+ * Updates the current screen name
+ * Called by navigation instrumentation when screen changes
+ */
+function setCurrentScreen(screenName) {
+    currentScreen = screenName;
+}
+/**
+ * Gets the current screen name
+ */
+function getCurrentScreen() {
+    return currentScreen;
+}
+/**
+ * Default screen meta with no custom configuration
+ */
+var getScreenMeta = function () {
+    return createScreenMeta();
+};
+exports.getScreenMeta = getScreenMeta;
+//# sourceMappingURL=screen.js.map

package/dist/cjs/metas/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../../../src/metas/screen.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAcA,4CAoBC;AAMD,4CAEC;AAKD,4CAEC;AAjDD,gDAA0E;AAE1E,IAAI,aAAiC,CAAC;AACtC,IAAI,QAA4B,CAAC;AAOjC;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,EAAmE;QAAnE,qBAAiE,EAAE,KAAA,EAAjE,gBAAgB,sBAAA,EAAE,iBAAiB,uBAAA;IAGpE,IAAM,UAAU,GAAiC;QAC/C,IAAM,UAAU,GAAG,aAAa,IAAI,SAAS,CAAC;QAE9C,IAAI,gBAAgB,KAAK,SAAS,IAAI,IAAA,sBAAU,EAAC,gBAAgB,CAAC,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;YACnG,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,IAAI,sBACF,GAAG,EAAE,mBAAY,UAAU,CAAE,IAC1B,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAClC,iBAAiB,CACrB;SACF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,UAAkB;IACjD,aAAa,GAAG,UAAU,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACI,IAAM,aAAa,GAAG;IAC3B,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB","sourcesContent":["import { isFunction, type Meta, type MetaItem } from '@grafana/faro-core';\n\nlet currentScreen: string | undefined;\nlet screenId: string | undefined;\n\ntype CreateScreenMetaProps = {\n  generateScreenId?: (screenName: string) => string;\n  initialScreenMeta?: Meta['page'];\n};\n\n/**\n * Screen meta for React Native\n * Tracks the current screen name instead of URL (as in web page meta)\n */\nexport function createScreenMeta({ generateScreenId, initialScreenMeta }: CreateScreenMetaProps = {}): MetaItem<\n  Pick<Meta, 'page'>\n> {\n  const screenMeta: MetaItem<Pick<Meta, 'page'>> = () => {\n    const screenName = currentScreen || 'unknown';\n\n    if (generateScreenId !== undefined && isFunction(generateScreenId) && currentScreen !== screenName) {\n      screenId = generateScreenId(screenName);\n    }\n\n    return {\n      page: {\n        url: `screen://${screenName}`,\n        ...(screenId ? { id: screenId } : {}),\n        ...initialScreenMeta,\n      },\n    };\n  };\n\n  return screenMeta;\n}\n\n/**\n * Updates the current screen name\n * Called by navigation instrumentation when screen changes\n */\nexport function setCurrentScreen(screenName: string): void {\n  currentScreen = screenName;\n}\n\n/**\n * Gets the current screen name\n */\nexport function getCurrentScreen(): string | undefined {\n  return currentScreen;\n}\n\n/**\n * Default screen meta with no custom configuration\n */\nexport const getScreenMeta = (): MetaItem<Pick<Meta, 'page'>> => {\n  return createScreenMeta();\n};\n"]}

package/dist/cjs/metas/sdk.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSdkMeta = void 0;
+var faro_core_1 = require("@grafana/faro-core");
+/**
+ * SDK meta for React Native
+ * Provides information about the Faro SDK and its integrations
+ */
+var getSdkMeta = function () {
+    return function () { return ({
+        sdk: {
+            name: '@grafana/faro-react-native',
+            version: faro_core_1.VERSION,
+            integrations: faro_core_1.faro.config.instrumentations.map(function (instrumentation) { return ({
+                name: instrumentation.name,
+                version: instrumentation.version,
+            }); }),
+        },
+    }); };
+};
+exports.getSdkMeta = getSdkMeta;
+//# sourceMappingURL=sdk.js.map

package/dist/cjs/metas/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/metas/sdk.ts"],"names":[],"mappings":";;;AAAA,gDAAmD;AAGnD;;;GAGG;AACI,IAAM,UAAU,GAAG;IACxB,OAAO,cAAM,OAAA,CAAC;QACZ,GAAG,EAAE;YACH,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,mBAAO;YAChB,YAAY,EAAE,gBAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAC,eAAkD,IAAK,OAAA,CAAC;gBACtG,IAAI,EAAE,eAAe,CAAC,IAAI;gBAC1B,OAAO,EAAE,eAAe,CAAC,OAAO;aACjC,CAAC,EAHqG,CAGrG,CAAC;SACJ;KACF,CAAC,EATW,CASX,CAAC;AACL,CAAC,CAAC;AAXW,QAAA,UAAU,cAWrB","sourcesContent":["import { faro, VERSION } from '@grafana/faro-core';\nimport type { Meta, MetaItem } from '@grafana/faro-core';\n\n/**\n * SDK meta for React Native\n * Provides information about the Faro SDK and its integrations\n */\nexport const getSdkMeta = (): MetaItem<Pick<Meta, 'sdk'>> => {\n  return () => ({\n    sdk: {\n      name: '@grafana/faro-react-native',\n      version: VERSION,\n      integrations: faro.config.instrumentations.map((instrumentation: { name: string; version: string }) => ({\n        name: instrumentation.name,\n        version: instrumentation.version,\n      })),\n    },\n  });\n};\n"]}

package/dist/cjs/navigation/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onNavigationStateChange = exports.getRouteName = exports.getCurrentRoute = exports.createNavigationStateChangeHandler = exports.useFaroNavigation = void 0;
+var useFaroNavigation_1 = require("./useFaroNavigation");
+Object.defineProperty(exports, "useFaroNavigation", { enumerable: true, get: function () { return useFaroNavigation_1.useFaroNavigation; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "createNavigationStateChangeHandler", { enumerable: true, get: function () { return utils_1.createNavigationStateChangeHandler; } });
+Object.defineProperty(exports, "getCurrentRoute", { enumerable: true, get: function () { return utils_1.getCurrentRoute; } });
+Object.defineProperty(exports, "getRouteName", { enumerable: true, get: function () { return utils_1.getRouteName; } });
+Object.defineProperty(exports, "onNavigationStateChange", { enumerable: true, get: function () { return utils_1.onNavigationStateChange; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/navigation/index.ts"],"names":[],"mappings":";;;AAAA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,iCAAqH;AAA5G,2HAAA,kCAAkC,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,gHAAA,uBAAuB,OAAA","sourcesContent":["export { useFaroNavigation } from './useFaroNavigation';\nexport { createNavigationStateChangeHandler, getCurrentRoute, getRouteName, onNavigationStateChange } from './utils';\nexport type { ReactNavigationConfig, ReactNavigationDependencies } from './types';\n"]}

package/dist/cjs/navigation/types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/navigation/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { NavigationState, PartialState } from '@react-navigation/native';\n\n/**\n * React Navigation dependencies that need to be provided by the user\n */\nexport interface ReactNavigationDependencies {\n  useNavigation: () => { navigate: (name: string, params?: object) => void };\n  useRoute: () => { key: string; name: string; params?: object };\n  useNavigationState: <T>(selector: (state: NavigationState | PartialState<NavigationState>) => T) => T;\n}\n\n/**\n * Configuration for React Navigation integration\n */\nexport interface ReactNavigationConfig {\n  dependencies: ReactNavigationDependencies;\n}\n"]}

package/dist/cjs/navigation/useFaroNavigation.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFaroNavigation = useFaroNavigation;
+var react_1 = require("react");
+var utils_1 = require("./utils");
+/**
+ * Hook to integrate Faro with React Navigation
+ *
+ * This hook automatically tracks navigation changes and updates Faro's view meta.
+ * It works with both NavigationContainer refs and the useNavigationContainerRef hook.
+ *
+ * @param navigationRef - Reference to the NavigationContainer
+ *
+ * @example
+ * ```
+ * import { useNavigationContainerRef } from '@react-navigation/native';
+ * import { useFaroNavigation } from '@grafana/faro-react-native';
+ *
+ * function App() {
+ *   const navigationRef = useNavigationContainerRef();
+ *   useFaroNavigation(navigationRef);
+ *
+ *   return (
+ *     <NavigationContainer ref={navigationRef}>
+ *       // your navigation
+ *     </NavigationContainer>
+ *   );
+ * }
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- ParamList is app-specific, using any for flexibility
+function useFaroNavigation(navigationRef) {
+    var unsubscribeRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(function () {
+        if (!navigationRef.current) {
+            return;
+        }
+        // Get initial state and track it
+        var initialState = navigationRef.current.getRootState();
+        if (initialState) {
+            (0, utils_1.onNavigationStateChange)(initialState);
+        }
+        // Subscribe to navigation state changes
+        unsubscribeRef.current = navigationRef.current.addListener('state', function (e) {
+            (0, utils_1.onNavigationStateChange)(e.data.state);
+        });
+        // Cleanup subscription on unmount
+        return function () {
+            if (unsubscribeRef.current) {
+                unsubscribeRef.current();
+                unsubscribeRef.current = null;
+            }
+        };
+    }, [navigationRef]);
+}
+//# sourceMappingURL=useFaroNavigation.js.map

package/dist/cjs/navigation/useFaroNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFaroNavigation.js","sourceRoot":"","sources":["../../../src/navigation/useFaroNavigation.ts"],"names":[],"mappings":";;AA+BA,8CA2BC;AAzDD,+BAA0C;AAE1C,iCAAkD;AAElD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,sHAAsH;AACtH,SAAgB,iBAAiB,CAAC,aAA8D;IAC9F,IAAM,cAAc,GAAG,IAAA,cAAM,EAAsB,IAAI,CAAC,CAAC;IAEzD,IAAA,iBAAS,EAAC;QACR,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,iCAAiC;QACjC,IAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC1D,IAAI,YAAY,EAAE,CAAC;YACjB,IAAA,+BAAuB,EAAC,YAAY,CAAC,CAAC;QACxC,CAAC;QAED,wCAAwC;QACxC,cAAc,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,UAAC,CAAC;YACpE,IAAA,+BAAuB,EAAC,CAAC,CAAC,IAAI,CAAC,KAAwB,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,OAAO;YACL,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,cAAc,CAAC,OAAO,EAAE,CAAC;gBACzB,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC;YAChC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import type { NavigationContainerRef, NavigationState } from '@react-navigation/native';\nimport { useEffect, useRef } from 'react';\n\nimport { onNavigationStateChange } from './utils';\n\n/**\n * Hook to integrate Faro with React Navigation\n *\n * This hook automatically tracks navigation changes and updates Faro's view meta.\n * It works with both NavigationContainer refs and the useNavigationContainerRef hook.\n *\n * @param navigationRef - Reference to the NavigationContainer\n *\n * @example\n * ```\n * import { useNavigationContainerRef } from '@react-navigation/native';\n * import { useFaroNavigation } from '@grafana/faro-react-native';\n *\n * function App() {\n *   const navigationRef = useNavigationContainerRef();\n *   useFaroNavigation(navigationRef);\n *\n *   return (\n *     <NavigationContainer ref={navigationRef}>\n *       // your navigation\n *     </NavigationContainer>\n *   );\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- ParamList is app-specific, using any for flexibility\nexport function useFaroNavigation(navigationRef: { current: NavigationContainerRef<any> | null }): void {\n  const unsubscribeRef = useRef<(() => void) | null>(null);\n\n  useEffect(() => {\n    if (!navigationRef.current) {\n      return;\n    }\n\n    // Get initial state and track it\n    const initialState = navigationRef.current.getRootState();\n    if (initialState) {\n      onNavigationStateChange(initialState);\n    }\n\n    // Subscribe to navigation state changes\n    unsubscribeRef.current = navigationRef.current.addListener('state', (e) => {\n      onNavigationStateChange(e.data.state as NavigationState);\n    });\n\n    // Cleanup subscription on unmount\n    return () => {\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current();\n        unsubscribeRef.current = null;\n      }\n    };\n  }, [navigationRef]);\n}\n"]}

package/dist/cjs/navigation/utils.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentRoute = getCurrentRoute;
+exports.getRouteName = getRouteName;
+exports.onNavigationStateChange = onNavigationStateChange;
+exports.createNavigationStateChangeHandler = createNavigationStateChangeHandler;
+var faro_core_1 = require("@grafana/faro-core");
+var screen_1 = require("../metas/screen");
+/**
+ * Gets the currently active route from navigation state
+ */
+function getCurrentRoute(state) {
+    var _a;
+    if (!state || !state.routes || state.routes.length === 0) {
+        return undefined;
+    }
+    var route = state.routes[(_a = state.index) !== null && _a !== void 0 ? _a : 0];
+    // If this route has nested state, recursively get the active route
+    if (route === null || route === void 0 ? void 0 : route.state) {
+        return getCurrentRoute(route.state);
+    }
+    // Only return if route has all required properties
+    if (route && 'key' in route && 'name' in route && route.key && route.name) {
+        return route;
+    }
+    return undefined;
+}
+/**
+ * Extracts the route name from a route object
+ */
+function getRouteName(route) {
+    return route === null || route === void 0 ? void 0 : route.name;
+}
+/**
+ * Handles navigation state changes and updates Faro with the new screen
+ * @param state - The current navigation state
+ */
+function onNavigationStateChange(state) {
+    var _a, _b;
+    if (!state) {
+        return;
+    }
+    var currentRoute = getCurrentRoute(state);
+    var screenName = getRouteName(currentRoute);
+    if (screenName) {
+        // Update the screen meta
+        (0, screen_1.setCurrentScreen)(screenName);
+        // Update the view meta which will trigger VIEW_CHANGED event
+        (_a = faro_core_1.faro.api) === null || _a === void 0 ? void 0 : _a.setView({ name: screenName });
+        // Optionally push additional attributes if route has params
+        if (currentRoute === null || currentRoute === void 0 ? void 0 : currentRoute.params) {
+            (_b = faro_core_1.faro.api) === null || _b === void 0 ? void 0 : _b.pushEvent('navigation', {
+                screen: screenName,
+                params: JSON.stringify(currentRoute.params),
+            });
+        }
+    }
+}
+/**
+ * Creates a navigation state change handler
+ * Use this with NavigationContainer's onStateChange prop
+ *
+ * @example
+ * ```
+ * import { NavigationContainer } from '@react-navigation/native';
+ * import { createNavigationStateChangeHandler } from '@grafana/faro-react-native';
+ *
+ * const onStateChange = createNavigationStateChangeHandler();
+ *
+ * // In your component:
+ * <NavigationContainer onStateChange={onStateChange}>
+ *   // your navigation
+ * </NavigationContainer>
+ * ```
+ */
+function createNavigationStateChangeHandler() {
+    return onNavigationStateChange;
+}
+//# sourceMappingURL=utils.js.map

package/dist/cjs/navigation/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/navigation/utils.ts"],"names":[],"mappings":";;AASA,0CAoBC;AAKD,oCAEC;AAMD,0DAuBC;AAmBD,gFAEC;AApFD,gDAA0C;AAE1C,0CAAmD;AAEnD;;GAEG;AACH,SAAgB,eAAe,CAC7B,KAAkE;;IAElE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAA,KAAK,CAAC,KAAK,mCAAI,CAAC,CAAC,CAAC;IAE7C,mEAAmE;IACnE,IAAI,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,EAAE,CAAC;QACjB,OAAO,eAAe,CAAC,KAAK,CAAC,KAAwB,CAAC,CAAC;IACzD,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1E,OAAO,KAAsB,CAAC;IAChC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAgC;IAC3D,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,KAAkC;;IACxE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,IAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE9C,IAAI,UAAU,EAAE,CAAC;QACf,yBAAyB;QACzB,IAAA,yBAAgB,EAAC,UAAU,CAAC,CAAC;QAE7B,6DAA6D;QAC7D,MAAA,gBAAI,CAAC,GAAG,0CAAE,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAExC,4DAA4D;QAC5D,IAAI,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,MAAM,EAAE,CAAC;YACzB,MAAA,gBAAI,CAAC,GAAG,0CAAE,SAAS,CAAC,YAAY,EAAE;gBAChC,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kCAAkC;IAChD,OAAO,uBAAuB,CAAC;AACjC,CAAC","sourcesContent":["import type { NavigationState, PartialState, Route } from '@react-navigation/native';\n\nimport { faro } from '@grafana/faro-core';\n\nimport { setCurrentScreen } from '../metas/screen';\n\n/**\n * Gets the currently active route from navigation state\n */\nexport function getCurrentRoute(\n  state: NavigationState | PartialState<NavigationState> | undefined\n): Route<string> | undefined {\n  if (!state || !state.routes || state.routes.length === 0) {\n    return undefined;\n  }\n\n  const route = state.routes[state.index ?? 0];\n\n  // If this route has nested state, recursively get the active route\n  if (route?.state) {\n    return getCurrentRoute(route.state as NavigationState);\n  }\n\n  // Only return if route has all required properties\n  if (route && 'key' in route && 'name' in route && route.key && route.name) {\n    return route as Route<string>;\n  }\n\n  return undefined;\n}\n\n/**\n * Extracts the route name from a route object\n */\nexport function getRouteName(route: Route<string> | undefined): string | undefined {\n  return route?.name;\n}\n\n/**\n * Handles navigation state changes and updates Faro with the new screen\n * @param state - The current navigation state\n */\nexport function onNavigationStateChange(state: NavigationState | undefined): void {\n  if (!state) {\n    return;\n  }\n\n  const currentRoute = getCurrentRoute(state);\n  const screenName = getRouteName(currentRoute);\n\n  if (screenName) {\n    // Update the screen meta\n    setCurrentScreen(screenName);\n\n    // Update the view meta which will trigger VIEW_CHANGED event\n    faro.api?.setView({ name: screenName });\n\n    // Optionally push additional attributes if route has params\n    if (currentRoute?.params) {\n      faro.api?.pushEvent('navigation', {\n        screen: screenName,\n        params: JSON.stringify(currentRoute.params),\n      });\n    }\n  }\n}\n\n/**\n * Creates a navigation state change handler\n * Use this with NavigationContainer's onStateChange prop\n *\n * @example\n * ```\n * import { NavigationContainer } from '@react-navigation/native';\n * import { createNavigationStateChangeHandler } from '@grafana/faro-react-native';\n *\n * const onStateChange = createNavigationStateChangeHandler();\n *\n * // In your component:\n * <NavigationContainer onStateChange={onStateChange}>\n *   // your navigation\n * </NavigationContainer>\n * ```\n */\nexport function createNavigationStateChangeHandler(): (state: NavigationState | undefined) => void {\n  return onNavigationStateChange;\n}\n"]}