logixia 2.2.0 → 2.3.1

package/dist/{builder-CbttbixM.mjs → builder-CcRxxVwU.mjs}

@@ -1,12 +1,12 @@
 import { t as assignOwn } from "./own-property-CjFw9qwZ.mjs";
-import { s as TraceContext } from "./request-trace-txUhyyre.mjs";
-import { t as LogixiaContext } from "./async-context-1YMPGgJZ.mjs";
+import { s as TraceContext } from "./request-trace-B-S5-LVk.mjs";
+import { t as LogixiaContext } from "./async-context-DJdxbbCU.mjs";
 import { a as buildNameSet, n as DEFAULT_REDACT_QUERY_PARAMS, o as redactUrlQuery, r as SENSITIVE_KEY_NAMES, s as redactUrlsInText } from "./sensitive-names-BiBM6R1X.mjs";
-import { n as protectSecrets } from "./secret-config-Cng7XPLx.mjs";
+import { r as redactedView } from "./secret-config-BFKJrSYF.mjs";
 import { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-Cy5nF1ZL.mjs";
 import { i as stringifyForLog } from "./safe-stringify-B5p5ktFe.mjs";
 import { n as safeToString } from "./csv.utils-ZdxSod5g.mjs";
-import { c as TransportManager, n as _getOtelPayloadIfEnabled, r as _isOtelBridgeEnabled, v as stripControlChars } from "./otel-C5jBV_l_.mjs";
+import { c as TransportManager, n as _getOtelPayloadIfEnabled, r as _isOtelBridgeEnabled, v as stripControlChars } from "./otel-DWVTrsgM.mjs";
 import { i as serializeNestedErrors, r as serializeError, t as isError } from "./error.utils-B8_CwESF.mjs";
 import { constants } from "node:os";
 // src/types/index.ts
@@ -918,7 +918,7 @@ function warnOnReservedLevelNames(levels) {
 	if (clashes.length > 0) 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
+// src/core/logixia-logger.ts
 /**
 * Core Logixia Logger implementation
 *
@@ -941,6 +941,7 @@ function nowIso() {
 }
 const RESOLVED = Promise.resolve();
 const UNSERIALIZABLE = "[Unserializable]";
+const CONFIGS = /* @__PURE__ */ new WeakMap();
 const ANSI_COLORS = /* @__PURE__ */ new Map([
 	["black", "\x1B[30m"],
 	["red", "\x1B[31m"],
@@ -1018,6 +1019,16 @@ function namespacePatternToRegex(pattern) {
 }
 /** Max compiled patterns to keep in memory. Oldest entry is evicted when full. */
 const _NS_CACHE_MAX = 1e3;
+const _nsEnvNames = /* @__PURE__ */ new Map();
+function nsEnvName(ns) {
+	let name = _nsEnvNames.get(ns);
+	if (name === void 0) {
+		name = `LOGIXIA_LEVEL_${ns.split(".")[0].toUpperCase()}`;
+		if (_nsEnvNames.size >= _NS_CACHE_MAX) _nsEnvNames.clear();
+		_nsEnvNames.set(ns, name);
+	}
+	return name;
+}
 const _nsPatternCache = /* @__PURE__ */ new Map();
 /**
 * One-shot warning so operators notice runaway pattern growth.
@@ -1080,40 +1091,51 @@ function resolveInitialLevel(config) {
 * ```
 */
 var LogixiaLogger = class LogixiaLogger {
-	config;
+	get config() {
+		return CONFIGS.get(this);
+	}
+	set config(value) {
+		CONFIGS.set(this, value);
+	}
 	context;
-	timers = /* @__PURE__ */ new Map();
+	/** Created by the first time() call. */
+	timers;
 	contextData = {};
 	transportManager;
-	fieldState = /* @__PURE__ */ new Map();
+	/** Runtime field overrides; created by the first enableField() / disableField(). */
+	fieldState;
 	/** Stable fallback trace ID generated ONCE per logger instance. */
 	fallbackTraceId = TraceContext.instance.generate();
 	/** Numeric value for each known log level — built once, read on every log call. */
-	_levelValues = /* @__PURE__ */ new Map();
+	_levelValues;
 	/** Numeric threshold for the currently active log level. */
 	_minLevelValue = 2;
 	/** Level set via setLevel(); outranks every other level source until the process ends. */
 	_runtimeLevel;
 	/** `source=value` pairs already reported as unknown levels — warn once per logger. */
-	_warnedInvalidLevels = /* @__PURE__ */ new Set();
+	_warnedInvalidLevels;
 	/** Pre-built ANSI color codes to avoid recreating the object in colorize(). */
 	_colorMap = ANSI_COLORS;
 	/** Pre-computed field-enabled booleans so isFieldEnabled() isn't called per log. */
-	_fieldCache = /* @__PURE__ */ new Map();
+	_fieldCache;
+	/** False while _fieldCache is still the parent's map; it is copied before the first write. */
+	_ownsFieldCache = false;
 	/** True when contextData is non-empty — avoids Object.keys() check on hot path. */
 	_hasContextData = false;
 	/**
 	* Pre-computed `[INFO] `, `[WARN] ` etc. strings — avoids a colorize() call per log.
 	* Key: lowercase level name. Value: formatted bracket string ready to concatenate.
 	*/
-	_formattedLevels = /* @__PURE__ */ new Map();
+	_formattedLevels;
 	/** Pre-computed `[appName] ` string — avoids template literal allocation per log. */
 	_formattedAppName = "";
 	/**
 	* JSON line pieces between the timestamp and the message, keyed by level, for the
 	* appName and environment they were built from. Rebuilt when either changes.
 	*/
-	_jsonHeads = /* @__PURE__ */ new Map();
+	_jsonHeads;
+	/** Custom level shortcuts as [method, level] pairs; a child reuses its parent's list. */
+	_levelMethods;
 	_jsonHeadsApp = "";
 	_jsonHeadsEnv = "";
 	/** The `,"context":"..."` piece for `_jsonContextKey`. */
@@ -1139,41 +1161,41 @@ var LogixiaLogger = class LogixiaLogger {
 		};
 		this._nsSeenVersion = this._nsStore.version;
 		this._pluginRegistry = parent ? parent._pluginRegistry : new PluginRegistry();
-		const defaultConfig = {
-			appName: "App",
-			environment: "development",
-			traceId: true,
-			format: {
-				timestamp: true,
-				colorize: true,
-				json: false
-			},
-			silent: false,
-			levelOptions: {
-				level: LogLevel.INFO,
-				levels: {
-					[LogLevel.ERROR]: 0,
-					[LogLevel.WARN]: 1,
-					[LogLevel.INFO]: 2,
-					[LogLevel.DEBUG]: 3,
-					[LogLevel.TRACE]: 4,
-					[LogLevel.VERBOSE]: 5
-				},
-				colors: {
-					[LogLevel.ERROR]: "red",
-					[LogLevel.WARN]: "yellow",
-					[LogLevel.INFO]: "blue",
-					[LogLevel.DEBUG]: "green",
-					[LogLevel.TRACE]: "gray",
-					[LogLevel.VERBOSE]: "cyan"
-				}
-			}
-		};
 		if (parent) this.config = {
 			...config,
 			levelOptions: { ...config.levelOptions }
 		};
 		else {
+			const defaultConfig = {
+				appName: "App",
+				environment: "development",
+				traceId: true,
+				format: {
+					timestamp: true,
+					colorize: true,
+					json: false
+				},
+				silent: false,
+				levelOptions: {
+					level: LogLevel.INFO,
+					levels: {
+						[LogLevel.ERROR]: 0,
+						[LogLevel.WARN]: 1,
+						[LogLevel.INFO]: 2,
+						[LogLevel.DEBUG]: 3,
+						[LogLevel.TRACE]: 4,
+						[LogLevel.VERBOSE]: 5
+					},
+					colors: {
+						[LogLevel.ERROR]: "red",
+						[LogLevel.WARN]: "yellow",
+						[LogLevel.INFO]: "blue",
+						[LogLevel.DEBUG]: "green",
+						[LogLevel.TRACE]: "gray",
+						[LogLevel.VERBOSE]: "cyan"
+					}
+				}
+			};
 			this.config = {
 				...defaultConfig,
 				...config
@@ -1194,7 +1216,6 @@ var LogixiaLogger = class LogixiaLogger {
 			timeTaken: "[time_taken_MS]"
 		};
 		this.context = toContextLabel(context);
-		protectSecrets(this, ["config"]);
 		if (parent) {
 			this.transportManager = parent.transportManager;
 			this._sampler = parent._sampler;
@@ -1216,7 +1237,7 @@ var LogixiaLogger = class LogixiaLogger {
 			}) + "\n");
 		});
 		if (!parent) this.setupGracefulShutdown();
-		this.createCustomLevelMethods();
+		this.createCustomLevelMethods(parent);
 		if (!parent) for (const p of globalPluginRegistry._plugins) this._pluginRegistry.register(p);
 		this._buildPerfCaches(parent);
 	}
@@ -1232,28 +1253,39 @@ var LogixiaLogger = class LogixiaLogger {
 			...normalized.exit ? { exit: normalized.exit } : {}
 		});
 	}
-	createCustomLevelMethods() {
-		var _this$config$levelOpt3;
-		const levels = (_this$config$levelOpt3 = this.config.levelOptions) === null || _this$config$levelOpt3 === void 0 ? void 0 : _this$config$levelOpt3.levels;
-		warnOnReservedLevelNames(levels);
-		if (!levels) return;
+	createCustomLevelMethods(parent) {
+		if (parent) this._levelMethods = parent._levelMethods;
+		else {
+			var _this$config$levelOpt3;
+			const levels = (_this$config$levelOpt3 = this.config.levelOptions) === null || _this$config$levelOpt3 === void 0 ? void 0 : _this$config$levelOpt3.levels;
+			warnOnReservedLevelNames(levels);
+			const names = Object.keys(levels ?? {});
+			const methods = [];
+			const taken = /* @__PURE__ */ new Set();
+			const candidates = [...names.map((name) => [name, name]), ...names.map((name) => [name.toLowerCase(), name])];
+			for (const [method, levelName] of candidates) {
+				if (method in this || taken.has(method)) continue;
+				taken.add(method);
+				methods.push([method, levelName]);
+			}
+			this._levelMethods = methods;
+		}
 		const self = this;
-		const names = Object.keys(levels);
-		const define = (method, levelName) => {
-			if (!self[method]) self[method] = (message, data) => this.logLevel(levelName, message, data);
-		};
-		for (const levelName of names) define(levelName, levelName);
-		for (const levelName of names) define(levelName.toLowerCase(), levelName);
+		for (const [method, levelName] of this._levelMethods) self[method] = (message, data) => this.logLevel(levelName, message, data);
 	}
 	/**
 	* Rebuild all hot-path caches after any config mutation or level change.
 	* Keeps the actual log() call free of allocations in the common case.
 	*/
 	_buildPerfCaches(inheritFrom) {
-		var _this$config$levelOpt4, _this$config$format, _this$config$redact$p, _this$config$redact$p2;
-		if (inheritFrom && inheritFrom.fieldState.size === 0) {
+		var _inheritFrom$fieldSta, _this$config$levelOpt4, _this$config$format, _this$config$redact$p, _this$config$redact$p2;
+		if (inheritFrom && !((_inheritFrom$fieldSta = inheritFrom.fieldState) === null || _inheritFrom$fieldSta === void 0 ? void 0 : _inheritFrom$fieldSta.size)) {
 			this._levelValues = inheritFrom._levelValues;
-			this._fieldCache = new Map(inheritFrom._fieldCache);
+			this._fieldCache = inheritFrom._fieldCache;
+			inheritFrom._ownsFieldCache = false;
+			this._jsonHeads = inheritFrom._jsonHeads;
+			this._jsonHeadsApp = inheritFrom._jsonHeadsApp;
+			this._jsonHeadsEnv = inheritFrom._jsonHeadsEnv;
 			this._formattedLevels = inheritFrom._formattedLevels;
 			this._formattedAppName = inheritFrom._formattedAppName;
 			this._hasRedact = inheritFrom._hasRedact;
@@ -1275,6 +1307,8 @@ var LogixiaLogger = class LogixiaLogger {
 		const effectiveLevel = this.resolveEffectiveLevel();
 		this._minLevelValue = this._levelValues.get(effectiveLevel) ?? 2;
 		this._colorMap = ANSI_COLORS;
+		const fieldCache = this._writableFieldCache();
+		this._jsonHeads ??= /* @__PURE__ */ new Map();
 		for (const f of [
 			"timestamp",
 			"level",
@@ -1284,10 +1318,11 @@ var LogixiaLogger = class LogixiaLogger {
 			"message",
 			"payload"
 		]) {
-			var _this$config$fields;
-			if (this.fieldState.has(f)) this._fieldCache.set(f, this.fieldState.get(f));
-			else if (((_this$config$fields = this.config.fields) === null || _this$config$fields === void 0 ? void 0 : _this$config$fields[f]) === void 0) this._fieldCache.set(f, true);
-			else this._fieldCache.set(f, this.config.fields[f] !== false);
+			var _this$fieldState, _this$config$fields;
+			const own = (_this$fieldState = this.fieldState) === null || _this$fieldState === void 0 ? void 0 : _this$fieldState.get(f);
+			if (own !== void 0) fieldCache.set(f, own);
+			else if (((_this$config$fields = this.config.fields) === null || _this$config$fields === void 0 ? void 0 : _this$config$fields[f]) === void 0) fieldCache.set(f, true);
+			else fieldCache.set(f, this.config.fields[f] !== false);
 		}
 		const colorize = ((_this$config$format = this.config.format) === null || _this$config$format === void 0 ? void 0 : _this$config$format.colorize) ?? true;
 		this._formattedLevels = /* @__PURE__ */ new Map();
@@ -1329,6 +1364,13 @@ var LogixiaLogger = class LogixiaLogger {
 		else this._formattedAppName = colorize ? `${this._colorMap.get("gray")}${appNameRaw}${this._colorMap.get("reset")} ` : `${appNameRaw} `;
 		this._hasRedact = !!(this.config.redact && ((((_this$config$redact$p = this.config.redact.paths) === null || _this$config$redact$p === void 0 ? void 0 : _this$config$redact$p.length) ?? 0) > 0 || (((_this$config$redact$p2 = this.config.redact.patterns) === null || _this$config$redact$p2 === void 0 ? void 0 : _this$config$redact$p2.length) ?? 0) > 0 || !!this.config.redact.autoDetect));
 	}
+	_writableFieldCache() {
+		if (!this._ownsFieldCache) {
+			this._fieldCache = new Map(this._fieldCache);
+			this._ownsFieldCache = true;
+		}
+		return this._fieldCache;
+	}
 	/**
 	* Log at `error` level. An `Error` is logged with its message and serialized
 	* (name, message, stack) under `data.error`; a string is logged as-is.
@@ -1384,6 +1426,7 @@ var LogixiaLogger = class LogixiaLogger {
 	}
 	/** Start a named timer; finish it with {@link timeEnd}. Reusing a label restarts it. */
 	time(label) {
+		this.timers ??= /* @__PURE__ */ new Map();
 		this.timers.set(label, {
 			label,
 			startTime: Date.now()
@@ -1402,7 +1445,8 @@ var LogixiaLogger = class LogixiaLogger {
 	* ```
 	*/
 	async timeEnd(label) {
-		const timer = this.timers.get(label);
+		var _this$timers, _this$timers2;
+		const timer = (_this$timers = this.timers) === null || _this$timers === void 0 ? void 0 : _this$timers.get(label);
 		if (!timer) {
 			await this.warn(`Timer '${label}' does not exist`);
 			return;
@@ -1416,7 +1460,7 @@ var LogixiaLogger = class LogixiaLogger {
 			startTime: new Date(timer.startTime).toISOString(),
 			endTime: new Date(endTime).toISOString()
 		});
-		this.timers.delete(label);
+		(_this$timers2 = this.timers) === null || _this$timers2 === void 0 || _this$timers2.delete(label);
 		return duration;
 	}
 	async timeAsync(label, fn) {
@@ -1473,6 +1517,7 @@ var LogixiaLogger = class LogixiaLogger {
 		const canonical = canonicalLevel(level, this._levelValues);
 		if (canonical === void 0) {
 			const key = `${source}=${String(level)}`;
+			this._warnedInvalidLevels ??= /* @__PURE__ */ new Set();
 			if (!this._warnedInvalidLevels.has(key)) {
 				this._warnedInvalidLevels.add(key);
 				internalWarn(`Unknown log level '${String(level)}' from ${source}; valid levels: ${this._validLevelList()}. Falling back to the next level source (default '${LogLevel.INFO}').`);
@@ -1531,22 +1576,25 @@ var LogixiaLogger = class LogixiaLogger {
 	}
 	/** Show `fieldName` in log output, overriding the config for this logger instance. */
 	enableField(fieldName) {
+		this.fieldState ??= /* @__PURE__ */ new Map();
 		this.fieldState.set(fieldName, true);
-		this._fieldCache.set(fieldName, true);
+		this._writableFieldCache().set(fieldName, true);
 		if (fieldName === "level" || fieldName === "appName") this._buildPerfCaches();
 		internalLog(`Field '${fieldName}' enabled`);
 	}
 	/** Hide `fieldName` from log output, overriding the config for this logger instance. */
 	disableField(fieldName) {
+		this.fieldState ??= /* @__PURE__ */ new Map();
 		this.fieldState.set(fieldName, false);
-		this._fieldCache.set(fieldName, false);
+		this._writableFieldCache().set(fieldName, false);
 		if (fieldName === "level" || fieldName === "appName") this._buildPerfCaches();
 		internalLog(`Field '${fieldName}' disabled`);
 	}
 	/** Whether `fieldName` is currently shown: runtime override first, then config, default `true`. */
 	isFieldEnabled(fieldName) {
-		var _this$config$fields2;
-		if (this.fieldState.has(fieldName)) return this.fieldState.get(fieldName);
+		var _this$fieldState2, _this$config$fields2;
+		const own = (_this$fieldState2 = this.fieldState) === null || _this$fieldState2 === void 0 ? void 0 : _this$fieldState2.get(fieldName);
+		if (own !== void 0) return own;
 		if (((_this$config$fields2 = this.config.fields) === null || _this$config$fields2 === void 0 ? void 0 : _this$config$fields2[fieldName]) !== void 0) return this.config.fields[fieldName] !== false;
 		return true;
 	}
@@ -1569,7 +1617,8 @@ var LogixiaLogger = class LogixiaLogger {
 	}
 	/** Drop all runtime enable/disable overrides so field visibility follows the config again. */
 	resetFieldState() {
-		this.fieldState.clear();
+		var _this$fieldState3;
+		(_this$fieldState3 = this.fieldState) === null || _this$fieldState3 === void 0 || _this$fieldState3.clear();
 		internalLog("Field state reset to configuration defaults");
 	}
 	/** @deprecated No-op. Library code never prompts on stdin; use setTransportLevels(). */
@@ -1675,12 +1724,12 @@ var LogixiaLogger = class LogixiaLogger {
 	* ```
 	*/
 	async close() {
-		var _this$_sampler;
-		for (const [label, timer] of this.timers) await this.warn(`Timer '${label}' was not ended properly`, {
+		var _this$timers3, _this$_sampler;
+		for (const [label, timer] of this.timers ?? []) await this.warn(`Timer '${label}' was not ended properly`, {
 			startTime: new Date(timer.startTime).toISOString(),
 			duration: `${Date.now() - timer.startTime}ms (incomplete)`
 		});
-		this.timers.clear();
+		(_this$timers3 = this.timers) === null || _this$timers3 === void 0 || _this$timers3.clear();
 		if (this._parent) return;
 		if (this.transportManager) await this.transportManager.close();
 		(_this$_sampler = this._sampler) === null || _this$_sampler === void 0 || _this$_sampler.destroy();
@@ -1786,8 +1835,8 @@ var LogixiaLogger = class LogixiaLogger {
 		if (this._runtimeLevel) return this._runtimeLevel;
 		const ns = this.context;
 		if (ns) {
-			const nsKey = ns.split(".")[0].toUpperCase();
-			const envNsLevel = this._validLevel(process.env[`LOGIXIA_LEVEL_${nsKey}`], `LOGIXIA_LEVEL_${nsKey}`);
+			const envName = nsEnvName(ns);
+			const envNsLevel = this._validLevel(process.env[envName], envName);
 			if (envNsLevel) return envNsLevel;
 			const namespaceLevels = this._nsStore.levels;
 			if (Object.keys(namespaceLevels).length > 0) {
@@ -1902,6 +1951,13 @@ var LogixiaLogger = class LogixiaLogger {
 		(level === LogLevel.ERROR ? process.stderr : process.stdout).write(this.formatLog(entry) + "\n");
 	}
 };
+function loggerView() {
+	return redactedView(this, /* @__PURE__ */ new Map([["config", CONFIGS.get(this)]]));
+}
+for (const key of ["toJSON", Symbol.for("nodejs.util.inspect.custom")]) Object.defineProperty(LogixiaLogger.prototype, key, {
+	value: loggerView,
+	configurable: true
+});
 /**
 * Create a logger from `config`, with an optional default `context` label.
 *
@@ -2162,4 +2218,4 @@ var ErrorResponseBuilder = class {
 };
 export { usePlugin as _, isLogixiaException as a, DEFAULT_LOG_LEVELS as b, _shutdownRegistrySize as c, registerForShutdown as d, resetShutdownHandlers as f, globalPluginRegistry as g, PluginRegistry as h, LogixiaException as i, deregisterFromShutdown as l, redactObject as m, generateRequestId as n, LogixiaLogger as o, applyRedaction as p, generateTraceId as r, createLogger as s, ErrorResponseBuilder as t, flushOnExit as u, DEFAULT_CONFIG as v, LogLevel as x, DEFAULT_LOG_COLORS as y };
 
-//# sourceMappingURL=builder-CbttbixM.mjs.map
+//# sourceMappingURL=builder-CcRxxVwU.mjs.map