api-contracts-and-zod-validation

用途：为表单、API 路由和 Server Actions 生成 Zod 校验模式并配合 TypeScript 类型推断，在运行时做输入校验。主要能力：从现有 TypeScript 接口/类型生成等价 Zod schema，支持双向类型兼容与 z.infer 推断；为 React Hook Form、Formik 或原生表单生成校验，支持字段级规则（长度、正则、自定义校验）、嵌套对象、数组和复杂结构；为 API 路由与 Server Action 加入校验，使用 .parse() 或 .safeParse() 包裹处理逻辑，返回类型化错误，校验查询参数、请求体与路由参数。提供脚本 python scripts/generate_zod_schema.py --input types/entities.ts --output schemas/entities.ts 解析 TypeScript AST 自动生成 schema，保留 JSDoc 说明。资源含 references/zod_patterns.md 常见校验模式，以及 assets/schema_templates/ 下的表单、API 路由、Server Action、实体模板。工作流：先定义请求/响应 TypeScript 类型，再生成或选择 schema，接入路由或动作入口校验并处理错误。建议使用 .safeParse() 避免抛异常、提供友好错误信息、在边界尽早校验、schema 与路由就近存放。限制：官方资料未提供具体收费、平台支持范围和效果数据，暂未提供。