@kood/claude-code 0.1.6 → 0.1.9

package/templates/tanstack-start/docs/library/better-auth/session.md

@@ -1,127 +1,47 @@
 # Better Auth - 세션 관리
 
-> **상위 문서**: [Better Auth](./index.md)
-
-## 세션 설정
-
-```typescript
-import { betterAuth } from 'better-auth'
-
-export const auth = betterAuth({
-  session: {
-    modelName: 'sessions',
-    fields: {
-      userId: 'user_id',
-    },
-    expiresIn: 604800, // 7일 (초 단위)
-    updateAge: 86400, // 1일마다 갱신
-    additionalFields: {
-      customField: {
-        type: 'string',
-      },
-    },
-  },
-})
-```
-
-## 쿠키 캐시
-
-세션 조회 성능 최적화를 위한 쿠키 캐시:
+## 설정
 
 ```typescript
 export const auth = betterAuth({
   session: {
+    expiresIn: 604800,   // 7일 (초)
+    updateAge: 86400,    // 1일마다 갱신
     cookieCache: {
       enabled: true,
-      maxAge: 5 * 60, // 5분
-      strategy: 'compact', // 'compact' | 'jwt' | 'jwe'
-      refreshCache: true,
+      maxAge: 5 * 60,    // 5분
+      strategy: 'compact',  // 'compact' | 'jwt' | 'jwe'
     },
   },
 })
 ```
 
-## 세션 가져오기
-
-### 클라이언트
+## 세션 조회
 
 ```typescript
-// 기본
+// 클라이언트
 const session = await authClient.getSession()
+const session = await authClient.getSession({ query: { disableCookieCache: true } })
 
-// 쿠키 캐시 우회 (DB에서 직접 가져오기)
-const session = await authClient.getSession({
-  query: {
-    disableCookieCache: true,
-  },
-})
-```
-
-### 서버
-
-```typescript
-await auth.api.getSession({
-  query: {
-    disableCookieCache: true,
-  },
-  headers: req.headers,
-})
+// 서버
+await auth.api.getSession({ headers: req.headers })
 ```
 
 ## Custom Session Plugin
 
-세션 스키마 확장 및 커스텀 로직 구현:
-
 ```typescript
-import { betterAuth } from 'better-auth'
 import { customSession } from 'better-auth/plugins'
 
 export const auth = betterAuth({
   plugins: [
     customSession({
-      // 세션 스키마 확장
       schema: {
-        session: {
-          fields: {
-            ipAddress: {
-              type: 'string',
-              required: false,
-            },
-            userAgent: {
-              type: 'string',
-              required: false,
-            },
-            metadata: {
-              type: 'json',
-              required: false,
-            },
-          },
-        },
+        session: { fields: { ipAddress: { type: 'string' }, metadata: { type: 'json' } } },
       },
-
-      // 세션 생성 시 커스터마이즈
       async onSessionCreate(session, context) {
-        return {
-          ...session,
-          ipAddress: context.request.headers.get('x-forwarded-for'),
-          userAgent: context.request.headers.get('user-agent'),
-          metadata: { loginMethod: 'email' },
-        }
-      },
-
-      // 세션 조회 시 커스터마이즈
-      async onSessionGet(session, context) {
-        return {
-          ...session,
-          activeDevices: await getActiveDevices(session.userId),
-        }
+        return { ...session, ipAddress: context.request.headers.get('x-forwarded-for') }
       },
     }),
   ],
 })
-
-// 타입 안전한 커스텀 세션 데이터 접근
-const session = await auth.api.getSession({ headers })
-console.log('IP Address:', session?.ipAddress)
-console.log('Metadata:', session?.metadata)
 ```

package/templates/tanstack-start/docs/library/better-auth/setup.md

@@ -1,123 +1,41 @@
 # Better Auth - 설치 및 설정
 
-> **상위 문서**: [Better Auth](./index.md)
-
 ## 설치
 
 ```bash
 yarn add better-auth
 ```
 
-## 서버 설정
-
-### 기본 설정
+## 서버
 
 ```typescript
-// lib/auth.ts
 import { betterAuth } from 'better-auth'
 import { prismaAdapter } from 'better-auth/adapters/prisma'
-import { prisma } from './prisma'
-
-export const auth = betterAuth({
-  database: prismaAdapter(prisma),
-
-  // 이메일/비밀번호 인증 활성화
-  emailAndPassword: {
-    enabled: true,
-    requireEmailVerification: false,
-  },
-})
-```
-
-### 소셜 로그인 설정
-
-```typescript
-import { betterAuth } from 'better-auth'
 
 export const auth = betterAuth({
   database: prismaAdapter(prisma),
+  emailAndPassword: { enabled: true },
   socialProviders: {
-    google: {
-      clientId: process.env.GOOGLE_CLIENT_ID as string,
-      clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,
-    },
-    github: {
-      clientId: process.env.GITHUB_CLIENT_ID as string,
-      clientSecret: process.env.GITHUB_CLIENT_SECRET as string,
-    },
-    spotify: {
-      clientId: process.env.SPOTIFY_CLIENT_ID as string,
-      clientSecret: process.env.SPOTIFY_CLIENT_SECRET as string,
-    },
+    google: { clientId: process.env.GOOGLE_CLIENT_ID, clientSecret: process.env.GOOGLE_CLIENT_SECRET },
+    github: { clientId: process.env.GITHUB_CLIENT_ID, clientSecret: process.env.GITHUB_CLIENT_SECRET },
   },
 })
 ```
 
-## 클라이언트 설정
-
-### 기본 클라이언트
-
-```typescript
-// lib/auth-client.ts
-import { createAuthClient } from 'better-auth/client'
-
-export const authClient = createAuthClient({
-  // 옵션
-})
-```
-
-### React 클라이언트
+## 클라이언트
 
 ```typescript
 import { createAuthClient } from 'better-auth/react'
-
-export const authClient = createAuthClient({
-  // 옵션
-})
-```
-
-### 플러그인 포함 클라이언트
-
-```typescript
-import { createAuthClient } from 'better-auth/client'
 import { twoFactorClient } from 'better-auth/client/plugins'
 
-const authClient = createAuthClient({
-  plugins: [
-    twoFactorClient({
-      twoFactorPage: '/two-factor',
-      onTwoFactorRedirect() {
-        router.push('/two-factor')
-      },
-    }),
-  ],
+export const authClient = createAuthClient({
+  plugins: [twoFactorClient({ twoFactorPage: '/two-factor' })],
 })
 ```
 
-## TanStack Start 통합
+## TanStack Start 연동
 
 ```typescript
-// lib/auth.ts
-import { betterAuth } from 'better-auth'
-import { prismaAdapter } from 'better-auth/adapters/prisma'
-import { prisma } from './prisma'
-
-export const auth = betterAuth({
-  database: prismaAdapter(prisma),
-  emailAndPassword: {
-    enabled: true,
-  },
-})
-
-// Server Function에서 사용
-import { createServerFn } from '@tanstack/react-start'
-import { auth } from '@/lib/auth'
-
 export const getSession = createServerFn({ method: 'GET' })
-  .handler(async ({ request }) => {
-    const session = await auth.api.getSession({
-      headers: request.headers,
-    })
-    return session
-  })
+  .handler(async ({ request }) => auth.api.getSession({ headers: request.headers }))
 ```

package/templates/tanstack-start/docs/library/prisma/cloudflare-d1.md

@@ -1,404 +1,76 @@
 # Prisma - Cloudflare D1
 
-> **상위 문서**: [Prisma](./index.md)
+SQLite 기반 서버리스 DB. 일반 Prisma 마이그레이션과 다른 워크플로우.
 
----
+⚠️ 트랜잭션 미지원 | prisma migrate 불가 - wrangler 사용 | Preview 상태
 
-## ⚠️ 주의사항
-
-Cloudflare D1은 **SQLite 기반 서버리스 데이터베이스**입니다. 일반 Prisma 마이그레이션과 **다른 워크플로우**를 사용합니다.
-
-```
-⚠️ D1은 트랜잭션을 지원하지 않음 (ACID 보장 X)
-⚠️ prisma migrate dev 사용 불가 - wrangler CLI 사용
-⚠️ Prisma ORM D1 지원은 Preview 상태
-```
-
----
-
-## 🚀 Quick Reference
-
-```typescript
-// D1 Adapter 설정
-import { PrismaClient } from './generated/prisma'
-import { PrismaD1 } from '@prisma/adapter-d1'
-
-export interface Env {
-  DB: D1Database
-}
-
-export default {
-  async fetch(request: Request, env: Env): Promise<Response> {
-    const adapter = new PrismaD1(env.DB)
-    const prisma = new PrismaClient({ adapter })
-
-    const users = await prisma.user.findMany()
-    return new Response(JSON.stringify(users))
-  },
-}
-```
-
-### schema.prisma (D1용)
+## 설정
 
 ```prisma
+// schema.prisma
 generator client {
   provider = "prisma-client"
   output   = "../src/generated/prisma"
-  runtime  = "cloudflare"  // D1 필수!
+  runtime  = "cloudflare"  // 필수
 }
 
 datasource db {
-  provider = "sqlite"  // D1은 SQLite 기반
-}
-
-model User {
-  id    Int     @id @default(autoincrement())
-  email String  @unique
-  name  String?
+  provider = "sqlite"
 }
 ```
 
----
-
-## 설치
-
-```bash
-# 필수 패키지
-npm install @prisma/client @prisma/adapter-d1
-npm install -D prisma wrangler
-
-# Prisma 초기화
-npx prisma init --datasource-provider sqlite
-```
-
----
-
-## D1 데이터베이스 생성
-
-```bash
-# Cloudflare D1 데이터베이스 생성
-npx wrangler d1 create my-database
-
-# 출력 예시:
-# ✅ Successfully created DB 'my-database'
-# database_id = "xxxx-xxxx-xxxx-xxxx"
-```
-
----
-
-## wrangler.jsonc 설정
-
 ```jsonc
+// wrangler.jsonc
 {
-  "$schema": "node_modules/wrangler/config-schema.json",
-  "name": "my-worker",
-  "main": "src/index.ts",
-  "compatibility_date": "2025-01-01",
-  "d1_databases": [
-    {
-      "binding": "DB",
-      "database_name": "my-database",
-      "database_id": "YOUR_DATABASE_ID"
-    }
-  ]
+  "d1_databases": [{ "binding": "DB", "database_name": "my-db", "database_id": "ID" }]
 }
 ```
 
----
-
-## Schema 설정
-
-### schema.prisma
-
-```prisma
-generator client {
-  provider = "prisma-client"
-  output   = "../src/generated/prisma"
-  runtime  = "cloudflare"
-}
-
-datasource db {
-  provider = "sqlite"
-}
-
-model User {
-  id    Int     @id @default(autoincrement())
-  email String  @unique
-  name  String?
-  posts Post[]
-}
-
-model Post {
-  id        Int     @id @default(autoincrement())
-  title     String
-  content   String?
-  published Boolean @default(false)
-  author    User    @relation(fields: [authorId], references: [id])
-  authorId  Int
-}
-```
-
----
-
-## 마이그레이션 워크플로우
-
-D1은 일반 Prisma 마이그레이션(`prisma migrate dev`)을 사용하지 않습니다.
-
-### 1단계: 마이그레이션 디렉토리 생성
-
-```bash
-mkdir -p prisma/migrations
-```
-
-### 2단계: 마이그레이션 파일 생성 (wrangler)
-
-```bash
-npx wrangler d1 migrations create my-database create_user_table
-```
-
-### 3단계: SQL 생성 (prisma migrate diff)
-
-```bash
-# 초기 마이그레이션 (빈 스키마에서)
-npx prisma migrate diff \
-  --from-empty \
-  --to-schema-datamodel prisma/schema.prisma \
-  --script \
-  --output prisma/migrations/0001_create_user_table.sql
-
-# 후속 마이그레이션 (로컬 D1에서)
-npx prisma migrate diff \
-  --from-local-d1 \
-  --to-schema-datamodel prisma/schema.prisma \
-  --script \
-  --output prisma/migrations/0002_add_post_table.sql
-```
-
-### 4단계: 마이그레이션 적용
-
-```bash
-# 로컬 데이터베이스에 적용
-npx wrangler d1 migrations apply my-database --local
-
-# 원격(프로덕션) 데이터베이스에 적용
-npx wrangler d1 migrations apply my-database --remote
-```
-
-### 생성된 SQL 예시
-
-```sql
--- 0001_create_user_table.sql
--- CreateTable
-CREATE TABLE "User" (
-    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
-    "email" TEXT NOT NULL,
-    "name" TEXT
-);
-
--- CreateIndex
-CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
-```
-
----
-
-## Prisma Client 설정
-
-### Cloudflare Worker에서 사용
+## 사용법
 
 ```typescript
-// src/index.ts
 import { PrismaClient } from './generated/prisma'
 import { PrismaD1 } from '@prisma/adapter-d1'
 
-export interface Env {
-  DB: D1Database
-}
+export interface Env { DB: D1Database }
 
 export default {
-  async fetch(
-    request: Request,
-    env: Env,
-    ctx: ExecutionContext
-  ): Promise<Response> {
+  async fetch(request: Request, env: Env): Promise<Response> {
     const adapter = new PrismaD1(env.DB)
     const prisma = new PrismaClient({ adapter })
-
-    const url = new URL(request.url)
-
-    if (url.pathname === '/users' && request.method === 'GET') {
-      const users = await prisma.user.findMany()
-      return new Response(JSON.stringify(users), {
-        headers: { 'Content-Type': 'application/json' },
-      })
-    }
-
-    if (url.pathname === '/users' && request.method === 'POST') {
-      const body = await request.json()
-      const user = await prisma.user.create({
-        data: body,
-      })
-      return new Response(JSON.stringify(user), {
-        status: 201,
-        headers: { 'Content-Type': 'application/json' },
-      })
-    }
-
-    return new Response('Not Found', { status: 404 })
+    const users = await prisma.user.findMany()
+    return new Response(JSON.stringify(users))
   },
 }
 ```
 
----
-
-## TanStack Start + D1 통합
-
-D1은 Cloudflare Workers 환경에서 실행되므로, TanStack Start의 Cloudflare 배포와 함께 사용합니다.
-
-### Server Function에서 사용
-
-```typescript
-// lib/prisma.ts
-import { PrismaClient } from './generated/prisma'
-import { PrismaD1 } from '@prisma/adapter-d1'
-
-export const createPrismaClient = (db: D1Database) => {
-  const adapter = new PrismaD1(db)
-  return new PrismaClient({ adapter })
-}
-
-// Server Function
-import { createServerFn } from '@tanstack/react-start'
-
-export const getUsers = createServerFn({ method: 'GET' })
-  .handler(async ({ context }) => {
-    // context에서 D1 바인딩 접근 필요
-    const prisma = createPrismaClient(context.env.DB)
-    return prisma.user.findMany()
-  })
-```
-
----
-
-## 로컬 개발
-
-### 로컬 D1로 개발
-
-```bash
-# 로컬 Worker 실행 (D1 포함)
-npx wrangler dev
-
-# 로컬 D1에 데이터 삽입
-npx wrangler d1 execute my-database --local \
-  --command "INSERT INTO User (email, name) VALUES ('test@example.com', 'Test User');"
-
-# 로컬 D1 조회
-npx wrangler d1 execute my-database --local \
-  --command "SELECT * FROM User;"
-```
-
----
-
-## 배포
-
-```bash
-# Prisma Client 생성
-npx prisma generate
-
-# 원격 D1에 마이그레이션 적용
-npx wrangler d1 migrations apply my-database --remote
-
-# Worker 배포
-npx wrangler deploy
-```
-
----
-
-## ⚠️ 제한사항
-
-### 트랜잭션 미지원
-
-```typescript
-// ❌ 트랜잭션이 무시됨 - ACID 보장 안됨
-await prisma.$transaction([
-  prisma.user.create({ data: { email: 'user1@example.com' } }),
-  prisma.post.create({ data: { title: 'Post', authorId: 1 } }),
-])
-
-// ❌ Interactive 트랜잭션도 미지원
-await prisma.$transaction(async (tx) => {
-  // 각 쿼리가 독립적으로 실행됨
-})
-```
-
-### D1 vs 일반 SQLite 차이점
-
-| 항목 | 일반 SQLite | Cloudflare D1 |
-|------|-------------|---------------|
-| 마이그레이션 | `prisma migrate dev` | `wrangler d1 migrations` |
-| 트랜잭션 | ✅ 지원 | ❌ 미지원 |
-| 데이터베이스 위치 | 로컬 파일 | Cloudflare Edge |
-| 접속 방식 | 직접 연결 | HTTP (어댑터) |
-| 환경 | 로컬 `.wrangler/state` | 원격 Cloudflare |
-
----
-
-## prisma.config.ts (선택사항)
-
-Prisma CLI에서 D1에 직접 접근이 필요한 경우:
-
-```typescript
-// prisma.config.ts
-import path from 'node:path'
-import type { PrismaConfig } from 'prisma'
-import { PrismaD1 } from '@prisma/adapter-d1'
-
-export default {
-  experimental: {
-    adapter: true,
-  },
-  engine: 'js',
-  schema: path.join('prisma', 'schema.prisma'),
-  async adapter() {
-    return new PrismaD1({
-      CLOUDFLARE_D1_TOKEN: process.env.CLOUDFLARE_D1_TOKEN,
-      CLOUDFLARE_ACCOUNT_ID: process.env.CLOUDFLARE_ACCOUNT_ID,
-      CLOUDFLARE_DATABASE_ID: process.env.CLOUDFLARE_DATABASE_ID,
-    })
-  },
-} satisfies PrismaConfig
-```
-
----
-
-## 마이그레이션 명령어 요약
+## 마이그레이션 워크플로우
 
 ```bash
-# D1 데이터베이스 생성
+# 1. D1 생성
 npx wrangler d1 create my-database
 
-# 마이그레이션 파일 생성
-npx wrangler d1 migrations create my-database migration_name
+# 2. 마이그레이션 생성
+npx wrangler d1 migrations create my-database init
 
-# SQL 생성 (초기)
-npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script
+# 3. SQL 생성 (초기)
+npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script --output prisma/migrations/0001.sql
 
-# SQL 생성 (후속)
+# 4. SQL 생성 (후속)
 npx prisma migrate diff --from-local-d1 --to-schema-datamodel prisma/schema.prisma --script
 
-# 로컬 적용
-npx wrangler d1 migrations apply my-database --local
+# 5. 적용
+npx wrangler d1 migrations apply my-database --local   # 로컬
+npx wrangler d1 migrations apply my-database --remote  # 프로덕션
 
-# 원격 적용
-npx wrangler d1 migrations apply my-database --remote
-
-# Prisma Client 생성
+# 6. Client 생성
 npx prisma generate
 ```
 
----
-
-## 참고 자료
+## 제한사항
 
-- [Prisma D1 공식 문서](https://www.prisma.io/docs/orm/overview/databases/cloudflare-d1)
-- [Cloudflare D1 문서](https://developers.cloudflare.com/d1/)
-- [Prisma D1 가이드](https://www.prisma.io/guides/cloudflare-d1)
+| 항목 | 일반 SQLite | D1 |
+|------|-------------|-----|
+| 마이그레이션 | prisma migrate | wrangler d1 |
+| 트랜잭션 | ✅ | ❌ |
+| 접속 | 직접 | HTTP 어댑터 |