logixia 2.0.11 → 2.1.0

package/dist/{builder-C6kKEVrU.mjs → builder-CA_dokb4.mjs}

@@ -1,11 +1,12 @@
-import { a as buildNameSet, n as DEFAULT_REDACT_QUERY_PARAMS, o as redactUrlQuery, r as SENSITIVE_KEY_NAMES, s as redactUrlsInText, u as assignOwn } from "./sensitive-names-wv27qBQC.mjs";
+import { t as assignOwn } from "./own-property-CjFw9qwZ.mjs";
 import { o as TraceContext } from "./request-trace-Dekcnenb.mjs";
-import { t as LogixiaContext } from "./async-context-BGUCdYAa.mjs";
-import { n as protectSecrets } from "./secret-config-D1F4MW69.mjs";
+import { t as LogixiaContext } from "./async-context-fBqC5lNc.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-GKmb15Me.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 { i as stringifyForLog } from "./safe-stringify-pZOnzGRJ.mjs";
-import { c as TransportManager, n as _getOtelPayloadIfEnabled, r as _isOtelBridgeEnabled, v as stripControlChars } from "./otel-DAVxpArV.mjs";
+import { c as TransportManager, n as _getOtelPayloadIfEnabled, r as _isOtelBridgeEnabled, v as stripControlChars } from "./otel-b-s2QbY4.mjs";
 import { constants } from "node:os";
 // src/types/index.ts
 const LogLevel = {
@@ -711,12 +712,28 @@ function isCacheableTraceId(id) {
 	}
 	return true;
 }
+/** Maps a trace id to a stable number in [0, 1): FNV-1a followed by a murmur3 finalizer. */
+function traceFraction(id) {
+	let h = 2166136261;
+	for (let i = 0; i < id.length; i++) {
+		h ^= id.charCodeAt(i);
+		h = Math.imul(h, 16777619);
+	}
+	h ^= h >>> 16;
+	h = Math.imul(h, 2246822507);
+	h ^= h >>> 13;
+	h = Math.imul(h, 3266489909);
+	h ^= h >>> 16;
+	return (h >>> 0) / 4294967296;
+}
+const ADAPTIVE_BUCKETS = 100;
 var Sampler = class {
 	config;
 	/**
-	* Per-trace decisions in LRU order (Map preserves insertion order; a hit
-	* re-inserts the key). Survives resetStats() so a long trace is not re-decided
-	* mid-flight. Bounded by size, by an idle TTL (refreshed on hit) and by a hard
+	* Per-trace sampling fractions in LRU order (Map preserves insertion order; a
+	* hit re-inserts the key). A trace is kept at a level when its fraction is below
+	* that level's rate, so it is never fixed by the first level seen. Survives
+	* resetStats() so a long trace is not re-evaluated mid-flight. Bounded by size, by an idle TTL (refreshed on hit) and by a hard
 	* lifetime measured from the first decision.
 	*/
 	traceDecisions = /* @__PURE__ */ new Map();
@@ -725,8 +742,11 @@ var Sampler = class {
 	traceMaxLifetimeMs = 36e5;
 	_tokenBucket = 0;
 	_lastRefillMs = Date.now();
-	_adaptiveWindow = [];
-	_adaptiveHead = 0;
+	_adaptiveBucketMs;
+	_adaptiveTotals = new Float64Array(ADAPTIVE_BUCKETS);
+	_adaptiveErrorCounts = new Float64Array(ADAPTIVE_BUCKETS);
+	_adaptiveBucket = 0;
+	_adaptiveTotal = 0;
 	_adaptiveErrors = 0;
 	_stats = {
 		evaluated: 0,
@@ -737,7 +757,9 @@ var Sampler = class {
 	};
 	_statsTimer;
 	constructor(config, onStats) {
+		var _config$adaptive;
 		this.config = config;
+		this._adaptiveBucketMs = Math.max(1, Math.ceil((((_config$adaptive = config.adaptive) === null || _config$adaptive === void 0 ? void 0 : _config$adaptive.windowMs) ?? 1e4) / ADAPTIVE_BUCKETS));
 		if (config.maxLogsPerSecond && config.maxLogsPerSecond > 0) this._tokenBucket = config.maxLogsPerSecond;
 		const interval = config.statsIntervalMs ?? 6e4;
 		if (interval > 0 && onStats) {
@@ -795,34 +817,38 @@ var Sampler = class {
 	destroy() {
 		if (this._statsTimer) clearInterval(this._statsTimer);
 	}
-	_sampleByRate(level) {
+	_sampleByRate(level, fraction) {
 		var _this$config$perLevel2, _this$config$perLevel3;
 		const baseRate = ((_this$config$perLevel2 = this.config.perLevel) === null || _this$config$perLevel2 === void 0 ? void 0 : _this$config$perLevel2[level]) ?? ((_this$config$perLevel3 = this.config.perLevel) === null || _this$config$perLevel3 === void 0 ? void 0 : _this$config$perLevel3["*"]) ?? this.config.rate ?? 1;
 		const rate = Math.max(baseRate, this._adaptiveBoostRate());
 		if (rate >= 1) return true;
 		if (rate <= 0) return false;
+		if (fraction !== void 0) return fraction < rate;
 		return Math.random() < rate;
 	}
-	/** Record one evaluated sample and evict entries older than the window. O(1) amortized. */
-	_recordAdaptiveSample(level) {
-		var _this$config$adaptive;
-		const now = Date.now();
-		const windowMs = ((_this$config$adaptive = this.config.adaptive) === null || _this$config$adaptive === void 0 ? void 0 : _this$config$adaptive.windowMs) ?? 1e4;
-		const err = level === "error" || level === "fatal";
-		this._adaptiveWindow.push({
-			t: now,
-			err
-		});
-		if (err) this._adaptiveErrors += 1;
-		const cutoff = now - windowMs;
-		const win = this._adaptiveWindow;
-		while (this._adaptiveHead < win.length && win[this._adaptiveHead].t < cutoff) {
-			if (win[this._adaptiveHead].err) this._adaptiveErrors -= 1;
-			this._adaptiveHead += 1;
+	/** Moves the ring forward to the bucket holding `now`, dropping buckets that left the window. */
+	_advanceAdaptive(now) {
+		const target = Math.floor(now / this._adaptiveBucketMs);
+		if (target <= this._adaptiveBucket) return this._adaptiveBucket;
+		const steps = Math.min(target - this._adaptiveBucket, ADAPTIVE_BUCKETS);
+		for (let i = 1; i <= steps; i++) {
+			const slot = (this._adaptiveBucket + i) % ADAPTIVE_BUCKETS;
+			this._adaptiveTotal -= this._adaptiveTotals[slot];
+			this._adaptiveErrors -= this._adaptiveErrorCounts[slot];
+			this._adaptiveTotals[slot] = 0;
+			this._adaptiveErrorCounts[slot] = 0;
 		}
-		if (this._adaptiveHead >= 1024 && this._adaptiveHead * 2 >= win.length) {
-			this._adaptiveWindow = win.slice(this._adaptiveHead);
-			this._adaptiveHead = 0;
+		this._adaptiveBucket = target;
+		return target;
+	}
+	/** Record one evaluated sample in the current bucket. O(1). */
+	_recordAdaptiveSample(level) {
+		const slot = this._advanceAdaptive(Date.now()) % ADAPTIVE_BUCKETS;
+		this._adaptiveTotals[slot] += 1;
+		this._adaptiveTotal += 1;
+		if (level === "error" || level === "fatal") {
+			this._adaptiveErrorCounts[slot] += 1;
+			this._adaptiveErrors += 1;
 		}
 	}
 	/**
@@ -833,8 +859,9 @@ var Sampler = class {
 	_adaptiveBoostRate() {
 		const cfg = this.config.adaptive;
 		if (!cfg) return 0;
+		this._advanceAdaptive(Date.now());
 		const minSamples = cfg.minSamples ?? 20;
-		const total = this._adaptiveWindow.length - this._adaptiveHead;
+		const total = this._adaptiveTotal;
 		if (total < minSamples) return 0;
 		return this._adaptiveErrors / total >= (cfg.errorRateThreshold ?? .05) ? cfg.boostRate ?? 1 : 0;
 	}
@@ -843,8 +870,9 @@ var Sampler = class {
 		return this._adaptiveBoostRate() > 0;
 	}
 	/**
-	* Return the cached decision for a trace, or make and cache a new one. Entries
-	* idle past the TTL, or older than the hard lifetime, are re-decided; the least
+	* Decide a trace by comparing its stable fraction with the level's rate, caching
+	* the fraction. Entries idle past the TTL, or older than the hard lifetime, are
+	* recomputed; the least
 	* recently used entry is evicted once the cap is reached. IDs that are empty,
 	* too long or contain control characters are sampled independently and never cached.
 	*/
@@ -856,12 +884,12 @@ var Sampler = class {
 			this.traceDecisions.delete(traceId);
 			known.seenAt = now;
 			this.traceDecisions.set(traceId, known);
-			return known.emit;
+			return this._sampleByRate(level, known.fraction);
 		}
-		const emit = this._sampleByRate(level);
+		const fraction = traceFraction(traceId);
 		this.traceDecisions.delete(traceId);
 		this.traceDecisions.set(traceId, {
-			emit,
+			fraction,
 			firstAt: now,
 			seenAt: now
 		});
@@ -869,7 +897,7 @@ var Sampler = class {
 			const oldest = this.traceDecisions.keys().next().value;
 			if (oldest !== void 0) this.traceDecisions.delete(oldest);
 		}
-		return emit;
+		return this._sampleByRate(level, fraction);
 	}
 	_consumeToken() {
 		const now = Date.now();
@@ -946,7 +974,8 @@ function deregisterFromShutdown(logger) {
 * the process exits. Idempotent — the first call wins and later calls with
 * conflicting options print a warning. The process is ended with 128 + signal
 * number only when logixia's handler is the sole listener for that signal (see
-* `exit`); otherwise it just flushes and leaves shutdown to the application.
+* `exit`), closing the loggers first; otherwise it only flushes them and leaves
+* shutdown to the application.
 * Loggers are also flushed (not closed) on `beforeExit`.
 *
 * @example
@@ -973,7 +1002,8 @@ function flushOnExit(options = {}) {
 		}, timeout).unref() : void 0;
 		try {
 			if (beforeFlush) await beforeFlush();
-			await Promise.allSettled([...registry].map((logger) => logger.close()));
+			const ownsExit = shouldExit(signal);
+			await Promise.allSettled([...registry].map((logger) => ownsExit || !logger.flush ? logger.close() : logger.flush()));
 			if (afterFlush) await afterFlush();
 		} catch (err) {
 			process.stderr.write(`[logixia] Shutdown hook failed: ${String(err)}\n`);
@@ -1094,6 +1124,7 @@ function nowIso() {
 	return _tsCacheStr;
 }
 const RESOLVED = Promise.resolve();
+const UNSERIALIZABLE = "[Unserializable]";
 const JSON_STRING_FIELDS = [
 	"timestamp",
 	"level",
@@ -1130,6 +1161,21 @@ function toContextLabel(context) {
 	if (context === void 0 || context === null) return "";
 	return typeof context === "string" ? context : safeToString(context);
 }
+function serializeErrorSafely(error) {
+	try {
+		return serializeError(error);
+	} catch (cause) {
+		internalError("Error serialization failed", cause);
+		return UNSERIALIZABLE;
+	}
+}
+function errorMessageSafely(error) {
+	try {
+		return safeToString(error.message);
+	} catch {
+		return UNSERIALIZABLE;
+	}
+}
 function namespacePatternToRegex(pattern) {
 	const escaped = pattern.split(".").map((s) => s === "*" ? "[^.]+" : s.replace(/[$()*+.?[\\\]^{|}]/g, "\\$&")).join("\\.");
 	return new RegExp(`^${escaped}$`);
@@ -1345,19 +1391,25 @@ var LogixiaLogger = class LogixiaLogger {
 		});
 	}
 	createCustomLevelMethods() {
-		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()] = (message, data) => this.logLevel(levelName.toLowerCase(), message, data);
-		}
+		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;
+		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);
 	}
 	/**
 	* 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() {
-		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) ?? {});
+		var _this$config$levelOpt4, _this$config$format, _this$config$redact$p, _this$config$redact$p2;
+		const customLevelEntries = Object.entries(((_this$config$levelOpt4 = this.config.levelOptions) === null || _this$config$levelOpt4 === void 0 ? void 0 : _this$config$levelOpt4.levels) ?? {});
 		this._levelValues = new Map([
 			[LogLevel.ERROR, 0],
 			[LogLevel.WARN, 1],
@@ -1426,8 +1478,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$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];
+				var _this$config$levelOpt5;
+				let colorName = (_this$config$levelOpt5 = this.config.levelOptions) === null || _this$config$levelOpt5 === void 0 || (_this$config$levelOpt5 = _this$config$levelOpt5.colors) === null || _this$config$levelOpt5 === void 0 ? void 0 : _this$config$levelOpt5[lvl];
 				if (!colorName) {
 					if (_BUILTIN_LEVELS.has(lvl)) colorName = "white";
 					else {
@@ -1452,9 +1504,9 @@ var LogixiaLogger = class LogixiaLogger {
 	*/
 	error(messageOrError, data) {
 		try {
-			return isError(messageOrError) ? this._run("error", messageOrError.message, {
+			return isError(messageOrError) ? this._run("error", errorMessageSafely(messageOrError), {
 				...data,
-				error: serializeError(messageOrError)
+				error: serializeErrorSafely(messageOrError)
 			}) : this._run("error", messageOrError, data);
 		} catch (error) {
 			return Promise.reject(error);
@@ -1574,8 +1626,8 @@ var LogixiaLogger = class LogixiaLogger {
 	* else a `NODE_ENV` default (`debug` in development, `warn` in test), else `info`.
 	*/
 	getLevel() {
-		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;
+		var _this$config$levelOpt6;
+		return ((_this$config$levelOpt6 = this.config.levelOptions) === null || _this$config$levelOpt6 === void 0 ? void 0 : _this$config$levelOpt6.level) ?? LogLevel.INFO;
 	}
 	_validLevelList() {
 		return [...this._levelValues.keys()].join(", ");
@@ -1639,6 +1691,7 @@ var LogixiaLogger = class LogixiaLogger {
 	/** Set the context label (e.g. a class or module name) attached to every subsequent entry. */
 	setContext(context) {
 		this.context = typeof context === "string" ? context : safeToString(context);
+		this._syncNamespaceLevels();
 	}
 	/** Return the current context label, or `undefined` if none is set. */
 	getContext() {
@@ -1807,7 +1860,7 @@ var LogixiaLogger = class LogixiaLogger {
 		const config = this.config;
 		if (config.silent) return;
 		if (!this.shouldLog(level)) return;
-		const data = rawData instanceof Error ? { error: serializeError(rawData) } : rawData;
+		const data = rawData instanceof Error ? { error: serializeErrorSafely(rawData) } : rawData;
 		const alsContext = LogixiaContext.get();
 		let activeTraceId;
 		if (config.traceId) {
@@ -2034,13 +2087,7 @@ var LogixiaLogger = class LogixiaLogger {
 * ```
 */
 function createLogger(config, context) {
-	var _config$levelOptions3;
-	const logger = new LogixiaLogger(config, context);
-	const mutableLogger = logger;
-	if ((_config$levelOptions3 = config.levelOptions) === null || _config$levelOptions3 === void 0 ? void 0 : _config$levelOptions3.levels) {
-		for (const levelName of Object.keys(config.levelOptions.levels)) if (!mutableLogger[levelName]) mutableLogger[levelName] = (message, data) => logger.logLevel(levelName, message, data);
-	}
-	return logger;
+	return new LogixiaLogger(config, context);
 }
 // src/exceptions/exception.ts
 var LogixiaException = class extends Error {
@@ -2283,4 +2330,4 @@ var ErrorResponseBuilder = class {
 };
 export { DEFAULT_LOG_COLORS as C, DEFAULT_CONFIG as S, LogLevel as T, serializeError as _, isLogixiaException as a, globalPluginRegistry as b, _shutdownRegistrySize as c, registerForShutdown as d, resetShutdownHandlers as f, normalizeError as g, isError 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, serializeNestedErrors as v, DEFAULT_LOG_LEVELS as w, usePlugin as x, PluginRegistry as y };
 
-//# sourceMappingURL=builder-C6kKEVrU.mjs.map
+//# sourceMappingURL=builder-CA_dokb4.mjs.map