logixia 2.0.4 → 2.0.7

package/dist/{builder-M7NoaugM.js → builder-CzmM_4Ub.js}

@@ -1,10 +1,11 @@
-const require_secret_config = require("./secret-config-CBZBs0p1.js");
-const require_request_trace = require("./request-trace-wTJdKp6-.js");
-const require_async_context = require("./async-context-DTQgi8f7.js");
-const require_internal_log = require("./internal-log-b0Vp4qrB.js");
+const require_secret_config = require("./secret-config-BvFl2dC8.js");
+const require_sensitive_names = require("./sensitive-names-CHMowujD.js");
+const require_request_trace = require("./request-trace-ByujsUZk.js");
+const require_async_context = require("./async-context-Dv0bmPC-.js");
+const require_internal_log = require("./internal-log-DwqTjhpb.js");
 const require_coerce_utils = require("./coerce.utils-C1C5sIX0.js");
-const require_safe_stringify = require("./safe-stringify-DLz1Kz3o.js");
-const require_transport_manager = require("./transport.manager-DkcEOlqV.js");
+const require_safe_stringify = require("./safe-stringify-CN7icp8S.js");
+const require_otel = require("./otel-ChnVYRLA.js");
 let fast_json_stringify = require("fast-json-stringify");
 fast_json_stringify = require_secret_config.__toESM(fast_json_stringify);
 let node_os = require("node:os");
@@ -243,11 +244,10 @@ function _serializeError(error, includeStack, maxDepth, excludeFields, depth, se
 	]);
 	for (const key of Object.getOwnPropertyNames(error)) {
 		if (skip.has(key)) continue;
-		if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
 		try {
-			serialized[key] = serializeValue(errorRecord[key], maxDepth - depth - 1, seen);
+			require_sensitive_names.assignOwn(serialized, key, serializeValue(errorRecord[key], maxDepth - depth - 1, seen));
 		} catch {
-			serialized[key] = "[Unserializable]";
+			require_sensitive_names.assignOwn(serialized, key, "[Unserializable]");
 		}
 	}
 	return serialized;
@@ -282,13 +282,10 @@ function serializeValue(value, remainingDepth, seen) {
 		if (seen.has(value)) return "[Circular]";
 		seen.add(value);
 		const out = {};
-		for (const [k, v] of Object.entries(value)) {
-			if (k === "__proto__" || k === "constructor" || k === "prototype") continue;
-			try {
-				out[k] = serializeValue(v, remainingDepth - 1, seen);
-			} catch {
-				out[k] = "[Unserializable]";
-			}
+		for (const [k, v] of Object.entries(value)) try {
+			require_sensitive_names.assignOwn(out, k, serializeValue(v, remainingDepth - 1, seen));
+		} catch {
+			require_sensitive_names.assignOwn(out, k, "[Unserializable]");
 		}
 		return out;
 	}
@@ -314,111 +311,6 @@ function normalizeError(error) {
 	}
 	return new Error(String(error));
 }
-// src/utils/otel.ts
-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 & api.trace.TraceFlags.SAMPLED) === api.trace.TraceFlags.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);
-}
-/**
-* Disable the OTel bridge (useful for tests).
-*/
-function disableOtelBridge() {
-	_bridgeOptions = null;
-}
 // src/utils/redact.utils.ts
 const DEFAULT_CENSOR = "[REDACTED]";
 /** Maximum nesting depth walked; deeper values are replaced with a marker. */
@@ -448,7 +340,7 @@ const PII_CONSERVATIVE_PATTERNS = [
 /**
 * Conservative field-name paths auto-redacted by name regardless of value.
 */
-const PII_CONSERVATIVE_PATHS = require_internal_log.SENSITIVE_KEY_NAMES.map((name) => `**.${name}`);
+const PII_CONSERVATIVE_PATHS = require_sensitive_names.SENSITIVE_KEY_NAMES.map((name) => `**.${name}`);
 /**
 * Aggressive patterns: also catch personal data that could identify a person.
 * Applied when `autoDetect: 'aggressive'`.
@@ -620,10 +512,9 @@ function walkRecord(obj, state, fullPath, bare, depth) {
 	let result;
 	const entries = Object.entries(obj);
 	for (const [index, [key, value]] of entries.entries()) {
-		const forbidden = key === "__proto__" || key === "constructor" || key === "prototype";
-		const next = forbidden ? void 0 : walkValue(value, state, joinPath(fullPath, key), joinPath(bare, key), depth);
-		if ((forbidden || next !== value) && !result) result = Object.fromEntries(entries.slice(0, index));
-		if (result && !forbidden) result[key] = next;
+		const next = walkValue(value, state, joinPath(fullPath, key), joinPath(bare, key), depth);
+		if (next !== value && !result) result = Object.fromEntries(entries.slice(0, index));
+		if (result) require_sensitive_names.assignOwn(result, key, next);
 	}
 	return result ?? obj;
 }
@@ -1035,6 +926,48 @@ function resetShutdownHandlers() {
 	shutdownHandlerRegistered = false;
 	shutdownInProgress = false;
 }
+const RESERVED = /* @__PURE__ */ new Set([
+	"logLevel",
+	"time",
+	"timeEnd",
+	"timeAsync",
+	"setLevel",
+	"getLevel",
+	"setNamespaceLevels",
+	"patchNamespaceLevels",
+	"getNamespaceLevels",
+	"setContext",
+	"getContext",
+	"enableField",
+	"disableField",
+	"isFieldEnabled",
+	"getFieldState",
+	"resetFieldState",
+	"enableTransportLevelPrompting",
+	"disableTransportLevelPrompting",
+	"setTransportLevels",
+	"getTransportLevels",
+	"clearTransportLevelPreferences",
+	"getAvailableTransports",
+	"child",
+	"flush",
+	"healthCheck",
+	"close",
+	"use",
+	"unuse"
+]);
+/**
+* Warn when `levels` defines a level named like a logger method (e.g. `flush`, `child`).
+* The method keeps its normal behaviour and no level shortcut is installed for that
+* name; log at it with `logger.logLevel(name, ...)` or pick a different level name.
+* Returns the clashing names.
+*/
+function warnOnReservedLevelNames(levels) {
+	if (!levels) return [];
+	const clashes = Object.keys(levels).filter((name) => RESERVED.has(name));
+	if (clashes.length > 0) require_internal_log.internalWarn(`levelOptions.levels uses reserved logger method name(s): ${clashes.join(", ")}. No level shortcut is created for them; use logger.logLevel(name, ...) or rename the level.`);
+	return clashes;
+}
 // src/core/logitron-logger.ts
 /**
 * Core Logixia Logger implementation
@@ -1155,7 +1088,13 @@ var LogixiaLogger = class LogixiaLogger {
 		this._formattedLevels = /* @__PURE__ */ new Map();
 		this._formattedAppName = "";
 		this._hasRedact = false;
+		this._nsSeenVersion = 0;
 		this._parent = parent;
+		this._nsStore = parent ? parent._nsStore : {
+			levels: { ...config.namespaceLevels },
+			version: 0
+		};
+		this._nsSeenVersion = this._nsStore.version;
 		this._pluginRegistry = parent ? parent._pluginRegistry : new PluginRegistry();
 		const defaultConfig = {
 			appName: "App",
@@ -1211,14 +1150,14 @@ var LogixiaLogger = class LogixiaLogger {
 			this.transportManager = parent.transportManager;
 			this._sampler = parent._sampler;
 		} else if (this.config.transports) {
-			var _this$config$levelOpt;
+			var _this$config$levelOpt, _this$config$levelOpt2;
 			const transportsWithColors = { ...this.config.transports };
 			const userColors = (_this$config$levelOpt = this.config.levelOptions) === null || _this$config$levelOpt === void 0 ? void 0 : _this$config$levelOpt.colors;
 			if (userColors && transportsWithColors.console) transportsWithColors.console = {
 				...typeof transportsWithColors.console === "object" ? transportsWithColors.console : {},
 				levelColors: userColors
 			};
-			this.transportManager = new require_transport_manager.TransportManager(transportsWithColors);
+			this.transportManager = new require_otel.TransportManager(transportsWithColors, (_this$config$levelOpt2 = this.config.levelOptions) === null || _this$config$levelOpt2 === void 0 ? void 0 : _this$config$levelOpt2.levels);
 		}
 		if (!parent && this.config.sampling) this._sampler = new Sampler(this.config.sampling, (stats) => {
 			process.stdout.write(JSON.stringify({
@@ -1245,8 +1184,9 @@ var LogixiaLogger = class LogixiaLogger {
 		});
 	}
 	createCustomLevelMethods() {
-		var _this$config$levelOpt2;
-		if ((_this$config$levelOpt2 = this.config.levelOptions) === null || _this$config$levelOpt2 === void 0 ? void 0 : _this$config$levelOpt2.levels) {
+		var _this$config$levelOpt3, _this$config$levelOpt4;
+		warnOnReservedLevelNames((_this$config$levelOpt3 = this.config.levelOptions) === null || _this$config$levelOpt3 === void 0 ? void 0 : _this$config$levelOpt3.levels);
+		if ((_this$config$levelOpt4 = this.config.levelOptions) === null || _this$config$levelOpt4 === void 0 ? void 0 : _this$config$levelOpt4.levels) {
 			for (const levelName of Object.keys(this.config.levelOptions.levels)) if (!this[levelName.toLowerCase()]) this[levelName.toLowerCase()] = async (message, data) => {
 				await this.logLevel(levelName.toLowerCase(), message, data);
 			};
@@ -1257,8 +1197,8 @@ var LogixiaLogger = class LogixiaLogger {
 	* Keeps the actual log() call free of allocations in the common case.
 	*/
 	_buildPerfCaches() {
-		var _this$config$levelOpt3, _this$config$format, _this$config$redact$p, _this$config$redact$p2;
-		const customLevelEntries = Object.entries(((_this$config$levelOpt3 = this.config.levelOptions) === null || _this$config$levelOpt3 === void 0 ? void 0 : _this$config$levelOpt3.levels) ?? {});
+		var _this$config$levelOpt5, _this$config$format, _this$config$redact$p, _this$config$redact$p2;
+		const customLevelEntries = Object.entries(((_this$config$levelOpt5 = this.config.levelOptions) === null || _this$config$levelOpt5 === void 0 ? void 0 : _this$config$levelOpt5.levels) ?? {});
 		this._levelValues = new Map([
 			[LogLevel.ERROR, 0],
 			[LogLevel.WARN, 1],
@@ -1327,8 +1267,8 @@ var LogixiaLogger = class LogixiaLogger {
 		for (const [lvl] of this._levelValues) {
 			const upper = lvl.toUpperCase();
 			if (colorize && this._fieldCache.get("level") !== false) {
-				var _this$config$levelOpt4;
-				let colorName = (_this$config$levelOpt4 = this.config.levelOptions) === null || _this$config$levelOpt4 === void 0 || (_this$config$levelOpt4 = _this$config$levelOpt4.colors) === null || _this$config$levelOpt4 === void 0 ? void 0 : _this$config$levelOpt4[lvl];
+				var _this$config$levelOpt6;
+				let colorName = (_this$config$levelOpt6 = this.config.levelOptions) === null || _this$config$levelOpt6 === void 0 || (_this$config$levelOpt6 = _this$config$levelOpt6.colors) === null || _this$config$levelOpt6 === void 0 ? void 0 : _this$config$levelOpt6[lvl];
 				if (!colorName) {
 					if (_BUILTIN_LEVELS.has(lvl)) colorName = "white";
 					else {
@@ -1462,8 +1402,8 @@ var LogixiaLogger = class LogixiaLogger {
 	* else a `NODE_ENV` default (`debug` in development, `warn` in test), else `info`.
 	*/
 	getLevel() {
-		var _this$config$levelOpt5;
-		return ((_this$config$levelOpt5 = this.config.levelOptions) === null || _this$config$levelOpt5 === void 0 ? void 0 : _this$config$levelOpt5.level) ?? LogLevel.INFO;
+		var _this$config$levelOpt7;
+		return ((_this$config$levelOpt7 = this.config.levelOptions) === null || _this$config$levelOpt7 === void 0 ? void 0 : _this$config$levelOpt7.level) ?? LogLevel.INFO;
 	}
 	_validLevelList() {
 		return [...this._levelValues.keys()].join(", ");
@@ -1492,6 +1432,10 @@ var LogixiaLogger = class LogixiaLogger {
 	* (flip a module's verbosity live to chase a bug without raising global
 	* volume). The new map fully replaces the previous one.
 	*
+	* The map is shared by a logger and all its `child()` loggers: calling this on
+	* a child changes the whole family, and existing children pick the change up on
+	* their next log call.
+	*
 	* @example
 	* ```ts
 	* // Turn on debug for the DB layer only, live:
@@ -1499,20 +1443,26 @@ var LogixiaLogger = class LogixiaLogger {
 	* ```
 	*/
 	setNamespaceLevels(levels) {
-		this.config.namespaceLevels = { ...levels };
-		this._buildPerfCaches();
+		this._nsStore.levels = { ...levels };
+		this._nsStore.version++;
+		this._syncNamespaceLevels();
 	}
 	/** Merge entries into the existing per-namespace level map at runtime. */
 	patchNamespaceLevels(levels) {
-		this.config.namespaceLevels = {
-			...this.config.namespaceLevels,
+		this._nsStore.levels = {
+			...this._nsStore.levels,
 			...levels
 		};
-		this._buildPerfCaches();
+		this._nsStore.version++;
+		this._syncNamespaceLevels();
 	}
 	/** Return a copy of the current per-namespace level map. */
 	getNamespaceLevels() {
-		return { ...this.config.namespaceLevels };
+		return { ...this._nsStore.levels };
+	}
+	_syncNamespaceLevels() {
+		this._nsSeenVersion = this._nsStore.version;
+		this._minLevelValue = this._levelValues.get(this.resolveEffectiveLevel()) ?? 2;
 	}
 	/** Set the context label (e.g. a class or module name) attached to every subsequent entry. */
 	setContext(context) {
@@ -1691,15 +1641,19 @@ var LogixiaLogger = class LogixiaLogger {
 		}
 		if (this._sampler && !this._sampler.shouldEmit(level, activeTraceId)) return;
 		const hasAls = alsContext !== void 0 && Object.keys(alsContext).length > 0;
-		const otelFields = _isOtelBridgeEnabled() ? _getOtelPayloadIfEnabled() : void 0;
+		const otelFields = require_otel._isOtelBridgeEnabled() ? require_otel._getOtelPayloadIfEnabled() : void 0;
 		const hasOtel = otelFields !== void 0 && Object.keys(otelFields).length > 0;
+		const traceId = this.config.traceId ? activeTraceId ?? this.fallbackTraceId : void 0;
 		let mergedData;
-		if (hasAls) mergedData = {
-			...alsContext,
-			...hasOtel ? otelFields : {},
-			...data
-		};
-		else if (hasOtel) mergedData = {
+		if (hasAls) {
+			const als = { ...alsContext };
+			if (traceId !== void 0 && als["traceId"] === traceId) delete als["traceId"];
+			mergedData = {
+				...als,
+				...hasOtel ? otelFields : {},
+				...data
+			};
+		} else if (hasOtel) mergedData = {
 			...otelFields,
 			...data
 		};
@@ -1718,7 +1672,6 @@ var LogixiaLogger = class LogixiaLogger {
 			}
 			else payload = rawPayload;
 		}
-		const traceId = this.config.traceId ? activeTraceId ?? this.fallbackTraceId : void 0;
 		let safeMessage = message;
 		if (this._hasRedact) try {
 			safeMessage = applyRedactionToString(message, this.config.redact);
@@ -1749,6 +1702,7 @@ var LogixiaLogger = class LogixiaLogger {
 	* The level map and threshold are pre-built in _buildPerfCaches().
 	*/
 	shouldLog(level) {
+		if (this._nsSeenVersion !== this._nsStore.version) this._syncNamespaceLevels();
 		const v = this._levelValues.get(level);
 		return v !== void 0 && v <= this._minLevelValue;
 	}
@@ -1769,8 +1723,8 @@ var LogixiaLogger = class LogixiaLogger {
 			const nsKey = ns.split(".")[0].toUpperCase();
 			const envNsLevel = this._validLevel(process.env[`LOGIXIA_LEVEL_${nsKey}`], `LOGIXIA_LEVEL_${nsKey}`);
 			if (envNsLevel) return envNsLevel;
-			const namespaceLevels = this.config.namespaceLevels;
-			if (namespaceLevels) {
+			const namespaceLevels = this._nsStore.levels;
+			if (Object.keys(namespaceLevels).length > 0) {
 				const sortedPatterns = Object.keys(namespaceLevels).sort((a, b) => b.length - a.length);
 				for (const pattern of sortedPatterns) if (matchesNamespacePattern(ns, pattern)) {
 					const nsLevel = this._validLevel(namespaceLevels[pattern], `namespaceLevels['${pattern}']`);
@@ -1798,9 +1752,9 @@ var LogixiaLogger = class LogixiaLogger {
 		if (((_this$config$format4 = this.config.format) === null || _this$config$format4 === void 0 ? void 0 : _this$config$format4.timestamp) !== false && this._fieldCache.get("timestamp") !== false) formatted += `${gray}[${entry.timestamp}]${reset} `;
 		if (this._fieldCache.get("level") !== false) formatted += this._formattedLevels.get(entry.level) ?? `[${entry.level.toUpperCase()}] `;
 		formatted += this._formattedAppName;
-		if (entry.traceId && this._fieldCache.get("traceId") !== false) formatted += `${cyan}[${require_transport_manager.stripControlChars(String(entry.traceId))}]${reset} `;
-		if (entry.context && this._fieldCache.get("context") !== false) formatted += `${yellow}[${require_transport_manager.stripControlChars(String(entry.context))}]${reset} `;
-		if (this._fieldCache.get("message") !== false) formatted += require_transport_manager.stripControlChars(require_coerce_utils.safeToString(entry.message));
+		if (entry.traceId && this._fieldCache.get("traceId") !== false) formatted += `${cyan}[${require_otel.stripControlChars(String(entry.traceId))}]${reset} `;
+		if (entry.context && this._fieldCache.get("context") !== false) formatted += `${yellow}[${require_otel.stripControlChars(String(entry.context))}]${reset} `;
+		if (this._fieldCache.get("message") !== false) formatted += require_otel.stripControlChars(require_coerce_utils.safeToString(entry.message));
 		if (entry.payload !== void 0 && this._fieldCache.get("payload") !== false) formatted += ` ${require_safe_stringify.stringifyForLog(entry.payload)}`;
 		return formatted;
 	}
@@ -2159,12 +2113,6 @@ Object.defineProperty(exports, "deregisterFromShutdown", {
 		return deregisterFromShutdown;
 	}
 });
-Object.defineProperty(exports, "disableOtelBridge", {
-	enumerable: true,
-	get: function() {
-		return disableOtelBridge;
-	}
-});
 Object.defineProperty(exports, "flushOnExit", {
 	enumerable: true,
 	get: function() {
@@ -2183,30 +2131,12 @@ Object.defineProperty(exports, "generateTraceId", {
 		return generateTraceId;
 	}
 });
-Object.defineProperty(exports, "getActiveOtelContext", {
-	enumerable: true,
-	get: function() {
-		return getActiveOtelContext;
-	}
-});
-Object.defineProperty(exports, "getOtelMetaFields", {
-	enumerable: true,
-	get: function() {
-		return getOtelMetaFields;
-	}
-});
 Object.defineProperty(exports, "globalPluginRegistry", {
 	enumerable: true,
 	get: function() {
 		return globalPluginRegistry;
 	}
 });
-Object.defineProperty(exports, "initOtelBridge", {
-	enumerable: true,
-	get: function() {
-		return initOtelBridge;
-	}
-});
 Object.defineProperty(exports, "isError", {
 	enumerable: true,
 	get: function() {
@@ -2256,4 +2186,4 @@ Object.defineProperty(exports, "usePlugin", {
 	}
 });
 
-//# sourceMappingURL=builder-M7NoaugM.js.map
+//# sourceMappingURL=builder-CzmM_4Ub.js.map