honojs-middleware/packages/zod-validator
Jonathan Haines 5ea7fb5d09
chore: Migrate workspaces that use `jest` to `vitest` (#998)
* docs(contributing): add section on testing

Fixes #994

* test(clerk-auth): replace jest with vitest

* test(graphql-server): replace jest with vitest

* test(medley-router): replace jest with vitest

* test(oauth-providers): replace jest with vitest

* test(oidc-auth): replace jest with vitest

* test(sentry): replace jest with vitest

* test(trpc-server): replace jest with vitest

* test(typebox-validator): replace jest with vitest

* test(typia-validator): replace jest with vitest

* test(valibot-validator): replace jest with vitest

* chore: cleanup remaining references to jest

* chore: fix lint errors

* test(typia-validator): fix exclude directory

* test(oauth-providers): use vitest environment miniflare

* chore: update `yarn.lock`

* chore(zod-openapi): pin zod-validator to 0.4.2

* test(graphql-server): remove console filtering

---------

Co-authored-by: Yusuke Wada <yusuke@kamawada.com>
2025-03-04 22:00:28 +09:00
..
src chore: use the latest eslint and `@hono/eslint-config` (#904) 2024-12-25 18:08:43 +09:00
test chore: use the latest eslint and `@hono/eslint-config` (#904) 2024-12-25 18:08:43 +09:00
CHANGELOG.md Version Packages (#969) 2025-02-15 10:44:19 +09:00
README.md docs(zod-validator) - Update README.md to include an example with a custom validator wrapper for improved type inference (#922) 2025-01-05 18:04:45 +09:00
package.json chore: Migrate workspaces that use `jest` to `vitest` (#998) 2025-03-04 22:00:28 +09:00
tsconfig.cjs.json feat: introduce zod-validator (#16) 2023-01-02 00:03:44 +09:00
tsconfig.esm.json feat: introduce zod-validator (#16) 2023-01-02 00:03:44 +09:00
tsconfig.json feat: introduce zod-validator (#16) 2023-01-02 00:03:44 +09:00
vitest.config.ts fix(zod-validator): fix export for esm module (#431) 2024-03-26 09:03:48 +09:00

README.md

Zod validator middleware for Hono

The validator middleware using Zod for Hono applications. You can write a schema with Zod and validate the incoming values.

Usage

import { z } from 'zod'
import { zValidator } from '@hono/zod-validator'

const schema = z.object({
  name: z.string(),
  age: z.number(),
})

app.post('/author', zValidator('json', schema), (c) => {
  const data = c.req.valid('json')
  return c.json({
    success: true,
    message: `${data.name} is ${data.age}`,
  })
})

Hook:

app.post(
  '/post',
  zValidator('json', schema, (result, c) => {
    if (!result.success) {
      return c.text('Invalid!', 400)
    }
  })
  //...
)

Throw Error:

throw a zod validate error instead of directly returning an error response.

// file: validator-wrapper.ts
import { ZodSchema } from "zod";
import type { ValidationTargets } from "hono";
import { zValidator as zv } from "@hono/zod-validator";

export const zValidator = <
  T extends ZodSchema,
  Target extends keyof ValidationTargets
>(
  target: Target,
  schema: T
) =>
  zv(target, schema, (result, c) => {
    if (!result.success) {
      throw new HTTPException(400, { cause: result.error });
    }
  });

// usage
import { zValidator } from './validator-wrapper'
app.post(
  '/post',
  zValidator('json', schema)
  //...
)

Author

Yusuke Wada https://github.com/yusukebe

License

MIT