turbine-orm 0.5.0 → 0.7.1

package/dist/cjs/cli/index.js

@@ -56,13 +56,14 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const introspect_js_1 = require("../introspect.js");
+const node_url_1 = require("node:url");
 const generate_js_1 = require("../generate.js");
+const introspect_js_1 = require("../introspect.js");
 const schema_sql_js_1 = require("../schema-sql.js");
 const config_js_1 = require("./config.js");
+const loader_js_1 = require("./loader.js");
 const migrate_js_1 = require("./migrate.js");
 const ui_js_1 = require("./ui.js");
-const node_url_1 = require("node:url");
 function parseArgs() {
     const args = process.argv.slice(2);
     const result = {
@@ -110,6 +111,12 @@ function parseArgs() {
             case '--dry-run':
                 result.dryRun = true;
                 break;
+            case '--auto':
+                result.auto = true;
+                break;
+            case '--allow-drift':
+                result.allowDrift = true;
+                break;
             case '--force':
             case '-f':
                 result.force = true;
@@ -118,6 +125,10 @@ function parseArgs() {
             case '-v':
                 result.verbose = true;
                 break;
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
             default:
                 if (!arg.startsWith('-')) {
                     result.positional.push(arg);
@@ -128,6 +139,36 @@ function parseArgs() {
     return result;
 }
 // ---------------------------------------------------------------------------
+// TypeScript loader — user-facing error helper
+// ---------------------------------------------------------------------------
+/**
+ * Print a friendly error explaining how to install tsx, then exit.
+ * Called when we know we need to load a `.ts` file but the loader isn't available.
+ */
+function failMissingTsLoader(filePath, reason) {
+    (0, ui_js_1.newline)();
+    (0, ui_js_1.error)(`Cannot load TypeScript file: ${filePath}`);
+    (0, ui_js_1.newline)();
+    if (reason === 'unsupported') {
+        console.log(`  ${(0, ui_js_1.dim)('Your Node.js version does not support')} ${(0, ui_js_1.cyan)('module.register()')}.`);
+        console.log(`  ${(0, ui_js_1.dim)('Upgrade to Node.js')} ${(0, ui_js_1.cyan)('20.6+')} ${(0, ui_js_1.dim)('or use a')} ${(0, ui_js_1.cyan)('.js')} ${(0, ui_js_1.dim)('/')} ${(0, ui_js_1.cyan)('.mjs')} ${(0, ui_js_1.dim)('config file.')}`);
+    }
+    else {
+        console.log(`  ${(0, ui_js_1.dim)('Loading .ts config / schema files requires')} ${(0, ui_js_1.cyan)('tsx')} ${(0, ui_js_1.dim)('to be installed.')}`);
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('Install it as a dev dependency:')}`);
+        console.log(`    ${(0, ui_js_1.cyan)('npm install --save-dev tsx')}`);
+        console.log(`    ${(0, ui_js_1.dim)('or')}`);
+        console.log(`    ${(0, ui_js_1.cyan)('pnpm add -D tsx')}`);
+        console.log(`    ${(0, ui_js_1.dim)('or')}`);
+        console.log(`    ${(0, ui_js_1.cyan)('yarn add -D tsx')}`);
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('Alternatively, rename your file to')} ${(0, ui_js_1.cyan)('.js')} ${(0, ui_js_1.dim)('or')} ${(0, ui_js_1.cyan)('.mjs')}.`);
+    }
+    (0, ui_js_1.newline)();
+    process.exit(1);
+}
+// ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
 function requireUrl(config) {
@@ -150,6 +191,15 @@ async function loadSchemaFile(schemaFile) {
         console.log(`  ${(0, ui_js_1.dim)('Create one with:')} ${(0, ui_js_1.cyan)('turbine init')}`);
         process.exit(1);
     }
+    // If this is a TypeScript file, ensure the tsx ESM loader is registered
+    // before we attempt the dynamic import. Without this, Node throws
+    // ERR_UNKNOWN_FILE_EXTENSION for `.ts`.
+    if ((0, loader_js_1.needsTsLoader)(absPath)) {
+        const status = await (0, loader_js_1.registerTsLoader)();
+        if (status === 'missing' || status === 'unsupported') {
+            failMissingTsLoader(schemaFile, status);
+        }
+    }
     try {
         const fileUrl = (0, node_url_1.pathToFileURL)(absPath).href;
         const mod = await Promise.resolve(`${fileUrl}`).then(s => __importStar(require(s)));
@@ -164,6 +214,11 @@ async function loadSchemaFile(schemaFile) {
         (0, ui_js_1.error)(`Failed to load schema file: ${schemaFile}`);
         if (err instanceof Error) {
             console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+            // If the error is the classic ERR_UNKNOWN_FILE_EXTENSION, give a hint.
+            if (err.message.includes('ERR_UNKNOWN_FILE_EXTENSION') || err.message.includes('Unknown file extension')) {
+                (0, ui_js_1.newline)();
+                console.log(`  ${(0, ui_js_1.dim)('Hint: install')} ${(0, ui_js_1.cyan)('tsx')} ${(0, ui_js_1.dim)('to load .ts files:')} ${(0, ui_js_1.cyan)('npm install --save-dev tsx')}`);
+            }
         }
         process.exit(1);
     }
@@ -175,7 +230,7 @@ async function cmdInit(args, config) {
     (0, ui_js_1.banner)();
     (0, ui_js_1.header)('Initializing Turbine project');
     // Detect environment
-    const envUrl = process.env['DATABASE_URL'];
+    const envUrl = process.env.DATABASE_URL;
     const hasEnvFile = (0, node_fs_1.existsSync)('.env');
     const hasEnvLocal = (0, node_fs_1.existsSync)('.env.local');
     if (envUrl) {
@@ -214,7 +269,7 @@ async function cmdInit(args, config) {
         (0, node_fs_1.mkdirSync)(migrDir, { recursive: true });
         // Create .gitkeep
         (0, node_fs_1.writeFileSync)(`${migrDir}/.gitkeep`, '', 'utf-8');
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(migrDir + '/')}`);
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(`${migrDir}/`)}`);
     }
     else {
         (0, ui_js_1.info)(`Migrations dir already exists: ${(0, ui_js_1.dim)(migrDir)}`);
@@ -222,7 +277,7 @@ async function cmdInit(args, config) {
     // Create output directory
     if (!(0, node_fs_1.existsSync)(config.out)) {
         (0, node_fs_1.mkdirSync)(config.out, { recursive: true });
-        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(config.out + '/')}`);
+        (0, ui_js_1.success)(`Created ${(0, ui_js_1.cyan)(`${config.out}/`)}`);
     }
     // Create seed file template
     const seedDir = config.seedFile.substring(0, config.seedFile.lastIndexOf('/'));
@@ -266,7 +321,7 @@ async function cmdInit(args, config) {
  * Define your database schema in TypeScript.
  * Use \`npx turbine push\` to sync it to your database.
  *
- * @see https://batadata.com/docs/turbine/schema
+ * @see https://turbineorm.dev
  */
 
 import { defineSchema } from 'turbine-orm';
@@ -317,15 +372,15 @@ export default defineSchema({
             spinner.succeed(`Found ${(0, ui_js_1.bold)(String(tableCount))} tables`);
             const genSpinner = new ui_js_1.Spinner('Generating TypeScript client').start();
             const result = (0, generate_js_1.generate)({ schema, outDir: config.out, connectionString: url });
-            genSpinner.succeed(`Generated ${(0, ui_js_1.bold)(String(result.files.length))} files to ${(0, ui_js_1.cyan)(config.out + '/')}`);
+            genSpinner.succeed(`Generated ${(0, ui_js_1.bold)(String(result.files.length))} files to ${(0, ui_js_1.cyan)(`${config.out}/`)}`);
         }
         catch (err) {
             spinner.fail('Could not connect to database');
             if (err instanceof Error) {
-                console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
             }
             (0, ui_js_1.newline)();
-            (0, ui_js_1.info)('You can run generation later with: ' + (0, ui_js_1.cyan)('npx turbine generate'));
+            (0, ui_js_1.info)(`You can run generation later with: ${(0, ui_js_1.cyan)('npx turbine generate')}`);
         }
     }
     // Next steps
@@ -401,7 +456,7 @@ async function cmdGenerate(args, config) {
     genSpinner.succeed(`Generated ${(0, ui_js_1.bold)(String(result.files.length))} files in ${(0, ui_js_1.elapsed)(startTime)}`);
     // List files
     for (const file of result.files) {
-        console.log(`    ${(0, ui_js_1.dim)(ui_js_1.symbols.teeEnd)} ${(0, ui_js_1.cyan)(result.outDir + '/' + file)}`);
+        console.log(`    ${(0, ui_js_1.dim)(ui_js_1.symbols.teeEnd)} ${(0, ui_js_1.cyan)(`${result.outDir}/${file}`)}`);
     }
     // Usage hint
     (0, ui_js_1.newline)();
@@ -449,9 +504,11 @@ async function cmdPush(args, config) {
         for (const a of diff.alter) {
             console.log(`    ${(0, ui_js_1.yellow)(ui_js_1.symbols.arrowRight)} ${a.table}`);
             for (const col of a.columns) {
-                const actionLabel = col.action === 'add' ? (0, ui_js_1.green)('+ add') :
-                    col.action === 'drop' ? (0, ui_js_1.red)('- drop') :
-                        (0, ui_js_1.yellow)('~ ' + col.action.replace('_', ' '));
+                const actionLabel = col.action === 'add'
+                    ? (0, ui_js_1.green)('+ add')
+                    : col.action === 'drop'
+                        ? (0, ui_js_1.red)('- drop')
+                        : (0, ui_js_1.yellow)(`~ ${col.action.replace('_', ' ')}`);
                 console.log(`      ${actionLabel} ${col.column}`);
             }
         }
@@ -505,17 +562,21 @@ async function cmdMigrate(args, config) {
         console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} ${(0, ui_js_1.dim)('— SQL-first migration system')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.bold)('Commands:')}`);
-        console.log(`    ${(0, ui_js_1.cyan)('create <name>')}  Create a new migration file`);
-        console.log(`    ${(0, ui_js_1.cyan)('up')}             Apply pending migrations`);
-        console.log(`    ${(0, ui_js_1.cyan)('down')}           Rollback last migration`);
-        console.log(`    ${(0, ui_js_1.cyan)('status')}         Show migration status`);
+        console.log(`    ${(0, ui_js_1.cyan)('create <name>')}         Create a new migration file`);
+        console.log(`    ${(0, ui_js_1.cyan)('create <name> --auto')}  Auto-generate from schema diff`);
+        console.log(`    ${(0, ui_js_1.cyan)('up')}                    Apply pending migrations`);
+        console.log(`    ${(0, ui_js_1.cyan)('down')}                  Rollback last migration`);
+        console.log(`    ${(0, ui_js_1.cyan)('status')}                Show migration status`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
-        console.log(`    ${(0, ui_js_1.cyan)('--step, -n')}     Number of migrations to apply/rollback`);
-        console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}      Show SQL without executing`);
+        console.log(`    ${(0, ui_js_1.cyan)('--auto')}           Auto-generate UP/DOWN SQL from schema diff`);
+        console.log(`    ${(0, ui_js_1.cyan)('--step, -n')}       Number of migrations to apply/rollback`);
+        console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}        Show SQL without executing`);
+        console.log(`    ${(0, ui_js_1.cyan)('--allow-drift')}    Bypass checksum validation on ${(0, ui_js_1.cyan)('migrate up')} ${(0, ui_js_1.dim)('(advanced)')}`);
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.bold)('Examples:')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate create add_users_table')}`);
+        console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate create add_email_index --auto')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate up')}`);
         console.log(`    ${(0, ui_js_1.dim)('npx turbine migrate down --step 2')}`);
         (0, ui_js_1.newline)();
@@ -549,9 +610,61 @@ async function cmdMigrateCreate(args, config) {
         (0, ui_js_1.newline)();
         console.log(`  ${(0, ui_js_1.dim)('Usage:')} ${(0, ui_js_1.cyan)('npx turbine migrate create <name>')}`);
         console.log(`  ${(0, ui_js_1.dim)('Example:')} ${(0, ui_js_1.cyan)('npx turbine migrate create add_users_table')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Auto:')}    ${(0, ui_js_1.cyan)('npx turbine migrate create my_change --auto')}`);
         (0, ui_js_1.newline)();
         process.exit(1);
     }
+    if (args.auto) {
+        // Auto-generate migration from schema diff
+        const url = requireUrl(config);
+        (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
+        (0, ui_js_1.label)('Schema file', config.schemaFile);
+        (0, ui_js_1.newline)();
+        const schemaDef = await loadSchemaFile(config.schemaFile);
+        const diffSpinner = new ui_js_1.Spinner('Computing schema diff').start();
+        const diff = await (0, schema_sql_js_1.schemaDiff)(schemaDef, url);
+        if (diff.statements.length === 0) {
+            diffSpinner.succeed('Database is already in sync — nothing to migrate');
+            (0, ui_js_1.newline)();
+            return;
+        }
+        diffSpinner.succeed(`Found ${(0, ui_js_1.bold)(String(diff.statements.length))} change(s)`);
+        (0, ui_js_1.newline)();
+        const upSQL = diff.statements.join('\n');
+        const downSQL = diff.reverseStatements.join('\n');
+        const file = (0, migrate_js_1.createMigration)(config.migrationsDir, name, { up: upSQL, down: downSQL });
+        const relPath = (0, node_path_1.relative)(process.cwd(), file.path);
+        (0, ui_js_1.success)(`Created auto-migration: ${(0, ui_js_1.bold)(file.filename)}`);
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('File:')} ${(0, ui_js_1.cyan)(relPath)}`);
+        (0, ui_js_1.newline)();
+        // Show summary of changes
+        if (diff.create.length > 0) {
+            console.log(`  ${(0, ui_js_1.green)('+ Create')} ${diff.create.length} table(s): ${diff.create.map((t) => t.name).join(', ')}`);
+        }
+        if (diff.alter.length > 0) {
+            console.log(`  ${(0, ui_js_1.yellow)('~ Alter')} ${diff.alter.length} table(s):`);
+            for (const a of diff.alter) {
+                for (const col of a.columns) {
+                    const actionLabel = col.action === 'add'
+                        ? (0, ui_js_1.green)('+ add')
+                        : col.action === 'drop'
+                            ? (0, ui_js_1.red)('- drop')
+                            : col.action === 'add_unique'
+                                ? (0, ui_js_1.green)('+ unique')
+                                : col.action === 'drop_unique'
+                                    ? (0, ui_js_1.red)('- unique')
+                                    : (0, ui_js_1.yellow)(`~ ${col.action.replace(/_/g, ' ')}`);
+                    console.log(`    ${actionLabel} ${a.table}.${col.column}`);
+                }
+            }
+        }
+        (0, ui_js_1.newline)();
+        console.log(`  ${(0, ui_js_1.dim)('Review the migration, then run:')}`);
+        console.log(`  ${(0, ui_js_1.cyan)('npx turbine migrate up')}`);
+        (0, ui_js_1.newline)();
+        return;
+    }
     const file = (0, migrate_js_1.createMigration)(config.migrationsDir, name);
     const relPath = (0, node_path_1.relative)(process.cwd(), file.path);
     (0, ui_js_1.success)(`Created migration: ${(0, ui_js_1.bold)(file.filename)}`);
@@ -575,9 +688,18 @@ async function cmdMigrateUp(args, config) {
         (0, ui_js_1.newline)();
         return;
     }
+    // Big, loud warning when bypassing drift detection — this is a deliberately
+    // dangerous operation and the user should see it on every invocation.
+    if (args.allowDrift) {
+        (0, ui_js_1.warn)('--allow-drift is set — checksum validation is DISABLED for this run.');
+        console.log(`  ${(0, ui_js_1.dim)('Applied migrations may have been modified or deleted on disk.')}`);
+        console.log(`  ${(0, ui_js_1.dim)('Proceed only if you are intentionally rewriting migration history.')}`);
+        (0, ui_js_1.newline)();
+    }
     const spinner = new ui_js_1.Spinner('Applying migrations').start();
     const result = await (0, migrate_js_1.migrateUp)(url, config.migrationsDir, {
         step: args.step,
+        allowDrift: args.allowDrift,
     });
     if (result.applied.length === 0 && result.errors.length === 0) {
         spinner.succeed('All migrations are up to date');
@@ -633,7 +755,7 @@ async function cmdMigrateDown(args, config) {
     }
     (0, ui_js_1.newline)();
 }
-async function cmdMigrateStatus(args, config) {
+async function cmdMigrateStatus(_args, config) {
     (0, ui_js_1.banner)();
     const url = requireUrl(config);
     (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
@@ -663,19 +785,22 @@ async function cmdMigrateStatus(args, config) {
     const rows = statuses.map((s) => {
         let status;
         if (s.applied && s.checksumValid === false) {
-            status = (0, ui_js_1.red)(ui_js_1.symbols.warning + ' Drifted');
+            status = (0, ui_js_1.red)(`${ui_js_1.symbols.warning} Drifted`);
         }
         else if (s.applied) {
-            status = (0, ui_js_1.green)(ui_js_1.symbols.check + ' Applied');
+            status = (0, ui_js_1.green)(`${ui_js_1.symbols.check} Applied`);
         }
         else {
-            status = (0, ui_js_1.yellow)(ui_js_1.symbols.dot + ' Pending');
+            status = (0, ui_js_1.yellow)(`${ui_js_1.symbols.dot} Pending`);
         }
         return [
             status,
             s.file.filename,
             s.appliedAt
-                ? (0, ui_js_1.dim)(s.appliedAt.toISOString().replace('T', ' ').replace(/\.\d+Z$/, ' UTC'))
+                ? (0, ui_js_1.dim)(s.appliedAt
+                    .toISOString()
+                    .replace('T', ' ')
+                    .replace(/\.\d+Z$/, ' UTC'))
                 : (0, ui_js_1.dim)('—'),
         ];
     });
@@ -689,7 +814,7 @@ async function cmdMigrateStatus(args, config) {
 // ---------------------------------------------------------------------------
 // Command: seed
 // ---------------------------------------------------------------------------
-async function cmdSeed(args, config) {
+async function cmdSeed(_args, config) {
     (0, ui_js_1.banner)();
     const seedFile = (0, node_path_1.resolve)(config.seedFile);
     (0, ui_js_1.label)('Seed file', config.seedFile);
@@ -705,22 +830,20 @@ async function cmdSeed(args, config) {
     const spinner = new ui_js_1.Spinner('Running seed file').start();
     try {
         // Use child_process to run the seed file via tsx or node
-        const { execSync } = await Promise.resolve().then(() => __importStar(require('node:child_process')));
+        const { execFileSync } = await Promise.resolve().then(() => __importStar(require('node:child_process')));
         // Try tsx first (most compatible with .ts files), fall back to node --experimental-strip-types
         const runners = [
-            { cmd: 'npx tsx', name: 'tsx' },
-            { cmd: 'node --experimental-strip-types', name: 'node' },
+            { cmd: 'npx', args: ['tsx', seedFile], name: 'tsx' },
+            { cmd: 'node', args: ['--experimental-strip-types', seedFile], name: 'node' },
         ];
-        // Shell-escape the seed file path to prevent injection
-        const escapedSeedFile = seedFile.replace(/'/g, "'\\''");
         let ran = false;
         for (const runner of runners) {
             try {
-                execSync(`${runner.cmd} '${escapedSeedFile}'`, {
+                execFileSync(runner.cmd, runner.args, {
                     stdio: 'inherit',
                     env: {
                         ...process.env,
-                        DATABASE_URL: config.url || process.env['DATABASE_URL'],
+                        DATABASE_URL: config.url || process.env.DATABASE_URL,
                     },
                 });
                 ran = true;
@@ -742,7 +865,7 @@ async function cmdSeed(args, config) {
     catch (err) {
         spinner.fail('Seed failed');
         if (err instanceof Error) {
-            console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+            console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
         }
         (0, ui_js_1.newline)();
         process.exit(1);
@@ -752,7 +875,7 @@ async function cmdSeed(args, config) {
 // ---------------------------------------------------------------------------
 // Command: status
 // ---------------------------------------------------------------------------
-async function cmdStatus(args, config) {
+async function cmdStatus(_args, config) {
     (0, ui_js_1.banner)();
     const url = requireUrl(config);
     (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
@@ -770,7 +893,7 @@ async function cmdStatus(args, config) {
     (0, ui_js_1.newline)();
     for (const tbl of Object.values(schema.tables)) {
         const relCount = Object.keys(tbl.relations).length;
-        const pk = tbl.primaryKey.join(', ') || (0, ui_js_1.dim)('(none)');
+        const _pk = tbl.primaryKey.join(', ') || (0, ui_js_1.dim)('(none)');
         console.log(`  ${(0, ui_js_1.bold)((0, ui_js_1.cyan)(tbl.name))}`);
         for (let i = 0; i < tbl.columns.length; i++) {
             const col = tbl.columns[i];
@@ -779,7 +902,7 @@ async function cmdStatus(args, config) {
             const nullable = col.nullable ? (0, ui_js_1.dim)('?') : '';
             const def = col.hasDefault ? (0, ui_js_1.dim)(' (default)') : '';
             const pkLabel = tbl.primaryKey.includes(col.name) ? ` ${(0, ui_js_1.magenta)('PK')}` : '';
-            console.log(`    ${(0, ui_js_1.dim)(prefix)} ${col.field}${nullable}: ${(0, ui_js_1.green)(col.tsType)}${pkLabel}${def}  ${(0, ui_js_1.gray)(ui_js_1.symbols.arrow + ' ' + col.pgType)}`);
+            console.log(`    ${(0, ui_js_1.dim)(prefix)} ${col.field}${nullable}: ${(0, ui_js_1.green)(col.tsType)}${pkLabel}${def}  ${(0, ui_js_1.gray)(`${ui_js_1.symbols.arrow} ${col.pgType}`)}`);
         }
         const rels = Object.entries(tbl.relations);
         if (rels.length > 0) {
@@ -812,11 +935,139 @@ async function cmdStudio(_args, _config) {
         'A local web UI for browsing your database,',
         'exploring relations, and managing data.',
         '',
-        `Follow ${(0, ui_js_1.cyan)('@batadata')} for updates.`,
+        `Follow ${(0, ui_js_1.cyan)('@turbineorm')} for updates.`,
     ].join('\n'), { title: (0, ui_js_1.bold)((0, ui_js_1.cyan)('Studio')), padding: 2 }));
     (0, ui_js_1.newline)();
 }
 // ---------------------------------------------------------------------------
+// Subcommand help
+// ---------------------------------------------------------------------------
+function showSubcommandHelp(command) {
+    const helpMap = {
+        init: showInitHelp,
+        generate: showGenerateHelp,
+        pull: showGenerateHelp,
+        push: showPushHelp,
+        migrate: showMigrateHelp,
+        migration: showMigrateHelp,
+        seed: showSeedHelp,
+        status: showStatusHelp,
+    };
+    const fn = helpMap[command];
+    if (fn) {
+        fn();
+        return true;
+    }
+    return false;
+}
+function showInitHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine init')} — Initialize a Turbine project`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine init ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Creates ${(0, ui_js_1.cyan)('turbine.config.ts')}, migrations directory, seed file template,`);
+    console.log(`  and schema file template.`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}   Postgres connection string to embed in config`);
+    console.log(`    ${(0, ui_js_1.cyan)('--force, -f')}        Overwrite existing config file`);
+    (0, ui_js_1.newline)();
+}
+function showGenerateHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine generate')} — Introspect database and generate TypeScript types`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine generate ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Connects to your database, reads the schema, and generates:`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('types.ts')}    — Entity interfaces, Create/Update input types`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('metadata.ts')} — Runtime schema metadata`);
+    console.log(`    ${(0, ui_js_1.dim)('•')} ${(0, ui_js_1.cyan)('index.ts')}    — Configured client with typed table accessors`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}       Postgres connection string`);
+    console.log(`    ${(0, ui_js_1.cyan)('--out, -o')} ${(0, ui_js_1.dim)('<dir>')}       Output directory ${(0, ui_js_1.dim)('(default: ./generated/turbine)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--schema, -s')} ${(0, ui_js_1.dim)('<name>')}   Postgres schema ${(0, ui_js_1.dim)('(default: public)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--include')} ${(0, ui_js_1.dim)('<tables>')}    Comma-separated tables to include`);
+    console.log(`    ${(0, ui_js_1.cyan)('--exclude')} ${(0, ui_js_1.dim)('<tables>')}    Comma-separated tables to exclude`);
+    (0, ui_js_1.newline)();
+}
+function showPushHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine push')} — Apply schema-builder definitions to database`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine push ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Reads your ${(0, ui_js_1.cyan)('turbine/schema.ts')} file, diffs against the live database,`);
+    console.log(`  and applies CREATE/ALTER statements.`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}   Postgres connection string`);
+    console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}          Show SQL without executing`);
+    console.log(`    ${(0, ui_js_1.cyan)('--verbose, -v')}      Show detailed output`);
+    (0, ui_js_1.newline)();
+}
+function showMigrateHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine migrate')} — SQL migration management`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine migrate ${(0, ui_js_1.cyan)('<subcommand>')} ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Subcommands:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('create')} ${(0, ui_js_1.dim)('<name>')}   Create a new migration file`);
+    console.log(`    ${(0, ui_js_1.cyan)('up')}              Apply pending migrations`);
+    console.log(`    ${(0, ui_js_1.cyan)('down')}            Rollback last migration`);
+    console.log(`    ${(0, ui_js_1.cyan)('status')}          Show applied/pending migrations`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}   Postgres connection string`);
+    console.log(`    ${(0, ui_js_1.cyan)('--step, -n')} ${(0, ui_js_1.dim)('<N>')}    Number of migrations to apply/rollback`);
+    console.log(`    ${(0, ui_js_1.cyan)('--dry-run')}          Show SQL without executing`);
+    console.log(`    ${(0, ui_js_1.cyan)('--allow-drift')}      Bypass checksum validation ${(0, ui_js_1.dim)('(migrate up only — advanced)')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--verbose, -v')}      Show detailed output`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Examples:')}`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate create add_users_table`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate up`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate down --step 2`);
+    console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate status`);
+    (0, ui_js_1.newline)();
+}
+function showSeedHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine seed')} — Run seed file`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine seed ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Runs the seed file specified in ${(0, ui_js_1.cyan)('turbine.config.ts')}`);
+    console.log(`  ${(0, ui_js_1.dim)('(default: ./turbine/seed.ts)')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}   Postgres connection string`);
+    (0, ui_js_1.newline)();
+}
+function showStatusHelp() {
+    (0, ui_js_1.banner)();
+    console.log(`  ${(0, ui_js_1.bold)('turbine status')} — Show database schema summary`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Usage:')}`);
+    console.log(`    npx turbine status ${(0, ui_js_1.dim)('[options]')}`);
+    (0, ui_js_1.newline)();
+    console.log(`  Introspects your database and displays tables, columns,`);
+    console.log(`  types, relations, and indexes.`);
+    (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Options:')}`);
+    console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}       Postgres connection string`);
+    console.log(`    ${(0, ui_js_1.cyan)('--schema, -s')} ${(0, ui_js_1.dim)('<name>')}   Postgres schema ${(0, ui_js_1.dim)('(default: public)')}`);
+    (0, ui_js_1.newline)();
+}
+// ---------------------------------------------------------------------------
 // Help
 // ---------------------------------------------------------------------------
 function showHelp() {
@@ -875,10 +1126,27 @@ async function main() {
         showHelp();
         return;
     }
+    // Subcommand help: e.g. `turbine migrate --help`
+    if (args.help) {
+        if (showSubcommandHelp(args.command))
+            return;
+        showHelp();
+        return;
+    }
     if (args.command === 'version' || args.command === '--version' || args.command === '-V') {
         showVersion();
         return;
     }
+    // If the user has a TypeScript config file, register the tsx ESM loader
+    // before we attempt to import it. Otherwise Node throws
+    // ERR_UNKNOWN_FILE_EXTENSION for `.ts`.
+    const configPath = (0, config_js_1.findConfigFile)();
+    if ((0, loader_js_1.needsTsLoader)(configPath)) {
+        const status = await (0, loader_js_1.registerTsLoader)();
+        if (status === 'missing' || status === 'unsupported') {
+            failMissingTsLoader(configPath ?? 'turbine.config.ts', status);
+        }
+    }
     // Load config file
     let fileConfig = {};
     try {
@@ -940,7 +1208,7 @@ async function main() {
             if (err.message.includes('ECONNREFUSED') || err.message.includes('connection')) {
                 (0, ui_js_1.newline)();
                 (0, ui_js_1.error)(`Could not connect to database`);
-                console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
                 (0, ui_js_1.newline)();
                 console.log(`  ${(0, ui_js_1.dim)('Check that:')}`);
                 console.log(`    ${(0, ui_js_1.dim)('1.')} Your database is running`);
@@ -950,25 +1218,25 @@ async function main() {
             else if (err.message.includes('authentication')) {
                 (0, ui_js_1.newline)();
                 (0, ui_js_1.error)(`Authentication failed`);
-                console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
             }
             else if (err.message.includes('does not exist')) {
                 (0, ui_js_1.newline)();
                 (0, ui_js_1.error)(`Database or schema not found`);
-                console.log(`  ${(0, ui_js_1.dim)(err.message)}`);
+                console.log(`  ${(0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.message))}`);
             }
             else {
                 (0, ui_js_1.newline)();
-                (0, ui_js_1.error)(err.message);
+                (0, ui_js_1.error)((0, ui_js_1.redactUrl)(err.message));
                 if (args.verbose && err.stack) {
                     (0, ui_js_1.newline)();
-                    console.log((0, ui_js_1.dim)(err.stack));
+                    console.log((0, ui_js_1.dim)((0, ui_js_1.redactUrl)(err.stack)));
                 }
             }
         }
         else {
             (0, ui_js_1.newline)();
-            (0, ui_js_1.error)(`Unexpected error: ${String(err)}`);
+            (0, ui_js_1.error)(`Unexpected error: ${(0, ui_js_1.redactUrl)(String(err))}`);
         }
         (0, ui_js_1.newline)();
         process.exit(1);