Drizzle/BetterAuth/Storage rework

.github/workflows/node.js.yml

@@ -15,7 +15,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [24.4.1]
+        node-version: [25.2.1]
         # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
 
     steps:
@@ -25,7 +25,7 @@ jobs:
       - name: ⎔ Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 10.13.1
+          version: 10.27.0
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -41,6 +41,6 @@ jobs:
 
       - name: Lint
         run: pnpm lint
-        
+
       - name: Build project
         run: pnpm build

.pnpm-store/v10/projects/9e1b7cceca46cdd071268608ba856edf

@@ -0,0 +1 @@
+../../..

AGENTS.md

@@ -0,0 +1,85 @@
+# Agent Guidelines
+
+## Project Structure
+
+- **Backend**: `apps/api/` - NestJS with Drizzle ORM
+- **Frontend**: `apps/web/` - TanStack Start
+- **Shared**: `packages/typescript-config/` - Shared TypeScript configs
+
+## Frontend
+
+### Routing (TanStack Start)
+
+- Use Tanstack Start best practices
+
+### Data Fetching (TanStack Query)
+
+- Query keys: `['resource', id, 'sub-resource']`
+- Use `invalidateQueries()` without parameters
+
+### Forms (TanStack Forms)
+
+- Use `useForm()`, ShadCN Field components (`Field`, `FieldLabel`, `FieldError`), `form.useField()` for fields
+
+### UI Components (ShadCN + BaseUI)
+
+- Components: `apps/web/src/components/ui/` - ShadCN
+- Prefer BaseUI primitives over raw html (`@base-ui/react`)
+- Utils: `apps/web/src/lib/utils.ts` - `cn()` helper
+- Tailwind CSS with ShadCN design tokens
+
+### Type Safety
+
+- E2E types: `apps/api/generated/openapi.d.ts` (auto-generated)
+
+### Creating Routes/Components
+
+- Routes: `apps/web/src/routes/{path}.tsx` with `createFileRoute()`
+- Components: `apps/web/src/components/` using ShadCN UI + `cn()`
+
+## Backend
+
+### Database
+
+- Schema: `apps/api/src/databases/drizzle.schema.ts`
+- Tables: `apps/api/src/databases/tables/*.table.ts`
+- Utils: `apps/api/src/databases/drizzle.utils.ts`
+- Provider: `apps/api/src/databases/drizzle.provider.ts`
+
+### Authentication
+
+- Provider: `apps/api/src/auth/better-auth.provider.ts`
+- Guard: `apps/api/src/auth/guards/auth.guard.ts`
+- Decorators: `@Auth()`, `@ActiveUser()`, `@ActiveSession()`
+
+### Transactions
+
+- Use `@Transactional()` decorator
+- Inject `TransactionHost<DrizzleTransactionClient>`
+- Don't manually wrap with `tx.transaction()`
+
+### Services
+
+- Providers for external clients (Better Auth, Drizzle)
+- Services handle business logic
+- Export providers with `Inject*()` helpers
+
+### Error Handling
+
+- Use NestJS exceptions (`NotFoundException`, `UnauthorizedException`, etc.)
+
+### Type Safety
+
+- E2E types: `apps/api/generated/openapi.d.ts` (auto-generated)
+- Use `Serialize` decorator for DTO transformation
+
+### Creating Tables
+
+1. Create `apps/api/src/databases/tables/{name}.table.ts`
+2. Export from `drizzle.schema.ts`
+3. Add relations in `drizzle.relations.ts`
+
+## Important Notes
+
+- Don't nest transactions - use `@Transactional()` decorator
+- Avoid `as any` - use proper types or `as` with specific types

apps/api/.env.example

@@ -1,20 +1,23 @@
 # app
-PORT=8000
-BASE_URL=http://localhost:8000
-NODE_ENV=development
+APP_NAME=SojuStack
+APP_PORT=8000
+APP_URL=http://localhost:8000
+APP_WEB_URL=http://localhost:3000
 
-# better-auth
+# auth
 AUTH_SECRET=CHANGE_THIS_FOR_PROD
 
-# databases
-POSTGRES_URL=postgres://postgres:postgres@localhost:5432/postgres
-REDIS_URL=redis://localhost:6379
+# database
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/postgres
+
+# cache
+CACHE_URL=redis://localhost:6379
 
 # email
-EMAIL_DOMAIN=example.com
+MAIL_DOMAIN=example.com
 
 # storage
-STORAGE_HOST=localhost
-STORAGE_PORT=9000
-STORAGE_ACCESS_KEY=user
-STORAGE_SECRET_KEY=password
+STORAGE_URL=http://localhost:9000
+STORAGE_REGION=us-east-1
+STORAGE_ACCESS_KEY=admin
+STORAGE_SECRET_KEY=admin

apps/api/.gitignore

@@ -54,3 +54,5 @@ pids
 
 # Diagnostic reports (https://nodejs.org/api/report.html)
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+.nestjs_repl_history
+generated

apps/api/.nestjs_repl_history

@@ -0,0 +1 @@
+$(AppService).getHello()

apps/api/drizzle.config.ts

@@ -0,0 +1,12 @@
+// @ts-nocheck
+import 'dotenv/config';
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  dialect: 'postgresql',
+  schema: './src/databases/drizzle.schema.ts',
+  out: './src/databases/migrations',
+  dbCredentials: {
+    url: process.env['DATABASE_URL']!,
+  },
+});