@eventuras/logger 0.8.0 → 0.9.0

package/dist/node.js

@@ -1,7 +1,15 @@
-import { r as e, t } from "./Logger-CcNEmm6u.js";
-import { Writable as n } from "node:stream";
+import { r as PinoTransport, t as Logger } from "./Logger-B22dX10w.js";
+import { Writable } from "node:stream";
 //#region src/transports/pretty.ts
-var r = {
+/**
+* Lightweight pretty-print formatter for development.
+* Zero external dependencies — uses ANSI colors and simple formatting.
+*
+* Produces output like:
+*   12:34:56 INFO  (web:auth) → User logged in
+*   12:34:56 ERROR (web:auth) → Failed to authenticate { error: "invalid token" }
+*/
+var ANSI = {
 	reset: "\x1B[0m",
 	dim: "\x1B[2m",
 	bold: "\x1B[1m",
@@ -11,57 +19,61 @@ var r = {
 	cyan: "\x1B[36m",
 	magenta: "\x1B[35m",
 	gray: "\x1B[90m"
-}, i = {
+};
+var LEVEL_BY_NUMBER = {
 	10: {
 		label: "TRACE",
-		color: r.gray
+		color: ANSI.gray
 	},
 	20: {
 		label: "DEBUG",
-		color: r.cyan
+		color: ANSI.cyan
 	},
 	30: {
 		label: "INFO ",
-		color: r.green
+		color: ANSI.green
 	},
 	40: {
 		label: "WARN ",
-		color: r.yellow
+		color: ANSI.yellow
 	},
 	50: {
 		label: "ERROR",
-		color: r.red
+		color: ANSI.red
 	},
 	60: {
 		label: "FATAL",
-		color: `${r.bold}${r.red}`
+		color: `${ANSI.bold}${ANSI.red}`
 	}
-}, a = {
+};
+var LEVEL_BY_NAME = {
 	trace: {
 		label: "TRACE",
-		color: r.gray
+		color: ANSI.gray
 	},
 	debug: {
 		label: "DEBUG",
-		color: r.cyan
+		color: ANSI.cyan
 	},
 	info: {
 		label: "INFO ",
-		color: r.green
+		color: ANSI.green
 	},
 	warn: {
 		label: "WARN ",
-		color: r.yellow
+		color: ANSI.yellow
 	},
 	error: {
 		label: "ERROR",
-		color: r.red
+		color: ANSI.red
 	},
 	fatal: {
 		label: "FATAL",
-		color: `${r.bold}${r.red}`
+		color: `${ANSI.bold}${ANSI.red}`
 	}
-}, o = new Set([
+};
+/** Keys excluded from the "extra data" output. */
+var INTERNAL_KEYS = /* @__PURE__ */ new Set([
 	"level",
 	"time",
 	"pid",
@@ -71,60 +83,114 @@ var r = {
 	"ns",
 	"namespace"
 ]);
-function s(e) {
-	if (typeof e == "string") {
-		let t = new Date(e);
-		return Number.isNaN(t.getTime()) ? "" : t.toLocaleTimeString("en-GB", { hour12: !1 });
+function formatTime(time) {
+	if (typeof time === "string") {
+		const d = new Date(time);
+		return Number.isNaN(d.getTime()) ? "" : d.toLocaleTimeString("en-GB", { hour12: false });
 	}
-	return typeof e == "number" ? new Date(e).toLocaleTimeString("en-GB", { hour12: !1 }) : (/* @__PURE__ */ new Date()).toLocaleTimeString("en-GB", { hour12: !1 });
+	if (typeof time === "number") return new Date(time).toLocaleTimeString("en-GB", { hour12: false });
+	return (/* @__PURE__ */ new Date()).toLocaleTimeString("en-GB", { hour12: false });
 }
-function c(e) {
-	let t = {}, n = !1;
-	for (let [r, i] of Object.entries(e)) o.has(r) || (t[r] = i, n = !0);
-	return n ? ` ${r.dim}${JSON.stringify(t)}${r.reset}` : "";
+function formatData(obj) {
+	const filtered = {};
+	let hasKeys = false;
+	for (const [key, value] of Object.entries(obj)) if (!INTERNAL_KEYS.has(key)) {
+		filtered[key] = value;
+		hasKeys = true;
+	}
+	if (!hasKeys) return "";
+	return ` ${ANSI.dim}${JSON.stringify(filtered)}${ANSI.reset}`;
 }
-function l(e) {
-	let t = e.trim();
-	if (!t) return "";
-	let n;
+/**
+* Format a Pino JSON log line into a human-readable string.
+* @param line Raw JSON string from Pino
+* @returns Formatted string, or the original line if parsing fails
+*/
+function formatLogLine(line) {
+	const trimmed = line.trim();
+	if (!trimmed) return "";
+	let obj;
 	try {
-		n = JSON.parse(t);
+		obj = JSON.parse(trimmed);
 	} catch {
-		return t;
+		return trimmed;
 	}
-	let o = n.level, l = typeof o == "string" ? a[o] ?? {
-		label: o.toUpperCase().padEnd(5),
-		color: r.gray
-	} : i[o] ?? {
-		label: `L${o}`,
-		color: r.gray
-	}, u = s(n.time), d = n.msg ?? "", f = n.namespace || n.ns || n.name || "", p = f ? ` ${r.magenta}(${f})${r.reset}` : "", m = `${r.dim}→${r.reset}`, h = c(n);
-	return `${r.dim}${u}${r.reset} ${l.color}${l.label}${r.reset}${p} ${m} ${d}${h}`;
+	const level = obj.level;
+	const config = typeof level === "string" ? LEVEL_BY_NAME[level] ?? {
+		label: level.toUpperCase().padEnd(5),
+		color: ANSI.gray
+	} : LEVEL_BY_NUMBER[level] ?? {
+		label: `L${level}`,
+		color: ANSI.gray
+	};
+	const time = formatTime(obj.time);
+	const msg = obj.msg ?? "";
+	const ns = obj.namespace || obj.ns || obj.name || "";
+	const nsTag = ns ? ` ${ANSI.magenta}(${ns})${ANSI.reset}` : "";
+	const arrow = `${ANSI.dim}→${ANSI.reset}`;
+	const data = formatData(obj);
+	return `${ANSI.dim}${time}${ANSI.reset} ${config.color}${config.label}${ANSI.reset}${nsTag} ${arrow} ${msg}${data}`;
 }
-function u() {
-	return new n({ write(e, t, n) {
-		let r = e.toString().split("\n");
-		for (let e of r) {
-			let t = l(e);
-			t && process.stdout.write(t + "\n");
+/**
+* Creates a Node.js writable stream that formats Pino JSON output.
+* Used as the destination for PinoTransport when prettyPrint is enabled.
+*/
+function createPrettyStream() {
+	return new Writable({ write(chunk, _encoding, callback) {
+		const lines = chunk.toString().split("\n");
+		for (const line of lines) {
+			const formatted = formatLogLine(line);
+			if (formatted) process.stdout.write(formatted + "\n");
 		}
-		n();
+		callback();
 	} });
 }
 //#endregion
 //#region src/node.ts
-function d(n = {}) {
-	let { prettyPrint: r, pinoOptions: i, ...a } = n;
-	t.configure({
-		...a,
-		transport: new e({
-			level: a.level,
-			redact: a.redact,
-			destination: a.destination,
-			destinationStream: r ? u() : void 0,
-			pinoOptions: i
+/**
+* Node.js-only exports for @eventuras/logger.
+*
+* These utilities depend on `node:stream` and must not be imported in browser
+* or edge runtime environments. Import from the root entry point
+* (`@eventuras/logger`) for the browser-safe API.
+*
+* @example
+* // Pretty dev output
+* import { configureNodeLogger } from '@eventuras/logger/node';
+* configureNodeLogger({ prettyPrint: process.env.NODE_ENV === 'development' });
+*
+* @example
+* // Lower-level: just the pretty helpers
+* import { createPrettyStream, formatLogLine } from '@eventuras/logger/node';
+*/
+/**
+* Configure the global Logger with a Node-side PinoTransport, optionally
+* wired to a pretty-print stream for development. Keeps the browser/edge
+* main entry free of `node:stream` imports — call this from a Node-only
+* bootstrap (e.g. `instrumentation.ts`, `server.ts`).
+*
+* @example
+* // In your server entry point
+* import { configureNodeLogger } from '@eventuras/logger/node';
+* configureNodeLogger({
+*   level: 'debug',
+*   prettyPrint: process.env.NODE_ENV === 'development',
+* });
+*/
+function configureNodeLogger(options = {}) {
+	const { prettyPrint, pinoOptions, ...rest } = options;
+	Logger.configure({
+		...rest,
+		transport: new PinoTransport({
+			level: rest.level,
+			redact: rest.redact,
+			destination: rest.destination,
+			destinationStream: prettyPrint ? createPrettyStream() : void 0,
+			pinoOptions
 		})
 	});
 }
 //#endregion
-export { d as configureNodeLogger, u as createPrettyStream, l as formatLogLine };
+export { configureNodeLogger, createPrettyStream, formatLogLine };
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../src/transports/pretty.ts","../src/node.ts"],"sourcesContent":["/**\n * Lightweight pretty-print formatter for development.\n * Zero external dependencies — uses ANSI colors and simple formatting.\n *\n * Produces output like:\n *   12:34:56 INFO  (web:auth) → User logged in\n *   12:34:56 ERROR (web:auth) → Failed to authenticate { error: \"invalid token\" }\n */\n\nimport { Writable } from 'node:stream';\n\nconst ANSI = {\n  reset: '\\x1b[0m',\n  dim: '\\x1b[2m',\n  bold: '\\x1b[1m',\n  red: '\\x1b[31m',\n  yellow: '\\x1b[33m',\n  green: '\\x1b[32m',\n  cyan: '\\x1b[36m',\n  magenta: '\\x1b[35m',\n  gray: '\\x1b[90m',\n} as const;\n\nconst LEVEL_BY_NUMBER: Record<number, { label: string; color: string; }> = {\n  10: { label: 'TRACE', color: ANSI.gray },\n  20: { label: 'DEBUG', color: ANSI.cyan },\n  30: { label: 'INFO ', color: ANSI.green },\n  40: { label: 'WARN ', color: ANSI.yellow },\n  50: { label: 'ERROR', color: ANSI.red },\n  60: { label: 'FATAL', color: `${ANSI.bold}${ANSI.red}` },\n};\n\nconst LEVEL_BY_NAME: Record<string, { label: string; color: string; }> = {\n  trace: { label: 'TRACE', color: ANSI.gray },\n  debug: { label: 'DEBUG', color: ANSI.cyan },\n  info:  { label: 'INFO ', color: ANSI.green },\n  warn:  { label: 'WARN ', color: ANSI.yellow },\n  error: { label: 'ERROR', color: ANSI.red },\n  fatal: { label: 'FATAL', color: `${ANSI.bold}${ANSI.red}` },\n};\n\n/** Keys excluded from the \"extra data\" output. */\nconst INTERNAL_KEYS = new Set([\n  'level', 'time', 'pid', 'hostname', 'msg', 'name', 'ns', 'namespace',\n]);\n\nfunction formatTime(time: unknown): string {\n  if (typeof time === 'string') {\n    // ISO string — extract time portion\n    const d = new Date(time);\n    return Number.isNaN(d.getTime()) ? '' : d.toLocaleTimeString('en-GB', { hour12: false });\n  }\n  if (typeof time === 'number') {\n    return new Date(time).toLocaleTimeString('en-GB', { hour12: false });\n  }\n  return new Date().toLocaleTimeString('en-GB', { hour12: false });\n}\n\nfunction formatData(obj: Record<string, unknown>): string {\n  const filtered: Record<string, unknown> = {};\n  let hasKeys = false;\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (!INTERNAL_KEYS.has(key)) {\n      filtered[key] = value;\n      hasKeys = true;\n    }\n  }\n\n  if (!hasKeys) return '';\n  return ` ${ANSI.dim}${JSON.stringify(filtered)}${ANSI.reset}`;\n}\n\n/**\n * Format a Pino JSON log line into a human-readable string.\n * @param line Raw JSON string from Pino\n * @returns Formatted string, or the original line if parsing fails\n */\nexport function formatLogLine(line: string): string {\n  const trimmed = line.trim();\n  if (!trimmed) return '';\n\n  let obj: Record<string, unknown>;\n  try {\n    obj = JSON.parse(trimmed);\n  } catch {\n    return trimmed;\n  }\n\n  const level = obj.level;\n  const config = typeof level === 'string'\n    ? LEVEL_BY_NAME[level] ?? { label: level.toUpperCase().padEnd(5), color: ANSI.gray }\n    : LEVEL_BY_NUMBER[level as number] ?? { label: `L${level}`, color: ANSI.gray };\n  const time = formatTime(obj.time);\n  const msg = (obj.msg as string) ?? '';\n  const ns = (obj.namespace as string) || (obj.ns as string) || (obj.name as string) || '';\n\n  const nsTag = ns ? ` ${ANSI.magenta}(${ns})${ANSI.reset}` : '';\n  const arrow = `${ANSI.dim}→${ANSI.reset}`;\n  const data = formatData(obj);\n\n  return `${ANSI.dim}${time}${ANSI.reset} ${config.color}${config.label}${ANSI.reset}${nsTag} ${arrow} ${msg}${data}`;\n}\n\n/**\n * Creates a Node.js writable stream that formats Pino JSON output.\n * Used as the destination for PinoTransport when prettyPrint is enabled.\n */\nexport function createPrettyStream(): NodeJS.WritableStream {\n  return new Writable({\n    write(chunk: Buffer, _encoding: string, callback: () => void) {\n      const lines = chunk.toString().split('\\n');\n      for (const line of lines) {\n        const formatted = formatLogLine(line);\n        if (formatted) {\n          process.stdout.write(formatted + '\\n');\n        }\n      }\n      callback();\n    },\n  });\n}\n","/**\n * Node.js-only exports for @eventuras/logger.\n *\n * These utilities depend on `node:stream` and must not be imported in browser\n * or edge runtime environments. Import from the root entry point\n * (`@eventuras/logger`) for the browser-safe API.\n *\n * @example\n * // Pretty dev output\n * import { configureNodeLogger } from '@eventuras/logger/node';\n * configureNodeLogger({ prettyPrint: process.env.NODE_ENV === 'development' });\n *\n * @example\n * // Lower-level: just the pretty helpers\n * import { createPrettyStream, formatLogLine } from '@eventuras/logger/node';\n */\nimport { Logger } from './Logger';\nimport { PinoTransport, type PinoTransportOptions } from './transports/pino';\nimport { createPrettyStream } from './transports/pretty';\nimport type { LoggerConfig } from './types';\n\nexport { formatLogLine, createPrettyStream } from './transports/pretty';\n\n/** Options for `configureNodeLogger`. */\nexport type NodeLoggerOptions = Omit<LoggerConfig, 'transport'> & {\n  /** Enable human-readable, ANSI-colored output. Off by default. */\n  prettyPrint?: boolean;\n  /** Raw PinoTransport options for advanced tuning. */\n  pinoOptions?: PinoTransportOptions['pinoOptions'];\n};\n\n/**\n * Configure the global Logger with a Node-side PinoTransport, optionally\n * wired to a pretty-print stream for development. Keeps the browser/edge\n * main entry free of `node:stream` imports — call this from a Node-only\n * bootstrap (e.g. `instrumentation.ts`, `server.ts`).\n *\n * @example\n * // In your server entry point\n * import { configureNodeLogger } from '@eventuras/logger/node';\n * configureNodeLogger({\n *   level: 'debug',\n *   prettyPrint: process.env.NODE_ENV === 'development',\n * });\n */\nexport function configureNodeLogger(options: NodeLoggerOptions = {}): void {\n  const { prettyPrint, pinoOptions, ...rest } = options;\n  Logger.configure({\n    ...rest,\n    transport: new PinoTransport({\n      level: rest.level,\n      redact: rest.redact,\n      destination: rest.destination,\n      destinationStream: prettyPrint ? createPrettyStream() : undefined,\n      pinoOptions,\n    }),\n  });\n}\n"],"mappings":"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"}

package/dist/opentelemetry.d.ts

@@ -1,12 +1,22 @@
 /**
  * OpenTelemetry integration for @eventuras/logger
  *
- * This module provides integration between Pino and OpenTelemetry Logs API.
- * It allows sending logs to any OpenTelemetry-compatible backend (Sentry, Grafana, Jaeger, etc.)
- * without vendor lock-in.
+ * Sends logs to any OpenTelemetry-compatible backend (Sentry, Grafana, the
+ * Aspire dashboard, etc.) without vendor lock-in.
  *
- * NOTE: This module requires OpenTelemetry packages to be installed as peer dependencies.
- * If they are not available, the integration will gracefully disable itself.
+ * Every line the Pino transport writes — after redaction, from every logger,
+ * including ones created before setup — is also emitted as an OpenTelemetry
+ * log record. The logger bridges this itself rather than through
+ * `@opentelemetry/instrumentation-pino`, which only patches Pino when it is
+ * loaded through an import-in-the-middle loader hook, and so never saw this
+ * package's ESM import of Pino.
+ *
+ * `@opentelemetry/sdk-logs` is an optional peer dependency, needed only when
+ * passing `logRecordProcessor` — which comes from that package anyway, so the
+ * app already has it and the logger uses the app's copy.
+ *
+ * Setup never throws or rejects: if it can't start, it logs an error and
+ * leaves logging to stdout untouched.
  *
  * @example
  * // In your app's instrumentation.ts or main entry point
@@ -14,13 +24,10 @@
  * import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
  * import { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
  *
- * setupOpenTelemetryLogger({
- *   logRecordProcessor: new BatchLogRecordProcessor(
- *     new OTLPLogExporter({
- *       url: 'https://[org].ingest.sentry.io/api/[project]/integration/otlp/v1/logs',
- *       headers: { 'x-sentry-auth': 'sentry sentry_key=...' }
- *     })
- *   )
+ * await setupOpenTelemetryLogger({
+ *   logRecordProcessor: new BatchLogRecordProcessor({
+ *     exporter: new OTLPLogExporter(), // reads OTEL_EXPORTER_OTLP_* env vars
+ *   }),
  * });
  *
  * @example
@@ -36,16 +43,36 @@
  * Defined locally to avoid requiring OTel types at compile time.
  */
 export interface LogRecordProcessor {
+    onEmit(logRecord: unknown, context?: unknown): void;
     shutdown(): Promise<void>;
     forceFlush(): Promise<void>;
 }
+/**
+ * Minimal shape of an OpenTelemetry log record, as emitted by this package.
+ * Loosely typed so the SDK's own `LogRecord` type is assignable to it.
+ */
+export type OTelLogRecord = {
+    timestamp?: unknown;
+    severityNumber?: number;
+    severityText?: string;
+    body?: unknown;
+    attributes?: Record<string, unknown>;
+};
+/**
+ * Minimal interface for an OpenTelemetry Logger.
+ * Compatible with `@opentelemetry/api-logs` `Logger`.
+ */
+export interface OTelLogger {
+    emit(record: OTelLogRecord): void;
+}
 /**
  * Minimal interface for an OpenTelemetry LoggerProvider.
- * Compatible with `@opentelemetry/sdk-logs` `LoggerProvider`.
+ * Compatible with `@opentelemetry/sdk-logs` `LoggerProvider` and the global
+ * provider from `@opentelemetry/api-logs`.
  */
 export interface OTelLoggerProvider {
-    addLogRecordProcessor(processor: LogRecordProcessor): void;
-    shutdown(): Promise<void>;
+    getLogger(name: string, version?: string): OTelLogger;
+    shutdown?(): Promise<void>;
     forceFlush?(): Promise<void>;
 }
 /**
@@ -54,15 +81,19 @@ export interface OTelLoggerProvider {
 export type OpenTelemetryLoggerOptions = {
     /**
      * Log record processor (e.g., BatchLogRecordProcessor with an exporter).
-     * If not provided, logs will only be instrumented but not exported.
+     * A LoggerProvider is created for it. Requires `@opentelemetry/sdk-logs`.
      */
     logRecordProcessor?: LogRecordProcessor;
     /**
-     * Logger provider instance. If not provided, a new one will be created.
+     * Logger provider to emit to, e.g. one your app already configured with a
+     * resource and processors. Takes precedence over `logRecordProcessor`.
+     *
+     * With neither option, the globally registered provider is used (as set up
+     * by `@opentelemetry/sdk-node`, for instance).
      */
     loggerProvider?: OTelLoggerProvider;
     /**
-     * Service name to attach to log records.
+     * Service name attached to every log record as the `service.name` attribute.
      * Defaults to the `OTEL_SERVICE_NAME` environment variable, or `'unknown-service'`.
      */
     serviceName?: string;
@@ -72,55 +103,43 @@ export type OpenTelemetryLoggerOptions = {
     enabled?: boolean;
 };
 /**
- * Set up OpenTelemetry integration for Pino logger.
+ * Set up OpenTelemetry integration for the logger.
  *
- * This function:
- * 1. Creates or uses provided LoggerProvider
- * 2. Registers the log record processor (for exporting logs)
- * 3. Enables Pino instrumentation to bridge Pino logs to OTel
- *
- * Call this function once at application startup, before creating any loggers.
+ * Call once at application startup. Loggers created before the call are
+ * exported too. Calling again replaces the previous setup.
  *
  * @param options - Configuration options
  *
  * @example
  * // Send to Sentry via OTLP
- * import { setupOpenTelemetryLogger } from '@eventuras/logger';
+ * import { setupOpenTelemetryLogger } from '@eventuras/logger/opentelemetry';
  * import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
  * import { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
  *
- * setupOpenTelemetryLogger({
- *   logRecordProcessor: new BatchLogRecordProcessor(
- *     new OTLPLogExporter({
+ * await setupOpenTelemetryLogger({
+ *   logRecordProcessor: new BatchLogRecordProcessor({
+ *     exporter: new OTLPLogExporter({
  *       url: process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT,
  *       headers: {
  *         'x-sentry-auth': `sentry sentry_key=${process.env.SENTRY_KEY}`
  *       }
  *     })
- *   )
+ *   })
  * });
  *
  * @example
- * // Use environment variables (recommended)
- * // Set these in your environment:
- * // OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://[org].ingest.sentry.io/api/[project]/integration/otlp/v1/logs
- * // OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-sentry-auth=sentry sentry_key=...
- *
- * import { setupOpenTelemetryLogger } from '@eventuras/logger';
- * import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
- * import { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
- *
- * await setupOpenTelemetryLogger({
- *   logRecordProcessor: new BatchLogRecordProcessor(
- *     new OTLPLogExporter() // Reads from env vars
- *   )
- * });
+ * // Use a provider your app already registered globally (e.g. via NodeSDK)
+ * await setupOpenTelemetryLogger();
  */
 export declare function setupOpenTelemetryLogger(options?: OpenTelemetryLoggerOptions): Promise<void>;
 /**
  * Shut down the OpenTelemetry logger integration.
  * Call this when your application is shutting down to flush any pending logs.
  *
+ * A provider created from `logRecordProcessor` is shut down. One passed as
+ * `loggerProvider`, or the global one, belongs to your app — it is flushed,
+ * not shut down.
+ *
  * @example
  * process.on('SIGTERM', async () => {
  *   await shutdownOpenTelemetryLogger();

package/dist/opentelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC3D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAwBD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAiEf;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAO7D"}
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAOH;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACtD,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAmFF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAejE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAO7D"}