@lark-apaas/fullstack-nestjs-core 1.0.15-alpha.14 → 1.0.15-alpha.15

package/dist/index.cjs

@@ -92,7 +92,11 @@ var UserContextMiddleware = class {
       tenantId: webUser?.tenant_id,
       appId: webUser?.app_id ?? "",
       loginUrl: webUser?.login_url ?? "",
-      userType: webUser?.user_type ?? ""
+      userType: webUser?.user_type ?? "",
+      env: webUser?.env ?? "runtime",
+      userName: webUser?.user_name?.zh_cn ?? "",
+      userNameEn: webUser?.user_name?.en_us ?? "",
+      userNameI18n: webUser?.user_name ?? {}
     };
     next();
   }
@@ -249,7 +253,7 @@ var CsrfTokenMiddleware = class _CsrfTokenMiddleware {
       res.cookie(cookieKey, token, {
         maxAge: cookieMaxAge,
         path: cookiePath,
-        httpOnly: true,
+        httpOnly: false,
         secure: true,
         sameSite: "none",
         partitioned: true
@@ -262,6 +266,38 @@ CsrfTokenMiddleware = _ts_decorate4([
   (0, import_common4.Injectable)()
 ], CsrfTokenMiddleware);
 
+// src/middlewares/api-fallback/index.ts
+function createApiNotFoundResponse(req) {
+  return {
+    code: 404,
+    message: `Cannot ${req.method} ${req.path}`,
+    error: "Not Found",
+    path: req.path,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+__name(createApiNotFoundResponse, "createApiNotFoundResponse");
+function getApiPathPrefix() {
+  const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
+  if (!globalPrefix) {
+    return "/api/";
+  }
+  const normalizedPrefix = globalPrefix.replace(/\/+$/, "");
+  return `${normalizedPrefix}/api/`;
+}
+__name(getApiPathPrefix, "getApiPathPrefix");
+function apiResponseInterceptor(req, res, next) {
+  const apiPrefix = getApiPathPrefix();
+  if (!req.baseUrl.startsWith(apiPrefix)) {
+    return next();
+  }
+  res.render = function() {
+    return res.status(404).json(createApiNotFoundResponse(req));
+  };
+  next();
+}
+__name(apiResponseInterceptor, "apiResponseInterceptor");
+
 // src/modules/platform/config/app.config.ts
 var import_config = require("@nestjs/config");
 var NAMESPACE = "app";
@@ -360,6 +396,7 @@ var PlatformModule = class _PlatformModule {
   */
   configure(consumer) {
     const options = _PlatformModule.moduleOptions;
+    consumer.apply(apiResponseInterceptor).forRoutes("/api/*");
     consumer.apply(UserContextMiddleware, import_nestjs_logger.LoggerContextMiddleware, import_nestjs_datapaas.SqlExecutionContextMiddleware).forRoutes("/*");
     consumer.apply(CsrfTokenMiddleware, ViewContextMiddleware).exclude("/api/(.*)").forRoutes("*");
     if (options.enableCsrf !== false) {
@@ -383,13 +420,16 @@ PlatformModule = _ts_decorate5([
 var import_nestjs_logger2 = require("@lark-apaas/nestjs-logger");
 var import_cookie_parser = __toESM(require("cookie-parser"), 1);
 var import_nestjs_openapi_devtools = require("@lark-apaas/nestjs-openapi-devtools");
-async function configureApp(app) {
+var defaultPerms = {
+  disableSwagger: false
+};
+async function configureApp(app, perms = defaultPerms) {
   app.useLogger(app.get(import_nestjs_logger2.AppLogger));
   app.flushLogs();
   app.use((0, import_cookie_parser.default)());
   const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
   app.setGlobalPrefix(globalPrefix);
-  if (process.env.NODE_ENV !== "production") {
+  if (process.env.NODE_ENV !== "production" && perms.disableSwagger !== true) {
     try {
       await import_nestjs_openapi_devtools.DevToolsV2Module.mount(app, {
         basePath: process.env.CLIENT_BASE_PATH,

package/dist/index.d.cts

@@ -21,7 +21,11 @@ declare global {
         appId?: string;
         loginUrl?: string;
         userType?: string;
-      };
+        env?: 'preview' | 'runtime';
+        userName?: string; // 默认中文名
+        userNameEn?: string; // 冗余一份英文名
+        userNameI18n?: Record<string, string>; // 带多语的用户名
+      },
       csrfToken?: string;
     }
   }
@@ -52,7 +56,16 @@ declare class PlatformModule implements NestModule {
     configure(consumer: MiddlewareConsumer): void;
 }
 
-declare function configureApp(app: NestExpressApplication): Promise<void>;
+/**
+ * 初始化应用的基础能力（中间件、过滤器、Swagger 等）。
+ *
+ * @param app NestExpressApplication 实例
+ * @param perms 配置项
+ * @param perms.disableSwagger 是否禁用 Swagger（默认：false）
+ */
+declare function configureApp(app: NestExpressApplication, perms?: {
+    disableSwagger?: boolean;
+}): Promise<void>;
 
 interface CsrfTokenOptions {
     cookieKey?: string;
@@ -85,4 +98,15 @@ declare class ViewContextMiddleware implements NestMiddleware {
     use(req: Request, res: Response, next: NextFunction): void;
 }
 
-export { CsrfMiddleware, CsrfTokenMiddleware, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+/**
+ * API 404 响应格式
+ */
+interface ApiNotFoundResponse {
+    code: number;
+    message: string;
+    error: string;
+    path: string;
+    timestamp: string;
+}
+
+export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.d.ts

@@ -21,7 +21,11 @@ declare global {
         appId?: string;
         loginUrl?: string;
         userType?: string;
-      };
+        env?: 'preview' | 'runtime';
+        userName?: string; // 默认中文名
+        userNameEn?: string; // 冗余一份英文名
+        userNameI18n?: Record<string, string>; // 带多语的用户名
+      },
       csrfToken?: string;
     }
   }
@@ -52,7 +56,16 @@ declare class PlatformModule implements NestModule {
     configure(consumer: MiddlewareConsumer): void;
 }
 
-declare function configureApp(app: NestExpressApplication): Promise<void>;
+/**
+ * 初始化应用的基础能力（中间件、过滤器、Swagger 等）。
+ *
+ * @param app NestExpressApplication 实例
+ * @param perms 配置项
+ * @param perms.disableSwagger 是否禁用 Swagger（默认：false）
+ */
+declare function configureApp(app: NestExpressApplication, perms?: {
+    disableSwagger?: boolean;
+}): Promise<void>;
 
 interface CsrfTokenOptions {
     cookieKey?: string;
@@ -85,4 +98,15 @@ declare class ViewContextMiddleware implements NestMiddleware {
     use(req: Request, res: Response, next: NextFunction): void;
 }
 
-export { CsrfMiddleware, CsrfTokenMiddleware, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };
+/**
+ * API 404 响应格式
+ */
+interface ApiNotFoundResponse {
+    code: number;
+    message: string;
+    error: string;
+    path: string;
+    timestamp: string;
+}
+
+export { type ApiNotFoundResponse, CsrfMiddleware, CsrfTokenMiddleware, PlatformModule, type PlatformModuleOptions, UserContextMiddleware, ViewContextMiddleware, configureApp };

package/dist/index.js

@@ -50,7 +50,11 @@ var UserContextMiddleware = class {
       tenantId: webUser?.tenant_id,
       appId: webUser?.app_id ?? "",
       loginUrl: webUser?.login_url ?? "",
-      userType: webUser?.user_type ?? ""
+      userType: webUser?.user_type ?? "",
+      env: webUser?.env ?? "runtime",
+      userName: webUser?.user_name?.zh_cn ?? "",
+      userNameEn: webUser?.user_name?.en_us ?? "",
+      userNameI18n: webUser?.user_name ?? {}
     };
     next();
   }
@@ -207,7 +211,7 @@ var CsrfTokenMiddleware = class _CsrfTokenMiddleware {
       res.cookie(cookieKey, token, {
         maxAge: cookieMaxAge,
         path: cookiePath,
-        httpOnly: true,
+        httpOnly: false,
         secure: true,
         sameSite: "none",
         partitioned: true
@@ -220,6 +224,38 @@ CsrfTokenMiddleware = _ts_decorate4([
   Injectable4()
 ], CsrfTokenMiddleware);
 
+// src/middlewares/api-fallback/index.ts
+function createApiNotFoundResponse(req) {
+  return {
+    code: 404,
+    message: `Cannot ${req.method} ${req.path}`,
+    error: "Not Found",
+    path: req.path,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+__name(createApiNotFoundResponse, "createApiNotFoundResponse");
+function getApiPathPrefix() {
+  const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
+  if (!globalPrefix) {
+    return "/api/";
+  }
+  const normalizedPrefix = globalPrefix.replace(/\/+$/, "");
+  return `${normalizedPrefix}/api/`;
+}
+__name(getApiPathPrefix, "getApiPathPrefix");
+function apiResponseInterceptor(req, res, next) {
+  const apiPrefix = getApiPathPrefix();
+  if (!req.baseUrl.startsWith(apiPrefix)) {
+    return next();
+  }
+  res.render = function() {
+    return res.status(404).json(createApiNotFoundResponse(req));
+  };
+  next();
+}
+__name(apiResponseInterceptor, "apiResponseInterceptor");
+
 // src/modules/platform/config/app.config.ts
 import { registerAs } from "@nestjs/config";
 var NAMESPACE = "app";
@@ -318,6 +354,7 @@ var PlatformModule = class _PlatformModule {
   */
   configure(consumer) {
     const options = _PlatformModule.moduleOptions;
+    consumer.apply(apiResponseInterceptor).forRoutes("/api/*");
     consumer.apply(UserContextMiddleware, LoggerContextMiddleware, SqlExecutionContextMiddleware).forRoutes("/*");
     consumer.apply(CsrfTokenMiddleware, ViewContextMiddleware).exclude("/api/(.*)").forRoutes("*");
     if (options.enableCsrf !== false) {
@@ -341,13 +378,16 @@ PlatformModule = _ts_decorate5([
 import { AppLogger as AppLogger2 } from "@lark-apaas/nestjs-logger";
 import cookieParser from "cookie-parser";
 import { DevToolsV2Module } from "@lark-apaas/nestjs-openapi-devtools";
-async function configureApp(app) {
+var defaultPerms = {
+  disableSwagger: false
+};
+async function configureApp(app, perms = defaultPerms) {
   app.useLogger(app.get(AppLogger2));
   app.flushLogs();
   app.use(cookieParser());
   const globalPrefix = process.env.CLIENT_BASE_PATH ?? "";
   app.setGlobalPrefix(globalPrefix);
-  if (process.env.NODE_ENV !== "production") {
+  if (process.env.NODE_ENV !== "production" && perms.disableSwagger !== true) {
     try {
       await DevToolsV2Module.mount(app, {
         basePath: process.env.CLIENT_BASE_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-nestjs-core",
-  "version": "1.0.15-alpha.14",
+  "version": "1.0.15-alpha.15",
   "description": "FullStack Nestjs Core",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,14 +35,15 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "echo 'ESLint skipped for TypeScript files'",
-    "lint:fix": "eslint src --ext .ts --fix"
+    "lint:fix": "eslint src --ext .ts --fix",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@lark-apaas/nestjs-authnpaas": "^1.0.0",
-    "@lark-apaas/nestjs-authzpaas": "0.1.0-alpha.12",
-    "@lark-apaas/nestjs-datapaas": "1.0.6-alpha.4",
+    "@lark-apaas/nestjs-authzpaas": "0.1.0-alpha.13",
+    "@lark-apaas/nestjs-datapaas": "1.0.6-alpha.13",
     "@lark-apaas/nestjs-logger": "^1.0.2",
-    "@lark-apaas/nestjs-openapi-devtools": "^1.0.7",
+    "@lark-apaas/nestjs-openapi-devtools": "^1.0.9",
     "cookie-parser": "^1.4.7"
   },
   "devDependencies": {