@kood/claude-code 0.2.5 → 0.3.1
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.
- package/dist/index.js +13 -8
- package/package.json +1 -1
- package/templates/.claude/agents/code-reviewer.md +371 -19
- package/templates/.claude/agents/dependency-manager.md +197 -0
- package/templates/.claude/agents/deployment-validator.md +136 -0
- package/templates/.claude/agents/git-operator.md +147 -0
- package/templates/.claude/agents/implementation-executor.md +202 -0
- package/templates/.claude/agents/lint-fixer.md +155 -0
- package/templates/.claude/agents/refactor-advisor.md +339 -29
- package/templates/.claude/commands/agent-creator.md +355 -0
- package/templates/.claude/commands/docs-creator.md +404 -163
- package/templates/.claude/commands/docs-refactor.md +400 -113
- package/templates/.claude/commands/execute.md +357 -185
- package/templates/.claude/commands/git-all.md +65 -71
- package/templates/.claude/commands/git-session.md +80 -64
- package/templates/.claude/commands/git.md +68 -72
- package/templates/.claude/commands/lint-fix.md +224 -109
- package/templates/.claude/commands/lint-init.md +142 -168
- package/templates/.claude/commands/plan.md +300 -84
- package/templates/.claude/commands/prd.md +497 -214
- package/templates/.claude/commands/pre-deploy.md +242 -0
- package/templates/.claude/commands/subagent-creator.md +118 -0
- package/templates/.claude/commands/version-update.md +45 -57
- package/templates/hono/CLAUDE.md +99 -54
- package/templates/hono/docs/guides/conventions.md +352 -0
- package/templates/hono/docs/guides/env-setup.md +347 -0
- package/templates/hono/docs/guides/getting-started.md +239 -0
- package/templates/hono/docs/library/hono/error-handling.md +20 -29
- package/templates/hono/docs/library/hono/index.md +25 -52
- package/templates/hono/docs/library/hono/middleware.md +16 -75
- package/templates/hono/docs/library/hono/rpc.md +7 -35
- package/templates/hono/docs/library/hono/validation.md +25 -45
- package/templates/hono/docs/library/t3-env/index.md +374 -0
- package/templates/npx/CLAUDE.md +165 -65
- package/templates/npx/docs/library/commander/index.md +10 -73
- package/templates/npx/docs/library/fs-extra/index.md +21 -113
- package/templates/npx/docs/library/prompts/index.md +30 -176
- package/templates/npx/docs/references/patterns.md +75 -48
- package/templates/tanstack-start/CLAUDE.md +101 -77
- package/templates/tanstack-start/docs/architecture.md +427 -0
- package/templates/tanstack-start/docs/design.md +558 -0
- package/templates/tanstack-start/docs/guides/conventions.md +132 -32
- package/templates/tanstack-start/docs/guides/env-setup.md +127 -62
- package/templates/tanstack-start/docs/guides/getting-started.md +81 -20
- package/templates/tanstack-start/docs/guides/hooks.md +241 -36
- package/templates/tanstack-start/docs/guides/routes.md +213 -61
- package/templates/tanstack-start/docs/guides/services.md +260 -24
- package/templates/tanstack-start/docs/library/better-auth/index.md +469 -16
- package/templates/tanstack-start/docs/library/t3-env/index.md +307 -0
- package/templates/tanstack-start/docs/library/tanstack-query/index.md +12 -21
- package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md +22 -35
- package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md +7 -24
- package/templates/tanstack-start/docs/library/tanstack-query/use-mutation.md +26 -39
- package/templates/tanstack-start/docs/library/tanstack-query/use-query.md +23 -26
- package/templates/tanstack-start/docs/library/tanstack-router/error-handling.md +32 -147
- package/templates/tanstack-start/docs/library/tanstack-router/hooks.md +25 -167
- package/templates/tanstack-start/docs/library/tanstack-router/index.md +39 -74
- package/templates/tanstack-start/docs/library/tanstack-router/navigation.md +46 -116
- package/templates/tanstack-start/docs/library/tanstack-router/route-context.md +35 -154
- package/templates/tanstack-start/docs/library/tanstack-router/search-params.md +32 -171
- package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md +7 -15
- package/templates/tanstack-start/docs/library/tanstack-start/routing.md +16 -23
- package/templates/tanstack-start/docs/library/zod/complex-types.md +12 -31
- package/templates/tanstack-start/docs/library/zod/index.md +18 -35
- package/templates/tanstack-start/docs/library/zod/transforms.md +11 -25
- package/templates/tanstack-start/docs/library/zod/validation.md +12 -34
- package/templates/.claude/agents/debug-detective.md +0 -37
- package/templates/.claude/agents/test-writer.md +0 -41
- package/templates/.claude/commands/feedback.md +0 -199
- package/templates/.claude/commands/ts-fix.md +0 -176
- package/templates/.claude/skills/command-creator/LICENSE.txt +0 -202
- package/templates/.claude/skills/command-creator/SKILL.md +0 -245
- package/templates/.claude/skills/command-creator/scripts/init_command.py +0 -244
- package/templates/.claude/skills/command-creator/scripts/package_command.py +0 -125
- package/templates/.claude/skills/command-creator/scripts/quick_validate.py +0 -143
- package/templates/.claude/skills/frontend-design/SKILL.md +0 -310
- package/templates/.claude/skills/frontend-design/references/animation-patterns.md +0 -446
- package/templates/.claude/skills/frontend-design/references/colors-2026.md +0 -244
- package/templates/.claude/skills/frontend-design/references/typography-2026.md +0 -302
- package/templates/.claude/skills/gemini-review/SKILL.md +0 -118
- package/templates/.claude/skills/gemini-review/references/checklists.md +0 -129
- package/templates/.claude/skills/gemini-review/references/prompt-templates.md +0 -274
- package/templates/.claude/skills/skill-creator/LICENSE.txt +0 -202
- package/templates/.claude/skills/skill-creator/SKILL.md +0 -184
- package/templates/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
- package/templates/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
- package/templates/.claude/skills/skill-creator/scripts/quick_validate.py +0 -65
- package/templates/hono/docs/library/ai-sdk/index.md +0 -190
- package/templates/hono/docs/library/ai-sdk/openrouter.md +0 -111
- package/templates/hono/docs/library/ai-sdk/providers.md +0 -102
- package/templates/hono/docs/library/ai-sdk/streaming.md +0 -146
- package/templates/hono/docs/library/ai-sdk/structured-output.md +0 -161
- package/templates/hono/docs/library/ai-sdk/tools.md +0 -144
- package/templates/hono/docs/library/drizzle/cloudflare-d1.md +0 -247
- package/templates/hono/docs/library/drizzle/config.md +0 -167
- package/templates/hono/docs/library/drizzle/index.md +0 -259
- package/templates/hono/docs/library/hono/env-setup.md +0 -169
- package/templates/hono/docs/library/pino/index.md +0 -146
- package/templates/tanstack-start/docs/architecture/architecture.md +0 -243
- package/templates/tanstack-start/docs/deployment/cloudflare.md +0 -132
- package/templates/tanstack-start/docs/deployment/index.md +0 -163
- package/templates/tanstack-start/docs/deployment/nitro.md +0 -110
- package/templates/tanstack-start/docs/deployment/railway.md +0 -147
- package/templates/tanstack-start/docs/deployment/vercel.md +0 -135
- package/templates/tanstack-start/docs/design/components.md +0 -175
- package/templates/tanstack-start/docs/design/index.md +0 -151
- package/templates/tanstack-start/docs/design/safe-area.md +0 -118
- package/templates/tanstack-start/docs/design/tailwind-setup.md +0 -156
- package/templates/tanstack-start/docs/library/ai-sdk/hooks.md +0 -472
- package/templates/tanstack-start/docs/library/ai-sdk/index.md +0 -264
- package/templates/tanstack-start/docs/library/ai-sdk/openrouter.md +0 -371
- package/templates/tanstack-start/docs/library/ai-sdk/providers.md +0 -403
- package/templates/tanstack-start/docs/library/ai-sdk/streaming.md +0 -320
- package/templates/tanstack-start/docs/library/ai-sdk/structured-output.md +0 -454
- package/templates/tanstack-start/docs/library/ai-sdk/tools.md +0 -473
- package/templates/tanstack-start/docs/library/better-auth/2fa.md +0 -48
- package/templates/tanstack-start/docs/library/better-auth/advanced.md +0 -55
- package/templates/tanstack-start/docs/library/better-auth/plugins.md +0 -34
- package/templates/tanstack-start/docs/library/better-auth/session.md +0 -47
- package/templates/tanstack-start/docs/library/better-auth/setup.md +0 -41
- package/templates/tanstack-start/docs/library/drizzle/cloudflare-d1.md +0 -147
- package/templates/tanstack-start/docs/library/drizzle/config.md +0 -118
- package/templates/tanstack-start/docs/library/drizzle/crud.md +0 -205
- package/templates/tanstack-start/docs/library/drizzle/index.md +0 -79
- package/templates/tanstack-start/docs/library/drizzle/relations.md +0 -202
- package/templates/tanstack-start/docs/library/drizzle/schema.md +0 -154
- package/templates/tanstack-start/docs/library/drizzle/setup.md +0 -96
- package/templates/tanstack-start/docs/library/drizzle/transactions.md +0 -127
- package/templates/tanstack-start/docs/library/pino/index.md +0 -320
- /package/templates/hono/docs/{architecture/architecture.md → architecture.md} +0 -0
|
@@ -1,147 +0,0 @@
|
|
|
1
|
-
# Drizzle - Cloudflare D1
|
|
2
|
-
|
|
3
|
-
SQLite 기반 서버리스 DB. 일반 Drizzle 마이그레이션과 다른 워크플로우.
|
|
4
|
-
|
|
5
|
-
트랜잭션 미지원 | drizzle-kit migrate 불가 - wrangler 사용
|
|
6
|
-
|
|
7
|
-
## 설정
|
|
8
|
-
|
|
9
|
-
### 스키마 (SQLite)
|
|
10
|
-
|
|
11
|
-
```typescript
|
|
12
|
-
// src/db/schema.ts
|
|
13
|
-
import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'
|
|
14
|
-
|
|
15
|
-
export const users = sqliteTable('users', {
|
|
16
|
-
id: integer('id').primaryKey({ autoIncrement: true }),
|
|
17
|
-
email: text('email').notNull().unique(),
|
|
18
|
-
name: text('name'),
|
|
19
|
-
})
|
|
20
|
-
|
|
21
|
-
export type User = typeof users.$inferSelect
|
|
22
|
-
export type NewUser = typeof users.$inferInsert
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### drizzle.config.ts
|
|
26
|
-
|
|
27
|
-
```typescript
|
|
28
|
-
import { defineConfig } from 'drizzle-kit'
|
|
29
|
-
|
|
30
|
-
export default defineConfig({
|
|
31
|
-
dialect: 'sqlite',
|
|
32
|
-
schema: './src/db/schema.ts',
|
|
33
|
-
out: './drizzle/migrations',
|
|
34
|
-
driver: 'd1-http',
|
|
35
|
-
dbCredentials: {
|
|
36
|
-
accountId: process.env.CLOUDFLARE_ACCOUNT_ID!,
|
|
37
|
-
databaseId: process.env.CLOUDFLARE_DATABASE_ID!,
|
|
38
|
-
token: process.env.CLOUDFLARE_D1_TOKEN!,
|
|
39
|
-
},
|
|
40
|
-
})
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### wrangler.jsonc
|
|
44
|
-
|
|
45
|
-
```jsonc
|
|
46
|
-
{
|
|
47
|
-
"d1_databases": [{
|
|
48
|
-
"binding": "DB",
|
|
49
|
-
"database_name": "my-db",
|
|
50
|
-
"database_id": "YOUR_DATABASE_ID",
|
|
51
|
-
"migrations_dir": "drizzle/migrations"
|
|
52
|
-
}]
|
|
53
|
-
}
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
## 사용법
|
|
57
|
-
|
|
58
|
-
```typescript
|
|
59
|
-
import { drizzle } from 'drizzle-orm/d1'
|
|
60
|
-
import * as schema from './db/schema'
|
|
61
|
-
|
|
62
|
-
export interface Env {
|
|
63
|
-
DB: D1Database
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
export default {
|
|
67
|
-
async fetch(request: Request, env: Env): Promise<Response> {
|
|
68
|
-
const db = drizzle(env.DB, { schema })
|
|
69
|
-
const users = await db.select().from(schema.users)
|
|
70
|
-
return new Response(JSON.stringify(users))
|
|
71
|
-
},
|
|
72
|
-
}
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
## TanStack Start + D1
|
|
76
|
-
|
|
77
|
-
```typescript
|
|
78
|
-
// app/services/user.ts
|
|
79
|
-
import { createServerFn } from '@tanstack/react-start'
|
|
80
|
-
import { drizzle } from 'drizzle-orm/d1'
|
|
81
|
-
import { eq } from 'drizzle-orm'
|
|
82
|
-
import { z } from 'zod'
|
|
83
|
-
import * as schema from '@/db/schema'
|
|
84
|
-
|
|
85
|
-
// D1 바인딩 접근 (Cloudflare Pages/Workers)
|
|
86
|
-
const getDb = () => {
|
|
87
|
-
const env = (globalThis as any).__env__
|
|
88
|
-
return drizzle(env.DB, { schema })
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
export const getUsers = createServerFn({ method: 'GET' })
|
|
92
|
-
.handler(async () => {
|
|
93
|
-
const db = getDb()
|
|
94
|
-
return db.select().from(schema.users)
|
|
95
|
-
})
|
|
96
|
-
|
|
97
|
-
export const createUser = createServerFn({ method: 'POST' })
|
|
98
|
-
.inputValidator(z.object({ email: z.email(), name: z.string().optional() }))
|
|
99
|
-
.handler(async ({ data }) => {
|
|
100
|
-
const db = getDb()
|
|
101
|
-
const [user] = await db.insert(schema.users).values(data).returning()
|
|
102
|
-
return user
|
|
103
|
-
})
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
## 마이그레이션 워크플로우
|
|
107
|
-
|
|
108
|
-
```bash
|
|
109
|
-
# 1. D1 생성
|
|
110
|
-
npx wrangler d1 create my-database
|
|
111
|
-
|
|
112
|
-
# 2. 마이그레이션 생성
|
|
113
|
-
npx drizzle-kit generate
|
|
114
|
-
|
|
115
|
-
# 3. 로컬 적용
|
|
116
|
-
npx wrangler d1 migrations apply my-database --local
|
|
117
|
-
|
|
118
|
-
# 4. 원격 적용
|
|
119
|
-
npx wrangler d1 migrations apply my-database --remote
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
## 로컬 개발
|
|
123
|
-
|
|
124
|
-
```bash
|
|
125
|
-
# Worker 실행
|
|
126
|
-
npx wrangler dev
|
|
127
|
-
|
|
128
|
-
# D1 조회
|
|
129
|
-
npx wrangler d1 execute my-database --local \
|
|
130
|
-
--command "SELECT * FROM users;"
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
## 배포
|
|
134
|
-
|
|
135
|
-
```bash
|
|
136
|
-
npx drizzle-kit generate
|
|
137
|
-
npx wrangler d1 migrations apply my-database --remote
|
|
138
|
-
npx wrangler deploy
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
## 제한사항
|
|
142
|
-
|
|
143
|
-
| 항목 | 일반 SQLite | D1 |
|
|
144
|
-
|------|-------------|-----|
|
|
145
|
-
| 마이그레이션 | drizzle-kit migrate | wrangler d1 |
|
|
146
|
-
| 트랜잭션 | 지원 | 미지원 |
|
|
147
|
-
| 접속 | 직접 | HTTP (D1 binding) |
|
|
@@ -1,118 +0,0 @@
|
|
|
1
|
-
# Drizzle - Config 파일
|
|
2
|
-
|
|
3
|
-
drizzle.config.ts 설정.
|
|
4
|
-
|
|
5
|
-
## 기본 설정
|
|
6
|
-
|
|
7
|
-
```typescript
|
|
8
|
-
// drizzle.config.ts
|
|
9
|
-
import 'dotenv/config'
|
|
10
|
-
import { defineConfig } from 'drizzle-kit'
|
|
11
|
-
|
|
12
|
-
export default defineConfig({
|
|
13
|
-
dialect: 'postgresql',
|
|
14
|
-
schema: './src/db/schema/index.ts',
|
|
15
|
-
out: './drizzle/migrations',
|
|
16
|
-
dbCredentials: {
|
|
17
|
-
url: process.env.DATABASE_URL!,
|
|
18
|
-
},
|
|
19
|
-
})
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
## 폴더 구조
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
프로젝트/
|
|
26
|
-
├── drizzle.config.ts
|
|
27
|
-
├── drizzle/
|
|
28
|
-
│ └── migrations/
|
|
29
|
-
│ ├── 0000_init.sql
|
|
30
|
-
│ └── meta/
|
|
31
|
-
├── src/
|
|
32
|
-
│ └── db/
|
|
33
|
-
│ └── schema/
|
|
34
|
-
│ ├── index.ts
|
|
35
|
-
│ └── user.ts
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
## PostgreSQL
|
|
39
|
-
|
|
40
|
-
```typescript
|
|
41
|
-
import { defineConfig } from 'drizzle-kit'
|
|
42
|
-
|
|
43
|
-
export default defineConfig({
|
|
44
|
-
dialect: 'postgresql',
|
|
45
|
-
schema: './src/db/schema/index.ts',
|
|
46
|
-
out: './drizzle/migrations',
|
|
47
|
-
dbCredentials: {
|
|
48
|
-
url: process.env.DATABASE_URL!,
|
|
49
|
-
},
|
|
50
|
-
})
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
## MySQL
|
|
54
|
-
|
|
55
|
-
```typescript
|
|
56
|
-
import { defineConfig } from 'drizzle-kit'
|
|
57
|
-
|
|
58
|
-
export default defineConfig({
|
|
59
|
-
dialect: 'mysql',
|
|
60
|
-
schema: './src/db/schema/index.ts',
|
|
61
|
-
out: './drizzle/migrations',
|
|
62
|
-
dbCredentials: {
|
|
63
|
-
url: process.env.DATABASE_URL!,
|
|
64
|
-
},
|
|
65
|
-
})
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
## SQLite
|
|
69
|
-
|
|
70
|
-
```typescript
|
|
71
|
-
import { defineConfig } from 'drizzle-kit'
|
|
72
|
-
|
|
73
|
-
export default defineConfig({
|
|
74
|
-
dialect: 'sqlite',
|
|
75
|
-
schema: './src/db/schema/index.ts',
|
|
76
|
-
out: './drizzle/migrations',
|
|
77
|
-
dbCredentials: {
|
|
78
|
-
url: './sqlite.db',
|
|
79
|
-
},
|
|
80
|
-
})
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## 설정 옵션
|
|
84
|
-
|
|
85
|
-
| 옵션 | 설명 |
|
|
86
|
-
|------|------|
|
|
87
|
-
| `dialect` | DB 종류 (postgresql, mysql, sqlite) |
|
|
88
|
-
| `schema` | 스키마 파일 경로 (glob 패턴 지원) |
|
|
89
|
-
| `out` | 마이그레이션 출력 폴더 |
|
|
90
|
-
| `dbCredentials` | DB 연결 정보 |
|
|
91
|
-
| `driver` | 드라이버 (d1-http 등) |
|
|
92
|
-
| `verbose` | 상세 로그 출력 |
|
|
93
|
-
| `strict` | 엄격 모드 |
|
|
94
|
-
|
|
95
|
-
## 다중 스키마 파일
|
|
96
|
-
|
|
97
|
-
```typescript
|
|
98
|
-
import { defineConfig } from 'drizzle-kit'
|
|
99
|
-
|
|
100
|
-
export default defineConfig({
|
|
101
|
-
dialect: 'postgresql',
|
|
102
|
-
schema: './src/db/schema/*.ts', // glob 패턴
|
|
103
|
-
out: './drizzle/migrations',
|
|
104
|
-
dbCredentials: {
|
|
105
|
-
url: process.env.DATABASE_URL!,
|
|
106
|
-
},
|
|
107
|
-
})
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
## 마이그레이션 명령어
|
|
111
|
-
|
|
112
|
-
```bash
|
|
113
|
-
npx drizzle-kit generate # 마이그레이션 파일 생성
|
|
114
|
-
npx drizzle-kit migrate # 마이그레이션 실행
|
|
115
|
-
npx drizzle-kit push # 스키마 직접 동기화 (개발용)
|
|
116
|
-
npx drizzle-kit pull # DB에서 스키마 가져오기
|
|
117
|
-
npx drizzle-kit studio # GUI 실행
|
|
118
|
-
```
|
|
@@ -1,205 +0,0 @@
|
|
|
1
|
-
# Drizzle - CRUD 작업
|
|
2
|
-
|
|
3
|
-
## Create
|
|
4
|
-
|
|
5
|
-
```typescript
|
|
6
|
-
import { db } from '@/lib/db'
|
|
7
|
-
import { users } from '@/db/schema'
|
|
8
|
-
|
|
9
|
-
// 단일
|
|
10
|
-
const [user] = await db.insert(users)
|
|
11
|
-
.values({ email: 'alice@example.com', name: 'Alice' })
|
|
12
|
-
.returning()
|
|
13
|
-
|
|
14
|
-
// Batch insert
|
|
15
|
-
await db.insert(users).values([
|
|
16
|
-
{ email: 'alice@example.com', name: 'Alice' },
|
|
17
|
-
{ email: 'bob@example.com', name: 'Bob' },
|
|
18
|
-
])
|
|
19
|
-
|
|
20
|
-
// returning 없이
|
|
21
|
-
await db.insert(users).values({ email: 'alice@example.com' })
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
## Read
|
|
25
|
-
|
|
26
|
-
```typescript
|
|
27
|
-
import { eq, and, or, gt, like, desc, asc, count, sql } from 'drizzle-orm'
|
|
28
|
-
|
|
29
|
-
// 전체
|
|
30
|
-
const allUsers = await db.select().from(users)
|
|
31
|
-
|
|
32
|
-
// 조건
|
|
33
|
-
const [user] = await db.select().from(users).where(eq(users.id, 1))
|
|
34
|
-
|
|
35
|
-
// 복합 조건
|
|
36
|
-
const filtered = await db.select().from(users).where(
|
|
37
|
-
and(
|
|
38
|
-
eq(users.role, 'ADMIN'),
|
|
39
|
-
gt(users.createdAt, new Date('2024-01-01'))
|
|
40
|
-
)
|
|
41
|
-
)
|
|
42
|
-
|
|
43
|
-
// 특정 필드만
|
|
44
|
-
const emails = await db.select({ email: users.email }).from(users)
|
|
45
|
-
|
|
46
|
-
// 정렬
|
|
47
|
-
const sorted = await db.select().from(users).orderBy(desc(users.createdAt))
|
|
48
|
-
|
|
49
|
-
// 페이지네이션
|
|
50
|
-
const paginated = await db.select().from(users)
|
|
51
|
-
.orderBy(asc(users.id))
|
|
52
|
-
.limit(10)
|
|
53
|
-
.offset(0)
|
|
54
|
-
|
|
55
|
-
// 카운트
|
|
56
|
-
const [{ count: total }] = await db.select({ count: count() }).from(users)
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
## Relational Query (관계 포함)
|
|
60
|
-
|
|
61
|
-
```typescript
|
|
62
|
-
// with 사용
|
|
63
|
-
const userWithPosts = await db.query.users.findFirst({
|
|
64
|
-
where: eq(users.id, 1),
|
|
65
|
-
with: {
|
|
66
|
-
posts: true,
|
|
67
|
-
},
|
|
68
|
-
})
|
|
69
|
-
|
|
70
|
-
// 중첩 관계
|
|
71
|
-
const userWithAll = await db.query.users.findFirst({
|
|
72
|
-
where: eq(users.id, 1),
|
|
73
|
-
with: {
|
|
74
|
-
posts: {
|
|
75
|
-
with: {
|
|
76
|
-
comments: true,
|
|
77
|
-
},
|
|
78
|
-
},
|
|
79
|
-
},
|
|
80
|
-
})
|
|
81
|
-
|
|
82
|
-
// 조건 + 정렬
|
|
83
|
-
const result = await db.query.users.findMany({
|
|
84
|
-
where: eq(users.verified, true),
|
|
85
|
-
with: {
|
|
86
|
-
posts: {
|
|
87
|
-
where: eq(posts.published, true),
|
|
88
|
-
orderBy: desc(posts.createdAt),
|
|
89
|
-
limit: 5,
|
|
90
|
-
},
|
|
91
|
-
},
|
|
92
|
-
orderBy: asc(users.id),
|
|
93
|
-
limit: 10,
|
|
94
|
-
})
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
## Update
|
|
98
|
-
|
|
99
|
-
```typescript
|
|
100
|
-
// 단일
|
|
101
|
-
const [updated] = await db.update(users)
|
|
102
|
-
.set({ name: 'Updated Name' })
|
|
103
|
-
.where(eq(users.id, 1))
|
|
104
|
-
.returning()
|
|
105
|
-
|
|
106
|
-
// 다중
|
|
107
|
-
await db.update(users)
|
|
108
|
-
.set({ verified: true })
|
|
109
|
-
.where(eq(users.role, 'ADMIN'))
|
|
110
|
-
|
|
111
|
-
// Upsert (PostgreSQL)
|
|
112
|
-
await db.insert(users)
|
|
113
|
-
.values({ email: 'alice@example.com', name: 'Alice' })
|
|
114
|
-
.onConflictDoUpdate({
|
|
115
|
-
target: users.email,
|
|
116
|
-
set: { name: 'Alice Updated' },
|
|
117
|
-
})
|
|
118
|
-
|
|
119
|
-
// Upsert - 아무것도 안 함
|
|
120
|
-
await db.insert(users)
|
|
121
|
-
.values({ email: 'alice@example.com', name: 'Alice' })
|
|
122
|
-
.onConflictDoNothing({ target: users.email })
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
## Delete
|
|
126
|
-
|
|
127
|
-
```typescript
|
|
128
|
-
// 단일
|
|
129
|
-
await db.delete(users).where(eq(users.id, 1))
|
|
130
|
-
|
|
131
|
-
// 조건부
|
|
132
|
-
await db.delete(users).where(eq(users.verified, false))
|
|
133
|
-
|
|
134
|
-
// 전체 (주의!)
|
|
135
|
-
await db.delete(users)
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
## 필터 연산자
|
|
139
|
-
|
|
140
|
-
```typescript
|
|
141
|
-
import {
|
|
142
|
-
eq, // =
|
|
143
|
-
ne, // !=
|
|
144
|
-
gt, // >
|
|
145
|
-
gte, // >=
|
|
146
|
-
lt, // <
|
|
147
|
-
lte, // <=
|
|
148
|
-
like, // LIKE
|
|
149
|
-
ilike, // ILIKE (대소문자 무시)
|
|
150
|
-
inArray, // IN
|
|
151
|
-
notInArray,// NOT IN
|
|
152
|
-
isNull, // IS NULL
|
|
153
|
-
isNotNull, // IS NOT NULL
|
|
154
|
-
between, // BETWEEN
|
|
155
|
-
and, // AND
|
|
156
|
-
or, // OR
|
|
157
|
-
not, // NOT
|
|
158
|
-
} from 'drizzle-orm'
|
|
159
|
-
|
|
160
|
-
// 문자열
|
|
161
|
-
where(like(users.name, '%John%'))
|
|
162
|
-
where(ilike(users.name, '%john%'))
|
|
163
|
-
|
|
164
|
-
// 숫자
|
|
165
|
-
where(gt(users.age, 18))
|
|
166
|
-
where(between(users.age, 18, 65))
|
|
167
|
-
|
|
168
|
-
// 배열
|
|
169
|
-
where(inArray(users.id, [1, 2, 3]))
|
|
170
|
-
|
|
171
|
-
// NULL
|
|
172
|
-
where(isNull(users.deletedAt))
|
|
173
|
-
|
|
174
|
-
// 논리
|
|
175
|
-
where(and(eq(users.role, 'admin'), eq(users.verified, true)))
|
|
176
|
-
where(or(eq(users.role, 'admin'), eq(users.role, 'moderator')))
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
## Join
|
|
180
|
-
|
|
181
|
-
```typescript
|
|
182
|
-
// Inner join
|
|
183
|
-
const result = await db.select({
|
|
184
|
-
userId: users.id,
|
|
185
|
-
userName: users.name,
|
|
186
|
-
postTitle: posts.title,
|
|
187
|
-
})
|
|
188
|
-
.from(users)
|
|
189
|
-
.innerJoin(posts, eq(users.id, posts.authorId))
|
|
190
|
-
|
|
191
|
-
// Left join
|
|
192
|
-
const result = await db.select()
|
|
193
|
-
.from(users)
|
|
194
|
-
.leftJoin(posts, eq(users.id, posts.authorId))
|
|
195
|
-
|
|
196
|
-
// Aggregation
|
|
197
|
-
const result = await db.select({
|
|
198
|
-
userId: users.id,
|
|
199
|
-
userName: users.name,
|
|
200
|
-
postCount: count(posts.id),
|
|
201
|
-
})
|
|
202
|
-
.from(users)
|
|
203
|
-
.leftJoin(posts, eq(users.id, posts.authorId))
|
|
204
|
-
.groupBy(users.id)
|
|
205
|
-
```
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
# Drizzle ORM
|
|
2
|
-
|
|
3
|
-
> **Version**: 0.38.x | Node.js/TypeScript ORM
|
|
4
|
-
|
|
5
|
-
@setup.md
|
|
6
|
-
@config.md
|
|
7
|
-
@schema.md
|
|
8
|
-
@crud.md
|
|
9
|
-
@relations.md
|
|
10
|
-
@transactions.md
|
|
11
|
-
@cloudflare-d1.md
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## Quick Reference
|
|
16
|
-
|
|
17
|
-
```typescript
|
|
18
|
-
import { db } from '@/lib/db'
|
|
19
|
-
import { users } from '@/db/schema'
|
|
20
|
-
import { eq } from 'drizzle-orm'
|
|
21
|
-
|
|
22
|
-
// CRUD
|
|
23
|
-
const allUsers = await db.select().from(users)
|
|
24
|
-
const [user] = await db.insert(users).values({ email, name }).returning()
|
|
25
|
-
const [updated] = await db.update(users).set({ name }).where(eq(users.id, id)).returning()
|
|
26
|
-
await db.delete(users).where(eq(users.id, id))
|
|
27
|
-
|
|
28
|
-
// 관계 포함 (Relational Query)
|
|
29
|
-
const userWithPosts = await db.query.users.findFirst({
|
|
30
|
-
where: eq(users.id, id),
|
|
31
|
-
with: { posts: true },
|
|
32
|
-
})
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
### drizzle.config.ts
|
|
36
|
-
|
|
37
|
-
```typescript
|
|
38
|
-
import { defineConfig } from 'drizzle-kit'
|
|
39
|
-
|
|
40
|
-
export default defineConfig({
|
|
41
|
-
dialect: 'postgresql',
|
|
42
|
-
schema: './src/db/schema/index.ts',
|
|
43
|
-
out: './drizzle/migrations',
|
|
44
|
-
dbCredentials: {
|
|
45
|
-
url: process.env.DATABASE_URL!,
|
|
46
|
-
},
|
|
47
|
-
})
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### Claude Code 금지
|
|
51
|
-
|
|
52
|
-
| 금지 사항 |
|
|
53
|
-
|----------|
|
|
54
|
-
| drizzle-kit push 자동 실행 |
|
|
55
|
-
| drizzle-kit migrate 자동 실행 |
|
|
56
|
-
| drizzle-kit generate 자동 실행 |
|
|
57
|
-
| 스키마 임의 변경 |
|
|
58
|
-
|
|
59
|
-
---
|
|
60
|
-
|
|
61
|
-
## Drizzle Client 설정
|
|
62
|
-
|
|
63
|
-
```typescript
|
|
64
|
-
// lib/db.ts
|
|
65
|
-
import { drizzle } from 'drizzle-orm/node-postgres'
|
|
66
|
-
import * as schema from '@/db/schema'
|
|
67
|
-
|
|
68
|
-
export const db = drizzle(process.env.DATABASE_URL!, { schema })
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
## CLI 명령어
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
npx drizzle-kit generate # 마이그레이션 생성
|
|
75
|
-
npx drizzle-kit migrate # 마이그레이션 실행
|
|
76
|
-
npx drizzle-kit push # 스키마 동기화 (개발용)
|
|
77
|
-
npx drizzle-kit pull # DB에서 스키마 가져오기
|
|
78
|
-
npx drizzle-kit studio # GUI
|
|
79
|
-
```
|