@lark-apaas/fullstack-nestjs-core 1.1.23-alpha.5 → 1.1.23-alpha.7

package/dist/index.cjs

@@ -39,7 +39,6 @@ __export(index_exports, {
   DevToolsModule: () => import_nestjs_openapi_devtools2.DevToolsModule,
   DevToolsV2Module: () => import_nestjs_openapi_devtools2.DevToolsV2Module,
   FileService: () => FileService,
-  PlatformHttpClientService: () => PlatformHttpClientService,
   PlatformModule: () => PlatformModule,
   UserContextMiddleware: () => UserContextMiddleware,
   ViewContextMiddleware: () => ViewContextMiddleware,
@@ -48,8 +47,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/modules/platform/module.ts
-var import_common10 = require("@nestjs/common");
-var import_core2 = require("@nestjs/core");
+var import_common11 = require("@nestjs/common");
+var import_core3 = require("@nestjs/core");
 var import_nestjs_common5 = require("@lark-apaas/nestjs-common");
 var import_config2 = require("@nestjs/config");
 var import_nestjs_observable = require("@lark-apaas/nestjs-observable");
@@ -760,47 +759,10 @@ var PlatformHttpClientService = class _PlatformHttpClientService {
     });
   }
   /**
-  * 创建一个带全局拦截器的独立 HttpClient 实例
-  *
-  * 与 `create()` 类似，但会自动注册全局拦截器（日志、x-tt-env 透传等）
-  * 适用于需要保留平台标准行为，同时又需要添加自定义拦截器的场景
-  *
-  * @param options - 配置选项（会与全局配置合并）
-  * @returns 完整的 HttpClient 实例（带全局拦截器，允许添加更多拦截器）
-  *
-  * @example
-  * ```typescript
-  * const client = this.platformHttp.createWithGlobalInterceptors();
-  * // 客户端已包含日志和 x-tt-env 拦截器
-  * // 可以继续添加自定义拦截器
-  * client.interceptors.request.use((config) => {
-  *   config.headers['x-custom'] = 'value';
-  *   return config;
-  * });
-  * ```
-  */
-  createWithGlobalInterceptors(options) {
-    const client = this.create(options);
-    this.registerInterceptorsForClient(client);
-    return client;
-  }
-  /**
-  * 注册全局拦截器（用于单例实例）
+  * 注册全局拦截器
   */
   registerGlobalInterceptors() {
-    this.registerInterceptorsForClient(this.client);
-  }
-  /**
-  * 为指定的 HttpClient 实例注册标准拦截器
-  *
-  * 包含：
-  * - 请求日志记录
-  * - x-tt-env header 透传
-  * - 响应日志记录
-  * - 错误日志记录
-  */
-  registerInterceptorsForClient(client) {
-    client.interceptors.request.use((config) => {
+    this.client.interceptors.request.use((config) => {
       this.logger.debug(`Server SDK HTTP Request: ${config.method?.toUpperCase()} ${config.url}`);
       const ttEnv = this.requestContext.get("ttEnv");
       if (ttEnv) {
@@ -814,7 +776,7 @@ var PlatformHttpClientService = class _PlatformHttpClientService {
       this.logger.error("Server SDK HTTP Request Error", error, "HttpService");
       return Promise.reject(error);
     });
-    client.interceptors.response.use((response) => {
+    this.client.interceptors.response.use((response) => {
       this.logger.debug(`Server SDK HTTP Response: ${response.status} ${response.url}`);
       return response;
     }, (error) => {
@@ -1228,6 +1190,11 @@ FileService = _ts_decorate9([
 
 // src/modules/platform/module.ts
 var import_nestjs_authzpaas = require("@lark-apaas/nestjs-authzpaas");
+
+// src/controllers/dev-api-routes.controller.ts
+var import_common10 = require("@nestjs/common");
+var import_core2 = require("@nestjs/core");
+var import_swagger = require("@nestjs/swagger");
 function _ts_decorate10(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);
@@ -1235,6 +1202,151 @@ function _ts_decorate10(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate10, "_ts_decorate");
+function _ts_metadata7(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata7, "_ts_metadata");
+var DevApiRoutesController = class {
+  static {
+    __name(this, "DevApiRoutesController");
+  }
+  httpAdapterHost;
+  constructor(httpAdapterHost) {
+    this.httpAdapterHost = httpAdapterHost;
+  }
+  /**
+  * 获取 API 路由列表
+  *
+  * GET /dev/api-routes
+  *
+  * 返回预处理后的 API 路由数据，按模块分组
+  */
+  getApiRoutes() {
+    const routes = this.extractRoutes();
+    const groups = this.groupRoutesByModule(routes);
+    return {
+      groups,
+      total: routes.length
+    };
+  }
+  /**
+  * 从 Express 路由栈中提取 API 路由
+  */
+  extractRoutes() {
+    const server = this.httpAdapterHost.httpAdapter;
+    const router = server.getInstance()._router;
+    if (!router?.stack) {
+      return [];
+    }
+    const routes = [];
+    const seenRoutes = /* @__PURE__ */ new Set();
+    router.stack.forEach((layer) => {
+      if (layer.route) {
+        const path = layer.route.path;
+        if (!path.startsWith("/api/") || path.includes("__framework__") || path.includes("__innerapi__")) {
+          return;
+        }
+        const methods = Object.keys(layer.route.methods).filter((m) => layer.route.methods[m]);
+        methods.forEach((method) => {
+          const upperMethod = method.toUpperCase();
+          const routeKey = `${upperMethod}:${path}`;
+          if (seenRoutes.has(routeKey)) {
+            return;
+          }
+          seenRoutes.add(routeKey);
+          const moduleId = this.extractModuleFromPath(path);
+          const id = this.generateRouteId(upperMethod, path);
+          routes.push({
+            id,
+            path,
+            method: upperMethod,
+            module: moduleId
+          });
+        });
+      }
+    });
+    return routes;
+  }
+  /**
+  * 从路径中提取模块名
+  * /api/users/... -> users
+  * /api/v1/orders/... -> orders
+  */
+  extractModuleFromPath(path) {
+    const segments = path.split("/").filter(Boolean);
+    let startIndex = 0;
+    if (segments[0] === "api") {
+      startIndex = 1;
+    }
+    if (segments[startIndex]?.match(/^v\d+$/)) {
+      startIndex++;
+    }
+    const moduleName = segments[startIndex];
+    if (!moduleName || moduleName.startsWith(":")) {
+      return "default";
+    }
+    return moduleName;
+  }
+  /**
+  * 生成路由唯一标识
+  */
+  generateRouteId(method, path) {
+    const cleanPath = path.replace(/[/:]/g, "_").replace(/^_+|_+$/g, "");
+    return `${method.toLowerCase()}_${cleanPath}`;
+  }
+  /**
+  * 按模块分组路由
+  */
+  groupRoutesByModule(routes) {
+    const groupMap = /* @__PURE__ */ new Map();
+    routes.forEach((route) => {
+      const existing = groupMap.get(route.module) || [];
+      existing.push(route);
+      groupMap.set(route.module, existing);
+    });
+    const groups = [];
+    groupMap.forEach((apis, moduleName) => {
+      groups.push({
+        id: moduleName,
+        name: this.formatModuleName(moduleName),
+        apis: apis.sort((a, b) => a.path.localeCompare(b.path))
+      });
+    });
+    return groups.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  /**
+  * 格式化模块名用于显示
+  */
+  formatModuleName(moduleName) {
+    return moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
+  }
+};
+_ts_decorate10([
+  (0, import_common10.Get)(),
+  (0, import_common10.Header)("Access-Control-Allow-Origin", "*"),
+  (0, import_common10.Header)("Access-Control-Allow-Methods", "GET, OPTIONS"),
+  (0, import_common10.Header)("Access-Control-Allow-Headers", "Content-Type, Accept"),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", []),
+  _ts_metadata7("design:returntype", Object)
+], DevApiRoutesController.prototype, "getApiRoutes", null);
+DevApiRoutesController = _ts_decorate10([
+  (0, import_swagger.ApiExcludeController)(),
+  (0, import_common10.Controller)("dev/api-routes"),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
+    typeof import_core2.HttpAdapterHost === "undefined" ? Object : import_core2.HttpAdapterHost
+  ])
+], DevApiRoutesController);
+
+// src/modules/platform/module.ts
+function _ts_decorate11(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_decorate11, "_ts_decorate");
 var PLATFORM_MODULE_OPTIONS = /* @__PURE__ */ Symbol("PLATFORM_MODULE_OPTIONS");
 var PlatformModule = class _PlatformModule {
   static {
@@ -1245,6 +1357,9 @@ var PlatformModule = class _PlatformModule {
     _PlatformModule.moduleOptions = options;
     return {
       module: _PlatformModule,
+      controllers: process.env.NODE_ENV === "development" ? [
+        DevApiRoutesController
+      ] : [],
       imports: [
         import_config2.ConfigModule.forRoot({
           isGlobal: true,
@@ -1308,8 +1423,8 @@ var PlatformModule = class _PlatformModule {
           useValue: options
         },
         {
-          provide: import_core2.APP_PIPE,
-          useValue: new import_common10.ValidationPipe({
+          provide: import_core3.APP_PIPE,
+          useValue: new import_common11.ValidationPipe({
             transform: true,
             transformOptions: {
               enableImplicitConversion: true
@@ -1328,18 +1443,9 @@ var PlatformModule = class _PlatformModule {
             PlatformHttpClientService
           ]
         },
-        {
-          provide: import_nestjs_common5.HTTP_CLIENT_FACTORY,
-          useFactory: /* @__PURE__ */ __name((svc) => ({
-            create: /* @__PURE__ */ __name((options2) => svc.createWithGlobalInterceptors(options2), "create")
-          }), "useFactory"),
-          inject: [
-            PlatformHttpClientService
-          ]
-        },
         HttpInterceptorService,
         {
-          provide: import_core2.APP_INTERCEPTOR,
+          provide: import_core3.APP_INTERCEPTOR,
           useClass: import_nestjs_observable.TraceInterceptor
         },
         FileService
@@ -1350,8 +1456,6 @@ var PlatformModule = class _PlatformModule {
         import_nestjs_common5.CommonModule,
         import_nestjs_common5.OBSERVABLE_SERVICE,
         import_nestjs_common6.PLATFORM_HTTP_CLIENT,
-        import_nestjs_common5.HTTP_CLIENT_FACTORY,
-        PlatformHttpClientService,
         import_nestjs_capability.CapabilityModule,
         FileService
       ]
@@ -1382,9 +1486,9 @@ var PlatformModule = class _PlatformModule {
     }
   }
 };
-PlatformModule = _ts_decorate10([
-  (0, import_common10.Global)(),
-  (0, import_common10.Module)({})
+PlatformModule = _ts_decorate11([
+  (0, import_common11.Global)(),
+  (0, import_common11.Module)({})
 ], PlatformModule);
 
 // src/setup.ts
@@ -1435,7 +1539,6 @@ var import_nestjs_authzpaas2 = require("@lark-apaas/nestjs-authzpaas");
   DevToolsModule,
   DevToolsV2Module,
   FileService,
-  PlatformHttpClientService,
   PlatformModule,
   UserContextMiddleware,
   ViewContextMiddleware,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { NestModule, DynamicModule, MiddlewareConsumer, NestMiddleware } from '@nestjs/common';
-import { HttpClientConfig, PlatformPluginOptions, HttpClient } from '@lark-apaas/http-client';
+import { HttpClientConfig, PlatformPluginOptions } from '@lark-apaas/http-client';
 import { NestExpressApplication } from '@nestjs/platform-express';
 export { DevToolsModule, DevToolsOptions, DevToolsV2Module, DevToolsV2Options } from '@lark-apaas/nestjs-openapi-devtools';
 import { Request, Response, NextFunction } from 'express';
@@ -170,143 +170,28 @@ declare class FileService {
 }
 
 /**
- * 平台 HttpClient 服务
- *
- * 提供两种使用方式：
- * 1. 全局实例：通过 `instance` 或 `PLATFORM_HTTP_CLIENT` 注入，适用于 95% 的场景
- * 2. 独立实例：通过 `create()` 创建，适用于需要自定义拦截器或配置的场景
- *
- * @example
- * 基本使用（推荐）
- * ```typescript
- * @Injectable()
- * export class UserService {
- *   constructor(
- *     @Inject(PLATFORM_HTTP_CLIENT) private http: SafeHttpClient
- *   ) {}
- *
- *   async getUser() {
- *     return this.http.get('/user');
- *   }
- * }
- * ```
- *
- * @example
- * 需要自定义拦截器（高级场景）
- * ```typescript
- * @Injectable()
- * export class FileService {
- *   private fileClient: HttpClient;
- *
- *   constructor(private platformHttp: PlatformHttpClientService) {
- *     this.fileClient = this.platformHttp.create({
- *       config: { timeout: 60000 }
- *     });
- *
- *     this.fileClient.interceptors.request.use((config) => {
- *       console.log('File upload starting...');
- *       return config;
- *     });
- *   }
- * }
- * ```
+ * API 路由信息（已处理）
  */
-declare class PlatformHttpClientService {
-    private readonly requestContext;
-    private readonly client;
-    private readonly protectedClient;
-    private readonly logger;
-    constructor(requestContext: RequestContextService);
-    /**
-     * 获取受保护的 HttpClient 实例（推荐）
-     *
-     * 该实例不暴露 interceptors，防止业务代码修改全局拦截器
-     *
-     * @returns 受保护的 HttpClient 实例
-     */
-    get instance(): PlatformHttpClient;
-    /**
-     * 获取原始 HttpClient 实例（危险）
-     *
-     * ⚠️ 警告：该实例允许修改拦截器，会影响所有使用全局实例的地方
-     *
-     * 仅用于特殊场景，不应该暴露给业务代码
-     * 如果需要自定义拦截器，请使用 `create()` 方法创建独立实例
-     *
-     * @internal
-     * @returns 原始 HttpClient 实例
-     */
-    get rawInstance(): HttpClient;
-    /**
-     * 创建一个新的独立 HttpClient 实例
-     *
-     * 适用于需要自定义拦截器或配置的场景
-     * 创建的实例完全独立，不会影响全局实例
-     *
-     * @param options - 配置选项（会与全局配置合并）
-     * @returns 完整的 HttpClient 实例（允许修改拦截器）
-     *
-     * @example
-     * ```typescript
-     * @Injectable()
-     * export class FileService {
-     *   private fileClient: HttpClient;
-     *
-     *   constructor(private platformHttp: PlatformHttpClientService) {
-     *     // 创建超时 60 秒的独立实例
-     *     this.fileClient = this.platformHttp.create({
-     *       config: { timeout: 60000 }
-     *     });
-     *
-     *     // 为这个实例注册拦截器（不影响全局实例）
-     *     this.fileClient.interceptors.request.use((config) => {
-     *       console.log('File upload starting...');
-     *       return config;
-     *     });
-     *   }
-     *
-     *   async uploadFile(file: Buffer) {
-     *     return this.fileClient.post('/file/upload', file);
-     *   }
-     * }
-     * ```
-     */
-    create(options?: PlatformHttpClientOptions): HttpClient;
-    /**
-     * 创建一个带全局拦截器的独立 HttpClient 实例
-     *
-     * 与 `create()` 类似，但会自动注册全局拦截器（日志、x-tt-env 透传等）
-     * 适用于需要保留平台标准行为，同时又需要添加自定义拦截器的场景
-     *
-     * @param options - 配置选项（会与全局配置合并）
-     * @returns 完整的 HttpClient 实例（带全局拦截器，允许添加更多拦截器）
-     *
-     * @example
-     * ```typescript
-     * const client = this.platformHttp.createWithGlobalInterceptors();
-     * // 客户端已包含日志和 x-tt-env 拦截器
-     * // 可以继续添加自定义拦截器
-     * client.interceptors.request.use((config) => {
-     *   config.headers['x-custom'] = 'value';
-     *   return config;
-     * });
-     * ```
-     */
-    createWithGlobalInterceptors(options?: PlatformHttpClientOptions): HttpClient;
-    /**
-     * 注册全局拦截器（用于单例实例）
-     */
-    private registerGlobalInterceptors;
-    /**
-     * 为指定的 HttpClient 实例注册标准拦截器
-     *
-     * 包含：
-     * - 请求日志记录
-     * - x-tt-env header 透传
-     * - 响应日志记录
-     * - 错误日志记录
-     */
-    private registerInterceptorsForClient;
+interface ApiRouteInfo {
+    /** 唯一标识 */
+    id: string;
+    /** 路由路径 */
+    path: string;
+    /** HTTP 方法 */
+    method: string;
+    /** 所属模块（从路径提取） */
+    module: string;
+}
+/**
+ * API 路由分组
+ */
+interface ApiRouteGroup {
+    /** 分组 ID */
+    id: string;
+    /** 分组名称 */
+    name: string;
+    /** 该分组下的 API 列表 */
+    apis: ApiRouteInfo[];
 }
 
-export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformHttpClientService, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+export { type ApiNotFoundResponse, type ApiRouteGroup, type ApiRouteInfo, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { NestModule, DynamicModule, MiddlewareConsumer, NestMiddleware } from '@nestjs/common';
-import { HttpClientConfig, PlatformPluginOptions, HttpClient } from '@lark-apaas/http-client';
+import { HttpClientConfig, PlatformPluginOptions } from '@lark-apaas/http-client';
 import { NestExpressApplication } from '@nestjs/platform-express';
 export { DevToolsModule, DevToolsOptions, DevToolsV2Module, DevToolsV2Options } from '@lark-apaas/nestjs-openapi-devtools';
 import { Request, Response, NextFunction } from 'express';
@@ -170,143 +170,28 @@ declare class FileService {
 }
 
 /**
- * 平台 HttpClient 服务
- *
- * 提供两种使用方式：
- * 1. 全局实例：通过 `instance` 或 `PLATFORM_HTTP_CLIENT` 注入，适用于 95% 的场景
- * 2. 独立实例：通过 `create()` 创建，适用于需要自定义拦截器或配置的场景
- *
- * @example
- * 基本使用（推荐）
- * ```typescript
- * @Injectable()
- * export class UserService {
- *   constructor(
- *     @Inject(PLATFORM_HTTP_CLIENT) private http: SafeHttpClient
- *   ) {}
- *
- *   async getUser() {
- *     return this.http.get('/user');
- *   }
- * }
- * ```
- *
- * @example
- * 需要自定义拦截器（高级场景）
- * ```typescript
- * @Injectable()
- * export class FileService {
- *   private fileClient: HttpClient;
- *
- *   constructor(private platformHttp: PlatformHttpClientService) {
- *     this.fileClient = this.platformHttp.create({
- *       config: { timeout: 60000 }
- *     });
- *
- *     this.fileClient.interceptors.request.use((config) => {
- *       console.log('File upload starting...');
- *       return config;
- *     });
- *   }
- * }
- * ```
+ * API 路由信息（已处理）
  */
-declare class PlatformHttpClientService {
-    private readonly requestContext;
-    private readonly client;
-    private readonly protectedClient;
-    private readonly logger;
-    constructor(requestContext: RequestContextService);
-    /**
-     * 获取受保护的 HttpClient 实例（推荐）
-     *
-     * 该实例不暴露 interceptors，防止业务代码修改全局拦截器
-     *
-     * @returns 受保护的 HttpClient 实例
-     */
-    get instance(): PlatformHttpClient;
-    /**
-     * 获取原始 HttpClient 实例（危险）
-     *
-     * ⚠️ 警告：该实例允许修改拦截器，会影响所有使用全局实例的地方
-     *
-     * 仅用于特殊场景，不应该暴露给业务代码
-     * 如果需要自定义拦截器，请使用 `create()` 方法创建独立实例
-     *
-     * @internal
-     * @returns 原始 HttpClient 实例
-     */
-    get rawInstance(): HttpClient;
-    /**
-     * 创建一个新的独立 HttpClient 实例
-     *
-     * 适用于需要自定义拦截器或配置的场景
-     * 创建的实例完全独立，不会影响全局实例
-     *
-     * @param options - 配置选项（会与全局配置合并）
-     * @returns 完整的 HttpClient 实例（允许修改拦截器）
-     *
-     * @example
-     * ```typescript
-     * @Injectable()
-     * export class FileService {
-     *   private fileClient: HttpClient;
-     *
-     *   constructor(private platformHttp: PlatformHttpClientService) {
-     *     // 创建超时 60 秒的独立实例
-     *     this.fileClient = this.platformHttp.create({
-     *       config: { timeout: 60000 }
-     *     });
-     *
-     *     // 为这个实例注册拦截器（不影响全局实例）
-     *     this.fileClient.interceptors.request.use((config) => {
-     *       console.log('File upload starting...');
-     *       return config;
-     *     });
-     *   }
-     *
-     *   async uploadFile(file: Buffer) {
-     *     return this.fileClient.post('/file/upload', file);
-     *   }
-     * }
-     * ```
-     */
-    create(options?: PlatformHttpClientOptions): HttpClient;
-    /**
-     * 创建一个带全局拦截器的独立 HttpClient 实例
-     *
-     * 与 `create()` 类似，但会自动注册全局拦截器（日志、x-tt-env 透传等）
-     * 适用于需要保留平台标准行为，同时又需要添加自定义拦截器的场景
-     *
-     * @param options - 配置选项（会与全局配置合并）
-     * @returns 完整的 HttpClient 实例（带全局拦截器，允许添加更多拦截器）
-     *
-     * @example
-     * ```typescript
-     * const client = this.platformHttp.createWithGlobalInterceptors();
-     * // 客户端已包含日志和 x-tt-env 拦截器
-     * // 可以继续添加自定义拦截器
-     * client.interceptors.request.use((config) => {
-     *   config.headers['x-custom'] = 'value';
-     *   return config;
-     * });
-     * ```
-     */
-    createWithGlobalInterceptors(options?: PlatformHttpClientOptions): HttpClient;
-    /**
-     * 注册全局拦截器（用于单例实例）
-     */
-    private registerGlobalInterceptors;
-    /**
-     * 为指定的 HttpClient 实例注册标准拦截器
-     *
-     * 包含：
-     * - 请求日志记录
-     * - x-tt-env header 透传
-     * - 响应日志记录
-     * - 错误日志记录
-     */
-    private registerInterceptorsForClient;
+interface ApiRouteInfo {
+    /** 唯一标识 */
+    id: string;
+    /** 路由路径 */
+    path: string;
+    /** HTTP 方法 */
+    method: string;
+    /** 所属模块（从路径提取） */
+    module: string;
+}
+/**
+ * API 路由分组
+ */
+interface ApiRouteGroup {
+    /** 分组 ID */
+    id: string;
+    /** 分组名称 */
+    name: string;
+    /** 该分组下的 API 列表 */
+    apis: ApiRouteInfo[];
 }
 
-export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformHttpClientService, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+export { type ApiNotFoundResponse, type ApiRouteGroup, type ApiRouteInfo, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.js

@@ -4,7 +4,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 // src/modules/platform/module.ts
 import { Global, Module, ValidationPipe } from "@nestjs/common";
 import { APP_INTERCEPTOR, APP_PIPE } from "@nestjs/core";
-import { CommonModule, OBSERVABLE_SERVICE as OBSERVABLE_SERVICE2, HTTP_CLIENT_FACTORY } from "@lark-apaas/nestjs-common";
+import { CommonModule, OBSERVABLE_SERVICE as OBSERVABLE_SERVICE2 } from "@lark-apaas/nestjs-common";
 import { ConfigModule, ConfigService } from "@nestjs/config";
 import { NestjsObservableModule as ObservableModule, Observable, ObservableTraceMiddleware, TraceInterceptor } from "@lark-apaas/nestjs-observable";
 import { HttpModule } from "@nestjs/axios";
@@ -714,47 +714,10 @@ var PlatformHttpClientService = class _PlatformHttpClientService {
     });
   }
   /**
-  * 创建一个带全局拦截器的独立 HttpClient 实例
-  *
-  * 与 `create()` 类似，但会自动注册全局拦截器（日志、x-tt-env 透传等）
-  * 适用于需要保留平台标准行为，同时又需要添加自定义拦截器的场景
-  *
-  * @param options - 配置选项（会与全局配置合并）
-  * @returns 完整的 HttpClient 实例（带全局拦截器，允许添加更多拦截器）
-  *
-  * @example
-  * ```typescript
-  * const client = this.platformHttp.createWithGlobalInterceptors();
-  * // 客户端已包含日志和 x-tt-env 拦截器
-  * // 可以继续添加自定义拦截器
-  * client.interceptors.request.use((config) => {
-  *   config.headers['x-custom'] = 'value';
-  *   return config;
-  * });
-  * ```
-  */
-  createWithGlobalInterceptors(options) {
-    const client = this.create(options);
-    this.registerInterceptorsForClient(client);
-    return client;
-  }
-  /**
-  * 注册全局拦截器（用于单例实例）
+  * 注册全局拦截器
   */
   registerGlobalInterceptors() {
-    this.registerInterceptorsForClient(this.client);
-  }
-  /**
-  * 为指定的 HttpClient 实例注册标准拦截器
-  *
-  * 包含：
-  * - 请求日志记录
-  * - x-tt-env header 透传
-  * - 响应日志记录
-  * - 错误日志记录
-  */
-  registerInterceptorsForClient(client) {
-    client.interceptors.request.use((config) => {
+    this.client.interceptors.request.use((config) => {
       this.logger.debug(`Server SDK HTTP Request: ${config.method?.toUpperCase()} ${config.url}`);
       const ttEnv = this.requestContext.get("ttEnv");
       if (ttEnv) {
@@ -768,7 +731,7 @@ var PlatformHttpClientService = class _PlatformHttpClientService {
       this.logger.error("Server SDK HTTP Request Error", error, "HttpService");
       return Promise.reject(error);
     });
-    client.interceptors.response.use((response) => {
+    this.client.interceptors.response.use((response) => {
       this.logger.debug(`Server SDK HTTP Response: ${response.status} ${response.url}`);
       return response;
     }, (error) => {
@@ -1182,6 +1145,11 @@ FileService = _ts_decorate9([
 
 // src/modules/platform/module.ts
 import { AuthZPaasModule } from "@lark-apaas/nestjs-authzpaas";
+
+// src/controllers/dev-api-routes.controller.ts
+import { Controller, Get, Header } from "@nestjs/common";
+import { HttpAdapterHost as HttpAdapterHost2 } from "@nestjs/core";
+import { ApiExcludeController } from "@nestjs/swagger";
 function _ts_decorate10(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);
@@ -1189,6 +1157,151 @@ function _ts_decorate10(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate10, "_ts_decorate");
+function _ts_metadata7(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata7, "_ts_metadata");
+var DevApiRoutesController = class {
+  static {
+    __name(this, "DevApiRoutesController");
+  }
+  httpAdapterHost;
+  constructor(httpAdapterHost) {
+    this.httpAdapterHost = httpAdapterHost;
+  }
+  /**
+  * 获取 API 路由列表
+  *
+  * GET /dev/api-routes
+  *
+  * 返回预处理后的 API 路由数据，按模块分组
+  */
+  getApiRoutes() {
+    const routes = this.extractRoutes();
+    const groups = this.groupRoutesByModule(routes);
+    return {
+      groups,
+      total: routes.length
+    };
+  }
+  /**
+  * 从 Express 路由栈中提取 API 路由
+  */
+  extractRoutes() {
+    const server = this.httpAdapterHost.httpAdapter;
+    const router = server.getInstance()._router;
+    if (!router?.stack) {
+      return [];
+    }
+    const routes = [];
+    const seenRoutes = /* @__PURE__ */ new Set();
+    router.stack.forEach((layer) => {
+      if (layer.route) {
+        const path = layer.route.path;
+        if (!path.startsWith("/api/") || path.includes("__framework__") || path.includes("__innerapi__")) {
+          return;
+        }
+        const methods = Object.keys(layer.route.methods).filter((m) => layer.route.methods[m]);
+        methods.forEach((method) => {
+          const upperMethod = method.toUpperCase();
+          const routeKey = `${upperMethod}:${path}`;
+          if (seenRoutes.has(routeKey)) {
+            return;
+          }
+          seenRoutes.add(routeKey);
+          const moduleId = this.extractModuleFromPath(path);
+          const id = this.generateRouteId(upperMethod, path);
+          routes.push({
+            id,
+            path,
+            method: upperMethod,
+            module: moduleId
+          });
+        });
+      }
+    });
+    return routes;
+  }
+  /**
+  * 从路径中提取模块名
+  * /api/users/... -> users
+  * /api/v1/orders/... -> orders
+  */
+  extractModuleFromPath(path) {
+    const segments = path.split("/").filter(Boolean);
+    let startIndex = 0;
+    if (segments[0] === "api") {
+      startIndex = 1;
+    }
+    if (segments[startIndex]?.match(/^v\d+$/)) {
+      startIndex++;
+    }
+    const moduleName = segments[startIndex];
+    if (!moduleName || moduleName.startsWith(":")) {
+      return "default";
+    }
+    return moduleName;
+  }
+  /**
+  * 生成路由唯一标识
+  */
+  generateRouteId(method, path) {
+    const cleanPath = path.replace(/[/:]/g, "_").replace(/^_+|_+$/g, "");
+    return `${method.toLowerCase()}_${cleanPath}`;
+  }
+  /**
+  * 按模块分组路由
+  */
+  groupRoutesByModule(routes) {
+    const groupMap = /* @__PURE__ */ new Map();
+    routes.forEach((route) => {
+      const existing = groupMap.get(route.module) || [];
+      existing.push(route);
+      groupMap.set(route.module, existing);
+    });
+    const groups = [];
+    groupMap.forEach((apis, moduleName) => {
+      groups.push({
+        id: moduleName,
+        name: this.formatModuleName(moduleName),
+        apis: apis.sort((a, b) => a.path.localeCompare(b.path))
+      });
+    });
+    return groups.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  /**
+  * 格式化模块名用于显示
+  */
+  formatModuleName(moduleName) {
+    return moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
+  }
+};
+_ts_decorate10([
+  Get(),
+  Header("Access-Control-Allow-Origin", "*"),
+  Header("Access-Control-Allow-Methods", "GET, OPTIONS"),
+  Header("Access-Control-Allow-Headers", "Content-Type, Accept"),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", []),
+  _ts_metadata7("design:returntype", Object)
+], DevApiRoutesController.prototype, "getApiRoutes", null);
+DevApiRoutesController = _ts_decorate10([
+  ApiExcludeController(),
+  Controller("dev/api-routes"),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
+    typeof HttpAdapterHost2 === "undefined" ? Object : HttpAdapterHost2
+  ])
+], DevApiRoutesController);
+
+// src/modules/platform/module.ts
+function _ts_decorate11(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_decorate11, "_ts_decorate");
 var PLATFORM_MODULE_OPTIONS = /* @__PURE__ */ Symbol("PLATFORM_MODULE_OPTIONS");
 var PlatformModule = class _PlatformModule {
   static {
@@ -1199,6 +1312,9 @@ var PlatformModule = class _PlatformModule {
     _PlatformModule.moduleOptions = options;
     return {
       module: _PlatformModule,
+      controllers: process.env.NODE_ENV === "development" ? [
+        DevApiRoutesController
+      ] : [],
       imports: [
         ConfigModule.forRoot({
           isGlobal: true,
@@ -1282,15 +1398,6 @@ var PlatformModule = class _PlatformModule {
             PlatformHttpClientService
           ]
         },
-        {
-          provide: HTTP_CLIENT_FACTORY,
-          useFactory: /* @__PURE__ */ __name((svc) => ({
-            create: /* @__PURE__ */ __name((options2) => svc.createWithGlobalInterceptors(options2), "create")
-          }), "useFactory"),
-          inject: [
-            PlatformHttpClientService
-          ]
-        },
         HttpInterceptorService,
         {
           provide: APP_INTERCEPTOR,
@@ -1304,8 +1411,6 @@ var PlatformModule = class _PlatformModule {
         CommonModule,
         OBSERVABLE_SERVICE2,
         PLATFORM_HTTP_CLIENT3,
-        HTTP_CLIENT_FACTORY,
-        PlatformHttpClientService,
         CapabilityModule,
         FileService
       ]
@@ -1336,7 +1441,7 @@ var PlatformModule = class _PlatformModule {
     }
   }
 };
-PlatformModule = _ts_decorate10([
+PlatformModule = _ts_decorate11([
   Global(),
   Module({})
 ], PlatformModule);
@@ -1388,7 +1493,6 @@ export {
   DevToolsModule,
   DevToolsV2Module2 as DevToolsV2Module,
   FileService,
-  PlatformHttpClientService,
   PlatformModule,
   UserContextMiddleware,
   ViewContextMiddleware,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-nestjs-core",
-  "version": "1.1.23-alpha.5",
+  "version": "1.1.23-alpha.7",
   "description": "FullStack Nestjs Core",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,12 +42,12 @@
     "@lark-apaas/file-service": "^0.1.1",
     "@lark-apaas/http-client": "^0.1.2",
     "@lark-apaas/nestjs-authnpaas": "^1.0.2",
-    "@lark-apaas/nestjs-authzpaas": "0.1.2-alpha.4",
-    "@lark-apaas/nestjs-capability": "0.1.5-alpha.4",
-    "@lark-apaas/nestjs-common": "0.1.4-alpha.4",
-    "@lark-apaas/nestjs-datapaas": "1.0.10-alpha.4",
-    "@lark-apaas/nestjs-logger": "1.0.10-alpha.4",
-    "@lark-apaas/nestjs-observable": "0.0.5-alpha.4",
+    "@lark-apaas/nestjs-authzpaas": "^0.1.1",
+    "@lark-apaas/nestjs-capability": "^0.1.3",
+    "@lark-apaas/nestjs-common": "^0.1.3",
+    "@lark-apaas/nestjs-datapaas": "^1.0.9",
+    "@lark-apaas/nestjs-logger": "1.0.10-alpha.6",
+    "@lark-apaas/nestjs-observable": "^0.0.4",
     "@lark-apaas/nestjs-openapi-devtools": "^1.0.9",
     "@lark-apaas/nestjs-trigger": "^0.0.2",
     "@nestjs/axios": "^4.0.1",