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

package/dist/esm/instrumentation.js

@@ -0,0 +1,183 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { context, trace } from '@opentelemetry/api';
+import { registerInstrumentations } from '@opentelemetry/instrumentation';
+import { defaultResource, resourceFromAttributes } from '@opentelemetry/resources';
+import { BatchSpanProcessor, BasicTracerProvider as ReactNativeTracerProvider } from '@opentelemetry/sdk-trace-base';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, SEMRESATTRS_DEPLOYMENT_ENVIRONMENT, } from '@opentelemetry/semantic-conventions';
+import { BaseInstrumentation, getInternalFaroFromGlobalObject, VERSION } from '@grafana/faro-core';
+import { FaroTraceExporter } from './exporters/faroTraceExporter';
+import { getDefaultOTELInstrumentations } from './instrumentations/getDefaultOTELInstrumentations';
+import { FaroMetaAttributesSpanProcessor } from './processors/faroMetaAttributesSpanProcessor';
+import { HttpRequestMonitorSpanProcessor } from './processors/httpRequestMonitorSpanProcessor';
+import { ATTR_APP_VERSION, ATTR_DEPLOYMENT_ENVIRONMENT_NAME, ATTR_DEVICE_BRAND, ATTR_DEVICE_LOCALE, ATTR_DEVICE_MODEL, ATTR_DEVICE_OS_VERSION, ATTR_DEVICE_PLATFORM, ATTR_PROCESS_RUNTIME_NAME, ATTR_PROCESS_RUNTIME_VERSION, ATTR_SERVICE_NAMESPACE, ATTR_TELEMETRY_DISTRO_NAME, ATTR_TELEMETRY_DISTRO_VERSION, } from './semconv';
+import { getSamplingDecision } from './utils/sampler';
+// Import React Native TracerProvider
+// Note: We use the base provider since React Native doesn't have a specific one
+/**
+ * TracingInstrumentation for React Native
+ *
+ * Enables distributed tracing with OpenTelemetry for React Native applications.
+ *
+ * IMPORTANT: Infinite loop prevention
+ * - Uses internalLogger for debugging instead of console
+ * - Collector URLs are added to ignoreUrls in HTTP instrumentation
+ * - BatchSpanProcessor delays span export to avoid blocking
+ * - No console logging during trace export
+ *
+ * Example usage:
+ * ```ts
+ * import { initializeFaro } from '@grafana/faro-react-native';
+ * import { TracingInstrumentation } from '@grafana/faro-react-native-tracing';
+ *
+ * initializeFaro({
+ *   // ... other config
+ *   instrumentations: [
+ *     new TracingInstrumentation({
+ *       propagateTraceHeaderCorsUrls: [/https:\\/\\/my-api\\.com/],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export class TracingInstrumentation extends BaseInstrumentation {
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        this.name = '@grafana/faro-react-native-tracing';
+        this.version = VERSION;
+    }
+    initialize() {
+        var _a, _b, _c, _d;
+        const options = this.options;
+        const attributes = {};
+        // App attributes
+        if (this.config.app.name) {
+            attributes[ATTR_SERVICE_NAME] = this.config.app.name;
+        }
+        if (this.config.app.namespace) {
+            attributes[ATTR_SERVICE_NAMESPACE] = this.config.app.namespace;
+        }
+        if (this.config.app.version) {
+            attributes[ATTR_SERVICE_VERSION] = this.config.app.version;
+            attributes[ATTR_APP_VERSION] = this.config.app.version;
+        }
+        if (this.config.app.environment) {
+            attributes[ATTR_DEPLOYMENT_ENVIRONMENT_NAME] = this.config.app.environment;
+            /**
+             * @deprecated will be removed in the future and has been replaced by ATTR_DEPLOYMENT_ENVIRONMENT_NAME (deployment.environment.name)
+             * We need to keep this for compatibility with some internal services for now.
+             */
+            attributes[SEMRESATTRS_DEPLOYMENT_ENVIRONMENT] = this.config.app.environment;
+        }
+        // Device/Platform attributes from React Native
+        // Note: metas.value contains all meta providers, we need to check if device meta exists
+        const allMetas = this.metas.value;
+        const deviceMeta = allMetas['device'];
+        if (deviceMeta === null || deviceMeta === void 0 ? void 0 : deviceMeta.model) {
+            attributes[ATTR_DEVICE_MODEL] = deviceMeta.model;
+        }
+        if (deviceMeta === null || deviceMeta === void 0 ? void 0 : deviceMeta.brand) {
+            attributes[ATTR_DEVICE_BRAND] = deviceMeta.brand;
+        }
+        if (deviceMeta === null || deviceMeta === void 0 ? void 0 : deviceMeta.osName) {
+            attributes[ATTR_DEVICE_PLATFORM] = deviceMeta.osName;
+        }
+        if (deviceMeta === null || deviceMeta === void 0 ? void 0 : deviceMeta.osVersion) {
+            attributes[ATTR_DEVICE_OS_VERSION] = deviceMeta.osVersion;
+        }
+        if (deviceMeta === null || deviceMeta === void 0 ? void 0 : deviceMeta.locale) {
+            attributes[ATTR_DEVICE_LOCALE] = deviceMeta.locale;
+        }
+        attributes[ATTR_PROCESS_RUNTIME_NAME] = 'react-native';
+        attributes[ATTR_PROCESS_RUNTIME_VERSION] = (_a = deviceMeta === null || deviceMeta === void 0 ? void 0 : deviceMeta.osVersion) !== null && _a !== void 0 ? _a : 'unknown';
+        attributes[ATTR_TELEMETRY_DISTRO_NAME] = 'faro-react-native-sdk';
+        attributes[ATTR_TELEMETRY_DISTRO_VERSION] = VERSION;
+        // Merge with user-provided attributes
+        Object.assign(attributes, options.resourceAttributes);
+        const resource = defaultResource().merge(resourceFromAttributes(attributes));
+        // Create tracer provider with span processors
+        this.provider = new ReactNativeTracerProvider({
+            resource,
+            sampler: {
+                shouldSample: () => {
+                    return {
+                        decision: getSamplingDecision(this.api.getSession()),
+                    };
+                },
+            },
+            spanProcessors: [
+                (_b = options.spanProcessor) !== null && _b !== void 0 ? _b : new HttpRequestMonitorSpanProcessor(new FaroMetaAttributesSpanProcessor(new BatchSpanProcessor(new FaroTraceExporter({ api: this.api }), {
+                    scheduledDelayMillis: TracingInstrumentation.SCHEDULED_BATCH_DELAY_MS,
+                    maxExportBatchSize: 30,
+                }), this.metas)),
+            ],
+        });
+        // Register the provider as the global tracer provider
+        // This is CRITICAL for the tracer to generate real trace IDs instead of all zeros
+        trace.setGlobalTracerProvider(this.provider);
+        const { propagateTraceHeaderCorsUrls, fetchInstrumentationOptions, xhrInstrumentationOptions } = (_c = this.options.instrumentationOptions) !== null && _c !== void 0 ? _c : {};
+        // Get ignore URLs from transports to prevent infinite loops
+        const ignoreUrls = this.getIgnoreUrls();
+        // Register instrumentations
+        registerInstrumentations({
+            instrumentations: (_d = options.instrumentations) !== null && _d !== void 0 ? _d : getDefaultOTELInstrumentations({
+                ignoreUrls,
+                propagateTraceHeaderCorsUrls,
+                fetchInstrumentationOptions,
+                xhrInstrumentationOptions,
+            }),
+        });
+        // Expose OTEL API on the global Faro instance for manual span creation
+        // This allows users to access trace and context APIs via faro.otel
+        const globalFaroInstance = getInternalFaroFromGlobalObject();
+        if (globalFaroInstance) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Extending Faro instance with OTEL API
+            globalFaroInstance.otel = {
+                trace,
+                context,
+            };
+        }
+    }
+    /**
+     * Get ignore URLs from all transports to avoid tracing collector requests
+     * CRITICAL: This prevents infinite loops where trace exports trigger more traces
+     */
+    getIgnoreUrls() {
+        // Get URLs from transports' getIgnoreUrls() method
+        const transportUrls = this.transports.transports.flatMap((transport) => {
+            return transport.getIgnoreUrls();
+        });
+        // Create regex patterns that match both with and without trailing slashes
+        // This is critical because fetch() might add trailing slashes
+        const regexPatterns = transportUrls.map((url) => {
+            if (typeof url === 'string') {
+                // Escape special regex characters and make trailing slash optional
+                const escapedUrl = url.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                return new RegExp(`^${escapedUrl}/?$`);
+            }
+            return url;
+        });
+        // Return both original URLs and regex patterns for maximum coverage
+        return [...transportUrls, ...regexPatterns];
+    }
+    /**
+     * Shutdown the tracer provider
+     */
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.provider) {
+                yield this.provider.shutdown();
+            }
+        });
+    }
+}
+TracingInstrumentation.SCHEDULED_BATCH_DELAY_MS = 1000;
+//# sourceMappingURL=instrumentation.js.map

package/dist/esm/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, trace } from '@opentelemetry/api';\nimport type { Attributes } from '@opentelemetry/api';\nimport { registerInstrumentations } from '@opentelemetry/instrumentation';\nimport { defaultResource, resourceFromAttributes } from '@opentelemetry/resources';\nimport { BatchSpanProcessor, BasicTracerProvider as ReactNativeTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport type { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport {\n  ATTR_SERVICE_NAME,\n  ATTR_SERVICE_VERSION,\n  SEMRESATTRS_DEPLOYMENT_ENVIRONMENT,\n} from '@opentelemetry/semantic-conventions';\n\nimport { BaseInstrumentation, getInternalFaroFromGlobalObject, VERSION } from '@grafana/faro-core';\nimport type { Transport } from '@grafana/faro-core';\n\nimport { FaroTraceExporter } from './exporters/faroTraceExporter';\nimport { getDefaultOTELInstrumentations } from './instrumentations/getDefaultOTELInstrumentations';\nimport { FaroMetaAttributesSpanProcessor } from './processors/faroMetaAttributesSpanProcessor';\nimport { HttpRequestMonitorSpanProcessor } from './processors/httpRequestMonitorSpanProcessor';\nimport {\n  ATTR_APP_VERSION,\n  ATTR_DEPLOYMENT_ENVIRONMENT_NAME,\n  ATTR_DEVICE_BRAND,\n  ATTR_DEVICE_LOCALE,\n  ATTR_DEVICE_MODEL,\n  ATTR_DEVICE_OS_VERSION,\n  ATTR_DEVICE_PLATFORM,\n  ATTR_PROCESS_RUNTIME_NAME,\n  ATTR_PROCESS_RUNTIME_VERSION,\n  ATTR_SERVICE_NAMESPACE,\n  ATTR_TELEMETRY_DISTRO_NAME,\n  ATTR_TELEMETRY_DISTRO_VERSION,\n} from './semconv';\nimport type { TracingInstrumentationOptions } from './types';\nimport { getSamplingDecision } from './utils/sampler';\n\n// Import React Native TracerProvider\n// Note: We use the base provider since React Native doesn't have a specific one\n\n/**\n * TracingInstrumentation for React Native\n *\n * Enables distributed tracing with OpenTelemetry for React Native applications.\n *\n * IMPORTANT: Infinite loop prevention\n * - Uses internalLogger for debugging instead of console\n * - Collector URLs are added to ignoreUrls in HTTP instrumentation\n * - BatchSpanProcessor delays span export to avoid blocking\n * - No console logging during trace export\n *\n * Example usage:\n * ```ts\n * import { initializeFaro } from '@grafana/faro-react-native';\n * import { TracingInstrumentation } from '@grafana/faro-react-native-tracing';\n *\n * initializeFaro({\n *   // ... other config\n *   instrumentations: [\n *     new TracingInstrumentation({\n *       propagateTraceHeaderCorsUrls: [/https:\\\\/\\\\/my-api\\\\.com/],\n *     }),\n *   ],\n * });\n * ```\n */\nexport class TracingInstrumentation extends BaseInstrumentation {\n  name = '@grafana/faro-react-native-tracing';\n  version = VERSION;\n\n  static SCHEDULED_BATCH_DELAY_MS = 1000;\n\n  private provider?: BasicTracerProvider;\n\n  constructor(private options: TracingInstrumentationOptions = {}) {\n    super();\n  }\n\n  initialize(): void {\n    const options = this.options;\n    const attributes: Attributes = {};\n\n    // App attributes\n    if (this.config.app.name) {\n      attributes[ATTR_SERVICE_NAME] = this.config.app.name;\n    }\n\n    if (this.config.app.namespace) {\n      attributes[ATTR_SERVICE_NAMESPACE] = this.config.app.namespace;\n    }\n\n    if (this.config.app.version) {\n      attributes[ATTR_SERVICE_VERSION] = this.config.app.version;\n      attributes[ATTR_APP_VERSION] = this.config.app.version;\n    }\n\n    if (this.config.app.environment) {\n      attributes[ATTR_DEPLOYMENT_ENVIRONMENT_NAME] = this.config.app.environment;\n\n      /**\n       * @deprecated will be removed in the future and has been replaced by ATTR_DEPLOYMENT_ENVIRONMENT_NAME (deployment.environment.name)\n       * We need to keep this for compatibility with some internal services for now.\n       */\n      attributes[SEMRESATTRS_DEPLOYMENT_ENVIRONMENT] = this.config.app.environment;\n    }\n\n    // Device/Platform attributes from React Native\n    // Note: metas.value contains all meta providers, we need to check if device meta exists\n    const allMetas = this.metas.value as Record<string, unknown>;\n    const deviceMeta = allMetas['device'] as\n      | {\n          model?: string;\n          brand?: string;\n          osName?: string;\n          osVersion?: string;\n          locale?: string;\n        }\n      | undefined;\n\n    if (deviceMeta?.model) {\n      attributes[ATTR_DEVICE_MODEL] = deviceMeta.model;\n    }\n\n    if (deviceMeta?.brand) {\n      attributes[ATTR_DEVICE_BRAND] = deviceMeta.brand;\n    }\n\n    if (deviceMeta?.osName) {\n      attributes[ATTR_DEVICE_PLATFORM] = deviceMeta.osName;\n    }\n\n    if (deviceMeta?.osVersion) {\n      attributes[ATTR_DEVICE_OS_VERSION] = deviceMeta.osVersion;\n    }\n\n    if (deviceMeta?.locale) {\n      attributes[ATTR_DEVICE_LOCALE] = deviceMeta.locale;\n    }\n\n    attributes[ATTR_PROCESS_RUNTIME_NAME] = 'react-native';\n    attributes[ATTR_PROCESS_RUNTIME_VERSION] = deviceMeta?.osVersion ?? 'unknown';\n\n    attributes[ATTR_TELEMETRY_DISTRO_NAME] = 'faro-react-native-sdk';\n    attributes[ATTR_TELEMETRY_DISTRO_VERSION] = VERSION;\n\n    // Merge with user-provided attributes\n    Object.assign(attributes, options.resourceAttributes);\n\n    const resource = defaultResource().merge(resourceFromAttributes(attributes));\n\n    // Create tracer provider with span processors\n    this.provider = new ReactNativeTracerProvider({\n      resource,\n      sampler: {\n        shouldSample: () => {\n          return {\n            decision: getSamplingDecision(this.api.getSession()),\n          };\n        },\n      },\n      spanProcessors: [\n        options.spanProcessor ??\n          new HttpRequestMonitorSpanProcessor(\n            new FaroMetaAttributesSpanProcessor(\n              new BatchSpanProcessor(new FaroTraceExporter({ api: this.api }), {\n                scheduledDelayMillis: TracingInstrumentation.SCHEDULED_BATCH_DELAY_MS,\n                maxExportBatchSize: 30,\n              }),\n              this.metas\n            )\n          ),\n      ],\n    });\n\n    // Register the provider as the global tracer provider\n    // This is CRITICAL for the tracer to generate real trace IDs instead of all zeros\n    trace.setGlobalTracerProvider(this.provider);\n\n    const { propagateTraceHeaderCorsUrls, fetchInstrumentationOptions, xhrInstrumentationOptions } =\n      this.options.instrumentationOptions ?? {};\n\n    // Get ignore URLs from transports to prevent infinite loops\n    const ignoreUrls = this.getIgnoreUrls();\n\n    // Register instrumentations\n    registerInstrumentations({\n      instrumentations:\n        options.instrumentations ??\n        getDefaultOTELInstrumentations({\n          ignoreUrls,\n          propagateTraceHeaderCorsUrls,\n          fetchInstrumentationOptions,\n          xhrInstrumentationOptions,\n        }),\n    });\n\n    // Expose OTEL API on the global Faro instance for manual span creation\n    // This allows users to access trace and context APIs via faro.otel\n    const globalFaroInstance = getInternalFaroFromGlobalObject();\n    if (globalFaroInstance) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Extending Faro instance with OTEL API\n      (globalFaroInstance as any).otel = {\n        trace,\n        context,\n      };\n    }\n  }\n\n  /**\n   * Get ignore URLs from all transports to avoid tracing collector requests\n   * CRITICAL: This prevents infinite loops where trace exports trigger more traces\n   */\n  private getIgnoreUrls(): Array<string | RegExp> {\n    // Get URLs from transports' getIgnoreUrls() method\n    const transportUrls = this.transports.transports.flatMap((transport: Transport) => {\n      return transport.getIgnoreUrls();\n    });\n\n    // Create regex patterns that match both with and without trailing slashes\n    // This is critical because fetch() might add trailing slashes\n    const regexPatterns = transportUrls.map((url) => {\n      if (typeof url === 'string') {\n        // Escape special regex characters and make trailing slash optional\n        const escapedUrl = url.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        return new RegExp(`^${escapedUrl}/?$`);\n      }\n      return url;\n    });\n\n    // Return both original URLs and regex patterns for maximum coverage\n    return [...transportUrls, ...regexPatterns];\n  }\n\n  /**\n   * Shutdown the tracer provider\n   */\n  async shutdown(): Promise<void> {\n    if (this.provider) {\n      await this.provider.shutdown();\n    }\n  }\n}\n"]}

package/dist/esm/instrumentations/getDefaultOTELInstrumentations.js

@@ -0,0 +1,62 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { FetchInstrumentation } from '@opentelemetry/instrumentation-fetch';
+import { XMLHttpRequestInstrumentation } from '@opentelemetry/instrumentation-xml-http-request';
+import { faro, UserActionState } from '@grafana/faro-core';
+import { fetchCustomAttributeFunctionWithDefaults, xhrCustomAttributeFunctionWithDefaults, } from './instrumentationUtils';
+/**
+ * Get default OTEL instrumentations for React Native
+ *
+ * This function creates the default OpenTelemetry instrumentations for React Native:
+ * - FetchInstrumentation: Traces fetch() API calls
+ * - XMLHttpRequestInstrumentation: Traces XMLHttpRequest and axios (which uses XHR)
+ *
+ * IMPORTANT: Infinite loop prevention
+ * - ignoreUrls is used to exclude Faro collector URLs
+ * - ignoreNetworkEvents is true to avoid duplicate events
+ * - No console logging during instrumentation
+ *
+ * @param options - Configuration options
+ * @returns Array of OTEL instrumentations
+ */
+export function getDefaultOTELInstrumentations(options = {}) {
+    const { fetchInstrumentationOptions, xhrInstrumentationOptions } = options, sharedOptions = __rest(options, ["fetchInstrumentationOptions", "xhrInstrumentationOptions"]);
+    const fetchOpts = createFetchInstrumentationOptions(fetchInstrumentationOptions, sharedOptions);
+    const xhrOpts = createXhrInstrumentationOptions(xhrInstrumentationOptions, sharedOptions);
+    return [new FetchInstrumentation(fetchOpts), new XMLHttpRequestInstrumentation(xhrOpts)];
+}
+function createFetchInstrumentationOptions(fetchInstrumentationOptions, sharedOptions) {
+    return Object.assign(Object.assign(Object.assign(Object.assign({}, sharedOptions), { 
+        // Ignore network performance events to avoid duplicates
+        ignoreNetworkEvents: true }), fetchInstrumentationOptions), { 
+        // Always keep this function
+        applyCustomAttributesOnSpan: fetchCustomAttributeFunctionWithDefaults(fetchInstrumentationOptions === null || fetchInstrumentationOptions === void 0 ? void 0 : fetchInstrumentationOptions.applyCustomAttributesOnSpan), 
+        // Request hook to add user action context
+        requestHook: (span, _) => {
+            try {
+                const currentAction = faro.api.getActiveUserAction();
+                if (currentAction &&
+                    (currentAction === null || currentAction === void 0 ? void 0 : currentAction.getState()) === UserActionState.Started) {
+                    span.setAttribute('faro.action.user.name', currentAction.name);
+                    span.setAttribute('faro.action.user.parentId', currentAction.parentId);
+                }
+            }
+            catch (_error) {
+                // Silently fail - don't log to avoid infinite loops
+                // The span will just not have user action context
+            }
+        } });
+}
+function createXhrInstrumentationOptions(xhrInstrumentationOptions, sharedOptions) {
+    return Object.assign(Object.assign(Object.assign(Object.assign({}, sharedOptions), { ignoreNetworkEvents: true }), xhrInstrumentationOptions), { applyCustomAttributesOnSpan: xhrCustomAttributeFunctionWithDefaults(xhrInstrumentationOptions === null || xhrInstrumentationOptions === void 0 ? void 0 : xhrInstrumentationOptions.applyCustomAttributesOnSpan) });
+}
+//# sourceMappingURL=getDefaultOTELInstrumentations.js.map

package/dist/esm/instrumentations/getDefaultOTELInstrumentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultOTELInstrumentations.js","sourceRoot":"","sources":["../../../src/instrumentations/getDefaultOTELInstrumentations.ts"],"names":[],"mappings":";;;;;;;;;;;AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAEhG,OAAO,EAAE,IAAI,EAAoC,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI7F,OAAO,EACL,wCAAwC,EACxC,sCAAsC,GACvC,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAA0C,EAAE;IACzF,MAAM,EAAE,2BAA2B,EAAE,yBAAyB,KAAuB,OAAO,EAAzB,aAAa,UAAK,OAAO,EAAtF,4DAA4E,CAAU,CAAC;IAE7F,MAAM,SAAS,GAAG,iCAAiC,CAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,+BAA+B,CAAC,yBAAyB,EAAE,aAAa,CAAC,CAAC;IAE1F,OAAO,CAAC,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,IAAI,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,iCAAiC,CACxC,2BAA0F,EAC1F,aAAsC;IAEtC,mEACK,aAAa;QAChB,wDAAwD;QACxD,mBAAmB,EAAE,IAAI,KAEtB,2BAA2B;QAC9B,4BAA4B;QAC5B,2BAA2B,EAAE,wCAAwC,CACnE,2BAA2B,aAA3B,2BAA2B,uBAA3B,2BAA2B,CAAE,2BAA2B,CACzD;QACD,0CAA0C;QAC1C,WAAW,EAAE,CAAC,IAAU,EAAE,CAAwB,EAAE,EAAE;YACpD,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;gBACrD,IACE,aAAa;oBACb,CAAC,aAAwD,aAAxD,aAAa,uBAAb,aAAa,CAA6C,QAAQ,EAAE,MAAK,eAAe,CAAC,OAAO,EACjG,CAAC;oBACD,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;oBAC/D,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,oDAAoD;gBACpD,kDAAkD;YACpD,CAAC;QACH,CAAC,IACD;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,yBAAsF,EACtF,aAAsC;IAEtC,mEACK,aAAa,KAChB,mBAAmB,EAAE,IAAI,KACtB,yBAAyB,KAC5B,2BAA2B,EAAE,sCAAsC,CACjE,yBAAyB,aAAzB,yBAAyB,uBAAzB,yBAAyB,CAAE,2BAA2B,CACvD,IACD;AACJ,CAAC","sourcesContent":["import type { Span } from '@opentelemetry/api';\nimport { FetchInstrumentation } from '@opentelemetry/instrumentation-fetch';\nimport { XMLHttpRequestInstrumentation } from '@opentelemetry/instrumentation-xml-http-request';\n\nimport { faro, type UserActionInternalInterface, UserActionState } from '@grafana/faro-core';\n\nimport type { DefaultInstrumentationsOptions, InstrumentationOption } from '../types';\n\nimport {\n  fetchCustomAttributeFunctionWithDefaults,\n  xhrCustomAttributeFunctionWithDefaults,\n} from './instrumentationUtils';\n\n/**\n * Get default OTEL instrumentations for React Native\n *\n * This function creates the default OpenTelemetry instrumentations for React Native:\n * - FetchInstrumentation: Traces fetch() API calls\n * - XMLHttpRequestInstrumentation: Traces XMLHttpRequest and axios (which uses XHR)\n *\n * IMPORTANT: Infinite loop prevention\n * - ignoreUrls is used to exclude Faro collector URLs\n * - ignoreNetworkEvents is true to avoid duplicate events\n * - No console logging during instrumentation\n *\n * @param options - Configuration options\n * @returns Array of OTEL instrumentations\n */\nexport function getDefaultOTELInstrumentations(options: DefaultInstrumentationsOptions = {}): InstrumentationOption[] {\n  const { fetchInstrumentationOptions, xhrInstrumentationOptions, ...sharedOptions } = options;\n\n  const fetchOpts = createFetchInstrumentationOptions(fetchInstrumentationOptions, sharedOptions);\n  const xhrOpts = createXhrInstrumentationOptions(xhrInstrumentationOptions, sharedOptions);\n\n  return [new FetchInstrumentation(fetchOpts), new XMLHttpRequestInstrumentation(xhrOpts)];\n}\n\nfunction createFetchInstrumentationOptions(\n  fetchInstrumentationOptions: DefaultInstrumentationsOptions['fetchInstrumentationOptions'],\n  sharedOptions: Record<string, unknown>\n) {\n  return {\n    ...sharedOptions,\n    // Ignore network performance events to avoid duplicates\n    ignoreNetworkEvents: true,\n    // Keep this here to overwrite the defaults above if provided by the users\n    ...fetchInstrumentationOptions,\n    // Always keep this function\n    applyCustomAttributesOnSpan: fetchCustomAttributeFunctionWithDefaults(\n      fetchInstrumentationOptions?.applyCustomAttributesOnSpan\n    ),\n    // Request hook to add user action context\n    requestHook: (span: Span, _: Request | RequestInit) => {\n      try {\n        const currentAction = faro.api.getActiveUserAction();\n        if (\n          currentAction &&\n          (currentAction as unknown as UserActionInternalInterface)?.getState() === UserActionState.Started\n        ) {\n          span.setAttribute('faro.action.user.name', currentAction.name);\n          span.setAttribute('faro.action.user.parentId', currentAction.parentId);\n        }\n      } catch (_error) {\n        // Silently fail - don't log to avoid infinite loops\n        // The span will just not have user action context\n      }\n    },\n  };\n}\n\nfunction createXhrInstrumentationOptions(\n  xhrInstrumentationOptions: DefaultInstrumentationsOptions['xhrInstrumentationOptions'],\n  sharedOptions: Record<string, unknown>\n) {\n  return {\n    ...sharedOptions,\n    ignoreNetworkEvents: true,\n    ...xhrInstrumentationOptions,\n    applyCustomAttributesOnSpan: xhrCustomAttributeFunctionWithDefaults(\n      xhrInstrumentationOptions?.applyCustomAttributesOnSpan\n    ),\n  };\n}\n"]}

package/dist/esm/instrumentations/instrumentationUtils.js

@@ -0,0 +1,83 @@
+import { SpanStatusCode } from '@opentelemetry/api';
+import { faro, UserActionState } from '@grafana/faro-core';
+/**
+ * Set span status to ERROR when fetch fails
+ *
+ * This ensures that failed HTTP requests are marked as errors in traces.
+ */
+export function setSpanStatusOnFetchError(span, error) {
+    const message = typeof error === 'string' ? error : error.message;
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message,
+    });
+}
+/**
+ * Type guard to check if result is a FetchError
+ */
+function isFetchError(result) {
+    return 'message' in result && typeof result.message === 'string';
+}
+/**
+ * Custom attribute function for fetch instrumentation with defaults
+ *
+ * Combines user-provided custom attributes with default handling.
+ *
+ * @param userFunction - Optional user-provided custom attribute function
+ * @returns Combined custom attribute function
+ */
+export function fetchCustomAttributeFunctionWithDefaults(userFunction) {
+    const fn = (span, request, result) => {
+        // Call user function first if provided
+        if (userFunction) {
+            userFunction(span, request, result);
+        }
+        // Add default error handling
+        if (isFetchError(result)) {
+            setSpanStatusOnFetchError(span, result.message);
+        }
+        else if (result instanceof Response && result.status >= 400 && result.status < 600) {
+            setSpanStatusOnFetchError(span, `HTTP ${result.status}: ${result.statusText}`);
+        }
+    };
+    return fn;
+}
+/**
+ * Set span status to ERROR for XHR failures (status 0 or 4xx/5xx).
+ */
+export function setSpanStatusOnXMLHttpRequestError(span, xhr) {
+    const status = xhr.status;
+    if (status == null)
+        return;
+    if (status === 0 || (status >= 400 && status < 600)) {
+        span.setStatus({ code: SpanStatusCode.ERROR });
+    }
+}
+/**
+ * Add user action context to span when active (for HTTP Errors column in user action table).
+ */
+function addUserActionContextToSpan(span) {
+    var _a, _b, _c;
+    try {
+        const currentAction = (_b = (_a = faro.api) === null || _a === void 0 ? void 0 : _a.getActiveUserAction) === null || _b === void 0 ? void 0 : _b.call(_a);
+        const state = (_c = currentAction === null || currentAction === void 0 ? void 0 : currentAction.getState) === null || _c === void 0 ? void 0 : _c.call(currentAction);
+        if (currentAction && (state === UserActionState.Started || state === UserActionState.Halted)) {
+            span.setAttribute('faro.action.user.name', currentAction.name);
+            span.setAttribute('faro.action.user.parentId', currentAction.parentId);
+        }
+    }
+    catch (_) {
+        // Silently fail - don't log to avoid instrumentation loops
+    }
+}
+/**
+ * Custom attribute function for XHR instrumentation with defaults.
+ */
+export function xhrCustomAttributeFunctionWithDefaults(userFunction) {
+    return (span, xhr) => {
+        setSpanStatusOnXMLHttpRequestError(span, xhr);
+        addUserActionContextToSpan(span);
+        userFunction === null || userFunction === void 0 ? void 0 : userFunction(span, xhr);
+    };
+}
+//# sourceMappingURL=instrumentationUtils.js.map

package/dist/esm/instrumentations/instrumentationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentationUtils.js","sourceRoot":"","sources":["../../../src/instrumentations/instrumentationUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { SpanStatusCode } from '@opentelemetry/api';\nimport type { Span } from '@opentelemetry/api';\nimport type { FetchCustomAttributeFunction } from '@opentelemetry/instrumentation-fetch';\nimport type { XHRCustomAttributeFunction } from '@opentelemetry/instrumentation-xml-http-request';\n\nimport { faro, type UserActionInternalInterface, UserActionState } from '@grafana/faro-core';\n\n/**\n * FetchError interface matching OpenTelemetry's internal type\n * Note: FetchError is not exported from @opentelemetry/instrumentation-fetch\n */\ninterface FetchError {\n  status?: number;\n  message: string;\n}\n\n/**\n * Set span status to ERROR when fetch fails\n *\n * This ensures that failed HTTP requests are marked as errors in traces.\n */\nexport function setSpanStatusOnFetchError(span: Span, error: Error | string): void {\n  const message = typeof error === 'string' ? error : error.message;\n  span.setStatus({\n    code: SpanStatusCode.ERROR,\n    message,\n  });\n}\n\n/**\n * Type guard to check if result is a FetchError\n */\nfunction isFetchError(result: Response | FetchError): result is FetchError {\n  return 'message' in result && typeof (result as FetchError).message === 'string';\n}\n\n/**\n * Custom attribute function for fetch instrumentation with defaults\n *\n * Combines user-provided custom attributes with default handling.\n *\n * @param userFunction - Optional user-provided custom attribute function\n * @returns Combined custom attribute function\n */\nexport function fetchCustomAttributeFunctionWithDefaults(\n  userFunction?: FetchCustomAttributeFunction\n): FetchCustomAttributeFunction {\n  const fn: FetchCustomAttributeFunction = (\n    span: Span,\n    request: Request | RequestInit,\n    result: Response | FetchError\n  ) => {\n    // Call user function first if provided\n    if (userFunction) {\n      userFunction(span, request, result);\n    }\n\n    // Add default error handling\n    if (isFetchError(result)) {\n      setSpanStatusOnFetchError(span, result.message);\n    } else if (result instanceof Response && result.status >= 400 && result.status < 600) {\n      setSpanStatusOnFetchError(span, `HTTP ${result.status}: ${result.statusText}`);\n    }\n  };\n  return fn;\n}\n\n/**\n * Set span status to ERROR for XHR failures (status 0 or 4xx/5xx).\n */\nexport function setSpanStatusOnXMLHttpRequestError(span: Span, xhr: XMLHttpRequest): void {\n  const status = xhr.status;\n  if (status == null) return;\n  if (status === 0 || (status >= 400 && status < 600)) {\n    span.setStatus({ code: SpanStatusCode.ERROR });\n  }\n}\n\n/**\n * Add user action context to span when active (for HTTP Errors column in user action table).\n */\nfunction addUserActionContextToSpan(span: Span): void {\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      span.setAttribute('faro.action.user.name', currentAction.name);\n      span.setAttribute('faro.action.user.parentId', currentAction.parentId);\n    }\n  } catch (_) {\n    // Silently fail - don't log to avoid instrumentation loops\n  }\n}\n\n/**\n * Custom attribute function for XHR instrumentation with defaults.\n */\nexport function xhrCustomAttributeFunctionWithDefaults(\n  userFunction?: XHRCustomAttributeFunction\n): XHRCustomAttributeFunction {\n  return (span: Span, xhr: XMLHttpRequest) => {\n    setSpanStatusOnXMLHttpRequestError(span, xhr);\n    addUserActionContextToSpan(span);\n    userFunction?.(span, xhr);\n  };\n}\n"]}

package/dist/esm/processors/faroMetaAttributesSpanProcessor.js

@@ -0,0 +1,54 @@
+import { ATTR_SESSION_ID } from '../semconv';
+/**
+ * Span processor that adds Faro meta attributes to spans
+ *
+ * This processor enriches spans with:
+ * - Session ID
+ * - User information (email, id, username, etc.)
+ *
+ * IMPORTANT: This processor delegates to a wrapped processor and does NOT log
+ * to avoid infinite loops.
+ */
+export class FaroMetaAttributesSpanProcessor {
+    constructor(processor, metas) {
+        this.processor = processor;
+        this.metas = metas;
+    }
+    forceFlush() {
+        return this.processor.forceFlush();
+    }
+    onStart(span, parentContext) {
+        var _a;
+        const session = this.metas.value.session;
+        if (session === null || session === void 0 ? void 0 : session.id) {
+            span.attributes[ATTR_SESSION_ID] = session.id;
+        }
+        const user = (_a = this.metas.value.user) !== null && _a !== void 0 ? _a : {};
+        if (user.email) {
+            span.attributes['user.email'] = user.email;
+        }
+        if (user.id) {
+            span.attributes['user.id'] = user.id;
+        }
+        if (user.username) {
+            span.attributes['user.name'] = user.username;
+        }
+        if (user.fullName) {
+            span.attributes['user.full_name'] = user.fullName;
+        }
+        if (user.roles) {
+            span.attributes['user.roles'] = user.roles.split(',').map((role) => role.trim());
+        }
+        if (user.hash) {
+            span.attributes['user.hash'] = user.hash;
+        }
+        this.processor.onStart(span, parentContext);
+    }
+    onEnd(span) {
+        this.processor.onEnd(span);
+    }
+    shutdown() {
+        return this.processor.shutdown();
+    }
+}
+//# sourceMappingURL=faroMetaAttributesSpanProcessor.js.map

package/dist/esm/processors/faroMetaAttributesSpanProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faroMetaAttributesSpanProcessor.js","sourceRoot":"","sources":["../../../src/processors/faroMetaAttributesSpanProcessor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,OAAO,+BAA+B;IAC1C,YACU,SAAwB,EACxB,KAAY;QADZ,cAAS,GAAT,SAAS,CAAe;QACxB,UAAK,GAAL,KAAK,CAAO;IACnB,CAAC;IAEJ,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,IAAU,EAAE,aAAsB;;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QAEzC,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,EAAE,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,mCAAI,EAAE,CAAC;QAEzC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,CAAC;QAED,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/C,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAkB;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;CACF","sourcesContent":["import type { Context } from '@opentelemetry/api';\nimport type { ReadableSpan, Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';\n\nimport type { Metas } from '@grafana/faro-core';\n\nimport { ATTR_SESSION_ID } from '../semconv';\n\n/**\n * Span processor that adds Faro meta attributes to spans\n *\n * This processor enriches spans with:\n * - Session ID\n * - User information (email, id, username, etc.)\n *\n * IMPORTANT: This processor delegates to a wrapped processor and does NOT log\n * to avoid infinite loops.\n */\nexport class FaroMetaAttributesSpanProcessor implements SpanProcessor {\n  constructor(\n    private processor: SpanProcessor,\n    private metas: Metas\n  ) {}\n\n  forceFlush(): Promise<void> {\n    return this.processor.forceFlush();\n  }\n\n  onStart(span: Span, parentContext: Context): void {\n    const session = this.metas.value.session;\n\n    if (session?.id) {\n      span.attributes[ATTR_SESSION_ID] = session.id;\n    }\n\n    const user = this.metas.value.user ?? {};\n\n    if (user.email) {\n      span.attributes['user.email'] = user.email;\n    }\n\n    if (user.id) {\n      span.attributes['user.id'] = user.id;\n    }\n\n    if (user.username) {\n      span.attributes['user.name'] = user.username;\n    }\n\n    if (user.fullName) {\n      span.attributes['user.full_name'] = user.fullName;\n    }\n\n    if (user.roles) {\n      span.attributes['user.roles'] = user.roles.split(',').map((role) => role.trim());\n    }\n\n    if (user.hash) {\n      span.attributes['user.hash'] = user.hash;\n    }\n\n    this.processor.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    this.processor.onEnd(span);\n  }\n\n  shutdown(): Promise<void> {\n    return this.processor.shutdown();\n  }\n}\n"]}

package/dist/esm/processors/httpRequestMonitorSpanProcessor.js

@@ -0,0 +1,93 @@
+import { notifyHttpRequestEnd, notifyHttpRequestStart, } from '@grafana/faro-react-native';
+const ATTR_HTTP_METHOD = 'http.method';
+const ATTR_HTTP_STATUS_CODE = 'http.status_code';
+const ATTR_HTTP_URL = 'http.url';
+/**
+ * Get string attribute from span.
+ * Handles both SDK attribute format and OTLP-style attribute values.
+ */
+function getAttr(span, key) {
+    var _a;
+    const attrs = span.attributes;
+    if (attrs == null)
+        return undefined;
+    const raw = typeof attrs['get'] === 'function' ? attrs['get'](key) : attrs[key];
+    if (raw == null)
+        return undefined;
+    if (typeof raw === 'string')
+        return raw.length > 0 ? raw : undefined;
+    if (typeof raw === 'object' && raw !== null && 'stringValue' in raw) {
+        const s = String((_a = raw.stringValue) !== null && _a !== void 0 ? _a : '');
+        return s.length > 0 ? s : undefined;
+    }
+    const str = String(raw);
+    return str.length > 0 ? str : undefined;
+}
+/**
+ * Check if a span is an HTTP span (from FetchInstrumentation).
+ */
+function isHttpSpan(span) {
+    return getAttr(span, ATTR_HTTP_URL) != null || getAttr(span, ATTR_HTTP_METHOD) != null;
+}
+/**
+ * SpanProcessor that notifies httpRequestMonitor when HTTP spans start and end.
+ *
+ * This enables user action correlation (UserActionController halt logic) when
+ * TracingInstrumentation is used instead of HttpInstrumentation.
+ *
+ * IMPORTANT: Must not use console or trigger any instrumentation to avoid loops.
+ */
+export class HttpRequestMonitorSpanProcessor {
+    constructor(processor) {
+        this.processor = processor;
+    }
+    onStart(span, parentContext) {
+        var _a, _b;
+        if (isHttpSpan(span)) {
+            const url = (_a = getAttr(span, ATTR_HTTP_URL)) !== null && _a !== void 0 ? _a : '';
+            const method = (_b = getAttr(span, ATTR_HTTP_METHOD)) !== null && _b !== void 0 ? _b : 'GET';
+            const requestId = span.spanContext().spanId;
+            const startTimeMs = Date.now();
+            const payload = {
+                requestId,
+                url,
+                method,
+                startTime: startTimeMs,
+            };
+            notifyHttpRequestStart(payload);
+        }
+        this.processor.onStart(span, parentContext);
+    }
+    onEnd(span) {
+        var _a, _b;
+        if (isHttpSpan(span)) {
+            const url = (_a = getAttr(span, ATTR_HTTP_URL)) !== null && _a !== void 0 ? _a : '';
+            const method = (_b = getAttr(span, ATTR_HTTP_METHOD)) !== null && _b !== void 0 ? _b : 'GET';
+            const requestId = span.spanContext().spanId;
+            const statusAttr = getAttr(span, ATTR_HTTP_STATUS_CODE);
+            const status = statusAttr != null ? parseInt(statusAttr, 10) : undefined;
+            const spanWithTime = span;
+            const startNs = spanWithTime.startTimeUnixNano;
+            const endNs = spanWithTime.endTimeUnixNano;
+            const startTimeMs = startNs != null && !Number.isNaN(Number(startNs)) ? Number(startNs) / 1000000 : Date.now();
+            const endTimeMs = endNs != null && !Number.isNaN(Number(endNs)) ? Number(endNs) / 1000000 : Date.now();
+            const payload = {
+                requestId,
+                url,
+                method,
+                startTime: startTimeMs,
+                endTime: endTimeMs,
+                status: !Number.isNaN(status) ? status : undefined,
+            };
+            notifyHttpRequestEnd(payload);
+        }
+        this.processor.onEnd(span);
+    }
+    forceFlush() {
+        return this.processor.forceFlush();
+    }
+    shutdown() {
+        return this.processor.shutdown();
+    }
+}
+//# sourceMappingURL=httpRequestMonitorSpanProcessor.js.map

package/dist/esm/processors/httpRequestMonitorSpanProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpRequestMonitorSpanProcessor.js","sourceRoot":"","sources":["../../../src/processors/httpRequestMonitorSpanProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Context } from '@opentelemetry/api';\nimport type { ReadableSpan, Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';\n\nimport {\n  type HttpRequestMessagePayload,\n  notifyHttpRequestEnd,\n  notifyHttpRequestStart,\n} from '@grafana/faro-react-native';\n\nconst ATTR_HTTP_METHOD = 'http.method';\nconst ATTR_HTTP_STATUS_CODE = 'http.status_code';\nconst ATTR_HTTP_URL = 'http.url';\n\n/**\n * Get string attribute from span.\n * Handles both SDK attribute format and OTLP-style attribute values.\n */\nfunction getAttr(span: Span | ReadableSpan, key: string): string | undefined {\n  const attrs = span.attributes as Record<string, unknown> | undefined;\n  if (attrs == null) return undefined;\n  const raw = typeof attrs['get'] === 'function' ? (attrs as { get: (k: string) => unknown })['get'](key) : attrs[key];\n  if (raw == null) return undefined;\n  if (typeof raw === 'string') return raw.length > 0 ? raw : undefined;\n  if (typeof raw === 'object' && raw !== null && 'stringValue' in raw) {\n    const s = String((raw as { stringValue?: string }).stringValue ?? '');\n    return s.length > 0 ? s : undefined;\n  }\n  const str = String(raw);\n  return str.length > 0 ? str : undefined;\n}\n\n/**\n * Check if a span is an HTTP span (from FetchInstrumentation).\n */\nfunction isHttpSpan(span: Span | ReadableSpan): boolean {\n  return getAttr(span, ATTR_HTTP_URL) != null || getAttr(span, ATTR_HTTP_METHOD) != null;\n}\n\n/**\n * SpanProcessor that notifies httpRequestMonitor when HTTP spans start and end.\n *\n * This enables user action correlation (UserActionController halt logic) when\n * TracingInstrumentation is used instead of HttpInstrumentation.\n *\n * IMPORTANT: Must not use console or trigger any instrumentation to avoid loops.\n */\nexport class HttpRequestMonitorSpanProcessor implements SpanProcessor {\n  constructor(private readonly processor: SpanProcessor) {}\n\n  onStart(span: Span, parentContext: Context): void {\n    if (isHttpSpan(span)) {\n      const url = getAttr(span, ATTR_HTTP_URL) ?? '';\n      const method = getAttr(span, ATTR_HTTP_METHOD) ?? 'GET';\n      const requestId = span.spanContext().spanId;\n      const startTimeMs = Date.now();\n\n      const payload: HttpRequestMessagePayload = {\n        requestId,\n        url,\n        method,\n        startTime: startTimeMs,\n      };\n      notifyHttpRequestStart(payload);\n    }\n\n    this.processor.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    if (isHttpSpan(span)) {\n      const url = getAttr(span, ATTR_HTTP_URL) ?? '';\n      const method = getAttr(span, ATTR_HTTP_METHOD) ?? 'GET';\n      const requestId = span.spanContext().spanId;\n      const statusAttr = getAttr(span, ATTR_HTTP_STATUS_CODE);\n      const status = statusAttr != null ? parseInt(statusAttr, 10) : undefined;\n      const spanWithTime = span as ReadableSpan & {\n        startTimeUnixNano?: number | bigint;\n        endTimeUnixNano?: number | bigint;\n      };\n      const startNs = spanWithTime.startTimeUnixNano;\n      const endNs = spanWithTime.endTimeUnixNano;\n      const startTimeMs = startNs != null && !Number.isNaN(Number(startNs)) ? Number(startNs) / 1_000_000 : Date.now();\n      const endTimeMs = endNs != null && !Number.isNaN(Number(endNs)) ? Number(endNs) / 1_000_000 : Date.now();\n\n      const payload: HttpRequestMessagePayload = {\n        requestId,\n        url,\n        method,\n        startTime: startTimeMs,\n        endTime: endTimeMs,\n        status: !Number.isNaN(status) ? status : undefined,\n      };\n      notifyHttpRequestEnd(payload);\n    }\n\n    this.processor.onEnd(span);\n  }\n\n  forceFlush(): Promise<void> {\n    return this.processor.forceFlush();\n  }\n\n  shutdown(): Promise<void> {\n    return this.processor.shutdown();\n  }\n}\n"]}

package/dist/esm/semconv.js

@@ -0,0 +1,26 @@
+/**
+ * Semantic convention attributes for React Native tracing
+ * Based on OpenTelemetry semantic conventions with React Native-specific additions
+ */
+// Session attributes
+export const ATTR_SESSION_ID = 'session.id';
+// Device/Platform attributes for React Native
+export const ATTR_DEVICE_MODEL = 'device.model';
+export const ATTR_DEVICE_BRAND = 'device.brand';
+export const ATTR_DEVICE_PLATFORM = 'device.platform';
+export const ATTR_DEVICE_OS_VERSION = 'device.os.version';
+export const ATTR_DEVICE_TYPE = 'device.type';
+export const ATTR_DEVICE_LOCALE = 'device.locale';
+// App attributes
+export const ATTR_APP_VERSION = 'app.version';
+export const ATTR_APP_BUILD = 'app.build';
+// Service attributes
+export const ATTR_SERVICE_NAMESPACE = 'service.namespace';
+export const ATTR_DEPLOYMENT_ENVIRONMENT_NAME = 'deployment.environment.name';
+// Telemetry attributes
+export const ATTR_TELEMETRY_DISTRO_NAME = 'telemetry.distro.name';
+export const ATTR_TELEMETRY_DISTRO_VERSION = 'telemetry.distro.version';
+// Process/Runtime attributes
+export const ATTR_PROCESS_RUNTIME_NAME = 'process.runtime.name';
+export const ATTR_PROCESS_RUNTIME_VERSION = 'process.runtime.version';
+//# sourceMappingURL=semconv.js.map

package/dist/esm/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","sourceRoot":"","sources":["../../src/semconv.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAqB;AACrB,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,iBAAiB;AACjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C,qBAAqB;AACrB,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,gCAAgC,GAAG,6BAA6B,CAAC;AAE9E,uBAAuB;AACvB,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAClE,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAExE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC","sourcesContent":["/**\n * Semantic convention attributes for React Native tracing\n * Based on OpenTelemetry semantic conventions with React Native-specific additions\n */\n\n// Session attributes\nexport const ATTR_SESSION_ID = 'session.id';\n\n// Device/Platform attributes for React Native\nexport const ATTR_DEVICE_MODEL = 'device.model';\nexport const ATTR_DEVICE_BRAND = 'device.brand';\nexport const ATTR_DEVICE_PLATFORM = 'device.platform';\nexport const ATTR_DEVICE_OS_VERSION = 'device.os.version';\nexport const ATTR_DEVICE_TYPE = 'device.type';\nexport const ATTR_DEVICE_LOCALE = 'device.locale';\n\n// App attributes\nexport const ATTR_APP_VERSION = 'app.version';\nexport const ATTR_APP_BUILD = 'app.build';\n\n// Service attributes\nexport const ATTR_SERVICE_NAMESPACE = 'service.namespace';\nexport const ATTR_DEPLOYMENT_ENVIRONMENT_NAME = 'deployment.environment.name';\n\n// Telemetry attributes\nexport const ATTR_TELEMETRY_DISTRO_NAME = 'telemetry.distro.name';\nexport const ATTR_TELEMETRY_DISTRO_VERSION = 'telemetry.distro.version';\n\n// Process/Runtime attributes\nexport const ATTR_PROCESS_RUNTIME_NAME = 'process.runtime.name';\nexport const ATTR_PROCESS_RUNTIME_VERSION = 'process.runtime.version';\n"]}

package/dist/esm/types.js

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

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Attributes, ContextManager, TextMapPropagator } from '@opentelemetry/api';\nimport type { Instrumentation } from '@opentelemetry/instrumentation';\nimport type { FetchCustomAttributeFunction } from '@opentelemetry/instrumentation-fetch';\nimport type { XHRCustomAttributeFunction } from '@opentelemetry/instrumentation-xml-http-request';\nimport type { SpanProcessor } from '@opentelemetry/sdk-trace-base';\n\nimport type { API, Patterns } from '@grafana/faro-core';\n\nexport type InstrumentationOption = Instrumentation | Instrumentation[];\n\nexport interface FaroTraceExporterConfig {\n  api: API;\n}\n\nexport interface TracingInstrumentationOptions {\n  resourceAttributes?: Attributes;\n  propagator?: TextMapPropagator;\n  contextManager?: ContextManager;\n  instrumentations?: InstrumentationOption[];\n  spanProcessor?: SpanProcessor;\n  instrumentationOptions?: Omit<DefaultInstrumentationsOptions, 'ignoreUrls'>;\n}\n\nexport type MatchUrlDefinitions = Patterns;\n\nexport type DefaultInstrumentationsOptions = {\n  ignoreUrls?: MatchUrlDefinitions;\n  propagateTraceHeaderCorsUrls?: MatchUrlDefinitions;\n\n  fetchInstrumentationOptions?: {\n    applyCustomAttributesOnSpan?: FetchCustomAttributeFunction;\n    ignoreNetworkEvents?: boolean;\n  };\n\n  xhrInstrumentationOptions?: {\n    applyCustomAttributesOnSpan?: XHRCustomAttributeFunction;\n    ignoreNetworkEvents?: boolean;\n  };\n};\n"]}

package/dist/esm/utils/sampler.js

@@ -0,0 +1,17 @@
+import { SamplingDecision } from '@opentelemetry/sdk-trace-base';
+/**
+ * Get sampling decision based on session configuration
+ *
+ * If the session is sampled, traces will be collected.
+ * If the session is not sampled, traces will be dropped.
+ *
+ * @param sessionMeta - Current Faro session meta
+ * @returns OTEL sampling decision
+ */
+export function getSamplingDecision(sessionMeta = {}) {
+    var _a;
+    const isSessionSampled = ((_a = sessionMeta.attributes) === null || _a === void 0 ? void 0 : _a['isSampled']) === 'true';
+    const samplingDecision = isSessionSampled ? SamplingDecision.RECORD_AND_SAMPLED : SamplingDecision.NOT_RECORD;
+    return samplingDecision;
+}
+//# sourceMappingURL=sampler.js.map

package/dist/esm/utils/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../../src/utils/sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,cAA2B,EAAE;;IAC/D,MAAM,gBAAgB,GAAG,CAAA,MAAA,WAAW,CAAC,UAAU,0CAAG,WAAW,CAAC,MAAK,MAAM,CAAC;IAC1E,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC;IAE9G,OAAO,gBAAgB,CAAC;AAC1B,CAAC","sourcesContent":["import { SamplingDecision } from '@opentelemetry/sdk-trace-base';\n\nimport type { MetaSession } from '@grafana/faro-core';\n\n/**\n * Get sampling decision based on session configuration\n *\n * If the session is sampled, traces will be collected.\n * If the session is not sampled, traces will be dropped.\n *\n * @param sessionMeta - Current Faro session meta\n * @returns OTEL sampling decision\n */\nexport function getSamplingDecision(sessionMeta: MetaSession = {}): SamplingDecision {\n  const isSessionSampled = sessionMeta.attributes?.['isSampled'] === 'true';\n  const samplingDecision = isSessionSampled ? SamplingDecision.RECORD_AND_SAMPLED : SamplingDecision.NOT_RECORD;\n\n  return samplingDecision;\n}\n"]}