logixia 1.4.0 → 1.6.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as SamplingConfig, E as TraceIdExtractorConfig, G as RequestTiming, H as HttpRequest, S as RequestContext, T as TraceIdConfig, U as HttpResponse, V as HttpError, W as RequestMetrics, _ as LogLevelString, a as Environment, b as NamespaceLevels, c as GracefulShutdownConfig, d as ILogger, f as ILoggerDefault, g as LogLevel, h as LogFieldKey, i as DEFAULT_LOG_LEVELS, l as IBaseLogger, m as LogEntry, n as CustomLevelMethods, o as ErrorSerializationOptions, p as LogColor, r as DEFAULT_LOG_COLORS, s as ExtractLevels, t as ContextData, u as ILogFormatter, v as LoggerConfig, w as TimingEntry, x as RedactConfig, y as LoggerWithLevels } from "./index-t-ActikQ.js";
-import { a as LogixiaOptionsFactory, c as LogixiaLoggerService, d as LogixiaPlugin, f as PluginRegistry, i as LogixiaLoggerModule, l as LogixiaLogger, m as usePlugin, n as LOGIXIA_LOGGER_PREFIX, o as WebSocketTraceInterceptor, p as globalPluginRegistry, r as LogixiaAsyncOptions, s as KafkaTraceInterceptor, t as LOGIXIA_LOGGER_CONFIG, u as createLogger$1 } from "./logitron-logger.module-9vOhKWDG.js";
+import { C as SamplingConfig, E as TraceIdExtractorConfig, G as RequestTiming, H as HttpRequest, S as RequestContext, T as TraceIdConfig, U as HttpResponse, V as HttpError, W as RequestMetrics, _ as LogLevelString, a as Environment, b as NamespaceLevels, c as GracefulShutdownConfig, d as ILogger, f as ILoggerDefault, g as LogLevel, h as LogFieldKey, i as DEFAULT_LOG_LEVELS, l as IBaseLogger, m as LogEntry, n as CustomLevelMethods, o as ErrorSerializationOptions, p as LogColor, r as DEFAULT_LOG_COLORS, s as ExtractLevels, t as ContextData, u as ILogFormatter, v as LoggerConfig, w as TimingEntry, x as RedactConfig, y as LoggerWithLevels } from "./index-C0sp2BVU.js";
+import { a as LogixiaOptionsFactory, c as LogixiaLoggerService, d as createLogger$1, f as LogixiaPlugin, h as usePlugin, i as LogixiaLoggerModule, l as LogixiaServiceWithLevels, m as globalPluginRegistry, n as LOGIXIA_LOGGER_PREFIX, o as WebSocketTraceInterceptor, p as PluginRegistry, r as LogixiaAsyncOptions, s as KafkaTraceInterceptor, t as LOGIXIA_LOGGER_CONFIG, u as LogixiaLogger } from "./logitron-logger.module-NI0xuTJj.js";
 import "./search-Cg_OasF-.js";
 import { ArgumentsHost, ExceptionFilter } from "@nestjs/common";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -60,8 +60,23 @@ interface LogMethodOptions {
  */
 declare function LogMethod(options?: LogMethodOptions): MethodDecorator;
 /**
- * Global NestJS exception filter that logs every unhandled exception with full
- * request context (method, URL, status) before delegating the response.
+ * Global NestJS exception filter that converts any exception into the standard
+ * `LogixiaErrorResponse` wire format and logs it with full request context.
+ *
+ * Handles three exception types in priority order:
+ *  1. `LogixiaException`     — typed fields used directly
+ *  2. NestJS `HttpException` — status + message extracted
+ *  3. Unknown / plain Error  — falls back to 500 `server_error`
+ *
+ * **Debug stripping in production:**
+ * The `debug` block is automatically stripped when `NODE_ENV === 'production'`.
+ *
+ * **Trace ID headers:**
+ * `X-Trace-ID` and `X-Request-ID` are echoed back on every error response so
+ * clients can correlate with server logs.
+ *
+ * **Retry-After header:**
+ * Automatically added for `429` responses (`Retry-After: 60`).
  *
  * Register in `main.ts`:
  * ```ts
@@ -543,6 +558,267 @@ interface SamplingStats {
   windowStart: number;
 }
 //#endregion
+//#region src/exceptions/types.d.ts
+/**
+ * Unified error response shape for logixia.
+ *
+ * Design-inspired by Stripe (`type` + `code` + `param`), GitHub (`details[]`),
+ * Twilio (`doc_url`), and Cloudflare (`success: false` envelope).
+ *
+ * The shape is intentionally framework-agnostic — it works for HTTP, WebSocket,
+ * Queue/RPC, and any other transport. Your exception filter is responsible for
+ * serialising it onto the wire.
+ *
+ * @template TCode - Union of valid error code strings you define (e.g. `'PE-AUTH-001' | 'PE-USR-001'`).
+ *                   Defaults to `string` for untyped usage.
+ * @template TType - Union of valid error type strings you define (e.g. `'authentication_error' | 'validation_error'`).
+ *                   Defaults to `string` for untyped usage.
+ *
+ * @example Fully typed usage
+ * ```ts
+ * type AppCode = 'PE-AUTH-001' | 'PE-VAL-001';
+ * type AppType = 'authentication_error' | 'validation_error';
+ *
+ * const response: LogixiaErrorResponse<AppCode, AppType> = { ... };
+ * ```
+ */
+interface LogixiaErrorResponse<TCode extends string = string, TType extends string = string> {
+  /** Always `false` — allows `if (response.success)` branching on the client. */
+  success: false;
+  error: {
+    /**
+     * Broad category that tells the client **how** to handle this error.
+     * e.g. `'validation_error'` → show field errors; `'authentication_error'` → redirect to login.
+     */
+    type: TType;
+    /**
+     * Machine-readable, stable error identifier.
+     * e.g. `'PE-AUTH-001'` — never changes; safe to switch/match on.
+     */
+    code: TCode;
+    /**
+     * Human-readable message shown to the end-user.
+     * May change between releases — do not rely on it programmatically.
+     */
+    message: string;
+    /**
+     * The specific request field that caused this error (Stripe pattern).
+     * e.g. `'email'` | `'metadata.name'`
+     */
+    param?: string;
+    /**
+     * Array of field-level errors for batch validation failures (GitHub pattern).
+     * Only present when more than one field is invalid.
+     */
+    details?: ErrorDetail[];
+    /**
+     * Documentation URL for this specific error (Twilio pattern).
+     * e.g. `'https://docs.example.com/errors/PE-AUTH-001'`
+     */
+    doc_url?: string;
+  };
+  meta: {
+    /** ULID / UUID-based request identifier for log correlation. */
+    request_id: string;
+    /** ISO 8601 timestamp of when the error was produced. */
+    timestamp: string;
+    /** Request path that caused the error. e.g. `'/api/v1/auth/login'` */
+    path: string;
+    /** HTTP status code mirrored in the body for clients that can't read headers. */
+    status: number;
+  };
+  /**
+   * Developer / diagnostic context.
+   *
+   * ⚠️ **Strip this in production.** The `ErrorResponseBuilder` always populates it
+   * (when possible); your exception filter should call `delete response.debug` before
+   * sending the response when `NODE_ENV === 'production'`.
+   */
+  debug?: {
+    /** Full stack trace of the underlying error. */
+    stack?: string;
+    /** Serialised `error.cause` (ES 2022 chained errors). */
+    cause?: string;
+    /** Originating micro-service name. e.g. `'gatekeeper'` | `'worker'` */
+    service?: string;
+    /** Wall-clock time in ms from `request.startTime` to error handling. */
+    duration_ms?: number;
+  };
+}
+/**
+ * A single field-level validation error (GitHub pattern).
+ *
+ * @example
+ * ```ts
+ * { field: 'email', message: 'must be a valid email address', code: 'invalid_format' }
+ * { field: 'password', message: 'required',                   code: 'required'       }
+ * ```
+ */
+interface ErrorDetail {
+  /** Dot-notation field path. e.g. `'email'` | `'user.address.zip'` */
+  field: string;
+  /** Human-readable reason this field failed. */
+  message: string;
+  /**
+   * Machine-readable failure code for this field.
+   * Suggested values: `'required'` | `'invalid_format'` | `'too_long'` | `'too_short'` |
+   * `'out_of_range'` | `'invalid_enum_value'` | `'duplicate'`
+   */
+  code: string;
+}
+//#endregion
+//#region src/exceptions/builder.d.ts
+/** Input parameters for `ErrorResponseBuilder.build`. */
+interface BuildParams {
+  /** The caught exception — any type. */
+  exception: unknown;
+  /**
+   * Request / correlation ID to embed in `meta.request_id`.
+   * If omitted a UUID-based ID is auto-generated: `req_<uuid without dashes>`.
+   */
+  requestId?: string | undefined;
+  /** Request path. e.g. `'/api/v1/auth/login'` */
+  path: string;
+  /**
+   * Originating service name for `debug.service`.
+   * e.g. `process.env.SERVICE_NAME` → `'gatekeeper'`
+   */
+  service?: string | undefined;
+  /**
+   * `Date.now()` captured at the start of the request.
+   * When present, `debug.duration_ms` is computed automatically.
+   */
+  startTime?: number | undefined;
+}
+/**
+ * Generates a `req_` prefixed request ID using Node's built-in `crypto.randomUUID`.
+ * No extra dependencies required.
+ *
+ * @example `'req_550e8400e29b41d4a716446655440000'`
+ */
+declare function generateRequestId(): string;
+declare class ErrorResponseBuilder {
+  /**
+   * Build a `LogixiaErrorResponse` from any thrown value.
+   *
+   * @param params - See `BuildParams`.
+   * @returns The unified error response and the HTTP status code to send.
+   *
+   * @example In a NestJS exception filter
+   * ```ts
+   * const { response, httpStatus } = ErrorResponseBuilder.build<AppCode, AppType>({
+   *   exception,
+   *   requestId: request.headers['x-trace-id'] as string | undefined,
+   *   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.request_id);
+   * response.status(httpStatus).json(response);
+   * ```
+   */
+  static build<TCode extends string = string, TType extends string = string>(params: BuildParams): {
+    response: LogixiaErrorResponse<TCode, TType>;
+    httpStatus: number;
+  };
+}
+//#endregion
+//#region src/exceptions/exception.d.ts
+/**
+ * Constructor options for `LogixiaException`.
+ *
+ * All user-supplied fields — logixia only owns the wire format.
+ */
+interface LogixiaExceptionOptions<TCode extends string = string, TType extends string = string> {
+  /**
+   * Machine-readable, stable error code.
+   * e.g. `'PE-AUTH-001'`
+   */
+  code: TCode;
+  /**
+   * Broad error type category.
+   * e.g. `'authentication_error'` | `'validation_error'` | `'rate_limit_error'`
+   */
+  type: TType;
+  /**
+   * HTTP status code to send on the wire.
+   * e.g. `401` | `400` | `429` | `500`
+   */
+  httpStatus: number;
+  /**
+   * Human-readable message for the end-user.
+   * This IS sent in the response body — keep it safe (no internal paths, etc.).
+   */
+  message: string;
+  /**
+   * The specific request field that caused this error (Stripe pattern).
+   * e.g. `'email'` | `'metadata.name'`
+   */
+  param?: string;
+  /**
+   * Array of per-field validation errors (GitHub pattern).
+   * Typically used for `400` / `422` validation failures.
+   */
+  details?: ErrorDetail[];
+  /**
+   * Documentation URL for this error (Twilio pattern).
+   * e.g. `'https://docs.example.com/errors/PE-AUTH-001'`
+   */
+  docUrl?: string;
+  /**
+   * Original error for ES 2022 cause chaining.
+   * Serialised into `debug.cause` by the `ErrorResponseBuilder`.
+   * Never sent to the client in production.
+   */
+  cause?: Error;
+  /**
+   * Arbitrary metadata for logging purposes only.
+   * This is **never** included in the HTTP response — it is passed to your
+   * logger / monitoring integrations through the exception object.
+   *
+   * @example
+   * ```ts
+   * metadata: { userId: 'u_abc', attemptCount: 3 }
+   * ```
+   */
+  metadata?: Record<string, unknown>;
+}
+declare class LogixiaException<TCode extends string = string, TType extends string = string> extends Error {
+  /** @readonly The machine-readable error code supplied by the caller. */
+  readonly errorCode: TCode;
+  /** @readonly The error type category supplied by the caller. */
+  readonly errorType: TType;
+  /** @readonly HTTP status code to respond with. */
+  readonly httpStatus: number;
+  /** @readonly Field pointer that caused this error (Stripe pattern). */
+  readonly param: string | undefined;
+  /** @readonly Field-level validation errors (GitHub pattern). */
+  readonly details: ErrorDetail[] | undefined;
+  /** @readonly Documentation URL for this error (Twilio pattern). */
+  readonly docUrl: string | undefined;
+  /**
+   * @readonly Extra context for your logger — never serialised into the HTTP response.
+   */
+  readonly metadata: Record<string, unknown> | undefined;
+  constructor(options: LogixiaExceptionOptions<TCode, TType>);
+}
+/**
+ * Returns `true` when `value` is a `LogixiaException` instance.
+ *
+ * Useful in exception filters or middleware that need to distinguish a
+ * `LogixiaException` from a plain `Error` or a framework `HttpException`.
+ *
+ * @example
+ * ```ts
+ * if (isLogixiaException(err)) {
+ *   console.log(err.errorCode, err.httpStatus);
+ * }
+ * ```
+ */
+declare function isLogixiaException<TCode extends string = string, TType extends string = string>(value?: unknown): value is LogixiaException<TCode, TType>;
+//#endregion
 //#region src/metrics.d.ts
 /**
  * Increment a counter on each matching log entry.
@@ -800,5 +1076,5 @@ declare const logger: LogixiaLogger<{
   outputs: string[];
 }>;
 //#endregion
-export { type CompiledSchema, ContextData, type CounterConfig, CustomLevelMethods, DEFAULT_CONFIG, DEFAULT_LOG_COLORS, DEFAULT_LOG_LEVELS, DEFAULT_TRACE_HEADERS, Environment, ErrorSerializationOptions, ExtractLevels, FlushOnExitOptions, type GaugeConfig, GracefulShutdownConfig, type HistogramConfig, HttpError, HttpRequest, HttpResponse, IBaseLogger, ILogFormatter, ILogger, ILoggerDefault, InjectLogger, JsonFormatter, KafkaTraceInterceptor, LOGIXIA_LOGGER_CONFIG, LOGIXIA_LOGGER_PREFIX, LogColor, type LogContext, LogEntry, type LogFieldDef, LogFieldKey, type LogFieldType, LogLevel, LogLevelString, LogMethod, type LogMethodOptions, type LogSchema, LoggerConfig, LoggerConfig as LoggerConfigInterface, type LoggerLike, LoggerWithLevels, LogixiaAsyncOptions, LogixiaContext, LogixiaExceptionFilter, LogixiaLogger, LogixiaLoggerModule, LogixiaLoggerService, LogixiaOptionsFactory, type LogixiaPlugin, type MetricConfig, type MetricsMap, MetricsPlugin, NamespaceLevels, type OtelBridgeOptions, type OtelSpanContext, PluginRegistry, type RedactConfig, RequestContext, RequestMetrics, RequestTiming, SamplingConfig, type SamplingStats, TextFormatter, TimingEntry, TraceIdConfig, TraceIdExtractorConfig, type TypedLogger, WebSocketTraceInterceptor, applyRedaction, createExpressContextMiddleware, createFastifyContextHook, createLogger, createLoggerService, createMetricsPlugin, createTraceMiddleware, createTypedLogger, defineLogSchema, deregisterFromShutdown, disableOtelBridge, extractTraceId, flushOnExit, generateTraceId, getActiveOtelContext, getCurrentTraceId, getOtelMetaFields, globalPluginRegistry, initOtelBridge, isError, logger, normalizeError, redactObject, registerForShutdown, resetShutdownHandlers, runWithTraceId, serializeError, setTraceId, traceStorage, usePlugin };
+export { type BuildParams, type CompiledSchema, ContextData, type CounterConfig, CustomLevelMethods, DEFAULT_CONFIG, DEFAULT_LOG_COLORS, DEFAULT_LOG_LEVELS, DEFAULT_TRACE_HEADERS, Environment, type ErrorDetail, ErrorResponseBuilder, ErrorSerializationOptions, ExtractLevels, FlushOnExitOptions, type GaugeConfig, GracefulShutdownConfig, type HistogramConfig, HttpError, HttpRequest, HttpResponse, IBaseLogger, ILogFormatter, ILogger, ILoggerDefault, InjectLogger, JsonFormatter, KafkaTraceInterceptor, LOGIXIA_LOGGER_CONFIG, LOGIXIA_LOGGER_PREFIX, LogColor, type LogContext, LogEntry, type LogFieldDef, LogFieldKey, type LogFieldType, LogLevel, LogLevelString, LogMethod, type LogMethodOptions, type LogSchema, LoggerConfig, LoggerConfig as LoggerConfigInterface, type LoggerLike, LoggerWithLevels, LogixiaAsyncOptions, LogixiaContext, type LogixiaErrorResponse, LogixiaException, LogixiaExceptionFilter, type LogixiaExceptionOptions, LogixiaLogger, LogixiaLoggerModule, LogixiaLoggerService, LogixiaOptionsFactory, type LogixiaPlugin, LogixiaServiceWithLevels, type MetricConfig, type MetricsMap, MetricsPlugin, NamespaceLevels, type OtelBridgeOptions, type OtelSpanContext, PluginRegistry, type RedactConfig, RequestContext, RequestMetrics, RequestTiming, SamplingConfig, type SamplingStats, TextFormatter, TimingEntry, TraceIdConfig, TraceIdExtractorConfig, type TypedLogger, WebSocketTraceInterceptor, applyRedaction, createExpressContextMiddleware, createFastifyContextHook, createLogger, createLoggerService, createMetricsPlugin, createTraceMiddleware, createTypedLogger, defineLogSchema, deregisterFromShutdown, disableOtelBridge, extractTraceId, flushOnExit, generateRequestId, generateTraceId, getActiveOtelContext, getCurrentTraceId, getOtelMetaFields, globalPluginRegistry, initOtelBridge, isError, isLogixiaException, logger, normalizeError, redactObject, registerForShutdown, resetShutdownHandlers, runWithTraceId, serializeError, setTraceId, traceStorage, usePlugin };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/nestjs-extras.ts","../src/formatters/json.formatter.ts","../src/formatters/text.formatter.ts","../src/utils/error.utils.ts","../src/utils/otel.ts","../src/utils/redact.utils.ts","../src/utils/shutdown.utils.ts","../src/utils/trace.utils.ts","../src/utils/typed-logger.ts","../src/context/async-context.ts","../src/utils/sampling.utils.ts","../src/metrics.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/core/nestjs-extras.ts","../src/formatters/json.formatter.ts","../src/formatters/text.formatter.ts","../src/utils/error.utils.ts","../src/utils/otel.ts","../src/utils/redact.utils.ts","../src/utils/shutdown.utils.ts","../src/utils/trace.utils.ts","../src/utils/typed-logger.ts","../src/context/async-context.ts","../src/utils/sampling.utils.ts","../src/exceptions/types.ts","../src/exceptions/builder.ts","../src/exceptions/exception.ts","../src/metrics.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js

@@ -1,10 +1,204 @@
 const require_chunk = require('./chunk-BTgCAUrQ.js');
-const require_logitron_logger_module = require('./logitron-logger.module-CCnX7GwK.js');
+const require_logitron_logger_module = require('./logitron-logger.module-B_VVi3P9.js');
 const require_transport_manager = require('./transport.manager-DVTM978M.js');
 require('./search-DeZHhWxB.js');
 let __nestjs_common = require("@nestjs/common");
 __nestjs_common = require_chunk.__toESM(__nestjs_common);
+let node_crypto = require("node:crypto");
+node_crypto = require_chunk.__toESM(node_crypto);
 
+//#region src/exceptions/exception.ts
+var LogixiaException = class extends Error {
+	constructor(options) {
+		super(options.message, { cause: options.cause });
+		this.name = "LogixiaException";
+		this.errorCode = options.code;
+		this.errorType = options.type;
+		this.httpStatus = options.httpStatus;
+		this.param = options.param;
+		this.details = options.details;
+		this.docUrl = options.docUrl;
+		this.metadata = options.metadata;
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+/**
+* Returns `true` when `value` is a `LogixiaException` instance.
+*
+* Useful in exception filters or middleware that need to distinguish a
+* `LogixiaException` from a plain `Error` or a framework `HttpException`.
+*
+* @example
+* ```ts
+* if (isLogixiaException(err)) {
+*   console.log(err.errorCode, err.httpStatus);
+* }
+* ```
+*/
+function isLogixiaException(value) {
+	return value instanceof LogixiaException;
+}
+
+//#endregion
+//#region src/exceptions/builder.ts
+/**
+* Generates a `req_` prefixed request ID using Node's built-in `crypto.randomUUID`.
+* No extra dependencies required.
+*
+* @example `'req_550e8400e29b41d4a716446655440000'`
+*/
+function generateRequestId() {
+	return `req_${(0, node_crypto.randomUUID)().replaceAll("-", "")}`;
+}
+/**
+* Maps an HTTP status code to a human-friendly error type string.
+* Used as a fallback when the exception is a generic `HttpException`.
+*/
+function httpStatusToType(status) {
+	if (status === 400) return "api_error";
+	if (status === 401) return "authentication_error";
+	if (status === 402) return "payment_error";
+	if (status === 403) return "authorization_error";
+	if (status === 404) return "not_found_error";
+	if (status === 408) return "timeout_error";
+	if (status === 409) return "conflict_error";
+	if (status === 422) return "validation_error";
+	if (status === 429) return "rate_limit_error";
+	if (status >= 500) return "server_error";
+	if (status >= 400) return "api_error";
+	return "server_error";
+}
+/**
+* Duck-type check for NestJS `HttpException`.
+* Avoids a hard import on `@nestjs/common` so the builder is usable outside NestJS.
+*/
+function isHttpException(value) {
+	return typeof value === "object" && value !== null && typeof value["getStatus"] === "function" && typeof value["getResponse"] === "function";
+}
+/**
+* Builds the optional `debug` block from an error.
+* Returns `undefined` when there is nothing useful to include.
+*/
+function buildDebug(error, service, durationMs) {
+	const stack = error instanceof Error ? error.stack : void 0;
+	const causeRaw = error instanceof Error ? error.cause : void 0;
+	let cause;
+	if (causeRaw instanceof Error) cause = causeRaw.message;
+	else if (causeRaw !== void 0 && causeRaw !== null) cause = String(causeRaw);
+	if (!stack && !cause && !service && durationMs === void 0) return void 0;
+	return {
+		...stack !== void 0 ? { stack } : {},
+		...cause !== void 0 ? { cause } : {},
+		...service !== void 0 ? { service } : {},
+		...durationMs !== void 0 ? { duration_ms: durationMs } : {}
+	};
+}
+var ErrorResponseBuilder = class {
+	/**
+	* Build a `LogixiaErrorResponse` from any thrown value.
+	*
+	* @param params - See `BuildParams`.
+	* @returns The unified error response and the HTTP status code to send.
+	*
+	* @example In a NestJS exception filter
+	* ```ts
+	* const { response, httpStatus } = ErrorResponseBuilder.build<AppCode, AppType>({
+	*   exception,
+	*   requestId: request.headers['x-trace-id'] as string | undefined,
+	*   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.request_id);
+	* response.status(httpStatus).json(response);
+	* ```
+	*/
+	static build(params) {
+		const { exception, path, service, startTime, requestId: rawRequestId } = params;
+		const requestId = rawRequestId ?? generateRequestId();
+		const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+		const durationMs = startTime !== void 0 ? Date.now() - startTime : void 0;
+		if (isLogixiaException(exception)) {
+			const debug$1 = buildDebug(exception, service, durationMs);
+			const errorBlock = {
+				type: exception.errorType,
+				code: exception.errorCode,
+				message: exception.message
+			};
+			if (exception.param !== void 0) errorBlock.param = exception.param;
+			if (exception.details !== void 0 && exception.details.length > 0) errorBlock.details = exception.details;
+			if (exception.docUrl !== void 0) errorBlock.doc_url = exception.docUrl;
+			return {
+				response: {
+					success: false,
+					error: errorBlock,
+					meta: {
+						request_id: requestId,
+						timestamp,
+						path,
+						status: exception.httpStatus
+					},
+					...debug$1 !== void 0 ? { debug: debug$1 } : {}
+				},
+				httpStatus: exception.httpStatus
+			};
+		}
+		if (isHttpException(exception)) {
+			const status = exception.getStatus();
+			const exResponse = exception.getResponse();
+			let message;
+			if (typeof exResponse === "string") message = exResponse;
+			else if (typeof exResponse === "object" && exResponse !== null && "message" in exResponse) {
+				const raw = exResponse.message;
+				message = Array.isArray(raw) ? raw.join(", ") : String(raw);
+			} else message = exception.message;
+			const type = httpStatusToType(status);
+			const code = `HTTP_${status}`;
+			const debug$1 = buildDebug(exception, service, durationMs);
+			return {
+				response: {
+					success: false,
+					error: {
+						type,
+						code,
+						message
+					},
+					meta: {
+						request_id: requestId,
+						timestamp,
+						path,
+						status
+					},
+					...debug$1 !== void 0 ? { debug: debug$1 } : {}
+				},
+				httpStatus: status
+			};
+		}
+		const debug = buildDebug(exception instanceof Error ? exception : new Error(String(exception)), service, durationMs);
+		return {
+			response: {
+				success: false,
+				error: {
+					type: "server_error",
+					code: "INTERNAL_SERVER_ERROR",
+					message: "An unexpected error occurred."
+				},
+				meta: {
+					request_id: requestId,
+					timestamp,
+					path,
+					status: 500
+				},
+				...debug !== void 0 ? { debug } : {}
+			},
+			httpStatus: 500
+		};
+	}
+};
+
+//#endregion
 //#region \0@oxc-project+runtime@0.95.0/helpers/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
@@ -84,26 +278,35 @@ let LogixiaExceptionFilter = class LogixiaExceptionFilter$1 {
 		this.logger = logger$1;
 	}
 	catch(exception, host) {
+		var _request$headers;
 		const ctx = host.switchToHttp();
-		const response = ctx.getResponse();
 		const request = ctx.getRequest();
-		const isHttp = exception instanceof __nestjs_common.HttpException;
-		const status = isHttp ? exception.getStatus() : 500;
-		let message;
-		if (isHttp) message = exception.message;
-		else if (exception instanceof Error) message = exception.message;
-		else message = "Internal server error";
-		const contextStr = `method=${String(request.method ?? "")} url=${String(request.url ?? "")} status=${status}`;
-		if (this.logger) if (status >= 500) {
-			const err = exception instanceof Error ? exception : new Error(String(exception));
-			this.logger.error(err, void 0, contextStr);
-		} else this.logger.warn(`[${status}] ${message}`, contextStr);
-		response.status(status).json({
-			statusCode: status,
-			message,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-			path: request.url
+		const response = ctx.getResponse();
+		const requestId = ((_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,
+			requestId,
+			path: request.url ?? "/",
+			startTime: request.startTime
 		});
+		if (this.logger) {
+			const contextStr = [
+				`method=${String(request.method ?? "")}`,
+				`url=${String(request.url ?? "")}`,
+				`status=${httpStatus}`,
+				`request_id=${errorResponse.meta.request_id}`
+			].join(" ");
+			if (httpStatus >= 500) {
+				const err = exception instanceof Error ? exception : new Error(String(exception));
+				this.logger.error(err, void 0, contextStr);
+			} else if (isLogixiaException(exception)) this.logger.warn(`[${errorResponse.error.code}] ${errorResponse.error.message}`, contextStr);
+			else this.logger.warn(`[${httpStatus}] ${errorResponse.error.message}`, contextStr);
+		}
+		if (process.env["NODE_ENV"] === "production") delete errorResponse.debug;
+		response.setHeader("X-Trace-ID", errorResponse.meta.request_id);
+		response.setHeader("X-Request-ID", errorResponse.meta.request_id);
+		if (httpStatus === 429) response.setHeader("Retry-After", "60");
+		response.status(httpStatus).json(errorResponse);
 	}
 };
 LogixiaExceptionFilter = require_logitron_logger_module.__decorate([
@@ -655,6 +858,7 @@ exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 exports.DEFAULT_LOG_COLORS = require_logitron_logger_module.DEFAULT_LOG_COLORS;
 exports.DEFAULT_LOG_LEVELS = require_logitron_logger_module.DEFAULT_LOG_LEVELS;
 exports.DEFAULT_TRACE_HEADERS = require_logitron_logger_module.DEFAULT_TRACE_HEADERS;
+exports.ErrorResponseBuilder = ErrorResponseBuilder;
 exports.InjectLogger = InjectLogger;
 exports.JsonFormatter = JsonFormatter;
 Object.defineProperty(exports, 'KafkaTraceInterceptor', {
@@ -668,6 +872,7 @@ exports.LOGIXIA_LOGGER_PREFIX = require_logitron_logger_module.LOGIXIA_LOGGER_PR
 exports.LogLevel = require_logitron_logger_module.LogLevel;
 exports.LogMethod = LogMethod;
 exports.LogixiaContext = require_logitron_logger_module.LogixiaContext;
+exports.LogixiaException = LogixiaException;
 Object.defineProperty(exports, 'LogixiaExceptionFilter', {
   enumerable: true,
   get: function () {
@@ -709,6 +914,7 @@ exports.deregisterFromShutdown = require_logitron_logger_module.deregisterFromSh
 exports.disableOtelBridge = require_logitron_logger_module.disableOtelBridge;
 exports.extractTraceId = require_logitron_logger_module.extractTraceId;
 exports.flushOnExit = require_logitron_logger_module.flushOnExit;
+exports.generateRequestId = generateRequestId;
 exports.generateTraceId = require_logitron_logger_module.generateTraceId;
 exports.getActiveOtelContext = require_logitron_logger_module.getActiveOtelContext;
 exports.getCurrentTraceId = require_logitron_logger_module.getCurrentTraceId;
@@ -716,6 +922,7 @@ exports.getOtelMetaFields = require_logitron_logger_module.getOtelMetaFields;
 exports.globalPluginRegistry = require_logitron_logger_module.globalPluginRegistry;
 exports.initOtelBridge = require_logitron_logger_module.initOtelBridge;
 exports.isError = require_logitron_logger_module.isError;
+exports.isLogixiaException = isLogixiaException;
 exports.logger = logger;
 exports.normalizeError = require_logitron_logger_module.normalizeError;
 exports.redactObject = require_logitron_logger_module.redactObject;