@grafana/faro-react-native-tracing 1.3.1 → 2.0.0

package/README.md

@@ -41,6 +41,23 @@ const faro = initializeFaro({
 
 That's it! HTTP requests via `fetch()` are now automatically traced (and correlated with user actions when user action tracking is enabled) and sent to your Faro collector.
 
+## HTTP span and event conventions
+
+Built-in fetch tracing uses OpenTelemetry's [stable HTTP conventions](https://opentelemetry.io/docs/specs/semconv/http/http-spans/#name),
+with span names such as `GET` and `POST`. Attributes include `http.request.method`,
+`url.full`, `server.address`, `server.port`, and `http.response.status_code`.
+Successful responses leave status UNSET; ordinary 4xx/5xx responses set ERROR
+and a string `error.type`. There is no fetch convention mode setting.
+
+The `faro.tracing.fetch` event keeps `http.method`, `http.url`, `http.status_code`,
+`http.host`, and `http.scheme`. Event attributes, including `duration_ns`, are
+strings. Events retain session and trace/span context and use the shared event
+pipeline for deduplication and transport hooks. Optional XHR tracing and custom
+instrumentations use their own conventions.
+
+Fetch spans capture the active user action at request start. A delayed fetch
+event can still be associated with a later action through event buffering.
+
 ## Fetch vs XHR in React Native
 
 By default, this package traces `fetch()` requests only.
@@ -209,6 +226,10 @@ new TracingInstrumentation({
 });
 ```
 
+A custom span processor remains reusable when Faro removes and later re-adds the tracing instrumentation. Removal
+flushes the processor without shutting it down. Calling `TracingInstrumentation.shutdown()` shuts it down and is
+terminal for that processor; use a new processor before initializing the instrumentation again.
+
 ## Usage Examples
 
 ### Automatic HTTP Tracing
@@ -665,6 +686,10 @@ const { trace } = faro.otel; // Error!
 
 **Solution:** This should be automatic. If you're using a custom span processor or custom instrumentations, ensure you're not overriding the tracer provider registration.
 
+If another global OpenTelemetry tracer provider is already registered, tracing initialization fails with a clear
+error instead of installing request instrumentation that cannot export through Faro. Remove the duplicate provider
+registration before initializing `TracingInstrumentation`.
+
 ### Spans missing user/session/device context
 
 **Cause:** FaroMetaAttributesSpanProcessor is not wrapping your span processor.
@@ -727,9 +752,17 @@ class TracingInstrumentation extends BaseInstrumentation {
   constructor(options?: TracingInstrumentationOptions);
   initialize(): void;
   shutdown(): Promise<void>;
+  destroy(): void;
 }
 ```
 
+`shutdown()` detaches HTTP instrumentation before waiting for the tracer provider to flush. Faro calls `destroy()`
+when the instrumentation is removed; it detaches immediately and completes provider shutdown in the background.
+Both methods are safe to call more than once.
+
+When tracing is removed and later re-added, reuse the same `TracingInstrumentation` instance so the default fetch
+and XHR patches are reused as well.
+
 **Options:**
 
 ```typescript

package/dist/cjs/exporters/faroTraceExporter.utils.js

@@ -5,6 +5,36 @@ var internal_types_1 = require("@opentelemetry/otlp-transformer/build/src/trace/
 var faro_core_1 = require("@grafana/faro-core");
 var internalLogger = (0, faro_core_1.createInternalLogger)();
 var DURATION_NS_KEY = 'duration_ns';
+/** Map stable OTel span attributes to Faro's fetch event contract. */
+function projectFetchEventAttributes(attributes) {
+    var _a, _b, _c;
+    var fields = {
+        'http.request.method': 'http.method',
+        'url.full': 'http.url',
+        'http.response.status_code': 'http.status_code',
+    };
+    for (var _i = 0, _d = Object.entries(fields); _i < _d.length; _i++) {
+        var _e = _d[_i], spanField = _e[0], eventField = _e[1];
+        if (attributes[spanField] != null) {
+            attributes[eventField] = attributes[spanField];
+            delete attributes[spanField];
+        }
+    }
+    var url = attributes['http.url'];
+    if (url) {
+        try {
+            var parsed = new URL(url);
+            attributes['http.host'] = (_a = attributes['http.host']) !== null && _a !== void 0 ? _a : parsed.host;
+            attributes['http.scheme'] = (_b = attributes['http.scheme']) !== null && _b !== void 0 ? _b : parsed.protocol.replace(':', '');
+        }
+        catch (_f) {
+            // Keep the captured URL even if it cannot supply host/scheme metadata.
+        }
+    }
+    delete attributes['server.address'];
+    delete attributes['server.port'];
+    attributes['component'] = (_c = attributes['component']) !== null && _c !== void 0 ? _c : 'fetch';
+}
 /**
  * Send Faro events for CLIENT spans (HTTP requests, navigation, etc.)
  *
@@ -45,6 +75,9 @@ function sendFaroEvents(resourceSpans) {
                         var attribute = _g[_f];
                         faroEventAttributes[attribute.key] = String(Object.values(attribute.value)[0]);
                     }
+                    if ((scope === null || scope === void 0 ? void 0 : scope.name) === '@opentelemetry/instrumentation-fetch') {
+                        projectFetchEventAttributes(faroEventAttributes);
+                    }
                     // Add span duration in nanoseconds
                     if (!Number.isNaN(span.endTimeUnixNano) && !Number.isNaN(span.startTimeUnixNano)) {
                         faroEventAttributes[DURATION_NS_KEY] = String(Number(span.endTimeUnixNano) - Number(span.startTimeUnixNano));

package/dist/cjs/exporters/faroTraceExporter.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"faroTraceExporter.utils.js","sourceRoot":"","sources":["../../../src/exporters/faroTraceExporter.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SpanContext } from '@opentelemetry/api';\nimport { ESpanKind, type IResourceSpans } from '@opentelemetry/otlp-transformer/build/src/trace/internal-types';\n\nimport { createInternalLogger, faro, unknownString } from '@grafana/faro-core';\nimport type { EventAttributes as FaroEventAttributes } from '@grafana/faro-core';\n\nconst internalLogger = createInternalLogger();\n\nconst DURATION_NS_KEY = 'duration_ns';\n\n/**\n * Send Faro events for CLIENT spans (HTTP requests, navigation, etc.)\n *\n * IMPORTANT: This function is called during trace export and must be careful to avoid infinite loops.\n *\n * Infinite loop prevention strategy:\n * 1. Only process SPAN_KIND_CLIENT spans (HTTP requests, etc.)\n * 2. Use faro.api.pushEvent which:\n *    - Does NOT trigger console logs if ConsoleInstrumentation is configured properly\n *    - Does NOT trigger HTTP instrumentation for collector URLs (they're ignored)\n * 3. Use internalLogger for debugging instead of console\n * 4. Never call console.log/warn/error in this function\n *\n * @param resourceSpans - OTLP resource spans from trace exporter\n */\nexport function sendFaroEvents(resourceSpans: IResourceSpans[] = []) {\n  try {\n    for (const resourceSpan of resourceSpans) {\n      const { scopeSpans } = resourceSpan;\n\n      for (const scopeSpan of scopeSpans) {\n        const { scope, spans = [] } = scopeSpan;\n\n        for (const span of spans) {\n          // Only process CLIENT spans (HTTP requests, external calls)\n          // This avoids processing internal spans which could cause loops\n          if (span.kind !== ESpanKind.SPAN_KIND_CLIENT) {\n            continue;\n          }\n\n          const spanContext: Pick<SpanContext, 'traceId' | 'spanId'> = {\n            traceId: span.traceId.toString(),\n            spanId: span.spanId.toString(),\n          };\n\n          const faroEventAttributes: FaroEventAttributes = {};\n          for (const attribute of span.attributes) {\n            faroEventAttributes[attribute.key] = String(Object.values(attribute.value)[0]);\n          }\n\n          // Add span duration in nanoseconds\n          if (!Number.isNaN(span.endTimeUnixNano) && !Number.isNaN(span.startTimeUnixNano)) {\n            faroEventAttributes[DURATION_NS_KEY] = String(\n              Number(span.endTimeUnixNano) - Number(span.startTimeUnixNano)\n            );\n          }\n\n          const index = (scope?.name ?? '').indexOf('-');\n          let eventName = unknownString;\n\n          if (scope?.name) {\n            if (index === -1) {\n              eventName = scope.name.split('/')[1] ?? scope.name;\n            }\n\n            if (index > -1) {\n              eventName = scope?.name.substring(index + 1);\n            }\n          }\n\n          // Push event to Faro\n          // This should NOT cause infinite loops because:\n          // 1. The collector URL is in ignoreUrls for HttpInstrumentation\n          // 2. ConsoleInstrumentation won't log this event\n          // 3. No console.log calls are made here\n          faro.api.pushEvent(`faro.tracing.${eventName}`, faroEventAttributes, undefined, {\n            spanContext,\n            // Convert nanoseconds to milliseconds\n            timestampOverwriteMs: Number(span.endTimeUnixNano) / 1_000_000,\n            customPayloadTransformer: (payload) => {\n              if (\n                faroEventAttributes['faro.action.user.name'] != null &&\n                faroEventAttributes['faro.action.user.parentId'] != null\n              ) {\n                payload.action = {\n                  name: faroEventAttributes['faro.action.user.name'],\n                  parentId: faroEventAttributes['faro.action.user.parentId'],\n                };\n\n                delete payload.attributes?.['faro.action.user.name'];\n                delete payload.attributes?.['faro.action.user.parentId'];\n              }\n\n              return payload;\n            },\n          });\n        }\n      }\n    }\n  } catch (error) {\n    // Only log critical errors using internal logger\n    // Do NOT use console.log here as it could cause infinite loops\n    internalLogger.error('sendFaroEvents: Failed to process spans', error);\n  }\n}\n"]}
+{"version":3,"file":"faroTraceExporter.utils.js","sourceRoot":"","sources":["../../../src/exporters/faroTraceExporter.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SpanContext } from '@opentelemetry/api';\nimport { ESpanKind, type IResourceSpans } from '@opentelemetry/otlp-transformer/build/src/trace/internal-types';\n\nimport { createInternalLogger, faro, unknownString } from '@grafana/faro-core';\nimport type { EventAttributes as FaroEventAttributes } from '@grafana/faro-core';\n\nconst internalLogger = createInternalLogger();\n\nconst DURATION_NS_KEY = 'duration_ns';\n/** Map stable OTel span attributes to Faro's fetch event contract. */\nfunction projectFetchEventAttributes(attributes: FaroEventAttributes): void {\n  const fields = {\n    'http.request.method': 'http.method',\n    'url.full': 'http.url',\n    'http.response.status_code': 'http.status_code',\n  };\n  for (const [spanField, eventField] of Object.entries(fields)) {\n    if (attributes[spanField] != null) {\n      attributes[eventField] = attributes[spanField];\n      delete attributes[spanField];\n    }\n  }\n\n  const url = attributes['http.url'];\n  if (url) {\n    try {\n      const parsed = new URL(url);\n      attributes['http.host'] = attributes['http.host'] ?? parsed.host;\n      attributes['http.scheme'] = attributes['http.scheme'] ?? parsed.protocol.replace(':', '');\n    } catch {\n      // Keep the captured URL even if it cannot supply host/scheme metadata.\n    }\n  }\n  delete attributes['server.address'];\n  delete attributes['server.port'];\n  attributes['component'] = attributes['component'] ?? 'fetch';\n}\n\n/**\n * Send Faro events for CLIENT spans (HTTP requests, navigation, etc.)\n *\n * IMPORTANT: This function is called during trace export and must be careful to avoid infinite loops.\n *\n * Infinite loop prevention strategy:\n * 1. Only process SPAN_KIND_CLIENT spans (HTTP requests, etc.)\n * 2. Use faro.api.pushEvent which:\n *    - Does NOT trigger console logs if ConsoleInstrumentation is configured properly\n *    - Does NOT trigger HTTP instrumentation for collector URLs (they're ignored)\n * 3. Use internalLogger for debugging instead of console\n * 4. Never call console.log/warn/error in this function\n *\n * @param resourceSpans - OTLP resource spans from trace exporter\n */\nexport function sendFaroEvents(resourceSpans: IResourceSpans[] = []) {\n  try {\n    for (const resourceSpan of resourceSpans) {\n      const { scopeSpans } = resourceSpan;\n\n      for (const scopeSpan of scopeSpans) {\n        const { scope, spans = [] } = scopeSpan;\n\n        for (const span of spans) {\n          // Only process CLIENT spans (HTTP requests, external calls)\n          // This avoids processing internal spans which could cause loops\n          if (span.kind !== ESpanKind.SPAN_KIND_CLIENT) {\n            continue;\n          }\n\n          const spanContext: Pick<SpanContext, 'traceId' | 'spanId'> = {\n            traceId: span.traceId.toString(),\n            spanId: span.spanId.toString(),\n          };\n\n          const faroEventAttributes: FaroEventAttributes = {};\n          for (const attribute of span.attributes) {\n            faroEventAttributes[attribute.key] = String(Object.values(attribute.value)[0]);\n          }\n\n          if (scope?.name === '@opentelemetry/instrumentation-fetch') {\n            projectFetchEventAttributes(faroEventAttributes);\n          }\n\n          // Add span duration in nanoseconds\n          if (!Number.isNaN(span.endTimeUnixNano) && !Number.isNaN(span.startTimeUnixNano)) {\n            faroEventAttributes[DURATION_NS_KEY] = String(\n              Number(span.endTimeUnixNano) - Number(span.startTimeUnixNano)\n            );\n          }\n\n          const index = (scope?.name ?? '').indexOf('-');\n          let eventName = unknownString;\n\n          if (scope?.name) {\n            if (index === -1) {\n              eventName = scope.name.split('/')[1] ?? scope.name;\n            }\n\n            if (index > -1) {\n              eventName = scope?.name.substring(index + 1);\n            }\n          }\n\n          // Push event to Faro\n          // This should NOT cause infinite loops because:\n          // 1. The collector URL is in ignoreUrls for HttpInstrumentation\n          // 2. ConsoleInstrumentation won't log this event\n          // 3. No console.log calls are made here\n          faro.api.pushEvent(`faro.tracing.${eventName}`, faroEventAttributes, undefined, {\n            spanContext,\n            // Convert nanoseconds to milliseconds\n            timestampOverwriteMs: Number(span.endTimeUnixNano) / 1_000_000,\n            customPayloadTransformer: (payload) => {\n              if (\n                faroEventAttributes['faro.action.user.name'] != null &&\n                faroEventAttributes['faro.action.user.parentId'] != null\n              ) {\n                payload.action = {\n                  name: faroEventAttributes['faro.action.user.name'],\n                  parentId: faroEventAttributes['faro.action.user.parentId'],\n                };\n\n                delete payload.attributes?.['faro.action.user.name'];\n                delete payload.attributes?.['faro.action.user.parentId'];\n              }\n\n              return payload;\n            },\n          });\n        }\n      }\n    }\n  } catch (error) {\n    // Only log critical errors using internal logger\n    // Do NOT use console.log here as it could cause infinite loops\n    internalLogger.error('sendFaroEvents: Failed to process spans', error);\n  }\n}\n"]}

package/dist/cjs/instrumentation.js

@@ -76,8 +76,34 @@ var faroMetaAttributesSpanProcessor_1 = require("./processors/faroMetaAttributes
 var httpRequestMonitorSpanProcessor_1 = require("./processors/httpRequestMonitorSpanProcessor");
 var semconv_1 = require("./semconv");
 var sampler_1 = require("./utils/sampler");
-// Import React Native TracerProvider
-// Note: We use the base provider since React Native doesn't have a specific one
+var detachedInstrumentations = new WeakSet();
+/**
+ * Keeps a caller-supplied processor reusable across Faro remove/add cycles.
+ * Explicit TracingInstrumentation.shutdown() remains responsible for the
+ * processor's terminal shutdown.
+ */
+var BorrowedSpanProcessor = /** @class */ (function () {
+    function BorrowedSpanProcessor(processor) {
+        this.processor = processor;
+    }
+    BorrowedSpanProcessor.prototype.forceFlush = function () {
+        return this.processor.forceFlush();
+    };
+    BorrowedSpanProcessor.prototype.onStart = function (span, parentContext) {
+        this.processor.onStart(span, parentContext);
+    };
+    BorrowedSpanProcessor.prototype.onEnding = function (span) {
+        var _a, _b;
+        (_b = (_a = this.processor).onEnding) === null || _b === void 0 ? void 0 : _b.call(_a, span);
+    };
+    BorrowedSpanProcessor.prototype.onEnd = function (span) {
+        this.processor.onEnd(span);
+    };
+    BorrowedSpanProcessor.prototype.shutdown = function () {
+        return Promise.resolve();
+    };
+    return BorrowedSpanProcessor;
+}());
 /**
  * TracingInstrumentation for React Native
  *
@@ -112,11 +138,13 @@ var TracingInstrumentation = /** @class */ (function (_super) {
         _this.options = options;
         _this.name = '@grafana/faro-react-native-tracing';
         _this.version = faro_core_1.VERSION;
+        _this.pendingShutdowns = new Set();
         return _this;
     }
     TracingInstrumentation.prototype.initialize = function () {
         var _this = this;
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e;
+        this.destroy();
         var options = this.options;
         var attributes = {};
         // App attributes
@@ -165,7 +193,7 @@ var TracingInstrumentation = /** @class */ (function (_super) {
         Object.assign(attributes, options.resourceAttributes);
         var resource = (0, resources_1.defaultResource)().merge((0, resources_1.resourceFromAttributes)(attributes));
         // Create tracer provider with span processors
-        this.provider = new sdk_trace_base_1.BasicTracerProvider({
+        var provider = new sdk_trace_base_1.BasicTracerProvider({
             resource: resource,
             sampler: {
                 shouldSample: function () {
@@ -175,51 +203,90 @@ var TracingInstrumentation = /** @class */ (function (_super) {
                 },
             },
             spanProcessors: [
-                (_b = options.spanProcessor) !== null && _b !== void 0 ? _b : new httpRequestMonitorSpanProcessor_1.HttpRequestMonitorSpanProcessor(new faroMetaAttributesSpanProcessor_1.FaroMetaAttributesSpanProcessor(new sdk_trace_base_1.BatchSpanProcessor(new faroTraceExporter_1.FaroTraceExporter({ api: this.api }), {
+                (_b = (options.spanProcessor && new BorrowedSpanProcessor(options.spanProcessor))) !== null && _b !== void 0 ? _b : new httpRequestMonitorSpanProcessor_1.HttpRequestMonitorSpanProcessor(new faroMetaAttributesSpanProcessor_1.FaroMetaAttributesSpanProcessor(new sdk_trace_base_1.BatchSpanProcessor(new faroTraceExporter_1.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
-        api_1.trace.setGlobalTracerProvider(this.provider);
-        // Register a global ContextManager. Without one, OTel falls back to the NoopContextManager,
-        // which always returns ROOT_CONTEXT — so when `@opentelemetry/instrumentation-fetch` does
-        // `context.with(setSpan(active(), createdSpan), () => _addHeaders(...))` the span set on the
-        // wrapped context is invisible inside `_addHeaders` and `propagation.inject` writes nothing.
-        // `StackContextManager` is pure JS (no DOM/Zone deps) and works in React Native.
-        api_1.context.setGlobalContextManager((_c = options.contextManager) !== null && _c !== void 0 ? _c : new sdk_trace_web_1.StackContextManager().enable());
-        // Register the global text-map propagator. Without this, OTel falls back to a
-        // NoopTextMapPropagator and `propagation.inject(...)` becomes a no-op, meaning
-        // `traceparent` / `tracestate` (and `baggage`) headers are never written on the
-        // outbound fetch/XHR — so the backend receives no context and starts a new trace.
-        api_1.propagation.setGlobalPropagator((_d = options.propagator) !== null && _d !== void 0 ? _d : new core_1.CompositePropagator({
-            propagators: [new core_1.W3CTraceContextPropagator(), new core_1.W3CBaggagePropagator()],
-        }));
-        var _g = (_e = this.options.instrumentationOptions) !== null && _e !== void 0 ? _e : {}, enableFetchInstrumentation = _g.enableFetchInstrumentation, enableXhrInstrumentation = _g.enableXhrInstrumentation, propagateTraceHeaderCorsUrls = _g.propagateTraceHeaderCorsUrls, fetchInstrumentationOptions = _g.fetchInstrumentationOptions, xhrInstrumentationOptions = _g.xhrInstrumentationOptions;
-        // Get ignore URLs from transports to prevent infinite loops
-        var ignoreUrls = this.getIgnoreUrls();
-        // Register instrumentations
-        (0, instrumentation_1.registerInstrumentations)({
-            instrumentations: (_f = options.instrumentations) !== null && _f !== void 0 ? _f : (0, getDefaultOTELInstrumentations_1.getDefaultOTELInstrumentations)({
+        var registration = {
+            instrumentations: [],
+            ownsContextManager: false,
+            ownsContextManagerInstance: false,
+            ownsPropagator: false,
+            ownsTracerProvider: false,
+            provider: provider,
+        };
+        this.activeRegistration = registration;
+        try {
+            // Register the provider as the global tracer provider
+            // This is CRITICAL for the tracer to generate real trace IDs instead of all zeros
+            if (!api_1.trace.setGlobalTracerProvider(provider)) {
+                throw new Error('Unable to register the Faro OpenTelemetry tracer provider. Remove the existing global tracer provider before initializing Faro tracing.');
+            }
+            registration.ownsTracerProvider = true;
+            // Register a global ContextManager. Without one, OTel falls back to the NoopContextManager,
+            // which always returns ROOT_CONTEXT — so when `@opentelemetry/instrumentation-fetch` does
+            // `context.with(setSpan(active(), createdSpan), () => _addHeaders(...))` the span set on the
+            // wrapped context is invisible inside `_addHeaders` and `propagation.inject` writes nothing.
+            // `StackContextManager` is pure JS (no DOM/Zone deps) and works in React Native.
+            var contextManager = ((_c = options.contextManager) !== null && _c !== void 0 ? _c : new sdk_trace_web_1.StackContextManager()).enable();
+            registration.contextManager = contextManager;
+            registration.ownsContextManagerInstance = options.contextManager == null;
+            registration.ownsContextManager = api_1.context.setGlobalContextManager(contextManager);
+            // Register the global text-map propagator. Without this, OTel falls back to a
+            // NoopTextMapPropagator and `propagation.inject(...)` becomes a no-op, meaning
+            // `traceparent` / `tracestate` (and `baggage`) headers are never written on the
+            // outbound fetch/XHR — so the backend receives no context and starts a new trace.
+            registration.ownsPropagator = api_1.propagation.setGlobalPropagator((_d = options.propagator) !== null && _d !== void 0 ? _d : new core_1.CompositePropagator({
+                propagators: [new core_1.W3CTraceContextPropagator(), new core_1.W3CBaggagePropagator()],
+            }));
+            var _f = (_e = this.options.instrumentationOptions) !== null && _e !== void 0 ? _e : {}, enableFetchInstrumentation = _f.enableFetchInstrumentation, enableXhrInstrumentation = _f.enableXhrInstrumentation, propagateTraceHeaderCorsUrls = _f.propagateTraceHeaderCorsUrls, fetchInstrumentationOptions = _f.fetchInstrumentationOptions, xhrInstrumentationOptions = _f.xhrInstrumentationOptions;
+            // Get ignore URLs from transports to prevent infinite loops
+            var ignoreUrls = this.getIgnoreUrls();
+            var defaultInstrumentationOptions = {
                 ignoreUrls: ignoreUrls,
                 enableFetchInstrumentation: enableFetchInstrumentation,
                 enableXhrInstrumentation: enableXhrInstrumentation,
                 propagateTraceHeaderCorsUrls: propagateTraceHeaderCorsUrls,
                 fetchInstrumentationOptions: fetchInstrumentationOptions,
                 xhrInstrumentationOptions: 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
-        var globalFaroInstance = (0, faro_core_1.getInternalFaroFromGlobalObject)();
-        if (globalFaroInstance) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Extending Faro instance with OTEL API
-            globalFaroInstance.otel = {
-                trace: api_1.trace,
-                context: api_1.context,
             };
+            if (options.instrumentations) {
+                registration.instrumentations = options.instrumentations.flat();
+            }
+            else if (this.defaultInstrumentations) {
+                (0, getDefaultOTELInstrumentations_1.updateDefaultOTELInstrumentations)(this.defaultInstrumentations, defaultInstrumentationOptions);
+                registration.instrumentations = this.defaultInstrumentations;
+            }
+            else {
+                this.defaultInstrumentations = (0, getDefaultOTELInstrumentations_1.getDefaultOTELInstrumentations)(defaultInstrumentationOptions).flat();
+                registration.instrumentations = this.defaultInstrumentations;
+            }
+            var instrumentationsNeedingExplicitEnable = registration.instrumentations.filter(function (instrumentation) {
+                return detachedInstrumentations.has(instrumentation) && instrumentation.getConfig().enabled === true;
+            });
+            registration.unregisterInstrumentations = (0, instrumentation_1.registerInstrumentations)({
+                instrumentations: registration.instrumentations,
+            });
+            registration.instrumentations.forEach(function (instrumentation) {
+                detachedInstrumentations.delete(instrumentation);
+            });
+            instrumentationsNeedingExplicitEnable.forEach(function (instrumentation) { return instrumentation.enable(); });
+            // Expose OTEL API on the global Faro instance for manual span creation
+            // This allows users to access trace and context APIs via faro.otel
+            var globalFaroInstance = (0, faro_core_1.getInternalFaroFromGlobalObject)();
+            if (globalFaroInstance) {
+                var faroOtel = { trace: api_1.trace, context: api_1.context };
+                registration.faro = globalFaroInstance;
+                registration.faroOtel = faroOtel;
+                registration.previousFaroOtel = globalFaroInstance.otel;
+                globalFaroInstance.otel = faroOtel;
+            }
+        }
+        catch (error) {
+            this.destroy();
+            throw error;
         }
     };
     /**
@@ -244,24 +311,172 @@ var TracingInstrumentation = /** @class */ (function (_super) {
         // Return dev-server, original transport URLs, and regex patterns for maximum coverage.
         return __spreadArray(__spreadArray(__spreadArray([], (0, devServerIgnoreUrls_1.getReactNativeDevServerIgnoreUrls)(), true), transportUrls, true), regexPatterns, true);
     };
-    /**
-     * Shutdown the tracer provider
-     */
+    TracingInstrumentation.prototype.detachRegistration = function () {
+        var _this = this;
+        var registration = this.activeRegistration;
+        if (!registration) {
+            return undefined;
+        }
+        this.activeRegistration = undefined;
+        registration.instrumentations.forEach(function (instrumentation) { return detachedInstrumentations.add(instrumentation); });
+        var unregistered = false;
+        if (registration.unregisterInstrumentations) {
+            try {
+                registration.unregisterInstrumentations();
+                unregistered = true;
+            }
+            catch (error) {
+                this.logCleanupError('unregister OpenTelemetry instrumentations', error);
+            }
+        }
+        if (!unregistered) {
+            registration.instrumentations.forEach(function (instrumentation) {
+                _this.runCleanup("disable ".concat(instrumentation.instrumentationName), function () { return instrumentation.disable(); });
+            });
+        }
+        var faro = registration.faro, faroOtel = registration.faroOtel;
+        if (faro && faroOtel && faro.otel === faroOtel) {
+            this.runCleanup('restore faro.otel', function () {
+                if (registration.previousFaroOtel === undefined) {
+                    delete faro.otel;
+                }
+                else {
+                    faro.otel = registration.previousFaroOtel;
+                }
+            });
+        }
+        if (registration.ownsPropagator) {
+            this.runCleanup('clear the OpenTelemetry propagator', function () { return api_1.propagation.disable(); });
+        }
+        if (registration.ownsContextManager) {
+            this.runCleanup('clear the OpenTelemetry context manager', function () { return api_1.context.disable(); });
+        }
+        else if (registration.ownsContextManagerInstance && registration.contextManager) {
+            this.runCleanup('disable the unused OpenTelemetry context manager', function () { var _a; return (_a = registration.contextManager) === null || _a === void 0 ? void 0 : _a.disable(); });
+        }
+        if (registration.ownsTracerProvider) {
+            this.runCleanup('clear the OpenTelemetry tracer provider', function () { return api_1.trace.disable(); });
+        }
+        return registration;
+    };
+    TracingInstrumentation.prototype.runCleanup = function (action, cleanup) {
+        try {
+            cleanup();
+        }
+        catch (error) {
+            this.logCleanupError(action, error);
+        }
+    };
+    TracingInstrumentation.prototype.logCleanupError = function (action, error) {
+        try {
+            this.logError("Failed to ".concat(action, ":"), error);
+        }
+        catch (_loggingError) {
+            // Cleanup must not fail because a custom logger threw.
+        }
+    };
+    TracingInstrumentation.prototype.startProviderShutdown = function (registration) {
+        var _this = this;
+        if (!registration.shutdownPromise) {
+            var shutdownPromise_1 = Promise.resolve()
+                .then(function () { return registration.provider.forceFlush(); })
+                .catch(function (error) {
+                _this.logCleanupError('flush the OpenTelemetry tracer provider', error);
+            })
+                .then(function () { return registration.provider.shutdown(); });
+            registration.shutdownPromise = shutdownPromise_1;
+            this.pendingShutdowns.add(shutdownPromise_1);
+            void shutdownPromise_1.then(function () { return _this.pendingShutdowns.delete(shutdownPromise_1); }, function () { return _this.pendingShutdowns.delete(shutdownPromise_1); });
+        }
+        return registration.shutdownPromise;
+    };
+    TracingInstrumentation.prototype.startSuppliedSpanProcessorShutdown = function () {
+        var spanProcessor = this.options.spanProcessor;
+        if (!spanProcessor) {
+            return undefined;
+        }
+        if (!this.suppliedSpanProcessorShutdown) {
+            try {
+                this.suppliedSpanProcessorShutdown = spanProcessor.shutdown();
+            }
+            catch (error) {
+                this.suppliedSpanProcessorShutdown = Promise.reject(error);
+            }
+        }
+        return this.suppliedSpanProcessorShutdown;
+    };
+    /** Detach request instrumentations and wait for the tracer provider to flush. */
     TracingInstrumentation.prototype.shutdown = function () {
         return __awaiter(this, void 0, void 0, function () {
+            var pendingShutdowns, registration, firstError, shutdownFailed, _i, pendingShutdowns_1, shutdownPromise, error_1, spanProcessorShutdown, error_2;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!this.provider) return [3 /*break*/, 2];
-                        return [4 /*yield*/, this.provider.shutdown()];
+                        pendingShutdowns = Array.from(this.pendingShutdowns);
+                        registration = this.detachRegistration();
+                        if (registration) {
+                            pendingShutdowns.push(this.startProviderShutdown(registration));
+                        }
+                        shutdownFailed = false;
+                        _i = 0, pendingShutdowns_1 = pendingShutdowns;
+                        _a.label = 1;
                     case 1:
-                        _a.sent();
+                        if (!(_i < pendingShutdowns_1.length)) return [3 /*break*/, 6];
+                        shutdownPromise = pendingShutdowns_1[_i];
                         _a.label = 2;
-                    case 2: return [2 /*return*/];
+                    case 2:
+                        _a.trys.push([2, 4, , 5]);
+                        return [4 /*yield*/, shutdownPromise];
+                    case 3:
+                        _a.sent();
+                        return [3 /*break*/, 5];
+                    case 4:
+                        error_1 = _a.sent();
+                        if (!shutdownFailed) {
+                            firstError = error_1;
+                            shutdownFailed = true;
+                        }
+                        return [3 /*break*/, 5];
+                    case 5:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 6:
+                        spanProcessorShutdown = this.startSuppliedSpanProcessorShutdown();
+                        if (!spanProcessorShutdown) return [3 /*break*/, 10];
+                        _a.label = 7;
+                    case 7:
+                        _a.trys.push([7, 9, , 10]);
+                        return [4 /*yield*/, spanProcessorShutdown];
+                    case 8:
+                        _a.sent();
+                        return [3 /*break*/, 10];
+                    case 9:
+                        error_2 = _a.sent();
+                        if (!shutdownFailed) {
+                            firstError = error_2;
+                            shutdownFailed = true;
+                        }
+                        return [3 /*break*/, 10];
+                    case 10:
+                        if (shutdownFailed) {
+                            throw firstError;
+                        }
+                        return [2 /*return*/];
                 }
             });
         });
     };
+    /** Detach synchronously when Faro removes this instrumentation. */
+    TracingInstrumentation.prototype.destroy = function () {
+        var _this = this;
+        var registration = this.detachRegistration();
+        if (!registration) {
+            return;
+        }
+        void this.startProviderShutdown(registration).then(undefined, function (error) {
+            _this.logCleanupError('shut down the OpenTelemetry tracer provider', error);
+        });
+    };
     TracingInstrumentation.SCHEDULED_BATCH_DELAY_MS = 1000;
     return TracingInstrumentation;
 }(faro_core_1.BaseInstrumentation));

package/dist/cjs/instrumentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0CAAiE;AAEjE,4CAA2G;AAC3G,kEAA0E;AAC1E,sDAAmF;AACnF,gEAAqH;AAErH,8DAAmE;AACnE,4EAI6C;AAE7C,gDAAmG;AAGnG,mEAAkE;AAClE,8EAA2F;AAC3F,oGAAmG;AACnG,gGAA+F;AAC/F,gGAA+F;AAC/F,qCAamB;AAEnB,2CAAsD;AAEtD,qCAAqC;AACrC,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;IAA4C,0CAAmB;IAQ7D,gCAAoB,OAA2C;QAA3C,wBAAA,EAAA,YAA2C;QAC7D,YAAA,MAAK,WAAE,SAAC;QADU,aAAO,GAAP,OAAO,CAAoC;QAP/D,UAAI,GAAG,oCAAoC,CAAC;QAC5C,aAAO,GAAG,mBAAO,CAAC;;IAQlB,CAAC;IAED,2CAAU,GAAV;QAAA,iBAyJC;;QAxJC,IAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAM,UAAU,GAAe,EAAE,CAAC;QAElC,iBAAiB;QACjB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACzB,UAAU,CAAC,wCAAiB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACvD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YAC9B,UAAU,CAAC,gCAAsB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QACjE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC5B,UAAU,CAAC,2CAAoB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;YAC3D,UAAU,CAAC,0BAAgB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACzD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAChC,UAAU,CAAC,0CAAgC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;YAE3E;;;eAGG;YACH,UAAU,CAAC,yDAAkC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAC/E,CAAC;QAED,+CAA+C;QAC/C,wFAAwF;QACxF,IAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAgC,CAAC;QAC7D,IAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAQvB,CAAC;QAEd,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,EAAE,CAAC;YACtB,UAAU,CAAC,2BAAiB,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;QACnD,CAAC;QAED,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,EAAE,CAAC;YACtB,UAAU,CAAC,2BAAiB,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;QACnD,CAAC;QAED,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,MAAM,EAAE,CAAC;YACvB,UAAU,CAAC,8BAAoB,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QACvD,CAAC;QAED,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,SAAS,EAAE,CAAC;YAC1B,UAAU,CAAC,gCAAsB,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC;QAC5D,CAAC;QAED,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,MAAM,EAAE,CAAC;YACvB,UAAU,CAAC,4BAAkB,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QACrD,CAAC;QAED,UAAU,CAAC,mCAAyB,CAAC,GAAG,cAAc,CAAC;QACvD,UAAU,CAAC,sCAA4B,CAAC,GAAG,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,SAAS,mCAAI,SAAS,CAAC;QAE9E,UAAU,CAAC,oCAA0B,CAAC,GAAG,uBAAuB,CAAC;QACjE,UAAU,CAAC,uCAA6B,CAAC,GAAG,mBAAO,CAAC;QAEpD,sCAAsC;QACtC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAEtD,IAAM,QAAQ,GAAG,IAAA,2BAAe,GAAE,CAAC,KAAK,CAAC,IAAA,kCAAsB,EAAC,UAAU,CAAC,CAAC,CAAC;QAE7E,8CAA8C;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,oCAAyB,CAAC;YAC5C,QAAQ,UAAA;YACR,OAAO,EAAE;gBACP,YAAY,EAAE;oBACZ,OAAO;wBACL,QAAQ,EAAE,IAAA,6BAAmB,EAAC,KAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;qBACrD,CAAC;gBACJ,CAAC;aACF;YACD,cAAc,EAAE;gBACd,MAAA,OAAO,CAAC,aAAa,mCACnB,IAAI,iEAA+B,CACjC,IAAI,iEAA+B,CACjC,IAAI,mCAAkB,CAAC,IAAI,qCAAiB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE;oBAC/D,oBAAoB,EAAE,sBAAsB,CAAC,wBAAwB;oBACrE,kBAAkB,EAAE,EAAE;iBACvB,CAAC,EACF,IAAI,CAAC,KAAK,CACX,CACF;aACJ;SACF,CAAC,CAAC;QAEH,sDAAsD;QACtD,kFAAkF;QAClF,WAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE7C,4FAA4F;QAC5F,0FAA0F;QAC1F,6FAA6F;QAC7F,6FAA6F;QAC7F,iFAAiF;QACjF,aAAO,CAAC,uBAAuB,CAAC,MAAA,OAAO,CAAC,cAAc,mCAAI,IAAI,mCAAmB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAE9F,8EAA8E;QAC9E,+EAA+E;QAC/E,gFAAgF;QAChF,kFAAkF;QAClF,iBAAW,CAAC,mBAAmB,CAC7B,MAAA,OAAO,CAAC,UAAU,mCAChB,IAAI,0BAAmB,CAAC;YACtB,WAAW,EAAE,CAAC,IAAI,gCAAyB,EAAE,EAAE,IAAI,2BAAoB,EAAE,CAAC;SAC3E,CAAC,CACL,CAAC;QAEI,IAAA,KAMF,MAAA,IAAI,CAAC,OAAO,CAAC,sBAAsB,mCAAI,EAAE,EAL3C,0BAA0B,gCAAA,EAC1B,wBAAwB,8BAAA,EACxB,4BAA4B,kCAAA,EAC5B,2BAA2B,iCAAA,EAC3B,yBAAyB,+BACkB,CAAC;QAE9C,4DAA4D;QAC5D,IAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAExC,4BAA4B;QAC5B,IAAA,0CAAwB,EAAC;YACvB,gBAAgB,EACd,MAAA,OAAO,CAAC,gBAAgB,mCACxB,IAAA,+DAA8B,EAAC;gBAC7B,UAAU,YAAA;gBACV,0BAA0B,4BAAA;gBAC1B,wBAAwB,0BAAA;gBACxB,4BAA4B,8BAAA;gBAC5B,2BAA2B,6BAAA;gBAC3B,yBAAyB,2BAAA;aAC1B,CAAC;SACL,CAAC,CAAC;QAEH,uEAAuE;QACvE,mEAAmE;QACnE,IAAM,kBAAkB,GAAG,IAAA,2CAA+B,GAAE,CAAC;QAC7D,IAAI,kBAAkB,EAAE,CAAC;YACvB,uGAAuG;YACtG,kBAA0B,CAAC,IAAI,GAAG;gBACjC,KAAK,aAAA;gBACL,OAAO,eAAA;aACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,8CAAa,GAArB;QACE,mDAAmD;QACnD,IAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,UAAC,SAAoB;YAC5E,OAAO,SAAS,CAAC,aAAa,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,0EAA0E;QAC1E,8DAA8D;QAC9D,IAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,UAAC,GAAG;YAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,mEAAmE;gBACnE,IAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;gBAC9D,OAAO,IAAI,MAAM,CAAC,WAAI,UAAU,QAAK,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,uFAAuF;QACvF,qDAAW,IAAA,uDAAiC,GAAE,SAAK,aAAa,SAAK,aAAa,QAAE;IACtF,CAAC;IAED;;OAEG;IACG,yCAAQ,GAAd;;;;;6BACM,IAAI,CAAC,QAAQ,EAAb,wBAAa;wBACf,qBAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAA;;wBAA9B,SAA8B,CAAC;;;;;;KAElC;IAnMM,+CAAwB,GAAG,IAAI,AAAP,CAAQ;IAoMzC,6BAAC;CAAA,AAxMD,CAA4C,+BAAmB,GAwM9D;AAxMY,wDAAsB","sourcesContent":["import { context, propagation, trace } from '@opentelemetry/api';\nimport type { Attributes } from '@opentelemetry/api';\nimport { CompositePropagator, W3CBaggagePropagator, W3CTraceContextPropagator } from '@opentelemetry/core';\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 { StackContextManager } from '@opentelemetry/sdk-trace-web';\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 { getReactNativeDevServerIgnoreUrls } from './instrumentations/devServerIgnoreUrls';\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    // Register a global ContextManager. Without one, OTel falls back to the NoopContextManager,\n    // which always returns ROOT_CONTEXT — so when `@opentelemetry/instrumentation-fetch` does\n    // `context.with(setSpan(active(), createdSpan), () => _addHeaders(...))` the span set on the\n    // wrapped context is invisible inside `_addHeaders` and `propagation.inject` writes nothing.\n    // `StackContextManager` is pure JS (no DOM/Zone deps) and works in React Native.\n    context.setGlobalContextManager(options.contextManager ?? new StackContextManager().enable());\n\n    // Register the global text-map propagator. Without this, OTel falls back to a\n    // NoopTextMapPropagator and `propagation.inject(...)` becomes a no-op, meaning\n    // `traceparent` / `tracestate` (and `baggage`) headers are never written on the\n    // outbound fetch/XHR — so the backend receives no context and starts a new trace.\n    propagation.setGlobalPropagator(\n      options.propagator ??\n        new CompositePropagator({\n          propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()],\n        })\n    );\n\n    const {\n      enableFetchInstrumentation,\n      enableXhrInstrumentation,\n      propagateTraceHeaderCorsUrls,\n      fetchInstrumentationOptions,\n      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          enableFetchInstrumentation,\n          enableXhrInstrumentation,\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 dev-server, original transport URLs, and regex patterns for maximum coverage.\n    return [...getReactNativeDevServerIgnoreUrls(), ...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"]}
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, propagation, trace } from '@opentelemetry/api';\nimport type { Attributes, Context, ContextManager } from '@opentelemetry/api';\nimport { CompositePropagator, W3CBaggagePropagator, W3CTraceContextPropagator } from '@opentelemetry/core';\nimport { registerInstrumentations } from '@opentelemetry/instrumentation';\nimport type { Instrumentation } from '@opentelemetry/instrumentation';\nimport { defaultResource, resourceFromAttributes } from '@opentelemetry/resources';\nimport { BatchSpanProcessor, BasicTracerProvider as ReactNativeTracerProvider } from '@opentelemetry/sdk-trace-base';\nimport type { BasicTracerProvider, ReadableSpan, Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { StackContextManager } from '@opentelemetry/sdk-trace-web';\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 { Faro, OTELApi, Transport } from '@grafana/faro-core';\n\nimport { FaroTraceExporter } from './exporters/faroTraceExporter';\nimport { getReactNativeDevServerIgnoreUrls } from './instrumentations/devServerIgnoreUrls';\nimport {\n  getDefaultOTELInstrumentations,\n  updateDefaultOTELInstrumentations,\n} 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\ntype FaroWithOtel = Faro & { otel?: unknown };\nconst detachedInstrumentations = new WeakSet<Instrumentation>();\n\n/**\n * Keeps a caller-supplied processor reusable across Faro remove/add cycles.\n * Explicit TracingInstrumentation.shutdown() remains responsible for the\n * processor's terminal shutdown.\n */\nclass BorrowedSpanProcessor implements SpanProcessor {\n  constructor(private readonly processor: SpanProcessor) {}\n\n  forceFlush(): Promise<void> {\n    return this.processor.forceFlush();\n  }\n\n  onStart(span: Span, parentContext: Context): void {\n    this.processor.onStart(span, parentContext);\n  }\n\n  onEnding(span: Span): void {\n    this.processor.onEnding?.(span);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    this.processor.onEnd(span);\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n\ninterface TracingRegistration {\n  contextManager?: ContextManager;\n  faro?: FaroWithOtel;\n  faroOtel?: OTELApi;\n  instrumentations: Instrumentation[];\n  ownsContextManager: boolean;\n  ownsContextManagerInstance: boolean;\n  ownsPropagator: boolean;\n  ownsTracerProvider: boolean;\n  previousFaroOtel?: unknown;\n  provider: BasicTracerProvider;\n  shutdownPromise?: Promise<void>;\n  unregisterInstrumentations?: VoidFunction;\n}\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 activeRegistration?: TracingRegistration;\n  private defaultInstrumentations?: Instrumentation[];\n  private pendingShutdowns = new Set<Promise<void>>();\n  private suppliedSpanProcessorShutdown?: Promise<void>;\n\n  constructor(private options: TracingInstrumentationOptions = {}) {\n    super();\n  }\n\n  initialize(): void {\n    this.destroy();\n\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    const 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 && new BorrowedSpanProcessor(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    const registration: TracingRegistration = {\n      instrumentations: [],\n      ownsContextManager: false,\n      ownsContextManagerInstance: false,\n      ownsPropagator: false,\n      ownsTracerProvider: false,\n      provider,\n    };\n    this.activeRegistration = registration;\n\n    try {\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      if (!trace.setGlobalTracerProvider(provider)) {\n        throw new Error(\n          'Unable to register the Faro OpenTelemetry tracer provider. Remove the existing global tracer provider before initializing Faro tracing.'\n        );\n      }\n      registration.ownsTracerProvider = true;\n\n      // Register a global ContextManager. Without one, OTel falls back to the NoopContextManager,\n      // which always returns ROOT_CONTEXT — so when `@opentelemetry/instrumentation-fetch` does\n      // `context.with(setSpan(active(), createdSpan), () => _addHeaders(...))` the span set on the\n      // wrapped context is invisible inside `_addHeaders` and `propagation.inject` writes nothing.\n      // `StackContextManager` is pure JS (no DOM/Zone deps) and works in React Native.\n      const contextManager = (options.contextManager ?? new StackContextManager()).enable();\n      registration.contextManager = contextManager;\n      registration.ownsContextManagerInstance = options.contextManager == null;\n      registration.ownsContextManager = context.setGlobalContextManager(contextManager);\n\n      // Register the global text-map propagator. Without this, OTel falls back to a\n      // NoopTextMapPropagator and `propagation.inject(...)` becomes a no-op, meaning\n      // `traceparent` / `tracestate` (and `baggage`) headers are never written on the\n      // outbound fetch/XHR — so the backend receives no context and starts a new trace.\n      registration.ownsPropagator = propagation.setGlobalPropagator(\n        options.propagator ??\n          new CompositePropagator({\n            propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()],\n          })\n      );\n\n      const {\n        enableFetchInstrumentation,\n        enableXhrInstrumentation,\n        propagateTraceHeaderCorsUrls,\n        fetchInstrumentationOptions,\n        xhrInstrumentationOptions,\n      } = this.options.instrumentationOptions ?? {};\n\n      // Get ignore URLs from transports to prevent infinite loops\n      const ignoreUrls = this.getIgnoreUrls();\n\n      const defaultInstrumentationOptions = {\n        ignoreUrls,\n        enableFetchInstrumentation,\n        enableXhrInstrumentation,\n        propagateTraceHeaderCorsUrls,\n        fetchInstrumentationOptions,\n        xhrInstrumentationOptions,\n      };\n\n      if (options.instrumentations) {\n        registration.instrumentations = options.instrumentations.flat();\n      } else if (this.defaultInstrumentations) {\n        updateDefaultOTELInstrumentations(this.defaultInstrumentations, defaultInstrumentationOptions);\n        registration.instrumentations = this.defaultInstrumentations;\n      } else {\n        this.defaultInstrumentations = getDefaultOTELInstrumentations(defaultInstrumentationOptions).flat();\n        registration.instrumentations = this.defaultInstrumentations;\n      }\n\n      const instrumentationsNeedingExplicitEnable = registration.instrumentations.filter(\n        (instrumentation) =>\n          detachedInstrumentations.has(instrumentation) && instrumentation.getConfig().enabled === true\n      );\n      registration.unregisterInstrumentations = registerInstrumentations({\n        instrumentations: registration.instrumentations,\n      });\n      registration.instrumentations.forEach((instrumentation) => {\n        detachedInstrumentations.delete(instrumentation);\n      });\n      instrumentationsNeedingExplicitEnable.forEach((instrumentation) => instrumentation.enable());\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() as FaroWithOtel | undefined;\n      if (globalFaroInstance) {\n        const faroOtel: OTELApi = { trace, context };\n        registration.faro = globalFaroInstance;\n        registration.faroOtel = faroOtel;\n        registration.previousFaroOtel = globalFaroInstance.otel;\n        globalFaroInstance.otel = faroOtel;\n      }\n    } catch (error) {\n      this.destroy();\n      throw error;\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 dev-server, original transport URLs, and regex patterns for maximum coverage.\n    return [...getReactNativeDevServerIgnoreUrls(), ...transportUrls, ...regexPatterns];\n  }\n\n  private detachRegistration(): TracingRegistration | undefined {\n    const registration = this.activeRegistration;\n    if (!registration) {\n      return undefined;\n    }\n    this.activeRegistration = undefined;\n    registration.instrumentations.forEach((instrumentation) => detachedInstrumentations.add(instrumentation));\n\n    let unregistered = false;\n    if (registration.unregisterInstrumentations) {\n      try {\n        registration.unregisterInstrumentations();\n        unregistered = true;\n      } catch (error) {\n        this.logCleanupError('unregister OpenTelemetry instrumentations', error);\n      }\n    }\n    if (!unregistered) {\n      registration.instrumentations.forEach((instrumentation) => {\n        this.runCleanup(`disable ${instrumentation.instrumentationName}`, () => instrumentation.disable());\n      });\n    }\n\n    const { faro, faroOtel } = registration;\n    if (faro && faroOtel && faro.otel === faroOtel) {\n      this.runCleanup('restore faro.otel', () => {\n        if (registration.previousFaroOtel === undefined) {\n          delete faro.otel;\n        } else {\n          faro.otel = registration.previousFaroOtel;\n        }\n      });\n    }\n\n    if (registration.ownsPropagator) {\n      this.runCleanup('clear the OpenTelemetry propagator', () => propagation.disable());\n    }\n    if (registration.ownsContextManager) {\n      this.runCleanup('clear the OpenTelemetry context manager', () => context.disable());\n    } else if (registration.ownsContextManagerInstance && registration.contextManager) {\n      this.runCleanup('disable the unused OpenTelemetry context manager', () => registration.contextManager?.disable());\n    }\n    if (registration.ownsTracerProvider) {\n      this.runCleanup('clear the OpenTelemetry tracer provider', () => trace.disable());\n    }\n\n    return registration;\n  }\n\n  private runCleanup(action: string, cleanup: VoidFunction): void {\n    try {\n      cleanup();\n    } catch (error) {\n      this.logCleanupError(action, error);\n    }\n  }\n\n  private logCleanupError(action: string, error: unknown): void {\n    try {\n      this.logError(`Failed to ${action}:`, error);\n    } catch (_loggingError) {\n      // Cleanup must not fail because a custom logger threw.\n    }\n  }\n\n  private startProviderShutdown(registration: TracingRegistration): Promise<void> {\n    if (!registration.shutdownPromise) {\n      const shutdownPromise = Promise.resolve()\n        .then(() => registration.provider.forceFlush())\n        .catch((error) => {\n          this.logCleanupError('flush the OpenTelemetry tracer provider', error);\n        })\n        .then(() => registration.provider.shutdown());\n      registration.shutdownPromise = shutdownPromise;\n      this.pendingShutdowns.add(shutdownPromise);\n      void shutdownPromise.then(\n        () => this.pendingShutdowns.delete(shutdownPromise),\n        () => this.pendingShutdowns.delete(shutdownPromise)\n      );\n    }\n    return registration.shutdownPromise;\n  }\n\n  private startSuppliedSpanProcessorShutdown(): Promise<void> | undefined {\n    const spanProcessor = this.options.spanProcessor;\n    if (!spanProcessor) {\n      return undefined;\n    }\n    if (!this.suppliedSpanProcessorShutdown) {\n      try {\n        this.suppliedSpanProcessorShutdown = spanProcessor.shutdown();\n      } catch (error) {\n        this.suppliedSpanProcessorShutdown = Promise.reject(error);\n      }\n    }\n    return this.suppliedSpanProcessorShutdown;\n  }\n\n  /** Detach request instrumentations and wait for the tracer provider to flush. */\n  async shutdown(): Promise<void> {\n    const pendingShutdowns = Array.from(this.pendingShutdowns);\n    const registration = this.detachRegistration();\n    if (registration) {\n      pendingShutdowns.push(this.startProviderShutdown(registration));\n    }\n\n    let firstError: unknown;\n    let shutdownFailed = false;\n    for (const shutdownPromise of pendingShutdowns) {\n      try {\n        await shutdownPromise;\n      } catch (error) {\n        if (!shutdownFailed) {\n          firstError = error;\n          shutdownFailed = true;\n        }\n      }\n    }\n    const spanProcessorShutdown = this.startSuppliedSpanProcessorShutdown();\n    if (spanProcessorShutdown) {\n      try {\n        await spanProcessorShutdown;\n      } catch (error) {\n        if (!shutdownFailed) {\n          firstError = error;\n          shutdownFailed = true;\n        }\n      }\n    }\n    if (shutdownFailed) {\n      throw firstError;\n    }\n  }\n\n  /** Detach synchronously when Faro removes this instrumentation. */\n  destroy(): void {\n    const registration = this.detachRegistration();\n    if (!registration) {\n      return;\n    }\n    void this.startProviderShutdown(registration).then(undefined, (error) => {\n      this.logCleanupError('shut down the OpenTelemetry tracer provider', error);\n    });\n  }\n}\n"]}