logixia 2.0.9 → 2.0.11

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

@@ -1,11 +1,11 @@
-import { l as assignOwn, r as SENSITIVE_KEY_NAMES } from "./sensitive-names-o__1PUUR.mjs";
-import { o as TraceContext } from "./request-trace-BgNykH9M.mjs";
-import { t as LogixiaContext } from "./async-context-COuvmwsS.mjs";
-import { n as protectSecrets } from "./secret-config-ByGq7kJd.mjs";
+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 { 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 { n as internalLog, r as internalWarn, t as internalError } from "./internal-log-Cy5nF1ZL.mjs";
-import { t as safeToString } from "./coerce.utils-B_rEudCn.mjs";
-import { i as stringifyForLog } from "./safe-stringify--7gbe95n.mjs";
-import { c as TransportManager, n as _getOtelPayloadIfEnabled, r as _isOtelBridgeEnabled, v as stripControlChars } from "./otel-DOuwGPCd.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 { constants } from "node:os";
 // src/types/index.ts
 const LogLevel = {
@@ -83,9 +83,7 @@ const DEFAULT_CONFIG = {
 * singleton is also exported for process-wide registration.
 */
 var PluginRegistry = class {
-	constructor() {
-		this._plugins = [];
-	}
+	_plugins = [];
 	/**
 	* Register a plugin. Silently skips if a plugin with the same `name` is
 	* already registered on this registry.
@@ -517,6 +515,35 @@ const CIRCULAR = "[Circular]";
 function joinPath(parent, key) {
 	return parent ? `${parent}.${key}` : key;
 }
+const CORRELATION_ID_KEYS = /* @__PURE__ */ new Set([
+	"traceid",
+	"spanid",
+	"parentspanid",
+	"requestid",
+	"correlationid",
+	"traceparent",
+	"xrequestid",
+	"xcorrelationid",
+	"xtraceid",
+	"xamzntraceid"
+]);
+const ID_SHAPED = /^[\w.:;=-]{1,256}$/;
+const DEFAULT_QUERY_NAMES = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, void 0);
+const queryNameSets = /* @__PURE__ */ new WeakMap();
+function queryNamesOf(config) {
+	const extra = config.queryParams;
+	if (!extra || extra.length === 0) return DEFAULT_QUERY_NAMES;
+	let names = queryNameSets.get(extra);
+	if (!names) {
+		names = buildNameSet(DEFAULT_REDACT_QUERY_PARAMS, extra);
+		queryNameSets.set(extra, names);
+	}
+	return names;
+}
+function isCorrelationId(fullPath, value) {
+	const key = fullPath.slice(fullPath.lastIndexOf(".") + 1);
+	return CORRELATION_ID_KEYS.has(key.toLowerCase().replace(/[-_]/g, "")) && ID_SHAPED.test(value);
+}
 function walkValue(value, state, fullPath, bare, depth) {
 	const { paths = [], excludePaths = [], patterns = [], censor = DEFAULT_CENSOR } = state.config;
 	if (paths.some((p) => matchesPath(fullPath, p) || matchesPath(bare, p))) return censor;
@@ -526,8 +553,9 @@ function walkValue(value, state, fullPath, bare, depth) {
 	}
 	if (typeof value === "string") {
 		if (patterns.length === 0) return value;
+		if (isCorrelationId(fullPath, value)) return value;
 		if (excludePaths.some((p) => matchesPath(fullPath, p) || matchesPath(bare, p))) return value;
-		return applyPatterns(value, patterns, censor);
+		return applyPatterns(value.includes("?") ? redactUrlsInText(value, queryNamesOf(state.config)) : value, patterns, censor);
 	}
 	if (Array.isArray(value)) return walkContainer(value, state, fullPath, bare, depth, walkArray);
 	if (value instanceof Error) return walkContainer(value, state, fullPath, bare, depth, walkError);
@@ -535,7 +563,7 @@ function walkValue(value, state, fullPath, bare, depth) {
 		const url = new URL(value.href);
 		url.username = "";
 		url.password = "";
-		const redacted = walkValue(url.href, state, fullPath, bare, depth);
+		const redacted = walkValue(redactUrlQuery(url.href, queryNamesOf(state.config)), state, fullPath, bare, depth);
 		return redacted === value.href ? value : redacted;
 	}
 	if (isPlainObject(value)) return walkContainer(value, state, fullPath, bare, depth, typeof value.toJSON === "function" ? walkToJSON : walkRecord);
@@ -611,14 +639,27 @@ function redactObject(obj, config, _currentPath = "") {
 	}, _currentPath, _currentPath, 0);
 	return result === obj ? { ...obj } : result;
 }
+function redactMessageObject(value, config) {
+	if (!Array.isArray(value)) return applyRedaction(value, config);
+	return value.map((item) => {
+		var _applyRedaction;
+		if (typeof item === "string") return applyRedactionToString(item, config);
+		if (item === null || typeof item !== "object") return item;
+		if (!Array.isArray(item)) return applyRedaction(item, config);
+		return (_applyRedaction = applyRedaction({ items: item }, config)) === null || _applyRedaction === void 0 ? void 0 : _applyRedaction["items"];
+	});
+}
 /**
-* Apply pattern-based redaction to a single string (e.g. the log message).
+* Apply redaction to the log message and return it as a string.
 *
-* Path-based rules don't apply to a bare string — only the `patterns` are run.
+* A string message gets only the `patterns`, because path rules don't apply to a
+* bare string. An object logged as the message (`logger.log(dto)` in NestJS) gets
+* every rule, as a payload would, before it is turned into a string.
 * Returns the input unchanged when no patterns are configured, so the hot path
 * stays allocation-free for the common no-redact case.
 */
 function applyRedactionToString(value, config) {
+	if (config && value !== null && typeof value === "object") return safeToString(redactMessageObject(value, config));
 	const text = typeof value === "string" ? value : safeToString(value);
 	if (!config) return text;
 	const resolved = resolveConfig(config);
@@ -671,23 +712,31 @@ function isCacheableTraceId(id) {
 	return true;
 }
 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
+	* lifetime measured from the first decision.
+	*/
+	traceDecisions = /* @__PURE__ */ new Map();
+	maxTrackedTraces = 1e5;
+	traceTtlMs = 3e5;
+	traceMaxLifetimeMs = 36e5;
+	_tokenBucket = 0;
+	_lastRefillMs = Date.now();
+	_adaptiveWindow = [];
+	_adaptiveHead = 0;
+	_adaptiveErrors = 0;
+	_stats = {
+		evaluated: 0,
+		emitted: 0,
+		dropped: 0,
+		byLevel: {},
+		windowStart: Date.now()
+	};
+	_statsTimer;
 	constructor(config, onStats) {
-		this.traceDecisions = /* @__PURE__ */ new Map();
-		this.maxTrackedTraces = 1e5;
-		this.traceTtlMs = 3e5;
-		this.traceMaxLifetimeMs = 36e5;
-		this._tokenBucket = 0;
-		this._lastRefillMs = Date.now();
-		this._adaptiveWindow = [];
-		this._adaptiveHead = 0;
-		this._adaptiveErrors = 0;
-		this._stats = {
-			evaluated: 0,
-			emitted: 0,
-			dropped: 0,
-			byLevel: {},
-			windowStart: Date.now()
-		};
 		this.config = config;
 		if (config.maxLogsPerSecond && config.maxLogsPerSecond > 0) this._tokenBucket = config.maxLogsPerSecond;
 		const interval = config.statsIntervalMs ?? 6e4;
@@ -1077,6 +1126,10 @@ function toJsonEntry(entry) {
 	}
 	return copy ?? entry;
 }
+function toContextLabel(context) {
+	if (context === void 0 || context === null) return "";
+	return typeof context === "string" ? context : safeToString(context);
+}
 function namespacePatternToRegex(pattern) {
 	const escaped = pattern.split(".").map((s) => s === "*" ? "[^.]+" : s.replace(/[$()*+.?[\\\]^{|}]/g, "\\$&")).join("\\.");
 	return new RegExp(`^${escaped}$`);
@@ -1145,26 +1198,58 @@ function resolveInitialLevel(config) {
 * ```
 */
 var LogixiaLogger = class LogixiaLogger {
+	config;
+	context;
+	timers = /* @__PURE__ */ new Map();
+	contextData = {};
+	transportManager;
+	fieldState = /* @__PURE__ */ new Map();
+	/** 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();
+	/** 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();
+	/** Pre-built ANSI color codes to avoid recreating the object in colorize(). */
+	_colorMap = /* @__PURE__ */ new Map();
+	/** Pre-computed field-enabled booleans so isFieldEnabled() isn't called per log. */
+	_fieldCache = /* @__PURE__ */ new Map();
+	/** 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();
+	/** 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();
+	_jsonHeadsApp = "";
+	_jsonHeadsEnv = "";
+	/** The `,"context":"..."` piece for `_jsonContextKey`. */
+	_jsonContextKey = void 0;
+	_jsonContext = "";
+	/** True when a redact config is present — short-circuits applyRedaction when false. */
+	_hasRedact = false;
+	/** Sampling engine — only created when sampling config is present. */
+	_sampler;
+	/** Per-instance plugin registry — also inherits from the global registry at creation time. */
+	_pluginRegistry;
+	/** Set on loggers created by child(); they borrow the root's transports, sampler and plugins. */
+	_parent;
+	/** Namespace level map shared by a logger and all its children; `version` bumps on every change. */
+	_nsStore;
+	/** Store version this logger's threshold was last computed against. */
+	_nsSeenVersion = 0;
 	constructor(config, context, parent) {
-		this.timers = /* @__PURE__ */ new Map();
-		this.contextData = {};
-		this.fieldState = /* @__PURE__ */ new Map();
-		this.fallbackTraceId = TraceContext.instance.generate();
-		this._levelValues = /* @__PURE__ */ new Map();
-		this._minLevelValue = 2;
-		this._warnedInvalidLevels = /* @__PURE__ */ new Set();
-		this._colorMap = /* @__PURE__ */ new Map();
-		this._fieldCache = /* @__PURE__ */ new Map();
-		this._hasContextData = false;
-		this._formattedLevels = /* @__PURE__ */ new Map();
-		this._formattedAppName = "";
-		this._jsonHeads = /* @__PURE__ */ new Map();
-		this._jsonHeadsApp = "";
-		this._jsonHeadsEnv = "";
-		this._jsonContextKey = void 0;
-		this._jsonContext = "";
-		this._hasRedact = false;
-		this._nsSeenVersion = 0;
 		this._parent = parent;
 		this._nsStore = parent ? parent._nsStore : {
 			levels: { ...config.namespaceLevels },
@@ -1220,7 +1305,7 @@ var LogixiaLogger = class LogixiaLogger {
 			payload: "[payload]",
 			timeTaken: "[time_taken_MS]"
 		};
-		this.context = context ?? "";
+		this.context = toContextLabel(context);
 		protectSecrets(this, ["config"]);
 		if (parent) {
 			this.transportManager = parent.transportManager;
@@ -1767,7 +1852,8 @@ var LogixiaLogger = class LogixiaLogger {
 			}
 			else payload = rawPayload;
 		}
-		let safeMessage = message;
+		const rawMessage = message;
+		let safeMessage = rawMessage !== null && typeof rawMessage === "object" ? safeToString(rawMessage) : message;
 		if (this._hasRedact) try {
 			safeMessage = applyRedactionToString(message, config.redact);
 		} catch (error) {
@@ -1958,6 +2044,22 @@ function createLogger(config, context) {
 }
 // src/exceptions/exception.ts
 var LogixiaException = class extends Error {
+	/** @readonly The machine-readable error code supplied by the caller. */
+	errorCode;
+	/** @readonly The error type category supplied by the caller. */
+	errorType;
+	/** @readonly HTTP status code to respond with. */
+	httpStatus;
+	/** @readonly Field pointer that caused this error (Stripe pattern). */
+	param;
+	/** @readonly Field-level validation errors (GitHub pattern). */
+	details;
+	/** @readonly Documentation URL for this error (Twilio pattern). */
+	docUrl;
+	/**
+	* @readonly Extra context for your logger — never serialised into the HTTP response.
+	*/
+	metadata;
 	constructor(options) {
 		super(options.message, { cause: options.cause });
 		this.name = "LogixiaException";
@@ -2181,4 +2283,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-BlIJNIuk.mjs.map
+//# sourceMappingURL=builder-C6kKEVrU.mjs.map