feat(db): generate Kysely types from SQL migrations

Adds a bin/generate-db-types.ts codegen script that replays every
migration into a scratch Bun SQLite database and runs kysely-codegen
against it, writing src/db/types.gen.ts. src/db/types.ts becomes a thin
re-export of the generated DB type, and the Kysely client registers
CamelCasePlugin so TypeScript access stays camelCase while SQL columns
remain snake_case.

Also:
- Wire `db:types` into `typegen` so `wrangler types` and Kysely codegen
  run together, and call `bun typegen` from bin/setup.
- Replace the unmaintained dotkit CLI with setup-dotenv in bin/setup.
- Drop the standalone `typecheck` script — oxlint now handles
  typechecking via oxlint-tsgolint, so tsc --noEmit is redundant.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: venables

bin/generate-db-types.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env bun
+import { Database } from "bun:sqlite"
+import { mkdtempSync, readdirSync, readFileSync, rmSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+
+const MIGRATIONS_DIR = "migrations"
+const OUT_FILE = "src/db/types.gen.ts"
+
+const tmpDir = mkdtempSync(join(tmpdir(), "startkit-db-codegen-"))
+const scratchPath = join(tmpDir, "scratch.sqlite")
+
+try {
+  const db = new Database(scratchPath, { create: true })
+  const migrations = readdirSync(MIGRATIONS_DIR)
+    .filter((file) => file.endsWith(".sql"))
+    .toSorted()
+
+  console.log(`Applying ${migrations.length} migration(s) to scratch SQLite`)
+  for (const file of migrations) {
+    const sql = readFileSync(join(MIGRATIONS_DIR, file), "utf8")
+    db.exec(sql)
+  }
+  db.close()
+
+  const codegen = Bun.spawnSync({
+    cmd: [
+      "bunx",
+      "kysely-codegen",
+      "--dialect",
+      "bun-sqlite",
+      "--camel-case",
+      "--out-file",
+      OUT_FILE
+    ],
+    env: { ...process.env, DATABASE_URL: scratchPath },
+    stdout: "inherit",
+    stderr: "inherit"
+  })
+  if (codegen.exitCode !== 0) {
+    process.exit(codegen.exitCode ?? 1)
+  }
+} finally {
+  rmSync(tmpDir, { recursive: true, force: true })
+}

bin/setup

@@ -4,10 +4,13 @@
 bun install --frozen-lockfile
 
 # Sync the .env.example file to the .env file
-dotkit sync --target .env --source .env.example
+bun run setup-dotenv sync --target .env --source .env.example
 
 # Generate a random secret for better-auth
-dotkit secret --target .env BETTER_AUTH_SECRET
+bun run setup-dotenv secret --target .env BETTER_AUTH_SECRET
 
 # Migrate the database
 bun db:migrate
+
+# Regenerate worker-configuration.d.ts and src/db/types.gen.ts
+bun typegen

bun.lock

@@ -9,6 +9,7 @@
     "db:migrate": "wrangler d1 migrations apply DB --local",
     "db:migrate:prod": "wrangler d1 migrations apply DB",
     "db:reset": "git clean -xdf .wrangler && bun db:migrate",
+    "db:types": "bun run bin/generate-db-types.ts",
     "dev": "vite dev",
     "fix": "bun run format && bun run lint:fix",
     "format": "oxfmt .",
@@ -21,8 +22,7 @@
     "setup": "bin/setup",
     "start": "vite start",
     "test": "bun test",
-    "typecheck": "tsc --noEmit --pretty",
-    "typegen": "wrangler types"
+    "typegen": "wrangler types && bun db:types"
   },
   "dependencies": {
     "@base-ui/react": "^1.3.0",
@@ -53,10 +53,11 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
-    "dotkit": "^1.5.0",
+    "kysely-codegen": "^0.20.0",
     "oxfmt": "latest",
     "oxlint": "latest",
     "oxlint-tsgolint": "latest",
+    "setup-dotenv": "^2.0.1",
     "tailwindcss": "^4.2.2",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.2",

package.json

@@ -1,12 +1,13 @@
 import { env } from "cloudflare:workers"
-import { Kysely } from "kysely"
+import { CamelCasePlugin, Kysely } from "kysely"
 import { D1Dialect } from "kysely-d1"
 
 import type { Database } from "./types"
 
 export function getDb() {
   return new Kysely<Database>({
-    dialect: new D1Dialect({ database: env.DB })
+    dialect: new D1Dialect({ database: env.DB }),
+    plugins: [new CamelCasePlugin()]
   })
 }
 

src/db/client.ts

@@ -0,0 +1,57 @@
+/**
+ * This file was generated by kysely-codegen.
+ * Please do not edit it manually.
+ */
+
+export interface Accounts {
+  accessToken: string | null;
+  accessTokenExpiresAt: number | null;
+  accountId: string;
+  createdAt: number;
+  id: string;
+  idToken: string | null;
+  password: string | null;
+  providerId: string;
+  refreshToken: string | null;
+  refreshTokenExpiresAt: number | null;
+  scope: string | null;
+  updatedAt: number;
+  userId: string;
+}
+
+export interface Sessions {
+  createdAt: number;
+  expiresAt: number;
+  id: string;
+  ipAddress: string | null;
+  token: string;
+  updatedAt: number;
+  userAgent: string | null;
+  userId: string;
+}
+
+export interface Users {
+  createdAt: number;
+  email: string;
+  emailVerified: number;
+  id: string;
+  image: string | null;
+  name: string;
+  updatedAt: number;
+}
+
+export interface Verification {
+  createdAt: number;
+  expiresAt: number;
+  id: string;
+  identifier: string;
+  updatedAt: number;
+  value: string;
+}
+
+export interface DB {
+  accounts: Accounts;
+  sessions: Sessions;
+  users: Users;
+  verification: Verification;
+}

src/db/types.gen.ts

@@ -1,52 +1 @@
-export interface Database {
-  users: UsersTable
-  sessions: SessionsTable
-  accounts: AccountsTable
-  verification: VerificationTable
-}
-
-export interface UsersTable {
-  id: string
-  name: string
-  email: string
-  email_verified: number
-  image: string | null
-  created_at: number
-  updated_at: number
-}
-
-export interface SessionsTable {
-  id: string
-  expires_at: number
-  token: string
-  created_at: number
-  updated_at: number
-  ip_address: string | null
-  user_agent: string | null
-  user_id: string
-}
-
-export interface AccountsTable {
-  id: string
-  account_id: string
-  provider_id: string
-  user_id: string
-  access_token: string | null
-  refresh_token: string | null
-  id_token: string | null
-  access_token_expires_at: number | null
-  refresh_token_expires_at: number | null
-  scope: string | null
-  password: string | null
-  created_at: number
-  updated_at: number
-}
-
-export interface VerificationTable {
-  id: string
-  identifier: string
-  value: string
-  expires_at: number
-  created_at: number
-  updated_at: number
-}
+export type { DB as Database } from "./types.gen"