feat: scaffold packages/db (#168)

Author: didinele

.claude/settings.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm view *)",
+      "Bash(yarn install *)",
+      "Bash(yarn workspace *)",
+      "Bash(yarn turbo *)",
+      "Bash(yarn prettier *)"
+    ]
+  }
+}

.env.public

@@ -1,6 +1,7 @@
 ROOT_DOMAIN=automoderator.app
 
 PRISMA_DATABASE_URL=postgres://chatsift:admin@127.0.0.1:${LOCAL_DATABASE_PORT}/chatsift
+DATABASE_URL=postgres://chatsift:admin@127.0.0.1:${LOCAL_DATABASE_PORT}/chatsift
 REDIS_URL=redis://redis:6379
 
 API_PORT=7004

package.json

@@ -7,6 +7,7 @@
 	"type": "module",
 	"workspaces": [
 		"apps/*",
+		"packages/db",
 		"packages/public/*",
 		"packages/private/*",
 		"services/*"

packages/db/atlas.hcl

@@ -0,0 +1,23 @@
+variable "database_url" {
+  type    = string
+  default = getenv("DATABASE_URL")
+}
+
+env "local" {
+  src = "file://schema/schema.sql"
+  url = var.database_url
+
+  # Used by `atlas migrate diff` / `atlas migrate lint` to compute a clean diff against an
+  # ephemeral database rather than the real dev DB.
+  dev = "docker://postgres/17/dev?search_path=public"
+
+  migration {
+    dir = "file://migrations"
+  }
+
+  format {
+    migrate {
+      diff = "{{ sql . \"  \" }}"
+    }
+  }
+}

packages/db/kanel.config.js

@@ -0,0 +1,10 @@
+/** @type {import('kanel').Config} */
+export default {
+	connection: {
+		connectionString: process.env.DATABASE_URL,
+	},
+
+	schemas: ['public'],
+	outputPath: './src/generated',
+	preDeleteOutputFolder: true,
+};

packages/db/migrations/.gitkeep

@@ -0,0 +1,29 @@
+{
+	"$schema": "https://json.schemastore.org/package.json",
+	"name": "@chatsift/db",
+	"version": "0.1.0",
+	"description": "Database schema, migrations, and query client (postgres.js + Atlas + kanel)",
+	"private": true,
+	"type": "module",
+	"exports": {
+		".": "./dist/index.js"
+	},
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsc",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "eslint src",
+		"lint:fix": "eslint src --fix",
+		"clean": "rimraf dist"
+	},
+	"devDependencies": {
+		"@types/node": "^24.9.1",
+		"kanel": "^4.0.2",
+		"rimraf": "^6.0.1",
+		"typescript": "~5.9.3"
+	},
+	"dependencies": {
+		"postgres": "^3.4.9"
+	}
+}

packages/db/package.json

@@ -0,0 +1,4 @@
+-- Declarative schema (source of truth for `atlas migrate diff`).
+-- Authored in a follow-up (see docs/roadmap/02-foundation.md Part A, checklist item 2):
+-- reproduces the 6 current Prisma models (Experiment, ExperimentOverride, DashboardGrant,
+-- AMASession, AMAPromptData, AMAQuestion + AMAQuestionState enum).

packages/db/schema/schema.sql

@@ -0,0 +1,16 @@
+import postgres from 'postgres';
+
+export type Database = postgres.Sql;
+
+export interface CreateDbOptions {
+	/**
+	 * Passed through to `postgres()` as-is. Row/column naming convention (e.g. a `postgres.camel`
+	 * transform) is decided alongside the schema — see docs/roadmap/02-foundation.md Part A.
+	 */
+	options?: postgres.Options<Record<string, postgres.PostgresType>>;
+	url: string;
+}
+
+export function createDb({ url, options }: CreateDbOptions): Database {
+	return postgres(url, options);
+}

packages/db/src/index.ts

@@ -0,0 +1,4 @@
+{
+	"extends": "../../tsconfig.eslint.json",
+	"include": ["src/**/*"]
+}