@fragno-dev/db 0.1.14 → 0.2.0

package/dist/adapters/generic-sql/migration/cold-kysely.js

@@ -0,0 +1,33 @@
+import { DummyDriver, Kysely, MysqlAdapter, MysqlIntrospector, MysqlQueryCompiler, PostgresAdapter, PostgresIntrospector, PostgresQueryCompiler, SqliteAdapter, SqliteIntrospector, SqliteQueryCompiler } from "kysely";
+
+//#region src/adapters/generic-sql/migration/cold-kysely.ts
+/**
+* Creates a Kysely instance that can only build queries, not execute them.
+* This is used for SQL generation without requiring a database connection.
+*/
+function createColdKysely(database) {
+	switch (database) {
+		case "postgresql": return new Kysely({ dialect: {
+			createAdapter: () => new PostgresAdapter(),
+			createDriver: () => new DummyDriver(),
+			createIntrospector: (db) => new PostgresIntrospector(db),
+			createQueryCompiler: () => new PostgresQueryCompiler()
+		} });
+		case "mysql": return new Kysely({ dialect: {
+			createAdapter: () => new MysqlAdapter(),
+			createDriver: () => new DummyDriver(),
+			createIntrospector: (db) => new MysqlIntrospector(db),
+			createQueryCompiler: () => new MysqlQueryCompiler()
+		} });
+		case "sqlite": return new Kysely({ dialect: {
+			createAdapter: () => new SqliteAdapter(),
+			createDriver: () => new DummyDriver(),
+			createIntrospector: (db) => new SqliteIntrospector(db),
+			createQueryCompiler: () => new SqliteQueryCompiler()
+		} });
+	}
+}
+
+//#endregion
+export { createColdKysely };
+//# sourceMappingURL=cold-kysely.js.map

package/dist/adapters/generic-sql/migration/cold-kysely.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cold-kysely.js","names":[],"sources":["../../../../src/adapters/generic-sql/migration/cold-kysely.ts"],"sourcesContent":["import {\n  DummyDriver,\n  Kysely,\n  MysqlAdapter,\n  MysqlIntrospector,\n  MysqlQueryCompiler,\n  PostgresAdapter,\n  PostgresIntrospector,\n  PostgresQueryCompiler,\n  SqliteAdapter,\n  SqliteIntrospector,\n  SqliteQueryCompiler,\n} from \"kysely\";\nimport type { SupportedDatabase } from \"../driver-config\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Creates a Kysely instance that can only build queries, not execute them.\n * This is used for SQL generation without requiring a database connection.\n */\nexport function createColdKysely(database: SupportedDatabase): KyselyAny {\n  switch (database) {\n    case \"postgresql\":\n      return new Kysely({\n        dialect: {\n          createAdapter: () => new PostgresAdapter(),\n          createDriver: () => new DummyDriver(),\n          createIntrospector: (db) => new PostgresIntrospector(db),\n          createQueryCompiler: () => new PostgresQueryCompiler(),\n        },\n      });\n\n    case \"mysql\":\n      return new Kysely({\n        dialect: {\n          createAdapter: () => new MysqlAdapter(),\n          createDriver: () => new DummyDriver(),\n          createIntrospector: (db) => new MysqlIntrospector(db),\n          createQueryCompiler: () => new MysqlQueryCompiler(),\n        },\n      });\n\n    case \"sqlite\":\n      return new Kysely({\n        dialect: {\n          createAdapter: () => new SqliteAdapter(),\n          createDriver: () => new DummyDriver(),\n          createIntrospector: (db) => new SqliteIntrospector(db),\n          createQueryCompiler: () => new SqliteQueryCompiler(),\n        },\n      });\n  }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,iBAAiB,UAAwC;AACvE,SAAQ,UAAR;EACE,KAAK,aACH,QAAO,IAAI,OAAO,EAChB,SAAS;GACP,qBAAqB,IAAI,iBAAiB;GAC1C,oBAAoB,IAAI,aAAa;GACrC,qBAAqB,OAAO,IAAI,qBAAqB,GAAG;GACxD,2BAA2B,IAAI,uBAAuB;GACvD,EACF,CAAC;EAEJ,KAAK,QACH,QAAO,IAAI,OAAO,EAChB,SAAS;GACP,qBAAqB,IAAI,cAAc;GACvC,oBAAoB,IAAI,aAAa;GACrC,qBAAqB,OAAO,IAAI,kBAAkB,GAAG;GACrD,2BAA2B,IAAI,oBAAoB;GACpD,EACF,CAAC;EAEJ,KAAK,SACH,QAAO,IAAI,OAAO,EAChB,SAAS;GACP,qBAAqB,IAAI,eAAe;GACxC,oBAAoB,IAAI,aAAa;GACrC,qBAAqB,OAAO,IAAI,mBAAmB,GAAG;GACtD,2BAA2B,IAAI,qBAAqB;GACrD,EACF,CAAC"}

package/dist/adapters/generic-sql/migration/dialect/mysql.js

@@ -0,0 +1,60 @@
+import { SQLGenerator } from "../sql-generator.js";
+import { isUpdated } from "../../../../migration-engine/shared.js";
+import { sql } from "kysely";
+
+//#region src/adapters/generic-sql/migration/dialect/mysql.ts
+const errors = { IdColumnUpdate: "ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds." };
+/**
+* MySQL-specific SQL generator.
+* Uses modifyColumn for updates and wraps migrations with FK checks disabled.
+*/
+var MySQLSQLGenerator = class extends SQLGenerator {
+	/**
+	* MySQL preprocessing: wrap operations with SET FOREIGN_KEY_CHECKS = 0/1.
+	*/
+	preprocess(operations) {
+		if (operations.length === 0) return operations;
+		return [
+			{
+				type: "custom",
+				sql: "SET FOREIGN_KEY_CHECKS = 0"
+			},
+			...operations,
+			{
+				type: "custom",
+				sql: "SET FOREIGN_KEY_CHECKS = 1"
+			}
+		];
+	}
+	applyAutoIncrement(builder) {
+		return builder.autoIncrement();
+	}
+	getDefaultValue(column) {
+		const value = column.default;
+		if (!value) return;
+		if (column.type === "string") return;
+		if ("value" in value && value.value !== void 0) return sql.lit(value.value);
+		if ("dbSpecial" in value && value.dbSpecial === "now") return sql`CURRENT_TIMESTAMP`;
+		if ("runtime" in value) return;
+	}
+	/**
+	* MySQL update-column uses modifyColumn which requires the full column definition.
+	*/
+	compileUpdateColumn(tableName, operation) {
+		const col = operation.value;
+		if (col.role === "external-id" || col.role === "internal-id") throw new Error(errors.IdColumnUpdate);
+		if (!isUpdated(operation)) return [];
+		return this.db.schema.alterTable(tableName).modifyColumn(operation.name, sql.raw(this.getDBType(col)), (b) => this.buildColumn(col, b)).compile();
+	}
+	/**
+	* MySQL doesn't support IF EXISTS for dropping constraints.
+	*/
+	compileDropForeignKey(operation, mapper) {
+		const { table, name } = operation;
+		return this.db.schema.alterTable(this.getTableName(table, mapper)).dropConstraint(name).compile();
+	}
+};
+
+//#endregion
+export { MySQLSQLGenerator };
+//# sourceMappingURL=mysql.js.map

package/dist/adapters/generic-sql/migration/dialect/mysql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.js","names":[],"sources":["../../../../../src/adapters/generic-sql/migration/dialect/mysql.ts"],"sourcesContent":["import { type ColumnDefinitionBuilder, type CompiledQuery, type RawBuilder, sql } from \"kysely\";\nimport type {\n  ColumnInfo,\n  ColumnOperation,\n  MigrationOperation,\n} from \"../../../../migration-engine/shared\";\nimport { isUpdated } from \"../../../../migration-engine/shared\";\nimport type { TableNameMapper } from \"../../../shared/table-name-mapper\";\nimport { SQLGenerator } from \"../sql-generator\";\n\nconst errors = {\n  IdColumnUpdate:\n    \"ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds.\",\n} as const;\n\n/**\n * MySQL-specific SQL generator.\n * Uses modifyColumn for updates and wraps migrations with FK checks disabled.\n */\nexport class MySQLSQLGenerator extends SQLGenerator {\n  /**\n   * MySQL preprocessing: wrap operations with SET FOREIGN_KEY_CHECKS = 0/1.\n   */\n  override preprocess(operations: MigrationOperation[]): MigrationOperation[] {\n    if (operations.length === 0) {\n      return operations;\n    }\n\n    return [\n      { type: \"custom\", sql: \"SET FOREIGN_KEY_CHECKS = 0\" },\n      ...operations,\n      { type: \"custom\", sql: \"SET FOREIGN_KEY_CHECKS = 1\" },\n    ];\n  }\n\n  override applyAutoIncrement(builder: ColumnDefinitionBuilder): ColumnDefinitionBuilder {\n    return builder.autoIncrement();\n  }\n\n  override getDefaultValue(column: ColumnInfo): RawBuilder<unknown> | undefined {\n    const value = column.default;\n    if (!value) {\n      return undefined;\n    }\n\n    // MySQL doesn't support default values for TEXT columns\n    if (column.type === \"string\") {\n      return undefined;\n    }\n\n    if (\"value\" in value && value.value !== undefined) {\n      return sql.lit(value.value);\n    }\n\n    if (\"dbSpecial\" in value && value.dbSpecial === \"now\") {\n      return sql`CURRENT_TIMESTAMP`;\n    }\n\n    // Runtime defaults are handled in application code, not SQL\n    if (\"runtime\" in value) {\n      return undefined;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * MySQL update-column uses modifyColumn which requires the full column definition.\n   */\n  protected override compileUpdateColumn(\n    tableName: string,\n    operation: Extract<ColumnOperation, { type: \"update-column\" }>,\n  ): CompiledQuery | CompiledQuery[] {\n    const col = operation.value;\n\n    if (col.role === \"external-id\" || col.role === \"internal-id\") {\n      throw new Error(errors.IdColumnUpdate);\n    }\n\n    if (!isUpdated(operation)) {\n      return [];\n    }\n\n    // MySQL: Use modifyColumn which requires the full column definition\n    return this.db.schema\n      .alterTable(tableName)\n      .modifyColumn(operation.name, sql.raw(this.getDBType(col)), (b) => this.buildColumn(col, b))\n      .compile();\n  }\n\n  /**\n   * MySQL doesn't support IF EXISTS for dropping constraints.\n   */\n  protected override compileDropForeignKey(\n    operation: Extract<MigrationOperation, { type: \"drop-foreign-key\" }>,\n    mapper?: TableNameMapper,\n  ): CompiledQuery {\n    const { table, name } = operation;\n    return this.db.schema\n      .alterTable(this.getTableName(table, mapper))\n      .dropConstraint(name)\n      .compile();\n  }\n}\n"],"mappings":";;;;;AAUA,MAAM,SAAS,EACb,gBACE,mHACH;;;;;AAMD,IAAa,oBAAb,cAAuC,aAAa;;;;CAIlD,AAAS,WAAW,YAAwD;AAC1E,MAAI,WAAW,WAAW,EACxB,QAAO;AAGT,SAAO;GACL;IAAE,MAAM;IAAU,KAAK;IAA8B;GACrD,GAAG;GACH;IAAE,MAAM;IAAU,KAAK;IAA8B;GACtD;;CAGH,AAAS,mBAAmB,SAA2D;AACrF,SAAO,QAAQ,eAAe;;CAGhC,AAAS,gBAAgB,QAAqD;EAC5E,MAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,MACH;AAIF,MAAI,OAAO,SAAS,SAClB;AAGF,MAAI,WAAW,SAAS,MAAM,UAAU,OACtC,QAAO,IAAI,IAAI,MAAM,MAAM;AAG7B,MAAI,eAAe,SAAS,MAAM,cAAc,MAC9C,QAAO,GAAG;AAIZ,MAAI,aAAa,MACf;;;;;CASJ,AAAmB,oBACjB,WACA,WACiC;EACjC,MAAM,MAAM,UAAU;AAEtB,MAAI,IAAI,SAAS,iBAAiB,IAAI,SAAS,cAC7C,OAAM,IAAI,MAAM,OAAO,eAAe;AAGxC,MAAI,CAAC,UAAU,UAAU,CACvB,QAAO,EAAE;AAIX,SAAO,KAAK,GAAG,OACZ,WAAW,UAAU,CACrB,aAAa,UAAU,MAAM,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,GAAG,MAAM,KAAK,YAAY,KAAK,EAAE,CAAC,CAC3F,SAAS;;;;;CAMd,AAAmB,sBACjB,WACA,QACe;EACf,MAAM,EAAE,OAAO,SAAS;AACxB,SAAO,KAAK,GAAG,OACZ,WAAW,KAAK,aAAa,OAAO,OAAO,CAAC,CAC5C,eAAe,KAAK,CACpB,SAAS"}

package/dist/adapters/generic-sql/migration/dialect/postgres.js

@@ -0,0 +1,59 @@
+import { SQLGenerator } from "../sql-generator.js";
+import { isUpdated } from "../../../../migration-engine/shared.js";
+import { sql } from "kysely";
+
+//#region src/adapters/generic-sql/migration/dialect/postgres.ts
+const errors = { IdColumnUpdate: "ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds." };
+/**
+* PostgreSQL-specific SQL generator.
+* Uses USING clauses for type conversion and SERIAL for auto-increment.
+*/
+var PostgresSQLGenerator = class extends SQLGenerator {
+	/**
+	* PostgreSQL doesn't need preprocessing - it handles FKs normally.
+	*/
+	preprocess(operations) {
+		return operations;
+	}
+	/**
+	* PostgreSQL uses SERIAL/BIGSERIAL types for auto-increment,
+	* which is already handled in PostgreSQLTypeMapper. No builder modification needed.
+	*/
+	applyAutoIncrement(builder) {
+		return builder;
+	}
+	getDefaultValue(column) {
+		const value = column.default;
+		if (!value) return;
+		if ("value" in value && value.value !== void 0) return sql.lit(value.value);
+		if ("dbSpecial" in value && value.dbSpecial === "now") return sql`CURRENT_TIMESTAMP`;
+		if ("runtime" in value) return;
+	}
+	/**
+	* PostgreSQL update-column uses USING clause for type conversion.
+	*/
+	compileUpdateColumn(tableName, operation) {
+		const col = operation.value;
+		if (col.role === "external-id" || col.role === "internal-id") throw new Error(errors.IdColumnUpdate);
+		if (!isUpdated(operation)) return [];
+		const queries = [];
+		const alter = () => this.db.schema.alterTable(tableName);
+		if (operation.updateDataType) {
+			const dbType = sql.raw(this.getDBType(col));
+			queries.push(sql`ALTER TABLE ${sql.ref(tableName)} ALTER COLUMN ${sql.ref(operation.name)} TYPE ${dbType} USING (${sql.ref(operation.name)}::${dbType})`.compile(this.db));
+		}
+		if (operation.updateNullable) queries.push(alter().alterColumn(operation.name, (build) => col.isNullable ? build.dropNotNull() : build.setNotNull()).compile());
+		if (operation.updateDefault) {
+			const defaultValue = this.getDefaultValue(col);
+			queries.push(alter().alterColumn(operation.name, (build) => {
+				if (!defaultValue) return build.dropDefault();
+				return build.setDefault(defaultValue);
+			}).compile());
+		}
+		return queries;
+	}
+};
+
+//#endregion
+export { PostgresSQLGenerator };
+//# sourceMappingURL=postgres.js.map

package/dist/adapters/generic-sql/migration/dialect/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","names":["queries: CompiledQuery[]"],"sources":["../../../../../src/adapters/generic-sql/migration/dialect/postgres.ts"],"sourcesContent":["import { type ColumnDefinitionBuilder, type CompiledQuery, type RawBuilder, sql } from \"kysely\";\nimport type {\n  ColumnInfo,\n  ColumnOperation,\n  MigrationOperation,\n} from \"../../../../migration-engine/shared\";\nimport { isUpdated } from \"../../../../migration-engine/shared\";\nimport { SQLGenerator } from \"../sql-generator\";\n\nconst errors = {\n  IdColumnUpdate:\n    \"ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds.\",\n} as const;\n\n/**\n * PostgreSQL-specific SQL generator.\n * Uses USING clauses for type conversion and SERIAL for auto-increment.\n */\nexport class PostgresSQLGenerator extends SQLGenerator {\n  /**\n   * PostgreSQL doesn't need preprocessing - it handles FKs normally.\n   */\n  override preprocess(operations: MigrationOperation[]): MigrationOperation[] {\n    return operations;\n  }\n\n  /**\n   * PostgreSQL uses SERIAL/BIGSERIAL types for auto-increment,\n   * which is already handled in PostgreSQLTypeMapper. No builder modification needed.\n   */\n  override applyAutoIncrement(builder: ColumnDefinitionBuilder): ColumnDefinitionBuilder {\n    return builder;\n  }\n\n  override getDefaultValue(column: ColumnInfo): RawBuilder<unknown> | undefined {\n    const value = column.default;\n    if (!value) {\n      return undefined;\n    }\n\n    if (\"value\" in value && value.value !== undefined) {\n      return sql.lit(value.value);\n    }\n\n    if (\"dbSpecial\" in value && value.dbSpecial === \"now\") {\n      return sql`CURRENT_TIMESTAMP`;\n    }\n\n    // Runtime defaults are handled in application code, not SQL\n    if (\"runtime\" in value) {\n      return undefined;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * PostgreSQL update-column uses USING clause for type conversion.\n   */\n  protected override compileUpdateColumn(\n    tableName: string,\n    operation: Extract<ColumnOperation, { type: \"update-column\" }>,\n  ): CompiledQuery | CompiledQuery[] {\n    const col = operation.value;\n\n    if (col.role === \"external-id\" || col.role === \"internal-id\") {\n      throw new Error(errors.IdColumnUpdate);\n    }\n\n    if (!isUpdated(operation)) {\n      return [];\n    }\n\n    const queries: CompiledQuery[] = [];\n    const alter = () => this.db.schema.alterTable(tableName);\n\n    // PostgreSQL: Use explicit USING clause for type conversion\n    if (operation.updateDataType) {\n      const dbType = sql.raw(this.getDBType(col));\n      queries.push(\n        sql`ALTER TABLE ${sql.ref(tableName)} ALTER COLUMN ${sql.ref(operation.name)} TYPE ${dbType} USING (${sql.ref(operation.name)}::${dbType})`.compile(\n          this.db,\n        ),\n      );\n    }\n\n    if (operation.updateNullable) {\n      queries.push(\n        alter()\n          .alterColumn(operation.name, (build) =>\n            col.isNullable ? build.dropNotNull() : build.setNotNull(),\n          )\n          .compile(),\n      );\n    }\n\n    if (operation.updateDefault) {\n      const defaultValue = this.getDefaultValue(col);\n      queries.push(\n        alter()\n          .alterColumn(operation.name, (build) => {\n            if (!defaultValue) {\n              return build.dropDefault();\n            }\n            return build.setDefault(defaultValue);\n          })\n          .compile(),\n      );\n    }\n\n    return queries;\n  }\n}\n"],"mappings":";;;;;AASA,MAAM,SAAS,EACb,gBACE,mHACH;;;;;AAMD,IAAa,uBAAb,cAA0C,aAAa;;;;CAIrD,AAAS,WAAW,YAAwD;AAC1E,SAAO;;;;;;CAOT,AAAS,mBAAmB,SAA2D;AACrF,SAAO;;CAGT,AAAS,gBAAgB,QAAqD;EAC5E,MAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,MACH;AAGF,MAAI,WAAW,SAAS,MAAM,UAAU,OACtC,QAAO,IAAI,IAAI,MAAM,MAAM;AAG7B,MAAI,eAAe,SAAS,MAAM,cAAc,MAC9C,QAAO,GAAG;AAIZ,MAAI,aAAa,MACf;;;;;CASJ,AAAmB,oBACjB,WACA,WACiC;EACjC,MAAM,MAAM,UAAU;AAEtB,MAAI,IAAI,SAAS,iBAAiB,IAAI,SAAS,cAC7C,OAAM,IAAI,MAAM,OAAO,eAAe;AAGxC,MAAI,CAAC,UAAU,UAAU,CACvB,QAAO,EAAE;EAGX,MAAMA,UAA2B,EAAE;EACnC,MAAM,cAAc,KAAK,GAAG,OAAO,WAAW,UAAU;AAGxD,MAAI,UAAU,gBAAgB;GAC5B,MAAM,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAC3C,WAAQ,KACN,GAAG,eAAe,IAAI,IAAI,UAAU,CAAC,gBAAgB,IAAI,IAAI,UAAU,KAAK,CAAC,QAAQ,OAAO,UAAU,IAAI,IAAI,UAAU,KAAK,CAAC,IAAI,OAAO,GAAG,QAC1I,KAAK,GACN,CACF;;AAGH,MAAI,UAAU,eACZ,SAAQ,KACN,OAAO,CACJ,YAAY,UAAU,OAAO,UAC5B,IAAI,aAAa,MAAM,aAAa,GAAG,MAAM,YAAY,CAC1D,CACA,SAAS,CACb;AAGH,MAAI,UAAU,eAAe;GAC3B,MAAM,eAAe,KAAK,gBAAgB,IAAI;AAC9C,WAAQ,KACN,OAAO,CACJ,YAAY,UAAU,OAAO,UAAU;AACtC,QAAI,CAAC,aACH,QAAO,MAAM,aAAa;AAE5B,WAAO,MAAM,WAAW,aAAa;KACrC,CACD,SAAS,CACb;;AAGH,SAAO"}

package/dist/adapters/generic-sql/migration/dialect/sqlite.js

@@ -0,0 +1,96 @@
+import { SQLGenerator } from "../sql-generator.js";
+import { sql } from "kysely";
+
+//#region src/adapters/generic-sql/migration/dialect/sqlite.ts
+const errors = {
+	IdColumnUpdate: "ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds.",
+	SQLiteUpdateColumn: "SQLite doesn't support updating columns. Recreate the table instead.",
+	SQLiteUpdateForeignKeys: "SQLite doesn't support modifying foreign keys directly. Use `recreate-table` instead."
+};
+/**
+* SQLite-specific SQL generator.
+* Handles SQLite's limitations around foreign keys and column updates.
+*/
+var SQLiteSQLGenerator = class extends SQLGenerator {
+	/**
+	* SQLite preprocessing: merge add-foreign-key operations into create-table operations
+	* when both exist in the same batch, and add pragma for deferred foreign keys.
+	*
+	* SQLite requires foreign keys to be defined at table creation time.
+	*/
+	preprocess(operations) {
+		if (operations.length === 0) return operations;
+		const result = [];
+		const createTableIndices = /* @__PURE__ */ new Map();
+		const foreignKeysByTable = /* @__PURE__ */ new Map();
+		for (const op of operations) if (op.type === "create-table") {
+			createTableIndices.set(op.name, result.length);
+			result.push(op);
+		} else if (op.type === "add-foreign-key") {
+			if (!foreignKeysByTable.has(op.table)) foreignKeysByTable.set(op.table, []);
+			foreignKeysByTable.get(op.table).push(op);
+		} else result.push(op);
+		for (const [tableName, fkOps] of foreignKeysByTable.entries()) {
+			const createTableIdx = createTableIndices.get(tableName);
+			if (createTableIdx !== void 0) {
+				const createOp = result[createTableIdx];
+				if (createOp.type === "create-table") {
+					const metadata = { inlineForeignKeys: fkOps.map((fkOp) => fkOp.value) };
+					result[createTableIdx] = {
+						...createOp,
+						metadata
+					};
+				}
+			} else result.push(...fkOps);
+		}
+		return [{
+			type: "custom",
+			sql: "PRAGMA defer_foreign_keys = ON"
+		}, ...result];
+	}
+	applyAutoIncrement(builder) {
+		return builder.autoIncrement();
+	}
+	getDefaultValue(column) {
+		const value = column.default;
+		if (!value) return;
+		if ("value" in value && value.value !== void 0) return sql.lit(value.value);
+		if ("dbSpecial" in value && value.dbSpecial === "now") return sql`CURRENT_TIMESTAMP`;
+		if ("runtime" in value) return;
+	}
+	/**
+	* Override create-table to add inline foreign keys from metadata.
+	*/
+	compileCreateTable(operation, mapper) {
+		const tableName = this.getTableName(operation.name, mapper);
+		let builder = this.db.schema.createTable(tableName);
+		for (const col of operation.columns) builder = builder.addColumn(col.name, sql.raw(this.getDBType(col)), (b) => this.buildColumn(col, b));
+		const metadata = operation.metadata;
+		if (metadata?.inlineForeignKeys) for (const fk of metadata.inlineForeignKeys) builder = builder.addForeignKeyConstraint(fk.name, fk.columns, this.getTableName(fk.referencedTable, mapper), fk.referencedColumns, (cb) => cb.onUpdate("restrict").onDelete("restrict"));
+		return builder.compile();
+	}
+	/**
+	* SQLite doesn't support adding foreign keys to existing tables.
+	*/
+	compileAddForeignKey(_operation, _mapper) {
+		throw new Error(errors.SQLiteUpdateForeignKeys);
+	}
+	/**
+	* SQLite doesn't support dropping foreign keys.
+	*/
+	compileDropForeignKey(_operation, _mapper) {
+		throw new Error(errors.SQLiteUpdateForeignKeys);
+	}
+	/**
+	* SQLite doesn't support updating columns.
+	*/
+	compileUpdateColumn(_tableName, operation) {
+		const col = operation.value;
+		if (col.role === "external-id" || col.role === "internal-id") throw new Error(errors.IdColumnUpdate);
+		throw new Error(errors.SQLiteUpdateColumn);
+	}
+};
+
+//#endregion
+export { SQLiteSQLGenerator };
+//# sourceMappingURL=sqlite.js.map

package/dist/adapters/generic-sql/migration/dialect/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","names":["result: MigrationOperation[]","metadata: SqliteCreateTableMetadata","builder: CreateTableBuilderAny"],"sources":["../../../../../src/adapters/generic-sql/migration/dialect/sqlite.ts"],"sourcesContent":["import { type ColumnDefinitionBuilder, type CompiledQuery, type RawBuilder, sql } from \"kysely\";\nimport type {\n  ColumnInfo,\n  ColumnOperation,\n  ForeignKeyInfo,\n  MigrationOperation,\n} from \"../../../../migration-engine/shared\";\nimport type { TableNameMapper } from \"../../../shared/table-name-mapper\";\nimport { SQLGenerator } from \"../sql-generator\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CreateTableBuilderAny = any;\n\n/**\n * Metadata attached to create-table operations for inline foreign keys.\n */\ninterface SqliteCreateTableMetadata {\n  [key: string]: unknown;\n  inlineForeignKeys?: ForeignKeyInfo[];\n}\n\nconst errors = {\n  IdColumnUpdate:\n    \"ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds.\",\n  SQLiteUpdateColumn: \"SQLite doesn't support updating columns. Recreate the table instead.\",\n  SQLiteUpdateForeignKeys:\n    \"SQLite doesn't support modifying foreign keys directly. Use `recreate-table` instead.\",\n} as const;\n\n/**\n * SQLite-specific SQL generator.\n * Handles SQLite's limitations around foreign keys and column updates.\n */\nexport class SQLiteSQLGenerator extends SQLGenerator {\n  /**\n   * SQLite preprocessing: merge add-foreign-key operations into create-table operations\n   * when both exist in the same batch, and add pragma for deferred foreign keys.\n   *\n   * SQLite requires foreign keys to be defined at table creation time.\n   */\n  override preprocess(operations: MigrationOperation[]): MigrationOperation[] {\n    if (operations.length === 0) {\n      return operations;\n    }\n\n    const result: MigrationOperation[] = [];\n    const createTableIndices = new Map<string, number>();\n    const foreignKeysByTable = new Map<\n      string,\n      Extract<MigrationOperation, { type: \"add-foreign-key\" }>[]\n    >();\n\n    // First pass: identify create-table operations and collect foreign keys\n    for (const op of operations) {\n      if (op.type === \"create-table\") {\n        createTableIndices.set(op.name, result.length);\n        result.push(op);\n      } else if (op.type === \"add-foreign-key\") {\n        if (!foreignKeysByTable.has(op.table)) {\n          foreignKeysByTable.set(op.table, []);\n        }\n        foreignKeysByTable.get(op.table)!.push(op);\n      } else {\n        result.push(op);\n      }\n    }\n\n    // Second pass: attach foreign keys as metadata to create-table ops\n    for (const [tableName, fkOps] of foreignKeysByTable.entries()) {\n      const createTableIdx = createTableIndices.get(tableName);\n\n      if (createTableIdx !== undefined) {\n        const createOp = result[createTableIdx];\n        if (createOp.type === \"create-table\") {\n          const metadata: SqliteCreateTableMetadata = {\n            inlineForeignKeys: fkOps.map((fkOp) => fkOp.value),\n          };\n          result[createTableIdx] = {\n            ...createOp,\n            metadata,\n          };\n        }\n      } else {\n        // Table already exists - keep add-foreign-key operations (will throw error during compile)\n        result.push(...fkOps);\n      }\n    }\n\n    // Add pragma at the beginning for deferred foreign key checking\n    return [{ type: \"custom\", sql: \"PRAGMA defer_foreign_keys = ON\" }, ...result];\n  }\n\n  override applyAutoIncrement(builder: ColumnDefinitionBuilder): ColumnDefinitionBuilder {\n    return builder.autoIncrement();\n  }\n\n  override getDefaultValue(column: ColumnInfo): RawBuilder<unknown> | undefined {\n    const value = column.default;\n    if (!value) {\n      return undefined;\n    }\n\n    if (\"value\" in value && value.value !== undefined) {\n      return sql.lit(value.value);\n    }\n\n    if (\"dbSpecial\" in value && value.dbSpecial === \"now\") {\n      return sql`CURRENT_TIMESTAMP`;\n    }\n\n    // Runtime defaults are handled in application code, not SQL\n    if (\"runtime\" in value) {\n      return undefined;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Override create-table to add inline foreign keys from metadata.\n   */\n  protected override compileCreateTable(\n    operation: Extract<MigrationOperation, { type: \"create-table\" }>,\n    mapper?: TableNameMapper,\n  ): CompiledQuery {\n    const tableName = this.getTableName(operation.name, mapper);\n    let builder: CreateTableBuilderAny = this.db.schema.createTable(tableName);\n\n    // Add columns\n    for (const col of operation.columns) {\n      builder = builder.addColumn(\n        col.name,\n        sql.raw(this.getDBType(col)),\n        (b: ColumnDefinitionBuilder) => this.buildColumn(col, b),\n      );\n    }\n\n    // Add inline foreign keys from metadata\n    const metadata = operation.metadata as SqliteCreateTableMetadata | undefined;\n    if (metadata?.inlineForeignKeys) {\n      for (const fk of metadata.inlineForeignKeys) {\n        builder = builder.addForeignKeyConstraint(\n          fk.name,\n          fk.columns,\n          this.getTableName(fk.referencedTable, mapper),\n          fk.referencedColumns,\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          (cb: any) => cb.onUpdate(\"restrict\").onDelete(\"restrict\"),\n        );\n      }\n    }\n\n    return builder.compile();\n  }\n\n  /**\n   * SQLite doesn't support adding foreign keys to existing tables.\n   */\n  protected override compileAddForeignKey(\n    _operation: Extract<MigrationOperation, { type: \"add-foreign-key\" }>,\n    _mapper?: TableNameMapper,\n  ): CompiledQuery {\n    throw new Error(errors.SQLiteUpdateForeignKeys);\n  }\n\n  /**\n   * SQLite doesn't support dropping foreign keys.\n   */\n  protected override compileDropForeignKey(\n    _operation: Extract<MigrationOperation, { type: \"drop-foreign-key\" }>,\n    _mapper?: TableNameMapper,\n  ): CompiledQuery {\n    throw new Error(errors.SQLiteUpdateForeignKeys);\n  }\n\n  /**\n   * SQLite doesn't support updating columns.\n   */\n  protected override compileUpdateColumn(\n    _tableName: string,\n    operation: Extract<ColumnOperation, { type: \"update-column\" }>,\n  ): CompiledQuery | CompiledQuery[] {\n    const col = operation.value;\n    if (col.role === \"external-id\" || col.role === \"internal-id\") {\n      throw new Error(errors.IdColumnUpdate);\n    }\n    throw new Error(errors.SQLiteUpdateColumn);\n  }\n}\n"],"mappings":";;;;AAqBA,MAAM,SAAS;CACb,gBACE;CACF,oBAAoB;CACpB,yBACE;CACH;;;;;AAMD,IAAa,qBAAb,cAAwC,aAAa;;;;;;;CAOnD,AAAS,WAAW,YAAwD;AAC1E,MAAI,WAAW,WAAW,EACxB,QAAO;EAGT,MAAMA,SAA+B,EAAE;EACvC,MAAM,qCAAqB,IAAI,KAAqB;EACpD,MAAM,qCAAqB,IAAI,KAG5B;AAGH,OAAK,MAAM,MAAM,WACf,KAAI,GAAG,SAAS,gBAAgB;AAC9B,sBAAmB,IAAI,GAAG,MAAM,OAAO,OAAO;AAC9C,UAAO,KAAK,GAAG;aACN,GAAG,SAAS,mBAAmB;AACxC,OAAI,CAAC,mBAAmB,IAAI,GAAG,MAAM,CACnC,oBAAmB,IAAI,GAAG,OAAO,EAAE,CAAC;AAEtC,sBAAmB,IAAI,GAAG,MAAM,CAAE,KAAK,GAAG;QAE1C,QAAO,KAAK,GAAG;AAKnB,OAAK,MAAM,CAAC,WAAW,UAAU,mBAAmB,SAAS,EAAE;GAC7D,MAAM,iBAAiB,mBAAmB,IAAI,UAAU;AAExD,OAAI,mBAAmB,QAAW;IAChC,MAAM,WAAW,OAAO;AACxB,QAAI,SAAS,SAAS,gBAAgB;KACpC,MAAMC,WAAsC,EAC1C,mBAAmB,MAAM,KAAK,SAAS,KAAK,MAAM,EACnD;AACD,YAAO,kBAAkB;MACvB,GAAG;MACH;MACD;;SAIH,QAAO,KAAK,GAAG,MAAM;;AAKzB,SAAO,CAAC;GAAE,MAAM;GAAU,KAAK;GAAkC,EAAE,GAAG,OAAO;;CAG/E,AAAS,mBAAmB,SAA2D;AACrF,SAAO,QAAQ,eAAe;;CAGhC,AAAS,gBAAgB,QAAqD;EAC5E,MAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,MACH;AAGF,MAAI,WAAW,SAAS,MAAM,UAAU,OACtC,QAAO,IAAI,IAAI,MAAM,MAAM;AAG7B,MAAI,eAAe,SAAS,MAAM,cAAc,MAC9C,QAAO,GAAG;AAIZ,MAAI,aAAa,MACf;;;;;CASJ,AAAmB,mBACjB,WACA,QACe;EACf,MAAM,YAAY,KAAK,aAAa,UAAU,MAAM,OAAO;EAC3D,IAAIC,UAAiC,KAAK,GAAG,OAAO,YAAY,UAAU;AAG1E,OAAK,MAAM,OAAO,UAAU,QAC1B,WAAU,QAAQ,UAChB,IAAI,MACJ,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,GAC3B,MAA+B,KAAK,YAAY,KAAK,EAAE,CACzD;EAIH,MAAM,WAAW,UAAU;AAC3B,MAAI,UAAU,kBACZ,MAAK,MAAM,MAAM,SAAS,kBACxB,WAAU,QAAQ,wBAChB,GAAG,MACH,GAAG,SACH,KAAK,aAAa,GAAG,iBAAiB,OAAO,EAC7C,GAAG,oBAEF,OAAY,GAAG,SAAS,WAAW,CAAC,SAAS,WAAW,CAC1D;AAIL,SAAO,QAAQ,SAAS;;;;;CAM1B,AAAmB,qBACjB,YACA,SACe;AACf,QAAM,IAAI,MAAM,OAAO,wBAAwB;;;;;CAMjD,AAAmB,sBACjB,YACA,SACe;AACf,QAAM,IAAI,MAAM,OAAO,wBAAwB;;;;;CAMjD,AAAmB,oBACjB,YACA,WACiC;EACjC,MAAM,MAAM,UAAU;AACtB,MAAI,IAAI,SAAS,iBAAiB,IAAI,SAAS,cAC7C,OAAM,IAAI,MAAM,OAAO,eAAe;AAExC,QAAM,IAAI,MAAM,OAAO,mBAAmB"}

package/dist/adapters/generic-sql/migration/executor.d.ts

@@ -0,0 +1,15 @@
+import { CompiledQuery } from "kysely";
+
+//#region src/adapters/generic-sql/migration/executor.d.ts
+
+/**
+ * Compiled migration containing all SQL statements to execute.
+ */
+interface CompiledMigration {
+  statements: CompiledQuery[];
+  fromVersion: number;
+  toVersion: number;
+}
+//#endregion
+export { CompiledMigration };
+//# sourceMappingURL=executor.d.ts.map

package/dist/adapters/generic-sql/migration/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","names":[],"sources":["../../../../src/adapters/generic-sql/migration/executor.ts"],"sourcesContent":[],"mappings":";;;;;AAMA;;UAAiB,iBAAA;cACH"}

package/dist/adapters/generic-sql/migration/executor.js

@@ -0,0 +1,18 @@
+//#region src/adapters/generic-sql/migration/executor.ts
+/**
+* Execute a compiled migration using the provided driver adapter.
+* All statements are executed within a single transaction.
+*
+* @param driver - The SQL driver adapter to execute queries
+* @param migration - The compiled migration containing SQL statements
+*/
+async function executeMigration(driver, migration) {
+	if (migration.statements.length === 0) return;
+	await driver.transaction(async (tx) => {
+		for (const statement of migration.statements) await tx.executeQuery(statement);
+	});
+}
+
+//#endregion
+export { executeMigration };
+//# sourceMappingURL=executor.js.map

package/dist/adapters/generic-sql/migration/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","names":[],"sources":["../../../../src/adapters/generic-sql/migration/executor.ts"],"sourcesContent":["import type { CompiledQuery } from \"kysely\";\nimport type { SqlDriverAdapter } from \"../../../sql-driver/sql-driver-adapter\";\n\n/**\n * Compiled migration containing all SQL statements to execute.\n */\nexport interface CompiledMigration {\n  statements: CompiledQuery[];\n  fromVersion: number;\n  toVersion: number;\n}\n\n/**\n * Execute a compiled migration using the provided driver adapter.\n * All statements are executed within a single transaction.\n *\n * @param driver - The SQL driver adapter to execute queries\n * @param migration - The compiled migration containing SQL statements\n */\nexport async function executeMigration(\n  driver: SqlDriverAdapter,\n  migration: CompiledMigration,\n): Promise<void> {\n  if (migration.statements.length === 0) {\n    return;\n  }\n\n  await driver.transaction(async (tx) => {\n    for (const statement of migration.statements) {\n      await tx.executeQuery(statement);\n    }\n  });\n}\n"],"mappings":";;;;;;;;AAmBA,eAAsB,iBACpB,QACA,WACe;AACf,KAAI,UAAU,WAAW,WAAW,EAClC;AAGF,OAAM,OAAO,YAAY,OAAO,OAAO;AACrC,OAAK,MAAM,aAAa,UAAU,WAChC,OAAM,GAAG,aAAa,UAAU;GAElC"}

package/dist/adapters/generic-sql/migration/prepared-migrations.d.ts

@@ -0,0 +1,66 @@
+import { SqlDriverAdapter } from "../../../sql-driver/sql-driver-adapter.js";
+import { CompiledMigration } from "./executor.js";
+
+//#region src/adapters/generic-sql/migration/prepared-migrations.d.ts
+
+/**
+ * Options for executing a migration.
+ */
+interface ExecuteOptions {
+  /**
+   * Whether to automatically update the schema version in the database after migration.
+   * If not specified, uses the value from PreparedMigrationsConfig.
+   */
+  updateVersionInMigration?: boolean;
+}
+/**
+ * Interface for preparing and executing migrations.
+ * Provides a clean separation between compilation (SQL generation) and execution.
+ */
+interface PreparedMigrations {
+  /**
+   * Execute migration from one version to another.
+   * This performs all three phases:
+   * - Phase 1: schema → operations
+   * - Phase 2: operations → SQL
+   * - Phase 3: SQL → database
+   *
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (overrides config defaults)
+   */
+  execute(fromVersion: number, toVersion?: number, options?: ExecuteOptions): Promise<void>;
+  /**
+   * Execute migration using a specific driver.
+   * Useful for testing or when you need to use a different driver than the one provided in config.
+   *
+   * @param driver - SQL driver to use for execution
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (overrides config defaults)
+   */
+  executeWithDriver(driver: SqlDriverAdapter, fromVersion: number, toVersion?: number, options?: ExecuteOptions): Promise<void>;
+  /**
+   * Get the SQL for a migration from one version to another without executing it.
+   * Useful for generating migration files or previewing changes.
+   *
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (affects version update SQL)
+   * @returns SQL string for the migration
+   */
+  getSQL(fromVersion: number, toVersion?: number, options?: ExecuteOptions): string;
+  /**
+   * Get the compiled migration for a version range.
+   * Returns both the SQL statements and the version information.
+   *
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (affects version update SQL)
+   * @returns Compiled migration with statements and version info
+   */
+  compile(fromVersion: number, toVersion?: number, options?: ExecuteOptions): CompiledMigration;
+}
+//#endregion
+export { PreparedMigrations };
+//# sourceMappingURL=prepared-migrations.d.ts.map

package/dist/adapters/generic-sql/migration/prepared-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-migrations.d.ts","names":[],"sources":["../../../../src/adapters/generic-sql/migration/prepared-migrations.ts"],"sourcesContent":[],"mappings":";;;;;AA2BA;;;AAwBY,UApCK,cAAA,CAoCL;EAGE;;;;EAuBgE,wBAAA,CAAA,EAAA,OAAA;;;;;;UAlD7D,kBAAA;;;;;;;;;;;;6DAY4C,iBAAiB;;;;;;;;;;4BAYlE,qEAGE,iBACT;;;;;;;;;;4DAWuD;;;;;;;;;;6DAWC,iBAAiB"}

package/dist/adapters/generic-sql/migration/prepared-migrations.js

@@ -0,0 +1,68 @@
+import { generateMigrationFromSchema } from "../../../migration-engine/auto-from-schema.js";
+import { createColdKysely } from "./cold-kysely.js";
+import "./sql-generator.js";
+import { SQLiteSQLGenerator } from "./dialect/sqlite.js";
+import { PostgresSQLGenerator } from "./dialect/postgres.js";
+import { MySQLSQLGenerator } from "./dialect/mysql.js";
+import { executeMigration } from "./executor.js";
+
+//#region src/adapters/generic-sql/migration/prepared-migrations.ts
+/**
+* Create a PreparedMigrations instance for a schema and namespace.
+*/
+function createPreparedMigrations(config) {
+	const { schema, namespace, database, driver, updateVersionInMigration: defaultUpdateVersion = true } = config;
+	const generator = createSQLGenerator(database, createColdKysely(database));
+	/**
+	* Internal method to compile a migration for a given version range.
+	*/
+	function compile(fromVersion, toVersion, updateVersionInMigration) {
+		if (fromVersion < 0) throw new Error(`fromVersion cannot be negative: ${fromVersion}`);
+		if (toVersion < 0) throw new Error(`toVersion cannot be negative: ${toVersion}`);
+		if (toVersion < fromVersion) throw new Error(`Cannot migrate backwards: fromVersion (${fromVersion}) > toVersion (${toVersion})`);
+		if (toVersion > schema.version) throw new Error(`toVersion (${toVersion}) exceeds schema version (${schema.version})`);
+		const operations = generateMigrationFromSchema(schema, fromVersion, toVersion);
+		const statements = generator.compile(operations, config.mapper);
+		if (updateVersionInMigration && toVersion !== fromVersion) {
+			const versionUpdate = generator.generateVersionUpdateSQL(namespace, fromVersion, toVersion);
+			statements.push(versionUpdate);
+		}
+		return {
+			statements,
+			fromVersion,
+			toVersion
+		};
+	}
+	return {
+		async execute(fromVersion, toVersion, options) {
+			if (!driver) throw new Error("Driver not provided. Cannot execute migration. Use `executeWithDriver` instead.");
+			return this.executeWithDriver(driver, fromVersion, toVersion, options);
+		},
+		async executeWithDriver(driverToUse, fromVersion, toVersion, options) {
+			const updateVersionInMigration = options?.updateVersionInMigration ?? defaultUpdateVersion;
+			await executeMigration(driverToUse, compile(fromVersion, toVersion ?? schema.version, updateVersionInMigration));
+		},
+		getSQL(fromVersion, toVersion, options) {
+			const updateVersionInMigration = options?.updateVersionInMigration ?? defaultUpdateVersion;
+			return compile(fromVersion, toVersion ?? schema.version, updateVersionInMigration).statements.map((stmt) => stmt.sql + ";").join("\n\n");
+		},
+		compile(fromVersion, toVersion, options) {
+			const updateVersionInMigration = options?.updateVersionInMigration ?? defaultUpdateVersion;
+			return compile(fromVersion, toVersion ?? schema.version, updateVersionInMigration);
+		}
+	};
+}
+/**
+* Create the appropriate SQL generator for a database type.
+*/
+function createSQLGenerator(database, coldKysely) {
+	switch (database) {
+		case "sqlite": return new SQLiteSQLGenerator(coldKysely, database);
+		case "postgresql": return new PostgresSQLGenerator(coldKysely, database);
+		case "mysql": return new MySQLSQLGenerator(coldKysely, database);
+	}
+}
+
+//#endregion
+export { createPreparedMigrations };
+//# sourceMappingURL=prepared-migrations.js.map

package/dist/adapters/generic-sql/migration/prepared-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-migrations.js","names":[],"sources":["../../../../src/adapters/generic-sql/migration/prepared-migrations.ts"],"sourcesContent":["import type { AnySchema } from \"../../../schema/create\";\nimport type { SqlDriverAdapter } from \"../../../sql-driver/sql-driver-adapter\";\nimport type { TableNameMapper } from \"../../shared/table-name-mapper\";\nimport { generateMigrationFromSchema } from \"../../../migration-engine/auto-from-schema\";\nimport { createColdKysely } from \"./cold-kysely\";\nimport { type SQLGenerator } from \"./sql-generator\";\nimport { SQLiteSQLGenerator } from \"./dialect/sqlite\";\nimport { PostgresSQLGenerator } from \"./dialect/postgres\";\nimport { MySQLSQLGenerator } from \"./dialect/mysql\";\nimport { executeMigration, type CompiledMigration } from \"./executor\";\nimport type { SupportedDatabase } from \"../driver-config\";\nimport type { Kysely } from \"kysely\";\n/**\n * Options for executing a migration.\n */\nexport interface ExecuteOptions {\n  /**\n   * Whether to automatically update the schema version in the database after migration.\n   * If not specified, uses the value from PreparedMigrationsConfig.\n   */\n  updateVersionInMigration?: boolean;\n}\n\n/**\n * Interface for preparing and executing migrations.\n * Provides a clean separation between compilation (SQL generation) and execution.\n */\nexport interface PreparedMigrations {\n  /**\n   * Execute migration from one version to another.\n   * This performs all three phases:\n   * - Phase 1: schema → operations\n   * - Phase 2: operations → SQL\n   * - Phase 3: SQL → database\n   *\n   * @param fromVersion - Current database version (0 for new database)\n   * @param toVersion - Target schema version (defaults to schema.version)\n   * @param options - Optional execution options (overrides config defaults)\n   */\n  execute(fromVersion: number, toVersion?: number, options?: ExecuteOptions): Promise<void>;\n\n  /**\n   * Execute migration using a specific driver.\n   * Useful for testing or when you need to use a different driver than the one provided in config.\n   *\n   * @param driver - SQL driver to use for execution\n   * @param fromVersion - Current database version (0 for new database)\n   * @param toVersion - Target schema version (defaults to schema.version)\n   * @param options - Optional execution options (overrides config defaults)\n   */\n  executeWithDriver(\n    driver: SqlDriverAdapter,\n    fromVersion: number,\n    toVersion?: number,\n    options?: ExecuteOptions,\n  ): Promise<void>;\n\n  /**\n   * Get the SQL for a migration from one version to another without executing it.\n   * Useful for generating migration files or previewing changes.\n   *\n   * @param fromVersion - Current database version (0 for new database)\n   * @param toVersion - Target schema version (defaults to schema.version)\n   * @param options - Optional execution options (affects version update SQL)\n   * @returns SQL string for the migration\n   */\n  getSQL(fromVersion: number, toVersion?: number, options?: ExecuteOptions): string;\n\n  /**\n   * Get the compiled migration for a version range.\n   * Returns both the SQL statements and the version information.\n   *\n   * @param fromVersion - Current database version (0 for new database)\n   * @param toVersion - Target schema version (defaults to schema.version)\n   * @param options - Optional execution options (affects version update SQL)\n   * @returns Compiled migration with statements and version info\n   */\n  compile(fromVersion: number, toVersion?: number, options?: ExecuteOptions): CompiledMigration;\n}\n\n/**\n * Configuration for creating a PreparedMigrations instance.\n */\nexport interface PreparedMigrationsConfig {\n  schema: AnySchema;\n  namespace: string;\n  database: SupportedDatabase;\n  mapper?: TableNameMapper;\n  driver?: SqlDriverAdapter;\n  /**\n   * Whether to automatically update the schema version in the database after migration.\n   * Defaults to true. Can be overridden per execution via ExecuteOptions.\n   */\n  updateVersionInMigration?: boolean;\n}\n\n/**\n * Create a PreparedMigrations instance for a schema and namespace.\n */\nexport function createPreparedMigrations(config: PreparedMigrationsConfig): PreparedMigrations {\n  const {\n    schema,\n    namespace,\n    database,\n    driver,\n    updateVersionInMigration: defaultUpdateVersion = true,\n  } = config;\n\n  // Create the cold Kysely instance for SQL generation\n  const coldKysely = createColdKysely(database);\n\n  // Create the appropriate SQL generator for the database\n  const generator = createSQLGenerator(database, coldKysely);\n\n  /**\n   * Internal method to compile a migration for a given version range.\n   */\n  function compile(\n    fromVersion: number,\n    toVersion: number,\n    updateVersionInMigration: boolean,\n  ): CompiledMigration {\n    // Validate version numbers\n    if (fromVersion < 0) {\n      throw new Error(`fromVersion cannot be negative: ${fromVersion}`);\n    }\n    if (toVersion < 0) {\n      throw new Error(`toVersion cannot be negative: ${toVersion}`);\n    }\n    if (toVersion < fromVersion) {\n      throw new Error(\n        `Cannot migrate backwards: fromVersion (${fromVersion}) > toVersion (${toVersion})`,\n      );\n    }\n    if (toVersion > schema.version) {\n      throw new Error(`toVersion (${toVersion}) exceeds schema version (${schema.version})`);\n    }\n\n    // Phase 1: Generate migration operations from schema\n    const operations = generateMigrationFromSchema(schema, fromVersion, toVersion);\n\n    // Phase 2: Compile operations to SQL\n    const statements = generator.compile(operations, config.mapper);\n\n    // Add version update SQL if requested\n    if (updateVersionInMigration && toVersion !== fromVersion) {\n      const versionUpdate = generator.generateVersionUpdateSQL(namespace, fromVersion, toVersion);\n      statements.push(versionUpdate);\n    }\n\n    return {\n      statements,\n      fromVersion,\n      toVersion,\n    };\n  }\n\n  return {\n    async execute(fromVersion, toVersion, options) {\n      if (!driver) {\n        throw new Error(\n          \"Driver not provided. Cannot execute migration. Use `executeWithDriver` instead.\",\n        );\n      }\n\n      return this.executeWithDriver(driver, fromVersion, toVersion, options);\n    },\n\n    async executeWithDriver(driverToUse, fromVersion, toVersion, options) {\n      // Use option if provided, otherwise use config default\n      const updateVersionInMigration = options?.updateVersionInMigration ?? defaultUpdateVersion;\n      const targetVersion = toVersion ?? schema.version;\n\n      // Compile the migration (this will validate the version numbers)\n      const migration = compile(fromVersion, targetVersion, updateVersionInMigration);\n\n      // Execute the migration\n      await executeMigration(driverToUse, migration);\n    },\n\n    getSQL(fromVersion, toVersion, options) {\n      const updateVersionInMigration = options?.updateVersionInMigration ?? defaultUpdateVersion;\n      const targetVersion = toVersion ?? schema.version;\n\n      const migration = compile(fromVersion, targetVersion, updateVersionInMigration);\n      return migration.statements.map((stmt) => stmt.sql + \";\").join(\"\\n\\n\");\n    },\n\n    compile(fromVersion, toVersion, options) {\n      const updateVersionInMigration = options?.updateVersionInMigration ?? defaultUpdateVersion;\n      const targetVersion = toVersion ?? schema.version;\n\n      return compile(fromVersion, targetVersion, updateVersionInMigration);\n    },\n  };\n}\n\n/**\n * Create the appropriate SQL generator for a database type.\n */\nfunction createSQLGenerator(\n  database: SupportedDatabase,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  coldKysely: Kysely<any>,\n): SQLGenerator {\n  switch (database) {\n    case \"sqlite\":\n      return new SQLiteSQLGenerator(coldKysely, database);\n    case \"postgresql\":\n      return new PostgresSQLGenerator(coldKysely, database);\n    case \"mysql\":\n      return new MySQLSQLGenerator(coldKysely, database);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAmGA,SAAgB,yBAAyB,QAAsD;CAC7F,MAAM,EACJ,QACA,WACA,UACA,QACA,0BAA0B,uBAAuB,SAC/C;CAMJ,MAAM,YAAY,mBAAmB,UAHlB,iBAAiB,SAAS,CAGa;;;;CAK1D,SAAS,QACP,aACA,WACA,0BACmB;AAEnB,MAAI,cAAc,EAChB,OAAM,IAAI,MAAM,mCAAmC,cAAc;AAEnE,MAAI,YAAY,EACd,OAAM,IAAI,MAAM,iCAAiC,YAAY;AAE/D,MAAI,YAAY,YACd,OAAM,IAAI,MACR,0CAA0C,YAAY,iBAAiB,UAAU,GAClF;AAEH,MAAI,YAAY,OAAO,QACrB,OAAM,IAAI,MAAM,cAAc,UAAU,4BAA4B,OAAO,QAAQ,GAAG;EAIxF,MAAM,aAAa,4BAA4B,QAAQ,aAAa,UAAU;EAG9E,MAAM,aAAa,UAAU,QAAQ,YAAY,OAAO,OAAO;AAG/D,MAAI,4BAA4B,cAAc,aAAa;GACzD,MAAM,gBAAgB,UAAU,yBAAyB,WAAW,aAAa,UAAU;AAC3F,cAAW,KAAK,cAAc;;AAGhC,SAAO;GACL;GACA;GACA;GACD;;AAGH,QAAO;EACL,MAAM,QAAQ,aAAa,WAAW,SAAS;AAC7C,OAAI,CAAC,OACH,OAAM,IAAI,MACR,kFACD;AAGH,UAAO,KAAK,kBAAkB,QAAQ,aAAa,WAAW,QAAQ;;EAGxE,MAAM,kBAAkB,aAAa,aAAa,WAAW,SAAS;GAEpE,MAAM,2BAA2B,SAAS,4BAA4B;AAOtE,SAAM,iBAAiB,aAHL,QAAQ,aAHJ,aAAa,OAAO,SAGY,yBAAyB,CAGjC;;EAGhD,OAAO,aAAa,WAAW,SAAS;GACtC,MAAM,2BAA2B,SAAS,4BAA4B;AAItE,UADkB,QAAQ,aAFJ,aAAa,OAAO,SAEY,yBAAyB,CAC9D,WAAW,KAAK,SAAS,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO;;EAGxE,QAAQ,aAAa,WAAW,SAAS;GACvC,MAAM,2BAA2B,SAAS,4BAA4B;AAGtE,UAAO,QAAQ,aAFO,aAAa,OAAO,SAEC,yBAAyB;;EAEvE;;;;;AAMH,SAAS,mBACP,UAEA,YACc;AACd,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,IAAI,mBAAmB,YAAY,SAAS;EACrD,KAAK,aACH,QAAO,IAAI,qBAAqB,YAAY,SAAS;EACvD,KAAK,QACH,QAAO,IAAI,kBAAkB,YAAY,SAAS"}