@loggerjs/browser 0.5.0 → 0.5.2

package/dist/service-worker-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-worker-integration.js","names":["record","message"],"sources":["../src/service-worker-integration.ts"],"sourcesContent":["import {\n  normalizeValue,\n  type Integration,\n  type IntegrationSetupContext,\n  type LoggerLevel,\n} from \"@loggerjs/core\";\n\nexport interface BrowserServiceWorkerControllerLike {\n  scriptURL?: string;\n  state?: string;\n}\n\nexport interface BrowserServiceWorkerContainerEventsLike {\n  controller?: BrowserServiceWorkerControllerLike | null;\n  addEventListener: (type: string, listener: EventListenerOrEventListenerObject) => void;\n  removeEventListener: (type: string, listener: EventListenerOrEventListenerObject) => void;\n}\n\nexport interface BrowserServiceWorkerMessagePayload {\n  dataType: string;\n  byteLength?: number;\n  data?: unknown;\n  origin?: string;\n  lastEventId?: string;\n}\n\nexport interface CaptureServiceWorkerOptions {\n  level?: LoggerLevel;\n  captureControllerChange?: boolean;\n  captureMessages?: boolean;\n  captureMessageErrors?: boolean;\n  captureMessageData?: boolean;\n  serviceWorker?: BrowserServiceWorkerContainerEventsLike;\n  sanitizeUrl?: (url: string) => string;\n}\n\nconst textEncoder = new TextEncoder();\n\nfunction dataType(data: unknown): string {\n  if (typeof data === \"string\") return \"string\";\n  if (data instanceof ArrayBuffer) return \"arraybuffer\";\n  if (ArrayBuffer.isView(data)) return data.constructor.name;\n  const record = data as { constructor?: { name?: string } } | undefined;\n  return record?.constructor?.name ?? typeof data;\n}\n\nfunction dataByteLength(data: unknown): number | undefined {\n  if (typeof data === \"string\") return textEncoder.encode(data).byteLength;\n  if (data instanceof ArrayBuffer) return data.byteLength;\n  if (ArrayBuffer.isView(data)) return data.byteLength;\n  const size = (data as { size?: unknown } | undefined)?.size;\n  return typeof size === \"number\" && Number.isFinite(size) ? size : undefined;\n}\n\nfunction controllerInfo(\n  controller: BrowserServiceWorkerControllerLike | null | undefined,\n  sanitizeUrl: ((url: string) => string) | undefined,\n) {\n  if (!controller) return undefined;\n  return {\n    scriptURL:\n      controller.scriptURL && sanitizeUrl\n        ? sanitizeUrl(controller.scriptURL)\n        : controller.scriptURL,\n    state: controller.state,\n  };\n}\n\nfunction messagePayload(\n  event: MessageEvent,\n  captureMessageData: boolean,\n): BrowserServiceWorkerMessagePayload {\n  return {\n    dataType: dataType(event.data),\n    byteLength: dataByteLength(event.data),\n    data: captureMessageData\n      ? normalizeValue(event.data, { maxDepth: 4, maxObjectKeys: 80 })\n      : undefined,\n    origin: event.origin,\n    lastEventId: event.lastEventId,\n  };\n}\n\nexport function captureServiceWorkerIntegration(\n  options: CaptureServiceWorkerOptions = {},\n): Integration {\n  const level = options.level ?? \"debug\";\n  const captureControllerChange = options.captureControllerChange ?? true;\n  const captureMessages = options.captureMessages ?? true;\n  const captureMessageErrors = options.captureMessageErrors ?? true;\n  const captureMessageData = options.captureMessageData ?? false;\n\n  return {\n    name: \"capture-service-worker\",\n    setup(api: IntegrationSetupContext) {\n      const serviceWorker =\n        options.serviceWorker ??\n        (typeof navigator === \"undefined\" ? undefined : navigator.serviceWorker);\n      if (!serviceWorker?.addEventListener || !serviceWorker.removeEventListener) return;\n      const disposers: Array<() => void> = [];\n      let disposed = false;\n\n      const capture = api.guard((input: Parameters<IntegrationSetupContext[\"capture\"]>[0]) => {\n        if (!disposed) api.capture(input);\n      });\n\n      if (captureControllerChange) {\n        const onControllerChange = () => {\n          capture({\n            level,\n            message: \"Service worker controller change\",\n            props: {\n              browser: {\n                kind: \"service-worker\",\n                event: \"controllerchange\",\n                controller: controllerInfo(serviceWorker.controller, options.sanitizeUrl),\n              },\n            },\n          });\n        };\n        serviceWorker.addEventListener(\"controllerchange\", onControllerChange);\n        disposers.push(() =>\n          serviceWorker.removeEventListener(\"controllerchange\", onControllerChange),\n        );\n      }\n\n      if (captureMessages) {\n        const onMessage = (event: Event) => {\n          const message = event as MessageEvent;\n          capture({\n            level,\n            message: \"Service worker message\",\n            props: {\n              browser: {\n                kind: \"service-worker\",\n                event: \"message\",\n                message: messagePayload(message, captureMessageData),\n              },\n            },\n          });\n        };\n        serviceWorker.addEventListener(\"message\", onMessage);\n        disposers.push(() => serviceWorker.removeEventListener(\"message\", onMessage));\n      }\n\n      if (captureMessageErrors) {\n        const onMessageError = (event: Event) => {\n          capture({\n            level: \"warn\",\n            message: \"Service worker message error\",\n            props: {\n              browser: {\n                kind: \"service-worker\",\n                event: \"messageerror\",\n                type: event.type,\n              },\n            },\n          });\n        };\n        serviceWorker.addEventListener(\"messageerror\", onMessageError);\n        disposers.push(() => serviceWorker.removeEventListener(\"messageerror\", onMessageError));\n      }\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        for (const dispose of disposers) dispose();\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/service-worker-transport.cjs

@@ -0,0 +1,184 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _loggerjs_core = require("@loggerjs/core");
+//#region src/service-worker-transport.ts
+let sourceSequence = 0;
+function createSourceId() {
+	sourceSequence += 1;
+	return `loggerjs-${Date.now().toString(36)}-${sourceSequence.toString(36)}`;
+}
+function defaultMapEvent(event, context) {
+	return {
+		type: "loggerjs.event",
+		source: context.source,
+		event
+	};
+}
+function defaultMapBatch(events, context) {
+	return {
+		type: "loggerjs.batch",
+		source: context.source,
+		events
+	};
+}
+function serviceWorkerContainer() {
+	return typeof navigator === "undefined" ? void 0 : navigator.serviceWorker;
+}
+function workerFromRegistration(registration) {
+	return registration.active ?? registration.waiting ?? registration.installing ?? void 0;
+}
+function browserServiceWorkerTransport(options = {}) {
+	const transportName = options.name ?? "browser-service-worker";
+	const target = options.target ?? "controller";
+	const source = options.source ?? createSourceId();
+	const maxQueueSize = options.maxQueueSize ?? 1e3;
+	const dropPolicy = options.dropPolicy ?? "drop-oldest";
+	const mapContext = {
+		source,
+		target
+	};
+	const mapEvent = options.mapEvent ?? defaultMapEvent;
+	const mapBatch = options.mapBatch ?? defaultMapBatch;
+	const queue = [];
+	let readyWorker;
+	let readyPromise;
+	let lastContext;
+	const reportError = (error, context, operation, droppedEvents = 0) => {
+		try {
+			options.onError?.(error, {
+				droppedEvents,
+				operation
+			});
+		} catch (onErrorError) {
+			context?.reportInternalError(onErrorError, {
+				operation: "on-error",
+				phase: "transport",
+				transport: transportName
+			});
+		}
+		context?.reportInternalError(error, {
+			operation,
+			phase: "transport",
+			transport: transportName
+		});
+	};
+	const reportDrop = (item, reason) => {
+		(0, _loggerjs_core.incrementLoggerMetaCounter)("transport.dropped", item.events.length);
+		(0, _loggerjs_core.incrementLoggerMetaCounter)(`transport.dropped.${reason}`, item.events.length);
+		for (const event of item.events) options.onDrop?.(event, reason);
+	};
+	const currentWorker = () => {
+		const container = options.serviceWorker ?? serviceWorkerContainer();
+		if (!container) return void 0;
+		if (target === "controller") return container.controller ?? void 0;
+		return readyWorker;
+	};
+	const post = (worker, item, context) => {
+		try {
+			worker.postMessage(item.message, options.transfer?.(item.message));
+			return true;
+		} catch (error) {
+			reportDrop(item, "post-message");
+			reportError(error, context, "post-message", item.events.length);
+			return false;
+		}
+	};
+	const drain = (context = lastContext) => {
+		const worker = currentWorker();
+		if (!worker || !context) return;
+		while (queue.length > 0) {
+			const item = queue.shift();
+			if (!item) return;
+			post(worker, item, context);
+		}
+	};
+	const dropQueued = (reason) => {
+		const pending = queue.splice(0);
+		for (const item of pending) reportDrop(item, reason);
+		return pending.reduce((total, item) => total + item.events.length, 0);
+	};
+	const waitForReady = (context) => {
+		if (currentWorker()) return Promise.resolve();
+		if (target !== "ready") return Promise.reject(/* @__PURE__ */ new Error("service worker controller is not available"));
+		if (readyPromise) return readyPromise;
+		const container = options.serviceWorker ?? serviceWorkerContainer();
+		if (!container?.ready) {
+			const error = /* @__PURE__ */ new Error("serviceWorker.ready is not available");
+			reportError(error, context, "ready", dropQueued("ready"));
+			return Promise.reject(error);
+		}
+		readyPromise = container.ready.then((registration) => {
+			readyWorker = workerFromRegistration(registration);
+			if (!readyWorker) throw new Error("service worker registration has no active worker");
+			drain(context ?? lastContext);
+		}).catch((error) => {
+			readyPromise = void 0;
+			const droppedEvents = dropQueued("ready");
+			reportError(error, context ?? lastContext, "ready", droppedEvents);
+			throw error;
+		});
+		return readyPromise;
+	};
+	const startReady = (context) => {
+		waitForReady(context).catch(() => {});
+	};
+	const enqueue = (item) => {
+		if (queue.length >= maxQueueSize) {
+			if (dropPolicy === "drop-newest") {
+				reportDrop(item, "queue-full");
+				return false;
+			}
+			const dropped = queue.shift();
+			if (dropped) reportDrop(dropped, "queue-full");
+		}
+		queue.push(item);
+		return true;
+	};
+	const send = (item, context) => {
+		lastContext = context;
+		const worker = currentWorker();
+		if (worker) {
+			post(worker, item, context);
+			return;
+		}
+		if (target === "ready") {
+			if (enqueue(item)) startReady(context);
+			return;
+		}
+		reportDrop(item, "unavailable");
+		reportError(/* @__PURE__ */ new Error("service worker controller is not available"), context, "unavailable", item.events.length);
+	};
+	return {
+		name: transportName,
+		minLevel: options.minLevel,
+		queueSize() {
+			return queue.length;
+		},
+		ready() {
+			return waitForReady();
+		},
+		log(event, context) {
+			send({
+				events: [event],
+				message: mapEvent(event, mapContext)
+			}, context);
+		},
+		logBatch(events, context) {
+			if (events.length === 0) return;
+			send({
+				events,
+				message: mapBatch(events, mapContext)
+			}, context);
+		},
+		flush() {
+			drain();
+		},
+		close() {
+			const pending = queue.splice(0);
+			for (const item of pending) reportDrop(item, "closed");
+		}
+	};
+}
+//#endregion
+exports.browserServiceWorkerTransport = browserServiceWorkerTransport;
+
+//# sourceMappingURL=service-worker-transport.cjs.map

package/dist/service-worker-transport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-worker-transport.cjs","names":[],"sources":["../src/service-worker-transport.ts"],"sourcesContent":["import {\n  incrementLoggerMetaCounter,\n  type LogEvent,\n  type LoggerLevel,\n  type Transport,\n  type TransportContext,\n} from \"@loggerjs/core\";\n\nexport type BrowserServiceWorkerDropPolicy = \"drop-oldest\" | \"drop-newest\";\nexport type BrowserServiceWorkerTarget = \"controller\" | \"ready\";\n\nexport interface BrowserServiceWorkerLike {\n  postMessage: (message: unknown, transfer?: Transferable[] | StructuredSerializeOptions) => void;\n}\n\nexport interface BrowserServiceWorkerRegistrationLike {\n  active?: BrowserServiceWorkerLike | null;\n  waiting?: BrowserServiceWorkerLike | null;\n  installing?: BrowserServiceWorkerLike | null;\n}\n\nexport interface BrowserServiceWorkerContainerLike {\n  controller?: BrowserServiceWorkerLike | null;\n  ready?: Promise<BrowserServiceWorkerRegistrationLike>;\n}\n\nexport interface BrowserServiceWorkerEventMessage {\n  type: \"loggerjs.event\";\n  source: string;\n  event: LogEvent;\n}\n\nexport interface BrowserServiceWorkerBatchMessage {\n  type: \"loggerjs.batch\";\n  source: string;\n  events: readonly LogEvent[];\n}\n\nexport type BrowserServiceWorkerMessage =\n  | BrowserServiceWorkerEventMessage\n  | BrowserServiceWorkerBatchMessage;\n\nexport interface BrowserServiceWorkerMapContext {\n  source: string;\n  target: BrowserServiceWorkerTarget;\n}\n\nexport interface BrowserServiceWorkerTransportOptions {\n  name?: string;\n  minLevel?: LoggerLevel;\n  source?: string;\n  target?: BrowserServiceWorkerTarget;\n  serviceWorker?: BrowserServiceWorkerContainerLike;\n  maxQueueSize?: number;\n  dropPolicy?: BrowserServiceWorkerDropPolicy;\n  transfer?: (message: unknown) => Transferable[] | StructuredSerializeOptions | undefined;\n  mapEvent?: (event: LogEvent, context: BrowserServiceWorkerMapContext) => unknown;\n  mapBatch?: (events: readonly LogEvent[], context: BrowserServiceWorkerMapContext) => unknown;\n  onDrop?: (event: LogEvent, reason: string) => void;\n  onError?: (error: unknown, detail: { operation: string; droppedEvents: number }) => void;\n}\n\ninterface QueueItem {\n  events: readonly LogEvent[];\n  message: unknown;\n}\n\nlet sourceSequence = 0;\n\nfunction createSourceId() {\n  sourceSequence += 1;\n  return `loggerjs-${Date.now().toString(36)}-${sourceSequence.toString(36)}`;\n}\n\nfunction defaultMapEvent(\n  event: LogEvent,\n  context: BrowserServiceWorkerMapContext,\n): BrowserServiceWorkerEventMessage {\n  return { type: \"loggerjs.event\", source: context.source, event };\n}\n\nfunction defaultMapBatch(\n  events: readonly LogEvent[],\n  context: BrowserServiceWorkerMapContext,\n): BrowserServiceWorkerBatchMessage {\n  return { type: \"loggerjs.batch\", source: context.source, events };\n}\n\nfunction serviceWorkerContainer(): BrowserServiceWorkerContainerLike | undefined {\n  return typeof navigator === \"undefined\"\n    ? undefined\n    : (navigator.serviceWorker as unknown as BrowserServiceWorkerContainerLike);\n}\n\nfunction workerFromRegistration(registration: BrowserServiceWorkerRegistrationLike) {\n  return registration.active ?? registration.waiting ?? registration.installing ?? undefined;\n}\n\nexport function browserServiceWorkerTransport(\n  options: BrowserServiceWorkerTransportOptions = {},\n): Transport & { queueSize: () => number } {\n  const transportName = options.name ?? \"browser-service-worker\";\n  const target = options.target ?? \"controller\";\n  const source = options.source ?? createSourceId();\n  const maxQueueSize = options.maxQueueSize ?? 1000;\n  const dropPolicy = options.dropPolicy ?? \"drop-oldest\";\n  const mapContext: BrowserServiceWorkerMapContext = { source, target };\n  const mapEvent = options.mapEvent ?? defaultMapEvent;\n  const mapBatch = options.mapBatch ?? defaultMapBatch;\n  const queue: QueueItem[] = [];\n  let readyWorker: BrowserServiceWorkerLike | undefined;\n  let readyPromise: Promise<void> | undefined;\n  let lastContext: TransportContext | undefined;\n\n  const reportError = (\n    error: unknown,\n    context: TransportContext | undefined,\n    operation: string,\n    droppedEvents = 0,\n  ) => {\n    try {\n      options.onError?.(error, { droppedEvents, operation });\n    } catch (onErrorError) {\n      context?.reportInternalError(onErrorError, {\n        operation: \"on-error\",\n        phase: \"transport\",\n        transport: transportName,\n      });\n    }\n    context?.reportInternalError(error, {\n      operation,\n      phase: \"transport\",\n      transport: transportName,\n    });\n  };\n\n  const reportDrop = (item: QueueItem, reason: string) => {\n    incrementLoggerMetaCounter(\"transport.dropped\", item.events.length);\n    incrementLoggerMetaCounter(`transport.dropped.${reason}`, item.events.length);\n    for (const event of item.events) options.onDrop?.(event, reason);\n  };\n\n  const currentWorker = () => {\n    const container = options.serviceWorker ?? serviceWorkerContainer();\n    if (!container) return undefined;\n    if (target === \"controller\") return container.controller ?? undefined;\n    return readyWorker;\n  };\n\n  const post = (worker: BrowserServiceWorkerLike, item: QueueItem, context: TransportContext) => {\n    try {\n      worker.postMessage(item.message, options.transfer?.(item.message));\n      return true;\n    } catch (error) {\n      reportDrop(item, \"post-message\");\n      reportError(error, context, \"post-message\", item.events.length);\n      return false;\n    }\n  };\n\n  const drain = (context = lastContext) => {\n    const worker = currentWorker();\n    if (!worker || !context) return;\n    while (queue.length > 0) {\n      const item = queue.shift();\n      if (!item) return;\n      post(worker, item, context);\n    }\n  };\n\n  const dropQueued = (reason: string) => {\n    const pending = queue.splice(0);\n    for (const item of pending) reportDrop(item, reason);\n    return pending.reduce((total, item) => total + item.events.length, 0);\n  };\n\n  const waitForReady = (context?: TransportContext) => {\n    const worker = currentWorker();\n    if (worker) return Promise.resolve();\n    if (target !== \"ready\") {\n      return Promise.reject(new Error(\"service worker controller is not available\"));\n    }\n    if (readyPromise) return readyPromise;\n    const container = options.serviceWorker ?? serviceWorkerContainer();\n    if (!container?.ready) {\n      const error = new Error(\"serviceWorker.ready is not available\");\n      const droppedEvents = dropQueued(\"ready\");\n      reportError(error, context, \"ready\", droppedEvents);\n      return Promise.reject(error);\n    }\n    readyPromise = container.ready\n      .then((registration) => {\n        readyWorker = workerFromRegistration(registration);\n        if (!readyWorker) {\n          throw new Error(\"service worker registration has no active worker\");\n        }\n        drain(context ?? lastContext);\n      })\n      .catch((error) => {\n        readyPromise = undefined;\n        const droppedEvents = dropQueued(\"ready\");\n        reportError(error, context ?? lastContext, \"ready\", droppedEvents);\n        throw error;\n      });\n    return readyPromise;\n  };\n\n  const startReady = (context: TransportContext) => {\n    void waitForReady(context).catch(() => {\n      // Errors are already reported through the transport context.\n    });\n  };\n\n  const enqueue = (item: QueueItem) => {\n    if (queue.length >= maxQueueSize) {\n      if (dropPolicy === \"drop-newest\") {\n        reportDrop(item, \"queue-full\");\n        return false;\n      }\n      const dropped = queue.shift();\n      if (dropped) reportDrop(dropped, \"queue-full\");\n    }\n    queue.push(item);\n    return true;\n  };\n\n  const send = (item: QueueItem, context: TransportContext) => {\n    lastContext = context;\n    const worker = currentWorker();\n    if (worker) {\n      post(worker, item, context);\n      return;\n    }\n    if (target === \"ready\") {\n      if (enqueue(item)) startReady(context);\n      return;\n    }\n    reportDrop(item, \"unavailable\");\n    reportError(\n      new Error(\"service worker controller is not available\"),\n      context,\n      \"unavailable\",\n      item.events.length,\n    );\n  };\n\n  return {\n    name: transportName,\n    minLevel: options.minLevel,\n    queueSize() {\n      return queue.length;\n    },\n    ready() {\n      return waitForReady();\n    },\n    log(event, context) {\n      send({ events: [event], message: mapEvent(event, mapContext) }, context);\n    },\n    logBatch(events, context) {\n      if (events.length === 0) return;\n      send({ events, message: mapBatch(events, mapContext) }, context);\n    },\n    flush() {\n      drain();\n    },\n    close() {\n      const pending = queue.splice(0);\n      for (const item of pending) reportDrop(item, \"closed\");\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/service-worker-transport.js

@@ -0,0 +1,183 @@
+import { incrementLoggerMetaCounter } from "@loggerjs/core";
+//#region src/service-worker-transport.ts
+let sourceSequence = 0;
+function createSourceId() {
+	sourceSequence += 1;
+	return `loggerjs-${Date.now().toString(36)}-${sourceSequence.toString(36)}`;
+}
+function defaultMapEvent(event, context) {
+	return {
+		type: "loggerjs.event",
+		source: context.source,
+		event
+	};
+}
+function defaultMapBatch(events, context) {
+	return {
+		type: "loggerjs.batch",
+		source: context.source,
+		events
+	};
+}
+function serviceWorkerContainer() {
+	return typeof navigator === "undefined" ? void 0 : navigator.serviceWorker;
+}
+function workerFromRegistration(registration) {
+	return registration.active ?? registration.waiting ?? registration.installing ?? void 0;
+}
+function browserServiceWorkerTransport(options = {}) {
+	const transportName = options.name ?? "browser-service-worker";
+	const target = options.target ?? "controller";
+	const source = options.source ?? createSourceId();
+	const maxQueueSize = options.maxQueueSize ?? 1e3;
+	const dropPolicy = options.dropPolicy ?? "drop-oldest";
+	const mapContext = {
+		source,
+		target
+	};
+	const mapEvent = options.mapEvent ?? defaultMapEvent;
+	const mapBatch = options.mapBatch ?? defaultMapBatch;
+	const queue = [];
+	let readyWorker;
+	let readyPromise;
+	let lastContext;
+	const reportError = (error, context, operation, droppedEvents = 0) => {
+		try {
+			options.onError?.(error, {
+				droppedEvents,
+				operation
+			});
+		} catch (onErrorError) {
+			context?.reportInternalError(onErrorError, {
+				operation: "on-error",
+				phase: "transport",
+				transport: transportName
+			});
+		}
+		context?.reportInternalError(error, {
+			operation,
+			phase: "transport",
+			transport: transportName
+		});
+	};
+	const reportDrop = (item, reason) => {
+		incrementLoggerMetaCounter("transport.dropped", item.events.length);
+		incrementLoggerMetaCounter(`transport.dropped.${reason}`, item.events.length);
+		for (const event of item.events) options.onDrop?.(event, reason);
+	};
+	const currentWorker = () => {
+		const container = options.serviceWorker ?? serviceWorkerContainer();
+		if (!container) return void 0;
+		if (target === "controller") return container.controller ?? void 0;
+		return readyWorker;
+	};
+	const post = (worker, item, context) => {
+		try {
+			worker.postMessage(item.message, options.transfer?.(item.message));
+			return true;
+		} catch (error) {
+			reportDrop(item, "post-message");
+			reportError(error, context, "post-message", item.events.length);
+			return false;
+		}
+	};
+	const drain = (context = lastContext) => {
+		const worker = currentWorker();
+		if (!worker || !context) return;
+		while (queue.length > 0) {
+			const item = queue.shift();
+			if (!item) return;
+			post(worker, item, context);
+		}
+	};
+	const dropQueued = (reason) => {
+		const pending = queue.splice(0);
+		for (const item of pending) reportDrop(item, reason);
+		return pending.reduce((total, item) => total + item.events.length, 0);
+	};
+	const waitForReady = (context) => {
+		if (currentWorker()) return Promise.resolve();
+		if (target !== "ready") return Promise.reject(/* @__PURE__ */ new Error("service worker controller is not available"));
+		if (readyPromise) return readyPromise;
+		const container = options.serviceWorker ?? serviceWorkerContainer();
+		if (!container?.ready) {
+			const error = /* @__PURE__ */ new Error("serviceWorker.ready is not available");
+			reportError(error, context, "ready", dropQueued("ready"));
+			return Promise.reject(error);
+		}
+		readyPromise = container.ready.then((registration) => {
+			readyWorker = workerFromRegistration(registration);
+			if (!readyWorker) throw new Error("service worker registration has no active worker");
+			drain(context ?? lastContext);
+		}).catch((error) => {
+			readyPromise = void 0;
+			const droppedEvents = dropQueued("ready");
+			reportError(error, context ?? lastContext, "ready", droppedEvents);
+			throw error;
+		});
+		return readyPromise;
+	};
+	const startReady = (context) => {
+		waitForReady(context).catch(() => {});
+	};
+	const enqueue = (item) => {
+		if (queue.length >= maxQueueSize) {
+			if (dropPolicy === "drop-newest") {
+				reportDrop(item, "queue-full");
+				return false;
+			}
+			const dropped = queue.shift();
+			if (dropped) reportDrop(dropped, "queue-full");
+		}
+		queue.push(item);
+		return true;
+	};
+	const send = (item, context) => {
+		lastContext = context;
+		const worker = currentWorker();
+		if (worker) {
+			post(worker, item, context);
+			return;
+		}
+		if (target === "ready") {
+			if (enqueue(item)) startReady(context);
+			return;
+		}
+		reportDrop(item, "unavailable");
+		reportError(/* @__PURE__ */ new Error("service worker controller is not available"), context, "unavailable", item.events.length);
+	};
+	return {
+		name: transportName,
+		minLevel: options.minLevel,
+		queueSize() {
+			return queue.length;
+		},
+		ready() {
+			return waitForReady();
+		},
+		log(event, context) {
+			send({
+				events: [event],
+				message: mapEvent(event, mapContext)
+			}, context);
+		},
+		logBatch(events, context) {
+			if (events.length === 0) return;
+			send({
+				events,
+				message: mapBatch(events, mapContext)
+			}, context);
+		},
+		flush() {
+			drain();
+		},
+		close() {
+			const pending = queue.splice(0);
+			for (const item of pending) reportDrop(item, "closed");
+		}
+	};
+}
+//#endregion
+export { browserServiceWorkerTransport };
+
+//# sourceMappingURL=service-worker-transport.js.map

package/dist/service-worker-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-worker-transport.js","names":[],"sources":["../src/service-worker-transport.ts"],"sourcesContent":["import {\n  incrementLoggerMetaCounter,\n  type LogEvent,\n  type LoggerLevel,\n  type Transport,\n  type TransportContext,\n} from \"@loggerjs/core\";\n\nexport type BrowserServiceWorkerDropPolicy = \"drop-oldest\" | \"drop-newest\";\nexport type BrowserServiceWorkerTarget = \"controller\" | \"ready\";\n\nexport interface BrowserServiceWorkerLike {\n  postMessage: (message: unknown, transfer?: Transferable[] | StructuredSerializeOptions) => void;\n}\n\nexport interface BrowserServiceWorkerRegistrationLike {\n  active?: BrowserServiceWorkerLike | null;\n  waiting?: BrowserServiceWorkerLike | null;\n  installing?: BrowserServiceWorkerLike | null;\n}\n\nexport interface BrowserServiceWorkerContainerLike {\n  controller?: BrowserServiceWorkerLike | null;\n  ready?: Promise<BrowserServiceWorkerRegistrationLike>;\n}\n\nexport interface BrowserServiceWorkerEventMessage {\n  type: \"loggerjs.event\";\n  source: string;\n  event: LogEvent;\n}\n\nexport interface BrowserServiceWorkerBatchMessage {\n  type: \"loggerjs.batch\";\n  source: string;\n  events: readonly LogEvent[];\n}\n\nexport type BrowserServiceWorkerMessage =\n  | BrowserServiceWorkerEventMessage\n  | BrowserServiceWorkerBatchMessage;\n\nexport interface BrowserServiceWorkerMapContext {\n  source: string;\n  target: BrowserServiceWorkerTarget;\n}\n\nexport interface BrowserServiceWorkerTransportOptions {\n  name?: string;\n  minLevel?: LoggerLevel;\n  source?: string;\n  target?: BrowserServiceWorkerTarget;\n  serviceWorker?: BrowserServiceWorkerContainerLike;\n  maxQueueSize?: number;\n  dropPolicy?: BrowserServiceWorkerDropPolicy;\n  transfer?: (message: unknown) => Transferable[] | StructuredSerializeOptions | undefined;\n  mapEvent?: (event: LogEvent, context: BrowserServiceWorkerMapContext) => unknown;\n  mapBatch?: (events: readonly LogEvent[], context: BrowserServiceWorkerMapContext) => unknown;\n  onDrop?: (event: LogEvent, reason: string) => void;\n  onError?: (error: unknown, detail: { operation: string; droppedEvents: number }) => void;\n}\n\ninterface QueueItem {\n  events: readonly LogEvent[];\n  message: unknown;\n}\n\nlet sourceSequence = 0;\n\nfunction createSourceId() {\n  sourceSequence += 1;\n  return `loggerjs-${Date.now().toString(36)}-${sourceSequence.toString(36)}`;\n}\n\nfunction defaultMapEvent(\n  event: LogEvent,\n  context: BrowserServiceWorkerMapContext,\n): BrowserServiceWorkerEventMessage {\n  return { type: \"loggerjs.event\", source: context.source, event };\n}\n\nfunction defaultMapBatch(\n  events: readonly LogEvent[],\n  context: BrowserServiceWorkerMapContext,\n): BrowserServiceWorkerBatchMessage {\n  return { type: \"loggerjs.batch\", source: context.source, events };\n}\n\nfunction serviceWorkerContainer(): BrowserServiceWorkerContainerLike | undefined {\n  return typeof navigator === \"undefined\"\n    ? undefined\n    : (navigator.serviceWorker as unknown as BrowserServiceWorkerContainerLike);\n}\n\nfunction workerFromRegistration(registration: BrowserServiceWorkerRegistrationLike) {\n  return registration.active ?? registration.waiting ?? registration.installing ?? undefined;\n}\n\nexport function browserServiceWorkerTransport(\n  options: BrowserServiceWorkerTransportOptions = {},\n): Transport & { queueSize: () => number } {\n  const transportName = options.name ?? \"browser-service-worker\";\n  const target = options.target ?? \"controller\";\n  const source = options.source ?? createSourceId();\n  const maxQueueSize = options.maxQueueSize ?? 1000;\n  const dropPolicy = options.dropPolicy ?? \"drop-oldest\";\n  const mapContext: BrowserServiceWorkerMapContext = { source, target };\n  const mapEvent = options.mapEvent ?? defaultMapEvent;\n  const mapBatch = options.mapBatch ?? defaultMapBatch;\n  const queue: QueueItem[] = [];\n  let readyWorker: BrowserServiceWorkerLike | undefined;\n  let readyPromise: Promise<void> | undefined;\n  let lastContext: TransportContext | undefined;\n\n  const reportError = (\n    error: unknown,\n    context: TransportContext | undefined,\n    operation: string,\n    droppedEvents = 0,\n  ) => {\n    try {\n      options.onError?.(error, { droppedEvents, operation });\n    } catch (onErrorError) {\n      context?.reportInternalError(onErrorError, {\n        operation: \"on-error\",\n        phase: \"transport\",\n        transport: transportName,\n      });\n    }\n    context?.reportInternalError(error, {\n      operation,\n      phase: \"transport\",\n      transport: transportName,\n    });\n  };\n\n  const reportDrop = (item: QueueItem, reason: string) => {\n    incrementLoggerMetaCounter(\"transport.dropped\", item.events.length);\n    incrementLoggerMetaCounter(`transport.dropped.${reason}`, item.events.length);\n    for (const event of item.events) options.onDrop?.(event, reason);\n  };\n\n  const currentWorker = () => {\n    const container = options.serviceWorker ?? serviceWorkerContainer();\n    if (!container) return undefined;\n    if (target === \"controller\") return container.controller ?? undefined;\n    return readyWorker;\n  };\n\n  const post = (worker: BrowserServiceWorkerLike, item: QueueItem, context: TransportContext) => {\n    try {\n      worker.postMessage(item.message, options.transfer?.(item.message));\n      return true;\n    } catch (error) {\n      reportDrop(item, \"post-message\");\n      reportError(error, context, \"post-message\", item.events.length);\n      return false;\n    }\n  };\n\n  const drain = (context = lastContext) => {\n    const worker = currentWorker();\n    if (!worker || !context) return;\n    while (queue.length > 0) {\n      const item = queue.shift();\n      if (!item) return;\n      post(worker, item, context);\n    }\n  };\n\n  const dropQueued = (reason: string) => {\n    const pending = queue.splice(0);\n    for (const item of pending) reportDrop(item, reason);\n    return pending.reduce((total, item) => total + item.events.length, 0);\n  };\n\n  const waitForReady = (context?: TransportContext) => {\n    const worker = currentWorker();\n    if (worker) return Promise.resolve();\n    if (target !== \"ready\") {\n      return Promise.reject(new Error(\"service worker controller is not available\"));\n    }\n    if (readyPromise) return readyPromise;\n    const container = options.serviceWorker ?? serviceWorkerContainer();\n    if (!container?.ready) {\n      const error = new Error(\"serviceWorker.ready is not available\");\n      const droppedEvents = dropQueued(\"ready\");\n      reportError(error, context, \"ready\", droppedEvents);\n      return Promise.reject(error);\n    }\n    readyPromise = container.ready\n      .then((registration) => {\n        readyWorker = workerFromRegistration(registration);\n        if (!readyWorker) {\n          throw new Error(\"service worker registration has no active worker\");\n        }\n        drain(context ?? lastContext);\n      })\n      .catch((error) => {\n        readyPromise = undefined;\n        const droppedEvents = dropQueued(\"ready\");\n        reportError(error, context ?? lastContext, \"ready\", droppedEvents);\n        throw error;\n      });\n    return readyPromise;\n  };\n\n  const startReady = (context: TransportContext) => {\n    void waitForReady(context).catch(() => {\n      // Errors are already reported through the transport context.\n    });\n  };\n\n  const enqueue = (item: QueueItem) => {\n    if (queue.length >= maxQueueSize) {\n      if (dropPolicy === \"drop-newest\") {\n        reportDrop(item, \"queue-full\");\n        return false;\n      }\n      const dropped = queue.shift();\n      if (dropped) reportDrop(dropped, \"queue-full\");\n    }\n    queue.push(item);\n    return true;\n  };\n\n  const send = (item: QueueItem, context: TransportContext) => {\n    lastContext = context;\n    const worker = currentWorker();\n    if (worker) {\n      post(worker, item, context);\n      return;\n    }\n    if (target === \"ready\") {\n      if (enqueue(item)) startReady(context);\n      return;\n    }\n    reportDrop(item, \"unavailable\");\n    reportError(\n      new Error(\"service worker controller is not available\"),\n      context,\n      \"unavailable\",\n      item.events.length,\n    );\n  };\n\n  return {\n    name: transportName,\n    minLevel: options.minLevel,\n    queueSize() {\n      return queue.length;\n    },\n    ready() {\n      return waitForReady();\n    },\n    log(event, context) {\n      send({ events: [event], message: mapEvent(event, mapContext) }, context);\n    },\n    logBatch(events, context) {\n      if (events.length === 0) return;\n      send({ events, message: mapBatch(events, mapContext) }, context);\n    },\n    flush() {\n      drain();\n    },\n    close() {\n      const pending = queue.splice(0);\n      for (const item of pending) reportDrop(item, \"closed\");\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/user-action-integration.cjs

@@ -0,0 +1,100 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/user-action-integration.ts
+const defaultEvents = [
+	"click",
+	"input",
+	"change",
+	"submit"
+];
+const defaultLabelAttributes = [
+	"data-loggerjs-label",
+	"aria-label",
+	"name",
+	"id"
+];
+function truncate(value, maxLength) {
+	if (!value) return void 0;
+	return value.length > maxLength ? value.slice(0, maxLength) : value;
+}
+function readAttribute(target, name) {
+	return target.getAttribute?.(name) || void 0;
+}
+function sanitizeField(value, field, sanitize) {
+	if (!value) return void 0;
+	return sanitize ? sanitize(value, field) : value;
+}
+function firstLabel(target, attributes) {
+	for (const name of attributes) {
+		const value = readAttribute(target, name) ?? target[name];
+		if (typeof value === "string" && value) return value;
+	}
+}
+function targetInfo(target, options) {
+	const element = target;
+	if (!element || typeof element !== "object") return {};
+	const maxTextLength = options.maxTextLength ?? 120;
+	const sanitize = options.sanitize;
+	const info = {
+		tagName: sanitizeField(element.tagName?.toLowerCase(), "tagName", sanitize),
+		id: sanitizeField(element.id, "id", sanitize),
+		name: sanitizeField(element.name, "name", sanitize),
+		role: sanitizeField(element.role ?? readAttribute(element, "role"), "role", sanitize),
+		type: sanitizeField(element.type, "type", sanitize),
+		href: sanitizeField(element.href, "href", sanitize),
+		label: sanitizeField(firstLabel(element, options.labelAttributes ?? defaultLabelAttributes), "label", sanitize)
+	};
+	if (options.captureText) info.text = sanitizeField(truncate(element.textContent ?? void 0, maxTextLength), "text", sanitize);
+	if (options.captureValue) info.value = sanitizeField(truncate(element.value, maxTextLength), "value", sanitize);
+	return info;
+}
+function throttleKey(event, target) {
+	return `${event.type}:${target.tagName ?? ""}:${target.id ?? ""}:${target.name ?? ""}:${target.label ?? ""}`;
+}
+function captureUserActionsIntegration(options = {}) {
+	const events = options.events ?? defaultEvents;
+	const level = options.level ?? "info";
+	const listenerCapture = options.listenerCapture ?? true;
+	const throttleMs = Math.max(0, Math.floor(options.throttleMs ?? 250));
+	const clock = options.clock ?? Date.now;
+	return {
+		name: "capture-user-actions",
+		setup(api) {
+			const root = options.root ?? globalThis.document;
+			if (!root?.addEventListener || !root.removeEventListener) return;
+			const lastSeen = /* @__PURE__ */ new Map();
+			let disposed = false;
+			const onAction = api.guard((event) => {
+				if (disposed) return;
+				const target = targetInfo(event.target, options);
+				if (options.ignore?.(event, target)) return;
+				const now = clock();
+				const key = throttleKey(event, target);
+				const last = lastSeen.get(key) ?? 0;
+				if (throttleMs > 0 && now - last < throttleMs) return;
+				lastSeen.set(key, now);
+				const action = {
+					type: event.type,
+					target
+				};
+				api.capture({
+					level,
+					message: `User action ${event.type}${target.label ? ` ${target.label}` : ""}`,
+					props: { browser: {
+						kind: "user-action",
+						action
+					} }
+				});
+			});
+			for (const event of events) root.addEventListener(event, onAction, listenerCapture);
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				for (const event of events) root.removeEventListener(event, onAction, listenerCapture);
+			};
+		}
+	};
+}
+//#endregion
+exports.captureUserActionsIntegration = captureUserActionsIntegration;
+
+//# sourceMappingURL=user-action-integration.cjs.map

package/dist/user-action-integration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-action-integration.cjs","names":[],"sources":["../src/user-action-integration.ts"],"sourcesContent":["import type { Integration, IntegrationSetupContext, LoggerLevel } from \"@loggerjs/core\";\n\nexport type BrowserUserActionEventName =\n  | \"change\"\n  | \"click\"\n  | \"dblclick\"\n  | \"input\"\n  | \"keydown\"\n  | \"submit\";\n\nexport interface BrowserUserActionTarget {\n  tagName?: string;\n  id?: string;\n  name?: string;\n  role?: string;\n  type?: string;\n  href?: string;\n  label?: string;\n  text?: string;\n  value?: string;\n}\n\nexport interface BrowserUserActionPayload {\n  type: BrowserUserActionEventName | string;\n  target: BrowserUserActionTarget;\n}\n\nexport interface BrowserEventTargetLike {\n  addEventListener: typeof globalThis.addEventListener;\n  removeEventListener: typeof globalThis.removeEventListener;\n}\n\nexport interface CaptureUserActionsOptions {\n  events?: readonly BrowserUserActionEventName[];\n  level?: LoggerLevel;\n  listenerCapture?: boolean;\n  throttleMs?: number;\n  captureText?: boolean;\n  captureValue?: boolean;\n  maxTextLength?: number;\n  labelAttributes?: readonly string[];\n  root?: BrowserEventTargetLike;\n  clock?: () => number;\n  sanitize?: (value: string, field: keyof BrowserUserActionTarget) => string;\n  ignore?: (event: Event, target: BrowserUserActionTarget) => boolean;\n}\n\ntype ElementLike = {\n  tagName?: string;\n  id?: string;\n  name?: string;\n  role?: string;\n  type?: string;\n  href?: string;\n  textContent?: string | null;\n  value?: string;\n  getAttribute?: (name: string) => string | null;\n};\n\nconst defaultEvents: readonly BrowserUserActionEventName[] = [\"click\", \"input\", \"change\", \"submit\"];\nconst defaultLabelAttributes = [\"data-loggerjs-label\", \"aria-label\", \"name\", \"id\"] as const;\n\nfunction truncate(value: string | undefined, maxLength: number): string | undefined {\n  if (!value) return undefined;\n  return value.length > maxLength ? value.slice(0, maxLength) : value;\n}\n\nfunction readAttribute(target: ElementLike, name: string): string | undefined {\n  const value = target.getAttribute?.(name);\n  return value || undefined;\n}\n\nfunction sanitizeField(\n  value: string | undefined,\n  field: keyof BrowserUserActionTarget,\n  sanitize: CaptureUserActionsOptions[\"sanitize\"],\n): string | undefined {\n  if (!value) return undefined;\n  return sanitize ? sanitize(value, field) : value;\n}\n\nfunction firstLabel(target: ElementLike, attributes: readonly string[]): string | undefined {\n  for (const name of attributes) {\n    const value = readAttribute(target, name) ?? (target as Record<string, unknown>)[name];\n    if (typeof value === \"string\" && value) return value;\n  }\n  return undefined;\n}\n\nfunction targetInfo(target: EventTarget | null, options: CaptureUserActionsOptions) {\n  const element = target as ElementLike | null;\n  if (!element || typeof element !== \"object\") return {};\n  const maxTextLength = options.maxTextLength ?? 120;\n  const sanitize = options.sanitize;\n  const info: BrowserUserActionTarget = {\n    tagName: sanitizeField(element.tagName?.toLowerCase(), \"tagName\", sanitize),\n    id: sanitizeField(element.id, \"id\", sanitize),\n    name: sanitizeField(element.name, \"name\", sanitize),\n    role: sanitizeField(element.role ?? readAttribute(element, \"role\"), \"role\", sanitize),\n    type: sanitizeField(element.type, \"type\", sanitize),\n    href: sanitizeField(element.href, \"href\", sanitize),\n    label: sanitizeField(\n      firstLabel(element, options.labelAttributes ?? defaultLabelAttributes),\n      \"label\",\n      sanitize,\n    ),\n  };\n\n  if (options.captureText) {\n    info.text = sanitizeField(\n      truncate(element.textContent ?? undefined, maxTextLength),\n      \"text\",\n      sanitize,\n    );\n  }\n  if (options.captureValue) {\n    info.value = sanitizeField(truncate(element.value, maxTextLength), \"value\", sanitize);\n  }\n  return info;\n}\n\nfunction throttleKey(event: Event, target: BrowserUserActionTarget): string {\n  return `${event.type}:${target.tagName ?? \"\"}:${target.id ?? \"\"}:${target.name ?? \"\"}:${target.label ?? \"\"}`;\n}\n\nexport function captureUserActionsIntegration(\n  options: CaptureUserActionsOptions = {},\n): Integration {\n  const events = options.events ?? defaultEvents;\n  const level = options.level ?? \"info\";\n  const listenerCapture = options.listenerCapture ?? true;\n  const throttleMs = Math.max(0, Math.floor(options.throttleMs ?? 250));\n  const clock = options.clock ?? Date.now;\n\n  return {\n    name: \"capture-user-actions\",\n    setup(api: IntegrationSetupContext) {\n      const root = options.root ?? globalThis.document;\n      if (!root?.addEventListener || !root.removeEventListener) return;\n      const lastSeen = new Map<string, number>();\n      let disposed = false;\n\n      const onAction = api.guard((event: Event) => {\n        if (disposed) return;\n        const target = targetInfo(event.target, options);\n        if (options.ignore?.(event, target)) return;\n        const now = clock();\n        const key = throttleKey(event, target);\n        const last = lastSeen.get(key) ?? 0;\n        if (throttleMs > 0 && now - last < throttleMs) return;\n        lastSeen.set(key, now);\n        const action: BrowserUserActionPayload = {\n          type: event.type,\n          target,\n        };\n        api.capture({\n          level,\n          message: `User action ${event.type}${target.label ? ` ${target.label}` : \"\"}`,\n          props: { browser: { kind: \"user-action\", action } },\n        });\n      });\n\n      for (const event of events) root.addEventListener(event, onAction, listenerCapture);\n\n      return () => {\n        if (disposed) return;\n        disposed = true;\n        for (const event of events) root.removeEventListener(event, onAction, listenerCapture);\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/user-action-integration.js

@@ -0,0 +1,99 @@
+//#region src/user-action-integration.ts
+const defaultEvents = [
+	"click",
+	"input",
+	"change",
+	"submit"
+];
+const defaultLabelAttributes = [
+	"data-loggerjs-label",
+	"aria-label",
+	"name",
+	"id"
+];
+function truncate(value, maxLength) {
+	if (!value) return void 0;
+	return value.length > maxLength ? value.slice(0, maxLength) : value;
+}
+function readAttribute(target, name) {
+	return target.getAttribute?.(name) || void 0;
+}
+function sanitizeField(value, field, sanitize) {
+	if (!value) return void 0;
+	return sanitize ? sanitize(value, field) : value;
+}
+function firstLabel(target, attributes) {
+	for (const name of attributes) {
+		const value = readAttribute(target, name) ?? target[name];
+		if (typeof value === "string" && value) return value;
+	}
+}
+function targetInfo(target, options) {
+	const element = target;
+	if (!element || typeof element !== "object") return {};
+	const maxTextLength = options.maxTextLength ?? 120;
+	const sanitize = options.sanitize;
+	const info = {
+		tagName: sanitizeField(element.tagName?.toLowerCase(), "tagName", sanitize),
+		id: sanitizeField(element.id, "id", sanitize),
+		name: sanitizeField(element.name, "name", sanitize),
+		role: sanitizeField(element.role ?? readAttribute(element, "role"), "role", sanitize),
+		type: sanitizeField(element.type, "type", sanitize),
+		href: sanitizeField(element.href, "href", sanitize),
+		label: sanitizeField(firstLabel(element, options.labelAttributes ?? defaultLabelAttributes), "label", sanitize)
+	};
+	if (options.captureText) info.text = sanitizeField(truncate(element.textContent ?? void 0, maxTextLength), "text", sanitize);
+	if (options.captureValue) info.value = sanitizeField(truncate(element.value, maxTextLength), "value", sanitize);
+	return info;
+}
+function throttleKey(event, target) {
+	return `${event.type}:${target.tagName ?? ""}:${target.id ?? ""}:${target.name ?? ""}:${target.label ?? ""}`;
+}
+function captureUserActionsIntegration(options = {}) {
+	const events = options.events ?? defaultEvents;
+	const level = options.level ?? "info";
+	const listenerCapture = options.listenerCapture ?? true;
+	const throttleMs = Math.max(0, Math.floor(options.throttleMs ?? 250));
+	const clock = options.clock ?? Date.now;
+	return {
+		name: "capture-user-actions",
+		setup(api) {
+			const root = options.root ?? globalThis.document;
+			if (!root?.addEventListener || !root.removeEventListener) return;
+			const lastSeen = /* @__PURE__ */ new Map();
+			let disposed = false;
+			const onAction = api.guard((event) => {
+				if (disposed) return;
+				const target = targetInfo(event.target, options);
+				if (options.ignore?.(event, target)) return;
+				const now = clock();
+				const key = throttleKey(event, target);
+				const last = lastSeen.get(key) ?? 0;
+				if (throttleMs > 0 && now - last < throttleMs) return;
+				lastSeen.set(key, now);
+				const action = {
+					type: event.type,
+					target
+				};
+				api.capture({
+					level,
+					message: `User action ${event.type}${target.label ? ` ${target.label}` : ""}`,
+					props: { browser: {
+						kind: "user-action",
+						action
+					} }
+				});
+			});
+			for (const event of events) root.addEventListener(event, onAction, listenerCapture);
+			return () => {
+				if (disposed) return;
+				disposed = true;
+				for (const event of events) root.removeEventListener(event, onAction, listenerCapture);
+			};
+		}
+	};
+}
+//#endregion
+export { captureUserActionsIntegration };
+
+//# sourceMappingURL=user-action-integration.js.map