@bungres/kit 0.3.0 → 0.5.0

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@bungres/kit",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI toolkit for @bungres/orm — migrate, push, generate, pull",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0",
+    "bun": ">=1.3.0"
+  },
   "type": "module",
   "bin": {
     "bungres": "./dist/cli.js"
@@ -17,7 +22,6 @@
   },
   "files": [
     "dist",
-    "src",
     "README.md",
     "LICENSE"
   ],
@@ -25,8 +29,20 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/bungres/bungres.git",
-    "directory": "packages/@bungres/kit"
+    "directory": "packages/bungres-kit"
+  },
+  "bugs": {
+    "url": "https://github.com/bungres/bungres/issues"
   },
+  "homepage": "https://github.com/bungres/bungres#readme",
+  "keywords": [
+    "bun",
+    "postgres",
+    "orm",
+    "cli",
+    "migration",
+    "generator"
+  ],
   "scripts": {
     "build:types": "tsc --emitDeclarationOnly",
     "build": "bun build ./src/cli.ts ./src/index.ts --outdir ./dist --target bun --format esm && npm run build:types",
@@ -34,7 +50,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@bungres/orm": "0.2.0"
+    "@bungres/orm": "workspace:*"
   },
   "devDependencies": {
     "bun-types": "latest",

package/src/cli.ts

@@ -1,162 +0,0 @@
-#!/usr/bin/env bun
-// ---------------------------------------------------------------------------
-// @bungres/kit CLI — entry point
-// Usage: bungres <command> [options]
-// ---------------------------------------------------------------------------
-
-import { loadConfig } from "./config.js";
-import { runPush } from "./commands/push.js";
-import { runGenerate } from "./commands/generate.js";
-import { runMigrate } from "./commands/migrate.js";
-import { runPull } from "./commands/pull.js";
-import { runStatus } from "./commands/status.js";
-import { runDrop } from "./commands/drop.js";
-import { runFresh } from "./commands/fresh.js";
-import { runRefresh } from "./commands/refresh.js";
-import { runSeed } from "./commands/seed.js";
-import { runStudio } from "./commands/studio.js";
-import { runTusky } from "./commands/tusky.js";
-import { ensureDatabase } from "./ensure-db.js";
-import { colorize } from "./utils/colors.js";
-
-const VERSION = "0.0.1";
-
-const HELP = `
-${colorize("🐘 Bungres ORM CLI", "cyan")} v${VERSION}
-
-${colorize("Usage:", "yellow")}
-  bungres <command> [options]
-
-${colorize("Commands:", "yellow")}
-  generate      Generate SQL migration files from your schema definitions
-  migrate       Run pending migration files against the database
-  push          Apply schema directly to the DB (no migration files, dev mode)
-  pull          Introspect the database and generate TypeScript schema
-  status        Show applied vs. pending migrations
-  fresh         Drop all tables and re-run all migrations from scratch
-  refresh       Truncate all tables to quickly reset data without dropping schema
-  seed          Execute the seed script to populate the database
-  studio        Start a local web interface to browse database data
-  tusky         Boot up a Node REPL connected to the database with schema loaded
-  drop          Drop all tables defined in the schema (dev only)
-
-${colorize("Options:", "yellow")}
-  --config      Path to config file (default: bungres.config.ts)
-  --verbose     Enable verbose SQL logging
-  --force       Skip confirmation prompts (use with drop)
-  --version     Show version
-  --help        Show this help
-
-${colorize("Examples:", "yellow")}
-  bungres generate
-  bungres migrate
-  bungres push
-  bungres pull
-  bungres status
-  bungres fresh
-  bungres refresh
-  bungres seed
-  bungres studio
-  bungres tusky
-  bungres drop --force
-`.trim();
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
-    console.log(HELP);
-    process.exit(0);
-  }
-
-  if (args.includes("--version") || args.includes("-v")) {
-    console.log(`@bungres/kit v${VERSION}`);
-    process.exit(0);
-  }
-
-  const command = args[0];
-  const flags = parseFlags(args.slice(1));
-
-  const config = await loadConfig(process.cwd());
-
-  // Override verbose from flag
-  if (flags.verbose) config.verbose = true;
-
-  if (command && ["migrate", "push", "drop", "status", "fresh", "refresh"].includes(command)) {
-    await ensureDatabase(config.dbUrl);
-  }
-
-  switch (command) {
-    case "generate":
-      await runGenerate(config, flags.name as string | undefined);
-      break;
-
-    case "migrate":
-      await runMigrate(config);
-      break;
-
-    case "push":
-      await runPush(config, { force: !!flags.force });
-      break;
-
-    case "pull":
-      await runPull(config);
-      break;
-
-    case "status":
-      await runStatus(config);
-      break;
-
-    case "drop":
-      await runDrop(config, { force: !!flags.force });
-      break;
-
-    case "fresh":
-      await runFresh(config);
-      break;
-
-    case "refresh":
-      await runRefresh(config);
-      break;
-
-    case "seed":
-      await runSeed(config);
-      break;
-
-    case "studio":
-      await runStudio(config);
-      break;
-
-    case "tusky":
-      await runTusky(config);
-      break;
-
-    default:
-      console.error(`Unknown command: ${command}\n`);
-      console.log(HELP);
-      process.exit(1);
-  }
-}
-
-function parseFlags(args: string[]): Record<string, boolean | string> {
-  const flags: Record<string, boolean | string> = {};
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg?.startsWith("--")) {
-      const key = arg.slice(2);
-      const next = args[i + 1];
-      if (next && !next.startsWith("--")) {
-        flags[key] = next;
-        i++;
-      } else {
-        flags[key] = true;
-      }
-    }
-  }
-  return flags;
-}
-
-main().catch((err) => {
-  console.error("@bungres/kit error:", err instanceof Error ? err.message : err);
-  process.exit(1);
-});

package/src/commands/drop.ts

@@ -1,92 +0,0 @@
-import { generateDropTable } from "@bungres/orm";
-import type { ResolvedConfig } from "../config.js";
-import { loadSchemas } from "../schema-loader.js";
-import { colorize } from "../utils/colors.js";
-
-// ---------------------------------------------------------------------------
-// drop — drop all tables defined in the schema (dev utility)
-// Always prompts for confirmation unless --force is passed
-// ---------------------------------------------------------------------------
-
-export async function runDrop(
-  config: ResolvedConfig,
-  opts: { force?: boolean } = {}
-): Promise<void> {
-  const schemas = await loadSchemas(config.schema);
-
-  if (schemas.length === 0) {
-    console.warn("No table definitions found in schema files.");
-    return;
-  }
-
-  const sql = new Bun.SQL(config.dbUrl);
-
-  try {
-    // Check which tables actually exist in the database
-    const existingTablesResult = await sql`
-      SELECT table_name 
-      FROM information_schema.tables 
-      WHERE table_schema = 'public' OR table_schema = current_schema()
-    `;
-    const existingTableNames = new Set(
-      existingTablesResult.map((row: any) => row.table_name)
-    );
-
-    // Also track the migration and push tables since they are dropped too
-    const migrationTableExists = existingTableNames.has("__bungres_migrations");
-    const pushTableExists = existingTableNames.has("__bungres_push");
-
-    // Filter our schema list to only those that exist in the DB
-    const tablesToDrop = schemas.filter((s) => existingTableNames.has(s.config.name));
-
-    if (tablesToDrop.length === 0 && !migrationTableExists && !pushTableExists) {
-      console.log("No tables to drop (they either don't exist or were already dropped).");
-      return;
-    }
-
-    const tableNamesToPrint = tablesToDrop.map(
-      (s) => (s.config.schema ? s.config.schema + "." : "") + s.config.name
-    );
-    if (migrationTableExists) {
-      tableNamesToPrint.push("__bungres_migrations");
-    }
-    if (pushTableExists) {
-      tableNamesToPrint.push("__bungres_push");
-    }
-
-    if (!opts.force) {
-      console.warn(colorize("\n⚠️  WARNING: This will drop the following tables and ALL their data:\n", "red"));
-      for (const name of tableNamesToPrint) console.log(colorize(`  - ${name}`, "yellow"));
-      process.stdout.write(colorize("\nAre you sure? Type YES to continue: ", "cyan"));
-
-      // Read confirmation from stdin using Bun's native console iterator
-      for await (const line of console) {
-        if (line.trim().toLowerCase() !== "yes") {
-          console.log("Aborted.");
-          return;
-        }
-        break; // break loop after reading the first line
-      }
-    }
-
-    for (const entry of tablesToDrop) {
-      const ddl = `DROP TABLE IF EXISTS "${entry.config.name}" CASCADE;`;
-      await sql.unsafe(ddl);
-      console.log(colorize(`  ✓ dropped ${entry.config.name}`, "green"));
-    }
-
-    if (migrationTableExists) {
-      await sql.unsafe("DROP TABLE IF EXISTS public.__bungres_migrations CASCADE");
-      console.log(colorize(`  ✓ dropped __bungres_migrations`, "green"));
-    }
-
-    if (pushTableExists) {
-      await sql.unsafe("DROP TABLE IF EXISTS public.__bungres_push CASCADE");
-      console.log(colorize(`  ✓ dropped __bungres_push`, "green"));
-    }
-
-    console.log(colorize("\nDrop complete.", "green"));
-  } finally {
-    await sql.end();
-  }
-}

package/src/commands/fresh.ts

@@ -1,17 +0,0 @@
-import type { ResolvedConfig } from "../config.js";
-import { runDrop } from "./drop.js";
-import { runMigrate } from "./migrate.js";
-
-// ---------------------------------------------------------------------------
-// fresh — drop all tables and re-run all migrations from scratch
-// ---------------------------------------------------------------------------
-
-export async function runFresh(config: ResolvedConfig): Promise<void> {
-  console.log("Dropping all tables...");
-  await runDrop(config, { force: true });
-  
-  console.log("\nRe-running migrations...");
-  await runMigrate(config);
-  
-  console.log("\nFresh complete.");
-}

package/src/commands/generate.ts

@@ -1,151 +0,0 @@
-import { join, resolve } from "node:path";
-import { generateCreateTable } from "@bungres/orm";
-import type { TableConfig } from "@bungres/orm";
-import type { ResolvedConfig } from "../config.js";
-import { loadSchemas, type SchemaEntry } from "../schema-loader.js";
-import { diffSchemas, type SchemaSnapshot } from "../differ.js";
-import { colorize } from "../utils/colors.js";
-
-// ---------------------------------------------------------------------------
-// generate — diff-based SQL migration generator (drizzle-style numbering)
-//
-// First run:  full CREATE TABLE for every table  → 0001_init.sql
-// Later runs: only the changes (ADD COLUMN, CREATE TABLE, etc.) → 0002_*.sql
-//
-// Schema state is tracked in <migrationsDir>/.snapshot.json
-// ---------------------------------------------------------------------------
-
-const SNAPSHOT_FILE = ".snapshot.json";
-
-export async function runGenerate(
-  config: ResolvedConfig,
-  name?: string
-): Promise<void> {
-  console.log("@bungres/kit generate: loading schemas...");
-
-  const schemas = await loadSchemas(config.schema);
-
-  if (schemas.length === 0) {
-    console.warn(colorize("No table definitions found. Check your schema glob pattern.", "yellow"));
-    return;
-  }
-
-  const migrationsDir = resolve(config.migrationsDir);
-  await Bun.$`mkdir -p ${migrationsDir}`.quiet();
-
-  // ── Build current snapshot from loaded schemas ────────────────────────────
-  const currentSnapshot: SchemaSnapshot = Object.fromEntries(
-    schemas.map((s) => [s.config.name, s.config])
-  );
-
-  // ── Load previous snapshot (if any) ──────────────────────────────────────
-  const snapshotPath = join(migrationsDir, SNAPSHOT_FILE);
-  const snapshotFile = Bun.file(snapshotPath);
-  const isFirstMigration = !(await snapshotFile.exists());
-  const prevSnapshot: SchemaSnapshot = isFirstMigration
-    ? {}
-    : (JSON.parse(await snapshotFile.text()) as SchemaSnapshot);
-
-  // ── Determine next sequence number ───────────────────────────────────────
-  const now = new Date();
-  const yyyy = now.getUTCFullYear();
-  const mm = String(now.getUTCMonth() + 1).padStart(2, "0");
-  const dd = String(now.getUTCDate()).padStart(2, "0");
-  const HH = String(now.getUTCHours()).padStart(2, "0");
-  const MM = String(now.getUTCMinutes()).padStart(2, "0");
-  const SS = String(now.getUTCSeconds()).padStart(2, "0");
-  
-  const prefix = `${yyyy}_${mm}_${dd}_${HH}${MM}${SS}`;
-  const filename = name ? `${prefix}_${name}.sql` : `${prefix}.sql`;
-  const outPath = join(migrationsDir, filename);
-
-  // ── Diff ──────────────────────────────────────────────────────────────────
-  let statements: string[];
-  let summary: string[];
-  let warnings: string[] = [];
-
-  if (isFirstMigration) {
-    // First migration — full schema sorted by FK dependency order
-    const sorted = topoSort(schemas);
-    statements = [
-      `CREATE EXTENSION IF NOT EXISTS "pgcrypto";`,
-      ``,
-      ...sorted.flatMap((entry) => [
-        `-- ${entry.exportName}`,
-        generateCreateTable(entry.config, true),
-        ``,
-      ]),
-    ];
-    summary = sorted.map((s) => `CREATE TABLE ${s.config.name}`);
-  } else {
-    // Subsequent migrations — diff only
-    const diff = diffSchemas(prevSnapshot, currentSnapshot);
-
-    if (diff.statements.length === 0) {
-      console.log(colorize("\nNo schema changes detected. Nothing to generate.", "yellow"));
-      return;
-    }
-
-    statements = diff.statements;
-    summary = diff.summary;
-    warnings = diff.warnings;
-  }
-
-  // ── Write migration file ──────────────────────────────────────────────────
-  const lines: string[] = [
-    `-- Migration: ${filename}`,
-    `-- Generated by @bungres/kit at ${new Date().toISOString()}`,
-    `-- Changes: ${summary.join(", ")}`,
-    ``,
-    ...statements,
-  ];
-
-  await Bun.write(outPath, lines.join("\n"));
-
-  // ── Save updated snapshot ─────────────────────────────────────────────────
-  await Bun.write(snapshotPath, JSON.stringify(currentSnapshot, null, 2));
-
-  console.log(colorize(`\nGenerated: ${outPath}`, "green"));
-  console.log(`  Changes:`);
-  for (const s of summary) console.log(colorize(`    + ${s}`, "cyan"));
-
-  if (warnings.length > 0) {
-    console.warn(colorize(`\n  ⚠️  WARNING: Data Loss Detected!`, "red"));
-    for (const w of warnings) console.warn(colorize(`    ! ${w}`, "red"));
-    console.warn(colorize(`  Please review the generated migration carefully before applying it.\n`, "yellow"));
-  }
-
-  console.log(colorize(`\nRun \`bungres migrate\` to apply it.`, "cyan"));
-}
-
-// ---------------------------------------------------------------------------
-// Topological sort — referenced tables come before dependents
-// ---------------------------------------------------------------------------
-
-function topoSort(schemas: SchemaEntry[]): SchemaEntry[] {
-  const byName = new Map<string, SchemaEntry>(
-    schemas.map((s) => [s.config.name, s])
-  );
-
-  function deps(config: TableConfig): string[] {
-    return Object.values(config.columns)
-      .map((col) => col.references?.table)
-      .filter((t): t is string => t !== undefined && byName.has(t) && t !== config.name);
-  }
-
-  const visited = new Set<string>();
-  const result: SchemaEntry[] = [];
-
-  function visit(name: string): void {
-    if (visited.has(name)) return;
-    visited.add(name);
-    const entry = byName.get(name);
-    if (!entry) return;
-    for (const dep of deps(entry.config)) visit(dep);
-    result.push(entry);
-  }
-
-  for (const schema of schemas) visit(schema.config.name);
-
-  return result;
-}

package/src/commands/migrate.ts

@@ -1,84 +0,0 @@
-import { join, resolve } from "node:path";
-import type { ResolvedConfig } from "../config.js";
-import { colorize } from "../utils/colors.js";
-
-// ---------------------------------------------------------------------------
-// migrate — run pending .sql files, track applied in __bungres_migrations
-// ---------------------------------------------------------------------------
-
-const MIGRATIONS_TABLE = "__bungres_migrations";
-
-const CREATE_MIGRATIONS_TABLE = `
-CREATE TABLE IF NOT EXISTS "${MIGRATIONS_TABLE}" (
-  id          SERIAL PRIMARY KEY,
-  name        TEXT NOT NULL UNIQUE,
-  applied_at  TIMESTAMPTZ NOT NULL DEFAULT NOW()
-);
-`.trim();
-
-export async function runMigrate(config: ResolvedConfig): Promise<void> {
-  const migrationsDir = resolve(config.migrationsDir);
-  const sql = new Bun.SQL(config.dbUrl);
-
-  try {
-    // Ensure tracking table exists
-    await sql.unsafe(CREATE_MIGRATIONS_TABLE);
-
-    // Discover migration files in order
-    const glob = new Bun.Glob("*.sql");
-    const files: string[] = [];
-    for await (const file of glob.scan({ cwd: migrationsDir, absolute: false })) {
-      files.push(file);
-    }
-    files.sort(); // 0001_ < 0002_ etc.
-
-    if (files.length === 0) {
-      console.log(colorize("No migration files found in " + migrationsDir, "yellow"));
-      console.log(colorize("Run `bungres generate` first.", "yellow"));
-      return;
-    }
-
-    // Fetch already applied
-    const applied = await sql.unsafe(`SELECT name FROM "${MIGRATIONS_TABLE}"`);
-    const appliedSet = new Set((applied as { name: string }[]).map((r) => r.name));
-
-    const pending = files.filter((f) => !appliedSet.has(f));
-
-    if (pending.length === 0) {
-      console.log(colorize("Everything is up to date.", "green"));
-      return;
-    }
-
-    console.log(colorize(`\nRunning ${pending.length} pending migration(s)...\n`, "cyan"));
-
-    for (const file of pending) {
-      const content = await Bun.file(join(migrationsDir, file)).text();
-
-      if (config.verbose) {
-        console.log(`-- ${file} --\n${content}\n`);
-      }
-
-      await sql.transaction(async (txSql: InstanceType<typeof Bun.SQL>) => {
-        const statements = content
-          .split(";")
-          .map((s) => s.trim())
-          .filter(Boolean);
-
-        for (const stmt of statements) {
-          await txSql.unsafe(stmt + ";");
-        }
-
-        await txSql.unsafe(
-          `INSERT INTO "${MIGRATIONS_TABLE}" (name) VALUES ($1)`,
-          [file]
-        );
-      });
-
-      console.log(colorize(`  ✓  ${file}`, "green"));
-    }
-
-    console.log(colorize("\nDone.", "green"));
-  } finally {
-    await sql.end();
-  }
-}