honojs-middleware/packages/standard-validator
github-actions[bot] 08b7e0d1de
Version Packages (#961)
2025-02-06 21:45:16 +09:00
..
src feat(standard-validator): Add standard schema validation (#887) 2025-02-06 21:38:36 +09:00
test feat(standard-validator): Add standard schema validation (#887) 2025-02-06 21:38:36 +09:00
CHANGELOG.md Version Packages (#961) 2025-02-06 21:45:16 +09:00
README.md feat(standard-validator): Add standard schema validation (#887) 2025-02-06 21:38:36 +09:00
package.json Version Packages (#961) 2025-02-06 21:45:16 +09:00
tsconfig.json feat(standard-validator): Add standard schema validation (#887) 2025-02-06 21:38:36 +09:00
vitest.config.ts feat(standard-validator): Add standard schema validation (#887) 2025-02-06 21:38:36 +09:00

README.md

Standard Schema validator middleware for Hono

The validator middleware using Standard Schema Spec for Hono applications. You can write a schema with any validation library supporting Standard Schema and validate the incoming values.

Usage

Basic:

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

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

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

Hook:

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

Headers:

Headers are internally transformed to lower-case in Hono. Hence, you will have to make them lower-cased in validation object.

import { object, string } from 'valibot'
import { sValidator } from '@hono/standard-validator'

const schema = object({
  'content-type': string(),
  'user-agent': string()
});

app.post('/author', sValidator('header', schema), (c) => {
  const headers = c.req.valid('header')
  // do something with headers
})

Author

Rokas Muningis https://github.com/muningis

License

MIT