@danceroutine/tango-migrations 0.1.0 → 1.0.0

package/dist/cli-DhCn8xiS.js

@@ -0,0 +1,313 @@
+import { InternalDialect } from "./CompilerStrategy-yKw-Egxv.js";
+import { MigrationRunner, loadModule } from "./MigrationRunner-D1ZfbbS-.js";
+import { MigrationGenerator } from "./MigrationGenerator-B1p0jHnx.js";
+import { diffSchema } from "./diffSchema-D4oemTWS.js";
+import { createDefaultIntrospectorStrategy } from "./IntrospectorStrategy-blvwSU3_.js";
+import { access, mkdir } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { getLogger } from "@danceroutine/tango-core";
+import { loadConfig } from "@danceroutine/tango-config";
+
+//#region src/commands/cli.ts
+const logger = getLogger("tango.migrations");
+async function importModule(modulePath) {
+	return loadModule(modulePath, { projectRoot: process.cwd() });
+}
+async function tryLoadMigrationDefaults(configPathArg, configEnvArg) {
+	const explicitConfigPath = typeof configPathArg === "string" && configPathArg.trim().length > 0;
+	const resolvedPath = resolve(process.cwd(), configPathArg?.trim() || "./tango.config.ts");
+	try {
+		await access(resolvedPath, fsConstants.F_OK);
+	} catch (error) {
+		if (explicitConfigPath) throw new Error(`Config file not found: ${resolvedPath}`, { cause: error });
+		return {};
+	}
+	const module = await importModule(resolvedPath);
+	const fileConfig = module.default ?? module;
+	const loaded = loadConfig(() => ({
+		...fileConfig,
+		...configEnvArg ? { current: configEnvArg } : {}
+	}));
+	const { db, migrations } = loaded.current;
+	const inferredDialect = db.adapter;
+	const inferredDb = resolveDbTarget(db);
+	return {
+		dialect: inferredDialect,
+		db: inferredDb,
+		dir: migrations.dir,
+		autoApply: migrations.autoApply
+	};
+}
+function resolveDbTarget(db) {
+	if (db.adapter === InternalDialect.SQLITE) return db.filename ?? db.url;
+	if (db.url) return db.url;
+	if (!db.database) return undefined;
+	const host = db.host ?? "localhost";
+	const port = db.port ?? 5432;
+	const encodedUser = db.user ? encodeURIComponent(db.user) : "";
+	const encodedPassword = db.password ? encodeURIComponent(db.password) : "";
+	const userInfo = encodedUser.length > 0 ? encodedPassword.length > 0 ? `${encodedUser}:${encodedPassword}@` : `${encodedUser}@` : "";
+	return `postgres://${userInfo}${host}:${String(port)}/${db.database}`;
+}
+async function resolveCommandInputs(argv) {
+	const defaults = await tryLoadMigrationDefaults(argv.config, argv.env);
+	const resolvedDialect = argv.dialect ?? defaults.dialect ?? InternalDialect.POSTGRES;
+	const resolvedDir = argv.dir ?? defaults.dir ?? "migrations";
+	const resolvedDb = argv.db ?? defaults.db;
+	return {
+		dialect: resolvedDialect,
+		dir: resolvedDir,
+		db: resolvedDb,
+		autoApply: defaults.autoApply ?? true
+	};
+}
+async function loadModels(modelsPath) {
+	const mod = await importModule(modelsPath);
+	const moduleValue = mod.default ?? mod;
+	const models = [];
+	if (moduleValue && typeof moduleValue === "object" && "metadata" in moduleValue) {
+		const direct = moduleValue;
+		models.push(direct.metadata);
+	}
+	const exportedValues = moduleValue && typeof moduleValue === "object" ? Object.values(moduleValue) : [];
+	for (const value of exportedValues) if (value && typeof value === "object" && "metadata" in value) {
+		const model = value;
+		models.push(model.metadata);
+	}
+	if (models.length === 0) throw new Error(`No models found in '${modelsPath}'. Ensure the module exports Model() definitions.`);
+	return models;
+}
+async function connectAndIntrospect(dbUrl, dialect) {
+	const dbClient = await connectDbClient(dbUrl, dialect);
+	try {
+		const strategy = createDefaultIntrospectorStrategy();
+		return await strategy.introspect(dialect, dbClient);
+	} finally {
+		await dbClient.close();
+	}
+}
+async function connectDbClient(db, dialect) {
+	if (dialect === InternalDialect.POSTGRES) {
+		const pg = await import("pg");
+		const client = new pg.default.Client({ connectionString: db });
+		await client.connect();
+		return {
+			async query(sql, params) {
+				const result = await client.query(sql, params);
+				return { rows: result.rows };
+			},
+			async close() {
+				await client.end();
+			}
+		};
+	}
+	if (dialect === InternalDialect.SQLITE) {
+		const sqlite = await import("better-sqlite3");
+		const DatabaseCtor = sqlite.default ?? sqlite;
+		const filename = normalizeSqliteFilename(db);
+		await ensureSqliteParentDirectory(filename);
+		const connection = new DatabaseCtor(filename);
+		return {
+			async query(sql, params) {
+				const statement = connection.prepare(sql);
+				const values = [...params ?? []];
+				const isSelectLike = /^\s*(SELECT|PRAGMA|WITH)\b/i.test(sql);
+				if (isSelectLike) return { rows: statement.all(...values) };
+				statement.run(...values);
+				return { rows: [] };
+			},
+			async close() {
+				connection.close();
+			}
+		};
+	}
+	throw new Error(`Unsupported dialect: ${dialect}`);
+}
+async function ensureSqliteParentDirectory(filename) {
+	if (filename === ":memory:" || filename === "file::memory:") return;
+	const directory = dirname(filename);
+	if (directory === "." || directory.length === 0) return;
+	await mkdir(directory, { recursive: true });
+}
+function normalizeSqliteFilename(db) {
+	if (db.startsWith("sqlite://")) return db.slice("sqlite://".length);
+	return db;
+}
+function registerMigrationsCommands(yargsBuilder) {
+	return yargsBuilder.command("migrate", "Apply pending migrations to the database", (builder) => builder.option("dir", {
+		type: "string",
+		describe: "Migrations directory"
+	}).option("db", {
+		type: "string",
+		describe: "Database connection URL"
+	}).option("dialect", {
+		type: "string",
+		choices: ["postgres", "sqlite"],
+		describe: "Database dialect"
+	}).option("config", {
+		type: "string",
+		describe: "Path to tango.config.ts (auto-loads ./tango.config.ts when present)"
+	}).option("env", {
+		type: "string",
+		choices: [
+			"development",
+			"test",
+			"production"
+		],
+		describe: "Config environment override"
+	}).option("to", {
+		type: "string",
+		describe: "Target migration ID (apply up to this migration)"
+	}), async (argv) => {
+		const resolved = await resolveCommandInputs({
+			dialect: argv.dialect,
+			dir: argv.dir,
+			db: argv.db,
+			config: argv.config,
+			env: argv.env
+		});
+		if (!resolved.autoApply) {
+			logger.info("Auto-migration disabled (autoApply: false). Skipping.");
+			return;
+		}
+		if (!resolved.db) throw new Error("No database target provided. Pass --db or define db settings in tango.config.ts.");
+		const dbClient = await connectDbClient(resolved.db, resolved.dialect);
+		const runner = new MigrationRunner(dbClient, resolved.dialect, resolved.dir);
+		await runner.apply(argv.to);
+		await dbClient.close();
+		logger.info("Migrations applied successfully");
+	}).command("make:migrations", "Generate migration file by comparing models to database", (builder) => builder.option("dir", {
+		type: "string",
+		describe: "Migrations directory"
+	}).option("name", {
+		type: "string",
+		demandOption: true,
+		describe: "Migration name (e.g. \"create_users\")"
+	}).option("models", {
+		type: "string",
+		demandOption: true,
+		describe: "Path to module exporting Model definitions (e.g. \"./src/models.ts\")"
+	}).option("db", {
+		type: "string",
+		describe: "Database connection URL for introspection (omit for initial migration)"
+	}).option("dialect", {
+		type: "string",
+		choices: ["postgres", "sqlite"],
+		describe: "Database dialect"
+	}).option("config", {
+		type: "string",
+		describe: "Path to tango.config.ts (auto-loads ./tango.config.ts when present)"
+	}).option("env", {
+		type: "string",
+		choices: [
+			"development",
+			"test",
+			"production"
+		],
+		describe: "Config environment override"
+	}), async (argv) => {
+		const resolved = await resolveCommandInputs({
+			dialect: argv.dialect,
+			dir: argv.dir,
+			db: argv.db,
+			config: argv.config,
+			env: argv.env
+		});
+		const models = await loadModels(argv.models);
+		logger.info(`Found ${models.length} model(s): ${models.map((m) => m.table).join(", ")}`);
+		let dbState;
+		if (resolved.db) {
+			logger.info("Introspecting database...");
+			dbState = await connectAndIntrospect(resolved.db, resolved.dialect);
+		} else dbState = { tables: {} };
+		const operations = diffSchema(dbState, models);
+		if (operations.length === 0) {
+			logger.info("No changes detected — models and database are in sync");
+			return;
+		}
+		const generator = new MigrationGenerator();
+		const filepath = await generator.generate({
+			name: argv.name,
+			operations,
+			directory: resolved.dir
+		});
+		logger.info(`Generated migration: ${filepath}`);
+		logger.info(`  ${operations.length} operation(s)`);
+	}).command("plan", "Print migration SQL without applying", (builder) => builder.option("dir", {
+		type: "string",
+		describe: "Migrations directory"
+	}).option("dialect", {
+		type: "string",
+		choices: ["postgres", "sqlite"],
+		describe: "Database dialect"
+	}).option("config", {
+		type: "string",
+		describe: "Path to tango.config.ts (auto-loads ./tango.config.ts when present)"
+	}).option("env", {
+		type: "string",
+		choices: [
+			"development",
+			"test",
+			"production"
+		],
+		describe: "Config environment override"
+	}), async (argv) => {
+		const resolved = await resolveCommandInputs({
+			dialect: argv.dialect,
+			dir: argv.dir,
+			db: argv.db,
+			config: argv.config,
+			env: argv.env
+		});
+		const runner = new MigrationRunner({
+			query: async () => ({ rows: [] }),
+			close: async () => {}
+		}, resolved.dialect, resolved.dir);
+		const output = await runner.plan();
+		logger.info(output);
+	}).command("status", "Show applied/pending status of all migrations", (builder) => builder.option("dir", {
+		type: "string",
+		describe: "Migrations directory"
+	}).option("db", {
+		type: "string",
+		describe: "Database connection URL"
+	}).option("dialect", {
+		type: "string",
+		choices: ["postgres", "sqlite"],
+		describe: "Database dialect"
+	}).option("config", {
+		type: "string",
+		describe: "Path to tango.config.ts (auto-loads ./tango.config.ts when present)"
+	}).option("env", {
+		type: "string",
+		choices: [
+			"development",
+			"test",
+			"production"
+		],
+		describe: "Config environment override"
+	}), async (argv) => {
+		const resolved = await resolveCommandInputs({
+			dialect: argv.dialect,
+			dir: argv.dir,
+			db: argv.db,
+			config: argv.config,
+			env: argv.env
+		});
+		if (!resolved.db) throw new Error("No database target provided. Pass --db or define db settings in tango.config.ts.");
+		const dbClient = await connectDbClient(resolved.db, resolved.dialect);
+		const runner = new MigrationRunner(dbClient, resolved.dialect, resolved.dir);
+		const statuses = await runner.status();
+		if (statuses.length === 0) logger.info("No migrations found");
+else statuses.forEach((statusItem) => {
+			const marker = statusItem.applied ? "[x]" : "[ ]";
+			logger.info(`  ${marker} ${statusItem.id}`);
+		});
+		await dbClient.close();
+	});
+}
+
+//#endregion
+export { registerMigrationsCommands };
+//# sourceMappingURL=cli-DhCn8xiS.js.map

package/dist/cli-DhCn8xiS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-DhCn8xiS.js","names":["modulePath: string","configPathArg: string | undefined","configEnvArg: ConfigEnvironment | undefined","db: {\n    adapter: string;\n    url?: string;\n    filename?: string;\n    host?: string;\n    port?: number;\n    database?: string;\n    user?: string;\n    password?: string;\n}","argv: {\n    dialect?: string;\n    dir?: string;\n    db?: string;\n    config?: string;\n    env?: ConfigEnvironment;\n}","modelsPath: string","models: ModelMetadataLike[]","dbUrl: string","dialect: string","db: string","dialect: Dialect","sql: string","params?: readonly unknown[]","filename: string","yargsBuilder: Argv","dbState: DbSchema"],"sources":["../src/commands/cli.ts"],"sourcesContent":["import { access, mkdir } from 'node:fs/promises';\nimport { constants as fsConstants } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport type { Argv } from 'yargs';\nimport { MigrationRunner } from '../runner/MigrationRunner';\nimport { MigrationGenerator } from '../generator/MigrationGenerator';\nimport { diffSchema } from '../diff/diffSchema';\nimport type { DbSchema } from '../introspect/PostgresIntrospector';\nimport type { Dialect } from '../domain/Dialect';\nimport type { ColumnType } from '../builder/contracts/ColumnType';\nimport type { DeleteReferentialAction } from '../builder/contracts/DeleteReferentialAction';\nimport type { UpdateReferentialAction } from '../builder/contracts/UpdateReferentialAction';\nimport { createDefaultIntrospectorStrategy } from '../strategies/IntrospectorStrategy';\nimport { InternalDialect } from '../domain/internal/InternalDialect';\nimport { loadConfig } from '@danceroutine/tango-config';\nimport { getLogger } from '@danceroutine/tango-core';\nimport { loadModule } from '../runtime/loadModule';\n\nconst logger = getLogger('tango.migrations');\n\ntype ConfigEnvironment = 'development' | 'test' | 'production';\n\ntype OptionalMigrationDefaults = {\n    dialect?: Dialect;\n    db?: string;\n    dir?: string;\n    autoApply?: boolean;\n};\n\ntype ModelMetadataLike = {\n    table: string;\n    fields: Array<{\n        name: string;\n        type: ColumnType;\n        notNull?: boolean;\n        default?: string | { now: true } | null;\n        primaryKey?: boolean;\n        unique?: boolean;\n        references?: {\n            table: string;\n            column: string;\n            onDelete?: DeleteReferentialAction;\n            onUpdate?: UpdateReferentialAction;\n        };\n    }>;\n    indexes?: Array<{ name: string; on: string[]; unique?: boolean }>;\n};\n\ntype CliDbClient = {\n    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }>;\n    close(): Promise<void>;\n};\n\nasync function importModule(modulePath: string): Promise<Record<string, unknown>> {\n    return loadModule(modulePath, { projectRoot: process.cwd() });\n}\n\nasync function tryLoadMigrationDefaults(\n    configPathArg: string | undefined,\n    configEnvArg: ConfigEnvironment | undefined\n): Promise<OptionalMigrationDefaults> {\n    const explicitConfigPath = typeof configPathArg === 'string' && configPathArg.trim().length > 0;\n    const resolvedPath = resolve(process.cwd(), configPathArg?.trim() || './tango.config.ts');\n\n    try {\n        await access(resolvedPath, fsConstants.F_OK);\n    } catch (error) {\n        if (explicitConfigPath) {\n            throw new Error(`Config file not found: ${resolvedPath}`, { cause: error });\n        }\n        return {};\n    }\n\n    const module = await importModule(resolvedPath);\n    const fileConfig = (module.default ?? module) as { current?: ConfigEnvironment } & Record<string, unknown>;\n\n    const loaded = loadConfig(() => ({\n        ...fileConfig,\n        ...(configEnvArg ? { current: configEnvArg } : {}),\n    }));\n\n    const { db, migrations } = loaded.current;\n    const inferredDialect = db.adapter as Dialect;\n    const inferredDb = resolveDbTarget(db);\n\n    return {\n        dialect: inferredDialect,\n        db: inferredDb,\n        dir: migrations.dir,\n        autoApply: (migrations as { autoApply?: boolean }).autoApply,\n    };\n}\n\nfunction resolveDbTarget(db: {\n    adapter: string;\n    url?: string;\n    filename?: string;\n    host?: string;\n    port?: number;\n    database?: string;\n    user?: string;\n    password?: string;\n}): string | undefined {\n    if (db.adapter === InternalDialect.SQLITE) {\n        return db.filename ?? db.url;\n    }\n\n    if (db.url) {\n        return db.url;\n    }\n\n    if (!db.database) {\n        return undefined;\n    }\n\n    const host = db.host ?? 'localhost';\n    const port = db.port ?? 5432;\n    const encodedUser = db.user ? encodeURIComponent(db.user) : '';\n    const encodedPassword = db.password ? encodeURIComponent(db.password) : '';\n    const userInfo =\n        encodedUser.length > 0\n            ? encodedPassword.length > 0\n                ? `${encodedUser}:${encodedPassword}@`\n                : `${encodedUser}@`\n            : '';\n\n    return `postgres://${userInfo}${host}:${String(port)}/${db.database}`;\n}\n\nasync function resolveCommandInputs(argv: {\n    dialect?: string;\n    dir?: string;\n    db?: string;\n    config?: string;\n    env?: ConfigEnvironment;\n}): Promise<{ dialect: Dialect; dir: string; db?: string; autoApply: boolean }> {\n    const defaults = await tryLoadMigrationDefaults(argv.config, argv.env);\n\n    const resolvedDialect = (argv.dialect as Dialect | undefined) ?? defaults.dialect ?? InternalDialect.POSTGRES;\n    const resolvedDir = argv.dir ?? defaults.dir ?? 'migrations';\n    const resolvedDb = argv.db ?? defaults.db;\n\n    return {\n        dialect: resolvedDialect,\n        dir: resolvedDir,\n        db: resolvedDb,\n        autoApply: defaults.autoApply ?? true,\n    };\n}\n\nasync function loadModels(modelsPath: string): Promise<ModelMetadataLike[]> {\n    const mod = await importModule(modelsPath);\n    const moduleValue = (mod.default ?? mod) as unknown;\n\n    const models: ModelMetadataLike[] = [];\n    if (moduleValue && typeof moduleValue === 'object' && 'metadata' in moduleValue) {\n        const direct = moduleValue as { metadata: ModelMetadataLike };\n        models.push(direct.metadata);\n    }\n    const exportedValues =\n        moduleValue && typeof moduleValue === 'object' ? Object.values(moduleValue as Record<string, unknown>) : [];\n\n    for (const value of exportedValues) {\n        if (value && typeof value === 'object' && 'metadata' in value) {\n            const model = value as { metadata: ModelMetadataLike };\n            models.push(model.metadata);\n        }\n    }\n\n    if (models.length === 0) {\n        throw new Error(`No models found in '${modelsPath}'. Ensure the module exports Model() definitions.`);\n    }\n\n    return models;\n}\n\nasync function connectAndIntrospect(dbUrl: string, dialect: string): Promise<DbSchema> {\n    const dbClient = await connectDbClient(dbUrl, dialect as Dialect);\n\n    try {\n        const strategy = createDefaultIntrospectorStrategy();\n        return await strategy.introspect(dialect as Dialect, dbClient);\n    } finally {\n        await dbClient.close();\n    }\n}\n\nasync function connectDbClient(db: string, dialect: Dialect): Promise<CliDbClient> {\n    if (dialect === InternalDialect.POSTGRES) {\n        const pg = await import('pg');\n        const client = new pg.default.Client({ connectionString: db });\n        await client.connect();\n\n        return {\n            async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n                const result = await client.query(sql, params as unknown[] | undefined);\n                return { rows: result.rows as T[] };\n            },\n            async close(): Promise<void> {\n                await client.end();\n            },\n        };\n    }\n\n    if (dialect === InternalDialect.SQLITE) {\n        const sqlite = await import('better-sqlite3');\n        const DatabaseCtor = (sqlite.default ?? sqlite) as new (filename: string) => {\n            prepare(sql: string): {\n                all(...params: unknown[]): unknown[];\n                run(...params: unknown[]): unknown;\n            };\n            close(): void;\n        };\n\n        const filename = normalizeSqliteFilename(db);\n        await ensureSqliteParentDirectory(filename);\n        const connection = new DatabaseCtor(filename);\n\n        return {\n            async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n                const statement = connection.prepare(sql);\n                const values = [...(params ?? [])];\n                const isSelectLike = /^\\s*(SELECT|PRAGMA|WITH)\\b/i.test(sql);\n                if (isSelectLike) {\n                    return { rows: statement.all(...values) as T[] };\n                }\n\n                statement.run(...values);\n                return { rows: [] as T[] };\n            },\n            async close(): Promise<void> {\n                connection.close();\n            },\n        };\n    }\n\n    throw new Error(`Unsupported dialect: ${dialect}`);\n}\n\nasync function ensureSqliteParentDirectory(filename: string): Promise<void> {\n    if (filename === ':memory:' || filename === 'file::memory:') {\n        return;\n    }\n    const directory = dirname(filename);\n    if (directory === '.' || directory.length === 0) {\n        return;\n    }\n    await mkdir(directory, { recursive: true });\n}\n\nfunction normalizeSqliteFilename(db: string): string {\n    if (db.startsWith('sqlite://')) {\n        return db.slice('sqlite://'.length);\n    }\n    return db;\n}\n\n/**\n * Register Tango's migration commands on an existing yargs parser.\n */\nexport function registerMigrationsCommands(yargsBuilder: Argv): Argv {\n    return yargsBuilder\n        .command(\n            'migrate',\n            'Apply pending migrations to the database',\n            (builder) =>\n                builder\n                    .option('dir', {\n                        type: 'string',\n                        describe: 'Migrations directory',\n                    })\n                    .option('db', {\n                        type: 'string',\n                        describe: 'Database connection URL',\n                    })\n                    .option('dialect', {\n                        type: 'string',\n                        choices: ['postgres', 'sqlite'] as const,\n                        describe: 'Database dialect',\n                    })\n                    .option('config', {\n                        type: 'string',\n                        describe: 'Path to tango.config.ts (auto-loads ./tango.config.ts when present)',\n                    })\n                    .option('env', {\n                        type: 'string',\n                        choices: ['development', 'test', 'production'] as const,\n                        describe: 'Config environment override',\n                    })\n                    .option('to', {\n                        type: 'string',\n                        describe: 'Target migration ID (apply up to this migration)',\n                    }),\n            async (argv) => {\n                const resolved = await resolveCommandInputs({\n                    dialect: argv.dialect as string | undefined,\n                    dir: argv.dir as string | undefined,\n                    db: argv.db as string | undefined,\n                    config: argv.config as string | undefined,\n                    env: argv.env as ConfigEnvironment | undefined,\n                });\n\n                if (!resolved.autoApply) {\n                    logger.info('Auto-migration disabled (autoApply: false). Skipping.');\n                    return;\n                }\n\n                if (!resolved.db) {\n                    throw new Error('No database target provided. Pass --db or define db settings in tango.config.ts.');\n                }\n\n                const dbClient = await connectDbClient(resolved.db, resolved.dialect);\n\n                const runner = new MigrationRunner(dbClient, resolved.dialect, resolved.dir);\n                await runner.apply(argv.to);\n\n                await dbClient.close();\n                logger.info('Migrations applied successfully');\n            }\n        )\n        .command(\n            'make:migrations',\n            'Generate migration file by comparing models to database',\n            (builder) =>\n                builder\n                    .option('dir', {\n                        type: 'string',\n                        describe: 'Migrations directory',\n                    })\n                    .option('name', {\n                        type: 'string',\n                        demandOption: true,\n                        describe: 'Migration name (e.g. \"create_users\")',\n                    })\n                    .option('models', {\n                        type: 'string',\n                        demandOption: true,\n                        describe: 'Path to module exporting Model definitions (e.g. \"./src/models.ts\")',\n                    })\n                    .option('db', {\n                        type: 'string',\n                        describe: 'Database connection URL for introspection (omit for initial migration)',\n                    })\n                    .option('dialect', {\n                        type: 'string',\n                        choices: ['postgres', 'sqlite'] as const,\n                        describe: 'Database dialect',\n                    })\n                    .option('config', {\n                        type: 'string',\n                        describe: 'Path to tango.config.ts (auto-loads ./tango.config.ts when present)',\n                    })\n                    .option('env', {\n                        type: 'string',\n                        choices: ['development', 'test', 'production'] as const,\n                        describe: 'Config environment override',\n                    }),\n            async (argv) => {\n                const resolved = await resolveCommandInputs({\n                    dialect: argv.dialect as string | undefined,\n                    dir: argv.dir as string | undefined,\n                    db: argv.db as string | undefined,\n                    config: argv.config as string | undefined,\n                    env: argv.env as ConfigEnvironment | undefined,\n                });\n                const models = await loadModels(argv.models);\n                logger.info(`Found ${models.length} model(s): ${models.map((m) => m.table).join(', ')}`);\n\n                let dbState: DbSchema;\n                if (resolved.db) {\n                    logger.info('Introspecting database...');\n                    dbState = await connectAndIntrospect(resolved.db, resolved.dialect);\n                } else {\n                    dbState = { tables: {} };\n                }\n\n                const operations = diffSchema(dbState, models);\n\n                if (operations.length === 0) {\n                    logger.info('No changes detected — models and database are in sync');\n                    return;\n                }\n\n                const generator = new MigrationGenerator();\n                const filepath = await generator.generate({\n                    name: argv.name,\n                    operations,\n                    directory: resolved.dir,\n                });\n\n                logger.info(`Generated migration: ${filepath}`);\n                logger.info(`  ${operations.length} operation(s)`);\n            }\n        )\n        .command(\n            'plan',\n            'Print migration SQL without applying',\n            (builder) =>\n                builder\n                    .option('dir', {\n                        type: 'string',\n                        describe: 'Migrations directory',\n                    })\n                    .option('dialect', {\n                        type: 'string',\n                        choices: ['postgres', 'sqlite'] as const,\n                        describe: 'Database dialect',\n                    })\n                    .option('config', {\n                        type: 'string',\n                        describe: 'Path to tango.config.ts (auto-loads ./tango.config.ts when present)',\n                    })\n                    .option('env', {\n                        type: 'string',\n                        choices: ['development', 'test', 'production'] as const,\n                        describe: 'Config environment override',\n                    }),\n            async (argv) => {\n                const resolved = await resolveCommandInputs({\n                    dialect: argv.dialect as string | undefined,\n                    dir: argv.dir as string | undefined,\n                    db: argv.db as string | undefined,\n                    config: argv.config as string | undefined,\n                    env: argv.env as ConfigEnvironment | undefined,\n                });\n                const runner = new MigrationRunner(\n                    { query: async () => ({ rows: [] }), close: async () => {} },\n                    resolved.dialect,\n                    resolved.dir\n                );\n                const output = await runner.plan();\n                logger.info(output);\n            }\n        )\n        .command(\n            'status',\n            'Show applied/pending status of all migrations',\n            (builder) =>\n                builder\n                    .option('dir', {\n                        type: 'string',\n                        describe: 'Migrations directory',\n                    })\n                    .option('db', {\n                        type: 'string',\n                        describe: 'Database connection URL',\n                    })\n                    .option('dialect', {\n                        type: 'string',\n                        choices: ['postgres', 'sqlite'] as const,\n                        describe: 'Database dialect',\n                    })\n                    .option('config', {\n                        type: 'string',\n                        describe: 'Path to tango.config.ts (auto-loads ./tango.config.ts when present)',\n                    })\n                    .option('env', {\n                        type: 'string',\n                        choices: ['development', 'test', 'production'] as const,\n                        describe: 'Config environment override',\n                    }),\n            async (argv) => {\n                const resolved = await resolveCommandInputs({\n                    dialect: argv.dialect as string | undefined,\n                    dir: argv.dir as string | undefined,\n                    db: argv.db as string | undefined,\n                    config: argv.config as string | undefined,\n                    env: argv.env as ConfigEnvironment | undefined,\n                });\n                if (!resolved.db) {\n                    throw new Error('No database target provided. Pass --db or define db settings in tango.config.ts.');\n                }\n\n                const dbClient = await connectDbClient(resolved.db, resolved.dialect);\n\n                const runner = new MigrationRunner(dbClient, resolved.dialect, resolved.dir);\n                const statuses = await runner.status();\n\n                if (statuses.length === 0) {\n                    logger.info('No migrations found');\n                } else {\n                    statuses.forEach((statusItem) => {\n                        const marker = statusItem.applied ? '[x]' : '[ ]';\n                        logger.info(`  ${marker} ${statusItem.id}`);\n                    });\n                }\n\n                await dbClient.close();\n            }\n        );\n}\n"],"mappings":"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"}

package/dist/cli.js

@@ -1,178 +1,26 @@
 #!/usr/bin/env node
-import "./CollectingBuilder-C6qnwyrb.js";
-import "./Migration-D9J6ZbLP.js";
-import "./InternalOperationKind-BPVoOQwD.js";
-import "./InternalColumnType-_YAz7RqI.js";
-import "./SqliteCompilerFactory-DwMwO7xY.js";
-import "./CompilerStrategy-Cv1woBmO.js";
-import { MigrationRunner } from "./MigrationRunner-CCFuPUlr.js";
-import { MigrationGenerator } from "./MigrationGenerator-Z39LTKmC.js";
-import "./builder-Dtk8oP_Y.js";
-import { diffSchema } from "./diffSchema-KgGHP-s3.js";
-import "./SqliteIntrospector-BRdNt6KG.js";
-import { createDefaultIntrospectorStrategy } from "./IntrospectorStrategy-BM1Eizfc.js";
+import "./CollectingBuilder--4fqDQdE.js";
+import "./Migration-DYQ0hUG7.js";
+import "./InternalOperationKind-Bt6Weuon.js";
+import "./InternalColumnType-G9zV9StN.js";
+import "./MigrationSqlSafetyAdapter-CGRbB2k2.js";
+import "./SqliteCompilerFactory-BAodJW9n.js";
+import "./CompilerStrategy-yKw-Egxv.js";
+import "./MigrationRunner-D1ZfbbS-.js";
+import "./MigrationGenerator-B1p0jHnx.js";
+import "./builder-xJ-Bq2pk.js";
+import "./diffSchema-D4oemTWS.js";
+import "./SqliteIntrospector-CWwPWhmA.js";
+import "./IntrospectorStrategy-blvwSU3_.js";
+import { registerMigrationsCommands } from "./cli-DhCn8xiS.js";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
-import { resolve } from "node:path";
 
 //#region src/cli.ts
-async function loadModels(modelsPath) {
-	const absolutePath = resolve(process.cwd(), modelsPath);
-	const mod = await import(absolutePath);
-	const models = [];
-	for (const value of Object.values(mod)) if (value && typeof value === "object" && "metadata" in value) {
-		const model = value;
-		models.push(model.metadata);
-	}
-	if (models.length === 0) throw new Error(`No models found in '${modelsPath}'. ` + `Ensure the module exports Model() definitions.`);
-	return models;
+function runMigrationsCli() {
+	registerMigrationsCommands(yargs(hideBin(process.argv))).scriptName("tango").demandCommand(1, "You must specify a command").strict().help().alias("help", "h").alias("version", "v").parse();
 }
-async function connectAndIntrospect(dbUrl, dialect) {
-	if (dialect !== "postgres") throw new Error(`Introspection for '${dialect}' is not yet supported. Omit --db to generate from scratch.`);
-	const pg = await import("pg");
-	const client = new pg.default.Client({ connectionString: dbUrl });
-	await client.connect();
-	const dbClient = {
-		async query(sql) {
-			const result = await client.query(sql);
-			return { rows: result.rows };
-		},
-		async close() {
-			await client.end();
-		}
-	};
-	try {
-		const strategy = createDefaultIntrospectorStrategy();
-		return await strategy.introspect("postgres", dbClient);
-	} finally {
-		await dbClient.close();
-	}
-}
-yargs(hideBin(process.argv)).command("migrate", "Apply pending migrations to the database", (yargsBuilder) => yargsBuilder.option("dir", {
-	type: "string",
-	default: "migrations",
-	describe: "Migrations directory"
-}).option("db", {
-	type: "string",
-	demandOption: true,
-	describe: "Database connection URL"
-}).option("dialect", {
-	type: "string",
-	choices: ["postgres", "sqlite"],
-	default: "postgres",
-	describe: "Database dialect"
-}).option("to", {
-	type: "string",
-	describe: "Target migration ID (apply up to this migration)"
-}), async (argv) => {
-	const pg = await import("pg");
-	const client = new pg.default.Client({ connectionString: argv.db });
-	await client.connect();
-	const dbClient = {
-		async query(sql, params) {
-			const result = await client.query(sql, params);
-			return { rows: result.rows };
-		},
-		async close() {
-			await client.end();
-		}
-	};
-	const runner = new MigrationRunner(dbClient, argv.dialect, argv.dir);
-	await runner.apply(argv.to);
-	await dbClient.close();
-	console.log("Migrations applied successfully");
-}).command("make:migrations", "Generate migration file by comparing models to database", (yargsBuilder) => yargsBuilder.option("dir", {
-	type: "string",
-	default: "migrations",
-	describe: "Migrations directory"
-}).option("name", {
-	type: "string",
-	demandOption: true,
-	describe: "Migration name (e.g. \"create_users\")"
-}).option("models", {
-	type: "string",
-	demandOption: true,
-	describe: "Path to module exporting Model definitions (e.g. \"./src/models.ts\")"
-}).option("db", {
-	type: "string",
-	describe: "Database connection URL for introspection (omit for initial migration)"
-}).option("dialect", {
-	type: "string",
-	choices: ["postgres", "sqlite"],
-	default: "postgres",
-	describe: "Database dialect"
-}), async (argv) => {
-	const models = await loadModels(argv.models);
-	console.log(`Found ${models.length} model(s): ${models.map((m) => m.table).join(", ")}`);
-	let dbState;
-	if (argv.db) {
-		console.log("Introspecting database...");
-		dbState = await connectAndIntrospect(argv.db, argv.dialect);
-	} else dbState = { tables: {} };
-	const operations = diffSchema(dbState, models);
-	if (operations.length === 0) {
-		console.log("No changes detected — models and database are in sync");
-		return;
-	}
-	const generator = new MigrationGenerator();
-	const filepath = await generator.generate({
-		name: argv.name,
-		operations,
-		directory: argv.dir
-	});
-	console.log(`Generated migration: ${filepath}`);
-	console.log(`  ${operations.length} operation(s)`);
-}).command("plan", "Print migration SQL without applying", (yargsBuilder) => yargsBuilder.option("dir", {
-	type: "string",
-	default: "migrations",
-	describe: "Migrations directory"
-}).option("dialect", {
-	type: "string",
-	choices: ["postgres", "sqlite"],
-	default: "postgres",
-	describe: "Database dialect"
-}), async (argv) => {
-	const runner = new MigrationRunner({
-		query: async () => ({ rows: [] }),
-		close: async () => {}
-	}, argv.dialect, argv.dir);
-	const output = await runner.plan();
-	console.log(output);
-}).command("status", "Show applied/pending status of all migrations", (yargsBuilder) => yargsBuilder.option("dir", {
-	type: "string",
-	default: "migrations",
-	describe: "Migrations directory"
-}).option("db", {
-	type: "string",
-	demandOption: true,
-	describe: "Database connection URL"
-}).option("dialect", {
-	type: "string",
-	choices: ["postgres", "sqlite"],
-	default: "postgres",
-	describe: "Database dialect"
-}), async (argv) => {
-	const pg = await import("pg");
-	const client = new pg.default.Client({ connectionString: argv.db });
-	await client.connect();
-	const dbClient = {
-		async query(sql, params) {
-			const result = await client.query(sql, params);
-			return { rows: result.rows };
-		},
-		async close() {
-			await client.end();
-		}
-	};
-	const runner = new MigrationRunner(dbClient, argv.dialect, argv.dir);
-	const statuses = await runner.status();
-	if (statuses.length === 0) console.log("No migrations found");
-else statuses.forEach((s) => {
-		const marker = s.applied ? "[x]" : "[ ]";
-		console.log(`  ${marker} ${s.id}`);
-	});
-	await dbClient.close();
-}).demandCommand(1, "You must specify a command").strict().help().alias("help", "h").alias("version", "v").parse();
+runMigrationsCli();
 
 //#endregion
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":["modelsPath: string","models: ModelMetadataLike[]","dbUrl: string","dialect: string","sql: string","params?: readonly unknown[]","dbState: DbSchema"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport { resolve } from 'node:path';\nimport { MigrationRunner } from './runner/MigrationRunner';\nimport { MigrationGenerator } from './generator/MigrationGenerator';\nimport { diffSchema } from './diff/diffSchema';\nimport type { DbSchema } from './introspect/PostgresIntrospector';\nimport type { Dialect } from './domain/Dialect';\nimport type { ColumnType } from './builder/contracts/ColumnType';\nimport type { DeleteReferentialAction } from './builder/contracts/DeleteReferentialAction';\nimport type { UpdateReferentialAction } from './builder/contracts/UpdateReferentialAction';\nimport { createDefaultIntrospectorStrategy } from './strategies/IntrospectorStrategy';\n\ntype ModelMetadataLike = {\n    table: string;\n    fields: Array<{\n        name: string;\n        type: ColumnType;\n        notNull?: boolean;\n        default?: string | { now: true } | null;\n        primaryKey?: boolean;\n        unique?: boolean;\n        references?: {\n            table: string;\n            column: string;\n            onDelete?: DeleteReferentialAction;\n            onUpdate?: UpdateReferentialAction;\n        };\n    }>;\n    indexes?: Array<{ name: string; on: string[]; unique?: boolean }>;\n};\n\nasync function loadModels(modelsPath: string): Promise<ModelMetadataLike[]> {\n    const absolutePath = resolve(process.cwd(), modelsPath);\n    const mod = await import(absolutePath);\n\n    const models: ModelMetadataLike[] = [];\n\n    for (const value of Object.values(mod)) {\n        if (value && typeof value === 'object' && 'metadata' in value) {\n            const model = value as { metadata: ModelMetadataLike };\n            models.push(model.metadata);\n        }\n    }\n\n    if (models.length === 0) {\n        throw new Error(`No models found in '${modelsPath}'. ` + `Ensure the module exports Model() definitions.`);\n    }\n\n    return models;\n}\n\nasync function connectAndIntrospect(dbUrl: string, dialect: string): Promise<DbSchema> {\n    if (dialect !== 'postgres') {\n        throw new Error(`Introspection for '${dialect}' is not yet supported. Omit --db to generate from scratch.`);\n    }\n\n    const pg = await import('pg');\n    const client = new pg.default.Client({ connectionString: dbUrl });\n    await client.connect();\n\n    const dbClient = {\n        async query<T = unknown>(sql: string): Promise<{ rows: T[] }> {\n            const result = await client.query(sql);\n            return { rows: result.rows as T[] };\n        },\n        async close() {\n            await client.end();\n        },\n    };\n\n    try {\n        const strategy = createDefaultIntrospectorStrategy();\n        return await strategy.introspect('postgres' as Dialect, dbClient);\n    } finally {\n        await dbClient.close();\n    }\n}\n\nyargs(hideBin(process.argv))\n    .command(\n        'migrate',\n        'Apply pending migrations to the database',\n        (yargsBuilder) =>\n            yargsBuilder\n                .option('dir', {\n                    type: 'string',\n                    default: 'migrations',\n                    describe: 'Migrations directory',\n                })\n                .option('db', {\n                    type: 'string',\n                    demandOption: true,\n                    describe: 'Database connection URL',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: ['postgres', 'sqlite'] as const,\n                    default: 'postgres' as const,\n                    describe: 'Database dialect',\n                })\n                .option('to', {\n                    type: 'string',\n                    describe: 'Target migration ID (apply up to this migration)',\n                }),\n        async (argv) => {\n            const pg = await import('pg');\n            const client = new pg.default.Client({ connectionString: argv.db });\n            await client.connect();\n\n            const dbClient = {\n                async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n                    const result = await client.query(sql, params as unknown[] | undefined);\n                    return { rows: result.rows as T[] };\n                },\n                async close() {\n                    await client.end();\n                },\n            };\n\n            const runner = new MigrationRunner(dbClient, argv.dialect as Dialect, argv.dir);\n            await runner.apply(argv.to);\n\n            await dbClient.close();\n            console.log('Migrations applied successfully');\n        }\n    )\n    .command(\n        'make:migrations',\n        'Generate migration file by comparing models to database',\n        (yargsBuilder) =>\n            yargsBuilder\n                .option('dir', {\n                    type: 'string',\n                    default: 'migrations',\n                    describe: 'Migrations directory',\n                })\n                .option('name', {\n                    type: 'string',\n                    demandOption: true,\n                    describe: 'Migration name (e.g. \"create_users\")',\n                })\n                .option('models', {\n                    type: 'string',\n                    demandOption: true,\n                    describe: 'Path to module exporting Model definitions (e.g. \"./src/models.ts\")',\n                })\n                .option('db', {\n                    type: 'string',\n                    describe: 'Database connection URL for introspection (omit for initial migration)',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: ['postgres', 'sqlite'] as const,\n                    default: 'postgres' as const,\n                    describe: 'Database dialect',\n                }),\n        async (argv) => {\n            const models = await loadModels(argv.models);\n            console.log(`Found ${models.length} model(s): ${models.map((m) => m.table).join(', ')}`);\n\n            let dbState: DbSchema;\n            if (argv.db) {\n                console.log('Introspecting database...');\n                dbState = await connectAndIntrospect(argv.db, argv.dialect);\n            } else {\n                dbState = { tables: {} };\n            }\n\n            const operations = diffSchema(dbState, models);\n\n            if (operations.length === 0) {\n                console.log('No changes detected — models and database are in sync');\n                return;\n            }\n\n            const generator = new MigrationGenerator();\n            const filepath = await generator.generate({\n                name: argv.name,\n                operations,\n                directory: argv.dir,\n            });\n\n            console.log(`Generated migration: ${filepath}`);\n            console.log(`  ${operations.length} operation(s)`);\n        }\n    )\n    .command(\n        'plan',\n        'Print migration SQL without applying',\n        (yargsBuilder) =>\n            yargsBuilder\n                .option('dir', {\n                    type: 'string',\n                    default: 'migrations',\n                    describe: 'Migrations directory',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: ['postgres', 'sqlite'] as const,\n                    default: 'postgres' as const,\n                    describe: 'Database dialect',\n                }),\n        async (argv) => {\n            const runner = new MigrationRunner(\n                { query: async () => ({ rows: [] }), close: async () => {} },\n                argv.dialect as Dialect,\n                argv.dir\n            );\n            const output = await runner.plan();\n            console.log(output);\n        }\n    )\n    .command(\n        'status',\n        'Show applied/pending status of all migrations',\n        (yargsBuilder) =>\n            yargsBuilder\n                .option('dir', {\n                    type: 'string',\n                    default: 'migrations',\n                    describe: 'Migrations directory',\n                })\n                .option('db', {\n                    type: 'string',\n                    demandOption: true,\n                    describe: 'Database connection URL',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: ['postgres', 'sqlite'] as const,\n                    default: 'postgres' as const,\n                    describe: 'Database dialect',\n                }),\n        async (argv) => {\n            const pg = await import('pg');\n            const client = new pg.default.Client({ connectionString: argv.db });\n            await client.connect();\n\n            const dbClient = {\n                async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n                    const result = await client.query(sql, params as unknown[] | undefined);\n                    return { rows: result.rows as T[] };\n                },\n                async close() {\n                    await client.end();\n                },\n            };\n\n            const runner = new MigrationRunner(dbClient, argv.dialect as Dialect, argv.dir);\n            const statuses = await runner.status();\n\n            if (statuses.length === 0) {\n                console.log('No migrations found');\n            } else {\n                statuses.forEach((s) => {\n                    const marker = s.applied ? '[x]' : '[ ]';\n                    console.log(`  ${marker} ${s.id}`);\n                });\n            }\n\n            await dbClient.close();\n        }\n    )\n    .demandCommand(1, 'You must specify a command')\n    .strict()\n    .help()\n    .alias('help', 'h')\n    .alias('version', 'v')\n    .parse();\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport { registerMigrationsCommands } from './commands/cli';\n\nfunction runMigrationsCli(): void {\n    registerMigrationsCommands(yargs(hideBin(process.argv)))\n        .scriptName('tango')\n        .demandCommand(1, 'You must specify a command')\n        .strict()\n        .help()\n        .alias('help', 'h')\n        .alias('version', 'v')\n        .parse();\n}\n\nrunMigrationsCli();\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAKA,SAAS,mBAAyB;AAC9B,4BAA2B,MAAM,QAAQ,QAAQ,KAAK,CAAC,CAAC,CACnD,WAAW,QAAQ,CACnB,cAAc,GAAG,6BAA6B,CAC9C,QAAQ,CACR,MAAM,CACN,MAAM,QAAQ,IAAI,CAClB,MAAM,WAAW,IAAI,CACrB,OAAO;AACf;AAED,kBAAkB"}

package/dist/commands/cli.d.ts

@@ -0,0 +1,5 @@
+import type { Argv } from 'yargs';
+/**
+ * Register Tango's migration commands on an existing yargs parser.
+ */
+export declare function registerMigrationsCommands(yargsBuilder: Argv): Argv;

package/dist/commands/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export { registerMigrationsCommands } from './cli';

package/dist/commands/index.js

@@ -0,0 +1,17 @@
+import "../CollectingBuilder--4fqDQdE.js";
+import "../Migration-DYQ0hUG7.js";
+import "../InternalOperationKind-Bt6Weuon.js";
+import "../InternalColumnType-G9zV9StN.js";
+import "../MigrationSqlSafetyAdapter-CGRbB2k2.js";
+import "../SqliteCompilerFactory-BAodJW9n.js";
+import "../CompilerStrategy-yKw-Egxv.js";
+import "../MigrationRunner-D1ZfbbS-.js";
+import "../MigrationGenerator-B1p0jHnx.js";
+import "../builder-xJ-Bq2pk.js";
+import "../diffSchema-D4oemTWS.js";
+import "../SqliteIntrospector-CWwPWhmA.js";
+import "../IntrospectorStrategy-blvwSU3_.js";
+import { registerMigrationsCommands } from "../cli-DhCn8xiS.js";
+import "../commands-DIJepqNg.js";
+
+export { registerMigrationsCommands };

package/dist/commands-DIJepqNg.js

@@ -0,0 +1,10 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { registerMigrationsCommands } from "./cli-DhCn8xiS.js";
+
+//#region src/commands/index.ts
+var commands_exports = {};
+__export(commands_exports, { registerMigrationsCommands: () => registerMigrationsCommands });
+
+//#endregion
+export { commands_exports };
+//# sourceMappingURL=commands-DIJepqNg.js.map

package/dist/commands-DIJepqNg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-DIJepqNg.js","names":[],"sources":["../src/commands/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { registerMigrationsCommands } from './cli';\n"],"mappings":""}