@xfe-repo/bff-endpoint 1.6.0 → 1.6.4

package/dist/{chunk-L6OSYIFY.mjs → chunk-F42XQQAA.mjs}

@@ -14,10 +14,18 @@ import { APP_FILTER, APP_INTERCEPTOR, APP_PIPE } from "@nestjs/core";
 import { ValidationPipe } from "@xfe-repo/bff-validation";
 
 // src/apiResponse/ApiResponse.exception.filter.ts
-import { Catch } from "@nestjs/common";
+import { Catch, Logger as Logger2 } from "@nestjs/common";
 import { HttpException, HttpStatus } from "@nestjs/common";
-import { CtxService } from "@xfe-repo/bff-core";
+import { CtxService as CtxService2 } from "@xfe-repo/bff-core";
 import { ApiResponseException } from "@xfe-repo/bff-validation";
+
+// src/apiResponse/ApiResponse.interceptor.ts
+import { Injectable, Logger } from "@nestjs/common";
+import { Reflector } from "@nestjs/core";
+import { DECORATORS } from "@nestjs/swagger/dist/constants";
+import { CtxService } from "@xfe-repo/bff-core";
+import { createValidationPipe } from "@xfe-repo/bff-validation";
+import { mergeMap } from "rxjs/operators";
 function _ts_decorate(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);
@@ -29,9 +37,110 @@ function _ts_metadata(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata, "_ts_metadata");
+var _ApiResponseInterceptor = class _ApiResponseInterceptor {
+  constructor(reflector, ctx) {
+    __publicField(this, "reflector");
+    __publicField(this, "ctx");
+    __publicField(this, "validationPipe");
+    __publicField(this, "logger", new Logger(_ApiResponseInterceptor.name));
+    /**
+    * 注册 tracks 日志记录器，在响应完成后消费 tracks 日志并输出
+    * 响应流会保证外层 TransformInterceptor 的 UnionQueryPlugin 等日志采集写入后，再由 ApiResponseInterceptor 一次性输出完整 tracks 列表
+    */
+    __publicField(this, "wrapApiResponseWithTracks", /* @__PURE__ */ __name((resJson) => {
+      Object.defineProperty(resJson, "toJSON", {
+        configurable: true,
+        value: /* @__PURE__ */ __name(() => {
+          const tracks = this.consumeTracks();
+          this.logger.log({
+            traceid: this.ctx.traceid,
+            tracks
+          });
+          return {
+            ...resJson,
+            tracks
+          };
+        }, "value")
+      });
+    }, "wrapApiResponseWithTracks"));
+    this.reflector = reflector;
+    this.ctx = ctx;
+    this.validationPipe = createValidationPipe({
+      // 配合配置 validationPipe.transform({ type: 'custom' }) 时使用
+      validateCustomDecorators: true
+    });
+  }
+  intercept(context, next) {
+    const contextClass = context.getClass();
+    const contextHandler = context.getHandler();
+    return next.handle().pipe(mergeMap((data) => this.handlerSuccess(data, contextClass, contextHandler)));
+  }
+  async handlerSuccess(data, contextClass, contextHandler) {
+    const hasApiRawResponse = this.reflector.get(API_RAW_RESPONSE, contextHandler);
+    if (hasApiRawResponse) {
+      return data;
+    }
+    const hasApiSuccessResponse = this.reflector.get(API_SUCCESS_RESPONSE, contextClass);
+    const hasApiSuccessMethodResponse = this.reflector.get(API_SUCCESS_METHOD_RESPONSE, contextHandler);
+    const apiWrapResponse = hasApiSuccessResponse || hasApiSuccessMethodResponse;
+    const apiResponseDto = {
+      code: 200,
+      msg: "success",
+      traceid: this.ctx.traceid
+    };
+    const transformData = apiWrapResponse ? {
+      ...apiResponseDto,
+      data
+    } : data;
+    const apiResponse = this.reflector.get(DECORATORS.API_RESPONSE, contextHandler);
+    const metatype = (apiResponse?.["200"] || apiResponse?.["201"])?.type;
+    const res = await this.validationPipe.transform(transformData, {
+      metatype,
+      type: "custom"
+    });
+    const baseJson = apiWrapResponse ? res : {
+      ...apiResponseDto,
+      data: res
+    };
+    if (!needDevTracks()) return baseJson;
+    this.wrapApiResponseWithTracks(baseJson);
+    return baseJson;
+  }
+  consumeTracks() {
+    return this.ctx.consumeTracks().map(({ response, ...track }) => track);
+  }
+};
+__name(_ApiResponseInterceptor, "ApiResponseInterceptor");
+var ApiResponseInterceptor = _ApiResponseInterceptor;
+ApiResponseInterceptor = _ts_decorate([
+  Injectable(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof Reflector === "undefined" ? Object : Reflector,
+    typeof CtxService === "undefined" ? Object : CtxService
+  ])
+], ApiResponseInterceptor);
+function needDevTracks() {
+  return process.env.ENV !== "prod" || process.env.NODE_ENV === "development";
+}
+__name(needDevTracks, "needDevTracks");
+
+// src/apiResponse/ApiResponse.exception.filter.ts
+function _ts_decorate2(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;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
 var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
   constructor(ctx) {
     __publicField(this, "ctx");
+    __publicField(this, "logger", new Logger2(_ApiResponseExceptionFilter.name));
     this.ctx = ctx;
   }
   catch(exception, host) {
@@ -44,46 +153,56 @@ var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
       data: {},
       msg: "\u5C0F\u6613\u7D2F\u4E86\uFF0C\u8BA9\u5C0F\u6613\u4F11\u606F\u4E00\u4E0B\u5427~"
     };
-    response.status(HttpStatus.OK).json({
-      code: apiResponse?.code || defaultError.code,
-      msg: apiResponse?.msg || defaultError.msg,
-      data: apiResponse?.data || defaultError.data,
-      debug: {
-        stack: apiResponse?.stack || "\u672A\u77E5\u7684stack\u9519\u8BEF",
-        tracks: this.ctx.tracks
-      }
-    });
+    const code = apiResponse?.code || defaultError.code;
+    const data = apiResponse?.data || defaultError.data;
+    const msg = apiResponse?.msg || defaultError.msg;
+    const debug = {
+      stack: apiResponse?.stack || "\u672A\u77E5\u7684stack\u9519\u8BEF",
+      tracks: this.ctx.consumeTracks()
+    };
+    const baseJson = {
+      code,
+      data,
+      msg,
+      traceid: this.ctx.traceid
+    };
+    const loggerJson = {
+      ...baseJson,
+      debug
+    };
+    this.logger.error(loggerJson);
+    response.status(HttpStatus.OK).json(needDevTracks() ? loggerJson : baseJson);
   }
   handleException(exception, _host) {
     if (exception instanceof HttpException) {
       return {
         code: exception.getStatus(),
-        msg: exception.message,
         data: exception.getResponse(),
+        msg: exception.message,
         stack: exception.stack
       };
     }
     if (exception instanceof ApiResponseException) {
       return {
         code: exception.code,
-        msg: exception.msg,
         data: exception.data,
+        msg: exception.msg,
         stack: exception.stack
       };
     }
     if (exception instanceof Error) {
       return {
         code: HttpStatus.INTERNAL_SERVER_ERROR,
-        msg: exception.message,
         data: exception,
+        msg: exception.message,
         stack: exception.stack
       };
     }
     if (typeof exception === "string") {
       return {
         code: HttpStatus.INTERNAL_SERVER_ERROR,
-        msg: exception,
         data: {},
+        msg: exception,
         stack: new Error(exception).stack
       };
     }
@@ -92,91 +211,13 @@ var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
 };
 __name(_ApiResponseExceptionFilter, "ApiResponseExceptionFilter");
 var ApiResponseExceptionFilter = _ApiResponseExceptionFilter;
-ApiResponseExceptionFilter = _ts_decorate([
+ApiResponseExceptionFilter = _ts_decorate2([
   Catch(),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
-    typeof CtxService === "undefined" ? Object : CtxService
-  ])
-], ApiResponseExceptionFilter);
-
-// src/apiResponse/ApiResponse.interceptor.ts
-import { Injectable } from "@nestjs/common";
-import { Reflector } from "@nestjs/core";
-import { DECORATORS } from "@nestjs/swagger/dist/constants";
-import { CtxService as CtxService2 } from "@xfe-repo/bff-core";
-import { createValidationPipe } from "@xfe-repo/bff-validation";
-import { mergeMap } from "rxjs/operators";
-function _ts_decorate2(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;
-}
-__name(_ts_decorate2, "_ts_decorate");
-function _ts_metadata2(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata2, "_ts_metadata");
-var _ApiResponseInterceptor = class _ApiResponseInterceptor {
-  constructor(reflector, ctx) {
-    __publicField(this, "reflector");
-    __publicField(this, "ctx");
-    __publicField(this, "validationPipe");
-    __publicField(this, "contextClass");
-    __publicField(this, "contextHandler");
-    this.reflector = reflector;
-    this.ctx = ctx;
-    this.validationPipe = createValidationPipe({
-      // 配合配置 validationPipe.transform({ type: 'custom' }) 时使用
-      validateCustomDecorators: true
-    });
-  }
-  intercept(context, next) {
-    this.contextClass = context.getClass();
-    this.contextHandler = context.getHandler();
-    return next.handle().pipe(mergeMap((data) => this.handlerSuccess(data)));
-  }
-  async handlerSuccess(data) {
-    const hasApiRawResponse = this.reflector.get(API_RAW_RESPONSE, this.contextHandler);
-    if (hasApiRawResponse) {
-      return data;
-    }
-    const hasApiSuccessResponse = this.reflector.get(API_SUCCESS_RESPONSE, this.contextClass);
-    const hasApiSuccessMethodResponse = this.reflector.get(API_SUCCESS_METHOD_RESPONSE, this.contextHandler);
-    const apiWrapResponse = hasApiSuccessResponse || hasApiSuccessMethodResponse;
-    const apiResponseDto = {
-      code: 200,
-      msg: "success",
-      traceid: this.ctx.traceid
-    };
-    const transformData = apiWrapResponse ? {
-      ...apiResponseDto,
-      data
-    } : data;
-    const apiResponse = this.reflector.get(DECORATORS.API_RESPONSE, this.contextHandler);
-    const metatype = (apiResponse?.["200"] || apiResponse?.["201"])?.type;
-    const res = await this.validationPipe.transform(transformData, {
-      metatype,
-      // 自定义类型校验器
-      type: "custom"
-    });
-    return apiWrapResponse ? res : {
-      ...apiResponseDto,
-      data: res
-    };
-  }
-};
-__name(_ApiResponseInterceptor, "ApiResponseInterceptor");
-var ApiResponseInterceptor = _ApiResponseInterceptor;
-ApiResponseInterceptor = _ts_decorate2([
-  Injectable(),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
-    typeof Reflector === "undefined" ? Object : Reflector,
     typeof CtxService2 === "undefined" ? Object : CtxService2
   ])
-], ApiResponseInterceptor);
+], ApiResponseExceptionFilter);
 
 // src/endpoint.module.ts
 function _ts_decorate3(decorators, target, key, desc) {
@@ -211,5 +252,6 @@ EndpointModule = _ts_decorate3([
 
 export {
   ApiResponseInterceptor,
+  needDevTracks,
   EndpointModule
 };

package/dist/endpoint.module.js

@@ -31,151 +31,89 @@ var import_core2 = require("@nestjs/core");
 var import_bff_validation3 = require("@xfe-repo/bff-validation");
 
 // src/apiResponse/ApiResponse.exception.filter.ts
-var import_common = require("@nestjs/common");
-var import_common2 = require("@nestjs/common");
-var import_bff_core = require("@xfe-repo/bff-core");
-var import_bff_validation = require("@xfe-repo/bff-validation");
-function _ts_decorate(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;
-}
-__name(_ts_decorate, "_ts_decorate");
-function _ts_metadata(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata, "_ts_metadata");
-var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
-  constructor(ctx) {
-    __publicField(this, "ctx");
-    this.ctx = ctx;
-  }
-  catch(exception, host) {
-    if (!exception) return;
-    const apiResponse = this.handleException(exception, host);
-    const context = host.switchToHttp();
-    const response = context.getResponse();
-    const defaultError = {
-      code: import_common2.HttpStatus.INTERNAL_SERVER_ERROR,
-      data: {},
-      msg: "\u5C0F\u6613\u7D2F\u4E86\uFF0C\u8BA9\u5C0F\u6613\u4F11\u606F\u4E00\u4E0B\u5427~"
-    };
-    response.status(import_common2.HttpStatus.OK).json({
-      code: apiResponse?.code || defaultError.code,
-      msg: apiResponse?.msg || defaultError.msg,
-      data: apiResponse?.data || defaultError.data,
-      debug: {
-        stack: apiResponse?.stack || "\u672A\u77E5\u7684stack\u9519\u8BEF",
-        tracks: this.ctx.tracks
-      }
-    });
-  }
-  handleException(exception, _host) {
-    if (exception instanceof import_common2.HttpException) {
-      return {
-        code: exception.getStatus(),
-        msg: exception.message,
-        data: exception.getResponse(),
-        stack: exception.stack
-      };
-    }
-    if (exception instanceof import_bff_validation.ApiResponseException) {
-      return {
-        code: exception.code,
-        msg: exception.msg,
-        data: exception.data,
-        stack: exception.stack
-      };
-    }
-    if (exception instanceof Error) {
-      return {
-        code: import_common2.HttpStatus.INTERNAL_SERVER_ERROR,
-        msg: exception.message,
-        data: exception,
-        stack: exception.stack
-      };
-    }
-    if (typeof exception === "string") {
-      return {
-        code: import_common2.HttpStatus.INTERNAL_SERVER_ERROR,
-        msg: exception,
-        data: {},
-        stack: new Error(exception).stack
-      };
-    }
-    return exception;
-  }
-};
-__name(_ApiResponseExceptionFilter, "ApiResponseExceptionFilter");
-var ApiResponseExceptionFilter = _ApiResponseExceptionFilter;
-ApiResponseExceptionFilter = _ts_decorate([
-  (0, import_common.Catch)(),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
-    typeof import_bff_core.CtxService === "undefined" ? Object : import_bff_core.CtxService
-  ])
-], ApiResponseExceptionFilter);
+var import_common4 = require("@nestjs/common");
+var import_common5 = require("@nestjs/common");
+var import_bff_core3 = require("@xfe-repo/bff-core");
+var import_bff_validation2 = require("@xfe-repo/bff-validation");
 
 // src/apiResponse/ApiResponse.interceptor.ts
-var import_common5 = require("@nestjs/common");
+var import_common3 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 var import_constants2 = require("@nestjs/swagger/dist/constants");
-var import_bff_core3 = require("@xfe-repo/bff-core");
-var import_bff_validation2 = require("@xfe-repo/bff-validation");
+var import_bff_core2 = require("@xfe-repo/bff-core");
+var import_bff_validation = require("@xfe-repo/bff-validation");
 var import_operators = require("rxjs/operators");
 
 // src/apiResponse/ApiRawResponse.decorator.ts
-var import_common3 = require("@nestjs/common");
+var import_common = require("@nestjs/common");
 var API_RAW_RESPONSE = "API_RAW_RESPONSE";
 
 // src/apiResponse/ApiSuccessResponse.decorator.ts
-var import_common4 = require("@nestjs/common");
+var import_common2 = require("@nestjs/common");
 var import_constants = require("@nestjs/swagger/dist/constants");
-var import_bff_core2 = require("@xfe-repo/bff-core");
+var import_bff_core = require("@xfe-repo/bff-core");
 var import_class_transformer = require("class-transformer");
 var import_class_validator = require("class-validator");
 var API_SUCCESS_RESPONSE = "API_SUCCESS_RESPONSE";
 var API_SUCCESS_METHOD_RESPONSE = "API_SUCCESS_METHOD_RESPONSE";
 
 // src/apiResponse/ApiResponse.interceptor.ts
-function _ts_decorate2(decorators, target, key, desc) {
+function _ts_decorate(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;
 }
-__name(_ts_decorate2, "_ts_decorate");
-function _ts_metadata2(k, v) {
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata2, "_ts_metadata");
+__name(_ts_metadata, "_ts_metadata");
 var _ApiResponseInterceptor = class _ApiResponseInterceptor {
   constructor(reflector, ctx) {
     __publicField(this, "reflector");
     __publicField(this, "ctx");
     __publicField(this, "validationPipe");
-    __publicField(this, "contextClass");
-    __publicField(this, "contextHandler");
+    __publicField(this, "logger", new import_common3.Logger(_ApiResponseInterceptor.name));
+    /**
+    * 注册 tracks 日志记录器，在响应完成后消费 tracks 日志并输出
+    * 响应流会保证外层 TransformInterceptor 的 UnionQueryPlugin 等日志采集写入后，再由 ApiResponseInterceptor 一次性输出完整 tracks 列表
+    */
+    __publicField(this, "wrapApiResponseWithTracks", /* @__PURE__ */ __name((resJson) => {
+      Object.defineProperty(resJson, "toJSON", {
+        configurable: true,
+        value: /* @__PURE__ */ __name(() => {
+          const tracks = this.consumeTracks();
+          this.logger.log({
+            traceid: this.ctx.traceid,
+            tracks
+          });
+          return {
+            ...resJson,
+            tracks
+          };
+        }, "value")
+      });
+    }, "wrapApiResponseWithTracks"));
     this.reflector = reflector;
     this.ctx = ctx;
-    this.validationPipe = (0, import_bff_validation2.createValidationPipe)({
+    this.validationPipe = (0, import_bff_validation.createValidationPipe)({
       // 配合配置 validationPipe.transform({ type: 'custom' }) 时使用
       validateCustomDecorators: true
     });
   }
   intercept(context, next) {
-    this.contextClass = context.getClass();
-    this.contextHandler = context.getHandler();
-    return next.handle().pipe((0, import_operators.mergeMap)((data) => this.handlerSuccess(data)));
+    const contextClass = context.getClass();
+    const contextHandler = context.getHandler();
+    return next.handle().pipe((0, import_operators.mergeMap)((data) => this.handlerSuccess(data, contextClass, contextHandler)));
   }
-  async handlerSuccess(data) {
-    const hasApiRawResponse = this.reflector.get(API_RAW_RESPONSE, this.contextHandler);
+  async handlerSuccess(data, contextClass, contextHandler) {
+    const hasApiRawResponse = this.reflector.get(API_RAW_RESPONSE, contextHandler);
     if (hasApiRawResponse) {
       return data;
     }
-    const hasApiSuccessResponse = this.reflector.get(API_SUCCESS_RESPONSE, this.contextClass);
-    const hasApiSuccessMethodResponse = this.reflector.get(API_SUCCESS_METHOD_RESPONSE, this.contextHandler);
+    const hasApiSuccessResponse = this.reflector.get(API_SUCCESS_RESPONSE, contextClass);
+    const hasApiSuccessMethodResponse = this.reflector.get(API_SUCCESS_METHOD_RESPONSE, contextHandler);
     const apiWrapResponse = hasApiSuccessResponse || hasApiSuccessMethodResponse;
     const apiResponseDto = {
       code: 200,
@@ -186,29 +124,132 @@ var _ApiResponseInterceptor = class _ApiResponseInterceptor {
       ...apiResponseDto,
       data
     } : data;
-    const apiResponse = this.reflector.get(import_constants2.DECORATORS.API_RESPONSE, this.contextHandler);
+    const apiResponse = this.reflector.get(import_constants2.DECORATORS.API_RESPONSE, contextHandler);
     const metatype = (apiResponse?.["200"] || apiResponse?.["201"])?.type;
     const res = await this.validationPipe.transform(transformData, {
       metatype,
-      // 自定义类型校验器
       type: "custom"
     });
-    return apiWrapResponse ? res : {
+    const baseJson = apiWrapResponse ? res : {
       ...apiResponseDto,
       data: res
     };
+    if (!needDevTracks()) return baseJson;
+    this.wrapApiResponseWithTracks(baseJson);
+    return baseJson;
+  }
+  consumeTracks() {
+    return this.ctx.consumeTracks().map(({ response, ...track }) => track);
   }
 };
 __name(_ApiResponseInterceptor, "ApiResponseInterceptor");
 var ApiResponseInterceptor = _ApiResponseInterceptor;
-ApiResponseInterceptor = _ts_decorate2([
-  (0, import_common5.Injectable)(),
+ApiResponseInterceptor = _ts_decorate([
+  (0, import_common3.Injectable)(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof import_core.Reflector === "undefined" ? Object : import_core.Reflector,
+    typeof import_bff_core2.CtxService === "undefined" ? Object : import_bff_core2.CtxService
+  ])
+], ApiResponseInterceptor);
+function needDevTracks() {
+  return process.env.ENV !== "prod" || process.env.NODE_ENV === "development";
+}
+__name(needDevTracks, "needDevTracks");
+
+// src/apiResponse/ApiResponse.exception.filter.ts
+function _ts_decorate2(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;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
+  constructor(ctx) {
+    __publicField(this, "ctx");
+    __publicField(this, "logger", new import_common4.Logger(_ApiResponseExceptionFilter.name));
+    this.ctx = ctx;
+  }
+  catch(exception, host) {
+    if (!exception) return;
+    const apiResponse = this.handleException(exception, host);
+    const context = host.switchToHttp();
+    const response = context.getResponse();
+    const defaultError = {
+      code: import_common5.HttpStatus.INTERNAL_SERVER_ERROR,
+      data: {},
+      msg: "\u5C0F\u6613\u7D2F\u4E86\uFF0C\u8BA9\u5C0F\u6613\u4F11\u606F\u4E00\u4E0B\u5427~"
+    };
+    const code = apiResponse?.code || defaultError.code;
+    const data = apiResponse?.data || defaultError.data;
+    const msg = apiResponse?.msg || defaultError.msg;
+    const debug = {
+      stack: apiResponse?.stack || "\u672A\u77E5\u7684stack\u9519\u8BEF",
+      tracks: this.ctx.consumeTracks()
+    };
+    const baseJson = {
+      code,
+      data,
+      msg,
+      traceid: this.ctx.traceid
+    };
+    const loggerJson = {
+      ...baseJson,
+      debug
+    };
+    this.logger.error(loggerJson);
+    response.status(import_common5.HttpStatus.OK).json(needDevTracks() ? loggerJson : baseJson);
+  }
+  handleException(exception, _host) {
+    if (exception instanceof import_common5.HttpException) {
+      return {
+        code: exception.getStatus(),
+        data: exception.getResponse(),
+        msg: exception.message,
+        stack: exception.stack
+      };
+    }
+    if (exception instanceof import_bff_validation2.ApiResponseException) {
+      return {
+        code: exception.code,
+        data: exception.data,
+        msg: exception.msg,
+        stack: exception.stack
+      };
+    }
+    if (exception instanceof Error) {
+      return {
+        code: import_common5.HttpStatus.INTERNAL_SERVER_ERROR,
+        data: exception,
+        msg: exception.message,
+        stack: exception.stack
+      };
+    }
+    if (typeof exception === "string") {
+      return {
+        code: import_common5.HttpStatus.INTERNAL_SERVER_ERROR,
+        data: {},
+        msg: exception,
+        stack: new Error(exception).stack
+      };
+    }
+    return exception;
+  }
+};
+__name(_ApiResponseExceptionFilter, "ApiResponseExceptionFilter");
+var ApiResponseExceptionFilter = _ApiResponseExceptionFilter;
+ApiResponseExceptionFilter = _ts_decorate2([
+  (0, import_common4.Catch)(),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
-    typeof import_core.Reflector === "undefined" ? Object : import_core.Reflector,
     typeof import_bff_core3.CtxService === "undefined" ? Object : import_bff_core3.CtxService
   ])
-], ApiResponseInterceptor);
+], ApiResponseExceptionFilter);
 
 // src/endpoint.module.ts
 function _ts_decorate3(decorators, target, key, desc) {

package/dist/endpoint.module.mjs

@@ -1,6 +1,6 @@
 import {
   EndpointModule
-} from "./chunk-L6OSYIFY.mjs";
+} from "./chunk-F42XQQAA.mjs";
 import "./chunk-MFNQSBS5.mjs";
 import "./chunk-Q7G5RLD4.mjs";
 export {

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 export { EndpointModule } from './endpoint.module.mjs';
 import * as _nestjs_common from '@nestjs/common';
-import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { NestInterceptor, ExecutionContext, CallHandler, Type } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { CtxService } from '@xfe-repo/bff-core';
 import { Observable } from 'rxjs';
@@ -14,16 +14,18 @@ declare class ApiResponseInterceptor<T> implements NestInterceptor {
     private readonly reflector;
     private readonly ctx;
     private readonly validationPipe;
-    private contextClass;
-    private contextHandler;
+    private readonly logger;
     constructor(reflector: Reflector, ctx: CtxService);
     intercept(context: ExecutionContext, next: CallHandler): Observable<T>;
-    handlerSuccess(data: T): Promise<any>;
+    handlerSuccess(data: T, contextClass: Type<T>, contextHandler: Function): Promise<any>;
+    private wrapApiResponseWithTracks;
+    private consumeTracks;
 }
+declare function needDevTracks(): boolean;
 
 declare const API_SUCCESS_RESPONSE = "API_SUCCESS_RESPONSE";
 declare const API_SUCCESS_METHOD_RESPONSE = "API_SUCCESS_METHOD_RESPONSE";
 declare function ApiSuccessResponse(): ClassDecorator;
 declare function ApiSuccessMethodResponse(): MethodDecorator;
 
-export { API_RAW_RESPONSE, API_SUCCESS_METHOD_RESPONSE, API_SUCCESS_RESPONSE, ApiRawResponse, ApiResponseInterceptor, ApiSuccessMethodResponse, ApiSuccessResponse };
+export { API_RAW_RESPONSE, API_SUCCESS_METHOD_RESPONSE, API_SUCCESS_RESPONSE, ApiRawResponse, ApiResponseInterceptor, ApiSuccessMethodResponse, ApiSuccessResponse, needDevTracks };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { EndpointModule } from './endpoint.module.js';
 import * as _nestjs_common from '@nestjs/common';
-import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { NestInterceptor, ExecutionContext, CallHandler, Type } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { CtxService } from '@xfe-repo/bff-core';
 import { Observable } from 'rxjs';
@@ -14,16 +14,18 @@ declare class ApiResponseInterceptor<T> implements NestInterceptor {
     private readonly reflector;
     private readonly ctx;
     private readonly validationPipe;
-    private contextClass;
-    private contextHandler;
+    private readonly logger;
     constructor(reflector: Reflector, ctx: CtxService);
     intercept(context: ExecutionContext, next: CallHandler): Observable<T>;
-    handlerSuccess(data: T): Promise<any>;
+    handlerSuccess(data: T, contextClass: Type<T>, contextHandler: Function): Promise<any>;
+    private wrapApiResponseWithTracks;
+    private consumeTracks;
 }
+declare function needDevTracks(): boolean;
 
 declare const API_SUCCESS_RESPONSE = "API_SUCCESS_RESPONSE";
 declare const API_SUCCESS_METHOD_RESPONSE = "API_SUCCESS_METHOD_RESPONSE";
 declare function ApiSuccessResponse(): ClassDecorator;
 declare function ApiSuccessMethodResponse(): MethodDecorator;
 
-export { API_RAW_RESPONSE, API_SUCCESS_METHOD_RESPONSE, API_SUCCESS_RESPONSE, ApiRawResponse, ApiResponseInterceptor, ApiSuccessMethodResponse, ApiSuccessResponse };
+export { API_RAW_RESPONSE, API_SUCCESS_METHOD_RESPONSE, API_SUCCESS_RESPONSE, ApiRawResponse, ApiResponseInterceptor, ApiSuccessMethodResponse, ApiSuccessResponse, needDevTracks };

package/dist/index.js

@@ -32,7 +32,8 @@ __export(index_exports, {
   ApiSuccessResponse: () => ApiSuccessResponse,
   Endpoint: () => Endpoint,
   EndpointModule: () => EndpointModule,
-  Endpoints: () => Endpoints
+  Endpoints: () => Endpoints,
+  needDevTracks: () => needDevTracks
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -42,122 +43,41 @@ var import_core2 = require("@nestjs/core");
 var import_bff_validation3 = require("@xfe-repo/bff-validation");
 
 // src/apiResponse/ApiResponse.exception.filter.ts
-var import_common = require("@nestjs/common");
-var import_common2 = require("@nestjs/common");
-var import_bff_core = require("@xfe-repo/bff-core");
-var import_bff_validation = require("@xfe-repo/bff-validation");
-function _ts_decorate(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;
-}
-__name(_ts_decorate, "_ts_decorate");
-function _ts_metadata(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata, "_ts_metadata");
-var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
-  constructor(ctx) {
-    __publicField(this, "ctx");
-    this.ctx = ctx;
-  }
-  catch(exception, host) {
-    if (!exception) return;
-    const apiResponse = this.handleException(exception, host);
-    const context = host.switchToHttp();
-    const response = context.getResponse();
-    const defaultError = {
-      code: import_common2.HttpStatus.INTERNAL_SERVER_ERROR,
-      data: {},
-      msg: "\u5C0F\u6613\u7D2F\u4E86\uFF0C\u8BA9\u5C0F\u6613\u4F11\u606F\u4E00\u4E0B\u5427~"
-    };
-    response.status(import_common2.HttpStatus.OK).json({
-      code: apiResponse?.code || defaultError.code,
-      msg: apiResponse?.msg || defaultError.msg,
-      data: apiResponse?.data || defaultError.data,
-      debug: {
-        stack: apiResponse?.stack || "\u672A\u77E5\u7684stack\u9519\u8BEF",
-        tracks: this.ctx.tracks
-      }
-    });
-  }
-  handleException(exception, _host) {
-    if (exception instanceof import_common2.HttpException) {
-      return {
-        code: exception.getStatus(),
-        msg: exception.message,
-        data: exception.getResponse(),
-        stack: exception.stack
-      };
-    }
-    if (exception instanceof import_bff_validation.ApiResponseException) {
-      return {
-        code: exception.code,
-        msg: exception.msg,
-        data: exception.data,
-        stack: exception.stack
-      };
-    }
-    if (exception instanceof Error) {
-      return {
-        code: import_common2.HttpStatus.INTERNAL_SERVER_ERROR,
-        msg: exception.message,
-        data: exception,
-        stack: exception.stack
-      };
-    }
-    if (typeof exception === "string") {
-      return {
-        code: import_common2.HttpStatus.INTERNAL_SERVER_ERROR,
-        msg: exception,
-        data: {},
-        stack: new Error(exception).stack
-      };
-    }
-    return exception;
-  }
-};
-__name(_ApiResponseExceptionFilter, "ApiResponseExceptionFilter");
-var ApiResponseExceptionFilter = _ApiResponseExceptionFilter;
-ApiResponseExceptionFilter = _ts_decorate([
-  (0, import_common.Catch)(),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
-    typeof import_bff_core.CtxService === "undefined" ? Object : import_bff_core.CtxService
-  ])
-], ApiResponseExceptionFilter);
+var import_common4 = require("@nestjs/common");
+var import_common5 = require("@nestjs/common");
+var import_bff_core3 = require("@xfe-repo/bff-core");
+var import_bff_validation2 = require("@xfe-repo/bff-validation");
 
 // src/apiResponse/ApiResponse.interceptor.ts
-var import_common5 = require("@nestjs/common");
+var import_common3 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 var import_constants2 = require("@nestjs/swagger/dist/constants");
-var import_bff_core3 = require("@xfe-repo/bff-core");
-var import_bff_validation2 = require("@xfe-repo/bff-validation");
+var import_bff_core2 = require("@xfe-repo/bff-core");
+var import_bff_validation = require("@xfe-repo/bff-validation");
 var import_operators = require("rxjs/operators");
 
 // src/apiResponse/ApiRawResponse.decorator.ts
-var import_common3 = require("@nestjs/common");
+var import_common = require("@nestjs/common");
 var API_RAW_RESPONSE = "API_RAW_RESPONSE";
-var ApiRawResponse = /* @__PURE__ */ __name(() => (0, import_common3.SetMetadata)(API_RAW_RESPONSE, true), "ApiRawResponse");
+var ApiRawResponse = /* @__PURE__ */ __name(() => (0, import_common.SetMetadata)(API_RAW_RESPONSE, true), "ApiRawResponse");
 
 // src/apiResponse/ApiSuccessResponse.decorator.ts
-var import_common4 = require("@nestjs/common");
+var import_common2 = require("@nestjs/common");
 var import_constants = require("@nestjs/swagger/dist/constants");
-var import_bff_core2 = require("@xfe-repo/bff-core");
+var import_bff_core = require("@xfe-repo/bff-core");
 var import_class_transformer = require("class-transformer");
 var import_class_validator = require("class-validator");
-function _ts_decorate2(decorators, target, key, desc) {
+function _ts_decorate(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;
 }
-__name(_ts_decorate2, "_ts_decorate");
-function _ts_metadata2(k, v) {
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata2, "_ts_metadata");
+__name(_ts_metadata, "_ts_metadata");
 var API_SUCCESS_RESPONSE = "API_SUCCESS_RESPONSE";
 var API_SUCCESS_METHOD_RESPONSE = "API_SUCCESS_METHOD_RESPONSE";
 function ApiSuccessResponse() {
@@ -228,39 +148,39 @@ function withApiSuccessResponse(Base, isArray) {
   var _a;
   let ApiResponse2 = (_a = class {
     constructor() {
-      __publicField(this, "code", import_common4.HttpStatus.INTERNAL_SERVER_ERROR);
+      __publicField(this, "code", import_common2.HttpStatus.INTERNAL_SERVER_ERROR);
       __publicField(this, "msg", "\u5C0F\u6613\u5F88\u5FD9\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5~");
       __publicField(this, "traceid");
       __publicField(this, "data");
     }
   }, __name(_a, "ApiResponse"), _a);
-  _ts_decorate2([
-    (0, import_bff_core2.ApiProperty)({
+  _ts_decorate([
+    (0, import_bff_core.ApiProperty)({
       example: 200,
       description: "\u54CD\u5E94\u72B6\u6001\u7801, \u6B64\u5904\u7EA6\u5B9A 0 - 100000 \u533A\u95F4\u5BA2\u6237\u7AEFToast\u5904\u7406, \u5927\u4E8E 100000 \u4E3A\u81EA\u5B9A\u4E49\u5904\u7406"
     }),
     (0, import_class_validator.IsInt)(),
     (0, import_class_validator.IsNotEmpty)(),
-    _ts_metadata2("design:type", Number)
+    _ts_metadata("design:type", Number)
   ], ApiResponse2.prototype, "code", void 0);
-  _ts_decorate2([
-    (0, import_bff_core2.ApiProperty)({
+  _ts_decorate([
+    (0, import_bff_core.ApiProperty)({
       description: "\u9519\u8BEF\u4FE1\u606F"
     }),
     (0, import_class_validator.IsString)(),
     (0, import_class_validator.IsNotEmpty)(),
-    _ts_metadata2("design:type", String)
+    _ts_metadata("design:type", String)
   ], ApiResponse2.prototype, "msg", void 0);
-  _ts_decorate2([
-    (0, import_bff_core2.ApiPropertyOptional)({
+  _ts_decorate([
+    (0, import_bff_core.ApiPropertyOptional)({
       description: "\u9519\u8BEF\u4FE1\u606F\u8FFD\u8E2Aid"
     }),
     (0, import_class_validator.IsString)(),
     (0, import_class_validator.IsOptional)(),
-    _ts_metadata2("design:type", String)
+    _ts_metadata("design:type", String)
   ], ApiResponse2.prototype, "traceid", void 0);
-  _ts_decorate2([
-    (0, import_bff_core2.ApiProperty)({
+  _ts_decorate([
+    (0, import_bff_core.ApiProperty)({
       description: "\u54CD\u5E94\u6570\u636E",
       type: isArray ? [
         Base
@@ -272,50 +192,69 @@ function withApiSuccessResponse(Base, isArray) {
     }),
     (0, import_class_validator.IsNotEmpty)(),
     IsArrayOrObject(isArray),
-    _ts_metadata2("design:type", Object)
+    _ts_metadata("design:type", Object)
   ], ApiResponse2.prototype, "data", void 0);
   return mixin(ApiResponse2, `${ApiResponse2.name}<${Base.name}>`);
 }
 __name(withApiSuccessResponse, "withApiSuccessResponse");
 
 // src/apiResponse/ApiResponse.interceptor.ts
-function _ts_decorate3(decorators, target, key, desc) {
+function _ts_decorate2(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;
 }
-__name(_ts_decorate3, "_ts_decorate");
-function _ts_metadata3(k, v) {
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata3, "_ts_metadata");
+__name(_ts_metadata2, "_ts_metadata");
 var _ApiResponseInterceptor = class _ApiResponseInterceptor {
   constructor(reflector, ctx) {
     __publicField(this, "reflector");
     __publicField(this, "ctx");
     __publicField(this, "validationPipe");
-    __publicField(this, "contextClass");
-    __publicField(this, "contextHandler");
+    __publicField(this, "logger", new import_common3.Logger(_ApiResponseInterceptor.name));
+    /**
+    * 注册 tracks 日志记录器，在响应完成后消费 tracks 日志并输出
+    * 响应流会保证外层 TransformInterceptor 的 UnionQueryPlugin 等日志采集写入后，再由 ApiResponseInterceptor 一次性输出完整 tracks 列表
+    */
+    __publicField(this, "wrapApiResponseWithTracks", /* @__PURE__ */ __name((resJson) => {
+      Object.defineProperty(resJson, "toJSON", {
+        configurable: true,
+        value: /* @__PURE__ */ __name(() => {
+          const tracks = this.consumeTracks();
+          this.logger.log({
+            traceid: this.ctx.traceid,
+            tracks
+          });
+          return {
+            ...resJson,
+            tracks
+          };
+        }, "value")
+      });
+    }, "wrapApiResponseWithTracks"));
     this.reflector = reflector;
     this.ctx = ctx;
-    this.validationPipe = (0, import_bff_validation2.createValidationPipe)({
+    this.validationPipe = (0, import_bff_validation.createValidationPipe)({
       // 配合配置 validationPipe.transform({ type: 'custom' }) 时使用
       validateCustomDecorators: true
     });
   }
   intercept(context, next) {
-    this.contextClass = context.getClass();
-    this.contextHandler = context.getHandler();
-    return next.handle().pipe((0, import_operators.mergeMap)((data) => this.handlerSuccess(data)));
+    const contextClass = context.getClass();
+    const contextHandler = context.getHandler();
+    return next.handle().pipe((0, import_operators.mergeMap)((data) => this.handlerSuccess(data, contextClass, contextHandler)));
   }
-  async handlerSuccess(data) {
-    const hasApiRawResponse = this.reflector.get(API_RAW_RESPONSE, this.contextHandler);
+  async handlerSuccess(data, contextClass, contextHandler) {
+    const hasApiRawResponse = this.reflector.get(API_RAW_RESPONSE, contextHandler);
     if (hasApiRawResponse) {
       return data;
     }
-    const hasApiSuccessResponse = this.reflector.get(API_SUCCESS_RESPONSE, this.contextClass);
-    const hasApiSuccessMethodResponse = this.reflector.get(API_SUCCESS_METHOD_RESPONSE, this.contextHandler);
+    const hasApiSuccessResponse = this.reflector.get(API_SUCCESS_RESPONSE, contextClass);
+    const hasApiSuccessMethodResponse = this.reflector.get(API_SUCCESS_METHOD_RESPONSE, contextHandler);
     const apiWrapResponse = hasApiSuccessResponse || hasApiSuccessMethodResponse;
     const apiResponseDto = {
       code: 200,
@@ -326,29 +265,132 @@ var _ApiResponseInterceptor = class _ApiResponseInterceptor {
       ...apiResponseDto,
       data
     } : data;
-    const apiResponse = this.reflector.get(import_constants2.DECORATORS.API_RESPONSE, this.contextHandler);
+    const apiResponse = this.reflector.get(import_constants2.DECORATORS.API_RESPONSE, contextHandler);
     const metatype = (apiResponse?.["200"] || apiResponse?.["201"])?.type;
     const res = await this.validationPipe.transform(transformData, {
       metatype,
-      // 自定义类型校验器
       type: "custom"
     });
-    return apiWrapResponse ? res : {
+    const baseJson = apiWrapResponse ? res : {
       ...apiResponseDto,
       data: res
     };
+    if (!needDevTracks()) return baseJson;
+    this.wrapApiResponseWithTracks(baseJson);
+    return baseJson;
+  }
+  consumeTracks() {
+    return this.ctx.consumeTracks().map(({ response, ...track }) => track);
   }
 };
 __name(_ApiResponseInterceptor, "ApiResponseInterceptor");
 var ApiResponseInterceptor = _ApiResponseInterceptor;
-ApiResponseInterceptor = _ts_decorate3([
-  (0, import_common5.Injectable)(),
+ApiResponseInterceptor = _ts_decorate2([
+  (0, import_common3.Injectable)(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof import_core.Reflector === "undefined" ? Object : import_core.Reflector,
+    typeof import_bff_core2.CtxService === "undefined" ? Object : import_bff_core2.CtxService
+  ])
+], ApiResponseInterceptor);
+function needDevTracks() {
+  return process.env.ENV !== "prod" || process.env.NODE_ENV === "development";
+}
+__name(needDevTracks, "needDevTracks");
+
+// src/apiResponse/ApiResponse.exception.filter.ts
+function _ts_decorate3(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;
+}
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
+var _ApiResponseExceptionFilter = class _ApiResponseExceptionFilter {
+  constructor(ctx) {
+    __publicField(this, "ctx");
+    __publicField(this, "logger", new import_common4.Logger(_ApiResponseExceptionFilter.name));
+    this.ctx = ctx;
+  }
+  catch(exception, host) {
+    if (!exception) return;
+    const apiResponse = this.handleException(exception, host);
+    const context = host.switchToHttp();
+    const response = context.getResponse();
+    const defaultError = {
+      code: import_common5.HttpStatus.INTERNAL_SERVER_ERROR,
+      data: {},
+      msg: "\u5C0F\u6613\u7D2F\u4E86\uFF0C\u8BA9\u5C0F\u6613\u4F11\u606F\u4E00\u4E0B\u5427~"
+    };
+    const code = apiResponse?.code || defaultError.code;
+    const data = apiResponse?.data || defaultError.data;
+    const msg = apiResponse?.msg || defaultError.msg;
+    const debug = {
+      stack: apiResponse?.stack || "\u672A\u77E5\u7684stack\u9519\u8BEF",
+      tracks: this.ctx.consumeTracks()
+    };
+    const baseJson = {
+      code,
+      data,
+      msg,
+      traceid: this.ctx.traceid
+    };
+    const loggerJson = {
+      ...baseJson,
+      debug
+    };
+    this.logger.error(loggerJson);
+    response.status(import_common5.HttpStatus.OK).json(needDevTracks() ? loggerJson : baseJson);
+  }
+  handleException(exception, _host) {
+    if (exception instanceof import_common5.HttpException) {
+      return {
+        code: exception.getStatus(),
+        data: exception.getResponse(),
+        msg: exception.message,
+        stack: exception.stack
+      };
+    }
+    if (exception instanceof import_bff_validation2.ApiResponseException) {
+      return {
+        code: exception.code,
+        data: exception.data,
+        msg: exception.msg,
+        stack: exception.stack
+      };
+    }
+    if (exception instanceof Error) {
+      return {
+        code: import_common5.HttpStatus.INTERNAL_SERVER_ERROR,
+        data: exception,
+        msg: exception.message,
+        stack: exception.stack
+      };
+    }
+    if (typeof exception === "string") {
+      return {
+        code: import_common5.HttpStatus.INTERNAL_SERVER_ERROR,
+        data: {},
+        msg: exception,
+        stack: new Error(exception).stack
+      };
+    }
+    return exception;
+  }
+};
+__name(_ApiResponseExceptionFilter, "ApiResponseExceptionFilter");
+var ApiResponseExceptionFilter = _ApiResponseExceptionFilter;
+ApiResponseExceptionFilter = _ts_decorate3([
+  (0, import_common4.Catch)(),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
-    typeof import_core.Reflector === "undefined" ? Object : import_core.Reflector,
     typeof import_bff_core3.CtxService === "undefined" ? Object : import_bff_core3.CtxService
   ])
-], ApiResponseInterceptor);
+], ApiResponseExceptionFilter);
 
 // src/endpoint.module.ts
 function _ts_decorate4(decorators, target, key, desc) {
@@ -493,5 +535,6 @@ __name(routeToTag, "routeToTag");
   ApiSuccessResponse,
   Endpoint,
   EndpointModule,
-  Endpoints
+  Endpoints,
+  needDevTracks
 });

package/dist/index.mjs

@@ -3,8 +3,9 @@ import {
 } from "./chunk-G3XZMNHG.mjs";
 import {
   ApiResponseInterceptor,
-  EndpointModule
-} from "./chunk-L6OSYIFY.mjs";
+  EndpointModule,
+  needDevTracks
+} from "./chunk-F42XQQAA.mjs";
 import {
   Endpoints
 } from "./chunk-5FTZ5OJ5.mjs";
@@ -27,5 +28,6 @@ export {
   ApiSuccessResponse,
   Endpoint,
   EndpointModule,
-  Endpoints
+  Endpoints,
+  needDevTracks
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfe-repo/bff-endpoint",
-  "version": "1.6.0",
+  "version": "1.6.4",
   "sideEffects": false,
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,8 +28,8 @@
     "eslint": "8.57.1",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
-    "@xfe-repo/bff-core": "1.6.0",
-    "@xfe-repo/bff-validation": "1.6.0"
+    "@xfe-repo/bff-core": "1.6.4",
+    "@xfe-repo/bff-validation": "1.6.4"
   },
   "devDependencies": {
     "@nestjs/testing": "11.1.13",
@@ -37,8 +37,8 @@
     "@types/node": "^20.17.0",
     "jest": "^30.2.0",
     "@xfe-repo/eslint-config": "1.6.0",
-    "@xfe-repo/jest-config": "1.6.0",
-    "@xfe-repo/typescript-config": "1.6.0"
+    "@xfe-repo/typescript-config": "1.6.2",
+    "@xfe-repo/jest-config": "1.6.0"
   },
   "peerDependencies": {},
   "publishConfig": {