logixia 1.8.2 → 1.8.4

package/dist/index.js

@@ -1,11 +1,8 @@
-const require_chunk = require('./chunk-BTgCAUrQ.js');
-const require_logitron_logger_module = require('./logitron-logger.module-Fof9Er2E.js');
-const require_transport_manager = require('./transport.manager-DU1W0wV3.js');
-require('./search-DeZHhWxB.js');
-let node_crypto = require("node:crypto");
-node_crypto = require_chunk.__toESM(node_crypto);
+const require_transport_manager = require('./transport.manager-DPjB-dFH.js');
+const require_logitron_logger_module = require('./logitron-logger.module-CMDM61Iz.js');
+require('./search-DoZF3RZj.js');
 let __nestjs_common = require("@nestjs/common");
-__nestjs_common = require_chunk.__toESM(__nestjs_common);
+__nestjs_common = require_transport_manager.__toESM(__nestjs_common);
 
 //#region src/exceptions/exception.ts
 var LogixiaException = class extends Error {
@@ -42,13 +39,16 @@ function isLogixiaException(value) {
 //#endregion
 //#region src/exceptions/builder.ts
 /**
-* Generates a trace ID using Node's built-in `crypto.randomUUID`.
-* No extra dependencies required.
+* Generates a trace ID via the shared {@link TraceContext} generator.
+*
+* Delegates to `TraceContext.instance.generate()` so any custom generator
+* configured on `TraceIdConfig.generator` is respected — avoids the silent
+* "builder has its own UUID source" divergence this module had previously.
 *
 * @example `'550e8400-e29b-41d4-a716-446655440000'`
 */
 function generateTraceId() {
-	return (0, node_crypto.randomUUID)();
+	return require_logitron_logger_module.TraceContext.instance.generate();
 }
 /** @deprecated Use `generateTraceId` instead. */
 const generateRequestId = generateTraceId;
@@ -102,24 +102,34 @@ var ErrorResponseBuilder = class {
 	* @param params - See `BuildParams`.
 	* @returns The unified error response and the HTTP status code to send.
 	*
+	* @remarks
+	* `traceId` does not need to be supplied by the caller in most cases — the
+	* builder reads `TraceContext.instance.getCurrentTraceId()` internally and
+	* falls back to the explicit `traceId` argument only when AsyncLocalStorage
+	* is empty. If neither source yields a value, `meta.trace_id` is omitted.
+	*
 	* @example In a NestJS exception filter
 	* ```ts
 	* const { response, httpStatus } = ErrorResponseBuilder.build<AppCode, AppType>({
 	*   exception,
-	*   traceId: request.headers['x-trace-id'] as string | undefined,
+	*   // Omit traceId — it will be picked up from ALS automatically.
 	*   path:    request.url,
 	*   service: process.env.SERVICE_NAME,
 	*   startTime: request.startTime,
 	* });
 	*
 	* if (process.env.NODE_ENV === 'production') delete response.debug;
-	* response.setHeader('X-Trace-ID', response.meta.trace_id);
+	* // Echo the resolved traceId back on whatever header your TraceIdConfig says —
+	* // do NOT hardcode 'X-Trace-Id', use `resolveResponseHeader(config)` instead.
+	* if (response.meta.trace_id) {
+	*   response.setHeader(resolveResponseHeader(config) ?? 'X-Trace-Id', response.meta.trace_id);
+	* }
 	* response.status(httpStatus).json(response);
 	* ```
 	*/
 	static build(params) {
 		const { exception, path, service, startTime, traceId: rawTraceId } = params;
-		const traceId = rawTraceId ?? generateTraceId();
+		const traceId = require_logitron_logger_module.TraceContext.instance.getCurrentTraceId() ?? rawTraceId;
 		const timestamp = (/* @__PURE__ */ new Date()).toISOString();
 		const durationMs = startTime !== void 0 ? Date.now() - startTime : void 0;
 		if (isLogixiaException(exception)) {
@@ -137,7 +147,7 @@ var ErrorResponseBuilder = class {
 					success: false,
 					error: errorBlock,
 					meta: {
-						trace_id: traceId,
+						...traceId !== void 0 ? { trace_id: traceId } : {},
 						timestamp,
 						path,
 						status: exception.httpStatus
@@ -168,7 +178,7 @@ var ErrorResponseBuilder = class {
 						message
 					},
 					meta: {
-						trace_id: traceId,
+						...traceId !== void 0 ? { trace_id: traceId } : {},
 						timestamp,
 						path,
 						status
@@ -188,7 +198,7 @@ var ErrorResponseBuilder = class {
 					message: "An unexpected error occurred."
 				},
 				meta: {
-					trace_id: traceId,
+					...traceId !== void 0 ? { trace_id: traceId } : {},
 					timestamp,
 					path,
 					status: 500
@@ -202,6 +212,7 @@ var ErrorResponseBuilder = class {
 
 //#endregion
 //#region src/core/nestjs-extras.ts
+var _ref;
 /**
 * Inject the Logixia logger registered in the current NestJS DI container.
 *
@@ -245,9 +256,12 @@ function LogMethod(options = {}) {
 			const start = Date.now();
 			const entry = { method: label };
 			if (logArgs && args.length > 0) entry["args"] = args;
+			const reportLogFailure = (phase, err) => {
+				process.stderr.write(`[logixia] @LogMethod(${label}) ${phase} log failed: ${String(err)}\n`);
+			};
 			if (logger$1) {
 				const logFnRaw = logger$1[level];
-				await (typeof logFnRaw === "function" ? logFnRaw : logger$1.debug).bind(logger$1)(`→ ${label}`, entry).catch(() => void 0);
+				await (typeof logFnRaw === "function" ? logFnRaw : logger$1.debug).bind(logger$1)(`→ ${label}`, entry).catch((e) => reportLogFailure("entry", e));
 			}
 			try {
 				const result = await originalMethod.apply(this, args);
@@ -258,13 +272,17 @@ function LogMethod(options = {}) {
 				if (logResult) exit["result"] = result;
 				if (logger$1) {
 					const logFnRaw = logger$1[level];
-					await (typeof logFnRaw === "function" ? logFnRaw : logger$1.debug).bind(logger$1)(`← ${label}`, exit).catch(() => void 0);
+					await (typeof logFnRaw === "function" ? logFnRaw : logger$1.debug).bind(logger$1)(`← ${label}`, exit).catch((e) => reportLogFailure("exit", e));
 				}
 				return result;
 			} catch (error) {
 				if (logger$1 && logErrors) {
 					const err = error instanceof Error ? error : new Error(String(error));
-					logger$1.error(err, `${label} durationMs=${Date.now() - start}`);
+					const errLog = logger$1.error(err, {
+						method: label,
+						durationMs: Date.now() - start
+					});
+					if (errLog !== void 0 && errLog !== null && typeof errLog.catch === "function") errLog.catch((e) => reportLogFailure("error", e));
 				}
 				throw error;
 			}
@@ -273,15 +291,16 @@ function LogMethod(options = {}) {
 	};
 }
 let LogixiaExceptionFilter = class LogixiaExceptionFilter$1 {
-	constructor(logger$1) {
+	constructor(logger$1, loggerConfig) {
 		this._logger = logger$1 ?? require_logitron_logger_module.LogixiaLoggerModule._globalLogger ?? void 0;
+		this._traceConfig = typeof (loggerConfig === null || loggerConfig === void 0 ? void 0 : loggerConfig.traceId) === "object" ? loggerConfig.traceId : void 0;
 	}
 	catch(exception, host) {
 		var _request$headers;
 		const ctx = host.switchToHttp();
 		const request = ctx.getRequest();
 		const response = ctx.getResponse();
-		const traceId = ((_request$headers = request.headers) === null || _request$headers === void 0 ? void 0 : _request$headers["x-trace-id"]) ?? request.id ?? void 0;
+		const traceId = require_logitron_logger_module.TraceContext.instance.getCurrentTraceId() ?? ((_request$headers = request.headers) === null || _request$headers === void 0 ? void 0 : _request$headers["x-trace-id"]) ?? request.id ?? void 0;
 		const { response: errorResponse, httpStatus } = ErrorResponseBuilder.build({
 			exception,
 			traceId,
@@ -293,16 +312,24 @@ let LogixiaExceptionFilter = class LogixiaExceptionFilter$1 {
 				method: request.method ?? "",
 				url: request.url ?? "",
 				status: httpStatus,
-				trace_id: errorResponse.meta.trace_id
+				...errorResponse.meta.trace_id !== void 0 ? { trace_id: errorResponse.meta.trace_id } : {}
+			};
+			const onLogFailure = (err) => {
+				process.stderr.write(`[logixia] ExceptionFilter failed to write log entry: ${String(err)}\n`);
 			};
+			let logPromise;
 			if (httpStatus >= 500) {
 				const err = exception instanceof Error ? exception : new Error(String(exception));
-				this._logger.error(err, requestMeta);
-			} else if (isLogixiaException(exception)) this._logger.warn(`[${errorResponse.error.code}] ${errorResponse.error.message}`, requestMeta);
-			else this._logger.warn(`[${httpStatus}] ${errorResponse.error.message}`, requestMeta);
+				logPromise = this._logger.error(err, requestMeta);
+			} else if (isLogixiaException(exception)) logPromise = this._logger.warn(`[${errorResponse.error.code}] ${errorResponse.error.message}`, requestMeta);
+			else logPromise = this._logger.warn(`[${httpStatus}] ${errorResponse.error.message}`, requestMeta);
+			if (logPromise && typeof logPromise.catch === "function") logPromise.catch(onLogFailure);
 		}
 		if (process.env["NODE_ENV"] === "production") delete errorResponse.debug;
-		response.setHeader("X-Trace-ID", errorResponse.meta.trace_id);
+		if (errorResponse.meta.trace_id) {
+			const traceHeader = require_logitron_logger_module.resolveResponseHeader(this._traceConfig);
+			if (traceHeader) response.setHeader(traceHeader, errorResponse.meta.trace_id);
+		}
 		if (httpStatus === 429) response.setHeader("Retry-After", "60");
 		response.status(httpStatus).json(errorResponse);
 	}
@@ -311,7 +338,9 @@ LogixiaExceptionFilter = require_logitron_logger_module.__decorate([
 	(0, __nestjs_common.Catch)(),
 	require_logitron_logger_module.__decorateParam(0, (0, __nestjs_common.Optional)()),
 	require_logitron_logger_module.__decorateParam(0, (0, __nestjs_common.Inject)(`${require_logitron_logger_module.LOGIXIA_LOGGER_PREFIX}SERVICE`)),
-	require_logitron_logger_module.__decorateMetadata("design:paramtypes", [Object])
+	require_logitron_logger_module.__decorateParam(1, (0, __nestjs_common.Optional)()),
+	require_logitron_logger_module.__decorateParam(1, (0, __nestjs_common.Inject)(require_logitron_logger_module.LOGIXIA_LOGGER_CONFIG)),
+	require_logitron_logger_module.__decorateMetadata("design:paramtypes", [Object, typeof (_ref = typeof Partial !== "undefined" && Partial) === "function" ? _ref : Object])
 ], LogixiaExceptionFilter);
 
 //#endregion
@@ -347,15 +376,18 @@ var JsonFormatter = class {
 	}
 	serializePayload(payload) {
 		const serialized = {};
-		for (const [key, value] of Object.entries(payload)) try {
-			if (value instanceof Error) serialized[key] = require_logitron_logger_module.serializeError(value);
-			else if (value instanceof Date) serialized[key] = value.toISOString();
-			else if (typeof value === "function") serialized[key] = "[Function]";
-			else if (typeof value === "symbol") serialized[key] = value.toString();
-			else if (value === void 0) serialized[key] = null;
-			else serialized[key] = value;
-		} catch {
-			serialized[key] = "[Unserializable]";
+		for (const [key, value] of Object.entries(payload)) {
+			if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
+			try {
+				if (value instanceof Error) serialized[key] = require_logitron_logger_module.serializeError(value);
+				else if (value instanceof Date) serialized[key] = value.toISOString();
+				else if (typeof value === "function") serialized[key] = "[Function]";
+				else if (typeof value === "symbol") serialized[key] = value.toString();
+				else if (value === void 0) serialized[key] = null;
+				else serialized[key] = value;
+			} catch {
+				serialized[key] = "[Unserializable]";
+			}
 		}
 		return serialized;
 	}
@@ -363,6 +395,8 @@ var JsonFormatter = class {
 
 //#endregion
 //#region src/formatters/text.formatter.ts
+const CONTROL_CHARS_RE = /[\x00-\x08\x0B-\x1F\x7F-\x9F]/g;
+const stripControls = (value) => value.replace(CONTROL_CHARS_RE, "");
 var TextFormatter = class TextFormatter {
 	constructor(options = {}) {
 		this.colorize = options.colorize ?? true;
@@ -395,18 +429,22 @@ var TextFormatter = class TextFormatter {
 		const formattedLevel = this.colorize ? `${levelColor}${this.colors.bold}${levelName.toUpperCase().padEnd(5)}${this.colors.reset}` : levelName.toUpperCase().padEnd(5);
 		parts.push(`[${formattedLevel}]`);
 		if (this.includeAppName) {
-			const appName = this.colorize ? `${this.colors.bold}${entry.appName}${this.colors.reset}` : entry.appName;
+			const safeAppName = stripControls(entry.appName);
+			const appName = this.colorize ? `${this.colors.bold}${safeAppName}${this.colors.reset}` : safeAppName;
 			parts.push(`[${appName}]`);
 		}
 		if (this.includeTraceId && entry.traceId) {
-			const traceId = this.colorize ? `${this.colors.dim}${entry.traceId}${this.colors.reset}` : entry.traceId;
+			const safeTraceId = stripControls(entry.traceId);
+			const traceId = this.colorize ? `${this.colors.dim}${safeTraceId}${this.colors.reset}` : safeTraceId;
 			parts.push(`[${traceId}]`);
 		}
 		if (this.includeContext && entry.context) {
-			const context = this.colorize ? `${this.colors.cyan}${entry.context}${this.colors.reset}` : entry.context;
+			const safeContext = stripControls(entry.context);
+			const context = this.colorize ? `${this.colors.cyan}${safeContext}${this.colors.reset}` : safeContext;
 			parts.push(`[${context}]`);
 		}
-		const message = this.colorize && entry.level === require_logitron_logger_module.LogLevel.ERROR ? `${this.colors.error}${entry.message}${this.colors.reset}` : entry.message;
+		const safeMessage = stripControls(entry.message);
+		const message = this.colorize && entry.level === require_logitron_logger_module.LogLevel.ERROR ? `${this.colors.error}${safeMessage}${this.colors.reset}` : safeMessage;
 		parts.push(message);
 		if (entry.payload && Object.keys(entry.payload).length > 0) {
 			const payload = this.formatPayload(entry.payload);