用途:为 Mix Space 项目提供统一的 Zod schema 编写与请求校验规范,适用于创建 DTO、校验 schema 及处理请求参数校验。
主要能力:定义基础 schema 并用 z.infer 推断类型;用 .partial() 生成更新用部分 schema;通过 @Body({ schema })、@Query、@Param({ schema }) 在控制器中接线校验。项目在 apps/core/src/common/zod/ 提供自定义校验器,如 zNonEmptyString、zCoerceInt、zCoerceBoolean、zCoerceDate、zHexColor、zAllowedUrl、zPaginationPage、zPaginationSize、zSortOrder、zArrayUnique、zUniqueStringArray,以及 custom.ts 中的 zSlug、zEmail、zUrl、zPinDate、zRefTypeTransform 等;实体 ID 使用 zEntityId、zEntityIdOrInt,路径参数可用 EntityIdSchema 与 EntityIdDto。支持 .extend() 组合、默认值、preprocess、union、enum、数组长度与唯一性、嵌套对象、refine 条件校验。
使用方式:从 ~/common/zod 导入校验器,定义 schema 后导出 z.infer 类型;控制器中通过 @Body({ schema: MySchema }) body: MyInput 等方式接入。
限制:资料未提供安装命令、版本要求、错误处理细节及完整项目配置说明。