feat: add Hono support

Author: yingzhi0808

examples/express/index.ts

@@ -7,14 +7,17 @@ const app = express();
 
 app.use(express.json());
 
+const usersRouter = express.Router();
+const versionRouter = express.Router();
+
 /**
  * @summary 更新用户信息
  * @description 更新指定用户的个人信息
  * @tags users
  * @response 200 {@link UpdateUserVo} 更新用户信息成功
  */
-app.put(
-  "/api/users/:id",
+usersRouter.put(
+  ":id",
   zodValidator({
     params: UserIdDto,
     body: UpdateUserDto,
@@ -31,6 +34,9 @@ app.put(
   },
 );
 
+versionRouter.use("users", usersRouter);
+app.use(versionRouter);
+
 // 生成 OpenAPI 文档
 const openapi = await generateDocument(
   {
@@ -47,6 +53,8 @@ const openapi = await generateDocument(
   },
 );
 
+console.log(openapi);
+
 // 提供 OpenAPI JSON 文档
 app.get("/openapi.json", (_req, res) => {
   res.json(openapi);

examples/hono/index.ts

@@ -0,0 +1,64 @@
+import { serve } from "@hono/node-server";
+import { generateDocument } from "api-morph";
+import { setupSwaggerUI, zodValidator } from "api-morph/hono";
+import { Hono } from "hono";
+import { UpdateUserDto, UpdateUserVo, UserIdDto } from "./schema";
+
+const app = new Hono();
+
+/**
+ * @summary 更新用户信息
+ * @description 更新指定用户的个人信息
+ * @tags users
+ * @response 200 {@link UpdateUserVo} 更新用户信息成功
+ */
+app.put(
+  "/api/users/:id",
+  zodValidator("param", UserIdDto),
+  zodValidator("json", UpdateUserDto),
+  (c) => {
+    const { id } = c.req.valid("param");
+    const { email, username } = c.req.valid("json");
+
+    return c.json({
+      id,
+      email,
+      username,
+    });
+  },
+);
+
+// 生成 OpenAPI 文档
+const openapi = await generateDocument(
+  {
+    info: {
+      version: "1.0.0",
+      title: "用户管理 API",
+      description: "这是一个用户管理 API 的文档示例",
+    },
+  },
+  {
+    parserOptions: {
+      include: ["examples/hono/**/*.ts"],
+    },
+  },
+);
+
+// 提供 OpenAPI JSON 文档
+app.get("/openapi.json", (c) => {
+  return c.json(openapi);
+});
+
+// 提供 Swagger UI 界面
+setupSwaggerUI("/swagger-ui", app);
+
+serve(
+  {
+    fetch: app.fetch,
+    port: 3000,
+  },
+  (info) => {
+    console.log(`Example app listening on port ${info.port}`);
+    console.log(`访问 http://localhost:${info.port}/swagger-ui 查看 API 文档`);
+  },
+);

examples/hono/schema.ts

@@ -0,0 +1,36 @@
+import { z } from "zod/v4";
+
+export const UserIdDto = z.object({
+  id: z.string().meta({ description: "用户ID" }),
+});
+
+export const UpdateUserDto = z.object({
+  email: z.email().meta({
+    description: "用户邮箱地址",
+    examples: ["[email protected]"],
+  }),
+  username: z
+    .string()
+    .min(3)
+    .max(50)
+    .meta({
+      description: "用户名",
+      examples: ["John Doe"],
+    }),
+});
+
+export const UpdateUserVo = z.object({
+  id: z.string().meta({ description: "用户ID" }),
+  email: z.email().meta({
+    description: "用户邮箱地址",
+    examples: ["[email protected]"],
+  }),
+  username: z
+    .string()
+    .min(3)
+    .max(50)
+    .meta({
+      description: "用户名",
+      examples: ["John Doe"],
+    }),
+});

examples/koa/index.ts

@@ -31,7 +31,7 @@ router.put(
   },
 );
 
-app.use(router.routes()).use(router.allowedMethods());
+app.use(router.routes());
 
 // 生成 OpenAPI 文档
 const openapi = await generateDocument(

package.json

@@ -23,6 +23,8 @@
     "express-swagger",
     "koa-openapi",
     "koa-swagger",
+    "hono-openapi",
+    "hono-swagger",
     "zod-openapi",
     "zod-swagger"
   ],
@@ -41,6 +43,11 @@
       "types": "./dist/koa.d.ts",
       "import": "./dist/koa.js",
       "require": "./dist/koa.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.js",
+      "require": "./dist/hono.js"
     }
   },
   "main": "./dist/index.js",
@@ -73,6 +80,8 @@
     "postinstall": "lefthook install"
   },
   "dependencies": {
+    "@hono/node-server": "^1.15.0",
+    "@hono/zod-validator": "^0.7.0",
     "@hyperjump/json-schema": "^1.16.0",
     "@types/koa-static": "^4.0.4",
     "deepmerge": "^4.3.1",
@@ -113,6 +122,7 @@
     "@types/koa": "^2.0.0",
     "@types/koa__router": "^12.0.0",
     "express": "^5.0.0",
+    "hono": "^4.0.0",
     "koa": "^3.0.0"
   }
 }