@danceroutine/tango-migrations 1.11.1 → 1.11.2

package/dist/MigrationOperation-qpdhPEs9.d.ts

@@ -0,0 +1,145 @@
+import { TrustedSqlFragment } from "@danceroutine/tango-core";
+
+//#region src/domain/internal/InternalOperationKind.d.ts
+declare const InternalOperationKind: {
+  readonly TABLE_CREATE: "table.create";
+  readonly TABLE_DROP: "table.drop";
+  readonly COLUMN_ADD: "column.add";
+  readonly COLUMN_DROP: "column.drop";
+  readonly COLUMN_ALTER: "column.alter";
+  readonly COLUMN_RENAME: "column.rename";
+  readonly INDEX_CREATE: "index.create";
+  readonly INDEX_DROP: "index.drop";
+  readonly FK_CREATE: "fk.create";
+  readonly FK_VALIDATE: "fk.validate";
+  readonly FK_DROP: "fk.drop";
+};
+type InternalOperationKind = (typeof InternalOperationKind)[keyof typeof InternalOperationKind];
+//#endregion
+//#region src/domain/internal/InternalColumnType.d.ts
+declare const InternalColumnType: {
+  readonly SERIAL: "serial";
+  readonly INT: "int";
+  readonly BIGINT: "bigint";
+  readonly TEXT: "text";
+  readonly BOOL: "bool";
+  readonly TIMESTAMPTZ: "timestamptz";
+  readonly JSONB: "jsonb";
+  readonly UUID: "uuid";
+};
+type InternalColumnType = (typeof InternalColumnType)[keyof typeof InternalColumnType];
+//#endregion
+//#region src/builder/contracts/ColumnType.d.ts
+type ColumnType = (typeof InternalColumnType)[keyof typeof InternalColumnType];
+//#endregion
+//#region src/domain/internal/InternalReferentialAction.d.ts
+declare const InternalReferentialAction: {
+  readonly CASCADE: "CASCADE";
+  readonly SET_NULL: "SET NULL";
+  readonly RESTRICT: "RESTRICT";
+  readonly NO_ACTION: "NO ACTION";
+};
+type InternalReferentialAction = (typeof InternalReferentialAction)[keyof typeof InternalReferentialAction];
+//#endregion
+//#region src/builder/contracts/DeleteReferentialAction.d.ts
+type DeleteReferentialAction = (typeof InternalReferentialAction)[keyof typeof InternalReferentialAction];
+//#endregion
+//#region src/builder/contracts/UpdateReferentialAction.d.ts
+type UpdateReferentialAction = Extract<InternalReferentialAction, 'CASCADE' | 'RESTRICT' | 'NO_ACTION'>;
+//#endregion
+//#region src/builder/contracts/ColumnSpec.d.ts
+interface ColumnSpec {
+  name: string;
+  type: ColumnType;
+  notNull?: boolean;
+  default?: TrustedSqlFragment | {
+    now: true;
+  } | null;
+  primaryKey?: boolean;
+  unique?: boolean;
+  references?: {
+    table: string;
+    column: string;
+    onDelete?: DeleteReferentialAction;
+    onUpdate?: UpdateReferentialAction;
+  };
+}
+//#endregion
+//#region src/domain/MigrationOperation.d.ts
+type TableCreate = {
+  kind: typeof InternalOperationKind.TABLE_CREATE;
+  table: string;
+  columns: ColumnSpec[];
+};
+type TableDrop = {
+  kind: typeof InternalOperationKind.TABLE_DROP;
+  table: string;
+  cascade?: boolean;
+};
+type ColumnAdd = {
+  kind: typeof InternalOperationKind.COLUMN_ADD;
+  table: string;
+  column: ColumnSpec;
+};
+type ColumnDrop = {
+  kind: typeof InternalOperationKind.COLUMN_DROP;
+  table: string;
+  column: string;
+};
+type ColumnAlter = {
+  kind: typeof InternalOperationKind.COLUMN_ALTER;
+  table: string;
+  column: string;
+  to: Partial<ColumnSpec>;
+};
+type ColumnRename = {
+  kind: typeof InternalOperationKind.COLUMN_RENAME;
+  table: string;
+  from: string;
+  to: string;
+};
+type IndexCreate = {
+  kind: typeof InternalOperationKind.INDEX_CREATE;
+  table: string;
+  name: string;
+  on: string[];
+  unique?: boolean;
+  where?: TrustedSqlFragment;
+  concurrently?: boolean;
+};
+type IndexDrop = {
+  kind: typeof InternalOperationKind.INDEX_DROP;
+  table: string;
+  name: string;
+  concurrently?: boolean;
+};
+type ForeignKeyCreate = {
+  kind: typeof InternalOperationKind.FK_CREATE;
+  table: string;
+  name?: string;
+  columns: string[];
+  refTable: string;
+  refColumns: string[];
+  onDelete?: string;
+  onUpdate?: string;
+  notValid?: boolean;
+};
+type ForeignKeyValidate = {
+  kind: typeof InternalOperationKind.FK_VALIDATE;
+  table: string;
+  name: string;
+};
+type ForeignKeyDrop = {
+  kind: typeof InternalOperationKind.FK_DROP;
+  table: string;
+  name: string;
+};
+type CustomMigrationOperation<TName extends string = string, TArgs extends object = Record<string, unknown>> = {
+  kind: 'custom';
+  name: TName;
+  args: TArgs;
+};
+type MigrationOperation = TableCreate | TableDrop | ColumnAdd | ColumnDrop | ColumnAlter | ColumnRename | IndexCreate | IndexDrop | ForeignKeyCreate | ForeignKeyValidate | ForeignKeyDrop | CustomMigrationOperation;
+//#endregion
+export { ColumnType as _, CustomMigrationOperation as a, ForeignKeyValidate as c, MigrationOperation as d, TableCreate as f, DeleteReferentialAction as g, UpdateReferentialAction as h, ColumnRename as i, IndexCreate as l, ColumnSpec as m, ColumnAlter as n, ForeignKeyCreate as o, TableDrop as p, ColumnDrop as r, ForeignKeyDrop as s, ColumnAdd as t, IndexDrop as u };
+//# sourceMappingURL=MigrationOperation-qpdhPEs9.d.ts.map

package/dist/{MigrationRunner-DomrOZIn.js → MigrationRunner-B5AJel12.js}

@@ -1,13 +1,12 @@
-import { CollectingBuilder } from "./CollectingBuilder--4fqDQdE.js";
-import { Migration } from "./Migration-DYQ0hUG7.js";
-import { InternalDialect, createDefaultCompilerStrategy } from "./CompilerStrategy-_AiXiyjS.js";
-import { readdir } from "node:fs/promises";
-import { extname, resolve, resolve as resolve$1 } from "node:path";
+import { t as Migration } from "./Migration-DxHHPyzn.js";
+import { t as CollectingBuilder } from "./CollectingBuilder-BIfAKs_x.js";
+import { n as createDefaultCompilerStrategy, r as InternalDialect } from "./CompilerStrategy-vcZKg8qf.js";
 import { isError } from "@danceroutine/tango-core";
+import { readdir } from "node:fs/promises";
+import { extname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { createJiti } from "jiti";
 import { ModelRegistry } from "@danceroutine/tango-schema";
-
 //#region src/runtime/loadModule.ts
 const TS_EXTENSIONS = new Set([
 	".ts",
@@ -16,36 +15,68 @@ const TS_EXTENSIONS = new Set([
 	".cts"
 ]);
 function toAbsolutePath(modulePath, projectRoot) {
-	return resolve$1(projectRoot, modulePath);
+	return resolve(projectRoot, modulePath);
 }
 function isTypeScriptModule(modulePath) {
 	return TS_EXTENSIONS.has(extname(modulePath).toLowerCase());
 }
+/**
+* Load a module from a Tango app project root.
+*
+* TypeScript modules are loaded through jiti and JavaScript/ESM modules are loaded
+* through native dynamic import so published installs behave like end-user runtime.
+*/
 async function loadModule(modulePath, options) {
 	const projectRoot = options?.projectRoot ?? process.cwd();
 	const absolutePath = toAbsolutePath(modulePath, projectRoot);
 	const executeImport = async () => {
-		if (isTypeScriptModule(absolutePath)) {
-			const jiti = createJiti(resolve$1(projectRoot, "tango.config.ts"), {
-				interopDefault: true,
-				moduleCache: options?.moduleCache ?? true
-			});
-			return await jiti.import(absolutePath);
-		}
+		if (isTypeScriptModule(absolutePath)) return await createJiti(resolve(projectRoot, "tango.config.ts"), {
+			interopDefault: true,
+			moduleCache: options?.moduleCache ?? true
+		}).import(absolutePath);
 		return await import(pathToFileURL(absolutePath).href);
 	};
 	if (options?.registry) return ModelRegistry.runWithRegistry(options.registry, executeImport);
 	return executeImport();
 }
+/**
+* Load a module and return default export when present.
+*/
 async function loadDefaultExport(modulePath, options) {
 	const loaded = await loadModule(modulePath, options);
 	return loaded.default ?? loaded;
 }
-
 //#endregion
 //#region src/runner/MigrationRunner.ts
 const JOURNAL = "_tango_migrations";
+/**
+* Manages the lifecycle of database migrations: applying, planning, and tracking status.
+*
+* The runner reads migration files from a directory, compiles operations to SQL
+* for the target dialect, and maintains a journal table to track which migrations
+* have been applied. Each applied migration is checksummed to detect tampering.
+*
+* @example
+* ```typescript
+* const runner = new MigrationRunner(client, 'postgres', './migrations');
+*
+* // Apply all pending migrations
+* await runner.apply();
+*
+* // Apply up to a specific migration
+* await runner.apply('003_add_indexes');
+*
+* // Preview the SQL that would be generated
+* const sql = await runner.plan();
+*
+* // Check which migrations are applied
+* const statuses = await runner.status();
+* ```
+*/
 var MigrationRunner = class MigrationRunner {
+	client;
+	dialect;
+	migrationsDir;
 	static BRAND = "tango.migrations.runner";
 	__tangoBrand = MigrationRunner.BRAND;
 	compilerStrategy;
@@ -86,8 +117,7 @@ var MigrationRunner = class MigrationRunner {
 		migrations.forEach((migration) => {
 			const builder = new CollectingBuilder();
 			migration.up(builder);
-			const preparedOps = this.compilerStrategy.prepareOperations(this.dialect, builder.ops);
-			const sqls = preparedOps.flatMap((op) => this.compileOperation(op));
+			const sqls = this.compilerStrategy.prepareOperations(this.dialect, builder.ops).flatMap((op) => this.compileOperation(op));
 			output += `# ${migration.id}\n`;
 			sqls.forEach((statement) => {
 				output += statement.sql + ";\n";
@@ -102,8 +132,7 @@ var MigrationRunner = class MigrationRunner {
 	*/
 	async status() {
 		const applied = await this.listApplied();
-		const migrations = await this.loadMigrations();
-		return migrations.map((m) => ({
+		return (await this.loadMigrations()).map((m) => ({
 			id: m.id,
 			applied: applied.has(m.id)
 		}));
@@ -152,8 +181,7 @@ var MigrationRunner = class MigrationRunner {
 	async applyMigration(migration) {
 		const builder = new CollectingBuilder();
 		await migration.up(builder);
-		const preparedOps = this.compilerStrategy.prepareOperations(this.dialect, builder.ops);
-		const sqls = preparedOps.flatMap((op) => this.compileOperation(op));
+		const sqls = this.compilerStrategy.prepareOperations(this.dialect, builder.ops).flatMap((op) => this.compileOperation(op));
 		const checksum = String(this.hashJSON(builder.ops));
 		const isOnline = (migration.mode ?? builder.getMode()) === "online";
 		if (!isOnline && this.dialect === InternalDialect.POSTGRES) await this.client.query("BEGIN");
@@ -188,7 +216,7 @@ var MigrationRunner = class MigrationRunner {
 		return this.compilerStrategy.compile(this.dialect, op);
 	}
 };
-
 //#endregion
-export { MigrationRunner, loadModule };
-//# sourceMappingURL=MigrationRunner-DomrOZIn.js.map
+export { loadModule as n, MigrationRunner as t };
+
+//# sourceMappingURL=MigrationRunner-B5AJel12.js.map

package/dist/MigrationRunner-B5AJel12.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRunner-B5AJel12.js","names":[],"sources":["../src/runtime/loadModule.ts","../src/runner/MigrationRunner.ts"],"sourcesContent":["import { resolve, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { createJiti } from 'jiti';\nimport { ModelRegistry } from '@danceroutine/tango-schema';\n\nconst TS_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts']);\n\nfunction toAbsolutePath(modulePath: string, projectRoot: string): string {\n    return resolve(projectRoot, modulePath);\n}\n\nfunction isTypeScriptModule(modulePath: string): boolean {\n    return TS_EXTENSIONS.has(extname(modulePath).toLowerCase());\n}\n\n/**\n * Load a module from a Tango app project root.\n *\n * TypeScript modules are loaded through jiti and JavaScript/ESM modules are loaded\n * through native dynamic import so published installs behave like end-user runtime.\n */\nexport async function loadModule(\n    modulePath: string,\n    options?: { projectRoot?: string; registry?: ModelRegistry; moduleCache?: boolean }\n): Promise<Record<string, unknown>> {\n    const projectRoot = options?.projectRoot ?? process.cwd();\n    const absolutePath = toAbsolutePath(modulePath, projectRoot);\n    const executeImport = async (): Promise<Record<string, unknown>> => {\n        if (isTypeScriptModule(absolutePath)) {\n            const jiti = createJiti(resolve(projectRoot, 'tango.config.ts'), {\n                interopDefault: true,\n                moduleCache: options?.moduleCache ?? true,\n            });\n            return (await jiti.import<Record<string, unknown>>(absolutePath)) as Record<string, unknown>;\n        }\n\n        return (await import(pathToFileURL(absolutePath).href)) as Record<string, unknown>;\n    };\n\n    if (options?.registry) {\n        return ModelRegistry.runWithRegistry(options.registry, executeImport);\n    }\n\n    return executeImport();\n}\n\n/**\n * Load a module and return default export when present.\n */\nexport async function loadDefaultExport(modulePath: string, options?: { projectRoot?: string }): Promise<unknown> {\n    const loaded = await loadModule(modulePath, options);\n    return loaded.default ?? loaded;\n}\n","import { CollectingBuilder } from '../builder/runtime/CollectingBuilder';\nimport type { Dialect } from '../domain/Dialect';\nimport { Migration } from '../domain/Migration';\nimport type { SQL } from '../compilers/contracts/SQL';\nimport type { MigrationOperation } from '../domain/MigrationOperation';\nimport type { CompilerStrategy } from '../strategies/CompilerStrategy';\nimport { createDefaultCompilerStrategy } from '../strategies/CompilerStrategy';\nimport { InternalDialect } from '../domain/internal/InternalDialect';\nimport { isError } from '@danceroutine/tango-core';\nimport { readdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { loadDefaultExport } from '../runtime/loadModule';\n\nconst JOURNAL = '_tango_migrations';\n\n/** DB client contract required by migration execution. */\ninterface DBClient {\n    /** Execute SQL with optional parameters. */\n    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }>;\n    /** Release underlying database resources. */\n    close(): Promise<void>;\n}\n\n/**\n * Manages the lifecycle of database migrations: applying, planning, and tracking status.\n *\n * The runner reads migration files from a directory, compiles operations to SQL\n * for the target dialect, and maintains a journal table to track which migrations\n * have been applied. Each applied migration is checksummed to detect tampering.\n *\n * @example\n * ```typescript\n * const runner = new MigrationRunner(client, 'postgres', './migrations');\n *\n * // Apply all pending migrations\n * await runner.apply();\n *\n * // Apply up to a specific migration\n * await runner.apply('003_add_indexes');\n *\n * // Preview the SQL that would be generated\n * const sql = await runner.plan();\n *\n * // Check which migrations are applied\n * const statuses = await runner.status();\n * ```\n */\nexport class MigrationRunner {\n    static readonly BRAND = 'tango.migrations.runner' as const;\n    readonly __tangoBrand: typeof MigrationRunner.BRAND = MigrationRunner.BRAND;\n    private compilerStrategy: CompilerStrategy;\n\n    constructor(\n        private client: DBClient,\n        private dialect: Dialect,\n        private migrationsDir: string = 'migrations',\n        compilerStrategy?: CompilerStrategy\n    ) {\n        this.compilerStrategy = compilerStrategy ?? createDefaultCompilerStrategy();\n    }\n\n    /**\n     * Narrow an unknown value to `MigrationRunner`.\n     */\n    static isMigrationRunner(value: unknown): value is MigrationRunner {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === MigrationRunner.BRAND\n        );\n    }\n\n    /**\n     * Apply all pending migrations, optionally stopping at a specific migration ID.\n     * Migrations are applied in file-sort order. Already-applied migrations are skipped.\n     * Non-online migrations are wrapped in a transaction on Postgres.\n     */\n    async apply(toId?: string): Promise<void> {\n        await this.ensureJournal();\n        const applied = await this.listApplied();\n        const migrations = await this.loadMigrations();\n\n        for (const migration of migrations) {\n            if (toId && migration.id > toId) {\n                break;\n            }\n            if (applied.has(migration.id)) {\n                continue;\n            }\n\n            await this.applyMigration(migration);\n        }\n    }\n\n    /**\n     * Generate a dry-run SQL plan for all migrations without executing anything.\n     * Useful for reviewing what SQL would be run before applying.\n     */\n    async plan(): Promise<string> {\n        const migrations = await this.loadMigrations();\n        let output = '';\n\n        migrations.forEach((migration) => {\n            const builder = new CollectingBuilder();\n            migration.up(builder);\n            const preparedOps = this.compilerStrategy.prepareOperations(this.dialect, builder.ops);\n            const sqls = preparedOps.flatMap((op) => this.compileOperation(op));\n\n            output += `# ${migration.id}\\n`;\n            sqls.forEach((statement) => {\n                output += statement.sql + ';\\n';\n            });\n            if (builder.dataFns.length) {\n                output += '-- (data step present)\\n';\n            }\n            output += '\\n';\n        });\n\n        return output;\n    }\n\n    /**\n     * Return the applied/pending status of every migration found on disk.\n     */\n    async status(): Promise<{ id: string; applied: boolean }[]> {\n        const applied = await this.listApplied();\n        const migrations = await this.loadMigrations();\n\n        return migrations.map((m) => ({\n            id: m.id,\n            applied: applied.has(m.id),\n        }));\n    }\n\n    private async ensureJournal(): Promise<void> {\n        const sql =\n            this.dialect === InternalDialect.POSTGRES\n                ? `CREATE TABLE IF NOT EXISTS \"${JOURNAL}\" (\n            id TEXT PRIMARY KEY,\n            applied_at TIMESTAMPTZ NOT NULL DEFAULT now(),\n            checksum TEXT NOT NULL\n          )`\n                : `CREATE TABLE IF NOT EXISTS ${JOURNAL} (\n            id TEXT PRIMARY KEY,\n            applied_at TEXT NOT NULL DEFAULT (datetime('now')),\n            checksum TEXT NOT NULL\n          )`;\n\n        await this.client.query(sql);\n    }\n\n    private async listApplied(): Promise<Set<string>> {\n        const table = this.dialect === InternalDialect.POSTGRES ? `\"${JOURNAL}\"` : JOURNAL;\n        const { rows } = await this.client.query<{ id: string }>(`SELECT id FROM ${table}`);\n        return new Set(rows.map((r) => r.id));\n    }\n\n    private async loadMigrations(): Promise<Migration[]> {\n        const files = (await readdir(this.migrationsDir)).filter((f) => f.endsWith('.ts') || f.endsWith('.js')).sort();\n\n        const migrations: Migration[] = [];\n\n        for (const file of files) {\n            const absolutePath = resolve(this.migrationsDir, file);\n            let loaded: unknown;\n            try {\n                loaded = await loadDefaultExport(absolutePath, { projectRoot: process.cwd() });\n            } catch (error) {\n                const reason = isError(error) ? error.message : String(error);\n                throw new Error(`Failed to load migration module '${file}': ${reason}`, { cause: error });\n            }\n\n            if (Migration.isMigration(loaded)) {\n                migrations.push(loaded);\n                continue;\n            }\n\n            if (Migration.isMigrationConstructor(loaded)) {\n                migrations.push(new loaded());\n                continue;\n            }\n\n            throw new Error(\n                `Invalid migration module '${file}'. Default export must be a Migration subclass or instance.`\n            );\n        }\n\n        return migrations;\n    }\n\n    private async applyMigration(migration: Migration): Promise<void> {\n        const builder = new CollectingBuilder();\n        await migration.up(builder);\n\n        const preparedOps = this.compilerStrategy.prepareOperations(this.dialect, builder.ops);\n        const sqls = preparedOps.flatMap((op) => this.compileOperation(op));\n        const checksum = String(this.hashJSON(builder.ops));\n\n        const isOnline = (migration.mode ?? builder.getMode()) === 'online';\n\n        if (!isOnline && this.dialect === InternalDialect.POSTGRES) {\n            await this.client.query('BEGIN');\n        }\n\n        try {\n            for (const statement of sqls) {\n                await this.client.query(statement.sql, statement.params);\n            }\n\n            for (const fn of builder.dataFns) {\n                await fn({ query: (sql, params) => this.client.query(sql, params).then(() => {}) });\n            }\n\n            const table = this.dialect === InternalDialect.POSTGRES ? `\"${JOURNAL}\"` : JOURNAL;\n            const placeholder = this.dialect === InternalDialect.POSTGRES ? '$1, $2' : '?, ?';\n            await this.client.query(`INSERT INTO ${table} (id, checksum) VALUES (${placeholder})`, [\n                migration.id,\n                checksum,\n            ]);\n\n            if (!isOnline && this.dialect === InternalDialect.POSTGRES) {\n                await this.client.query('COMMIT');\n            }\n        } catch (error) {\n            if (!isOnline && this.dialect === InternalDialect.POSTGRES) {\n                await this.client.query('ROLLBACK');\n            }\n            throw error;\n        }\n    }\n\n    /**\n     * Compute a simple hash of the migration's operation list.\n     * Stored alongside each applied migration in the journal table to detect\n     * if a migration file has been modified after it was already applied.\n     * Uses a djb2-like hash over the JSON-serialized operations.\n     */\n    private hashJSON(x: unknown): number {\n        const s = JSON.stringify(x);\n        let h = 0;\n        for (let i = 0; i < s.length; i++) {\n            // oxlint-disable-next-line prefer-code-point\n            h = Math.imul(31, h) + s.charCodeAt(i);\n            // oxlint-disable-next-line prefer-math-trunc\n            h = h | 0;\n        }\n        // oxlint-disable-next-line unicorn/prefer-math-trunc\n        return h >>> 0;\n    }\n\n    private compileOperation(op: MigrationOperation): SQL[] {\n        return this.compilerStrategy.compile(this.dialect, op);\n    }\n}\n"],"mappings":"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"}

package/dist/{MigrationSqlSafetyAdapter-CGRbB2k2.js → MigrationSqlSafetyAdapter-yP6fPjeC.js}

@@ -1,7 +1,12 @@
 import { SqlSafetyEngine, isTrustedSqlFragment, quoteSqlIdentifier } from "@danceroutine/tango-core";
-
 //#region src/internal/MigrationSqlSafetyAdapter.ts
+/**
+* Migrations-local adapter that maps migration operations into the shared SQL
+* safety engine and returns quoted identifiers or trusted raw fragments.
+*/
 var MigrationSqlSafetyAdapter = class {
+	dialect;
+	engine;
 	constructor(dialect, engine = new SqlSafetyEngine()) {
 		this.dialect = dialect;
 		this.engine = engine;
@@ -31,11 +36,11 @@ var MigrationSqlSafetyAdapter = class {
 		}] }).rawFragments[key].sql;
 	}
 	optionalRawFragment(key, value) {
-		if (!value) return undefined;
+		if (!value) return;
 		return this.rawFragment(key, value);
 	}
 	rawDefault(value, nowSql) {
-		if (value === undefined) return undefined;
+		if (value === void 0) return;
 		if (value === null) return null;
 		if (this.isNowDefault(value)) return nowSql;
 		return this.rawFragment("default", value);
@@ -44,19 +49,18 @@ var MigrationSqlSafetyAdapter = class {
 		return isTrustedSqlFragment(value);
 	}
 	quote(key, role, value, allowlist) {
-		const validated = this.engine.validate({ identifiers: [{
+		return quoteSqlIdentifier(this.engine.validate({ identifiers: [{
 			key,
 			role,
 			value,
 			allowlist
-		}] });
-		return quoteSqlIdentifier(validated.identifiers[key], this.dialect);
+		}] }).identifiers[key], this.dialect);
 	}
 	isNowDefault(value) {
 		return typeof value === "object" && value !== null && "now" in value && value.now === true;
 	}
 };
-
 //#endregion
-export { MigrationSqlSafetyAdapter };
-//# sourceMappingURL=MigrationSqlSafetyAdapter-CGRbB2k2.js.map
+export { MigrationSqlSafetyAdapter as t };
+
+//# sourceMappingURL=MigrationSqlSafetyAdapter-yP6fPjeC.js.map

package/dist/MigrationSqlSafetyAdapter-yP6fPjeC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationSqlSafetyAdapter-yP6fPjeC.js","names":[],"sources":["../src/internal/MigrationSqlSafetyAdapter.ts"],"sourcesContent":["import {\n    SqlSafetyEngine,\n    isTrustedSqlFragment,\n    quoteSqlIdentifier,\n    type SqlDialect,\n    type SqlIdentifierRole,\n    type TrustedSqlFragment,\n} from '@danceroutine/tango-core';\n\ntype IdentifierRole = Extract<SqlIdentifierRole, 'table' | 'column' | 'index' | 'constraint' | 'schema'>;\n\n/**\n * Migrations-local adapter that maps migration operations into the shared SQL\n * safety engine and returns quoted identifiers or trusted raw fragments.\n */\nexport class MigrationSqlSafetyAdapter {\n    constructor(\n        private readonly dialect: SqlDialect,\n        private readonly engine: SqlSafetyEngine = new SqlSafetyEngine()\n    ) {}\n\n    table(value: string): string {\n        return this.quote('table', 'table', value);\n    }\n\n    column(value: string, allowlist?: readonly string[]): string {\n        return this.quote('column', 'column', value, allowlist);\n    }\n\n    columns(values: readonly string[], allowlist?: readonly string[]): string[] {\n        return values.map((value, index) => this.quote(`column:${index}`, 'column', value, allowlist));\n    }\n\n    index(value: string): string {\n        return this.quote('index', 'index', value);\n    }\n\n    constraint(value: string): string {\n        return this.quote('constraint', 'constraint', value);\n    }\n\n    schema(value: string): string {\n        return this.quote('schema', 'schema', value);\n    }\n\n    rawFragment(key: string, value: TrustedSqlFragment): string {\n        return this.engine.validate({\n            rawFragments: [{ key, value }],\n        }).rawFragments[key]!.sql;\n    }\n\n    optionalRawFragment(key: string, value?: TrustedSqlFragment): string | undefined {\n        if (!value) {\n            return undefined;\n        }\n\n        return this.rawFragment(key, value);\n    }\n\n    rawDefault(\n        value: TrustedSqlFragment | { now: true } | null | undefined,\n        nowSql: string\n    ): string | null | undefined {\n        if (value === undefined) {\n            return undefined;\n        }\n\n        if (value === null) {\n            return null;\n        }\n\n        if (this.isNowDefault(value)) {\n            return nowSql;\n        }\n\n        return this.rawFragment('default', value);\n    }\n\n    isTrustedFragment(value: unknown): value is TrustedSqlFragment {\n        return isTrustedSqlFragment(value);\n    }\n\n    private quote(key: string, role: IdentifierRole, value: string, allowlist?: readonly string[]): string {\n        const validated = this.engine.validate({\n            identifiers: [{ key, role, value, allowlist }],\n        });\n\n        return quoteSqlIdentifier(validated.identifiers[key]!, this.dialect);\n    }\n\n    private isNowDefault(value: TrustedSqlFragment | { now: true }): value is { now: true } {\n        return typeof value === 'object' && value !== null && 'now' in value && value.now === true;\n    }\n}\n"],"mappings":";;;;;;AAeA,IAAa,4BAAb,MAAuC;CAEd;CACA;CAFrB,YACI,SACA,SAA2C,IAAI,gBAAgB,GACjE;EAFmB,KAAA,UAAA;EACA,KAAA,SAAA;CAClB;CAEH,MAAM,OAAuB;EACzB,OAAO,KAAK,MAAM,SAAS,SAAS,KAAK;CAC7C;CAEA,OAAO,OAAe,WAAuC;EACzD,OAAO,KAAK,MAAM,UAAU,UAAU,OAAO,SAAS;CAC1D;CAEA,QAAQ,QAA2B,WAAyC;EACxE,OAAO,OAAO,KAAK,OAAO,UAAU,KAAK,MAAM,UAAU,SAAS,UAAU,OAAO,SAAS,CAAC;CACjG;CAEA,MAAM,OAAuB;EACzB,OAAO,KAAK,MAAM,SAAS,SAAS,KAAK;CAC7C;CAEA,WAAW,OAAuB;EAC9B,OAAO,KAAK,MAAM,cAAc,cAAc,KAAK;CACvD;CAEA,OAAO,OAAuB;EAC1B,OAAO,KAAK,MAAM,UAAU,UAAU,KAAK;CAC/C;CAEA,YAAY,KAAa,OAAmC;EACxD,OAAO,KAAK,OAAO,SAAS,EACxB,cAAc,CAAC;GAAE;GAAK;EAAM,CAAC,EACjC,CAAC,EAAE,aAAa,KAAM;CAC1B;CAEA,oBAAoB,KAAa,OAAgD;EAC7E,IAAI,CAAC,OACD;EAGJ,OAAO,KAAK,YAAY,KAAK,KAAK;CACtC;CAEA,WACI,OACA,QACyB;EACzB,IAAI,UAAU,KAAA,GACV;EAGJ,IAAI,UAAU,MACV,OAAO;EAGX,IAAI,KAAK,aAAa,KAAK,GACvB,OAAO;EAGX,OAAO,KAAK,YAAY,WAAW,KAAK;CAC5C;CAEA,kBAAkB,OAA6C;EAC3D,OAAO,qBAAqB,KAAK;CACrC;CAEA,MAAc,KAAa,MAAsB,OAAe,WAAuC;EAKnG,OAAO,mBAJW,KAAK,OAAO,SAAS,EACnC,aAAa,CAAC;GAAE;GAAK;GAAM;GAAO;EAAU,CAAC,EACjD,CAEkC,EAAE,YAAY,MAAO,KAAK,OAAO;CACvE;CAEA,aAAqB,OAAmE;EACpF,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,SAAS,SAAS,MAAM,QAAQ;CAC1F;AACJ"}

package/dist/PostgresIntrospector-DQDTZUW_.d.ts

@@ -0,0 +1,77 @@
+//#region src/introspect/DatabaseIntrospector.d.ts
+/**
+ * Minimal DB client shape required by schema introspection.
+ */
+interface DBClient {
+  /** Execute a SQL statement and return row results. */
+  query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+    rows: T[];
+  }>;
+}
+/**
+ * Dialect-specific schema introspection contract.
+ */
+interface DatabaseIntrospector {
+  /** Read the current database schema state. */
+  introspect(client: DBClient): Promise<DbSchema>;
+}
+//#endregion
+//#region src/introspect/PostgresIntrospector.d.ts
+/** Introspected column metadata. */
+interface DbColumn {
+  name: string;
+  type: string;
+  notNull: boolean;
+  default: string | null;
+  isPk: boolean;
+  isUnique: boolean;
+}
+/** Introspected index metadata. */
+interface DbIndex {
+  name: string;
+  table: string;
+  unique: boolean;
+  columns: string[];
+  where: string | null;
+}
+/** Introspected foreign key metadata. */
+interface DbForeignKey {
+  name: string;
+  table: string;
+  columns: string[];
+  refTable: string;
+  refColumns: string[];
+  onDelete: string | null;
+  onUpdate: string | null;
+  validated: boolean;
+}
+/** Introspected table metadata. */
+interface DbTable {
+  name: string;
+  columns: Record<string, DbColumn>;
+  pks: string[];
+  indexes: Record<string, DbIndex>;
+  fks: Record<string, DbForeignKey>;
+}
+/** Introspected schema metadata. */
+interface DbSchema {
+  tables: Record<string, DbTable>;
+}
+/**
+ * PostgreSQL implementation of schema introspection.
+ */
+declare class PostgresIntrospector implements DatabaseIntrospector {
+  static readonly BRAND: "tango.migrations.postgres_introspector";
+  readonly __tangoBrand: typeof PostgresIntrospector.BRAND;
+  /**
+   * Narrow an unknown value to the PostgreSQL schema introspector.
+   */
+  static isPostgresIntrospector(value: unknown): value is PostgresIntrospector;
+  /**
+   * Read table and column metadata from PostgreSQL system catalogs.
+   */
+  introspect(client: DBClient): Promise<DbSchema>;
+}
+//#endregion
+export { DbTable as a, DatabaseIntrospector as c, DbSchema as i, DbForeignKey as n, PostgresIntrospector as o, DbIndex as r, DBClient as s, DbColumn as t };
+//# sourceMappingURL=PostgresIntrospector-DQDTZUW_.d.ts.map

package/dist/{SqliteCompilerFactory-BvdJ0kBl.js → SqliteCompilerFactory-CXlPAclY.js}

@@ -1,8 +1,10 @@
-import { InternalOperationKind } from "./InternalOperationKind-Bt6Weuon.js";
-import { InternalColumnType } from "./InternalColumnType-G9zV9StN.js";
-import { MigrationSqlSafetyAdapter } from "./MigrationSqlSafetyAdapter-CGRbB2k2.js";
-
+import { t as InternalColumnType } from "./InternalColumnType-Dzs9T6a6.js";
+import { t as InternalOperationKind } from "./InternalOperationKind-M4a4H9OZ.js";
+import { t as MigrationSqlSafetyAdapter } from "./MigrationSqlSafetyAdapter-yP6fPjeC.js";
 //#region src/compilers/dialects/PostgresCompiler.ts
+/**
+* PostgreSQL SQL compiler for migration operations.
+*/
 var PostgresCompiler = class PostgresCompiler {
 	static BRAND = "tango.migrations.postgres_compiler";
 	__tangoBrand = PostgresCompiler.BRAND;
@@ -21,7 +23,7 @@ var PostgresCompiler = class PostgresCompiler {
 		const tableCreates = [];
 		const remainder = [];
 		for (const operation of operations) if (operation.kind === InternalOperationKind.TABLE_CREATE) tableCreates.push(operation);
-else remainder.push(operation);
+		else remainder.push(operation);
 		const strippedCreates = [];
 		const foreignKeys = [];
 		for (const operation of tableCreates) {
@@ -54,9 +56,8 @@ else remainder.push(operation);
 					constraints.push(fk);
 				});
 				const allParts = [cols, ...constraints].join(", ");
-				const sql = `CREATE TABLE ${this.sqlSafety.table(op.table)} (${allParts})`;
 				return [{
-					sql,
+					sql: `CREATE TABLE ${this.sqlSafety.table(op.table)} (${allParts})`,
 					params: []
 				}];
 			}
@@ -78,7 +79,7 @@ else remainder.push(operation);
 					sql: `ALTER TABLE ${this.sqlSafety.table(op.table)} ALTER COLUMN ${this.sqlSafety.column(op.column)} TYPE ${this.typeToSQL(op.to.type)}`,
 					params: []
 				});
-				if (op.to.notNull !== undefined) out.push({
+				if (op.to.notNull !== void 0) out.push({
 					sql: `ALTER TABLE ${this.sqlSafety.table(op.table)} ALTER COLUMN ${this.sqlSafety.column(op.column)} ${op.to.notNull ? "SET NOT NULL" : "DROP NOT NULL"}`,
 					params: []
 				});
@@ -99,13 +100,10 @@ else remainder.push(operation);
 					params: []
 				}];
 			}
-			case InternalOperationKind.INDEX_DROP: {
-				const conc = op.concurrently ? "CONCURRENTLY " : "";
-				return [{
-					sql: `DROP INDEX ${conc}${this.sqlSafety.index(op.name)}`,
-					params: []
-				}];
-			}
+			case InternalOperationKind.INDEX_DROP: return [{
+				sql: `DROP INDEX ${op.concurrently ? "CONCURRENTLY " : ""}${this.sqlSafety.index(op.name)}`,
+				params: []
+			}];
 			case InternalOperationKind.FK_CREATE: {
 				const cols = this.sqlSafety.columns(op.columns).join(", ");
 				const refs = this.sqlSafety.columns(op.refColumns).join(", ");
@@ -134,7 +132,7 @@ else remainder.push(operation);
 	* Extracted to flatten the nested conditional logic.
 	*/
 	compileDefaultChange(table, column, defaultValue) {
-		if (defaultValue === undefined) return [];
+		if (defaultValue === void 0) return [];
 		if (defaultValue === null) return [{
 			sql: `ALTER TABLE ${this.sqlSafety.table(table)} ALTER COLUMN ${this.sqlSafety.column(column)} DROP DEFAULT`,
 			params: []
@@ -163,7 +161,7 @@ else remainder.push(operation);
 				onDelete: references.onDelete,
 				onUpdate: references.onUpdate
 			});
-			const { references: _references,...rest } = column;
+			const { references: _references, ...rest } = column;
 			return { ...rest };
 		});
 		return {
@@ -218,16 +216,15 @@ else remainder.push(operation);
 			case InternalColumnType.TIMESTAMPTZ: return "TIMESTAMPTZ";
 			case InternalColumnType.JSONB: return "JSONB";
 			case InternalColumnType.UUID: return "UUID";
-			default: {
-				const exhaustive = type;
-				throw new Error(`Unsupported column type: ${exhaustive}`);
-			}
+			default: throw new Error(`Unsupported column type: ${type}`);
 		}
 	}
 };
-
 //#endregion
 //#region src/compilers/factories/PostgresCompilerFactory.ts
+/**
+* Factory for PostgreSQL migration compilers.
+*/
 var PostgresCompilerFactory = class PostgresCompilerFactory {
 	static BRAND = "tango.migrations.postgres_compiler_factory";
 	__tangoBrand = PostgresCompilerFactory.BRAND;
@@ -244,9 +241,11 @@ var PostgresCompilerFactory = class PostgresCompilerFactory {
 		return new PostgresCompiler();
 	}
 };
-
 //#endregion
 //#region src/compilers/dialects/SqliteCompiler.ts
+/**
+* SQLite SQL compiler for migration operations.
+*/
 var SqliteCompiler = class SqliteCompiler {
 	static BRAND = "tango.migrations.sqlite_compiler";
 	__tangoBrand = SqliteCompiler.BRAND;
@@ -265,7 +264,7 @@ var SqliteCompiler = class SqliteCompiler {
 		const tableCreates = [];
 		const remainder = [];
 		for (const operation of operations) if (operation.kind === InternalOperationKind.TABLE_CREATE) tableCreates.push(operation);
-else remainder.push(operation);
+		else remainder.push(operation);
 		const preparedRemainder = remainder.flatMap((operation) => operation.kind === InternalOperationKind.COLUMN_ADD ? this.prepareColumnAdd(operation) : [operation]);
 		return [...this.topologicalSortTableCreatesWithReferences(tableCreates), ...preparedRemainder];
 	}
@@ -282,9 +281,8 @@ else remainder.push(operation);
 					const references = column.references;
 					cols.push(`FOREIGN KEY (${this.sqlSafety.column(column.name)}) REFERENCES ${this.sqlSafety.table(references.table)}(${this.sqlSafety.column(references.column)})${references.onDelete ? ` ON DELETE ${references.onDelete}` : ""}${references.onUpdate ? ` ON UPDATE ${references.onUpdate}` : ""}`);
 				});
-				const sql = `CREATE TABLE ${this.sqlSafety.table(op.table)} (${cols.join(", ")})`;
 				return [{
-					sql,
+					sql: `CREATE TABLE ${this.sqlSafety.table(op.table)} (${cols.join(", ")})`,
 					params: []
 				}];
 			}
@@ -363,33 +361,31 @@ else remainder.push(operation);
 	}
 	prepareColumnAdd(op) {
 		const preparedColumn = op.column;
-		if (preparedColumn.notNull && preparedColumn.default === undefined && !preparedColumn.primaryKey) throw new Error(`SQLite cannot add NOT NULL column '${preparedColumn.name}' to '${op.table}' without a default or backfill path.`);
+		if (preparedColumn.notNull && preparedColumn.default === void 0 && !preparedColumn.primaryKey) throw new Error(`SQLite cannot add NOT NULL column '${preparedColumn.name}' to '${op.table}' without a default or backfill path.`);
 		if (!preparedColumn.unique) return [op];
-		const addColumn = {
+		return [{
 			...op,
 			column: {
 				...preparedColumn,
 				unique: false
 			}
-		};
-		const createIndex = {
+		}, {
 			kind: InternalOperationKind.INDEX_CREATE,
 			name: `${op.table}_${preparedColumn.name}_idx`,
 			table: op.table,
 			on: [preparedColumn.name],
 			unique: true
-		};
-		return [addColumn, createIndex];
+		}];
 	}
 	topologicalSortTableCreatesWithReferences(creates) {
 		if (creates.length <= 1) return creates;
 		const tableSet = new Set(creates.map((create) => create.table));
 		const byTable = new Map(creates.map((create) => [create.table, create]));
-		const incoming = new Map();
-		const dependents = new Map();
+		const incoming = /* @__PURE__ */ new Map();
+		const dependents = /* @__PURE__ */ new Map();
 		for (const table of tableSet) incoming.set(table, 0);
 		for (const create of creates) {
-			const seenParents = new Set();
+			const seenParents = /* @__PURE__ */ new Set();
 			for (const column of create.columns) {
 				if (!column.references) continue;
 				const refTable = column.references.table;
@@ -397,7 +393,7 @@ else remainder.push(operation);
 				if (seenParents.has(refTable)) continue;
 				seenParents.add(refTable);
 				incoming.set(create.table, incoming.get(create.table) + 1);
-				if (!dependents.has(refTable)) dependents.set(refTable, new Set());
+				if (!dependents.has(refTable)) dependents.set(refTable, /* @__PURE__ */ new Set());
 				dependents.get(refTable).add(create.table);
 			}
 		}
@@ -419,9 +415,11 @@ else remainder.push(operation);
 		return sorted;
 	}
 };
-
 //#endregion
 //#region src/compilers/factories/SqliteCompilerFactory.ts
+/**
+* Factory for SQLite migration compilers.
+*/
 var SqliteCompilerFactory = class SqliteCompilerFactory {
 	static BRAND = "tango.migrations.sqlite_compiler_factory";
 	__tangoBrand = SqliteCompilerFactory.BRAND;
@@ -438,7 +436,7 @@ var SqliteCompilerFactory = class SqliteCompilerFactory {
 		return new SqliteCompiler();
 	}
 };
-
 //#endregion
-export { PostgresCompiler, PostgresCompilerFactory, SqliteCompiler, SqliteCompilerFactory };
-//# sourceMappingURL=SqliteCompilerFactory-BvdJ0kBl.js.map
+export { PostgresCompiler as i, SqliteCompiler as n, PostgresCompilerFactory as r, SqliteCompilerFactory as t };
+
+//# sourceMappingURL=SqliteCompilerFactory-CXlPAclY.js.map