npm - @kood/claude-code - Versions diffs - 0.5.3 → 0.5.5 - Mend

@kood/claude-code 0.5.3 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (125) hide show

package/templates/nextjs/docs/guides/routes.md CHANGED Viewed

@@ -1,13 +1,13 @@
 # Routes
-> Next.js App Router routing patterns
+> Next.js App Router 라우팅 패턴
 ---
-## Basic Routing
+## 기본 라우팅
-| File | Route |
-|------|-------|
+| 파일 | 라우트 |
+|------|--------|
 | `app/page.tsx` | `/` |
 | `app/about/page.tsx` | `/about` |
 | `app/blog/page.tsx` | `/blog` |
@@ -15,9 +15,9 @@
 ---
-## Dynamic Routes
+## 동적 라우트
-### Single Parameter
+### 단일 파라미터
 ```typescript
 // app/posts/[id]/page.tsx
@@ -33,7 +33,7 @@ export default async function PostPage({ params }: PageProps) {
   return <article>{post.title}</article>
 }
-// Static generation
+// 정적 생성
 export async function generateStaticParams() {
   const posts = await prisma.post.findMany({ select: { id: true } })
   return posts.map(post => ({ id: post.id }))
@@ -57,9 +57,9 @@ export default function DocsPage({ params }: PageProps) {
 ---
-## Layouts
+## 레이아웃
-### Root Layout (required)
+### Root Layout (필수)
 ```typescript
 // app/layout.tsx
@@ -67,7 +67,7 @@ import { Providers } from "./providers"
 export default function RootLayout({ children }: { children: React.ReactNode }) {
   return (
-    <html lang="en">
+    <html lang="ko">
       <body>
         <Providers>{children}</Providers>
       </body>
@@ -76,7 +76,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 }
 ```
-### Nested Layout
+### 중첩 Layout
 ```typescript
 // app/dashboard/layout.tsx
@@ -85,7 +85,7 @@ import { headers } from "next/headers"
 import { redirect } from "next/navigation"
 export default async function DashboardLayout({ children }: { children: React.ReactNode }) {
-  // Auth check
+  // 인증 체크
   const session = await auth.api.getSession({ headers: headers() })
   if (!session?.user) redirect("/login")
@@ -115,7 +115,7 @@ app/
         └── page.tsx    # /products
 ```
-**Purpose:** Apply different layouts without affecting URLs
+**용도:** URL에 영향 없이 다른 레이아웃 적용
 ---
@@ -139,8 +139,8 @@ export default function Loading() {
 export default function Error({ error, reset }: { error: Error; reset: () => void }) {
   return (
     <div>
-      <h2>Error: {error.message}</h2>
-      <button onClick={reset}>Try again</button>
+      <h2>오류 발생: {error.message}</h2>
+      <button onClick={reset}>다시 시도</button>
     </div>
   )
 }
@@ -151,7 +151,7 @@ export default function Error({ error, reset }: { error: Error; reset: () => voi
 ```typescript
 // app/posts/[id]/not-found.tsx
 export default function NotFound() {
-  return <div>Post not found</div>
+  return <div>게시글을 찾을 수 없습니다</div>
 }
 ```
@@ -159,7 +159,7 @@ export default function NotFound() {
 ## Metadata
-### Static
+### 정적
 ```typescript
 // app/about/page.tsx
@@ -175,7 +175,7 @@ export default function AboutPage() {
 }
 ```
-### Dynamic
+### 동적
 ```typescript
 // app/posts/[id]/page.tsx
@@ -204,7 +204,7 @@ export async function generateMetadata({ params }: { params: { id: string } }):
 ---
-## Navigation
+## 네비게이션
 ### Link
@@ -242,9 +242,9 @@ export function LoginButton() {
 ---
-## Auth Protection
+## 인증 보호
-### Check in Layout
+### Layout에서 체크
 ```typescript
 // app/dashboard/layout.tsx
@@ -263,7 +263,7 @@ export default async function DashboardLayout({ children }: { children: React.Re
 }
 ```
-### Check in Middleware
+### Middleware에서 체크
 ```typescript
 // middleware.ts
@@ -288,25 +288,25 @@ export const config = {
 ---
-## Best Practices
+## 베스트 프랙티스
 ### ✅ DO
 ```typescript
-// 1. Direct data fetching in Server Components
+// 1. Server Component에서 직접 데이터 페칭
 export default async function PostsPage() {
   const posts = await prisma.post.findMany()
   return <PostsList posts={posts} />
 }
-// 2. Auth check in layout
+// 2. 레이아웃에서 인증 체크
 export default async function DashboardLayout({ children }) {
   const session = await auth.api.getSession({ headers: headers() })
   if (!session?.user) redirect("/login")
   return <div>{children}</div>
 }
-// 3. Static generation with generateStaticParams
+// 3. generateStaticParams로 정적 생성
 export async function generateStaticParams() {
   const posts = await prisma.post.findMany({ select: { id: true } })
   return posts.map(post => ({ id: post.id }))
@@ -316,26 +316,26 @@ export async function generateStaticParams() {
 ### ❌ DON'T
 ```typescript
-// 1. async/await in Client Components
+// 1. Client Component에서 async/await
 "use client"
 export default async function PostsPage() { // ❌
   const posts = await prisma.post.findMany()
   return <PostsList posts={posts} />
 }
-// 2. Repeated auth checks per page
+// 2. 페이지마다 인증 체크 반복
 export default async function Page1() {
-  const session = await auth.api.getSession({ headers: headers() }) // ❌ Duplicate
+  const session = await auth.api.getSession({ headers: headers() }) // ❌ 중복
   if (!session) redirect("/login")
 }
-// 3. Hardcoded paths
-<Link href="/posts/123">Post</Link> // ❌ Hardcoded
+// 3. 하드코딩된 경로
+<Link href="/posts/123">Post</Link> // ❌ 하드코딩
 ```
 ---
-## References
+## 참조
 - [App Router](../library/nextjs/app-router.md)
 - [Server Actions](server-actions.md)

package/templates/nextjs/docs/library/better-auth/index.md CHANGED Viewed

@@ -15,7 +15,7 @@ npm install better-auth
 ## Minimal Setup
 ```typescript
-// src/lib/auth.ts - Server
+// src/lib/auth.ts - 서버
 import { betterAuth } from "better-auth"
 import { prismaAdapter } from "better-auth/adapters/prisma"
 import { prisma } from "@/database/prisma"
@@ -25,7 +25,7 @@ export const auth = betterAuth({
   emailAndPassword: { enabled: true },
 })
-// src/lib/auth-client.ts - Client
+// src/lib/auth-client.ts - 클라이언트
 import { createAuthClient } from "better-auth/react"
 export const authClient = createAuthClient({
@@ -55,17 +55,17 @@ export const POST = (request: Request) => auth.handler(request)
 |---------|--------|----------|
 | Prisma | `better-auth/adapters/prisma` | `postgresql`, `mysql`, `sqlite` |
 | Drizzle | `better-auth/adapters/drizzle` | `pg`, `mysql2`, `better-sqlite3` |
-| Kysely | `better-auth/adapters/kysely` | dialect-based |
+| Kysely | `better-auth/adapters/kysely` | dialect 기반 |
 ## Auth Config
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `database` | `Adapter` | required | Database adapter |
-| `baseURL` | `string` | `http://localhost:3000` | App URL |
-| `basePath` | `string` | `/api/auth` | Auth path |
-| `secret` | `string` | environment variable | JWT secret |
-| `trustedOrigins` | `string[]` | `[]` | CORS allowed origins |
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `database` | `Adapter` | 필수 | DB 어댑터 |
+| `baseURL` | `string` | `http://localhost:3000` | 앱 URL |
+| `basePath` | `string` | `/api/auth` | Auth 경로 |
+| `secret` | `string` | 환경변수 | JWT 시크릿 |
+| `trustedOrigins` | `string[]` | `[]` | CORS 허용 오리진 |
 ## Social Providers
@@ -111,22 +111,22 @@ export const auth = betterAuth({
 ## Session Config
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `expiresIn` | `number` | `604800` (7 days) | Session expiration time (seconds) |
-| `updateAge` | `number` | `86400` (1 day) | Session update interval (seconds) |
-| `cookieCache.enabled` | `boolean` | `true` | Enable cookie cache |
-| `cookieCache.maxAge` | `number` | `300` (5 min) | Cache validity (seconds) |
-| `cookieCache.strategy` | `'compact' \| 'jwt' \| 'jwe'` | `'compact'` | Cache strategy |
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `expiresIn` | `number` | `604800` (7일) | 세션 만료 시간 (초) |
+| `updateAge` | `number` | `86400` (1일) | 세션 갱신 주기 (초) |
+| `cookieCache.enabled` | `boolean` | `true` | 쿠키 캐시 활성화 |
+| `cookieCache.maxAge` | `number` | `300` (5분) | 캐시 유효 시간 (초) |
+| `cookieCache.strategy` | `'compact' \| 'jwt' \| 'jwe'` | `'compact'` | 캐시 전략 |
 ```typescript
 export const auth = betterAuth({
   session: {
-    expiresIn: 604800, // 7 days
-    updateAge: 86400, // Update every 1 day
+    expiresIn: 604800, // 7일
+    updateAge: 86400, // 1일마다 갱신
     cookieCache: {
       enabled: true,
-      maxAge: 300, // 5 minutes
+      maxAge: 300, // 5분
       strategy: "compact",
     },
   },
@@ -136,11 +136,11 @@ export const auth = betterAuth({
 ## Session Methods
 ```typescript
-// ✅ Client
+// ✅ 클라이언트
 const session = await authClient.getSession()
 const session = await authClient.getSession({ query: { disableCookieCache: true } })
-// ✅ Server (Server Component)
+// ✅ 서버 (Server Component)
 import { auth } from "@/lib/auth"
 import { headers } from "next/headers"
@@ -151,7 +151,7 @@ export default async function Page() {
   return <div>Welcome {session.user.name}</div>
 }
-// ✅ Server (Server Action)
+// ✅ 서버 (Server Action)
 "use server"
 import { auth } from "@/lib/auth"
@@ -162,10 +162,10 @@ export async function getSession() {
   return session
 }
-// ✅ Update session
+// ✅ 세션 업데이트
 await authClient.updateUser({ name: "New Name" })
-// ✅ Logout
+// ✅ 로그아웃
 await authClient.signOut()
 ```
@@ -207,30 +207,30 @@ export const auth = betterAuth({
 ## Email/Password
 ```typescript
-// ✅ Sign up
+// ✅ 회원가입
 await authClient.signUp.email({
   email: "user@example.com",
   password: "password123",
   name: "User Name",
 })
-// ✅ Sign in
+// ✅ 로그인
 await authClient.signIn.email({
   email: "user@example.com",
   password: "password123",
 })
-// ✅ Request password reset
+// ✅ 비밀번호 재설정 요청
 await authClient.forgetPassword({ email: "user@example.com" })
-// ✅ Reset password
+// ✅ 비밀번호 재설정
 await authClient.resetPassword({ token, password: "newpassword" })
 ```
 ## Social Login
 ```typescript
-// ✅ Social sign in
+// ✅ 소셜 로그인
 await authClient.signIn.social({ provider: "google", callbackURL: "/dashboard" })
 await authClient.signIn.social({ provider: "github", callbackURL: "/dashboard" })
@@ -257,8 +257,8 @@ export const auth = betterAuth({
             html: `Your code: ${otp}`,
           })
         },
-        period: 300, // 5 minutes
-        length: 6, // 6 digits
+        period: 300, // 5분
+        length: 6, // 6자리
       },
       backupCodeLength: 10,
       backupCodeCount: 10,
@@ -284,26 +284,26 @@ export const authClient = createAuthClient({
 ### 2FA Usage
 ```typescript
-// ✅ Enable TOTP
+// ✅ TOTP 활성화
 const { data } = await authClient.twoFactor.enable({ password: "current-password" })
 // data: { totpURI: 'otpauth://...', backupCodes: ['ABCD-1234', ...] }
-// ✅ Verify TOTP
+// ✅ TOTP 검증
 await authClient.twoFactor.verifyTotp({ code: "123456" })
-// ✅ Send OTP
+// ✅ OTP 전송
 await authClient.twoFactor.sendOtp()
-// ✅ Verify OTP
+// ✅ OTP 검증
 await authClient.twoFactor.verifyOtp({ code: "123456" })
-// ✅ Use backup code
+// ✅ 백업 코드 사용
 await authClient.twoFactor.useBackupCode({ code: "ABCD-1234" })
-// ✅ Regenerate backup codes
+// ✅ 백업 코드 재생성
 const { data } = await authClient.twoFactor.regenerateBackupCodes({ password: "current-password" })
-// ✅ Disable 2FA
+// ✅ 2FA 비활성화
 await authClient.twoFactor.disable({ password: "current-password" })
 ```
@@ -315,35 +315,35 @@ await authClient.twoFactor.disable({ password: "current-password" })
 ## Plugin System
-| Plugin | Import | Feature |
-|--------|--------|---------|
-| `multiSession` | `better-auth/plugins` | Multi-session management |
-| `customSession` | `better-auth/plugins` | Extend session fields |
-| `twoFactor` | `better-auth/plugins` | Two-factor authentication |
-| `captcha` | `better-auth/plugins` | CAPTCHA validation |
+| Plugin | Import | 기능 |
+|--------|--------|------|
+| `multiSession` | `better-auth/plugins` | 다중 세션 관리 |
+| `customSession` | `better-auth/plugins` | 세션 필드 확장 |
+| `twoFactor` | `better-auth/plugins` | 2단계 인증 |
+| `captcha` | `better-auth/plugins` | CAPTCHA 검증 |
 ## Multi-Session
 ```typescript
-// ✅ Server
+// ✅ 서버
 import { multiSession } from "better-auth/plugins"
 export const auth = betterAuth({
   plugins: [
     multiSession({
-      maximumSessions: 5, // Maximum sessions
+      maximumSessions: 5, // 최대 세션 수
     }),
   ],
 })
-// ✅ Client
+// ✅ 클라이언트
 import { multiSessionClient } from "better-auth/client/plugins"
 export const authClient = createAuthClient({
   plugins: [multiSessionClient()],
 })
-// Usage
+// 사용
 const sessions = await authClient.multiSession.listSessions()
 await authClient.multiSession.revokeSession({ sessionId: "session-id" })
 await authClient.multiSession.revokeOtherSessions()
@@ -352,7 +352,7 @@ await authClient.multiSession.revokeOtherSessions()
 ## CAPTCHA
 ```typescript
-// ✅ Server
+// ✅ 서버
 import { captcha } from "better-auth/plugins"
 export const auth = betterAuth({
@@ -366,7 +366,7 @@ export const auth = betterAuth({
   ],
 })
-// ✅ Client
+// ✅ 클라이언트
 import { captchaClient } from "better-auth/client/plugins"
 export const authClient = createAuthClient({
@@ -387,8 +387,8 @@ export const authClient = createAuthClient({
 ## SIWE (Ethereum)
 ```typescript
-// Server: siwe({ domain, uri })
-// Client:
+// 서버: siwe({ domain, uri })
+// 클라이언트:
 const { data } = await authClient.siwe.getNonce()
 const message = await authClient.siwe.prepareMessage({ address: "0x...", nonce: data.nonce })
 const signature = await signer.signMessage(message)
@@ -398,7 +398,7 @@ await authClient.siwe.signIn({ message, signature })
 ## Stateless Mode
 ```typescript
-// ✅ Social login only without DB
+// ✅ DB 없이 소셜 로그인만
 export const auth = betterAuth({
   socialProviders: {
     google: {
@@ -441,8 +441,8 @@ export const auth = betterAuth({
 ## Next.js Integration
-| Pattern | Usage |
-|---------|-------|
+| 패턴 | 용도 |
+|------|------|
 | Route Handler | `app/api/auth/[...all]/route.ts` |
 | Server Component | `auth.api.getSession({ headers })` |
 | Server Action | `auth.api.getSession({ headers })` |
@@ -518,24 +518,24 @@ export const config = {
 ## Common Patterns
-| Task | Pattern |
-|------|---------|
-| Sign in | `authClient.signIn.email({ email, password })` |
-| Sign up | `authClient.signUp.email({ email, password, name })` |
-| Sign out | `authClient.signOut()` |
-| Get session | `authClient.getSession()` (client) |
-| Get session | `auth.api.getSession({ headers })` (server) |
-| Update user | `authClient.updateUser({ name })` |
-| Reset password | `authClient.forgetPassword({ email })` → `authClient.resetPassword({ token, password })` |
+| 작업 | 패턴 |
+|------|------|
+| 로그인 | `authClient.signIn.email({ email, password })` |
+| 회원가입 | `authClient.signUp.email({ email, password, name })` |
+| 로그아웃 | `authClient.signOut()` |
+| 세션 조회 | `authClient.getSession()` (클라이언트) |
+| 세션 조회 | `auth.api.getSession({ headers })` (서버) |
+| 사용자 업데이트 | `authClient.updateUser({ name })` |
+| 비밀번호 재설정 | `authClient.forgetPassword({ email })` → `authClient.resetPassword({ token, password })` |
 ## Do's & Don'ts
 | ✅ Do | ❌ Don't |
 |-------|----------|
-| Use `auth.api.getSession()` on server | Manipulate session directly on client |
-| Use `authClient` on client | Hardcode secrets |
-| Manage secrets with environment variables | Store session tokens in localStorage |
-| HTTPS required in production | Deploy with HTTP in production |
-| Configure `baseURL` per environment | Hardcode absolute paths |
+| `auth.api.getSession()` 서버에서 사용 | 클라이언트에서 직접 세션 조작 |
+| `authClient` 클라이언트에서 사용 | 하드코딩된 시크릿 |
+| 환경변수로 시크릿 관리 | 세션 토큰 로컬스토리지 저장 |
+| HTTPS 프로덕션 필수 | HTTP 프로덕션 배포 |
+| `baseURL` 환경별 설정 | 절대 경로 하드코딩 |
 </patterns>