@kood/claude-code 0.1.6 → 0.1.9

package/templates/hono/docs/library/hono/error-handling.md

@@ -6,16 +6,10 @@
 
 ## HTTPException
 
-### 기본 사용
-
 ```typescript
-import { Hono } from 'hono'
 import { HTTPException } from 'hono/http-exception'
 
-const app = new Hono()
-
 app.get('/users/:id', async (c) => {
-  const id = c.req.param('id')
   const user = await prisma.user.findUnique({ where: { id } })
 
   if (!user) {
@@ -26,49 +20,22 @@ app.get('/users/:id', async (c) => {
 })
 ```
 
-### HTTPException 옵션
+### 일반적인 상태 코드
 
 ```typescript
-throw new HTTPException(400, {
-  message: 'Invalid request',        // 에러 메시지
-  cause: originalError,              // 원인 에러
-})
-```
-
-### 일반적인 HTTP 상태 코드
-
-```typescript
-// 400 Bad Request - 잘못된 요청
-throw new HTTPException(400, { message: 'Invalid input' })
-
-// 401 Unauthorized - 인증 필요
-throw new HTTPException(401, { message: 'Authentication required' })
-
-// 403 Forbidden - 권한 없음
-throw new HTTPException(403, { message: 'Access denied' })
-
-// 404 Not Found - 리소스 없음
-throw new HTTPException(404, { message: 'Resource not found' })
-
-// 409 Conflict - 충돌
-throw new HTTPException(409, { message: 'Resource already exists' })
-
-// 422 Unprocessable Entity - 검증 실패
-throw new HTTPException(422, { message: 'Validation failed' })
-
-// 429 Too Many Requests - 요청 제한 초과
-throw new HTTPException(429, { message: 'Rate limit exceeded' })
-
-// 500 Internal Server Error - 서버 에러
-throw new HTTPException(500, { message: 'Internal server error' })
+throw new HTTPException(400, { message: 'Invalid input' })      // Bad Request
+throw new HTTPException(401, { message: 'Unauthorized' })       // 인증 필요
+throw new HTTPException(403, { message: 'Access denied' })      // 권한 없음
+throw new HTTPException(404, { message: 'Not found' })          // 리소스 없음
+throw new HTTPException(409, { message: 'Already exists' })     // 충돌
+throw new HTTPException(422, { message: 'Validation failed' })  // 검증 실패
+throw new HTTPException(429, { message: 'Rate limit exceeded' })// 요청 제한
 ```
 
 ---
 
 ## 글로벌 에러 핸들러
 
-### onError
-
 ```typescript
 import { Hono } from 'hono'
 import { HTTPException } from 'hono/http-exception'
@@ -76,144 +43,45 @@ import { HTTPException } from 'hono/http-exception'
 const app = new Hono()
 
 app.onError((err, c) => {
-  console.error(`${err}`)
-
-  // HTTPException 처리
-  if (err instanceof HTTPException) {
-    return c.json(
-      {
-        error: err.message,
-        status: err.status,
-      },
-      err.status
-    )
-  }
-
-  // 기타 에러
-  return c.json(
-    {
-      error: 'Internal Server Error',
-      message: err.message,
-    },
-    500
-  )
-})
-```
-
-### 상세 에러 응답
-
-```typescript
-app.onError((err, c) => {
-  const requestId = c.get('requestId')
+  console.error(err)
 
-  // HTTPException
   if (err instanceof HTTPException) {
-    return c.json(
-      {
-        success: false,
-        error: {
-          code: err.status,
-          message: err.message,
-          requestId,
-        },
-      },
-      err.status
-    )
+    return c.json({ error: err.message, status: err.status }, err.status)
   }
 
-  // Zod 검증 에러 (이미 zValidator에서 처리된 경우)
-  if (err.name === 'ZodError') {
-    return c.json(
-      {
-        success: false,
-        error: {
-          code: 400,
-          message: 'Validation failed',
-          details: err.flatten(),
-          requestId,
-        },
-      },
-      400
-    )
-  }
-
-  // 개발 환경에서만 스택 트레이스 포함
-  const isDev = c.env.NODE_ENV === 'development'
-
-  return c.json(
-    {
-      success: false,
-      error: {
-        code: 500,
-        message: 'Internal Server Error',
-        ...(isDev && { stack: err.stack }),
-        requestId,
-      },
-    },
-    500
-  )
+  return c.json({ error: 'Internal Server Error' }, 500)
 })
-```
 
----
-
-## 404 핸들러
-
-### notFound
-
-```typescript
 app.notFound((c) => {
-  return c.json(
-    {
-      error: 'Not Found',
-      path: c.req.path,
-      method: c.req.method,
-    },
-    404
-  )
+  return c.json({ error: 'Not Found', path: c.req.path }, 404)
 })
 ```
 
 ---
 
-## 라우트별 에러 핸들러
+## 상세 에러 응답
 
 ```typescript
-const api = new Hono()
-
-// API 전용 에러 핸들러 (우선순위 높음)
-api.onError((err, c) => {
-  console.log('API-specific error handler')
+app.onError((err, c) => {
+  const requestId = c.get('requestId')
+  const isDev = c.env.NODE_ENV === 'development'
 
   if (err instanceof HTTPException) {
-    return c.json({ apiError: err.message }, err.status)
+    return c.json({
+      success: false,
+      error: { status: err.status, message: err.message, requestId },
+    }, err.status)
   }
 
-  return c.json({ apiError: err.message }, 500)
-})
-
-api.get('/error', () => {
-  throw new Error('API error')
-})
-
-app.route('/api', api)
-```
-
----
-
-## 미들웨어에서 에러 접근
-
-### c.error 사용
-
-```typescript
-app.use(async (c, next) => {
-  await next()
-
-  // 핸들러에서 발생한 에러 접근
-  if (c.error) {
-    // 로깅, 모니터링 등
-    console.error('Error occurred:', c.error)
-  }
+  return c.json({
+    success: false,
+    error: {
+      status: 500,
+      message: 'Internal Server Error',
+      requestId,
+      ...(isDev && { stack: err.stack }),
+    },
+  }, 500)
 })
 ```
 
@@ -221,7 +89,7 @@ app.use(async (c, next) => {
 
 ## 커스텀 에러 클래스
 
-### errors.ts
+### lib/errors.ts
 
 ```typescript
 import { HTTPException } from 'hono/http-exception'
@@ -238,18 +106,6 @@ export class UnauthorizedError extends HTTPException {
   }
 }
 
-export class ForbiddenError extends HTTPException {
-  constructor(message = 'Access denied') {
-    super(403, { message })
-  }
-}
-
-export class ValidationError extends HTTPException {
-  constructor(message: string, public details?: unknown) {
-    super(422, { message })
-  }
-}
-
 export class ConflictError extends HTTPException {
   constructor(resource: string) {
     super(409, { message: `${resource} already exists` })
@@ -264,137 +120,20 @@ import { NotFoundError, ConflictError } from '@/lib/errors'
 
 app.get('/users/:id', async (c) => {
   const user = await prisma.user.findUnique({ where: { id } })
-
-  if (!user) {
-    throw new NotFoundError('User')
-  }
-
+  if (!user) throw new NotFoundError('User')
   return c.json({ user })
 })
 
 app.post('/users', async (c) => {
-  const data = c.req.valid('json')
-  const existing = await prisma.user.findUnique({
-    where: { email: data.email },
-  })
-
-  if (existing) {
-    throw new ConflictError('User with this email')
-  }
-
-  const user = await prisma.user.create({ data })
-  return c.json({ user }, 201)
-})
-```
-
----
-
-## 스트리밍 에러 처리
-
-```typescript
-import { stream } from 'hono/streaming'
-
-app.get('/stream', (c) => {
-  return stream(
-    c,
-    async (stream) => {
-      stream.onAbort(() => {
-        console.log('Stream aborted')
-      })
-
-      await stream.write(new Uint8Array([0x48, 0x65, 0x6c, 0x6c, 0x6f]))
-    },
-    // 에러 핸들러 (선택적)
-    (err, stream) => {
-      stream.writeln('An error occurred!')
-      console.error(err)
-    }
-  )
+  const existing = await prisma.user.findUnique({ where: { email } })
+  if (existing) throw new ConflictError('User with this email')
+  // ...
 })
 ```
 
 ---
 
-## 완전한 에러 처리 설정
-
-```typescript
-import { Hono } from 'hono'
-import { HTTPException } from 'hono/http-exception'
-import { logger } from 'hono/logger'
-import { requestId } from 'hono/request-id'
-
-type Env = {
-  Bindings: {
-    NODE_ENV: string
-  }
-  Variables: {
-    requestId: string
-  }
-}
-
-const app = new Hono<Env>()
-
-// 미들웨어
-app.use(logger())
-app.use(requestId())
-
-// 글로벌 에러 핸들러
-app.onError((err, c) => {
-  const reqId = c.get('requestId')
-  const isDev = c.env.NODE_ENV === 'development'
-
-  console.error(`[${reqId}] Error:`, err)
-
-  if (err instanceof HTTPException) {
-    return c.json(
-      {
-        success: false,
-        error: {
-          status: err.status,
-          message: err.message,
-          requestId: reqId,
-        },
-      },
-      err.status
-    )
-  }
-
-  return c.json(
-    {
-      success: false,
-      error: {
-        status: 500,
-        message: 'Internal Server Error',
-        requestId: reqId,
-        ...(isDev && { stack: err.stack }),
-      },
-    },
-    500
-  )
-})
-
-// 404 핸들러
-app.notFound((c) => {
-  return c.json(
-    {
-      success: false,
-      error: {
-        status: 404,
-        message: 'Not Found',
-        path: c.req.path,
-      },
-    },
-    404
-  )
-})
-
-export default app
-```
-
----
-
 ## 관련 문서
 
 - [기본 사용법](./index.md)
 - [미들웨어](./middleware.md)
-- [Zod 검증](./validation.md)

package/templates/hono/docs/library/hono/index.md

@@ -1,73 +1,32 @@
 # Hono - Web Framework
 
-> Web Standards 기반 초경량, 초고속 서버 프레임워크
+> Web Standards 기반 초경량 서버 프레임워크
 
----
-
-## 개요
-
-Hono는 Cloudflare Workers, Deno, Bun, Node.js 등 모든 JavaScript 런타임에서 동작하는 서버 프레임워크입니다.
+@env-setup.md
+@middleware.md
+@validation.md
+@error-handling.md
+@rpc.md
 
 ---
 
 ## 설치
 
 ```bash
-# npm
 npm install hono
-
-# bun
-bun add hono
-
-# yarn
-yarn add hono
 ```
 
 ---
 
 ## 기본 사용법
 
-### App 생성
-
 ```typescript
 import { Hono } from 'hono'
 
 const app = new Hono()
 
-app.get('/', (c) => {
-  return c.text('Hello Hono!')
-})
-
-export default app
-```
-
-### HTTP 메서드
-
-```typescript
-const app = new Hono()
-
-app.get('/', (c) => c.text('GET /'))
+app.get('/', (c) => c.text('Hello Hono!'))
 app.post('/', (c) => c.text('POST /'))
-app.put('/', (c) => c.text('PUT /'))
-app.delete('/', (c) => c.text('DELETE /'))
-app.patch('/', (c) => c.text('PATCH /'))
-
-// 모든 메서드
-app.all('/hello', (c) => c.text('Any Method /hello'))
-
-// 여러 메서드
-app.on(['PUT', 'DELETE'], '/post', (c) => c.text('PUT or DELETE /post'))
-```
-
----
-
-## 라우팅
-
-### 기본 라우팅
-
-```typescript
-// 정적 경로
-app.get('/users', (c) => c.json({ users: [] }))
 
 // 동적 파라미터
 app.get('/users/:id', (c) => {
@@ -80,34 +39,22 @@ app.get('/posts/:postId/comments/:commentId', (c) => {
   const { postId, commentId } = c.req.param()
   return c.json({ postId, commentId })
 })
-```
 
-### 와일드카드
-
-```typescript
-// 와일드카드 매칭
-app.get('/wild/*/card', (c) => {
-  return c.text('GET /wild/*/card')
-})
-
-// 모든 하위 경로
-app.get('/api/*', (c) => {
-  return c.text('API catch-all')
-})
+export default app
 ```
 
-### 라우트 그룹화
+---
+
+## 라우트 그룹화
 
 ```typescript
 const app = new Hono()
 
-// 서브 라우트
 const users = new Hono()
 users.get('/', (c) => c.json({ users: [] }))
 users.get('/:id', (c) => c.json({ id: c.req.param('id') }))
 users.post('/', (c) => c.json({ created: true }, 201))
 
-// 마운트
 app.route('/users', users)
 ```
 
@@ -115,26 +62,16 @@ app.route('/users', users)
 
 ## Context (c)
 
-### Request 정보
+### Request
 
 ```typescript
 app.get('/info', (c) => {
-  // URL 정보
   const url = c.req.url
   const path = c.req.path
   const method = c.req.method
-
-  // 파라미터
   const id = c.req.param('id')
-  const params = c.req.param() // 모든 파라미터
-
-  // 쿼리 스트링
   const page = c.req.query('page')
-  const queries = c.req.query() // 모든 쿼리
-
-  // 헤더
   const auth = c.req.header('Authorization')
-
   return c.json({ url, path, method })
 })
 ```
@@ -142,86 +79,57 @@ app.get('/info', (c) => {
 ### Request Body
 
 ```typescript
-// JSON
 app.post('/json', async (c) => {
   const body = await c.req.json()
   return c.json(body)
 })
 
-// Form Data
 app.post('/form', async (c) => {
   const body = await c.req.parseBody()
   return c.json(body)
 })
-
-// Raw Text
-app.post('/text', async (c) => {
-  const text = await c.req.text()
-  return c.text(text)
-})
 ```
 
-### Response 메서드
+### Response
 
 ```typescript
-// Text
-app.get('/text', (c) => c.text('Hello'))
-
-// JSON
-app.get('/json', (c) => c.json({ message: 'Hello' }))
-
-// JSON with status
-app.post('/created', (c) => c.json({ id: 1 }, 201))
-
-// HTML
-app.get('/html', (c) => c.html('<h1>Hello</h1>'))
-
-// Redirect
-app.get('/old', (c) => c.redirect('/new'))
-
-// Not Found
-app.get('/404', (c) => c.notFound())
+c.text('Hello')                    // Text
+c.json({ message: 'Hello' })       // JSON
+c.json({ id: 1 }, 201)             // JSON + status
+c.html('<h1>Hello</h1>')           // HTML
+c.redirect('/new')                 // Redirect
+c.notFound()                       // 404
 ```
 
 ---
 
-## 환경 변수 (Bindings)
+## Bindings & Variables
 
 ```typescript
 type Bindings = {
   DATABASE_URL: string
   JWT_SECRET: string
-  MY_BUCKET: R2Bucket  // Cloudflare R2
 }
 
-const app = new Hono<{ Bindings: Bindings }>()
-
-app.get('/', (c) => {
-  const dbUrl = c.env.DATABASE_URL
-  const secret = c.env.JWT_SECRET
-  return c.json({ connected: true })
-})
-```
-
----
-
-## Variables (상태 공유)
-
-```typescript
 type Variables = {
   userId: string
   user: { id: string; name: string }
 }
 
-const app = new Hono<{ Variables: Variables }>()
+const app = new Hono<{ Bindings: Bindings; Variables: Variables }>()
+
+// 환경 변수 접근
+app.get('/', (c) => {
+  const dbUrl = c.env.DATABASE_URL
+  return c.json({ connected: true })
+})
 
-// 미들웨어에서 설정
+// Variables 설정/사용
 app.use(async (c, next) => {
   c.set('userId', '123')
   await next()
 })
 
-// 핸들러에서 사용
 app.get('/me', (c) => {
   const userId = c.get('userId')
   return c.json({ userId })
@@ -232,7 +140,7 @@ app.get('/me', (c) => {
 
 ## 관련 문서
 
-- [환경 변수 설정](./env-setup.md) - .env.development, .env.production 설정 ⭐
+- [환경 변수 설정](./env-setup.md)
 - [미들웨어](./middleware.md)
 - [Zod 검증](./validation.md)
 - [에러 처리](./error-handling.md)