logixia 2.0.0 → 2.0.6

package/dist/{transport.manager-CXbKKdVE.js → otel-DyeH6DVR.js}

@@ -1,22 +1,17 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_internal_log = require('./internal-log-BUJYMZbE.js');
-const require_safe_stringify = require('./safe-stringify-DWo3aZp_.js');
-const require_entry_fields = require('./entry-fields-BvOLFlJ4.js');
-const require_coerce_utils = require('./coerce.utils-B-LilukN.js');
-let node_fs = require("node:fs");
-node_fs = require_chunk.__toESM(node_fs);
-let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path);
+const require_secret_config = require("./secret-config-CmK2wVkr.js");
+const require_internal_log = require("./internal-log-By4Govmu.js");
+const require_coerce_utils = require("./coerce.utils-C1C5sIX0.js");
+const require_safe_stringify = require("./safe-stringify-J3sh-7YM.js");
+const require_entry_fields = require("./entry-fields-BSLkzw18.js");
 let node_events = require("node:events");
-node_events = require_chunk.__toESM(node_events);
 let node_util = require("node:util");
-node_util = require_chunk.__toESM(node_util);
 let node_zlib = require("node:zlib");
-node_zlib = require_chunk.__toESM(node_zlib);
+let node_fs = require("node:fs");
+node_fs = require_secret_config.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_secret_config.__toESM(node_path);
 let node_stream_promises = require("node:stream/promises");
-node_stream_promises = require_chunk.__toESM(node_stream_promises);
-
-//#region src/utils/sanitize.utils.ts
+// src/utils/sanitize.utils.ts
 /**
 * Control-character stripping for text-mode log output.
 *
@@ -32,9 +27,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).
 *
@@ -44,32 +37,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(require_coerce_utils.safeToString(value));
 	}
 	constructor(config = {}) {
 		this.config = config;
 		this.name = "console";
+		this.level = config.level;
 		if (config.filter) this.filter = config.filter;
 	}
 	write(entry) {
@@ -132,10 +106,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;
 /**
@@ -151,8 +143,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 require_internal_log.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 require_internal_log.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. */
@@ -174,9 +168,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.
@@ -199,7 +191,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",
@@ -209,7 +201,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,
@@ -218,12 +210,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,
@@ -285,13 +277,23 @@ var DatabaseTransport = class {
 		this.name = "database";
 		this.batch = [];
 		this.isConnected = false;
+		require_secret_config.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 ? require_secret_config.urlSecrets(connectionString) : []
+		];
+	}
 	async write(entry) {
 		if (!this.isConnected) await this.connect();
 		this.addToBatch(entry);
@@ -352,6 +354,13 @@ var DatabaseTransport = class {
 		this.cap.enforce(this.batch);
 	}
 	async writeEntries(entries) {
+		try {
+			await this.writeEntriesUnscrubbed(entries);
+		} catch (error) {
+			throw require_secret_config.scrubError(error, this.secretValues());
+		}
+	}
+	async writeEntriesUnscrubbed(entries) {
 		switch (this.config.type) {
 			case "mongodb":
 				await this.flushToMongoDB(entries);
@@ -430,13 +439,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;
+			require_secret_config.scrubError(error, this.secretValues());
 			throw new Error(`Database connection failed: ${error}`, { cause: error });
 		}
 	}
@@ -445,7 +453,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) {
@@ -557,12 +566,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());
 		};
@@ -726,9 +736,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;
 	}
@@ -769,9 +777,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.
@@ -795,16 +801,25 @@ var AnalyticsTransport = class {
 			enableEventTracking: true,
 			...config
 		};
+		require_secret_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 require_secret_config.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 require_secret_config.scrubError(error, this.secretValues());
+		}
 	}
 	addToBatch(entry) {
 		this.batch.push(entry);
@@ -842,6 +857,7 @@ var AnalyticsTransport = class {
 			try {
 				await this.sendBatch(entriesToSend);
 			} catch (error) {
+				require_secret_config.scrubError(error, this.secretValues());
 				require_internal_log.internalError(`Analytics transport ${this.name} flush failed`, error);
 				this.batch.unshift(...error instanceof PartialBatchError ? error.unsent : entriesToSend);
 				this.cap.enforce(this.batch);
@@ -903,9 +919,7 @@ var AnalyticsTransport = class {
 		await this.ensureReady();
 	}
 };
-
-//#endregion
-//#region src/transports/datadog.transport.ts
+// src/transports/datadog.transport.ts
 const gzipAsync = (0, node_util.promisify)(node_zlib.gzip);
 const MAX_LOGS_PER_REQUEST = 1e3;
 const MAX_LOGS_PAYLOAD_BYTES = 5e6;
@@ -974,8 +988,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) {
@@ -985,6 +1003,7 @@ var DataDogTransport = class extends AnalyticsTransport {
 		this.baseUrl = `https://api.${site}`;
 		this.logsUrl = `https://http-intake.logs.${site}`;
 		this.metricsUrl = `https://api.${site}`;
+		require_secret_config.protectSecrets(this, ["datadogConfig"]);
 	}
 	async initialize() {
 		try {
@@ -1020,9 +1039,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));
@@ -1211,9 +1230,7 @@ var DataDogTransport = class extends AnalyticsTransport {
 		}
 	}
 };
-
-//#endregion
-//#region src/transports/file.transport.ts
+// src/transports/file.transport.ts
 const appendFile = (0, node_util.promisify)(node_fs.appendFile);
 const rename = (0, node_util.promisify)(node_fs.rename);
 const unlink = (0, node_util.promisify)(node_fs.unlink);
@@ -1476,7 +1493,6 @@ var FileTransport = class {
 				csvField(entry.traceId),
 				csvField(require_safe_stringify.stringifyForLog(entry.data || {}))
 			].join(",");
-			case "text":
 			default: return `${entry.timestamp.toISOString()} [${stripControlChars(require_coerce_utils.safeToString(entry.level)).toUpperCase()}] ${stripControlChars(require_coerce_utils.safeToString(entry.message))}${entry.data ? " " + require_safe_stringify.stringifyForLog(entry.data) : ""}`;
 		}
 	}
@@ -1502,22 +1518,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 });
@@ -1546,7 +1562,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;
@@ -1661,14 +1677,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 }
 * }
 */
@@ -1678,6 +1692,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;
+		require_secret_config.protectSecrets(this, ["gaConfig"]);
 	}
 	async initialize() {
 		try {
@@ -1765,10 +1780,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);
 		}
@@ -1889,20 +1904,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;
+		require_secret_config.protectSecrets(this, ["mixpanelConfig"]);
 	}
 	async initialize() {
 		try {
@@ -2028,9 +2072,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.
 *
@@ -2039,14 +2081,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) {
@@ -2059,6 +2099,10 @@ var SegmentTransport = class extends AnalyticsTransport {
 			...config
 		};
 		this.baseUrl = config.dataPlaneUrl || "https://api.segment.io";
+		require_secret_config.protectSecrets(this, ["segmentConfig", "baseUrl"]);
+	}
+	secretValues() {
+		return [...super.secretValues(), Buffer.from(`${this.segmentConfig.writeKey}:`).toString("base64")];
 	}
 	async initialize() {
 		try {
@@ -2126,8 +2170,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);
 		}
 	}
@@ -2304,20 +2348,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 node_events.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) {
@@ -2501,7 +2549,6 @@ var TransportManager = class extends node_events.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);
@@ -2520,19 +2567,7 @@ var TransportManager = class extends node_events.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";
@@ -2655,72 +2690,232 @@ var TransportManager = class extends node_events.EventEmitter {
 		require_internal_log.internalLog("Transport level preferences cleared");
 	}
 };
-
-//#endregion
-Object.defineProperty(exports, 'AnalyticsTransport', {
-  enumerable: true,
-  get: function () {
-    return AnalyticsTransport;
-  }
+// 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;
+}
+Object.defineProperty(exports, "AnalyticsTransport", {
+	enumerable: true,
+	get: function() {
+		return AnalyticsTransport;
+	}
+});
+Object.defineProperty(exports, "BufferCap", {
+	enumerable: true,
+	get: function() {
+		return BufferCap;
+	}
+});
+Object.defineProperty(exports, "ConsoleTransport", {
+	enumerable: true,
+	get: function() {
+		return ConsoleTransport;
+	}
+});
+Object.defineProperty(exports, "DataDogTransport", {
+	enumerable: true,
+	get: function() {
+		return DataDogTransport;
+	}
+});
+Object.defineProperty(exports, "DatabaseTransport", {
+	enumerable: true,
+	get: function() {
+		return DatabaseTransport;
+	}
 });
-Object.defineProperty(exports, 'BufferCap', {
-  enumerable: true,
-  get: function () {
-    return BufferCap;
-  }
+Object.defineProperty(exports, "FileTransport", {
+	enumerable: true,
+	get: function() {
+		return FileTransport;
+	}
 });
-Object.defineProperty(exports, 'ConsoleTransport', {
-  enumerable: true,
-  get: function () {
-    return ConsoleTransport;
-  }
+Object.defineProperty(exports, "GoogleAnalyticsTransport", {
+	enumerable: true,
+	get: function() {
+		return GoogleAnalyticsTransport;
+	}
+});
+Object.defineProperty(exports, "MixpanelTransport", {
+	enumerable: true,
+	get: function() {
+		return MixpanelTransport;
+	}
+});
+Object.defineProperty(exports, "SegmentTransport", {
+	enumerable: true,
+	get: function() {
+		return SegmentTransport;
+	}
+});
+Object.defineProperty(exports, "TransportManager", {
+	enumerable: true,
+	get: function() {
+		return TransportManager;
+	}
 });
-Object.defineProperty(exports, 'DataDogTransport', {
-  enumerable: true,
-  get: function () {
-    return DataDogTransport;
-  }
+Object.defineProperty(exports, "_getOtelBridgeFieldNames", {
+	enumerable: true,
+	get: function() {
+		return _getOtelBridgeFieldNames;
+	}
 });
-Object.defineProperty(exports, 'DatabaseTransport', {
-  enumerable: true,
-  get: function () {
-    return DatabaseTransport;
-  }
+Object.defineProperty(exports, "_getOtelPayloadIfEnabled", {
+	enumerable: true,
+	get: function() {
+		return _getOtelPayloadIfEnabled;
+	}
 });
-Object.defineProperty(exports, 'FileTransport', {
-  enumerable: true,
-  get: function () {
-    return FileTransport;
-  }
+Object.defineProperty(exports, "_isOtelBridgeEnabled", {
+	enumerable: true,
+	get: function() {
+		return _isOtelBridgeEnabled;
+	}
 });
-Object.defineProperty(exports, 'GoogleAnalyticsTransport', {
-  enumerable: true,
-  get: function () {
-    return GoogleAnalyticsTransport;
-  }
+Object.defineProperty(exports, "disableOtelBridge", {
+	enumerable: true,
+	get: function() {
+		return disableOtelBridge;
+	}
 });
-Object.defineProperty(exports, 'MixpanelTransport', {
-  enumerable: true,
-  get: function () {
-    return MixpanelTransport;
-  }
+Object.defineProperty(exports, "getActiveOtelContext", {
+	enumerable: true,
+	get: function() {
+		return getActiveOtelContext;
+	}
 });
-Object.defineProperty(exports, 'SegmentTransport', {
-  enumerable: true,
-  get: function () {
-    return SegmentTransport;
-  }
+Object.defineProperty(exports, "getOtelMetaFields", {
+	enumerable: true,
+	get: function() {
+		return getOtelMetaFields;
+	}
 });
-Object.defineProperty(exports, 'TransportManager', {
-  enumerable: true,
-  get: function () {
-    return TransportManager;
-  }
+Object.defineProperty(exports, "initOtelBridge", {
+	enumerable: true,
+	get: function() {
+		return initOtelBridge;
+	}
 });
-Object.defineProperty(exports, 'stripControlChars', {
-  enumerable: true,
-  get: function () {
-    return stripControlChars;
-  }
+Object.defineProperty(exports, "stripControlChars", {
+	enumerable: true,
+	get: function() {
+		return stripControlChars;
+	}
 });
-//# sourceMappingURL=transport.manager-CXbKKdVE.js.map
+
+//# sourceMappingURL=otel-DyeH6DVR.js.map