logixia 2.0.0 → 2.0.6

package/dist/{transport.manager-BiuCAJd2.mjs → otel-Dt5riXuE.mjs}

@@ -1,16 +1,16 @@
-import { t as __require } from "./chunk-DLSkYcPk.mjs";
-import { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-Cm8SOWSV.mjs";
-import { i as stringifyForLog } from "./safe-stringify-DJ66tW5I.mjs";
-import { t as mergeCoreFields } from "./entry-fields-BJkuPnIg.mjs";
-import { t as safeToString } from "./coerce.utils-Cu6IUTgX.mjs";
-import * as fs from "node:fs";
-import * as path$1 from "node:path";
+import { t as __require } from "./rolldown-runtime-D3PmRqjj.mjs";
+import { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-Bg4V1cPg.mjs";
+import { n as protectSecrets, o as urlSecrets, r as scrubError, t as collectSecrets } from "./secret-config-Dhb6pqTU.mjs";
+import { t as safeToString } from "./coerce.utils-B_rEudCn.mjs";
+import { i as stringifyForLog } from "./safe-stringify-B5p5ktFe.mjs";
+import { t as mergeCoreFields } from "./entry-fields-J1OBi24o.mjs";
 import { EventEmitter } from "node:events";
 import { promisify } from "node:util";
 import { createGzip, gzip } from "node:zlib";
+import * as fs from "node:fs";
+import * as path$1 from "node:path";
 import { pipeline } from "node:stream/promises";
-
-//#region src/utils/sanitize.utils.ts
+// src/utils/sanitize.utils.ts
 /**
 * Control-character stripping for text-mode log output.
 *
@@ -26,9 +26,7 @@ const VISIBLE_ESCAPES = {
 function stripControlChars(value) {
 	return value.replace(CONTROL_CHARS_RE, (ch) => VISIBLE_ESCAPES[ch] ?? "");
 }
-
-//#endregion
-//#region src/transports/console.transport.ts
+// src/transports/console.transport.ts
 /**
 * Writes log entries to stdout (info/debug/verbose) and stderr (error/warn).
 *
@@ -38,32 +36,13 @@ function stripControlChars(value) {
 * transports: { console: { format: 'json' } }
 */
 var ConsoleTransport = class ConsoleTransport {
-	static #_ = this.COLORS = new Map([
-		["black", "\x1B[30m"],
-		["red", "\x1B[31m"],
-		["green", "\x1B[32m"],
-		["yellow", "\x1B[33m"],
-		["blue", "\x1B[34m"],
-		["magenta", "\x1B[35m"],
-		["cyan", "\x1B[36m"],
-		["white", "\x1B[37m"],
-		["gray", "\x1B[90m"],
-		["grey", "\x1B[90m"],
-		["brightred", "\x1B[91m"],
-		["brightgreen", "\x1B[92m"],
-		["brightyellow", "\x1B[93m"],
-		["brightblue", "\x1B[94m"],
-		["brightmagenta", "\x1B[95m"],
-		["brightcyan", "\x1B[96m"],
-		["brightwhite", "\x1B[97m"],
-		["reset", "\x1B[0m"]
-	]);
 	static sanitize(value) {
 		return stripControlChars(safeToString(value));
 	}
 	constructor(config = {}) {
 		this.config = config;
 		this.name = "console";
+		this.level = config.level;
 		if (config.filter) this.filter = config.filter;
 	}
 	write(entry) {
@@ -126,10 +105,28 @@ var ConsoleTransport = class ConsoleTransport {
 	close() {
 		return Promise.resolve();
 	}
+	static #_ = () => this.COLORS = /* @__PURE__ */ new Map([
+		["black", "\x1B[30m"],
+		["red", "\x1B[31m"],
+		["green", "\x1B[32m"],
+		["yellow", "\x1B[33m"],
+		["blue", "\x1B[34m"],
+		["magenta", "\x1B[35m"],
+		["cyan", "\x1B[36m"],
+		["white", "\x1B[37m"],
+		["gray", "\x1B[90m"],
+		["grey", "\x1B[90m"],
+		["brightred", "\x1B[91m"],
+		["brightgreen", "\x1B[92m"],
+		["brightyellow", "\x1B[93m"],
+		["brightblue", "\x1B[94m"],
+		["brightmagenta", "\x1B[95m"],
+		["brightcyan", "\x1B[96m"],
+		["brightwhite", "\x1B[97m"],
+		["reset", "\x1B[0m"]
+	]);
 };
-
-//#endregion
-//#region src/transports/buffer-cap.ts
+// src/transports/buffer-cap.ts
 const DEFAULT_BUFFER_CAP = 1e4;
 const DROP_WARN_INTERVAL_MS$1 = 5e3;
 /**
@@ -145,8 +142,10 @@ var BufferCap = class {
 		this.dropped = 0;
 		this.lastWarning = 0;
 		let max = fallback;
-		if (requested !== void 0) if (Number.isInteger(requested) && requested >= 1) max = requested;
-		else internalWarn(`${name}: maxBufferSize ${String(requested)} is not a positive integer; using ${fallback}`);
+		if (requested !== void 0) {
+			if (Number.isInteger(requested) && requested >= 1) max = requested;
+			else internalWarn(`${name}: maxBufferSize ${String(requested)} is not a positive integer; using ${fallback}`);
+		}
 		this.max = Math.max(max, batchSize);
 	}
 	/** Drops the oldest items beyond the cap, in place. */
@@ -168,9 +167,7 @@ var BufferCap = class {
 		this.lastWarning = now;
 	}
 };
-
-//#endregion
-//#region src/transports/database.transport.ts
+// src/transports/database.transport.ts
 /**
 * Validates that a SQL identifier (table/index name) contains only safe characters.
 * Prevents SQL injection via user-supplied table names.
@@ -193,7 +190,7 @@ const PG_DATA_CLASSES = [
 	"23",
 	"54"
 ];
-const MYSQL_DATA_CODES = new Set([
+const MYSQL_DATA_CODES = /* @__PURE__ */ new Set([
 	"ER_DATA_TOO_LONG",
 	"ER_TRUNCATED_WRONG_VALUE",
 	"ER_TRUNCATED_WRONG_VALUE_FOR_FIELD",
@@ -203,7 +200,7 @@ const MYSQL_DATA_CODES = new Set([
 	"ER_INVALID_JSON_TEXT",
 	"ER_INVALID_CHARACTER_STRING"
 ]);
-const MYSQL_DATA_ERRNOS = new Set([
+const MYSQL_DATA_ERRNOS = /* @__PURE__ */ new Set([
 	1048,
 	1062,
 	1264,
@@ -212,12 +209,12 @@ const MYSQL_DATA_ERRNOS = new Set([
 	1406,
 	3140
 ]);
-const SQLITE_DATA_CODES = new Set([
+const SQLITE_DATA_CODES = /* @__PURE__ */ new Set([
 	"SQLITE_CONSTRAINT",
 	"SQLITE_TOOBIG",
 	"SQLITE_MISMATCH"
 ]);
-const MONGO_DATA_CODES = new Set([
+const MONGO_DATA_CODES = /* @__PURE__ */ new Set([
 	2,
 	121,
 	10334,
@@ -279,13 +276,23 @@ var DatabaseTransport = class {
 		this.name = "database";
 		this.batch = [];
 		this.isConnected = false;
+		protectSecrets(this, ["config", "connection"]);
 		this.batchSize = config.batchSize || 100;
 		this.flushInterval = config.flushInterval || 5e3;
 		this.cap = new BufferCap("DatabaseTransport", config.maxBufferSize, this.batchSize);
+		this.level = config.level;
 		if (config.filter) this.filter = config.filter;
 		if (config.table) validateSqlIdentifier(config.table, "table");
 		this.setupFlushTimer();
 	}
+	secretValues() {
+		const { connectionString, password } = this.config;
+		return [
+			connectionString,
+			password,
+			...connectionString ? urlSecrets(connectionString) : []
+		];
+	}
 	async write(entry) {
 		if (!this.isConnected) await this.connect();
 		this.addToBatch(entry);
@@ -346,6 +353,13 @@ var DatabaseTransport = class {
 		this.cap.enforce(this.batch);
 	}
 	async writeEntries(entries) {
+		try {
+			await this.writeEntriesUnscrubbed(entries);
+		} catch (error) {
+			throw scrubError(error, this.secretValues());
+		}
+	}
+	async writeEntriesUnscrubbed(entries) {
 		switch (this.config.type) {
 			case "mongodb":
 				await this.flushToMongoDB(entries);
@@ -424,13 +438,12 @@ var DatabaseTransport = class {
 				case "mysql":
 					await this.connectMySQL();
 					break;
-				case "sqlite":
-					await this.connectSQLite();
-					break;
+				case "sqlite": await this.connectSQLite();
 			}
 			this.isConnected = true;
 		} catch (error) {
 			this.isConnected = false;
+			scrubError(error, this.secretValues());
 			throw new Error(`Database connection failed: ${error}`, { cause: error });
 		}
 	}
@@ -439,7 +452,8 @@ var DatabaseTransport = class {
 			const { MongoClient } = await import("mongodb").catch(() => {
 				throw new Error("MongoDB driver not installed. Run: npm install mongodb");
 			});
-			this.connection = new MongoClient(this.config.connectionString || `mongodb://${this.config.host}:${this.config.port}/${this.config.database}`);
+			const connectionString = this.config.connectionString || `mongodb://${this.config.host}:${this.config.port}/${this.config.database}`;
+			this.connection = new MongoClient(connectionString);
 			await this.connection.connect();
 			await this.connection.db(this.config.database).admin().ping();
 		} catch (error) {
@@ -551,12 +565,13 @@ var DatabaseTransport = class {
 			entry.environment
 		].map((value, column) => stripNul(column === 3 ? stripJsonNulEscape(value) : value))), POSTGRES_ROWS_PER_INSERT);
 		const insertChunk = async (rows) => {
+			const placeholders = rows.map((_, i) => {
+				return `(${Array.from({ length: POSTGRES_COLUMNS }, (_unused, c) => `$${i * POSTGRES_COLUMNS + c + 1}`).join(", ")})`;
+			}).join(", ");
 			const query = `
       INSERT INTO ${tableName} 
       (timestamp, level, message, payload, context, trace_id, app_name, environment)
-      VALUES ${rows.map((_, i) => {
-				return `(${Array.from({ length: POSTGRES_COLUMNS }, (_unused, c) => `$${i * POSTGRES_COLUMNS + c + 1}`).join(", ")})`;
-			}).join(", ")}
+      VALUES ${placeholders}
     `;
 			await this.connection.query(query, rows.flat());
 		};
@@ -720,9 +735,7 @@ var DatabaseTransport = class {
 			case "mysql":
 				await this.connection.end();
 				break;
-			case "sqlite":
-				await this.connection.close();
-				break;
+			case "sqlite": await this.connection.close();
 		}
 		this.isConnected = false;
 	}
@@ -763,9 +776,7 @@ var DatabaseTransport = class {
 		}
 	}
 };
-
-//#endregion
-//#region src/transports/analytics.transport.ts
+// src/transports/analytics.transport.ts
 /**
 * Thrown by sendBatch() when part of a batch was already delivered. drain()
 * requeues only `unsent`, so delivered entries are not sent twice.
@@ -789,16 +800,25 @@ var AnalyticsTransport = class {
 			enableEventTracking: true,
 			...config
 		};
+		protectSecrets(this, ["config"]);
 		this.level = config.level;
 		this.batchSize = this.config.batchSize || 50;
 		this.flushInterval = this.config.flushInterval || 1e4;
 		this.cap = new BufferCap(name, config.maxBufferSize, this.batchSize);
 	}
+	/** Secret strings to scrub from errors: everything secret-looking in the config. Override to add more. */
+	secretValues() {
+		return collectSecrets(this.config);
+	}
 	async write(entry) {
-		if (!this.isReady) await this.ensureReady();
-		if (this.shouldSkipEntry(entry)) return;
-		if (this.config.batchSize && this.config.batchSize > 1) this.addToBatch(entry);
-		else await this.sendEntry(entry);
+		try {
+			if (!this.isReady) await this.ensureReady();
+			if (this.shouldSkipEntry(entry)) return;
+			if (this.config.batchSize && this.config.batchSize > 1) this.addToBatch(entry);
+			else await this.sendEntry(entry);
+		} catch (error) {
+			throw scrubError(error, this.secretValues());
+		}
 	}
 	addToBatch(entry) {
 		this.batch.push(entry);
@@ -836,6 +856,7 @@ var AnalyticsTransport = class {
 			try {
 				await this.sendBatch(entriesToSend);
 			} catch (error) {
+				scrubError(error, this.secretValues());
 				internalError(`Analytics transport ${this.name} flush failed`, error);
 				this.batch.unshift(...error instanceof PartialBatchError ? error.unsent : entriesToSend);
 				this.cap.enforce(this.batch);
@@ -897,9 +918,7 @@ var AnalyticsTransport = class {
 		await this.ensureReady();
 	}
 };
-
-//#endregion
-//#region src/transports/datadog.transport.ts
+// src/transports/datadog.transport.ts
 const gzipAsync = promisify(gzip);
 const MAX_LOGS_PER_REQUEST = 1e3;
 const MAX_LOGS_PAYLOAD_BYTES = 5e6;
@@ -968,8 +987,12 @@ function tag(key, value) {
 *
 * The API key is transmitted via the `DD-API-KEY` request header — never in the URL.
 *
+* Metric names keep the legacy `logitron.logs.<level>` prefix (kept for
+* dashboards and monitors that already query it; renaming would be a breaking
+* change). Query `logitron.logs.error`, not `logixia.logs.error`.
+*
 * @example
-* transports: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
+* analytics: { datadog: { apiKey: process.env.DD_API_KEY, service: 'api', env: 'production' } }
 */
 var DataDogTransport = class extends AnalyticsTransport {
 	constructor(config) {
@@ -979,6 +1002,7 @@ var DataDogTransport = class extends AnalyticsTransport {
 		this.baseUrl = `https://api.${site}`;
 		this.logsUrl = `https://http-intake.logs.${site}`;
 		this.metricsUrl = `https://api.${site}`;
+		protectSecrets(this, ["datadogConfig"]);
 	}
 	async initialize() {
 		try {
@@ -1014,9 +1038,9 @@ var DataDogTransport = class extends AnalyticsTransport {
 		}));
 		const chunks = this.chunkLogs(items);
 		for (let i = 0; i < chunks.length; i += 1) {
-			const chunk$1 = chunks[i];
+			const chunk = chunks[i];
 			try {
-				await this.makeLogsRequest("/api/v2/logs", `[${chunk$1.map((item) => item.json).join(",")}]`);
+				await this.makeLogsRequest("/api/v2/logs", `[${chunk.map((item) => item.json).join(",")}]`);
 			} catch (error) {
 				if (i === 0) throw error;
 				const unsent = chunks.slice(i).flatMap((c) => c.map((item) => item.entry));
@@ -1205,9 +1229,7 @@ var DataDogTransport = class extends AnalyticsTransport {
 		}
 	}
 };
-
-//#endregion
-//#region src/transports/file.transport.ts
+// src/transports/file.transport.ts
 const appendFile = promisify(fs.appendFile);
 const rename = promisify(fs.rename);
 const unlink = promisify(fs.unlink);
@@ -1470,7 +1492,6 @@ var FileTransport = class {
 				csvField(entry.traceId),
 				csvField(stringifyForLog(entry.data || {}))
 			].join(",");
-			case "text":
 			default: return `${entry.timestamp.toISOString()} [${stripControlChars(safeToString(entry.level)).toUpperCase()}] ${stripControlChars(safeToString(entry.message))}${entry.data ? " " + stringifyForLog(entry.data) : ""}`;
 		}
 	}
@@ -1496,22 +1517,22 @@ var FileTransport = class {
 			await this.append(content);
 			return;
 		}
-		let chunk$1 = "";
+		let chunk = "";
 		let chunkBytes = 0;
 		for (const entry of entries) {
 			const line = this.formatEntry(entry) + "\n";
 			const lineBytes = Buffer.byteLength(line);
 			const used = this.bytesWritten + chunkBytes;
 			if (used > 0 && used + lineBytes > this.maxBytes) {
-				if (chunk$1) await this.append(chunk$1, chunkBytes);
-				chunk$1 = "";
+				if (chunk) await this.append(chunk, chunkBytes);
+				chunk = "";
 				chunkBytes = 0;
 				await this.rotateFile();
 			}
-			chunk$1 += line;
+			chunk += line;
 			chunkBytes += lineBytes;
 		}
-		if (chunk$1) await this.append(chunk$1, chunkBytes);
+		if (chunk) await this.append(chunk, chunkBytes);
 	}
 	async append(content, bytes = Buffer.byteLength(content)) {
 		await appendFile(this.currentFilePath, content, { mode: this.fileMode });
@@ -1540,7 +1561,7 @@ var FileTransport = class {
 	}
 	parseInterval(interval) {
 		const match = /^(\d{1,6})([hdwmy])$/i.exec(interval.trim());
-		if (!match) return 1440 * 60 * 1e3;
+		if (!match) return 864e5;
 		const value = Number.parseInt(match[1] || "1", 10);
 		switch ((match[2] || "h").toLowerCase()) {
 			case "h": return value * 60 * 60 * 1e3;
@@ -1655,14 +1676,12 @@ var FileTransport = class {
 		this.reportDropped(0);
 	}
 };
-
-//#endregion
-//#region src/transports/google-analytics.transport.ts
+// src/transports/google-analytics.transport.ts
 /**
 * Sends log entries as Google Analytics 4 Measurement Protocol events.
 *
 * @example
-* transports: {
+* analytics: {
 *   googleAnalytics: { measurementId: 'G-XXXXXXX', apiSecret: process.env.GA_API_SECRET }
 * }
 */
@@ -1672,6 +1691,7 @@ var GoogleAnalyticsTransport = class extends AnalyticsTransport {
 		this.baseUrl = "https://www.google-analytics.com/mp/collect";
 		this.debugUrl = "https://www.google-analytics.com/debug/mp/collect";
 		this.gaConfig = config;
+		protectSecrets(this, ["gaConfig"]);
 	}
 	async initialize() {
 		try {
@@ -1759,10 +1779,10 @@ var GoogleAnalyticsTransport = class extends AnalyticsTransport {
 	}
 	async sendEvents(events) {
 		const chunks = this.chunkArray(events, 25);
-		for (const chunk$1 of chunks) {
+		for (const chunk of chunks) {
 			const payload = {
 				client_id: this.gaConfig.clientId || this.generateClientId(),
-				events: chunk$1
+				events: chunk
 			};
 			await this.makeRequest(payload);
 		}
@@ -1883,20 +1903,49 @@ var GoogleAnalyticsTransport = class extends AnalyticsTransport {
 		await this.sendEvent(event);
 	}
 };
-
-//#endregion
-//#region src/transports/mixpanel.transport.ts
+// src/transports/level-filter.ts
+/** Severity values of the built-in levels; lower is more severe (same scale as the logger). */
+const BUILTIN_LEVEL_VALUES = {
+	error: 0,
+	warn: 1,
+	info: 2,
+	debug: 3,
+	trace: 4,
+	verbose: 5
+};
+/** Built-in levels plus the logger's custom `levelOptions.levels`. */
+function buildLevelValues(custom) {
+	return new Map([...Object.entries(BUILTIN_LEVEL_VALUES), ...Object.entries(custom ?? {})]);
+}
+function lookup(values, level) {
+	return values.get(level) ?? values.get(level.toLowerCase());
+}
+/**
+* Whether an entry at `level` passes a transport's minimum `threshold`, using the
+* logger's scale (an entry passes when its value is <= the threshold's value).
+* The logger has already rejected unknown entry levels, so an unknown entry level
+* or threshold here does not filter.
+*/
+function meetsTransportLevel(threshold, level, values) {
+	if (!threshold) return true;
+	const min = lookup(values, threshold);
+	const actual = lookup(values, level);
+	if (min === void 0 || actual === void 0) return true;
+	return actual <= min;
+}
+// src/transports/mixpanel.transport.ts
 /**
 * Sends log entries as Mixpanel events via the Track and Engage HTTP APIs.
 *
 * @example
-* transports: { mixpanel: { token: process.env.MIXPANEL_TOKEN } }
+* analytics: { mixpanel: { token: process.env.MIXPANEL_TOKEN } }
 */
 var MixpanelTransport = class extends AnalyticsTransport {
 	constructor(config) {
 		super("mixpanel", config);
 		this.baseUrl = "https://api.mixpanel.com";
 		this.mixpanelConfig = config;
+		protectSecrets(this, ["mixpanelConfig"]);
 	}
 	async initialize() {
 		try {
@@ -2022,9 +2071,7 @@ var MixpanelTransport = class extends AnalyticsTransport {
 		await this.makeRequest("/track", [payload]);
 	}
 };
-
-//#endregion
-//#region src/version.ts
+// src/version.ts
 /**
 * The published version of this package.
 *
@@ -2033,14 +2080,12 @@ var MixpanelTransport = class extends AnalyticsTransport {
 * free of a JSON import that bundlers and consumers would have to resolve.
 */
 const LOGIXIA_VERSION = "1.12.0";
-
-//#endregion
-//#region src/transports/segment.transport.ts
+// src/transports/segment.transport.ts
 /**
 * Sends log entries as Segment track/identify events via the HTTP Tracking API.
 *
 * @example
-* transports: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
+* analytics: { segment: { writeKey: process.env.SEGMENT_WRITE_KEY } }
 */
 var SegmentTransport = class extends AnalyticsTransport {
 	constructor(config) {
@@ -2053,6 +2098,10 @@ var SegmentTransport = class extends AnalyticsTransport {
 			...config
 		};
 		this.baseUrl = config.dataPlaneUrl || "https://api.segment.io";
+		protectSecrets(this, ["segmentConfig", "baseUrl"]);
+	}
+	secretValues() {
+		return [...super.secretValues(), Buffer.from(`${this.segmentConfig.writeKey}:`).toString("base64")];
 	}
 	async initialize() {
 		try {
@@ -2120,8 +2169,8 @@ var SegmentTransport = class extends AnalyticsTransport {
 	}
 	async batchTrack(events) {
 		const chunks = this.chunkArray(events, this.segmentConfig.maxBatchSize || 100);
-		for (const chunk$1 of chunks) {
-			const payload = { batch: chunk$1 };
+		for (const chunk of chunks) {
+			const payload = { batch: chunk };
 			await this.makeRequest("/v1/batch", payload);
 		}
 	}
@@ -2298,20 +2347,24 @@ var SegmentTransport = class extends AnalyticsTransport {
 		await this.makeRequest("/v1/track", payload);
 	}
 };
-
-//#endregion
-//#region src/transports/transport.manager.ts
+// src/transports/transport.manager.ts
 function _sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 var TransportManager = class extends EventEmitter {
-	constructor(config = {}) {
+	/**
+	* @param config  Transport configuration.
+	* @param levels  The logger's `levelOptions.levels`; used with the built-in levels
+	*                to compare entries against each transport's `level`.
+	*/
+	constructor(config = {}, levels) {
 		super();
 		this.transports = /* @__PURE__ */ new Map();
 		this.metrics = /* @__PURE__ */ new Map();
 		this.isShuttingDown = false;
 		this.transportLevelPreferences = /* @__PURE__ */ new Map();
 		this.warnedPromptDeprecated = false;
+		this.levelValues = buildLevelValues(levels);
 		this.setupTransports(config);
 	}
 	setupTransports(config) {
@@ -2495,7 +2548,6 @@ var TransportManager = class extends EventEmitter {
 					case "linear":
 						wait = baseDelay * (attempt + 1);
 						break;
-					case "exponential":
 					default: wait = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
 				}
 				this.emit("transport:retry", transport.name, attempt + 1, maxRetries, wait);
@@ -2514,19 +2566,7 @@ var TransportManager = class extends EventEmitter {
 	}
 	shouldTransportHandle(transport, level, transportId) {
 		if (transportId && this.transportLevelPreferences.has(transportId)) return this.transportLevelPreferences.get(transportId).includes(level.toLowerCase());
-		if (!transport.level) return true;
-		const levels = [
-			"error",
-			"warn",
-			"info",
-			"debug",
-			"trace",
-			"verbose"
-		];
-		const transportLevelIndex = levels.indexOf(transport.level.toLowerCase());
-		const entryLevelIndex = levels.indexOf(level.toLowerCase());
-		if (transportLevelIndex === -1 || entryLevelIndex === -1) return true;
-		return entryLevelIndex <= transportLevelIndex;
+		return meetsTransportLevel(transport.level, level, this.levelValues);
 	}
 	getTransportType(transport) {
 		if (transport.name === "console") return "console";
@@ -2649,7 +2689,125 @@ var TransportManager = class extends EventEmitter {
 		internalLog("Transport level preferences cleared");
 	}
 };
+// src/utils/otel.ts
+/** W3C trace-flags bit 0: the span is sampled (`TraceFlags.SAMPLED` in the OTel API). */
+const TRACE_FLAG_SAMPLED = 1;
+let _otelApi;
+function tryLoadOtelApi() {
+	if (_otelApi !== void 0) return _otelApi;
+	try {
+		_otelApi = __require("@opentelemetry/api");
+		return _otelApi;
+	} catch {
+		_otelApi = null;
+		return null;
+	}
+}
+/**
+* Read the currently active OTel span context (if any) and return its fields
+* in a plain object suitable for spreading into a log entry.
+*
+* Returns `undefined` when:
+* - `@opentelemetry/api` is not installed
+* - No active span exists (root context)
+* - The span context is invalid (all-zeros)
+*/
+function getActiveOtelContext(opts = {}) {
+	const api = tryLoadOtelApi();
+	if (!api) return void 0;
+	try {
+		const ctx = api.context.active();
+		const sc = api.trace.getSpanContext(ctx);
+		if (!sc || !api.trace.isSpanContextValid(sc)) return void 0;
+		const isSampled = (sc.traceFlags & TRACE_FLAG_SAMPLED) === TRACE_FLAG_SAMPLED;
+		if (opts.sampledOnly && !isSampled) return void 0;
+		return {
+			traceId: sc.traceId,
+			spanId: sc.spanId,
+			traceFlags: sc.traceFlags,
+			isSampled
+		};
+	} catch {
+		return;
+	}
+}
+/**
+* Returns a metadata object with OTel context fields ready to merge into a log call,
+* using the configured field names.
+*
+* Returns `{}` when no active span exists (safe to spread unconditionally).
+*
+* @example
+* ```ts
+* await logger.info('Payment processed', {
+*   ...getOtelMetaFields(),
+*   orderId: 'ord_123',
+* });
+* ```
+*/
+function getOtelMetaFields(opts = {}) {
+	const { traceIdField = "traceId", spanIdField = "spanId", traceFlagsField = "traceFlags" } = opts;
+	const ctx = getActiveOtelContext(opts);
+	if (!ctx) return {};
+	return {
+		[traceIdField]: ctx.traceId,
+		[spanIdField]: ctx.spanId,
+		[traceFlagsField]: ctx.traceFlags
+	};
+}
+let _bridgeOptions = null;
+/**
+* Initialise the global OTel bridge.
+*
+* Once called, logixia's internal log pipeline checks for an active OTel span
+* on **every** log call and automatically merges the span context into the
+* entry's metadata — no per-call wiring needed.
+*
+* Call once at app startup, **after** the OTel SDK has been initialised:
+* ```ts
+* import { initOtelBridge } from 'logixia';
+* initOtelBridge();
+* ```
+*/
+function initOtelBridge(opts = {}) {
+	_bridgeOptions = opts;
+}
+/**
+* @internal
+* True when initOtelBridge() has been called. Lets the logger hot path skip the
+* `_getOtelPayloadIfEnabled()` call (and its `{}` allocation + Object.keys) on
+* every log when the bridge is off — the overwhelmingly common case.
+*/
+function _isOtelBridgeEnabled() {
+	return _bridgeOptions !== null;
+}
+/**
+* @internal
+* Used by the core logger to inject OTel context when the bridge is active.
+* Returns `{}` when the bridge is not initialised or no active span exists.
+*/
+function _getOtelPayloadIfEnabled() {
+	if (!_bridgeOptions) return {};
+	return getOtelMetaFields(_bridgeOptions);
+}
+/**
+* @internal
+* Payload field names the active bridge writes the trace and span ids to, or
+* `undefined` when the bridge is not initialised.
+*/
+function _getOtelBridgeFieldNames() {
+	if (!_bridgeOptions) return void 0;
+	return {
+		traceIdField: _bridgeOptions.traceIdField ?? "traceId",
+		spanIdField: _bridgeOptions.spanIdField ?? "spanId"
+	};
+}
+/**
+* Disable the OTel bridge (useful for tests).
+*/
+function disableOtelBridge() {
+	_bridgeOptions = null;
+}
+export { ConsoleTransport as _, getActiveOtelContext as a, TransportManager as c, GoogleAnalyticsTransport as d, FileTransport as f, BufferCap as g, DatabaseTransport as h, disableOtelBridge as i, SegmentTransport as l, AnalyticsTransport as m, _getOtelPayloadIfEnabled as n, getOtelMetaFields as o, DataDogTransport as p, _isOtelBridgeEnabled as r, initOtelBridge as s, _getOtelBridgeFieldNames as t, MixpanelTransport as u, stripControlChars as v };
 
-//#endregion
-export { FileTransport as a, DatabaseTransport as c, stripControlChars as d, GoogleAnalyticsTransport as i, BufferCap as l, SegmentTransport as n, DataDogTransport as o, MixpanelTransport as r, AnalyticsTransport as s, TransportManager as t, ConsoleTransport as u };
-//# sourceMappingURL=transport.manager-BiuCAJd2.mjs.map
+//# sourceMappingURL=otel-Dt5riXuE.mjs.map