NestJS Boot

外观

更新日志 ​

2.14 (2026-05-25) ​

✨ 新功能 ​

  • Zod: zNum 支持字符串 Infinity 解析
  • Prisma: 优化时间处理逻辑，增强关联查询灵活性
  • Prisma: 支持 nanoid 时间戳偏移配置
  • 添加 AI 编码规则和模板（.ai/ 目录）

🐛 修复 ​

  • Prisma: 修复数据库抖动查询问题

2.13 (2026-03-18) ​

  • Zod: zBool 支持空串和 null 处理，空串视为未传

2.12 (2026-03-15) ​

  • Prisma: 新增模型元数据工具 getModelsMeta()，支持从 Prisma 7 运行时读取模型信息
  • 文档全面切换到运行时元数据（替代旧的 DMMF 方式）

2.11 (2026-03-12 ~ 03-14) ​

✨ 新功能 ​

  • Zod: 新增字符串处理 helper — zStrArr（数组逐项 trim）、空串转 null 系列
  • Zod: 错误消息支持基于 describe() 显示字段标签，兼容 transform/lazy/联合类型
  • Prisma: 审计扩展支持模型自动发现 + 手动指定/排除

🐛 修复 ​

  • Prisma: bulkUpsert() 在 Prisma 7+ 下统一切换到 _runtimeDataModel.models

2.10 (2026-03-09) ​

  • Prisma: 事务代理增强安全拦截，防止事务内不当调用（如 $connect/$disconnect）

2.9 (2026-03-09) ​

  • Prisma: 新增 bulkUpsert() — MySQL/MariaDB 原生批量 Upsert（INSERT ... ON DUPLICATE KEY UPDATE），适合大批量数据导入
  • Prisma: 修复事务代理递归解析问题

2.7 (2026-03-06) ​

✨ 新功能 ​

  • Prisma: 新增 PrismaRepository<T> 批量查询方法（findInBatches、upsertMany）
  • Prisma: 中间件迁移到 $extends 扩展模式（软删除 + 审计）

2.6 (2026-03-06) ​

✨ 新功能 ​

  • Prisma: PrismaBaseService — 抽象服务基类，Proxy 透明代理 + 生命周期管理
  • Prisma: @PrismaTransactional() — 声明式事务装饰器（AsyncLocalStorage 传播）
  • Prisma: 树形结构工具（buildTree、flattenTree、findTreeNode、getTreePath）
  • Prisma: Zod Schema 生成工具（从 Prisma 模型自动生成 Zod 校验 Schema）
  • 多数据源事务管理支持

2.5 (2026-03-06) ​

  • 引入 nestjs-cls 请求上下文管理，重构认证拦截器
  • DTO 全面切换到 Zod Schema（替代 class-validator）
  • 新增 RequestContextInterceptor，支持异步代码中获取当前用户

2.3 (2026-03-05) ​

✨ 新功能 ​

  • Prisma: Select/Exclude 字段选择工具
  • Health: 新增 HealthModule + HealthService（动态发现 + 并行检测）
  • Cache: 新增 CacheNotReadyException，支持健康检查和异常降级
  • Auth: 新增请求上下文拦截器（getCurrentUser() / getCurrentUserId()）

2.1 (2026-03-04) ​

大版本升级

此版本包含 ORM 切换和验证框架替换，属于重大升级。

💥 Breaking Changes ​

  • ORM: 从 TypeORM 迁移到 Prisma，新增 PrismaBaseService 和事务装饰器
  • 验证: 从 class-validator 切换到 Zod 4，新增 20+ 预处理器（zStr/zVarChar/zQueryInt/zEnumStr 等）
  • 响应: 重构响应格式，新增 Res<T> 统一信封 + traceId 链路追踪

✨ 新功能 ​

  • 新增操作日志模块（OperationModule + @Operation 装饰器）
  • 新增 XML 解析装饰器（@XmlBody）
  • 新增高复用 DTO 组合器（zId/zIds/zPage/zDateRange）
  • Multipart 模块优化（安全类型验证 + 超时控制）
  • Snowflake ID 生成器重构

1.x (2025-10 ~ 2026-01) ​

版本关键变更
1.12Snowflake ID 生成器重构，移除 @sapphire/snowflake 依赖
1.11Redis 连接管理增强（健康检查 + 自动重连）；INJECT_ENUM 统一管理
1.10Multipart 模块增强（安全类型验证）；全局异常过滤器优化
1.8查询参数清理工具；智能 Like 支持
1.5声明式事务装饰器（@Transactional）
1.4新增基于 Fastify 的文件上传模块
1.1核心库重构（认证/缓存/验证/异常处理）

0.x (2025-03 ~ 2025-04) ​

初始版本。包含认证模块（JWT + AES 加密）、缓存模块、日志模块、验证管道、异常过滤器等基础功能。