create-kuckit-app 0.3.5 → 0.4.0

package/templates/base/packages/db/AGENTS.md

@@ -1,99 +0,0 @@
-# AGENTS.md - Database Package
-
-> See root [AGENTS.md](../../AGENTS.md) for SDK Module System patterns
-
-## Purpose
-
-Drizzle ORM configuration, database connection, migrations, and shared schema.
-
-## Key Files
-
-| File                | Purpose                   |
-| ------------------- | ------------------------- |
-| `drizzle.config.ts` | Drizzle Kit configuration |
-| `src/connection.ts` | Database connection pool  |
-| `src/schema/`       | Shared schema definitions |
-| `src/migrations/`   | SQL migration files       |
-
-## Commands
-
-```bash
-# Generate migration from schema changes
-bun run db:generate
-
-# Apply pending migrations
-bun run db:migrate
-
-# Open Drizzle Studio (database GUI)
-bun run db:studio
-```
-
-## Adding a New Table
-
-1. Create schema file in `src/schema/` or in your module's `adapters/`:
-
-   ```typescript
-   import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core'
-
-   export const myTable = pgTable('my_table', {
-   	id: uuid('id').primaryKey().defaultRandom(),
-   	name: text('name').notNull(),
-   	createdAt: timestamp('created_at').defaultNow(),
-   })
-   ```
-
-2. Export from `src/index.ts` if shared
-
-3. Generate and run migration:
-   ```bash
-   bun run db:generate
-   bun run db:migrate
-   ```
-
-## Module Schema Pattern
-
-Modules can define their own schemas in `adapters/`:
-
-```typescript
-// packages/items-module/src/adapters/items.schema.ts
-export const itemsTable = pgTable('items', {
-	id: uuid('id').primaryKey().defaultRandom(),
-	userId: text('user_id').notNull(),
-	name: text('name').notNull(),
-})
-```
-
-The schema is imported by `drizzle.config.ts` for migration generation.
-
-### ⚠️ Important: Register Module Schemas
-
-**Drizzle only discovers schemas listed in `drizzle.config.ts`**. When adding a new module with database tables:
-
-1. Add the module's schema path to `drizzle.config.ts`:
-
-   ```typescript
-   export default defineConfig({
-   	schema: [
-   		resolve(currentDirPath, './src/schema'),
-   		// Add module schema paths here:
-   		resolve(currentDirPath, '../your-module/src/adapters/schema.drizzle.ts'),
-   	],
-   	// ...
-   })
-   ```
-
-2. Generate and apply migration:
-   ```bash
-   bun run db:generate
-   bun run db:migrate
-   ```
-
-**Common Issue**: If you see "relation does not exist" errors, the module schema likely isn't registered in `drizzle.config.ts`.
-
-## Connection
-
-```typescript
-import { db } from '@__APP_NAME_KEBAB__/db'
-
-const users = await db.select().from(usersTable)
-```

package/templates/base/packages/db/drizzle.config.ts

@@ -1,23 +0,0 @@
-import { defineConfig } from 'drizzle-kit'
-import dotenv from 'dotenv'
-import { dirname, resolve } from 'path'
-import { fileURLToPath } from 'url'
-import { buildDatabaseUrl } from './src/connection'
-
-const currentFilePath = fileURLToPath(import.meta.url)
-const currentDirPath = dirname(currentFilePath)
-
-dotenv.config({
-	path: resolve(currentDirPath, '../../apps/server/.env'),
-})
-
-export default defineConfig({
-	schema: [
-		resolve(currentDirPath, './src/schema'),
-		// Module schemas - add new module schema paths here
-		resolve(currentDirPath, '../items-module/src/adapters/item.drizzle.ts'),
-	],
-	out: resolve(currentDirPath, './src/migrations'),
-	dialect: 'postgresql',
-	dbCredentials: { url: buildDatabaseUrl() },
-})

package/templates/base/packages/db/package.json

@@ -1,36 +0,0 @@
-{
-	"name": "@__APP_NAME_KEBAB__/db",
-	"version": "0.0.1",
-	"private": true,
-	"type": "module",
-	"main": "src/index.ts",
-	"types": "src/index.ts",
-	"exports": {
-		".": {
-			"types": "./src/index.ts",
-			"default": "./src/index.ts"
-		},
-		"./*": {
-			"types": "./src/*.ts",
-			"default": "./src/*.ts"
-		}
-	},
-	"scripts": {
-		"db:generate": "drizzle-kit generate",
-		"db:migrate": "drizzle-kit migrate",
-		"db:studio": "drizzle-kit studio"
-	},
-	"devDependencies": {
-		"drizzle-kit": "^0.31.2",
-		"@types/pg": "^8.11.11"
-	},
-	"peerDependencies": {
-		"typescript": "^5"
-	},
-	"dependencies": {
-		"drizzle-orm": "^0.44.2",
-		"pg": "^8.14.1",
-		"dotenv": "^17.2.2",
-		"zod": "^4.1.11"
-	}
-}

package/templates/base/packages/db/src/connection.ts

@@ -1,40 +0,0 @@
-/**
- * Database connection utilities
- * Single source of truth for DATABASE_URL construction
- */
-
-/**
- * Build DATABASE_URL from environment variables
- *
- * Supports two modes:
- * 1. Direct DATABASE_URL - used in local development
- * 2. Individual DB_* vars - used in Cloud Run with Cloud SQL Auth Proxy
- *
- * @throws Error if neither DATABASE_URL nor complete DB_* vars are provided
- */
-export function buildDatabaseUrl(): string {
-	// Prefer DATABASE_URL if provided directly
-	if (process.env.DATABASE_URL) {
-		return process.env.DATABASE_URL
-	}
-
-	// Construct from individual components (Cloud Run with Cloud SQL)
-	const { DB_HOST, DB_USER, DB_PASSWORD, DB_NAME } = process.env
-	if (DB_HOST && DB_USER && DB_PASSWORD && DB_NAME) {
-		return `postgresql://${DB_USER}:${encodeURIComponent(DB_PASSWORD)}@/${DB_NAME}?host=${DB_HOST}`
-	}
-
-	throw new Error(
-		'Missing database configuration: provide DATABASE_URL or DB_HOST, DB_USER, DB_PASSWORD, DB_NAME'
-	)
-}
-
-/**
- * Ensure DATABASE_URL is set in process.env
- * Call this early in application startup to set up the environment
- */
-export function ensureDatabaseUrl(): string {
-	const url = buildDatabaseUrl()
-	process.env.DATABASE_URL = url
-	return url
-}

package/templates/base/packages/db/src/index.ts

@@ -1,4 +0,0 @@
-import { drizzle } from 'drizzle-orm/node-postgres'
-import { buildDatabaseUrl } from './connection'
-
-export const db = drizzle(buildDatabaseUrl())

package/templates/base/packages/db/src/schema/auth.ts

@@ -1,51 +0,0 @@
-import { pgTable, text, timestamp, boolean } from 'drizzle-orm/pg-core'
-
-export const user = pgTable('user', {
-	id: text('id').primaryKey(),
-	name: text('name').notNull(),
-	email: text('email').notNull().unique(),
-	emailVerified: boolean('email_verified').notNull(),
-	image: text('image'),
-	createdAt: timestamp('created_at').notNull(),
-	updatedAt: timestamp('updated_at').notNull(),
-})
-
-export const session = pgTable('session', {
-	id: text('id').primaryKey(),
-	expiresAt: timestamp('expires_at').notNull(),
-	token: text('token').notNull().unique(),
-	createdAt: timestamp('created_at').notNull(),
-	updatedAt: timestamp('updated_at').notNull(),
-	ipAddress: text('ip_address'),
-	userAgent: text('user_agent'),
-	userId: text('user_id')
-		.notNull()
-		.references(() => user.id, { onDelete: 'cascade' }),
-})
-
-export const account = pgTable('account', {
-	id: text('id').primaryKey(),
-	accountId: text('account_id').notNull(),
-	providerId: text('provider_id').notNull(),
-	userId: text('user_id')
-		.notNull()
-		.references(() => user.id, { onDelete: 'cascade' }),
-	accessToken: text('access_token'),
-	refreshToken: text('refresh_token'),
-	idToken: text('id_token'),
-	accessTokenExpiresAt: timestamp('access_token_expires_at'),
-	refreshTokenExpiresAt: timestamp('refresh_token_expires_at'),
-	scope: text('scope'),
-	password: text('password'),
-	createdAt: timestamp('created_at').notNull(),
-	updatedAt: timestamp('updated_at').notNull(),
-})
-
-export const verification = pgTable('verification', {
-	id: text('id').primaryKey(),
-	identifier: text('identifier').notNull(),
-	value: text('value').notNull(),
-	expiresAt: timestamp('expires_at').notNull(),
-	createdAt: timestamp('created_at'),
-	updatedAt: timestamp('updated_at'),
-})

package/templates/base/packages/db/tsconfig.json

@@ -1,8 +0,0 @@
-{
-	"extends": "../../tsconfig.base.json",
-	"compilerOptions": {
-		"outDir": "dist",
-		"rootDir": "src"
-	},
-	"include": ["src/**/*"]
-}