Todo API 项目

pnpm add hono zod @hono/zod-validator
pnpm add -D tsx typescript

pnpm add @hono/node-server

src/
├─ index.ts
├─ app.ts
├─ routes/
│  └─ todos.ts
└─ middleware/
   └─ request-id.ts

// src/middleware/request-id.ts
import type { MiddlewareHandler } from 'hono'

export const requestId: MiddlewareHandler = async (c, next) => {
  const id = c.req.header('X-Request-Id') ?? crypto.randomUUID()
  c.header('X-Request-Id', id)
  await next()
}

// src/routes/todos.ts
import { Hono } from 'hono'
import { z } from 'zod'
import { zValidator } from '@hono/zod-validator'

type Todo = {
  id: string
  title: string
  done: boolean
}

const todos = new Map<string, Todo>()

const createTodoSchema = z.object({
  title: z.string().min(1).max(100),
})

const updateTodoSchema = z.object({
  title: z.string().min(1).max(100).optional(),
  done: z.boolean().optional(),
})

export const todoRoutes = new Hono()
  .get('/', (c) => {
    return c.json({ data: Array.from(todos.values()) })
  })
  .post('/', zValidator('json', createTodoSchema), (c) => {
    const input = c.req.valid('json')
    const todo: Todo = {
      id: crypto.randomUUID(),
      title: input.title,
      done: false,
    }

    todos.set(todo.id, todo)

    return c.json({ data: todo }, 201)
  })
  .patch('/:id', zValidator('json', updateTodoSchema), (c) => {
    const id = c.req.param('id')
    const todo = todos.get(id)

    if (!todo) {
      return c.json({ message: 'Todo not found' }, 404)
    }

    const input = c.req.valid('json')
    const nextTodo = { ...todo, ...input }
    todos.set(id, nextTodo)

    return c.json({ data: nextTodo })
  })
  .delete('/:id', (c) => {
    const id = c.req.param('id')

    if (!todos.delete(id)) {
      return c.json({ message: 'Todo not found' }, 404)
    }

    return c.body(null, 204)
  })

// src/app.ts
import { Hono } from 'hono'
import { logger } from 'hono/logger'
import { requestId } from './middleware/request-id'
import { todoRoutes } from './routes/todos'

export const app = new Hono()

app.use(logger())
app.use(requestId)

app.get('/health', (c) => c.json({ ok: true }))
app.route('/todos', todoRoutes)

app.notFound((c) => c.json({ message: 'Not Found' }, 404))

app.onError((err, c) => {
  console.error(err)
  return c.json({ message: 'Internal Server Error' }, 500)
})

// src/index.ts
import { serve } from '@hono/node-server'
import { app } from './app'

serve({
  fetch: app.fetch,
  port: Number(process.env.PORT ?? '3000'),
})

curl http://localhost:3000/health

curl -X POST http://localhost:3000/todos \
  -H "Content-Type: application/json" \
  -d '{"title":"学习 Hono"}'