refactor: rename zodValidation to zodValidator

Author: yingzhi0808

docs/guides/getting-started.md

@@ -231,7 +231,7 @@ JSDoc 注释说明：
 ```typescript
 import express from "express";
 // [!code ++:2]
-import { validateRequest } from "api-morph/express";
+import { zodValidator } from "api-morph/express";
 import { UpdateUserDto, UserIdDto } from "./schema";
 
 const app = express();
@@ -247,7 +247,7 @@ app.put("/api/users/:id", (req, res) => { // [!code --]
 // [!code ++:4]
 app.put(
   "/api/users/:id",
-  validateRequest({ params: UserIdDto, body: UpdateUserDto }),
+  zodValidator({ params: UserIdDto, body: UpdateUserDto }),
   (req, res) => {
     const { id } = req.params;
     const { email, username } = req.body;
@@ -268,9 +268,9 @@ app.listen(port, () => {
 
 ### 这一步发生了什么？
 
-通过集成 `validateRequest` 中间件，我们可以利用 Zod 对请求参数进行校验，这在真实的后端项目中几乎是必须的步骤。如果你不使用 api-morph，也会通过其他的方式实现这个功能。
+通过集成 `zodValidator` 中间件，我们可以利用 Zod 对请求参数进行校验，这在真实的后端项目中几乎是必须的步骤。如果你不使用 api-morph，也会通过其他的方式实现这个功能。
 
-**api-morph 的核心理念是尽可能利用已有的代码，分析它，然后自动推断出必要的信息。** 当你使用 `validateRequest` 后，api-morph 会分析它然后自动生成对应的请求参数文档。
+**api-morph 的核心理念是尽可能利用已有的代码，分析它，然后自动推断出必要的信息。** 当你使用 `zodValidator` 后，api-morph 会分析它然后自动生成对应的请求参数文档。
 
 具体来说：
 - **自动验证路径参数**：`params: UserIdDto` 会验证 URL 中的 `:id` 参数
@@ -286,7 +286,7 @@ app.listen(port, () => {
 
 ```typescript
 import express from "express";
-import { validateRequest } from "api-morph/express";
+import { zodValidator } from "api-morph/express";
 import { UpdateUserDto, UserIdDto } from "./schema"; // [!code --]
 import { UpdateUserDto, UpdateUserVo, UserIdDto } from "./schema"; // [!code ++]
 
@@ -303,7 +303,7 @@ app.use(express.json());
  */
 app.put(
   "/api/users/:id",
-  validateRequest({ params: UserIdDto, body: UpdateUserDto }),
+  zodValidator({ params: UserIdDto, body: UpdateUserDto }),
   (req, res) => {
     const { id } = req.params;
     const { email, username } = req.body;
@@ -337,9 +337,9 @@ app.listen(port, () => {
 
 ```typescript
 import express from "express";
-import { validateRequest } from "api-morph/express"; // [!code --]
+import { zodValidator } from "api-morph/express"; // [!code --]
 import { generateDocument } from "api-morph"; // [!code ++]
-import { setupSwaggerUI, validateRequest } from "api-morph/express"; // [!code ++]
+import { setupSwaggerUI, zodValidator } from "api-morph/express"; // [!code ++]
 import { UpdateUserDto, UpdateUserVo, UserIdDto } from "./schema";
 
 const app = express();
@@ -354,7 +354,7 @@ app.use(express.json());
  */
 app.put(
   "/api/users/:id",
-  validateRequest({ params: UserIdDto, body: UpdateUserDto }),
+  zodValidator({ params: UserIdDto, body: UpdateUserDto }),
   (req, res) => {
     const { id } = req.params;
     const { email, username } = req.body;

docs/guides/working-principles.md

@@ -125,7 +125,7 @@ app.get("/api/users/:id", (req, res) => {
 ::: code-group
 
 ```typescript [index.ts]
-import { validateRequest } from "api-morph/express";
+import { zodValidator } from "api-morph/express";
 import express from "express";
 import { UserIdDto } from "./schema";
 
@@ -136,7 +136,7 @@ const app = express();
  */
 app.get(
   "/api/users/:id",
-  validateRequest({
+  zodValidator({
     params: UserIdDto,
   }),
   (req, res) => {},
@@ -228,7 +228,7 @@ app.get('/api/users', getUserList);
 
 - **HTTP 方法**：从路由定义中自动识别（如 `app.get()`、`app.post()` 等）
 - **API 路径**：从路由路径中提取并转换为 OpenAPI 格式（如 `/users/:id` → `/users/{id}`）
-- **请求参数**：从 `validateRequest` 中间件中提取参数验证规则
+- **请求参数**：从 `zodValidator` 中间件中提取参数验证规则
   - `params`：路径参数
   - `query`：查询参数
   - `body`：请求体参数
@@ -264,7 +264,7 @@ const openapi = await generateDocument(
  * @operationId createUserV2        // 👈 覆盖自动生成的 operationId
  * @summary 创建新用户
  */
-app.get('/api/users', validateRequest({  // 👈 代码分析器：GET /api/users
+app.get('/api/users', zodValidator({  // 👈 代码分析器：GET /api/users
   body: UserCreateDto
 }), createUser);
 

src/express/index.ts

@@ -3,5 +3,5 @@
  * @module express
  */
 
-export * from "./middlewares/zodValidation";
+export * from "./middlewares/zodValidator";
 export * from "./swagger";

src/express/middlewares/zodValidation.ts src/express/middlewares/zodValidator.tssrc/express/middlewares/zodValidation.ts renamed to src/express/middlewares/zodValidator.ts

@@ -69,7 +69,7 @@ const defaultErrorHandler: ErrorRequestHandler = (error, _req, res) => {
 /**
  * 创建类型安全的 Zod 校验中间件
  */
-export function validateRequest<
+export function zodValidator<
   TParams extends ZodObject = ZodObject,
   TQuery extends ZodObject = ZodObject,
   TBody extends ZodObject = ZodObject,

src/parsers/OpenAPIParser.test.ts

@@ -260,7 +260,7 @@ const app = express()
  * @response 200 {@link UserVo} 获取用户信息成功
  * @response 404 {@link UserNotFoundVo} 用户不存在
  */
-app.get("/api/users/:id", validateRequest({
+app.get("/api/users/:id", zodValidator({
   params: UserIdDto
 }), (req, res) => {})
 
@@ -271,7 +271,7 @@ app.get("/api/users/:id", validateRequest({
  * @response 200 {@link UpdateUserVo} 更新用户信息成功
  * @response 404 {@link UserNotFoundVo} 用户不存在
  */
-app.put("/api/users/:id", validateRequest({
+app.put("/api/users/:id", zodValidator({
   params: UserIdDto,
   body: UpdateUserDto
 }), (req, res) => {})`,
@@ -307,7 +307,7 @@ const app = express()
  * @response 200 {@link UserVo} 获取用户信息成功
  * @response 404 {@link UserNotFoundVo} 用户不存在
  */
-app.get("/api/users/:id", validateRequest({
+app.get("/api/users/:id", zodValidator({
   params: UserIdDto
 }), (req, res) => {})`,
       );