Add PostgreSQL persistence layer

[LahkLeKey]

Closes: #15

Summary

Implements persistent storage using PostgreSQL for Kloak deployments. The server auto-detects DATABASE_URL and uses PostgreSQL when available, falling back to in-memory storage for local development.

Architecture

• SqlDeploymentRepository — Implements DeploymentRepository interface with JSONB support for complex objects
• Schema — 5 normalized tables with proper indexes for query performance
• Migration — Automatic schema initialization on server startup
• Server — Smart detection of DATABASE_URL to choose repository implementation

Changes Made

1. Created src/database/ module with schema, repository, and migrations
2. Updated server.ts to support both in-memory and PostgreSQL repositories
3. Fixed 5 import statements to use explicit .ts extensions (ESM requirement)
4. Created package.json with postgres (15KB, pure JS, zero node-gyp)
5. Created .gitignore to exclude node_modules and other build artifacts

Testing

npm test
# Output: 10 passing tests, 0 failing

All existing tests pass, and the database module compiles without errors.

Deployment

Local Development (in-memory)

npm run dev
# Server uses in-memory repository

Local Development (PostgreSQL)

docker run --name kloak-postgres -e POSTGRES_DB=kloak -e POSTGRES_PASSWORD=dev -p 5432:5432 -d postgres:16
DATABASE_URL=postgresql://postgres:dev@localhost/kloak npm run dev
# Server runs migrations and uses PostgreSQL repository

fly.io Deployment

fly postgres create --name kloak-db
fly postgres attach kloak-db --app kloak
# DATABASE_URL injected automatically; migrations run on app start

Files Modified

• package.json (created)
• .gitignore (created)
• src/database/schema.sql (created)
• src/database/sql-repository.ts (created)
• src/database/migrate.ts (created)
• src/database/index.ts (created)
• src/database/README.md (created)
• src/admin-ui/server.ts (updated)
• src/admin-ui/README.md (updated)
• src/sync/index.ts (import fixes)
• src/infrastructure/index.test.ts (import fix)
• src/sync/index.test.ts (import fix)

[Copilot]

Pull request overview

Adds an optional PostgreSQL-backed persistence layer for deployments, intended to be auto-selected via DATABASE_URL with an in-memory fallback for local/dev usage.

Changes:

• Introduces a new src/database/ module (schema, migration runner, SQL repository, docs).
• Updates the admin UI server to choose PostgreSQL vs in-memory repository based on DATABASE_URL and run migrations on startup.
• Adds an npm package setup (with postgres dependency) and updates several ESM imports to use explicit .ts extensions.

Reviewed changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
package.json	Adds npm scripts and the postgres dependency for running/tests/migrations.
.gitignore	Ignores Node build artifacts and environment files.
src/database/schema.sql	Defines initial PostgreSQL schema + indexes for persistence.
src/database/sql-repository.ts	Implements DeploymentRepository using PostgreSQL queries.
src/database/migrate.ts	Adds a migration runner that initializes the schema.
src/database/index.ts	Exposes the database module’s public API.
src/database/README.md	Documents local Postgres + fly.io setup.
src/admin-ui/server.ts	Auto-detects DATABASE_URL and selects repository implementation.
src/admin-ui/README.md	Updates server startup docs for in-memory vs Postgres mode.
src/sync/index.ts	Updates ESM imports/exports to include explicit .ts extensions.
src/infrastructure/index.test.ts	Updates ESM import to include explicit .ts extension.
src/sync/index.test.ts	Updates ESM import to include explicit .ts extension.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.