@danceroutine/tango-migrations 0.1.0 → 1.0.0

package/dist/compilers/contracts/CompilerFactory.d.ts

@@ -1,4 +1,8 @@
 import type { SQLCompiler } from './SQLCompiler';
+/**
+ * Factory contract for SQL compiler instances.
+ */
 export interface CompilerFactory {
+    /** Create a compiler instance. */
     create(): SQLCompiler;
 }

package/dist/compilers/contracts/SQLCompiler.d.ts

@@ -1,5 +1,9 @@
 import type { MigrationOperation } from '../../domain/MigrationOperation';
 import type { SQL } from './SQL';
+/**
+ * Contract for dialect-specific migration SQL compilers.
+ */
 export interface SQLCompiler {
+    /** Compile an operation into SQL statements. */
     compile(operation: MigrationOperation): SQL[];
 }

package/dist/compilers/dialects/PostgresCompiler.d.ts

@@ -1,17 +1,26 @@
 import type { MigrationOperation } from '../../domain/MigrationOperation';
 import type { SQL } from '../contracts/SQL';
 import type { SQLCompiler } from '../contracts/SQLCompiler';
+/**
+ * PostgreSQL SQL compiler for migration operations.
+ */
 export declare class PostgresCompiler implements SQLCompiler {
     static readonly BRAND: "tango.migrations.postgres_compiler";
     readonly __tangoBrand: typeof PostgresCompiler.BRAND;
+    private readonly sqlSafety;
+    /**
+     * Narrow an unknown value to the PostgreSQL migration compiler implementation.
+     */
     static isPostgresCompiler(value: unknown): value is PostgresCompiler;
+    /**
+     * Compile a migration operation into one or more PostgreSQL statements.
+     */
     compile(op: MigrationOperation): SQL[];
     /**
      * Compile a DEFAULT value change into ALTER TABLE statements.
      * Extracted to flatten the nested conditional logic.
      */
     private compileDefaultChange;
-    private id;
     private colDDL;
     private typeToSQL;
 }

package/dist/compilers/dialects/SqliteCompiler.d.ts

@@ -1,10 +1,20 @@
 import type { MigrationOperation } from '../../domain/MigrationOperation';
 import type { SQL } from '../contracts/SQL';
 import type { SQLCompiler } from '../contracts/SQLCompiler';
+/**
+ * SQLite SQL compiler for migration operations.
+ */
 export declare class SqliteCompiler implements SQLCompiler {
     static readonly BRAND: "tango.migrations.sqlite_compiler";
     readonly __tangoBrand: typeof SqliteCompiler.BRAND;
+    private readonly sqlSafety;
+    /**
+     * Narrow an unknown value to the SQLite migration compiler implementation.
+     */
     static isSqliteCompiler(value: unknown): value is SqliteCompiler;
+    /**
+     * Compile a migration operation into one or more SQLite statements.
+     */
     compile(op: MigrationOperation): SQL[];
     private colDDL;
 }

package/dist/compilers/factories/PostgresCompilerFactory.d.ts

@@ -1,8 +1,17 @@
 import type { CompilerFactory } from '../contracts/CompilerFactory';
 import type { SQLCompiler } from '../contracts/SQLCompiler';
+/**
+ * Factory for PostgreSQL migration compilers.
+ */
 export declare class PostgresCompilerFactory implements CompilerFactory {
     static readonly BRAND: "tango.migrations.postgres_compiler_factory";
     readonly __tangoBrand: typeof PostgresCompilerFactory.BRAND;
+    /**
+     * Narrow an unknown value to the factory that provisions PostgreSQL compilers.
+     */
     static isPostgresCompilerFactory(value: unknown): value is PostgresCompilerFactory;
+    /**
+     * Create a PostgreSQL SQL compiler instance.
+     */
     create(): SQLCompiler;
 }

package/dist/compilers/factories/SqliteCompilerFactory.d.ts

@@ -1,8 +1,17 @@
 import type { CompilerFactory } from '../contracts/CompilerFactory';
 import type { SQLCompiler } from '../contracts/SQLCompiler';
+/**
+ * Factory for SQLite migration compilers.
+ */
 export declare class SqliteCompilerFactory implements CompilerFactory {
     static readonly BRAND: "tango.migrations.sqlite_compiler_factory";
     readonly __tangoBrand: typeof SqliteCompilerFactory.BRAND;
+    /**
+     * Narrow an unknown value to the factory that provisions SQLite compilers.
+     */
     static isSqliteCompilerFactory(value: unknown): value is SqliteCompilerFactory;
+    /**
+     * Create a SQLite SQL compiler instance.
+     */
     create(): SQLCompiler;
 }

package/dist/compilers/index.js

@@ -1,6 +1,7 @@
-import "../InternalOperationKind-BPVoOQwD.js";
-import "../InternalColumnType-_YAz7RqI.js";
-import { PostgresCompiler, PostgresCompilerFactory, SqliteCompiler, SqliteCompilerFactory } from "../SqliteCompilerFactory-DwMwO7xY.js";
-import { contracts_exports$1 as contracts_exports, dialects_exports, factories_exports } from "../compilers-D8DJuTnQ.js";
+import "../InternalOperationKind-Bt6Weuon.js";
+import "../InternalColumnType-G9zV9StN.js";
+import "../MigrationSqlSafetyAdapter-CGRbB2k2.js";
+import { PostgresCompiler, PostgresCompilerFactory, SqliteCompiler, SqliteCompilerFactory } from "../SqliteCompilerFactory-BAodJW9n.js";
+import { contracts_exports$1 as contracts_exports, dialects_exports, factories_exports } from "../compilers-dRN0Hzev.js";
 
 export { PostgresCompiler, PostgresCompilerFactory, SqliteCompiler, SqliteCompilerFactory, contracts_exports as contracts, dialects_exports as dialects, factories_exports as factories };

package/dist/{compilers-D8DJuTnQ.js → compilers-dRN0Hzev.js}

@@ -1,5 +1,5 @@
 import { __export } from "./chunk-BkvOhyD0.js";
-import { PostgresCompiler, PostgresCompilerFactory, SqliteCompiler, SqliteCompilerFactory } from "./SqliteCompilerFactory-DwMwO7xY.js";
+import { PostgresCompiler, PostgresCompilerFactory, SqliteCompiler, SqliteCompilerFactory } from "./SqliteCompilerFactory-BAodJW9n.js";
 
 //#region src/compilers/contracts/index.ts
 var contracts_exports = {};
@@ -35,4 +35,4 @@ __export(compilers_exports, {
 
 //#endregion
 export { compilers_exports, contracts_exports as contracts_exports$1, dialects_exports, factories_exports };
-//# sourceMappingURL=compilers-D8DJuTnQ.js.map
+//# sourceMappingURL=compilers-dRN0Hzev.js.map

package/dist/{compilers-D8DJuTnQ.js.map → compilers-dRN0Hzev.js.map}

@@ -1 +1 @@
-{"version":3,"file":"compilers-D8DJuTnQ.js","names":[],"sources":["../src/compilers/contracts/index.ts","../src/compilers/dialects/index.ts","../src/compilers/factories/index.ts","../src/compilers/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { SQL } from './SQL';\nexport type { SQLCompiler } from './SQLCompiler';\nexport type { CompilerFactory } from './CompilerFactory';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresCompiler } from './PostgresCompiler';\nexport { SqliteCompiler } from './SqliteCompiler';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresCompilerFactory } from './PostgresCompilerFactory';\nexport { SqliteCompilerFactory } from './SqliteCompilerFactory';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as contracts from './contracts/index';\nexport * as dialects from './dialects/index';\nexport * as factories from './factories/index';\n\nexport type { SQL, SQLCompiler, CompilerFactory } from './contracts/index';\nexport { PostgresCompiler, SqliteCompiler } from './dialects/index';\nexport * from './factories/index';\n"],"mappings":""}
+{"version":3,"file":"compilers-dRN0Hzev.js","names":[],"sources":["../src/compilers/contracts/index.ts","../src/compilers/dialects/index.ts","../src/compilers/factories/index.ts","../src/compilers/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { SQL } from './SQL';\nexport type { SQLCompiler } from './SQLCompiler';\nexport type { CompilerFactory } from './CompilerFactory';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresCompiler } from './PostgresCompiler';\nexport { SqliteCompiler } from './SqliteCompiler';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresCompilerFactory } from './PostgresCompilerFactory';\nexport { SqliteCompilerFactory } from './SqliteCompilerFactory';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as contracts from './contracts/index';\nexport * as dialects from './dialects/index';\nexport * as factories from './factories/index';\n\nexport type { SQL, SQLCompiler, CompilerFactory } from './contracts/index';\nexport { PostgresCompiler, SqliteCompiler } from './dialects/index';\nexport * from './factories/index';\n"],"mappings":""}

package/dist/diff/diffSchema.d.ts

@@ -24,10 +24,15 @@ type ModelIndex = {
     on: string[];
     unique?: boolean;
 };
-type ModelMetadataLike = {
+export type ModelMetadataLike = {
+    name?: string;
     table: string;
     fields: ModelField[];
     indexes?: ModelIndex[];
 };
+/**
+ * Compare model metadata with an introspected database schema and return the
+ * operations needed to bring the database into alignment.
+ */
 export declare function diffSchema(db: DbSchema, models: ModelMetadataLike[]): MigrationOperation[];
 export {};

package/dist/diff/index.js

@@ -1,8 +1,8 @@
-import "../CollectingBuilder-C6qnwyrb.js";
-import "../InternalOperationKind-BPVoOQwD.js";
-import "../InternalColumnType-_YAz7RqI.js";
-import "../builder-Dtk8oP_Y.js";
-import { diffSchema } from "../diffSchema-KgGHP-s3.js";
-import "../diff-Cs0TPEGR.js";
+import "../CollectingBuilder--4fqDQdE.js";
+import "../InternalOperationKind-Bt6Weuon.js";
+import "../InternalColumnType-G9zV9StN.js";
+import "../builder-xJ-Bq2pk.js";
+import { diffSchema } from "../diffSchema-D4oemTWS.js";
+import "../diff-CZZbXAPN.js";
 
 export { diffSchema };

package/dist/{diff-Cs0TPEGR.js → diff-CZZbXAPN.js}

@@ -1,5 +1,5 @@
 import { __export } from "./chunk-BkvOhyD0.js";
-import { diffSchema } from "./diffSchema-KgGHP-s3.js";
+import { diffSchema } from "./diffSchema-D4oemTWS.js";
 
 //#region src/diff/index.ts
 var diff_exports = {};
@@ -7,4 +7,4 @@ __export(diff_exports, { diffSchema: () => diffSchema });
 
 //#endregion
 export { diff_exports };
-//# sourceMappingURL=diff-Cs0TPEGR.js.map
+//# sourceMappingURL=diff-CZZbXAPN.js.map

package/dist/{diff-Cs0TPEGR.js.map → diff-CZZbXAPN.js.map}

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

package/dist/{diffSchema-KgGHP-s3.js → diffSchema-D4oemTWS.js}

@@ -1,4 +1,5 @@
-import { OpBuilder, applyFieldType } from "./builder-Dtk8oP_Y.js";
+import { OpBuilder, applyFieldType } from "./builder-xJ-Bq2pk.js";
+import { trustedSql } from "@danceroutine/tango-core";
 
 //#region src/diff/diffSchema.ts
 function diffSchema(db, models) {
@@ -15,7 +16,7 @@ function diffSchema(db, models) {
 						if (field.notNull) builder = builder.notNull();
 						if (field.default === null) builder = builder.default(null);
 else if (field.default && typeof field.default === "object" && "now" in field.default) builder = builder.defaultNow();
-else if (typeof field.default === "string") builder = builder.default(field.default);
+else if (typeof field.default === "string") builder = builder.default(trustedSql(field.default));
 						if (field.primaryKey) builder = builder.primaryKey();
 						if (field.unique) builder = builder.unique();
 						if (field.references) builder = builder.references(field.references.table, field.references.column, {
@@ -44,7 +45,7 @@ else if (typeof field.default === "string") builder = builder.default(field.defa
 				if (field.notNull) builder = builder.notNull();
 				if (field.default === null) builder = builder.default(null);
 else if (field.default && typeof field.default === "object" && "now" in field.default) builder = builder.defaultNow();
-else if (typeof field.default === "string") builder = builder.default(field.default);
+else if (typeof field.default === "string") builder = builder.default(trustedSql(field.default));
 				if (field.primaryKey) builder = builder.primaryKey();
 				if (field.unique) builder = builder.unique();
 				if (field.references) builder = builder.references(field.references.table, field.references.column, {
@@ -83,4 +84,4 @@ else if (typeof field.default === "string") builder = builder.default(field.defa
 
 //#endregion
 export { diffSchema };
-//# sourceMappingURL=diffSchema-KgGHP-s3.js.map
+//# sourceMappingURL=diffSchema-D4oemTWS.js.map

package/dist/diffSchema-D4oemTWS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffSchema-D4oemTWS.js","names":["db: DbSchema","models: ModelMetadataLike[]","ops: MigrationOperation[]"],"sources":["../src/diff/diffSchema.ts"],"sourcesContent":["import { trustedSql } from '@danceroutine/tango-core';\nimport type { DbSchema } from '../introspect/PostgresIntrospector';\nimport type { MigrationOperation } from '../domain/MigrationOperation';\nimport type { ColumnType } from '../builder/contracts/ColumnType';\nimport type { DeleteReferentialAction } from '../builder/contracts/DeleteReferentialAction';\nimport type { UpdateReferentialAction } from '../builder/contracts/UpdateReferentialAction';\nimport { op, applyFieldType } from '../builder/index';\n\ntype ModelField = {\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\ntype ModelIndex = {\n    name: string;\n    on: string[];\n    unique?: boolean;\n};\n\nexport type ModelMetadataLike = {\n    name?: string;\n    table: string;\n    fields: ModelField[];\n    indexes?: ModelIndex[];\n};\n\n/**\n * Compare model metadata with an introspected database schema and return the\n * operations needed to bring the database into alignment.\n */\nexport function diffSchema(db: DbSchema, models: ModelMetadataLike[]): MigrationOperation[] {\n    const ops: MigrationOperation[] = [];\n    const modelTables = new Set(models.map((model) => model.table));\n    const internalTables = new Set(['_tango_migrations']);\n\n    models.forEach((model) => {\n        const dbTable = db.tables[model.table];\n\n        if (!dbTable) {\n            ops.push(\n                op.table(model.table).create((cols) => {\n                    model.fields.forEach((field) => {\n                        cols.add(field.name, (builder) => {\n                            builder = applyFieldType(builder, field.type);\n\n                            if (field.notNull) {\n                                builder = builder.notNull();\n                            }\n\n                            if (field.default === null) {\n                                builder = builder.default(null);\n                            } else if (field.default && typeof field.default === 'object' && 'now' in field.default) {\n                                builder = builder.defaultNow();\n                            } else if (typeof field.default === 'string') {\n                                builder = builder.default(trustedSql(field.default));\n                            }\n\n                            if (field.primaryKey) {\n                                builder = builder.primaryKey();\n                            }\n\n                            if (field.unique) {\n                                builder = builder.unique();\n                            }\n\n                            if (field.references) {\n                                builder = builder.references(field.references.table, field.references.column, {\n                                    onDelete: field.references.onDelete,\n                                    onUpdate: field.references.onUpdate,\n                                });\n                            }\n\n                            return builder;\n                        });\n                    });\n                })\n            );\n\n            (model.indexes ?? []).forEach((index) => {\n                ops.push(\n                    op.index.create({\n                        name: index.name,\n                        table: model.table,\n                        on: index.on,\n                        unique: !!index.unique,\n                    })\n                );\n            });\n            return;\n        }\n\n        const modelFieldNames = new Set(model.fields.map((field) => field.name));\n        const dbFieldNames = new Set(Object.keys(dbTable.columns));\n\n        model.fields.forEach((field) => {\n            if (!dbFieldNames.has(field.name)) {\n                ops.push(\n                    op.table(model.table).addColumn(field.name, (builder) => {\n                        builder = applyFieldType(builder, field.type);\n\n                        if (field.notNull) {\n                            builder = builder.notNull();\n                        }\n                        if (field.default === null) {\n                            builder = builder.default(null);\n                        } else if (field.default && typeof field.default === 'object' && 'now' in field.default) {\n                            builder = builder.defaultNow();\n                        } else if (typeof field.default === 'string') {\n                            builder = builder.default(trustedSql(field.default));\n                        }\n                        if (field.primaryKey) {\n                            builder = builder.primaryKey();\n                        }\n                        if (field.unique) {\n                            builder = builder.unique();\n                        }\n                        if (field.references) {\n                            builder = builder.references(field.references.table, field.references.column, {\n                                onDelete: field.references.onDelete,\n                                onUpdate: field.references.onUpdate,\n                            });\n                        }\n\n                        return builder;\n                    })\n                );\n            }\n        });\n\n        dbFieldNames.forEach((dbColumnName) => {\n            if (!modelFieldNames.has(dbColumnName)) {\n                ops.push(op.table(model.table).dropColumn(dbColumnName));\n            }\n        });\n\n        const modelIndexes = new Map((model.indexes ?? []).map((index) => [index.name, index] as const));\n        const dbIndexNames = new Set(Object.keys(dbTable.indexes));\n\n        modelIndexes.forEach((index, indexName) => {\n            if (!dbIndexNames.has(indexName)) {\n                ops.push(\n                    op.index.create({\n                        name: index.name,\n                        table: model.table,\n                        on: index.on,\n                        unique: !!index.unique,\n                    })\n                );\n            }\n        });\n\n        dbIndexNames.forEach((dbIndexName) => {\n            if (!modelIndexes.has(dbIndexName)) {\n                ops.push(\n                    op.index.drop({\n                        name: dbIndexName,\n                        table: model.table,\n                    })\n                );\n            }\n        });\n    });\n\n    Object.keys(db.tables).forEach((dbTableName) => {\n        if (internalTables.has(dbTableName)) {\n            return;\n        }\n        if (!modelTables.has(dbTableName)) {\n            ops.push(op.table(dbTableName).drop());\n        }\n    });\n\n    return ops;\n}\n"],"mappings":"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"}

package/dist/domain/Migration.d.ts

@@ -1,12 +1,29 @@
 import type { Builder } from '../builder/contracts/Builder';
 import type { MigrationMode } from './MigrationMode';
+/**
+ * Base migration contract.
+ *
+ * Concrete migrations provide a stable `id` and define reversible schema/data
+ * operations through `up` and `down`.
+ */
 export declare abstract class Migration {
     static readonly BRAND: "tango.migration";
+    static readonly CONSTRUCTOR_BRAND: "tango.migration.constructor";
+    static readonly __tangoConstructorBrand: typeof Migration.CONSTRUCTOR_BRAND;
     readonly __tangoBrand: typeof Migration.BRAND;
     abstract id: string;
+    /** Optional execution mode override (`online`/`offline`). */
     mode?: MigrationMode;
+    /** Apply migration operations. */
     abstract up(m: Builder): void | Promise<void>;
+    /** Revert migration operations. */
     abstract down(m: Builder): void | Promise<void>;
+    /**
+     * Narrow an unknown value to a migration instance.
+     */
     static isMigration(value: unknown): value is Migration;
+    /**
+     * Narrow an unknown value to a migration constructor.
+     */
     static isMigrationConstructor(value: unknown): value is new () => Migration;
 }

package/dist/domain/MigrationOperation.d.ts

@@ -1,54 +1,55 @@
-import type { InternalOperationKind } from './internal/InternalOperationKind';
+import type { TrustedSqlFragment } from '@danceroutine/tango-core';
+import { InternalOperationKind } from './internal/InternalOperationKind';
 import type { ColumnSpec } from '../builder/contracts/ColumnSpec';
 export type TableCreate = {
-    kind: InternalOperationKind.TABLE_CREATE;
+    kind: typeof InternalOperationKind.TABLE_CREATE;
     table: string;
     columns: ColumnSpec[];
 };
 export type TableDrop = {
-    kind: InternalOperationKind.TABLE_DROP;
+    kind: typeof InternalOperationKind.TABLE_DROP;
     table: string;
     cascade?: boolean;
 };
 export type ColumnAdd = {
-    kind: InternalOperationKind.COLUMN_ADD;
+    kind: typeof InternalOperationKind.COLUMN_ADD;
     table: string;
     column: ColumnSpec;
 };
 export type ColumnDrop = {
-    kind: InternalOperationKind.COLUMN_DROP;
+    kind: typeof InternalOperationKind.COLUMN_DROP;
     table: string;
     column: string;
 };
 export type ColumnAlter = {
-    kind: InternalOperationKind.COLUMN_ALTER;
+    kind: typeof InternalOperationKind.COLUMN_ALTER;
     table: string;
     column: string;
     to: Partial<ColumnSpec>;
 };
 export type ColumnRename = {
-    kind: InternalOperationKind.COLUMN_RENAME;
+    kind: typeof InternalOperationKind.COLUMN_RENAME;
     table: string;
     from: string;
     to: string;
 };
 export type IndexCreate = {
-    kind: InternalOperationKind.INDEX_CREATE;
+    kind: typeof InternalOperationKind.INDEX_CREATE;
     table: string;
     name: string;
     on: string[];
     unique?: boolean;
-    where?: string;
+    where?: TrustedSqlFragment;
     concurrently?: boolean;
 };
 export type IndexDrop = {
-    kind: InternalOperationKind.INDEX_DROP;
+    kind: typeof InternalOperationKind.INDEX_DROP;
     table: string;
     name: string;
     concurrently?: boolean;
 };
 export type ForeignKeyCreate = {
-    kind: InternalOperationKind.FK_CREATE;
+    kind: typeof InternalOperationKind.FK_CREATE;
     table: string;
     name?: string;
     columns: string[];
@@ -59,12 +60,12 @@ export type ForeignKeyCreate = {
     notValid?: boolean;
 };
 export type ForeignKeyValidate = {
-    kind: InternalOperationKind.FK_VALIDATE;
+    kind: typeof InternalOperationKind.FK_VALIDATE;
     table: string;
     name: string;
 };
 export type ForeignKeyDrop = {
-    kind: InternalOperationKind.FK_DROP;
+    kind: typeof InternalOperationKind.FK_DROP;
     table: string;
     name: string;
 };

package/dist/domain/index.js

@@ -1,4 +1,4 @@
-import { Migration } from "../Migration-D9J6ZbLP.js";
-import "../domain-BXVlG0C0.js";
+import { Migration } from "../Migration-DYQ0hUG7.js";
+import "../domain-CwR-kUNS.js";
 
 export { Migration };

package/dist/domain/internal/InternalColumnType.d.ts

@@ -1,10 +1,11 @@
-export declare enum InternalColumnType {
-    SERIAL = "serial",
-    INT = "int",
-    BIGINT = "bigint",
-    TEXT = "text",
-    BOOL = "bool",
-    TIMESTAMPTZ = "timestamptz",
-    JSONB = "jsonb",
-    UUID = "uuid"
-}
+export 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";
+};
+export type InternalColumnType = (typeof InternalColumnType)[keyof typeof InternalColumnType];

package/dist/domain/internal/InternalDialect.d.ts

@@ -1,4 +1,5 @@
-export declare enum InternalDialect {
-    POSTGRES = "postgres",
-    SQLITE = "sqlite"
-}
+export declare const InternalDialect: {
+    readonly POSTGRES: "postgres";
+    readonly SQLITE: "sqlite";
+};
+export type InternalDialect = (typeof InternalDialect)[keyof typeof InternalDialect];

package/dist/domain/internal/InternalMigrationMode.d.ts

@@ -1,4 +1,5 @@
-export declare enum InternalMigrationMode {
-    TRANSACTIONAL = "transactional",
-    ONLINE = "online"
-}
+export declare const InternalMigrationMode: {
+    readonly TRANSACTIONAL: "transactional";
+    readonly ONLINE: "online";
+};
+export type InternalMigrationMode = (typeof InternalMigrationMode)[keyof typeof InternalMigrationMode];

package/dist/domain/internal/InternalOperationKind.d.ts

@@ -1,13 +1,14 @@
-export declare enum InternalOperationKind {
-    TABLE_CREATE = "table.create",
-    TABLE_DROP = "table.drop",
-    COLUMN_ADD = "column.add",
-    COLUMN_DROP = "column.drop",
-    COLUMN_ALTER = "column.alter",
-    COLUMN_RENAME = "column.rename",
-    INDEX_CREATE = "index.create",
-    INDEX_DROP = "index.drop",
-    FK_CREATE = "fk.create",
-    FK_VALIDATE = "fk.validate",
-    FK_DROP = "fk.drop"
-}
+export 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";
+};
+export type InternalOperationKind = (typeof InternalOperationKind)[keyof typeof InternalOperationKind];

package/dist/domain/internal/InternalReferentialAction.d.ts

@@ -1,6 +1,7 @@
-export declare enum InternalReferentialAction {
-    CASCADE = "CASCADE",
-    SET_NULL = "SET NULL",
-    RESTRICT = "RESTRICT",
-    NO_ACTION = "NO ACTION"
-}
+export declare const InternalReferentialAction: {
+    readonly CASCADE: "CASCADE";
+    readonly SET_NULL: "SET NULL";
+    readonly RESTRICT: "RESTRICT";
+    readonly NO_ACTION: "NO ACTION";
+};
+export type InternalReferentialAction = (typeof InternalReferentialAction)[keyof typeof InternalReferentialAction];

package/dist/{domain-BXVlG0C0.js → domain-CwR-kUNS.js}

@@ -1,5 +1,5 @@
 import { __export } from "./chunk-BkvOhyD0.js";
-import { Migration } from "./Migration-D9J6ZbLP.js";
+import { Migration } from "./Migration-DYQ0hUG7.js";
 
 //#region src/domain/index.ts
 var domain_exports = {};
@@ -7,4 +7,4 @@ __export(domain_exports, { Migration: () => Migration });
 
 //#endregion
 export { domain_exports };
-//# sourceMappingURL=domain-BXVlG0C0.js.map
+//# sourceMappingURL=domain-CwR-kUNS.js.map

package/dist/{domain-BXVlG0C0.js.map → domain-CwR-kUNS.js.map}

@@ -1 +1 @@
-{"version":3,"file":"domain-BXVlG0C0.js","names":[],"sources":["../src/domain/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { Dialect } from './Dialect';\nexport { Migration } from './Migration';\nexport type { MigrationMode } from './MigrationMode';\nexport type { MigrationOperation } from './MigrationOperation';\n"],"mappings":""}
+{"version":3,"file":"domain-CwR-kUNS.js","names":[],"sources":["../src/domain/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { Dialect } from './Dialect';\nexport { Migration } from './Migration';\nexport type { MigrationMode } from './MigrationMode';\nexport type { MigrationOperation } from './MigrationOperation';\n"],"mappings":""}

package/dist/generator/MigrationGenerator.d.ts

@@ -1,12 +1,24 @@
 import type { MigrationOperation } from '../domain/MigrationOperation';
+/**
+ * Input contract for generating a migration source file.
+ */
 export interface GenerateMigrationOptions {
+    /** Human-readable suffix used in file name/id generation. */
     name: string;
+    /** Ordered migration operations to render. */
     operations: MigrationOperation[];
+    /** Output directory for generated migration files. */
     directory: string;
 }
+/**
+ * Source generator for class-based migration files.
+ */
 export declare class MigrationGenerator {
     static readonly BRAND: "tango.migrations.generator";
     readonly __tangoBrand: typeof MigrationGenerator.BRAND;
+    /**
+     * Narrow an unknown value to `MigrationGenerator`.
+     */
     static isMigrationGenerator(value: unknown): value is MigrationGenerator;
     /**
      * Generate a migration file and write it to disk.
@@ -32,4 +44,5 @@ export declare class MigrationGenerator {
     private renderForeignKeyDrop;
     private renderColumnChain;
     private timestamp;
+    private isNowDefault;
 }

package/dist/generator/index.js

@@ -1,5 +1,5 @@
-import "../InternalOperationKind-BPVoOQwD.js";
-import { MigrationGenerator } from "../MigrationGenerator-Z39LTKmC.js";
-import "../generator-3yC60b1u.js";
+import "../InternalOperationKind-Bt6Weuon.js";
+import { MigrationGenerator } from "../MigrationGenerator-B1p0jHnx.js";
+import "../generator-DK-_f-PF.js";
 
 export { MigrationGenerator };

package/dist/{generator-3yC60b1u.js → generator-DK-_f-PF.js}

@@ -1,5 +1,5 @@
 import { __export } from "./chunk-BkvOhyD0.js";
-import { MigrationGenerator } from "./MigrationGenerator-Z39LTKmC.js";
+import { MigrationGenerator } from "./MigrationGenerator-B1p0jHnx.js";
 
 //#region src/generator/index.ts
 var generator_exports = {};
@@ -7,4 +7,4 @@ __export(generator_exports, { MigrationGenerator: () => MigrationGenerator });
 
 //#endregion
 export { generator_exports };
-//# sourceMappingURL=generator-3yC60b1u.js.map
+//# sourceMappingURL=generator-DK-_f-PF.js.map

package/dist/{generator-3yC60b1u.js.map → generator-DK-_f-PF.js.map}

@@ -1 +1 @@
-{"version":3,"file":"generator-3yC60b1u.js","names":[],"sources":["../src/generator/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { MigrationGenerator, type GenerateMigrationOptions } from './MigrationGenerator';\n"],"mappings":""}
+{"version":3,"file":"generator-DK-_f-PF.js","names":[],"sources":["../src/generator/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { MigrationGenerator, type GenerateMigrationOptions } from './MigrationGenerator';\n"],"mappings":""}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { trustedSql } from '@danceroutine/tango-core';
+export type { TrustedSqlFragment } from '@danceroutine/tango-core';
 /**
  * Bundled exports for Django-style domain drill-down imports, plus curated
  * top-level symbols for TS-native ergonomic imports.
@@ -10,6 +12,7 @@ export * as diff from './diff/index';
 export * as compilers from './compilers/index';
 export * as introspect from './introspect/index';
 export * as strategies from './strategies/index';
+export * as commands from './commands/index';
 export { Migration } from './domain/index';
 export type { Dialect, MigrationMode, MigrationOperation } from './domain/index';
 export type { Builder, ColumnSpec, ColumnType, DeleteReferentialAction, UpdateReferentialAction, } from './builder/index';
@@ -20,4 +23,5 @@ export { diffSchema } from './diff/index';
 export { PostgresCompiler, SqliteCompiler } from './compilers/index';
 export type { CompilerFactory, SQL, SQLCompiler } from './compilers/index';
 export { CompilerStrategy, IntrospectorStrategy, createDefaultCompilerStrategy, createDefaultIntrospectorStrategy, } from './strategies/index';
+export { registerMigrationsCommands } from './commands/index';
 export { PostgresIntrospector, SqliteIntrospector, type DatabaseIntrospector, type DBClient, type PostgresDbColumn, type PostgresDbForeignKey, type PostgresDbIndex, type PostgresDbSchema, type PostgresDbTable, type SqliteDbColumn, type SqliteDbSchema, type SqliteDbTable, } from './introspect/index';

package/dist/index.js

@@ -1,21 +1,25 @@
-import { CollectingBuilder } from "./CollectingBuilder-C6qnwyrb.js";
-import { Migration } from "./Migration-D9J6ZbLP.js";
-import "./InternalOperationKind-BPVoOQwD.js";
-import "./InternalColumnType-_YAz7RqI.js";
-import { PostgresCompiler, SqliteCompiler } from "./SqliteCompilerFactory-DwMwO7xY.js";
-import { CompilerStrategy, createDefaultCompilerStrategy } from "./CompilerStrategy-Cv1woBmO.js";
-import { MigrationRunner } from "./MigrationRunner-CCFuPUlr.js";
-import { MigrationGenerator } from "./MigrationGenerator-Z39LTKmC.js";
-import { OpBuilder, applyFieldType, builder_exports } from "./builder-Dtk8oP_Y.js";
-import { diffSchema } from "./diffSchema-KgGHP-s3.js";
-import { PostgresIntrospector, SqliteIntrospector } from "./SqliteIntrospector-BRdNt6KG.js";
-import { IntrospectorStrategy, createDefaultIntrospectorStrategy } from "./IntrospectorStrategy-BM1Eizfc.js";
-import { domain_exports } from "./domain-BXVlG0C0.js";
-import { runner_exports } from "./runner-BOs-tItW.js";
-import { generator_exports } from "./generator-3yC60b1u.js";
-import { diff_exports } from "./diff-Cs0TPEGR.js";
-import { compilers_exports } from "./compilers-D8DJuTnQ.js";
-import { introspect_exports } from "./introspect-ks-QSodq.js";
-import { strategies_exports } from "./strategies-BvHwf4as.js";
+import { CollectingBuilder } from "./CollectingBuilder--4fqDQdE.js";
+import { Migration } from "./Migration-DYQ0hUG7.js";
+import "./InternalOperationKind-Bt6Weuon.js";
+import "./InternalColumnType-G9zV9StN.js";
+import "./MigrationSqlSafetyAdapter-CGRbB2k2.js";
+import { PostgresCompiler, SqliteCompiler } from "./SqliteCompilerFactory-BAodJW9n.js";
+import { CompilerStrategy, createDefaultCompilerStrategy } from "./CompilerStrategy-yKw-Egxv.js";
+import { MigrationRunner } from "./MigrationRunner-D1ZfbbS-.js";
+import { MigrationGenerator } from "./MigrationGenerator-B1p0jHnx.js";
+import { OpBuilder, applyFieldType, builder_exports } from "./builder-xJ-Bq2pk.js";
+import { diffSchema } from "./diffSchema-D4oemTWS.js";
+import { PostgresIntrospector, SqliteIntrospector } from "./SqliteIntrospector-CWwPWhmA.js";
+import { IntrospectorStrategy, createDefaultIntrospectorStrategy } from "./IntrospectorStrategy-blvwSU3_.js";
+import { registerMigrationsCommands } from "./cli-DhCn8xiS.js";
+import { domain_exports } from "./domain-CwR-kUNS.js";
+import { runner_exports } from "./runner-C97xT8_W.js";
+import { generator_exports } from "./generator-DK-_f-PF.js";
+import { diff_exports } from "./diff-CZZbXAPN.js";
+import { compilers_exports } from "./compilers-dRN0Hzev.js";
+import { introspect_exports } from "./introspect-TPv_jeD6.js";
+import { strategies_exports } from "./strategies-D9ymSvbG.js";
+import { commands_exports } from "./commands-DIJepqNg.js";
+import { trustedSql } from "@danceroutine/tango-core";
 
-export { CollectingBuilder, CompilerStrategy, IntrospectorStrategy, Migration, MigrationGenerator, MigrationRunner, OpBuilder, PostgresCompiler, PostgresIntrospector, SqliteCompiler, SqliteIntrospector, applyFieldType, builder_exports as builder, compilers_exports as compilers, createDefaultCompilerStrategy, createDefaultIntrospectorStrategy, diff_exports as diff, diffSchema, domain_exports as domain, generator_exports as generator, introspect_exports as introspect, OpBuilder as op, runner_exports as runner, strategies_exports as strategies };
+export { CollectingBuilder, CompilerStrategy, IntrospectorStrategy, Migration, MigrationGenerator, MigrationRunner, OpBuilder, PostgresCompiler, PostgresIntrospector, SqliteCompiler, SqliteIntrospector, applyFieldType, builder_exports as builder, commands_exports as commands, compilers_exports as compilers, createDefaultCompilerStrategy, createDefaultIntrospectorStrategy, diff_exports as diff, diffSchema, domain_exports as domain, generator_exports as generator, introspect_exports as introspect, OpBuilder as op, registerMigrationsCommands, runner_exports as runner, strategies_exports as strategies, trustedSql };