@opentelemetry/browser-instrumentation 0.1.0 → 0.3.0

package/dist/resource-timing/idle-callback-shim.js

@@ -0,0 +1,35 @@
+//#region src/resource-timing/idle-callback-shim.ts
+const IDLE_DEADLINE_MS = 50;
+const supportsIdleCallback = typeof window.requestIdleCallback === "function";
+/**
+* Schedules a callback during idle time, using the native requestIdleCallback
+* when available. Falls back to setTimeout with a synthetic IdleDeadline that
+* reports ~50ms of available time (per the W3C spec recommendation).
+*/
+function requestIdleCallbackShim(callback, options) {
+	if (supportsIdleCallback) return {
+		id: window.requestIdleCallback(callback, options),
+		native: true
+	};
+	return {
+		id: window.setTimeout(() => {
+			const start = performance.now();
+			callback({
+				didTimeout: false,
+				timeRemaining: () => Math.max(0, IDLE_DEADLINE_MS - (performance.now() - start))
+			});
+		}, 1),
+		native: false
+	};
+}
+/**
+* Cancels a previously scheduled idle callback.
+*/
+function cancelIdleCallbackShim(handle) {
+	if (handle.native) window.cancelIdleCallback(handle.id);
+	else clearTimeout(handle.id);
+}
+//#endregion
+export { cancelIdleCallbackShim, requestIdleCallbackShim };
+
+//# sourceMappingURL=idle-callback-shim.js.map

package/dist/resource-timing/idle-callback-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-callback-shim.js","names":[],"sources":["../../src/resource-timing/idle-callback-shim.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nconst IDLE_DEADLINE_MS = 50;\n\n// requestIdleCallback is not yet Baseline (not supported in Safari).\n// Feature-detect here so we can shim it below for unsupported browsers.\n// eslint-disable-next-line baseline-js/use-baseline\nconst supportsIdleCallback = typeof window.requestIdleCallback === 'function';\n\nexport interface IdleCallbackHandle {\n  id: number;\n  native: boolean;\n}\n\n/**\n * Schedules a callback during idle time, using the native requestIdleCallback\n * when available. Falls back to setTimeout with a synthetic IdleDeadline that\n * reports ~50ms of available time (per the W3C spec recommendation).\n */\nexport function requestIdleCallbackShim(\n  callback: IdleRequestCallback,\n  options?: IdleRequestOptions,\n): IdleCallbackHandle {\n  if (supportsIdleCallback) {\n    // requestIdleCallback is not yet Baseline (not supported in Safari).\n    // eslint-disable-next-line baseline-js/use-baseline\n    const id = window.requestIdleCallback(callback, options);\n    return { id, native: true };\n  }\n\n  const id = window.setTimeout(() => {\n    const start = performance.now();\n    callback({\n      didTimeout: false,\n      timeRemaining: () =>\n        Math.max(0, IDLE_DEADLINE_MS - (performance.now() - start)),\n    });\n  }, 1);\n  return { id, native: false };\n}\n\n/**\n * Cancels a previously scheduled idle callback.\n */\nexport function cancelIdleCallbackShim(handle: IdleCallbackHandle): void {\n  if (handle.native) {\n    // eslint-disable-next-line baseline-js/use-baseline\n    window.cancelIdleCallback(handle.id);\n  } else {\n    clearTimeout(handle.id);\n  }\n}\n"],"mappings":";AAKA,MAAM,mBAAmB;AAKzB,MAAM,uBAAuB,OAAO,OAAO,wBAAwB;;;;;;AAYnE,SAAgB,wBACd,UACA,SACoB;AACpB,KAAI,qBAIF,QAAO;EAAE,IADE,OAAO,oBAAoB,UAAU,QACrC;EAAE,QAAQ;EAAM;AAW7B,QAAO;EAAE,IARE,OAAO,iBAAiB;GACjC,MAAM,QAAQ,YAAY,KAAK;AAC/B,YAAS;IACP,YAAY;IACZ,qBACE,KAAK,IAAI,GAAG,oBAAoB,YAAY,KAAK,GAAG,OAAO;IAC9D,CAAC;KACD,EACQ;EAAE,QAAQ;EAAO;;;;;AAM9B,SAAgB,uBAAuB,QAAkC;AACvE,KAAI,OAAO,OAET,QAAO,mBAAmB,OAAO,GAAG;KAEpC,cAAa,OAAO,GAAG"}

package/dist/resource-timing/index.d.ts

@@ -0,0 +1,3 @@
+import { ResourceTimingInstrumentationConfig } from "./types.js";
+import { ResourceTimingInstrumentation } from "./instrumentation.js";
+export { ResourceTimingInstrumentation, type ResourceTimingInstrumentationConfig };

package/dist/resource-timing/index.js

@@ -0,0 +1,2 @@
+import { ResourceTimingInstrumentation } from "./instrumentation.js";
+export { ResourceTimingInstrumentation };

package/dist/resource-timing/instrumentation.d.ts

@@ -0,0 +1,33 @@
+import { ResourceTimingInstrumentationConfig } from "./types.js";
+import { InstrumentationBase } from "@opentelemetry/instrumentation";
+
+//#region src/resource-timing/instrumentation.d.ts
+/**
+ * OpenTelemetry instrumentation for resource timing for browser applications.
+ *
+ * This instrumentation captures resource timing data using PerformanceObserver
+ * and batches emissions to avoid overwhelming the main thread. It uses
+ * requestIdleCallback when available (with fallback for Safari) to ensure
+ * processing happens during idle periods.
+ */
+declare class ResourceTimingInstrumentation extends InstrumentationBase<ResourceTimingInstrumentationConfig> {
+  private _observer?;
+  private _pendingEntries;
+  private _idleHandle?;
+  private _isEnabled;
+  private _loadHandler;
+  private _visibilityChangeHandler;
+  constructor(config?: ResourceTimingInstrumentationConfig);
+  protected init(): never[];
+  enable(): void;
+  disable(): void;
+  private _setupObserver;
+  private _scheduleProcessing;
+  private _processChunk;
+  private _emitResource;
+  private _flush;
+  private _cancelScheduledProcessing;
+}
+//#endregion
+export { ResourceTimingInstrumentation };
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/resource-timing/instrumentation.js

@@ -0,0 +1,160 @@
+import { version } from "../package.js";
+import { cancelIdleCallbackShim, requestIdleCallbackShim } from "./idle-callback-shim.js";
+import { ATTR_RESOURCE_CONNECT_END, ATTR_RESOURCE_CONNECT_START, ATTR_RESOURCE_DECODED_BODY_SIZE, ATTR_RESOURCE_DOMAIN_LOOKUP_END, ATTR_RESOURCE_DOMAIN_LOOKUP_START, ATTR_RESOURCE_DURATION, ATTR_RESOURCE_ENCODED_BODY_SIZE, ATTR_RESOURCE_FETCH_START, ATTR_RESOURCE_INITIATOR_TYPE, ATTR_RESOURCE_NEXT_HOP_PROTOCOL, ATTR_RESOURCE_REDIRECT_END, ATTR_RESOURCE_REDIRECT_START, ATTR_RESOURCE_RENDER_BLOCKING_STATUS, ATTR_RESOURCE_REQUEST_START, ATTR_RESOURCE_RESPONSE_END, ATTR_RESOURCE_RESPONSE_START, ATTR_RESOURCE_SECURE_CONNECTION_START, ATTR_RESOURCE_TRANSFER_SIZE, ATTR_RESOURCE_URL, ATTR_RESOURCE_WORKER_START, RESOURCE_TIMING_EVENT_NAME } from "./semconv.js";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { InstrumentationBase } from "@opentelemetry/instrumentation";
+//#region src/resource-timing/instrumentation.ts
+const DEFAULT_BATCH_SIZE = 50;
+const DEFAULT_FORCE_PROCESSING_AFTER = 1e3;
+const DEFAULT_MAX_PROCESSING_TIME = 50;
+const DEFAULT_MAX_QUEUE_SIZE = 1e3;
+const MIN_BATCH_SIZE = 1;
+const MIN_FORCE_PROCESSING_AFTER = 0;
+const MIN_PROCESSING_TIME = 0;
+const MIN_QUEUE_SIZE = 1;
+/**
+* OpenTelemetry instrumentation for resource timing for browser applications.
+*
+* This instrumentation captures resource timing data using PerformanceObserver
+* and batches emissions to avoid overwhelming the main thread. It uses
+* requestIdleCallback when available (with fallback for Safari) to ensure
+* processing happens during idle periods.
+*/
+var ResourceTimingInstrumentation = class extends InstrumentationBase {
+	_observer;
+	_pendingEntries = [];
+	_idleHandle;
+	constructor(config = {}) {
+		super("@opentelemetry/browser-instrumentation/resource-timing", version, config);
+	}
+	init() {
+		return [];
+	}
+	enable() {
+		if (this._isEnabled) return;
+		if (!("PerformanceObserver" in window)) {
+			this._diag.debug("PerformanceObserver is not supported, resource timings will not be collected");
+			return;
+		}
+		this._isEnabled = true;
+		if (document.readyState === "complete") this._setupObserver();
+		else {
+			this._loadHandler = () => this._setupObserver();
+			window.addEventListener("load", this._loadHandler, { once: true });
+		}
+		this._visibilityChangeHandler = () => {
+			if (document.hidden) this._flush();
+		};
+		document.addEventListener("visibilitychange", this._visibilityChangeHandler);
+	}
+	disable() {
+		this._isEnabled = false;
+		this._flush();
+		this._observer?.disconnect();
+		this._observer = void 0;
+		if (this._loadHandler) {
+			window.removeEventListener("load", this._loadHandler);
+			this._loadHandler = void 0;
+		}
+		if (this._visibilityChangeHandler) {
+			document.removeEventListener("visibilitychange", this._visibilityChangeHandler);
+			this._visibilityChangeHandler = void 0;
+		}
+	}
+	_setupObserver() {
+		if (!this._isEnabled) return;
+		try {
+			const observer = new PerformanceObserver((list) => {
+				if (!this._isEnabled) return;
+				const maxQueueSize = Math.max(this._config.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE, MIN_QUEUE_SIZE);
+				const entries = list.getEntries();
+				const initiatorTypes = this._config.initiatorTypes;
+				for (const entry of entries) {
+					if (initiatorTypes !== void 0 && !initiatorTypes.includes(entry.initiatorType)) continue;
+					if (this._pendingEntries.length >= maxQueueSize) this._flush();
+					this._pendingEntries.push(entry);
+				}
+				if (this._pendingEntries.length > 0) this._scheduleProcessing();
+			});
+			this._observer = observer;
+			observer.observe({
+				type: "resource",
+				buffered: true
+			});
+		} catch {
+			this._diag.warn("PerformanceObserver not supported, resource timings will not be collected");
+		}
+	}
+	_scheduleProcessing() {
+		if (this._idleHandle !== void 0) return;
+		const timeout = Math.max(this._config.forceProcessingAfter ?? DEFAULT_FORCE_PROCESSING_AFTER, MIN_FORCE_PROCESSING_AFTER);
+		this._idleHandle = requestIdleCallbackShim((deadline) => this._processChunk(deadline), { timeout });
+	}
+	_processChunk(deadline) {
+		this._idleHandle = void 0;
+		if (!this._isEnabled || this._pendingEntries.length === 0) return;
+		const maxTime = Math.max(this._config.maxProcessingTime ?? DEFAULT_MAX_PROCESSING_TIME, MIN_PROCESSING_TIME);
+		const batchSize = Math.max(this._config.batchSize ?? DEFAULT_BATCH_SIZE, MIN_BATCH_SIZE);
+		const startTime = performance.now();
+		let cursor = 0;
+		try {
+			for (let i = 0; i < batchSize; i++) {
+				const entry = this._pendingEntries[cursor];
+				if (entry === void 0) break;
+				if (performance.now() - startTime >= maxTime || deadline.timeRemaining() < 1) break;
+				cursor++;
+				this._emitResource(entry);
+			}
+		} finally {
+			this._pendingEntries.splice(0, cursor);
+			if (this._pendingEntries.length > 0) this._scheduleProcessing();
+		}
+	}
+	_emitResource(entry) {
+		try {
+			this.logger.emit({
+				eventName: RESOURCE_TIMING_EVENT_NAME,
+				severityNumber: SeverityNumber.INFO,
+				attributes: {
+					[ATTR_RESOURCE_URL]: entry.name,
+					[ATTR_RESOURCE_INITIATOR_TYPE]: entry.initiatorType,
+					[ATTR_RESOURCE_DURATION]: entry.duration,
+					[ATTR_RESOURCE_FETCH_START]: entry.fetchStart,
+					[ATTR_RESOURCE_DOMAIN_LOOKUP_START]: entry.domainLookupStart,
+					[ATTR_RESOURCE_DOMAIN_LOOKUP_END]: entry.domainLookupEnd,
+					[ATTR_RESOURCE_CONNECT_START]: entry.connectStart,
+					[ATTR_RESOURCE_CONNECT_END]: entry.connectEnd,
+					[ATTR_RESOURCE_SECURE_CONNECTION_START]: entry.secureConnectionStart,
+					[ATTR_RESOURCE_REQUEST_START]: entry.requestStart,
+					[ATTR_RESOURCE_RESPONSE_START]: entry.responseStart,
+					[ATTR_RESOURCE_RESPONSE_END]: entry.responseEnd,
+					[ATTR_RESOURCE_TRANSFER_SIZE]: entry.transferSize,
+					[ATTR_RESOURCE_ENCODED_BODY_SIZE]: entry.encodedBodySize,
+					[ATTR_RESOURCE_DECODED_BODY_SIZE]: entry.decodedBodySize,
+					[ATTR_RESOURCE_REDIRECT_START]: entry.redirectStart,
+					[ATTR_RESOURCE_REDIRECT_END]: entry.redirectEnd,
+					[ATTR_RESOURCE_WORKER_START]: entry.workerStart,
+					[ATTR_RESOURCE_NEXT_HOP_PROTOCOL]: entry.nextHopProtocol,
+					[ATTR_RESOURCE_RENDER_BLOCKING_STATUS]: entry.renderBlockingStatus
+				}
+			});
+		} catch (error) {
+			this._diag.error(`Failed to emit resource timing entry for "${entry.name}"`, error);
+		}
+	}
+	_flush() {
+		this._cancelScheduledProcessing();
+		for (const entry of this._pendingEntries) this._emitResource(entry);
+		this._pendingEntries = [];
+	}
+	_cancelScheduledProcessing() {
+		if (this._idleHandle !== void 0) {
+			cancelIdleCallbackShim(this._idleHandle);
+			this._idleHandle = void 0;
+		}
+	}
+};
+//#endregion
+export { ResourceTimingInstrumentation };
+
+//# sourceMappingURL=instrumentation.js.map

package/dist/resource-timing/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/resource-timing/instrumentation.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { InstrumentationBase } from '@opentelemetry/instrumentation';\nimport { version } from '../../package.json' with { type: 'json' };\nimport type { IdleCallbackHandle } from './idle-callback-shim.ts';\nimport {\n  cancelIdleCallbackShim,\n  requestIdleCallbackShim,\n} from './idle-callback-shim.ts';\nimport {\n  ATTR_RESOURCE_CONNECT_END,\n  ATTR_RESOURCE_CONNECT_START,\n  ATTR_RESOURCE_DECODED_BODY_SIZE,\n  ATTR_RESOURCE_DOMAIN_LOOKUP_END,\n  ATTR_RESOURCE_DOMAIN_LOOKUP_START,\n  ATTR_RESOURCE_DURATION,\n  ATTR_RESOURCE_ENCODED_BODY_SIZE,\n  ATTR_RESOURCE_FETCH_START,\n  ATTR_RESOURCE_INITIATOR_TYPE,\n  ATTR_RESOURCE_NEXT_HOP_PROTOCOL,\n  ATTR_RESOURCE_REDIRECT_END,\n  ATTR_RESOURCE_REDIRECT_START,\n  ATTR_RESOURCE_RENDER_BLOCKING_STATUS,\n  ATTR_RESOURCE_REQUEST_START,\n  ATTR_RESOURCE_RESPONSE_END,\n  ATTR_RESOURCE_RESPONSE_START,\n  ATTR_RESOURCE_SECURE_CONNECTION_START,\n  ATTR_RESOURCE_TRANSFER_SIZE,\n  ATTR_RESOURCE_URL,\n  ATTR_RESOURCE_WORKER_START,\n  RESOURCE_TIMING_EVENT_NAME,\n} from './semconv.ts';\nimport type { ResourceTimingInstrumentationConfig } from './types.ts';\n\nconst DEFAULT_BATCH_SIZE = 50;\nconst DEFAULT_FORCE_PROCESSING_AFTER = 1000;\nconst DEFAULT_MAX_PROCESSING_TIME = 50;\nconst DEFAULT_MAX_QUEUE_SIZE = 1000;\n\nconst MIN_BATCH_SIZE = 1;\nconst MIN_FORCE_PROCESSING_AFTER = 0;\nconst MIN_PROCESSING_TIME = 0;\nconst MIN_QUEUE_SIZE = 1;\n\n/**\n * OpenTelemetry instrumentation for resource timing for browser applications.\n *\n * This instrumentation captures resource timing data using PerformanceObserver\n * and batches emissions to avoid overwhelming the main thread. It uses\n * requestIdleCallback when available (with fallback for Safari) to ensure\n * processing happens during idle periods.\n */\nexport class ResourceTimingInstrumentation extends InstrumentationBase<ResourceTimingInstrumentationConfig> {\n  private _observer?: PerformanceObserver;\n  private _pendingEntries: PerformanceResourceTiming[] = [];\n  private _idleHandle?: IdleCallbackHandle;\n\n  // Use `declare` to prevent JS class field initializers from running after\n  // super(), which would reset values set by the enable() call that\n  // InstrumentationBase makes during its constructor.\n  private declare _isEnabled: boolean;\n  private declare _loadHandler: (() => void) | undefined;\n  private declare _visibilityChangeHandler: (() => void) | undefined;\n\n  constructor(config: ResourceTimingInstrumentationConfig = {}) {\n    super(\n      '@opentelemetry/browser-instrumentation/resource-timing',\n      version,\n      config,\n    );\n  }\n\n  protected override init() {\n    return [];\n  }\n\n  override enable(): void {\n    if (this._isEnabled) {\n      return;\n    }\n\n    if (!('PerformanceObserver' in window)) {\n      this._diag.debug(\n        'PerformanceObserver is not supported, resource timings will not be collected',\n      );\n      return;\n    }\n\n    this._isEnabled = true;\n\n    if (document.readyState === 'complete') {\n      this._setupObserver();\n    } else {\n      this._loadHandler = () => this._setupObserver();\n      window.addEventListener('load', this._loadHandler, { once: true });\n    }\n\n    this._visibilityChangeHandler = () => {\n      if (document.hidden) {\n        this._flush();\n      }\n    };\n    document.addEventListener(\n      'visibilitychange',\n      this._visibilityChangeHandler,\n    );\n  }\n\n  override disable(): void {\n    this._isEnabled = false;\n    this._flush();\n    this._observer?.disconnect();\n    this._observer = undefined;\n    if (this._loadHandler) {\n      window.removeEventListener('load', this._loadHandler);\n      this._loadHandler = undefined;\n    }\n    if (this._visibilityChangeHandler) {\n      document.removeEventListener(\n        'visibilitychange',\n        this._visibilityChangeHandler,\n      );\n      this._visibilityChangeHandler = undefined;\n    }\n  }\n\n  private _setupObserver(): void {\n    if (!this._isEnabled) {\n      return;\n    }\n\n    try {\n      const observer = new PerformanceObserver((list) => {\n        if (!this._isEnabled) {\n          return;\n        }\n\n        const maxQueueSize = Math.max(\n          this._config.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE,\n          MIN_QUEUE_SIZE,\n        );\n        const entries = list.getEntries() as PerformanceResourceTiming[];\n        const initiatorTypes = this._config.initiatorTypes;\n\n        for (const entry of entries) {\n          if (\n            initiatorTypes !== undefined &&\n            !initiatorTypes.includes(entry.initiatorType)\n          ) {\n            continue;\n          }\n\n          if (this._pendingEntries.length >= maxQueueSize) {\n            this._flush();\n          }\n          this._pendingEntries.push(entry);\n        }\n\n        if (this._pendingEntries.length > 0) {\n          this._scheduleProcessing();\n        }\n      });\n\n      this._observer = observer;\n      observer.observe({ type: 'resource', buffered: true });\n    } catch {\n      this._diag.warn(\n        'PerformanceObserver not supported, resource timings will not be collected',\n      );\n    }\n  }\n\n  private _scheduleProcessing(): void {\n    if (this._idleHandle !== undefined) {\n      return;\n    }\n\n    const timeout = Math.max(\n      this._config.forceProcessingAfter ?? DEFAULT_FORCE_PROCESSING_AFTER,\n      MIN_FORCE_PROCESSING_AFTER,\n    );\n    this._idleHandle = requestIdleCallbackShim(\n      (deadline) => this._processChunk(deadline),\n      { timeout },\n    );\n  }\n\n  private _processChunk(deadline: IdleDeadline): void {\n    this._idleHandle = undefined;\n    if (!this._isEnabled || this._pendingEntries.length === 0) {\n      return;\n    }\n\n    const maxTime = Math.max(\n      this._config.maxProcessingTime ?? DEFAULT_MAX_PROCESSING_TIME,\n      MIN_PROCESSING_TIME,\n    );\n    const batchSize = Math.max(\n      this._config.batchSize ?? DEFAULT_BATCH_SIZE,\n      MIN_BATCH_SIZE,\n    );\n    const startTime = performance.now();\n\n    let cursor = 0;\n    try {\n      for (let i = 0; i < batchSize; i++) {\n        const entry = this._pendingEntries[cursor];\n        if (entry === undefined) {\n          break;\n        }\n\n        const elapsed = performance.now() - startTime;\n        // timeRemaining() is not Baseline widely available (no Safari support),\n        // compatibility is handled by idle-callback-shim.ts.\n        // eslint-disable-next-line baseline-js/use-baseline\n        if (elapsed >= maxTime || deadline.timeRemaining() < 1) {\n          break;\n        }\n\n        cursor++;\n        this._emitResource(entry);\n      }\n    } finally {\n      this._pendingEntries.splice(0, cursor);\n      if (this._pendingEntries.length > 0) {\n        this._scheduleProcessing();\n      }\n    }\n  }\n\n  private _emitResource(entry: PerformanceResourceTiming): void {\n    try {\n      this.logger.emit({\n        eventName: RESOURCE_TIMING_EVENT_NAME,\n        severityNumber: SeverityNumber.INFO,\n        attributes: {\n          [ATTR_RESOURCE_URL]: entry.name,\n          [ATTR_RESOURCE_INITIATOR_TYPE]: entry.initiatorType,\n          [ATTR_RESOURCE_DURATION]: entry.duration,\n          [ATTR_RESOURCE_FETCH_START]: entry.fetchStart,\n          [ATTR_RESOURCE_DOMAIN_LOOKUP_START]: entry.domainLookupStart,\n          [ATTR_RESOURCE_DOMAIN_LOOKUP_END]: entry.domainLookupEnd,\n          [ATTR_RESOURCE_CONNECT_START]: entry.connectStart,\n          [ATTR_RESOURCE_CONNECT_END]: entry.connectEnd,\n          [ATTR_RESOURCE_SECURE_CONNECTION_START]: entry.secureConnectionStart,\n          [ATTR_RESOURCE_REQUEST_START]: entry.requestStart,\n          [ATTR_RESOURCE_RESPONSE_START]: entry.responseStart,\n          [ATTR_RESOURCE_RESPONSE_END]: entry.responseEnd,\n          [ATTR_RESOURCE_TRANSFER_SIZE]: entry.transferSize,\n          [ATTR_RESOURCE_ENCODED_BODY_SIZE]: entry.encodedBodySize,\n          [ATTR_RESOURCE_DECODED_BODY_SIZE]: entry.decodedBodySize,\n          [ATTR_RESOURCE_REDIRECT_START]: entry.redirectStart,\n          [ATTR_RESOURCE_REDIRECT_END]: entry.redirectEnd,\n          [ATTR_RESOURCE_WORKER_START]: entry.workerStart,\n          [ATTR_RESOURCE_NEXT_HOP_PROTOCOL]: entry.nextHopProtocol,\n          // @ts-expect-error renderBlockingStatus is only available in Chromium as of March 2026\n          [ATTR_RESOURCE_RENDER_BLOCKING_STATUS]: entry.renderBlockingStatus,\n        },\n      });\n    } catch (error) {\n      this._diag.error(\n        `Failed to emit resource timing entry for \"${entry.name}\"`,\n        error,\n      );\n    }\n  }\n\n  private _flush(): void {\n    this._cancelScheduledProcessing();\n\n    for (const entry of this._pendingEntries) {\n      this._emitResource(entry);\n    }\n    this._pendingEntries = [];\n  }\n\n  private _cancelScheduledProcessing(): void {\n    if (this._idleHandle !== undefined) {\n      cancelIdleCallbackShim(this._idleHandle);\n      this._idleHandle = undefined;\n    }\n  }\n}\n"],"mappings":";;;;;;AAsCA,MAAM,qBAAqB;AAC3B,MAAM,iCAAiC;AACvC,MAAM,8BAA8B;AACpC,MAAM,yBAAyB;AAE/B,MAAM,iBAAiB;AACvB,MAAM,6BAA6B;AACnC,MAAM,sBAAsB;AAC5B,MAAM,iBAAiB;;;;;;;;;AAUvB,IAAa,gCAAb,cAAmD,oBAAyD;CAC1G;CACA,kBAAuD,EAAE;CACzD;CASA,YAAY,SAA8C,EAAE,EAAE;AAC5D,QACE,0DACA,SACA,OACD;;CAGH,OAA0B;AACxB,SAAO,EAAE;;CAGX,SAAwB;AACtB,MAAI,KAAK,WACP;AAGF,MAAI,EAAE,yBAAyB,SAAS;AACtC,QAAK,MAAM,MACT,+EACD;AACD;;AAGF,OAAK,aAAa;AAElB,MAAI,SAAS,eAAe,WAC1B,MAAK,gBAAgB;OAChB;AACL,QAAK,qBAAqB,KAAK,gBAAgB;AAC/C,UAAO,iBAAiB,QAAQ,KAAK,cAAc,EAAE,MAAM,MAAM,CAAC;;AAGpE,OAAK,iCAAiC;AACpC,OAAI,SAAS,OACX,MAAK,QAAQ;;AAGjB,WAAS,iBACP,oBACA,KAAK,yBACN;;CAGH,UAAyB;AACvB,OAAK,aAAa;AAClB,OAAK,QAAQ;AACb,OAAK,WAAW,YAAY;AAC5B,OAAK,YAAY,KAAA;AACjB,MAAI,KAAK,cAAc;AACrB,UAAO,oBAAoB,QAAQ,KAAK,aAAa;AACrD,QAAK,eAAe,KAAA;;AAEtB,MAAI,KAAK,0BAA0B;AACjC,YAAS,oBACP,oBACA,KAAK,yBACN;AACD,QAAK,2BAA2B,KAAA;;;CAIpC,iBAA+B;AAC7B,MAAI,CAAC,KAAK,WACR;AAGF,MAAI;GACF,MAAM,WAAW,IAAI,qBAAqB,SAAS;AACjD,QAAI,CAAC,KAAK,WACR;IAGF,MAAM,eAAe,KAAK,IACxB,KAAK,QAAQ,gBAAgB,wBAC7B,eACD;IACD,MAAM,UAAU,KAAK,YAAY;IACjC,MAAM,iBAAiB,KAAK,QAAQ;AAEpC,SAAK,MAAM,SAAS,SAAS;AAC3B,SACE,mBAAmB,KAAA,KACnB,CAAC,eAAe,SAAS,MAAM,cAAc,CAE7C;AAGF,SAAI,KAAK,gBAAgB,UAAU,aACjC,MAAK,QAAQ;AAEf,UAAK,gBAAgB,KAAK,MAAM;;AAGlC,QAAI,KAAK,gBAAgB,SAAS,EAChC,MAAK,qBAAqB;KAE5B;AAEF,QAAK,YAAY;AACjB,YAAS,QAAQ;IAAE,MAAM;IAAY,UAAU;IAAM,CAAC;UAChD;AACN,QAAK,MAAM,KACT,4EACD;;;CAIL,sBAAoC;AAClC,MAAI,KAAK,gBAAgB,KAAA,EACvB;EAGF,MAAM,UAAU,KAAK,IACnB,KAAK,QAAQ,wBAAwB,gCACrC,2BACD;AACD,OAAK,cAAc,yBAChB,aAAa,KAAK,cAAc,SAAS,EAC1C,EAAE,SAAS,CACZ;;CAGH,cAAsB,UAA8B;AAClD,OAAK,cAAc,KAAA;AACnB,MAAI,CAAC,KAAK,cAAc,KAAK,gBAAgB,WAAW,EACtD;EAGF,MAAM,UAAU,KAAK,IACnB,KAAK,QAAQ,qBAAqB,6BAClC,oBACD;EACD,MAAM,YAAY,KAAK,IACrB,KAAK,QAAQ,aAAa,oBAC1B,eACD;EACD,MAAM,YAAY,YAAY,KAAK;EAEnC,IAAI,SAAS;AACb,MAAI;AACF,QAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;IAClC,MAAM,QAAQ,KAAK,gBAAgB;AACnC,QAAI,UAAU,KAAA,EACZ;AAOF,QAJgB,YAAY,KAAK,GAAG,aAIrB,WAAW,SAAS,eAAe,GAAG,EACnD;AAGF;AACA,SAAK,cAAc,MAAM;;YAEnB;AACR,QAAK,gBAAgB,OAAO,GAAG,OAAO;AACtC,OAAI,KAAK,gBAAgB,SAAS,EAChC,MAAK,qBAAqB;;;CAKhC,cAAsB,OAAwC;AAC5D,MAAI;AACF,QAAK,OAAO,KAAK;IACf,WAAW;IACX,gBAAgB,eAAe;IAC/B,YAAY;MACT,oBAAoB,MAAM;MAC1B,+BAA+B,MAAM;MACrC,yBAAyB,MAAM;MAC/B,4BAA4B,MAAM;MAClC,oCAAoC,MAAM;MAC1C,kCAAkC,MAAM;MACxC,8BAA8B,MAAM;MACpC,4BAA4B,MAAM;MAClC,wCAAwC,MAAM;MAC9C,8BAA8B,MAAM;MACpC,+BAA+B,MAAM;MACrC,6BAA6B,MAAM;MACnC,8BAA8B,MAAM;MACpC,kCAAkC,MAAM;MACxC,kCAAkC,MAAM;MACxC,+BAA+B,MAAM;MACrC,6BAA6B,MAAM;MACnC,6BAA6B,MAAM;MACnC,kCAAkC,MAAM;MAExC,uCAAuC,MAAM;KAC/C;IACF,CAAC;WACK,OAAO;AACd,QAAK,MAAM,MACT,6CAA6C,MAAM,KAAK,IACxD,MACD;;;CAIL,SAAuB;AACrB,OAAK,4BAA4B;AAEjC,OAAK,MAAM,SAAS,KAAK,gBACvB,MAAK,cAAc,MAAM;AAE3B,OAAK,kBAAkB,EAAE;;CAG3B,6BAA2C;AACzC,MAAI,KAAK,gBAAgB,KAAA,GAAW;AAClC,0BAAuB,KAAK,YAAY;AACxC,QAAK,cAAc,KAAA"}

package/dist/resource-timing/semconv.js

@@ -0,0 +1,131 @@
+//#region src/resource-timing/semconv.ts
+/**
+* Event name for resource timing
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const RESOURCE_TIMING_EVENT_NAME = "browser.resource_timing";
+/**
+* The URL of the resource
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_URL = "url.full";
+/**
+* The type of resource (script, stylesheet, img, xmlhttprequest, fetch, etc.)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_INITIATOR_TYPE = "browser.resource_timing.initiator_type";
+/**
+* Total duration of the resource load (in milliseconds)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_DURATION = "browser.resource_timing.duration";
+/**
+* Start time of the resource fetch (relative to navigation start)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_FETCH_START = "browser.resource_timing.fetch_start";
+/**
+* Domain lookup start time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_DOMAIN_LOOKUP_START = "browser.resource_timing.domain_lookup_start";
+/**
+* Domain lookup end time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_DOMAIN_LOOKUP_END = "browser.resource_timing.domain_lookup_end";
+/**
+* Connection start time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_CONNECT_START = "browser.resource_timing.connect_start";
+/**
+* Connection end time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_CONNECT_END = "browser.resource_timing.connect_end";
+/**
+* Secure connection start time (HTTPS)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_SECURE_CONNECTION_START = "browser.resource_timing.secure_connection_start";
+/**
+* Request start time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_REQUEST_START = "browser.resource_timing.request_start";
+/**
+* Response start time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_RESPONSE_START = "browser.resource_timing.response_start";
+/**
+* Response end time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_RESPONSE_END = "browser.resource_timing.response_end";
+/**
+* Transfer size in bytes (including headers)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_TRANSFER_SIZE = "browser.resource_timing.transfer_size";
+/**
+* Encoded body size in bytes (compressed)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_ENCODED_BODY_SIZE = "browser.resource_timing.encoded_body_size";
+/**
+* Decoded body size in bytes (uncompressed)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_DECODED_BODY_SIZE = "browser.resource_timing.decoded_body_size";
+/**
+* Redirect start time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_REDIRECT_START = "browser.resource_timing.redirect_start";
+/**
+* Redirect end time
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_REDIRECT_END = "browser.resource_timing.redirect_end";
+/**
+* Worker start time (for Service Worker interception)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_WORKER_START = "browser.resource_timing.worker_start";
+/**
+* Next hop protocol (h2, h3, http/1.1, etc.)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_NEXT_HOP_PROTOCOL = "browser.resource_timing.next_hop_protocol";
+/**
+* Render blocking status (blocking, non-blocking)
+*
+* @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+*/
+const ATTR_RESOURCE_RENDER_BLOCKING_STATUS = "browser.resource_timing.render_blocking_status";
+//#endregion
+export { ATTR_RESOURCE_CONNECT_END, ATTR_RESOURCE_CONNECT_START, ATTR_RESOURCE_DECODED_BODY_SIZE, ATTR_RESOURCE_DOMAIN_LOOKUP_END, ATTR_RESOURCE_DOMAIN_LOOKUP_START, ATTR_RESOURCE_DURATION, ATTR_RESOURCE_ENCODED_BODY_SIZE, ATTR_RESOURCE_FETCH_START, ATTR_RESOURCE_INITIATOR_TYPE, ATTR_RESOURCE_NEXT_HOP_PROTOCOL, ATTR_RESOURCE_REDIRECT_END, ATTR_RESOURCE_REDIRECT_START, ATTR_RESOURCE_RENDER_BLOCKING_STATUS, ATTR_RESOURCE_REQUEST_START, ATTR_RESOURCE_RESPONSE_END, ATTR_RESOURCE_RESPONSE_START, ATTR_RESOURCE_SECURE_CONNECTION_START, ATTR_RESOURCE_TRANSFER_SIZE, ATTR_RESOURCE_URL, ATTR_RESOURCE_WORKER_START, RESOURCE_TIMING_EVENT_NAME };
+
+//# sourceMappingURL=semconv.js.map

package/dist/resource-timing/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","names":[],"sources":["../../src/resource-timing/semconv.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/*\n * This file contains a copy of unstable semantic convention definitions\n * used by this package.\n * @see https://github.com/open-telemetry/opentelemetry-js/tree/main/semantic-conventions#unstable-semconv\n */\n\n/**\n * Event name for resource timing\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const RESOURCE_TIMING_EVENT_NAME = 'browser.resource_timing';\n\n// Resource timing attributes\n\n/**\n * The URL of the resource\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_URL = 'url.full';\n\n/**\n * The type of resource (script, stylesheet, img, xmlhttprequest, fetch, etc.)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_INITIATOR_TYPE =\n  'browser.resource_timing.initiator_type';\n\n/**\n * Total duration of the resource load (in milliseconds)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_DURATION = 'browser.resource_timing.duration';\n\n/**\n * Start time of the resource fetch (relative to navigation start)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_FETCH_START = 'browser.resource_timing.fetch_start';\n\n/**\n * Domain lookup start time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_DOMAIN_LOOKUP_START =\n  'browser.resource_timing.domain_lookup_start';\n\n/**\n * Domain lookup end time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_DOMAIN_LOOKUP_END =\n  'browser.resource_timing.domain_lookup_end';\n\n/**\n * Connection start time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_CONNECT_START =\n  'browser.resource_timing.connect_start';\n\n/**\n * Connection end time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_CONNECT_END = 'browser.resource_timing.connect_end';\n\n/**\n * Secure connection start time (HTTPS)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_SECURE_CONNECTION_START =\n  'browser.resource_timing.secure_connection_start';\n\n/**\n * Request start time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_REQUEST_START =\n  'browser.resource_timing.request_start';\n\n/**\n * Response start time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_RESPONSE_START =\n  'browser.resource_timing.response_start';\n\n/**\n * Response end time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_RESPONSE_END =\n  'browser.resource_timing.response_end';\n\n/**\n * Transfer size in bytes (including headers)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_TRANSFER_SIZE =\n  'browser.resource_timing.transfer_size';\n\n/**\n * Encoded body size in bytes (compressed)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_ENCODED_BODY_SIZE =\n  'browser.resource_timing.encoded_body_size';\n\n/**\n * Decoded body size in bytes (uncompressed)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_DECODED_BODY_SIZE =\n  'browser.resource_timing.decoded_body_size';\n\n/**\n * Redirect start time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_REDIRECT_START =\n  'browser.resource_timing.redirect_start';\n\n/**\n * Redirect end time\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_REDIRECT_END =\n  'browser.resource_timing.redirect_end';\n\n/**\n * Worker start time (for Service Worker interception)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_WORKER_START =\n  'browser.resource_timing.worker_start';\n\n/**\n * Next hop protocol (h2, h3, http/1.1, etc.)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_NEXT_HOP_PROTOCOL =\n  'browser.resource_timing.next_hop_protocol';\n\n/**\n * Render blocking status (blocking, non-blocking)\n *\n * @experimental This attribute is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.\n */\nexport const ATTR_RESOURCE_RENDER_BLOCKING_STATUS =\n  'browser.resource_timing.render_blocking_status';\n"],"mappings":";;;;;;AAgBA,MAAa,6BAA6B;;;;;;AAS1C,MAAa,oBAAoB;;;;;;AAOjC,MAAa,+BACX;;;;;;AAOF,MAAa,yBAAyB;;;;;;AAOtC,MAAa,4BAA4B;;;;;;AAOzC,MAAa,oCACX;;;;;;AAOF,MAAa,kCACX;;;;;;AAOF,MAAa,8BACX;;;;;;AAOF,MAAa,4BAA4B;;;;;;AAOzC,MAAa,wCACX;;;;;;AAOF,MAAa,8BACX;;;;;;AAOF,MAAa,+BACX;;;;;;AAOF,MAAa,6BACX;;;;;;AAOF,MAAa,8BACX;;;;;;AAOF,MAAa,kCACX;;;;;;AAOF,MAAa,kCACX;;;;;;AAOF,MAAa,+BACX;;;;;;AAOF,MAAa,6BACX;;;;;;AAOF,MAAa,6BACX;;;;;;AAOF,MAAa,kCACX;;;;;;AAOF,MAAa,uCACX"}

package/dist/resource-timing/types.d.ts

@@ -0,0 +1,38 @@
+import { InstrumentationConfig } from "@opentelemetry/instrumentation";
+
+//#region src/resource-timing/types.d.ts
+/**
+ * ResourceTimingInstrumentation Configuration
+ */
+interface ResourceTimingInstrumentationConfig extends InstrumentationConfig {
+  /**
+   * Number of resources to process per batch.
+   * Default: 50
+   */
+  batchSize?: number;
+  /**
+   * Maximum time in milliseconds to wait for an idle callback before forcing processing.
+   * Default: 1000
+   */
+  forceProcessingAfter?: number;
+  /**
+   * Maximum time in milliseconds to spend processing resources per idle callback.
+   * Default: 50
+   */
+  maxProcessingTime?: number;
+  /**
+   * Maximum number of resources to queue before forcing immediate flush.
+   * Default: 1000
+   */
+  maxQueueSize?: number;
+  /**
+   * Filter which resource types to capture by their initiator type
+   * (e.g. 'xmlhttprequest', 'fetch', 'script', 'link', 'img', 'css', etc.).
+   * When set, only entries whose initiatorType matches one of the listed values
+   * are captured. When unset, all resource entries are captured.
+   */
+  initiatorTypes?: string[];
+}
+//#endregion
+export { ResourceTimingInstrumentationConfig };
+//# sourceMappingURL=types.d.ts.map

package/dist/user-action/index.d.ts

@@ -1,2 +1,3 @@
+import { UserActionInstrumentationConfig } from "./types.js";
 import { UserActionInstrumentation } from "./instrumentation.js";
-export { UserActionInstrumentation };
+export { UserActionInstrumentation, type UserActionInstrumentationConfig };

package/dist/user-action/instrumentation.js

@@ -1,4 +1,5 @@
-import { getElementCSSSelector } from "../web-utils/dist/getElementCSSSelector.js";
+import { version } from "../package.js";
+import { getElementCSSSelector } from "../utils/getElementCSSSelector.js";
 import { ATTR_CSS_SELECTOR, ATTR_MOUSE_EVENT_BUTTON, ATTR_PAGE_X, ATTR_PAGE_Y, ATTR_TAGS, ATTR_TAG_NAME, CLICK_EVENT_NAME } from "./semconv.js";
 import { SeverityNumber } from "@opentelemetry/api-logs";
 import { InstrumentationBase } from "@opentelemetry/instrumentation";
@@ -10,7 +11,7 @@ const OTEL_ELEMENT_ATTRIBUTE_PREFIX = "data-otel-";
 */
 var UserActionInstrumentation = class extends InstrumentationBase {
 	constructor(config = {}) {
-		super("@opentelemetry/instrumentation-user-action", "0.1.0", config);
+		super("@opentelemetry/browser-instrumentation/user-action", version, config);
 	}
 	init() {
 		return [];

package/dist/user-action/instrumentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/user-action/instrumentation.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { InstrumentationBase } from '@opentelemetry/instrumentation';\nimport { getElementCSSSelector } from '@opentelemetry/web-utils';\nimport {\n  ATTR_CSS_SELECTOR,\n  ATTR_MOUSE_EVENT_BUTTON,\n  ATTR_PAGE_X,\n  ATTR_PAGE_Y,\n  ATTR_TAG_NAME,\n  ATTR_TAGS,\n  CLICK_EVENT_NAME,\n} from './semconv.ts';\nimport type {\n  AutoCapturedUserAction,\n  MouseButton,\n  UserActionInstrumentationConfig,\n} from './types.ts';\n\nconst DEFAULT_AUTO_CAPTURED_ACTIONS: AutoCapturedUserAction[] = ['click'];\nconst OTEL_ELEMENT_ATTRIBUTE_PREFIX = 'data-otel-';\n\n/**\n * This class automatically instruments different User Actions within the browser.\n */\nexport class UserActionInstrumentation extends InstrumentationBase<UserActionInstrumentationConfig> {\n  private declare _onClickHandler?: (event: MouseEvent) => void;\n\n  constructor(config: UserActionInstrumentationConfig = {}) {\n    super('@opentelemetry/instrumentation-user-action', '0.1.0', config);\n  }\n\n  protected override init() {\n    return [];\n  }\n\n  private _getMouseButtonFromMouseEvent(event: MouseEvent): MouseButton {\n    switch (event.button) {\n      case 0:\n        return 'left';\n      case 1:\n        return 'middle';\n      case 2:\n        return 'right';\n      default:\n        return 'left';\n    }\n  }\n\n  private onClick(event: MouseEvent) {\n    const element = event.target;\n\n    if (!(element instanceof HTMLElement)) {\n      return;\n    }\n\n    if (element.hasAttribute('disabled')) {\n      return;\n    }\n\n    const cssSelector = getElementCSSSelector(element, {\n      useIdForTargetElement: true,\n      useIdForAncestors: true,\n    });\n    const otelPrefixedAttributes: Record<string, string> = {};\n\n    // Grab all the attributes in the element that start with data-otel-*\n    for (const attr of element.attributes) {\n      if (attr.name.startsWith(OTEL_ELEMENT_ATTRIBUTE_PREFIX)) {\n        otelPrefixedAttributes[\n          attr.name.slice(OTEL_ELEMENT_ATTRIBUTE_PREFIX.length)\n        ] = attr.value;\n      }\n    }\n\n    this.logger.emit({\n      severityNumber: SeverityNumber.INFO,\n      eventName: CLICK_EVENT_NAME,\n      attributes: {\n        [ATTR_PAGE_X]: event.pageX,\n        [ATTR_PAGE_Y]: event.pageY,\n        [ATTR_TAG_NAME]: element.tagName,\n        [ATTR_TAGS]: otelPrefixedAttributes,\n        [ATTR_MOUSE_EVENT_BUTTON]: this._getMouseButtonFromMouseEvent(event),\n        [ATTR_CSS_SELECTOR]: cssSelector,\n      },\n    });\n  }\n\n  override enable(): void {\n    const autoCapturedActions =\n      this._config.autoCapturedActions ?? DEFAULT_AUTO_CAPTURED_ACTIONS;\n    if (!this._onClickHandler) {\n      this._onClickHandler = this.onClick.bind(this);\n    }\n\n    if (autoCapturedActions.includes('click')) {\n      document.addEventListener('click', this._onClickHandler, true);\n    }\n  }\n\n  override disable(): void {\n    if (this._onClickHandler) {\n      document.removeEventListener('click', this._onClickHandler, true);\n    }\n  }\n}\n"],"mappings":";;;;;AAuBA,MAAM,gCAA0D,CAAC,QAAQ;AACzE,MAAM,gCAAgC;;;;AAKtC,IAAa,4BAAb,cAA+C,oBAAqD;CAGlG,YAAY,SAA0C,EAAE,EAAE;AACxD,QAAM,8CAA8C,SAAS,OAAO;;CAGtE,OAA0B;AACxB,SAAO,EAAE;;CAGX,8BAAsC,OAAgC;AACpE,UAAQ,MAAM,QAAd;GACE,KAAK,EACH,QAAO;GACT,KAAK,EACH,QAAO;GACT,KAAK,EACH,QAAO;GACT,QACE,QAAO;;;CAIb,QAAgB,OAAmB;EACjC,MAAM,UAAU,MAAM;AAEtB,MAAI,EAAE,mBAAmB,aACvB;AAGF,MAAI,QAAQ,aAAa,WAAW,CAClC;EAGF,MAAM,cAAc,sBAAsB,SAAS;GACjD,uBAAuB;GACvB,mBAAmB;GACpB,CAAC;EACF,MAAM,yBAAiD,EAAE;AAGzD,OAAK,MAAM,QAAQ,QAAQ,WACzB,KAAI,KAAK,KAAK,WAAW,8BAA8B,CACrD,wBACE,KAAK,KAAK,MAAM,GAAqC,IACnD,KAAK;AAIb,OAAK,OAAO,KAAK;GACf,gBAAgB,eAAe;GAC/B,WAAW;GACX,YAAY;KACT,cAAc,MAAM;KACpB,cAAc,MAAM;KACpB,gBAAgB,QAAQ;KACxB,YAAY;KACZ,0BAA0B,KAAK,8BAA8B,MAAM;KACnE,oBAAoB;IACtB;GACF,CAAC;;CAGJ,SAAwB;EACtB,MAAM,sBACJ,KAAK,QAAQ,uBAAuB;AACtC,MAAI,CAAC,KAAK,gBACR,MAAK,kBAAkB,KAAK,QAAQ,KAAK,KAAK;AAGhD,MAAI,oBAAoB,SAAS,QAAQ,CACvC,UAAS,iBAAiB,SAAS,KAAK,iBAAiB,KAAK;;CAIlE,UAAyB;AACvB,MAAI,KAAK,gBACP,UAAS,oBAAoB,SAAS,KAAK,iBAAiB,KAAK"}
+{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/user-action/instrumentation.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { InstrumentationBase } from '@opentelemetry/instrumentation';\nimport { getElementCSSSelector } from '#instrumentation-utils';\nimport { version } from '../../package.json' with { type: 'json' };\nimport {\n  ATTR_CSS_SELECTOR,\n  ATTR_MOUSE_EVENT_BUTTON,\n  ATTR_PAGE_X,\n  ATTR_PAGE_Y,\n  ATTR_TAG_NAME,\n  ATTR_TAGS,\n  CLICK_EVENT_NAME,\n} from './semconv.ts';\nimport type {\n  AutoCapturedUserAction,\n  MouseButton,\n  UserActionInstrumentationConfig,\n} from './types.ts';\n\nconst DEFAULT_AUTO_CAPTURED_ACTIONS: AutoCapturedUserAction[] = ['click'];\nconst OTEL_ELEMENT_ATTRIBUTE_PREFIX = 'data-otel-';\n\n/**\n * This class automatically instruments different User Actions within the browser.\n */\nexport class UserActionInstrumentation extends InstrumentationBase<UserActionInstrumentationConfig> {\n  private declare _onClickHandler?: (event: MouseEvent) => void;\n\n  constructor(config: UserActionInstrumentationConfig = {}) {\n    super(\n      '@opentelemetry/browser-instrumentation/user-action',\n      version,\n      config,\n    );\n  }\n\n  protected override init() {\n    return [];\n  }\n\n  private _getMouseButtonFromMouseEvent(event: MouseEvent): MouseButton {\n    switch (event.button) {\n      case 0:\n        return 'left';\n      case 1:\n        return 'middle';\n      case 2:\n        return 'right';\n      default:\n        return 'left';\n    }\n  }\n\n  private onClick(event: MouseEvent) {\n    const element = event.target;\n\n    if (!(element instanceof HTMLElement)) {\n      return;\n    }\n\n    if (element.hasAttribute('disabled')) {\n      return;\n    }\n\n    const cssSelector = getElementCSSSelector(element, {\n      useIdForTargetElement: true,\n      useIdForAncestors: true,\n    });\n    const otelPrefixedAttributes: Record<string, string> = {};\n\n    // Grab all the attributes in the element that start with data-otel-*\n    for (const attr of element.attributes) {\n      if (attr.name.startsWith(OTEL_ELEMENT_ATTRIBUTE_PREFIX)) {\n        otelPrefixedAttributes[\n          attr.name.slice(OTEL_ELEMENT_ATTRIBUTE_PREFIX.length)\n        ] = attr.value;\n      }\n    }\n\n    this.logger.emit({\n      severityNumber: SeverityNumber.INFO,\n      eventName: CLICK_EVENT_NAME,\n      attributes: {\n        [ATTR_PAGE_X]: event.pageX,\n        [ATTR_PAGE_Y]: event.pageY,\n        [ATTR_TAG_NAME]: element.tagName,\n        [ATTR_TAGS]: otelPrefixedAttributes,\n        [ATTR_MOUSE_EVENT_BUTTON]: this._getMouseButtonFromMouseEvent(event),\n        [ATTR_CSS_SELECTOR]: cssSelector,\n      },\n    });\n  }\n\n  override enable(): void {\n    const autoCapturedActions =\n      this._config.autoCapturedActions ?? DEFAULT_AUTO_CAPTURED_ACTIONS;\n    if (!this._onClickHandler) {\n      this._onClickHandler = this.onClick.bind(this);\n    }\n\n    if (autoCapturedActions.includes('click')) {\n      document.addEventListener('click', this._onClickHandler, true);\n    }\n  }\n\n  override disable(): void {\n    if (this._onClickHandler) {\n      document.removeEventListener('click', this._onClickHandler, true);\n    }\n  }\n}\n"],"mappings":";;;;;;AAwBA,MAAM,gCAA0D,CAAC,QAAQ;AACzE,MAAM,gCAAgC;;;;AAKtC,IAAa,4BAAb,cAA+C,oBAAqD;CAGlG,YAAY,SAA0C,EAAE,EAAE;AACxD,QACE,sDACA,SACA,OACD;;CAGH,OAA0B;AACxB,SAAO,EAAE;;CAGX,8BAAsC,OAAgC;AACpE,UAAQ,MAAM,QAAd;GACE,KAAK,EACH,QAAO;GACT,KAAK,EACH,QAAO;GACT,KAAK,EACH,QAAO;GACT,QACE,QAAO;;;CAIb,QAAgB,OAAmB;EACjC,MAAM,UAAU,MAAM;AAEtB,MAAI,EAAE,mBAAmB,aACvB;AAGF,MAAI,QAAQ,aAAa,WAAW,CAClC;EAGF,MAAM,cAAc,sBAAsB,SAAS;GACjD,uBAAuB;GACvB,mBAAmB;GACpB,CAAC;EACF,MAAM,yBAAiD,EAAE;AAGzD,OAAK,MAAM,QAAQ,QAAQ,WACzB,KAAI,KAAK,KAAK,WAAW,8BAA8B,CACrD,wBACE,KAAK,KAAK,MAAM,GAAqC,IACnD,KAAK;AAIb,OAAK,OAAO,KAAK;GACf,gBAAgB,eAAe;GAC/B,WAAW;GACX,YAAY;KACT,cAAc,MAAM;KACpB,cAAc,MAAM;KACpB,gBAAgB,QAAQ;KACxB,YAAY;KACZ,0BAA0B,KAAK,8BAA8B,MAAM;KACnE,oBAAoB;IACtB;GACF,CAAC;;CAGJ,SAAwB;EACtB,MAAM,sBACJ,KAAK,QAAQ,uBAAuB;AACtC,MAAI,CAAC,KAAK,gBACR,MAAK,kBAAkB,KAAK,QAAQ,KAAK,KAAK;AAGhD,MAAI,oBAAoB,SAAS,QAAQ,CACvC,UAAS,iBAAiB,SAAS,KAAK,iBAAiB,KAAK;;CAIlE,UAAyB;AACvB,MAAI,KAAK,gBACP,UAAS,oBAAoB,SAAS,KAAK,iBAAiB,KAAK"}

package/dist/{web-utils/dist → utils}/getElementCSSSelector.js

@@ -1,4 +1,4 @@
-//#region ../web-utils/dist/getElementCSSSelector.js
+//#region src/utils/getElementCSSSelector.ts
 /**
 * Generates the CSS selector of a given element in the DOM tree.
 *

package/dist/utils/getElementCSSSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getElementCSSSelector.js","names":[],"sources":["../../src/utils/getElementCSSSelector.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\ntype GetElementCSSSelectorOptions = {\n  /**\n   * If true, the function will attempt to use element ID to create condensed CSS selector.\n   */\n  useIdForTargetElement?: boolean;\n  /**\n   * If true, the function will attempt to use element ID for all ancestor elements to create condensed CSS selector.\n   */\n  useIdForAncestors?: boolean;\n};\n\n/**\n * Generates the CSS selector of a given element in the DOM tree.\n *\n * @example #main > div:nth-child(2) > button.submit\n * @example #unique-id\n */\nexport const getElementCSSSelector = (\n  element: Node,\n  {\n    useIdForTargetElement = false,\n    useIdForAncestors = false,\n  }: GetElementCSSSelectorOptions = {},\n): string => {\n  // Handle document node\n  if (element.nodeType === Node.DOCUMENT_NODE) {\n    return '';\n  }\n\n  const htmlElement = element as HTMLElement;\n  const nodeValue = getNodeSelector(\n    htmlElement,\n    useIdForTargetElement || useIdForAncestors,\n  );\n\n  // If optimized and found an ID selector, stop recursion early\n  if (nodeValue.startsWith('#')) {\n    return nodeValue;\n  }\n\n  const parent = htmlElement.parentElement;\n  const parentSelector = parent\n    ? getElementCSSSelector(parent, {\n        useIdForAncestors,\n        useIdForTargetElement: false,\n      })\n    : '';\n\n  return parentSelector ? `${parentSelector} > ${nodeValue}` : nodeValue;\n};\n\nconst getNodeSelector = (element: Node, useElementId = false): string => {\n  if (element.nodeType !== Node.ELEMENT_NODE) {\n    return '';\n  }\n\n  const htmlElement = element as HTMLElement;\n  const id = htmlElement.getAttribute('id');\n\n  // Use ID if requested and it's unique\n  if (useElementId && id) {\n    // Check if ID is unique in the document\n    const elementsWithSameId = htmlElement.ownerDocument.querySelectorAll(\n      `#${CSS.escape(id)}`,\n    );\n\n    if (elementsWithSameId.length === 1) {\n      return `#${CSS.escape(id)}`;\n    }\n  }\n\n  let selector = getFullClassSelector(htmlElement);\n  // Add nth-child if there are siblings with the same tag and classes\n  const index = getNthChild(htmlElement);\n\n  if (index > 0) {\n    selector += `:nth-child(${index})`;\n  }\n\n  return selector;\n};\n\nconst getNthChild = (element: HTMLElement): number => {\n  // parentElement is needed to access children\n  if (!element.parentElement) {\n    return 0;\n  }\n\n  const selector = getFullClassSelector(element);\n\n  // Get all siblings that match the same selector\n  const siblings = Array.from(element.parentElement.children).filter(\n    (sibling) => getFullClassSelector(sibling) === selector,\n  );\n\n  // Only add nth-child if there are multiple matching siblings\n  if (siblings.length > 1) {\n    return siblings.indexOf(element) + 1;\n  }\n\n  return 0;\n};\n\nconst getFullClassSelector = (element: Element): string =>\n  element.localName +\n  (element.classList.length > 0\n    ? Array.from(element.classList)\n        .map((cls) => `.${CSS.escape(cls)}`)\n        .join('')\n    : '');\n"],"mappings":";;;;;;;AAsBA,MAAa,yBACX,SACA,EACE,wBAAwB,OACxB,oBAAoB,UACY,EAAE,KACzB;AAEX,KAAI,QAAQ,aAAa,KAAK,cAC5B,QAAO;CAGT,MAAM,cAAc;CACpB,MAAM,YAAY,gBAChB,aACA,yBAAyB,kBAC1B;AAGD,KAAI,UAAU,WAAW,IAAI,CAC3B,QAAO;CAGT,MAAM,SAAS,YAAY;CAC3B,MAAM,iBAAiB,SACnB,sBAAsB,QAAQ;EAC5B;EACA,uBAAuB;EACxB,CAAC,GACF;AAEJ,QAAO,iBAAiB,GAAG,eAAe,KAAK,cAAc;;AAG/D,MAAM,mBAAmB,SAAe,eAAe,UAAkB;AACvE,KAAI,QAAQ,aAAa,KAAK,aAC5B,QAAO;CAGT,MAAM,cAAc;CACpB,MAAM,KAAK,YAAY,aAAa,KAAK;AAGzC,KAAI,gBAAgB;MAES,YAAY,cAAc,iBACnD,IAAI,IAAI,OAAO,GAAG,GAGE,CAAC,WAAW,EAChC,QAAO,IAAI,IAAI,OAAO,GAAG;;CAI7B,IAAI,WAAW,qBAAqB,YAAY;CAEhD,MAAM,QAAQ,YAAY,YAAY;AAEtC,KAAI,QAAQ,EACV,aAAY,cAAc,MAAM;AAGlC,QAAO;;AAGT,MAAM,eAAe,YAAiC;AAEpD,KAAI,CAAC,QAAQ,cACX,QAAO;CAGT,MAAM,WAAW,qBAAqB,QAAQ;CAG9C,MAAM,WAAW,MAAM,KAAK,QAAQ,cAAc,SAAS,CAAC,QACzD,YAAY,qBAAqB,QAAQ,KAAK,SAChD;AAGD,KAAI,SAAS,SAAS,EACpB,QAAO,SAAS,QAAQ,QAAQ,GAAG;AAGrC,QAAO;;AAGT,MAAM,wBAAwB,YAC5B,QAAQ,aACP,QAAQ,UAAU,SAAS,IACxB,MAAM,KAAK,QAAQ,UAAU,CAC1B,KAAK,QAAQ,IAAI,IAAI,OAAO,IAAI,GAAG,CACnC,KAAK,GAAG,GACX"}

package/dist/web-vitals/instrumentation.js

@@ -1,3 +1,4 @@
+import { version } from "../package.js";
 import { ATTR_WEB_VITAL_DELTA, ATTR_WEB_VITAL_ID, ATTR_WEB_VITAL_NAME, ATTR_WEB_VITAL_NAVIGATION_TYPE, ATTR_WEB_VITAL_RATING, ATTR_WEB_VITAL_VALUE, WEB_VITAL_EVENT_NAME } from "./semconv.js";
 import { SeverityNumber } from "@opentelemetry/api-logs";
 import { InstrumentationBase, safeExecuteInTheMiddle } from "@opentelemetry/instrumentation";
@@ -15,7 +16,7 @@ var WebVitalsInstrumentation = class extends InstrumentationBase {
 	_applyCustomLogRecordData;
 	_includeRawAttribution;
 	constructor(config = {}) {
-		super("@opentelemetry/instrumentation-web-vitals", "0.1.0", config);
+		super("@opentelemetry/browser-instrumentation/web-vitals", version, config);
 		this._applyCustomLogRecordData = config.applyCustomLogRecordData;
 		this._includeRawAttribution = config.includeRawAttribution ?? false;
 	}

package/dist/web-vitals/instrumentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/web-vitals/instrumentation.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Attributes } from '@opentelemetry/api';\nimport type { LogRecord } from '@opentelemetry/api-logs';\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport {\n  InstrumentationBase,\n  safeExecuteInTheMiddle,\n} from '@opentelemetry/instrumentation';\nimport type {\n  CLSMetricWithAttribution,\n  INPMetricWithAttribution,\n  MetricWithAttribution,\n} from 'web-vitals/attribution';\nimport { onCLS, onFCP, onINP, onLCP, onTTFB } from 'web-vitals/attribution';\nimport {\n  ATTR_WEB_VITAL_DELTA,\n  ATTR_WEB_VITAL_ID,\n  ATTR_WEB_VITAL_NAME,\n  ATTR_WEB_VITAL_NAVIGATION_TYPE,\n  ATTR_WEB_VITAL_RATING,\n  ATTR_WEB_VITAL_VALUE,\n  WEB_VITAL_EVENT_NAME,\n} from './semconv.ts';\nimport type { WebVitalsInstrumentationConfig } from './types.ts';\n\n/**\n * Instrumentation for Core Web Vitals using the `web-vitals` library.\n * https://github.com/GoogleChrome/web-vitals\n *\n * Note: The `web-vitals` library does not support removing listeners once\n * registered. Calling `disable()` will stop emitting logs, but the underlying\n * listeners remain active. Calling `enable()` again will resume emission.\n */\nexport class WebVitalsInstrumentation extends InstrumentationBase<WebVitalsInstrumentationConfig> {\n  // Using `declare` is required here: InstrumentationBase calls enable() during\n  // construction, and standard field initialization would reset this flag after\n  // super() returns, breaking the duplicate-registration guard.\n  private declare _isEnabled: boolean;\n  private declare _listenersRegistered: boolean;\n  private _applyCustomLogRecordData?: (logRecord: LogRecord) => void;\n  private _includeRawAttribution: boolean;\n\n  constructor(config: WebVitalsInstrumentationConfig = {}) {\n    super('@opentelemetry/instrumentation-web-vitals', '0.1.0', config);\n    this._applyCustomLogRecordData = config.applyCustomLogRecordData;\n    this._includeRawAttribution = config.includeRawAttribution ?? false;\n  }\n\n  protected override init() {\n    return [];\n  }\n\n  /**\n   * Enables the instrumentation and registers web-vitals listeners.\n   * Listeners are registered only once. If disabled, subsequent calls resume emission.\n   */\n  override enable(): void {\n    if (typeof PerformanceObserver === 'undefined') {\n      this._diag.debug(\n        'PerformanceObserver not supported, web vitals will not be collected',\n      );\n      return;\n    }\n\n    this._isEnabled = true;\n\n    if (this._listenersRegistered) {\n      this._diag.debug('Listeners already registered, resuming emission');\n      return;\n    }\n\n    this._listenersRegistered = true;\n    this._diag.debug(`Registering listeners`);\n    // CLS is only supported in Chromium. See:\n    // https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#browser-support\n    onCLS((metric) => this._emitWebVital(metric));\n    onINP((metric) => this._emitWebVital(metric));\n    onLCP((metric) => this._emitWebVital(metric));\n    onFCP((metric) => this._emitWebVital(metric));\n    onTTFB((metric) => this._emitWebVital(metric));\n  }\n\n  /**\n   * Disables the instrumentation, pausing log emission.\n   * Listeners remain active due to web-vitals library limitations.\n   */\n  override disable(): void {\n    this._isEnabled = false;\n    this._diag.debug('Instrumentation disabled, pausing emission');\n  }\n\n  /**\n   * Gets the timestamp for a metric based on attribution timing.\n   * Returns undefined to let OTel use the current time for metrics without\n   * specific timing information.\n   */\n  private _getTimestampForMetric(\n    metric: MetricWithAttribution,\n  ): number | undefined {\n    if (metric.name === 'CLS') {\n      const { attribution } = metric as CLSMetricWithAttribution;\n      if (attribution.largestShiftTime !== undefined) {\n        return attribution.largestShiftTime;\n      }\n      return undefined;\n    }\n    if (metric.name === 'INP') {\n      const { attribution } = metric as INPMetricWithAttribution;\n      return attribution.interactionTime;\n    }\n    // FCP, LCP, TTFB: metric.value is already DOMHighResTimeStamp of the event\n    return metric.value;\n  }\n\n  private _emitWebVital(metric: MetricWithAttribution): void {\n    if (!this._isEnabled) {\n      return;\n    }\n    const attributes: Attributes = {\n      [ATTR_WEB_VITAL_NAME]: metric.name.toLowerCase(),\n      [ATTR_WEB_VITAL_VALUE]: metric.value,\n      // `delta` equals `value` on the first emission; subsequent emissions report only the change\n      [ATTR_WEB_VITAL_DELTA]: metric.delta,\n      [ATTR_WEB_VITAL_RATING]: metric.rating,\n      [ATTR_WEB_VITAL_ID]: metric.id,\n      [ATTR_WEB_VITAL_NAVIGATION_TYPE]: metric.navigationType,\n    };\n\n    const timestamp = this._getTimestampForMetric(metric);\n\n    const logRecord: LogRecord = {\n      eventName: WEB_VITAL_EVENT_NAME,\n      severityNumber: SeverityNumber.INFO,\n      attributes,\n      ...(this._includeRawAttribution\n        ? { body: JSON.stringify(metric.attribution) }\n        : {}),\n      ...(timestamp !== undefined ? { timestamp } : {}),\n    };\n\n    if (this._applyCustomLogRecordData) {\n      safeExecuteInTheMiddle(\n        () => this._applyCustomLogRecordData?.(logRecord),\n        (error) => {\n          if (error) {\n            this._diag.error('applyCustomLogRecordData hook failed', error);\n          }\n        },\n        true,\n      );\n    }\n\n    this.logger.emit(logRecord);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAqCA,IAAa,2BAAb,cAA8C,oBAAoD;CAMhG;CACA;CAEA,YAAY,SAAyC,EAAE,EAAE;AACvD,QAAM,6CAA6C,SAAS,OAAO;AACnE,OAAK,4BAA4B,OAAO;AACxC,OAAK,yBAAyB,OAAO,yBAAyB;;CAGhE,OAA0B;AACxB,SAAO,EAAE;;;;;;CAOX,SAAwB;AACtB,MAAI,OAAO,wBAAwB,aAAa;AAC9C,QAAK,MAAM,MACT,sEACD;AACD;;AAGF,OAAK,aAAa;AAElB,MAAI,KAAK,sBAAsB;AAC7B,QAAK,MAAM,MAAM,kDAAkD;AACnE;;AAGF,OAAK,uBAAuB;AAC5B,OAAK,MAAM,MAAM,wBAAwB;AAGzC,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,UAAQ,WAAW,KAAK,cAAc,OAAO,CAAC;;;;;;CAOhD,UAAyB;AACvB,OAAK,aAAa;AAClB,OAAK,MAAM,MAAM,6CAA6C;;;;;;;CAQhE,uBACE,QACoB;AACpB,MAAI,OAAO,SAAS,OAAO;GACzB,MAAM,EAAE,gBAAgB;AACxB,OAAI,YAAY,qBAAqB,KAAA,EACnC,QAAO,YAAY;AAErB;;AAEF,MAAI,OAAO,SAAS,OAAO;GACzB,MAAM,EAAE,gBAAgB;AACxB,UAAO,YAAY;;AAGrB,SAAO,OAAO;;CAGhB,cAAsB,QAAqC;AACzD,MAAI,CAAC,KAAK,WACR;EAEF,MAAM,aAAyB;IAC5B,sBAAsB,OAAO,KAAK,aAAa;IAC/C,uBAAuB,OAAO;IAE9B,uBAAuB,OAAO;IAC9B,wBAAwB,OAAO;IAC/B,oBAAoB,OAAO;IAC3B,iCAAiC,OAAO;GAC1C;EAED,MAAM,YAAY,KAAK,uBAAuB,OAAO;EAErD,MAAM,YAAuB;GAC3B,WAAW;GACX,gBAAgB,eAAe;GAC/B;GACA,GAAI,KAAK,yBACL,EAAE,MAAM,KAAK,UAAU,OAAO,YAAY,EAAE,GAC5C,EAAE;GACN,GAAI,cAAc,KAAA,IAAY,EAAE,WAAW,GAAG,EAAE;GACjD;AAED,MAAI,KAAK,0BACP,8BACQ,KAAK,4BAA4B,UAAU,GAChD,UAAU;AACT,OAAI,MACF,MAAK,MAAM,MAAM,wCAAwC,MAAM;KAGnE,KACD;AAGH,OAAK,OAAO,KAAK,UAAU"}
+{"version":3,"file":"instrumentation.js","names":[],"sources":["../../src/web-vitals/instrumentation.ts"],"sourcesContent":["/*\n * Copyright The OpenTelemetry Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Attributes } from '@opentelemetry/api';\nimport type { LogRecord } from '@opentelemetry/api-logs';\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport {\n  InstrumentationBase,\n  safeExecuteInTheMiddle,\n} from '@opentelemetry/instrumentation';\nimport type {\n  CLSMetricWithAttribution,\n  INPMetricWithAttribution,\n  MetricWithAttribution,\n} from 'web-vitals/attribution';\nimport { onCLS, onFCP, onINP, onLCP, onTTFB } from 'web-vitals/attribution';\nimport { version } from '../../package.json' with { type: 'json' };\nimport {\n  ATTR_WEB_VITAL_DELTA,\n  ATTR_WEB_VITAL_ID,\n  ATTR_WEB_VITAL_NAME,\n  ATTR_WEB_VITAL_NAVIGATION_TYPE,\n  ATTR_WEB_VITAL_RATING,\n  ATTR_WEB_VITAL_VALUE,\n  WEB_VITAL_EVENT_NAME,\n} from './semconv.ts';\nimport type { WebVitalsInstrumentationConfig } from './types.ts';\n\n/**\n * Instrumentation for Core Web Vitals using the `web-vitals` library.\n * https://github.com/GoogleChrome/web-vitals\n *\n * Note: The `web-vitals` library does not support removing listeners once\n * registered. Calling `disable()` will stop emitting logs, but the underlying\n * listeners remain active. Calling `enable()` again will resume emission.\n */\nexport class WebVitalsInstrumentation extends InstrumentationBase<WebVitalsInstrumentationConfig> {\n  // Using `declare` is required here: InstrumentationBase calls enable() during\n  // construction, and standard field initialization would reset this flag after\n  // super() returns, breaking the duplicate-registration guard.\n  private declare _isEnabled: boolean;\n  private declare _listenersRegistered: boolean;\n  private _applyCustomLogRecordData?: (logRecord: LogRecord) => void;\n  private _includeRawAttribution: boolean;\n\n  constructor(config: WebVitalsInstrumentationConfig = {}) {\n    super('@opentelemetry/browser-instrumentation/web-vitals', version, config);\n    this._applyCustomLogRecordData = config.applyCustomLogRecordData;\n    this._includeRawAttribution = config.includeRawAttribution ?? false;\n  }\n\n  protected override init() {\n    return [];\n  }\n\n  /**\n   * Enables the instrumentation and registers web-vitals listeners.\n   * Listeners are registered only once. If disabled, subsequent calls resume emission.\n   */\n  override enable(): void {\n    if (typeof PerformanceObserver === 'undefined') {\n      this._diag.debug(\n        'PerformanceObserver not supported, web vitals will not be collected',\n      );\n      return;\n    }\n\n    this._isEnabled = true;\n\n    if (this._listenersRegistered) {\n      this._diag.debug('Listeners already registered, resuming emission');\n      return;\n    }\n\n    this._listenersRegistered = true;\n    this._diag.debug(`Registering listeners`);\n    // CLS is only supported in Chromium. See:\n    // https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#browser-support\n    onCLS((metric) => this._emitWebVital(metric));\n    onINP((metric) => this._emitWebVital(metric));\n    onLCP((metric) => this._emitWebVital(metric));\n    onFCP((metric) => this._emitWebVital(metric));\n    onTTFB((metric) => this._emitWebVital(metric));\n  }\n\n  /**\n   * Disables the instrumentation, pausing log emission.\n   * Listeners remain active due to web-vitals library limitations.\n   */\n  override disable(): void {\n    this._isEnabled = false;\n    this._diag.debug('Instrumentation disabled, pausing emission');\n  }\n\n  /**\n   * Gets the timestamp for a metric based on attribution timing.\n   * Returns undefined to let OTel use the current time for metrics without\n   * specific timing information.\n   */\n  private _getTimestampForMetric(\n    metric: MetricWithAttribution,\n  ): number | undefined {\n    if (metric.name === 'CLS') {\n      const { attribution } = metric as CLSMetricWithAttribution;\n      if (attribution.largestShiftTime !== undefined) {\n        return attribution.largestShiftTime;\n      }\n      return undefined;\n    }\n    if (metric.name === 'INP') {\n      const { attribution } = metric as INPMetricWithAttribution;\n      return attribution.interactionTime;\n    }\n    // FCP, LCP, TTFB: metric.value is already DOMHighResTimeStamp of the event\n    return metric.value;\n  }\n\n  private _emitWebVital(metric: MetricWithAttribution): void {\n    if (!this._isEnabled) {\n      return;\n    }\n    const attributes: Attributes = {\n      [ATTR_WEB_VITAL_NAME]: metric.name.toLowerCase(),\n      [ATTR_WEB_VITAL_VALUE]: metric.value,\n      // `delta` equals `value` on the first emission; subsequent emissions report only the change\n      [ATTR_WEB_VITAL_DELTA]: metric.delta,\n      [ATTR_WEB_VITAL_RATING]: metric.rating,\n      [ATTR_WEB_VITAL_ID]: metric.id,\n      [ATTR_WEB_VITAL_NAVIGATION_TYPE]: metric.navigationType,\n    };\n\n    const timestamp = this._getTimestampForMetric(metric);\n\n    const logRecord: LogRecord = {\n      eventName: WEB_VITAL_EVENT_NAME,\n      severityNumber: SeverityNumber.INFO,\n      attributes,\n      ...(this._includeRawAttribution\n        ? { body: JSON.stringify(metric.attribution) }\n        : {}),\n      ...(timestamp !== undefined ? { timestamp } : {}),\n    };\n\n    if (this._applyCustomLogRecordData) {\n      safeExecuteInTheMiddle(\n        () => this._applyCustomLogRecordData?.(logRecord),\n        (error) => {\n          if (error) {\n            this._diag.error('applyCustomLogRecordData hook failed', error);\n          }\n        },\n        true,\n      );\n    }\n\n    this.logger.emit(logRecord);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAsCA,IAAa,2BAAb,cAA8C,oBAAoD;CAMhG;CACA;CAEA,YAAY,SAAyC,EAAE,EAAE;AACvD,QAAM,qDAAqD,SAAS,OAAO;AAC3E,OAAK,4BAA4B,OAAO;AACxC,OAAK,yBAAyB,OAAO,yBAAyB;;CAGhE,OAA0B;AACxB,SAAO,EAAE;;;;;;CAOX,SAAwB;AACtB,MAAI,OAAO,wBAAwB,aAAa;AAC9C,QAAK,MAAM,MACT,sEACD;AACD;;AAGF,OAAK,aAAa;AAElB,MAAI,KAAK,sBAAsB;AAC7B,QAAK,MAAM,MAAM,kDAAkD;AACnE;;AAGF,OAAK,uBAAuB;AAC5B,OAAK,MAAM,MAAM,wBAAwB;AAGzC,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,SAAO,WAAW,KAAK,cAAc,OAAO,CAAC;AAC7C,UAAQ,WAAW,KAAK,cAAc,OAAO,CAAC;;;;;;CAOhD,UAAyB;AACvB,OAAK,aAAa;AAClB,OAAK,MAAM,MAAM,6CAA6C;;;;;;;CAQhE,uBACE,QACoB;AACpB,MAAI,OAAO,SAAS,OAAO;GACzB,MAAM,EAAE,gBAAgB;AACxB,OAAI,YAAY,qBAAqB,KAAA,EACnC,QAAO,YAAY;AAErB;;AAEF,MAAI,OAAO,SAAS,OAAO;GACzB,MAAM,EAAE,gBAAgB;AACxB,UAAO,YAAY;;AAGrB,SAAO,OAAO;;CAGhB,cAAsB,QAAqC;AACzD,MAAI,CAAC,KAAK,WACR;EAEF,MAAM,aAAyB;IAC5B,sBAAsB,OAAO,KAAK,aAAa;IAC/C,uBAAuB,OAAO;IAE9B,uBAAuB,OAAO;IAC9B,wBAAwB,OAAO;IAC/B,oBAAoB,OAAO;IAC3B,iCAAiC,OAAO;GAC1C;EAED,MAAM,YAAY,KAAK,uBAAuB,OAAO;EAErD,MAAM,YAAuB;GAC3B,WAAW;GACX,gBAAgB,eAAe;GAC/B;GACA,GAAI,KAAK,yBACL,EAAE,MAAM,KAAK,UAAU,OAAO,YAAY,EAAE,GAC5C,EAAE;GACN,GAAI,cAAc,KAAA,IAAY,EAAE,WAAW,GAAG,EAAE;GACjD;AAED,MAAI,KAAK,0BACP,8BACQ,KAAK,4BAA4B,UAAU,GAChD,UAAU;AACT,OAAI,MACF,MAAK,MAAM,MAAM,wCAAwC,MAAM;KAGnE,KACD;AAGH,OAAK,OAAO,KAAK,UAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentelemetry/browser-instrumentation",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "OpenTelemetry browser instrumentations.",
   "keywords": [
     "opentelemetry",
@@ -9,7 +9,8 @@
     "instrumentation",
     "navigation-timing",
     "user-action",
-    "web-vitals"
+    "web-vitals",
+    "resource-timing"
   ],
   "homepage": "https://github.com/open-telemetry/opentelemetry-browser",
   "bugs": "https://github.com/open-telemetry/opentelemetry-browser/issues",
@@ -21,10 +22,15 @@
     "directory": "packages/instrumentation"
   },
   "type": "module",
+  "imports": {
+    "#instrumentation-utils": "./src/utils/index.ts",
+    "#instrumentation-test-utils": "./src/test-utils/index.ts"
+  },
   "exports": {
     "./experimental/navigation-timing": "./dist/navigation-timing/index.js",
     "./experimental/user-action": "./dist/user-action/index.js",
-    "./experimental/web-vitals": "./dist/web-vitals/index.js"
+    "./experimental/web-vitals": "./dist/web-vitals/index.js",
+    "./experimental/resource-timing": "./dist/resource-timing/index.js"
   },
   "files": [
     "dist"
@@ -38,16 +44,15 @@
     "test:coverage": "vitest --coverage"
   },
   "dependencies": {
-    "@opentelemetry/api-logs": "^0.213.0",
-    "@opentelemetry/instrumentation": "^0.213.0",
-    "web-vitals": "^5.1.0"
+    "@opentelemetry/api-logs": "^0.215.0",
+    "@opentelemetry/instrumentation": "^0.215.0",
+    "web-vitals": "^5.2.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0"
   },
   "devDependencies": {
-    "@opentelemetry/test-utils": "*",
-    "@opentelemetry/web-utils": "*"
+    "@opentelemetry/sdk-logs": "^0.215.0"
   },
   "publishConfig": {
     "access": "public"