@lark-apaas/fullstack-nestjs-core 1.2.0-alpha.1 → 1.2.0-alpha.20261017012411

package/README.md

@@ -138,6 +138,55 @@ export class AppModule implements NestModule {
 
 全局平台模块，集成了所有核心功能。
 
+#### 全局 ValidationPipe 与数字 DTO
+
+`PlatformModule.forRoot()` 会以 `APP_PIPE` 注册下面的全局验证管道；该管道来自 `PlatformModule`，不是由 `configureApp()` 注册的：
+
+```typescript
+new ValidationPipe({
+  transform: true,
+  transformOptions: {
+    enableImplicitConversion: true,
+  },
+});
+```
+
+对于带有类型元数据的数字 DTO 字段，请求值会先做隐式类型转换，再由 `class-validator` 执行该字段上的全部校验器。最终是否通过取决于转换后的值是否满足全部约束，而不是只看原始 JSON token 的类型：
+
+- 文本 `"1.5"` 转换为数字后可以通过 `@IsNumber()`，但不能通过 `@IsInt()`。
+- 小于 `@Min()` 下限的输入即使能转换为数字，仍会因下限约束失败。
+- 明显非数字的文本无法成为有效数字，会被后续的 `@IsNumber()` / `@IsInt()` 等约束拒绝。
+
+**默认合同：** 如果业务合同没有明确要求原始 JSON token 必须是 number，不要仅因为输入是数字文本就额外判定为 400。应按字段实际含义声明数字类型校验器和全部业务约束；这不表示所有数字文本都会成功。例如：
+
+```typescript
+import { IsInt, Min } from 'class-validator';
+
+export class CreateOrderDto {
+  @IsInt()
+  @Min(1)
+  quantity!: number;
+}
+```
+
+在默认全局管道下，`"2"` 转换后满足两个约束；`"1.5"` 不满足 `@IsInt()`，`"0"` 不满足 `@Min(1)`，非数字文本也不会通过。
+
+**显式严格合同：** 只有当业务明确要求拒绝原始 JSON 字符串、只接受 JSON number 时，才需要额外实现这一限制。可以在单个 DTO 字段上恢复原始请求值，再继续使用 `@IsNumber()` / `@IsInt()` 以及所有业务约束，不必修改全局管道：
+
+```typescript
+import { Transform } from 'class-transformer';
+import { IsInt, Min } from 'class-validator';
+
+export class StrictCreateOrderDto {
+  @Transform(({ obj, key }) => obj[key], { toClassOnly: true })
+  @IsInt()
+  @Min(1)
+  quantity!: number;
+}
+```
+
+这个写法保留 JSON number 的正常校验，同时让原始 JSON string 在校验前恢复为 string，因此由 `@IsInt()` 拒绝；需要允许小数时可以在同一字段局部写法中使用 `@IsNumber()` 并保留其它业务约束。这是经当前依赖版本验证的一种安全局部方案，并非唯一实现要求；它不会改变其他 DTO 字段或全局 `ValidationPipe` 的默认行为。
+
 #### 配置选项
 
 | 选项 | 类型 | 默认值 | 描述 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-nestjs-core",
-  "version": "1.2.0-alpha.1",
+  "version": "1.2.0-alpha.20261017012411",
   "description": "FullStack Nestjs Core",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,7 @@
     "typescript"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=18.0.0"
   },
   "files": [
     "dist"
@@ -49,7 +49,7 @@
     "@lark-apaas/nestjs-datapaas": "^1.0.21",
     "@lark-apaas/nestjs-http-forwarder": "^0.1.3",
     "@lark-apaas/nestjs-logger": "^1.0.18",
-    "@lark-apaas/nestjs-mcp": "0.2.0-alpha.1",
+    "@lark-apaas/nestjs-mcp": "^0.1.2",
     "@lark-apaas/nestjs-observable": "^0.0.12",
     "@lark-apaas/nestjs-openapi-devtools": "^1.0.10",
     "@lark-apaas/nestjs-trigger": "^0.0.3",