@dofe/infra-common 0.1.1

package/dist/enums/role.enum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Role = void 0;
+var Role;
+(function (Role) {
+    Role["User"] = "user";
+    Role["Admin"] = "admin";
+})(Role || (exports.Role = Role = {}));
+//# sourceMappingURL=role.enum.js.map

package/dist/enums/role.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.enum.js","sourceRoot":"","sources":["../../src/enums/role.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,IAGX;AAHD,WAAY,IAAI;IACd,qBAAa,CAAA;IACb,uBAAe,CAAA;AACjB,CAAC,EAHW,IAAI,oBAAJ,IAAI,QAGf"}

package/dist/filter/exception/api.exception.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ApiException - Enhanced exception using @repo/contracts
+ * 增强版 ApiException，使用 @repo/contracts 中的错误定义
+ */
+import { HttpException } from '@nestjs/common';
+import { ApiErrorCode } from '@dofe/infra-contracts';
+export declare class ApiException extends HttpException {
+    readonly errorCode: ApiErrorCode;
+    readonly errorType: string;
+    readonly errorData: unknown;
+    readonly domain: string;
+    /**
+     * Create exception from error type string (backward compatible)
+     * 从错误类型字符串创建异常（向后兼容）
+     */
+    constructor(errorType: string, data?: unknown);
+    /**
+     * Create exception from error code (recommended)
+     * 从错误码创建异常（推荐方式）
+     */
+    static fromCode(errorCode: ApiErrorCode, data?: unknown): ApiException;
+    /**
+     * Get error code
+     */
+    getErrorCode(): ApiErrorCode;
+    /**
+     * Get error message without i18n (fallback)
+     */
+    getErrorMessageWithoutI18n(): string;
+    /**
+     * Get localized error message using i18n
+     * 使用 i18n 获取本地化错误消息
+     *
+     * Uses namespace: errors.{domain}.{errorType}
+     */
+    getErrorMessage(i18n: any): string;
+    /**
+     * Get error data
+     */
+    getErrorData(): unknown;
+    /**
+     * Get error type
+     */
+    getErrorType(): string;
+    /**
+     * Convert to JSON response format
+     * 转换为 JSON 响应格式
+     *
+     * Note: `code` is numeric for backward compatibility
+     * `error.errorCode` is string for type safety
+     */
+    toJSON(): {
+        code: number;
+        msg: string;
+        data: null;
+        error: {
+            errorCode: string;
+            errorType: string;
+            errorData: unknown;
+        };
+    };
+}
+/**
+ * Helper function to throw ApiException from error code
+ * 从错误码抛出 ApiException 的辅助函数
+ *
+ * @example
+ * throw apiError(UserErrorCode.UserNotFound);
+ * throw apiError(UserErrorCode.InvalidPassword, { attempts: 3 });
+ */
+export declare function apiError(errorCode: ApiErrorCode, data?: unknown): ApiException;
+/**
+ * 获取适合写入日志的短错误信息（单行，避免堆栈刷屏）
+ * ApiException 的 message 为空，需用 errorCode/errorType 或 getErrorMessageWithoutI18n()
+ */
+export declare function getLoggableErrorMessage(error: unknown): string;
+//# sourceMappingURL=api.exception.d.ts.map

package/dist/filter/exception/api.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.exception.d.ts","sourceRoot":"","sources":["../../../src/filter/exception/api.exception.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,YAAY,EAKb,MAAM,uBAAuB,CAAC;AAmB/B,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAgB,SAAS,EAAE,YAAY,CAAC;IACxC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;;OAGG;gBACS,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,OAAc;IAsBnD;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,GAAE,OAAc,GAAG,YAAY;IAQ5E;;OAEG;IACH,YAAY,IAAI,YAAY;IAI5B;;OAEG;IACH,0BAA0B,IAAI,MAAM;IAIpC;;;;;OAKG;IAEH,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM;IAalC;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,IAAI,CAAC;QACX,KAAK,EAAE;YACL,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,OAAO,CAAC;SACpB,CAAC;KACH;CAYF;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,YAAY,EACvB,IAAI,GAAE,OAAc,GACnB,YAAY,CAEd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAa9D"}

package/dist/filter/exception/api.exception.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * ApiException - Enhanced exception using @repo/contracts
+ * 增强版 ApiException，使用 @repo/contracts 中的错误定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiException = void 0;
+exports.apiError = apiError;
+exports.getLoggableErrorMessage = getLoggableErrorMessage;
+const common_1 = require("@nestjs/common");
+const infra_contracts_1 = require("@dofe/infra-contracts");
+// Domain mapping for i18n namespace
+const ERROR_DOMAIN_MAP = {
+    // User errors (2xx)
+    '20': 'user',
+    '21': 'user',
+    // Common errors (9xx)
+    '90': 'common',
+    '91': 'common',
+    '92': 'common',
+    '99': 'common',
+};
+function getDomainFromCode(errorCode) {
+    const prefix = errorCode.slice(0, 2);
+    return ERROR_DOMAIN_MAP[prefix] || 'common';
+}
+class ApiException extends common_1.HttpException {
+    errorCode;
+    errorType;
+    errorData;
+    domain;
+    /**
+     * Create exception from error type string (backward compatible)
+     * 从错误类型字符串创建异常（向后兼容）
+     */
+    constructor(errorType, data = null) {
+        // Find error code from type
+        const entry = Object.entries(infra_contracts_1.AllErrorTypes).find(([, type]) => type === errorType);
+        if (!entry) {
+            throw new Error(`Unknown error type: ${errorType}`);
+        }
+        const errorCode = entry[0];
+        const httpStatus = (0, infra_contracts_1.getHttpStatus)(errorCode);
+        super('', httpStatus);
+        this.errorCode = errorCode;
+        this.errorType = errorType;
+        this.errorData = data;
+        this.domain = getDomainFromCode(errorCode);
+        this.name = 'ApiException';
+    }
+    /**
+     * Create exception from error code (recommended)
+     * 从错误码创建异常（推荐方式）
+     */
+    static fromCode(errorCode, data = null) {
+        const errorType = (0, infra_contracts_1.getErrorType)(errorCode);
+        if (!errorType) {
+            throw new Error(`Unknown error code: ${errorCode}`);
+        }
+        return new ApiException(errorType, data);
+    }
+    /**
+     * Get error code
+     */
+    getErrorCode() {
+        return this.errorCode;
+    }
+    /**
+     * Get error message without i18n (fallback)
+     */
+    getErrorMessageWithoutI18n() {
+        return (0, infra_contracts_1.getErrorMessage)(this.errorType);
+    }
+    /**
+     * Get localized error message using i18n
+     * 使用 i18n 获取本地化错误消息
+     *
+     * Uses namespace: errors.{domain}.{errorType}
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getErrorMessage(i18n) {
+        // Use errors.{domain}.{errorType} namespace
+        const key = `errors.${this.domain}.${this.errorType}`;
+        const message = i18n.t(key, { lang: i18n.lang });
+        if (message && message !== key) {
+            return message;
+        }
+        // Fallback to error type
+        return this.getErrorMessageWithoutI18n() || this.errorType || '';
+    }
+    /**
+     * Get error data
+     */
+    getErrorData() {
+        return this.errorData;
+    }
+    /**
+     * Get error type
+     */
+    getErrorType() {
+        return this.errorType;
+    }
+    /**
+     * Convert to JSON response format
+     * 转换为 JSON 响应格式
+     *
+     * Note: `code` is numeric for backward compatibility
+     * `error.errorCode` is string for type safety
+     */
+    toJSON() {
+        return {
+            code: Number(this.errorCode),
+            msg: this.errorType,
+            data: null,
+            error: {
+                errorCode: this.errorCode,
+                errorType: this.errorType,
+                errorData: this.errorData,
+            },
+        };
+    }
+}
+exports.ApiException = ApiException;
+/**
+ * Helper function to throw ApiException from error code
+ * 从错误码抛出 ApiException 的辅助函数
+ *
+ * @example
+ * throw apiError(UserErrorCode.UserNotFound);
+ * throw apiError(UserErrorCode.InvalidPassword, { attempts: 3 });
+ */
+function apiError(errorCode, data = null) {
+    return ApiException.fromCode(errorCode, data);
+}
+/**
+ * 获取适合写入日志的短错误信息（单行，避免堆栈刷屏）
+ * ApiException 的 message 为空，需用 errorCode/errorType 或 getErrorMessageWithoutI18n()
+ */
+function getLoggableErrorMessage(error) {
+    if (error instanceof ApiException) {
+        const msg = error.getErrorMessageWithoutI18n();
+        return msg
+            ? `${error.errorCode}: ${msg}`
+            : `${error.errorCode}: ${error.errorType}`;
+    }
+    if (error instanceof Error) {
+        return (error.message || error.stack?.split('\n')[0]?.trim() || 'Unknown error');
+    }
+    return String(error ?? 'Unknown error');
+}
+//# sourceMappingURL=api.exception.js.map

package/dist/filter/exception/api.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.exception.js","sourceRoot":"","sources":["../../../src/filter/exception/api.exception.ts"],"names":[],"mappings":"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"}

package/dist/filter/exception/exception.d.ts

@@ -0,0 +1,8 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+import { Logger } from 'winston';
+export declare class ExceptionsFilter implements ExceptionFilter {
+    private readonly logger;
+    constructor(logger: Logger);
+    catch(exception: any, host: ArgumentsHost): void;
+}
+//# sourceMappingURL=exception.d.ts.map

package/dist/filter/exception/exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../../src/filter/exception/exception.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,eAAe,EAIhB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,qBACa,gBAAiB,YAAW,eAAe;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAGlE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa;CA2B1C"}

package/dist/filter/exception/exception.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExceptionsFilter = void 0;
+const common_1 = require("@nestjs/common");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const infra_utils_1 = require("@dofe/infra-utils");
+let ExceptionsFilter = class ExceptionsFilter {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        const request = ctx.getRequest();
+        const status = exception instanceof common_1.HttpException
+            ? exception.getStatus()
+            : common_1.HttpStatus.INTERNAL_SERVER_ERROR;
+        let msg = exception.message || (status >= 500 ? 'Service Error' : 'Client Error');
+        if (Object.prototype.toString.call(response) === '[object Object]' &&
+            response.message) {
+            msg = response.message;
+        }
+        this.logger.error(msg, (0, infra_utils_1.getReqMainInfo)(request, { ...response, statusCode: status }));
+        response.status(status).json({
+            code: status,
+            msg: `Service Error: ${exception}`,
+        });
+    }
+};
+exports.ExceptionsFilter = ExceptionsFilter;
+exports.ExceptionsFilter = ExceptionsFilter = __decorate([
+    (0, common_1.Catch)(),
+    __param(0, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [winston_1.Logger])
+], ExceptionsFilter);
+//# sourceMappingURL=exception.js.map

package/dist/filter/exception/exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.js","sourceRoot":"","sources":["../../../src/filter/exception/exception.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAOwB;AAExB,+CAAuD;AACvD,qCAAiC;AACjC,mDAAmD;AAG5C,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAEyB;IADpD,YACoD,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAC/D,CAAC;IAEJ,KAAK,CAAC,SAAc,EAAE,IAAmB;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAEjC,MAAM,MAAM,GACV,SAAS,YAAY,sBAAa;YAChC,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE;YACvB,CAAC,CAAC,mBAAU,CAAC,qBAAqB,CAAC;QACvC,IAAI,GAAG,GACL,SAAS,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAC1E,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,iBAAiB;YAC9D,QAAQ,CAAC,OAAO,EAChB,CAAC;YACD,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,GAAG,EACH,IAAA,4BAAc,EAAC,OAAO,EAAE,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAC7D,CAAC;QACF,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YAC3B,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,kBAAkB,SAAS,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAhCY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,cAAK,GAAE;IAGH,WAAA,IAAA,eAAM,EAAC,sCAAuB,CAAC,CAAA;qCAA0B,gBAAM;GAFvD,gBAAgB,CAgC5B"}

package/dist/filter/exception/http.exception.d.ts

@@ -0,0 +1,11 @@
+import { ExceptionFilter, ArgumentsHost, HttpException } from '@nestjs/common';
+import { ApiException } from '@/filter/exception/api.exception';
+import { Logger } from 'winston';
+export declare class HttpExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    constructor(logger: Logger);
+    catch(exception: HttpException | ApiException, host: ArgumentsHost): void;
+    private getChannelFromHost;
+    private buildResponseBody;
+}
+//# sourceMappingURL=http.exception.d.ts.map

package/dist/filter/exception/http.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.exception.d.ts","sourceRoot":"","sources":["../../../src/filter/exception/http.exception.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,aAAa,EACb,aAAa,EAGd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKjC,qBACa,mBAAoB,YAAW,eAAe;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAGlE,KAAK,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,EAAE,IAAI,EAAE,aAAa;IA8ElE,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,iBAAiB;CAuD1B"}

package/dist/filter/exception/http.exception.js

@@ -0,0 +1,152 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_i18n_1 = require("nestjs-i18n");
+const api_exception_1 = require("@/filter/exception/api.exception");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+// import { errorFromType } from '@/ts-rest/response.helper';
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+// errorFromType is re-exported but not used in this file
+let HttpExceptionFilter = class HttpExceptionFilter {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    catch(exception, host) {
+        // console.log('TECHWU HttpExceptionFilter', exception);
+        const { channel, message } = this.getChannelFromHost(host);
+        // console.log('TECHWU exception', exception);
+        if (channel) {
+            this.logger.error(exception.message, exception.stack);
+            channel.nack(message, false, false);
+        }
+        else {
+            const i18n = nestjs_i18n_1.I18nContext.current(host);
+            const ctx = host.switchToHttp();
+            const response = ctx.getResponse();
+            const request = ctx.getRequest();
+            const status = exception.getStatus();
+            // 特殊处理参数校验失败
+            let validationErrors = null;
+            if (exception instanceof common_1.BadRequestException) {
+                const exceptionResponse = exception.getResponse();
+                // 处理 ts-rest 校验错误（TsRestRequestValidationError / RequestValidationError）
+                // exceptionResponse 格式: { paramsResult, headersResult, queryResult, bodyResult }
+                if (exceptionResponse &&
+                    typeof exceptionResponse === 'object' &&
+                    !Array.isArray(exceptionResponse)) {
+                    const tsRestErrors = [];
+                    const parts = [
+                        ['params', exceptionResponse.paramsResult],
+                        ['headers', exceptionResponse.headersResult],
+                        ['query', exceptionResponse.queryResult],
+                        ['body', exceptionResponse.bodyResult],
+                    ];
+                    for (const [location, zodError] of parts) {
+                        if (zodError && zodError.issues && Array.isArray(zodError.issues)) {
+                            for (const issue of zodError.issues) {
+                                const path = issue.path && issue.path.length > 0
+                                    ? issue.path.join('.')
+                                    : '';
+                                const fieldDesc = path ? `${location}.${path}` : location;
+                                tsRestErrors.push(`[${fieldDesc}] ${issue.message}`);
+                            }
+                        }
+                    }
+                    if (tsRestErrors.length > 0) {
+                        validationErrors = tsRestErrors;
+                    }
+                }
+                // 处理标准 NestJS 参数校验失败（class-validator）
+                if (!validationErrors &&
+                    exceptionResponse &&
+                    exceptionResponse.message) {
+                    if (Array.isArray(exceptionResponse.message)) {
+                        validationErrors = exceptionResponse.message;
+                    }
+                    else {
+                        validationErrors = [exceptionResponse.message];
+                    }
+                }
+            }
+            const responseBody = this.buildResponseBody(exception, request, status, i18n, validationErrors);
+            const { timestamp, path, ...responseRet } = responseBody;
+            // console.log('TECHWU , responseBody', responseBody)
+            response.status(status).send(responseRet);
+        }
+    }
+    getChannelFromHost(host) {
+        try {
+            const ctx = host.switchToRpc();
+            const context = ctx.getContext();
+            const channel = context.getChannelRef ? context.getChannelRef() : null;
+            const message = context.getMessage ? context.getMessage() : null;
+            return { channel, message };
+        }
+        catch (error) {
+            console.error('获取通道或消息时发生错误', error);
+            return { channel: null, message: null };
+        }
+    }
+    buildResponseBody(exception, request, status, i18n, validationErrors) {
+        const isApiException = exception instanceof api_exception_1.ApiException;
+        const timestamp = new Date().toLocaleString('zh-CN', {
+            timeZone: 'Asia/Shanghai',
+        });
+        const path = request.url;
+        // Get traceId for error tracking
+        const traceId = request.traceId;
+        // Get error code
+        const code = isApiException ? exception.getErrorCode() : status;
+        // Get error message
+        const message = isApiException
+            ? exception.getErrorMessage(i18n)
+            : exception.message || exception.getResponse();
+        // Get error data
+        const data = isApiException ? exception.getErrorData() : undefined;
+        const responseBody = {
+            code,
+            msg: message, // 使用 msg 与成功响应保持一致
+            traceId, // 添加 traceId 便于问题追踪
+            timestamp,
+            path,
+        };
+        // Add enhanced error details for ApiException
+        if (isApiException) {
+            responseBody.error = data;
+        }
+        // 如果是参数校验失败，添加详细的错误信息
+        if (validationErrors && validationErrors.length > 0) {
+            if (!responseBody.error ||
+                typeof responseBody.error !== 'object' ||
+                Array.isArray(responseBody.error)) {
+                responseBody.error = {
+                    originalError: responseBody.error,
+                };
+            }
+            responseBody.error.errorData = validationErrors;
+        }
+        return responseBody;
+    }
+};
+exports.HttpExceptionFilter = HttpExceptionFilter;
+exports.HttpExceptionFilter = HttpExceptionFilter = __decorate([
+    (0, common_1.Catch)(common_1.HttpException, api_exception_1.ApiException),
+    __param(0, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [winston_1.Logger])
+], HttpExceptionFilter);
+//# sourceMappingURL=http.exception.js.map

package/dist/filter/exception/http.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.exception.js","sourceRoot":"","sources":["../../../src/filter/exception/http.exception.ts"],"names":[],"mappings":"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"}

package/dist/guards/api-key.guard.d.ts

@@ -0,0 +1,42 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Logger } from 'winston';
+/**
+ * API Key 守卫
+ * 允许使用有效的 API Key 跳过部分验证（如用户认证、租户验证等）
+ *
+ * 安全特性：
+ * 1. API Key 必须预定义在环境变量中
+ * 2. 记录所有 API Key 调用日志
+ * 3. 支持可选的租户强制验证
+ */
+export declare class ApiKeyGuard implements CanActivate {
+    private readonly reflector;
+    private readonly logger;
+    private readonly validApiKeys;
+    private readonly enabled;
+    constructor(reflector: Reflector, logger: Logger);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+    /**
+     * 从请求中提取 API Key
+     * 支持从 header 或 query 参数获取
+     */
+    private extractApiKey;
+    /**
+     * 验证 API Key
+     */
+    private validateApiKey;
+    /**
+     * 设置内部服务上下文
+     */
+    private setInternalServiceContext;
+    /**
+     * 遮蔽 API Key 用于日志记录
+     */
+    private maskApiKey;
+    /**
+     * 获取 API Key 标识符（用于区分不同的 Key）
+     */
+    private getKeyId;
+}
+//# sourceMappingURL=api-key.guard.d.ts.map

package/dist/guards/api-key.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.guard.d.ts","sourceRoot":"","sources":["../../src/guards/api-key.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAOjC;;;;;;;;GAQG;AACH,qBACa,WAAY,YAAW,WAAW;IAK3C,OAAO,CAAC,QAAQ,CAAC,SAAS;IACO,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGf,SAAS,EAAE,SAAS,EACa,MAAM,EAAE,MAAM;IAmB5D,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyC9D;;;OAGG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAGjB"}