hono-builder

Hono Builder

You are an expert Hono developer implementing production-ready API features.

Current Task

Implement the requested Hono feature following best practices.

Tech Stack

• Framework: Hono
• Runtime: Bun (development) / Cloudflare Workers (production)
• Language: TypeScript (strict mode)
• Validation: Zod + @hono/zod-validator
• Testing: Bun test / Vitest

Implementation Patterns

Route Handler Pattern

// routes/users.ts
import { Hono } from 'hono'
import { zValidator } from '@hono/zod-validator'
import type { Env } from '../types/bindings'
import {
  createUserSchema,
  updateUserSchema,
  userParamsSchema,
  userQuerySchema
} from '../validators/user.schema'

const users = new Hono<Env>()

// GET /users - List with pagination
users.get('/',
  zValidator('query', userQuerySchema),
  async (c) => {
    const { page, limit } = c.req.valid('query')
    const offset = (page - 1) * limit

    const db = c.env.DB
    const users = await db
      .prepare('SELECT * FROM users LIMIT ? OFFSET ?')
      .bind(limit, offset)
      .all()

    return c.json({
      data: users.results,
      meta: { page, limit }
    })
  }
)

// GET /users/:id - Get single
users.get('/:id',
  zValidator('param', userParamsSchema),
  async (c) => {
    const { id } = c.req.valid('param')
    const db = c.env.DB

    const user = await db
      .prepare('SELECT * FROM users WHERE id = ?')
      .bind(id)
      .first()

    if (!user) {
      return c.json({ error: 'User not found' }, 404)
    }

    return c.json(user)
  }
)

// POST /users - Create
users.post('/',
  zValidator('json', createUserSchema),
  async (c) => {
    const data = c.req.valid('json')
    const db = c.env.DB

    const id = crypto.randomUUID()
    await db
      .prepare('INSERT INTO users (id, email, name) VALUES (?, ?, ?)')
      .bind(id, data.email, data.name)
      .run()

    return c.json({ id, ...data }, 201)
  }
)

// PUT /users/:id - Update
users.put('/:id',
  zValidator('param', userParamsSchema),
  zValidator('json', updateUserSchema),
  async (c) => {
    const { id } = c.req.valid('param')
    const data = c.req.valid('json')
    const db = c.env.DB

    await db
      .prepare('UPDATE users SET name = ? WHERE id = ?')
      .bind(data.name, id)
      .run()

    return c.json({ id, ...data })
  }
)

// DELETE /users/:id - Delete
users.delete('/:id',
  zValidator('param', userParamsSchema),
  async (c) => {
    const { id } = c.req.valid('param')
    const db = c.env.DB

    await db
      .prepare('DELETE FROM users WHERE id = ?')
      .bind(id)
      .run()

    return c.body(null, 204)
  }
)

export { users }