Mock Hono route handlers with Zod schema-valid responses for testing (no HTTP roundtrip needed)

[gonll]

Hey everyone! I wanted to share a small testing utility I built for Hono projects
that use Zod for request/response validation.

The problem

Testing Hono routes usually means spinning up a real server or hand-writing
response fixtures that silently drift from your actual schemas over time.

If you're already using Zod to describe your response shapes, your schemas are
the source of truth, so why not generate test responses directly from them?

What I built

zodmint/hono gives you two utilities:

mockHonoHandler drops a schema-valid mock handler into any route:

import { Hono } from "hono";
import { mockHonoHandler } from "zodmint/hono";

const app = new Hono();
app.get("/users/:id", mockHonoHandler(UserSchema));
app.post("/users",    mockHonoHandler(UserSchema, { status: 201, seed: 42 }));

const res  = await app.request("/users/1");
const user = await res.json();
// user passes UserSchema.safeParse(user).success === true

mockHonoApp builds a complete stub API in one call:

import { mockHonoApp } from "zodmint/hono";

const mockApi = mockHonoApp([
  { route: "GET /users/:id", schema: UserSchema },
  { route: "POST /users",    schema: UserSchema, status: 201 },
  { route: "GET /posts",     schema: z.array(PostSchema), seed: 2 },
]);

const res   = await mockApi.request("/posts");
const posts = await res.json();
// posts is a valid Post[]

Every generated value is guaranteed to pass schema.safeParse(v).success === true.
Uses app.request() directly so no HTTP roundtrip and no server needed.

Install

npm install zodmint hono

import { mockHonoHandler, mockHonoApp } from "zodmint/hono";

Full docs: github.com/gonll/zodmint

Would love feedback, especially if you have patterns around @hono/zod-validator
that this could integrate with better.