logixia 2.0.9 → 2.0.11

package/dist/{builder-Bs0qkfkY.js → builder-Up4YxX7l.js}

@@ -1,11 +1,11 @@
-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_secret_config = require("./secret-config-6hdODxBb.js");
+const require_sensitive_names = require("./sensitive-names-CNgHaqv9.js");
+const require_request_trace = require("./request-trace-C7kXMjx5.js");
+const require_async_context = require("./async-context-D8um9I5V.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-CN7icp8S.js");
-const require_otel = require("./otel-ChnVYRLA.js");
+const require_csv_utils = require("./csv.utils-CbVHY1pd.js");
+const require_safe_stringify = require("./safe-stringify-CJisLyZ3.js");
+const require_otel = require("./otel-DH6-G6DR.js");
 let node_os = require("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 = require_sensitive_names.buildNameSet(require_sensitive_names.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 = require_sensitive_names.buildNameSet(require_sensitive_names.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("?") ? require_sensitive_names.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(require_sensitive_names.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,15 +639,28 @@ 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) {
-	const text = typeof value === "string" ? value : require_coerce_utils.safeToString(value);
+	if (config && value !== null && typeof value === "object") return require_csv_utils.safeToString(redactMessageObject(value, config));
+	const text = typeof value === "string" ? value : require_csv_utils.safeToString(value);
 	if (!config) return text;
 	const resolved = resolveConfig(config);
 	if (!resolved.patterns || resolved.patterns.length === 0) return text;
@@ -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 : require_csv_utils.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 = require_request_trace.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 = require_request_trace.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);
 		require_secret_config.protectSecrets(this, ["config"]);
 		if (parent) {
 			this.transportManager = parent.transportManager;
@@ -1553,7 +1638,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 : require_coerce_utils.safeToString(context);
+		this.context = typeof context === "string" ? context : require_csv_utils.safeToString(context);
 	}
 	/** Return the current context label, or `undefined` if none is set. */
 	getContext() {
@@ -1767,7 +1852,8 @@ var LogixiaLogger = class LogixiaLogger {
 			}
 			else payload = rawPayload;
 		}
-		let safeMessage = message;
+		const rawMessage = message;
+		let safeMessage = rawMessage !== null && typeof rawMessage === "object" ? require_csv_utils.safeToString(rawMessage) : message;
 		if (this._hasRedact) try {
 			safeMessage = applyRedactionToString(message, config.redact);
 		} catch (error) {
@@ -1857,7 +1943,7 @@ var LogixiaLogger = class LogixiaLogger {
 		formatted += this._formattedAppName;
 		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 (this._fieldCache.get("message") !== false) formatted += require_otel.stripControlChars(require_csv_utils.safeToString(entry.message));
 		if (entry.payload !== void 0 && this._fieldCache.get("payload") !== false) formatted += ` ${require_safe_stringify.stringifyForLog(entry.payload)}`;
 		return formatted;
 	}
@@ -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";
@@ -2330,4 +2432,4 @@ Object.defineProperty(exports, "usePlugin", {
 	}
 });
 
-//# sourceMappingURL=builder-Bs0qkfkY.js.map
+//# sourceMappingURL=builder-Up4YxX7l.js.map