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

package/dist/index.cjs

@@ -47,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");
@@ -576,17 +576,7 @@ var FrameworkDebugMiddleware = class {
   constructor(httpAdapterHost) {
     this.httpAdapterHost = httpAdapterHost;
   }
-  use(req, res) {
-    const origin = req.headers.origin;
-    if (origin) {
-      res.setHeader("Access-Control-Allow-Origin", origin);
-      res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
-      res.setHeader("Access-Control-Allow-Headers", "Content-Type, Accept");
-    }
-    if (req.method === "OPTIONS") {
-      res.status(204).end();
-      return;
-    }
+  use(_req, res) {
     res.json(this.getDebugInfo());
   }
   getDebugInfo() {
@@ -1200,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);
@@ -1207,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 {
@@ -1217,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,
@@ -1280,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
@@ -1302,7 +1445,7 @@ var PlatformModule = class _PlatformModule {
         },
         HttpInterceptorService,
         {
-          provide: import_core2.APP_INTERCEPTOR,
+          provide: import_core3.APP_INTERCEPTOR,
           useClass: import_nestjs_observable.TraceInterceptor
         },
         FileService
@@ -1343,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

package/dist/index.d.cts

@@ -169,4 +169,29 @@ declare class FileService {
     private _getFileMetadata;
 }
 
-export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+/**
+ * API 路由信息（已处理）
+ */
+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, type ApiRouteGroup, type ApiRouteInfo, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.d.ts

@@ -169,4 +169,29 @@ declare class FileService {
     private _getFileMetadata;
 }
 
-export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+/**
+ * API 路由信息（已处理）
+ */
+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, type ApiRouteGroup, type ApiRouteInfo, CsrfMiddleware, CsrfTokenMiddleware, FileService, type PlatformHttpClientOptions, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.js

@@ -531,17 +531,7 @@ var FrameworkDebugMiddleware = class {
   constructor(httpAdapterHost) {
     this.httpAdapterHost = httpAdapterHost;
   }
-  use(req, res) {
-    const origin = req.headers.origin;
-    if (origin) {
-      res.setHeader("Access-Control-Allow-Origin", origin);
-      res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
-      res.setHeader("Access-Control-Allow-Headers", "Content-Type, Accept");
-    }
-    if (req.method === "OPTIONS") {
-      res.status(204).end();
-      return;
-    }
+  use(_req, res) {
     res.json(this.getDebugInfo());
   }
   getDebugInfo() {
@@ -1155,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);
@@ -1162,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 {
@@ -1172,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,
@@ -1298,7 +1441,7 @@ var PlatformModule = class _PlatformModule {
     }
   }
 };
-PlatformModule = _ts_decorate10([
+PlatformModule = _ts_decorate11([
   Global(),
   Module({})
 ], PlatformModule);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-nestjs-core",
-  "version": "1.1.23-alpha.6",
+  "version": "1.1.23-alpha.7",
   "description": "FullStack Nestjs Core",
   "type": "module",
   "main": "./dist/index.js",
@@ -46,7 +46,7 @@
     "@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.5",
+    "@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",