sqlmorpheus 0.1.4 → 0.1.6

package/dist/index.d.mts

@@ -121,6 +121,7 @@ declare function ForeignKey<TOther extends BackendTable>(toTable: Class<TOther>,
 declare function prepareMigration(db: DatabaseAccess, instructions: DatabaseInstructions, overwriteExisting?: boolean): Promise<void>;
 declare function runPreparedMigrations(db: DatabaseAccess, instructions: DatabaseInstructions): Promise<void>;
 declare function prepareAndRunMigration(db: DatabaseAccess, instructions: DatabaseInstructions, overwriteExisting?: boolean): Promise<void>;
+declare function runMigrationWithoutHistory(db: DatabaseAccess, instructions: DatabaseInstructions): Promise<void>;
 declare function rollback(db: DatabaseAccess, instructions: DatabaseInstructions, toVersion: number): Promise<void>;
 
-export { type DatabaseInstructions, DbTable, ForeignKey, prepareAndRunMigration, prepareMigration, rollback, runPreparedMigrations };
+export { type DatabaseInstructions, DbTable, ForeignKey, prepareAndRunMigration, prepareMigration, rollback, runMigrationWithoutHistory, runPreparedMigrations };

package/dist/index.d.ts

@@ -121,6 +121,7 @@ declare function ForeignKey<TOther extends BackendTable>(toTable: Class<TOther>,
 declare function prepareMigration(db: DatabaseAccess, instructions: DatabaseInstructions, overwriteExisting?: boolean): Promise<void>;
 declare function runPreparedMigrations(db: DatabaseAccess, instructions: DatabaseInstructions): Promise<void>;
 declare function prepareAndRunMigration(db: DatabaseAccess, instructions: DatabaseInstructions, overwriteExisting?: boolean): Promise<void>;
+declare function runMigrationWithoutHistory(db: DatabaseAccess, instructions: DatabaseInstructions): Promise<void>;
 declare function rollback(db: DatabaseAccess, instructions: DatabaseInstructions, toVersion: number): Promise<void>;
 
-export { type DatabaseInstructions, DbTable, ForeignKey, prepareAndRunMigration, prepareMigration, rollback, runPreparedMigrations };
+export { type DatabaseInstructions, DbTable, ForeignKey, prepareAndRunMigration, prepareMigration, rollback, runMigrationWithoutHistory, runPreparedMigrations };

package/dist/index.js

@@ -25,6 +25,7 @@ __export(index_exports, {
   prepareAndRunMigration: () => prepareAndRunMigration,
   prepareMigration: () => prepareMigration,
   rollback: () => rollback,
+  runMigrationWithoutHistory: () => runMigrationWithoutHistory,
   runPreparedMigrations: () => runPreparedMigrations
 });
 module.exports = __toCommonJS(index_exports);
@@ -114,7 +115,7 @@ var TableStructureGenerator = class {
           columnData.defaultValue = value === null ? this.dialect.typeNull : `"${this.dialect.formatValueToSql(value)}"`;
           break;
         case "number":
-          columnData.type = this.dialect.typeNumber;
+          columnData.type = this.dialect.typeInt;
           columnData.defaultValue = value === null ? this.dialect.typeNull : this.dialect.formatValueToSql(value);
           break;
         case "boolean":
@@ -253,18 +254,15 @@ var MigrationHistoryManager = class {
     (0, import_node_fs.mkdirSync)(this.configPath, { recursive: true });
     (0, import_node_fs.mkdirSync)(this.migrationsPath, { recursive: true });
   }
-  getLastHistoryVersion() {
-    if (this.lastVersion)
-      return this.lastVersion;
-    const path = `${this.configPath}/last_version.txt`;
-    this.lastVersion = (0, import_node_fs.existsSync)(path) ? parseInt((0, import_fs.readFileSync)(`${this.configPath}/last_version.txt`, { encoding: "utf-8" })) ?? 0 : 0;
-    return this.lastVersion;
-  }
-  setLastHistoryVersion(version) {
-    (0, import_node_fs.writeFileSync)(`${this.configPath}/last_version.txt`, version.toString(), { encoding: "utf-8" });
-  }
-  createMigrationHistory(toVersion, changes, overwriteExisting) {
-    const fromVersion = this.getLastHistoryVersion();
+  /**
+   * Creates migration history files for upgrading and downgrading database schemas.
+   *
+   * @param fromVersion - The current version number of the database.
+   * @param toVersion - The target version number for the migration.
+   * @param changes - An object containing the SQL changes for upgrading (`changes.up`) and downgrading (`changes.down`).
+   * @param overwriteExisting - A flag that determines if existing migration files should be overwritten. Defaults to `false`.
+   */
+  createMigrationHistory(fromVersion, toVersion, changes, overwriteExisting) {
     const upPath = `${this.migrationsPath}/${FILENAME_UP_PREFIX}${toVersion}.sql`;
     const downPath = `${this.migrationsPath}/${FILENAME_DOWN_PREFIX}${fromVersion}.sql`;
     if ((0, import_node_fs.existsSync)(upPath) && !overwriteExisting)
@@ -279,22 +277,36 @@ ${changes.up}`, { encoding: "utf-8" });
 -- To:   Version ${fromVersion}
 ${changes.down}`, { encoding: "utf-8" });
   }
+  /**
+   * Retrieves the SQL migration script for upgrading to the specified version.
+   * If no version is provided, it retrieves the migration script for the latest version in the history.
+   *
+   * @param toVersion - The version of the migration script to retrieve. If not specified, the latest version is used.
+   * @return The content of the SQL migration script as a string.
+   */
   getUpMigration(toVersion) {
-    return (0, import_fs.readFileSync)(`${this.migrationsPath}/${FILENAME_UP_PREFIX}${toVersion ?? this.getLastHistoryVersion()}.sql`, { encoding: "utf-8" });
+    return (0, import_fs.readFileSync)(`${this.migrationsPath}/${FILENAME_UP_PREFIX}${toVersion}.sql`, { encoding: "utf-8" });
   }
+  /**
+   * Retrieves the SQL migration script for downgrading to the specified version.
+   *
+   * @param version - The version number of the migration to retrieve.
+   * @return The SQL script for the down migration.
+   */
   getDownMigration(version) {
     return (0, import_fs.readFileSync)(`${this.migrationsPath}/${FILENAME_DOWN_PREFIX}${version}.sql`, { encoding: "utf-8" });
   }
 };
 
 // src/lib/dialects/DefaultSql.ts
+var MIGRATION_DATA_TABLE_NAME = "__sqlmorpheus_migrations";
 var DefaultSql = class {
   canAlterForeignKeys = false;
   canAlterPrimaryKey = false;
   canInspectForeignKeys = false;
   canInspectPrimaryKey = false;
   typeString = "TEXT";
-  typeNumber = "INTEGER";
+  typeInt = "INTEGER";
   typeBoolean = "BOOLEAN";
   typeNull = "NULL";
   formatValueToSql(value) {
@@ -337,8 +349,8 @@ var DefaultSql = class {
   dropTable(tableName) {
     return `DROP TABLE IF EXISTS ${tableName};`;
   }
-  columnDefinition(tableName, type, defaultValue, isPrimaryKey) {
-    const query = `${tableName} ${type} DEFAULT ${defaultValue}`;
+  columnDefinition(columnName, type, defaultValue, isPrimaryKey) {
+    const query = `${columnName} ${type} DEFAULT ${defaultValue}`;
     return isPrimaryKey ? `${query} PRIMARY KEY` : query;
   }
   createColumn(columnTable, entry) {
@@ -365,6 +377,30 @@ var DefaultSql = class {
   insertValues(keys, valueString) {
     return `(${keys}) ${valueString ?? `VALUES (${keys.map(() => "?").join(",")})`}`;
   }
+  migrationTableQuery() {
+    return this.createTable(MIGRATION_DATA_TABLE_NAME, [
+      this.columnDefinition("version", this.typeInt, "0", false)
+    ]);
+  }
+  async createMigrationTableIfNeeded(db) {
+    await db.runMultipleWriteStatements(this.migrationTableQuery());
+  }
+  //TODO: untested
+  async getVersion(db) {
+    await this.createMigrationTableIfNeeded(db);
+    const query = this.select(MIGRATION_DATA_TABLE_NAME, ["version"]);
+    const data = await db.runGetStatement(query);
+    return data.length ? data[0].version : 0;
+  }
+  //TODO: untested
+  async setVersion(db, newVersion) {
+    const query = `${this.migrationTableQuery()};
+INSERT INTO ${MIGRATION_DATA_TABLE_NAME} (version) VALUES ${newVersion} WHERE NOT EXISTS (SELECT 1 FROM ${MIGRATION_DATA_TABLE_NAME})
+UNION ALL
+UPDATE ${MIGRATION_DATA_TABLE_NAME} SET version = ${newVersion} WHERE EXISTS (SELECT 1 FROM ${MIGRATION_DATA_TABLE_NAME});
+`;
+    await db.runMultipleWriteStatements(query);
+  }
 };
 
 // src/lib/dialects/SqliteDialect.ts
@@ -412,6 +448,13 @@ var SqliteDialect = class extends DefaultSql {
         return value.toString();
     }
   }
+  async getVersion(db) {
+    const output = await db.runGetStatement(`PRAGMA user_version;`);
+    return output[0].user_version;
+  }
+  async setVersion(db, newVersion) {
+    await db.runMultipleWriteStatements(`PRAGMA user_version = ${newVersion};`);
+  }
 };
 
 // src/lib/dialects/PostgresDialect.ts
@@ -550,6 +593,22 @@ var MySqlDialect = class extends DefaultSql {
   }
 };
 
+// src/lib/getDialect.ts
+function getDialect(dbInstructions) {
+  switch (dbInstructions.dialect) {
+    case "Sqlite":
+      return new SqliteDialect();
+    case "Postgres":
+      return new PostgresDialect();
+    case "MsSql":
+      return new MsSqlDialect();
+    case "MySql":
+      return new MySqlDialect();
+    default:
+      throw new Error(`Unknown dialect ${dbInstructions.dialect}`);
+  }
+}
+
 // src/lib/MigrationManager.ts
 var MigrationManager = class {
   migrations = new Migrations();
@@ -560,31 +619,27 @@ var MigrationManager = class {
   migrationHistoryManager;
   dialect;
   constructor(db, dbInstructions) {
-    switch (dbInstructions.dialect) {
-      case "Sqlite":
-        this.dialect = new SqliteDialect();
-        break;
-      case "Postgres":
-        this.dialect = new PostgresDialect();
-        break;
-      case "MsSql":
-        this.dialect = new MsSqlDialect();
-        break;
-      case "MySql":
-        this.dialect = new MySqlDialect();
-        break;
-      default:
-        throw new Error(`Unknown dialect ${dbInstructions.dialect}`);
-    }
+    this.dialect = getDialect(dbInstructions);
     this.db = db;
     this.dbInstructions = dbInstructions;
     this.tableStructureGenerator = new TableStructureGenerator(dbInstructions, this.dialect);
     this.migrationHistoryManager = new MigrationHistoryManager(this.dbInstructions.configPath);
   }
+  /**
+   * Generates the SQL changes required to migrate a database from its current version
+   * to the target version defined in the database instructions. Handles the creation
+   * and deletion of tables, migration of foreign keys and columns, renaming of columns,
+   * and recreating tables, along with executing any pre- and post-migration custom logic.
+   *
+   * @return A promise that resolves to an object containing the SQL
+   * changes for the migration (`up` and `down` changes) or null if no migration is required.
+   * Throws an error in scenarios such as attempting to migrate to a lower version
+   * or an invalid starting version.
+   */
   async getMigrateSql() {
     if (this.dbInstructions.version <= 0)
       throw new Error("Cannot migrate to version 0 or lower");
-    const fromVersion = this.migrationHistoryManager.getLastHistoryVersion();
+    const fromVersion = await this.dialect.getVersion(this.db);
     if (fromVersion == 0) {
       Logger.log(`Creating initial migration to version ${this.dbInstructions.version}`);
       return this.createAndDropTables();
@@ -649,12 +704,29 @@ ${foreignKeyOnQuery}`;
 ${foreignKeyOnQuery}`;
     return changes;
   }
+  /**
+   * Prepares the migration by generating the SQL changes and creating a migration history entry.
+   * If no changes are needed, the method exits early.
+   *
+   * @param overwriteExisting - Optional flag indicating if overwriting existing changes is allowed.
+   * @return - A promise that resolves once the migration preparation is complete.
+   */
   async prepareMigration(overwriteExisting) {
     const changes = await this.getMigrateSql();
     if (!changes)
       return;
-    this.migrationHistoryManager.createMigrationHistory(this.dbInstructions.version, changes, overwriteExisting);
+    const fromVersion = await this.dialect.getVersion(this.db);
+    this.migrationHistoryManager.createMigrationHistory(fromVersion, this.dbInstructions.version, changes, overwriteExisting);
   }
+  /**
+   * Generates SQL change statements for creating and dropping tables based on the current table structure
+   * and existing table configurations in the database. The `up` changes include SQL statements for creating
+   * new tables, while the `down` changes include SQL statements for dropping the corresponding tables or
+   * recreating them if necessary.
+   *
+   * @return {Promise<SqlChanges>} A promise that resolves to an object containing `up` and `down` SQL
+   * change statements for migrating the database schema.
+   */
   async createAndDropTables() {
     let changes = {
       up: "\n\n-- Create tables\n",
@@ -681,6 +753,16 @@ ${foreignKeyOnQuery}`;
     }
     return changes;
   }
+  /**
+   * Generates an SQL string to create a table with the specified schema.
+   *
+   * @param tableName - The name of the table to be created.
+   * @param columns - An array of objects defining the columns of the table, including their names, types
+   * default values, and whether they are primary keys.
+   * @param foreignKeys - An optional array of objects defining the foreign key constraints for the table,
+   * including the source column, target table, target column, action on update, and action on delete.
+   * @return The complete SQL string to create the table with the specified structure and constraints.
+   */
   createTableSql(tableName, columns, foreignKeys) {
     const queryLines = [];
     for (const columnInfo of columns) {
@@ -693,9 +775,20 @@ ${foreignKeyOnQuery}`;
     }
     return this.dialect.createTable(tableName, queryLines);
   }
+  /**
+   * Checks if the specified table does not exist in the list of existing tables.
+   *
+   * @param tableName - The name of the table to check.
+   * @return Returns true if the table does not exist, otherwise false.
+   */
   tableDoesNotExists(tableName) {
     return this.existingTables.indexOf(tableName) == -1;
   }
+  /**
+   * Recreates database tables that have been flagged to be recreated in migration data.
+   * This method generated the necessary SQL code for backing up the current table data, dropping and recreating
+   * the tables, and reinserting the preserved data into the recreated tables.
+   */
   async recreateTables() {
     const changes = {
       up: "\n\n-- Recreate tables\n",
@@ -724,6 +817,9 @@ ${foreignKeyOnQuery}`;
     }
     return changes;
   }
+  /**
+   * Migrates foreign key constraints for all defined tables.
+   */
   async migrateForeignKeys() {
     if (!this.dialect.canAlterForeignKeys)
       return { up: "", down: "" };
@@ -847,12 +943,22 @@ ${foreignKeyOnQuery}`;
     }
     return changes;
   }
+  /**
+   * Retrieves the name of the primary key column from a list of column information.
+   *
+   * @param columnInfoList - An array of ColumnInfo objects containing details about each column.
+   * @return The name of the primary key column if found; otherwise, undefined.
+   */
   getPrimaryKeyColumn(columnInfoList) {
     for (const columnInfo of columnInfoList) {
       if (columnInfo.isPrimaryKey)
         return columnInfo.name;
     }
   }
+  /**
+   * Handles the renaming of columns in database tables by generating SQL changes for both applying and reverting the renames.
+   * Skips tables that are marked for recreation.
+   */
   renameColumns() {
     const changes = {
       up: "\n\n-- Rename columns\n",
@@ -914,7 +1020,8 @@ async function prepareMigration(db, instructions, overwriteExisting) {
 async function runPreparedMigrations(db, instructions) {
   Logger.setMode(instructions.loggerMode);
   const migrationHistoryManager = new MigrationHistoryManager(instructions.configPath);
-  const fromVersion = migrationHistoryManager.getLastHistoryVersion();
+  const dialect = getDialect(instructions);
+  const fromVersion = await dialect.getVersion(db);
   const toVersion = instructions.version;
   if (fromVersion == toVersion)
     return;
@@ -925,17 +1032,25 @@ async function runPreparedMigrations(db, instructions) {
     await db.runMultipleWriteStatements(upChanges);
     instructions.version = i;
   }
-  migrationHistoryManager.setLastHistoryVersion(toVersion);
+  await dialect.setVersion(db, toVersion);
 }
 async function prepareAndRunMigration(db, instructions, overwriteExisting) {
   Logger.setMode(instructions.loggerMode);
   await prepareMigration(db, instructions, overwriteExisting);
   await runPreparedMigrations(db, instructions);
 }
+async function runMigrationWithoutHistory(db, instructions) {
+  Logger.setMode(instructions.loggerMode);
+  const mm = new MigrationManager(db, instructions);
+  const changes = await mm.getMigrateSql();
+  if (changes)
+    await db.runMultipleWriteStatements(changes.up);
+}
 async function rollback(db, instructions, toVersion) {
   Logger.setMode(instructions.loggerMode);
   const migrationHistoryManager = new MigrationHistoryManager(instructions.configPath);
-  const fromVersion = migrationHistoryManager.getLastHistoryVersion();
+  const dialect = getDialect(instructions);
+  const fromVersion = await dialect.getVersion(db);
   Logger.log(`Rolling back from ${fromVersion} to ${toVersion}`);
   for (let i = fromVersion - 1; i >= toVersion; --i) {
     const upChanges = migrationHistoryManager.getDownMigration(i);
@@ -943,7 +1058,7 @@ async function rollback(db, instructions, toVersion) {
     await db.runMultipleWriteStatements(upChanges);
     instructions.version = i;
   }
-  migrationHistoryManager.setLastHistoryVersion(toVersion);
+  await dialect.setVersion(db, toVersion);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -952,5 +1067,6 @@ async function rollback(db, instructions, toVersion) {
   prepareAndRunMigration,
   prepareMigration,
   rollback,
+  runMigrationWithoutHistory,
   runPreparedMigrations
 });

package/dist/index.mjs

@@ -83,7 +83,7 @@ var TableStructureGenerator = class {
           columnData.defaultValue = value === null ? this.dialect.typeNull : `"${this.dialect.formatValueToSql(value)}"`;
           break;
         case "number":
-          columnData.type = this.dialect.typeNumber;
+          columnData.type = this.dialect.typeInt;
           columnData.defaultValue = value === null ? this.dialect.typeNull : this.dialect.formatValueToSql(value);
           break;
         case "boolean":
@@ -222,18 +222,15 @@ var MigrationHistoryManager = class {
     mkdirSync(this.configPath, { recursive: true });
     mkdirSync(this.migrationsPath, { recursive: true });
   }
-  getLastHistoryVersion() {
-    if (this.lastVersion)
-      return this.lastVersion;
-    const path = `${this.configPath}/last_version.txt`;
-    this.lastVersion = existsSync(path) ? parseInt(readFileSync(`${this.configPath}/last_version.txt`, { encoding: "utf-8" })) ?? 0 : 0;
-    return this.lastVersion;
-  }
-  setLastHistoryVersion(version) {
-    writeFileSync(`${this.configPath}/last_version.txt`, version.toString(), { encoding: "utf-8" });
-  }
-  createMigrationHistory(toVersion, changes, overwriteExisting) {
-    const fromVersion = this.getLastHistoryVersion();
+  /**
+   * Creates migration history files for upgrading and downgrading database schemas.
+   *
+   * @param fromVersion - The current version number of the database.
+   * @param toVersion - The target version number for the migration.
+   * @param changes - An object containing the SQL changes for upgrading (`changes.up`) and downgrading (`changes.down`).
+   * @param overwriteExisting - A flag that determines if existing migration files should be overwritten. Defaults to `false`.
+   */
+  createMigrationHistory(fromVersion, toVersion, changes, overwriteExisting) {
     const upPath = `${this.migrationsPath}/${FILENAME_UP_PREFIX}${toVersion}.sql`;
     const downPath = `${this.migrationsPath}/${FILENAME_DOWN_PREFIX}${fromVersion}.sql`;
     if (existsSync(upPath) && !overwriteExisting)
@@ -248,22 +245,36 @@ ${changes.up}`, { encoding: "utf-8" });
 -- To:   Version ${fromVersion}
 ${changes.down}`, { encoding: "utf-8" });
   }
+  /**
+   * Retrieves the SQL migration script for upgrading to the specified version.
+   * If no version is provided, it retrieves the migration script for the latest version in the history.
+   *
+   * @param toVersion - The version of the migration script to retrieve. If not specified, the latest version is used.
+   * @return The content of the SQL migration script as a string.
+   */
   getUpMigration(toVersion) {
-    return readFileSync(`${this.migrationsPath}/${FILENAME_UP_PREFIX}${toVersion ?? this.getLastHistoryVersion()}.sql`, { encoding: "utf-8" });
+    return readFileSync(`${this.migrationsPath}/${FILENAME_UP_PREFIX}${toVersion}.sql`, { encoding: "utf-8" });
   }
+  /**
+   * Retrieves the SQL migration script for downgrading to the specified version.
+   *
+   * @param version - The version number of the migration to retrieve.
+   * @return The SQL script for the down migration.
+   */
   getDownMigration(version) {
     return readFileSync(`${this.migrationsPath}/${FILENAME_DOWN_PREFIX}${version}.sql`, { encoding: "utf-8" });
   }
 };
 
 // src/lib/dialects/DefaultSql.ts
+var MIGRATION_DATA_TABLE_NAME = "__sqlmorpheus_migrations";
 var DefaultSql = class {
   canAlterForeignKeys = false;
   canAlterPrimaryKey = false;
   canInspectForeignKeys = false;
   canInspectPrimaryKey = false;
   typeString = "TEXT";
-  typeNumber = "INTEGER";
+  typeInt = "INTEGER";
   typeBoolean = "BOOLEAN";
   typeNull = "NULL";
   formatValueToSql(value) {
@@ -306,8 +317,8 @@ var DefaultSql = class {
   dropTable(tableName) {
     return `DROP TABLE IF EXISTS ${tableName};`;
   }
-  columnDefinition(tableName, type, defaultValue, isPrimaryKey) {
-    const query = `${tableName} ${type} DEFAULT ${defaultValue}`;
+  columnDefinition(columnName, type, defaultValue, isPrimaryKey) {
+    const query = `${columnName} ${type} DEFAULT ${defaultValue}`;
     return isPrimaryKey ? `${query} PRIMARY KEY` : query;
   }
   createColumn(columnTable, entry) {
@@ -334,6 +345,30 @@ var DefaultSql = class {
   insertValues(keys, valueString) {
     return `(${keys}) ${valueString ?? `VALUES (${keys.map(() => "?").join(",")})`}`;
   }
+  migrationTableQuery() {
+    return this.createTable(MIGRATION_DATA_TABLE_NAME, [
+      this.columnDefinition("version", this.typeInt, "0", false)
+    ]);
+  }
+  async createMigrationTableIfNeeded(db) {
+    await db.runMultipleWriteStatements(this.migrationTableQuery());
+  }
+  //TODO: untested
+  async getVersion(db) {
+    await this.createMigrationTableIfNeeded(db);
+    const query = this.select(MIGRATION_DATA_TABLE_NAME, ["version"]);
+    const data = await db.runGetStatement(query);
+    return data.length ? data[0].version : 0;
+  }
+  //TODO: untested
+  async setVersion(db, newVersion) {
+    const query = `${this.migrationTableQuery()};
+INSERT INTO ${MIGRATION_DATA_TABLE_NAME} (version) VALUES ${newVersion} WHERE NOT EXISTS (SELECT 1 FROM ${MIGRATION_DATA_TABLE_NAME})
+UNION ALL
+UPDATE ${MIGRATION_DATA_TABLE_NAME} SET version = ${newVersion} WHERE EXISTS (SELECT 1 FROM ${MIGRATION_DATA_TABLE_NAME});
+`;
+    await db.runMultipleWriteStatements(query);
+  }
 };
 
 // src/lib/dialects/SqliteDialect.ts
@@ -381,6 +416,13 @@ var SqliteDialect = class extends DefaultSql {
         return value.toString();
     }
   }
+  async getVersion(db) {
+    const output = await db.runGetStatement(`PRAGMA user_version;`);
+    return output[0].user_version;
+  }
+  async setVersion(db, newVersion) {
+    await db.runMultipleWriteStatements(`PRAGMA user_version = ${newVersion};`);
+  }
 };
 
 // src/lib/dialects/PostgresDialect.ts
@@ -519,6 +561,22 @@ var MySqlDialect = class extends DefaultSql {
   }
 };
 
+// src/lib/getDialect.ts
+function getDialect(dbInstructions) {
+  switch (dbInstructions.dialect) {
+    case "Sqlite":
+      return new SqliteDialect();
+    case "Postgres":
+      return new PostgresDialect();
+    case "MsSql":
+      return new MsSqlDialect();
+    case "MySql":
+      return new MySqlDialect();
+    default:
+      throw new Error(`Unknown dialect ${dbInstructions.dialect}`);
+  }
+}
+
 // src/lib/MigrationManager.ts
 var MigrationManager = class {
   migrations = new Migrations();
@@ -529,31 +587,27 @@ var MigrationManager = class {
   migrationHistoryManager;
   dialect;
   constructor(db, dbInstructions) {
-    switch (dbInstructions.dialect) {
-      case "Sqlite":
-        this.dialect = new SqliteDialect();
-        break;
-      case "Postgres":
-        this.dialect = new PostgresDialect();
-        break;
-      case "MsSql":
-        this.dialect = new MsSqlDialect();
-        break;
-      case "MySql":
-        this.dialect = new MySqlDialect();
-        break;
-      default:
-        throw new Error(`Unknown dialect ${dbInstructions.dialect}`);
-    }
+    this.dialect = getDialect(dbInstructions);
     this.db = db;
     this.dbInstructions = dbInstructions;
     this.tableStructureGenerator = new TableStructureGenerator(dbInstructions, this.dialect);
     this.migrationHistoryManager = new MigrationHistoryManager(this.dbInstructions.configPath);
   }
+  /**
+   * Generates the SQL changes required to migrate a database from its current version
+   * to the target version defined in the database instructions. Handles the creation
+   * and deletion of tables, migration of foreign keys and columns, renaming of columns,
+   * and recreating tables, along with executing any pre- and post-migration custom logic.
+   *
+   * @return A promise that resolves to an object containing the SQL
+   * changes for the migration (`up` and `down` changes) or null if no migration is required.
+   * Throws an error in scenarios such as attempting to migrate to a lower version
+   * or an invalid starting version.
+   */
   async getMigrateSql() {
     if (this.dbInstructions.version <= 0)
       throw new Error("Cannot migrate to version 0 or lower");
-    const fromVersion = this.migrationHistoryManager.getLastHistoryVersion();
+    const fromVersion = await this.dialect.getVersion(this.db);
     if (fromVersion == 0) {
       Logger.log(`Creating initial migration to version ${this.dbInstructions.version}`);
       return this.createAndDropTables();
@@ -618,12 +672,29 @@ ${foreignKeyOnQuery}`;
 ${foreignKeyOnQuery}`;
     return changes;
   }
+  /**
+   * Prepares the migration by generating the SQL changes and creating a migration history entry.
+   * If no changes are needed, the method exits early.
+   *
+   * @param overwriteExisting - Optional flag indicating if overwriting existing changes is allowed.
+   * @return - A promise that resolves once the migration preparation is complete.
+   */
   async prepareMigration(overwriteExisting) {
     const changes = await this.getMigrateSql();
     if (!changes)
       return;
-    this.migrationHistoryManager.createMigrationHistory(this.dbInstructions.version, changes, overwriteExisting);
+    const fromVersion = await this.dialect.getVersion(this.db);
+    this.migrationHistoryManager.createMigrationHistory(fromVersion, this.dbInstructions.version, changes, overwriteExisting);
   }
+  /**
+   * Generates SQL change statements for creating and dropping tables based on the current table structure
+   * and existing table configurations in the database. The `up` changes include SQL statements for creating
+   * new tables, while the `down` changes include SQL statements for dropping the corresponding tables or
+   * recreating them if necessary.
+   *
+   * @return {Promise<SqlChanges>} A promise that resolves to an object containing `up` and `down` SQL
+   * change statements for migrating the database schema.
+   */
   async createAndDropTables() {
     let changes = {
       up: "\n\n-- Create tables\n",
@@ -650,6 +721,16 @@ ${foreignKeyOnQuery}`;
     }
     return changes;
   }
+  /**
+   * Generates an SQL string to create a table with the specified schema.
+   *
+   * @param tableName - The name of the table to be created.
+   * @param columns - An array of objects defining the columns of the table, including their names, types
+   * default values, and whether they are primary keys.
+   * @param foreignKeys - An optional array of objects defining the foreign key constraints for the table,
+   * including the source column, target table, target column, action on update, and action on delete.
+   * @return The complete SQL string to create the table with the specified structure and constraints.
+   */
   createTableSql(tableName, columns, foreignKeys) {
     const queryLines = [];
     for (const columnInfo of columns) {
@@ -662,9 +743,20 @@ ${foreignKeyOnQuery}`;
     }
     return this.dialect.createTable(tableName, queryLines);
   }
+  /**
+   * Checks if the specified table does not exist in the list of existing tables.
+   *
+   * @param tableName - The name of the table to check.
+   * @return Returns true if the table does not exist, otherwise false.
+   */
   tableDoesNotExists(tableName) {
     return this.existingTables.indexOf(tableName) == -1;
   }
+  /**
+   * Recreates database tables that have been flagged to be recreated in migration data.
+   * This method generated the necessary SQL code for backing up the current table data, dropping and recreating
+   * the tables, and reinserting the preserved data into the recreated tables.
+   */
   async recreateTables() {
     const changes = {
       up: "\n\n-- Recreate tables\n",
@@ -693,6 +785,9 @@ ${foreignKeyOnQuery}`;
     }
     return changes;
   }
+  /**
+   * Migrates foreign key constraints for all defined tables.
+   */
   async migrateForeignKeys() {
     if (!this.dialect.canAlterForeignKeys)
       return { up: "", down: "" };
@@ -816,12 +911,22 @@ ${foreignKeyOnQuery}`;
     }
     return changes;
   }
+  /**
+   * Retrieves the name of the primary key column from a list of column information.
+   *
+   * @param columnInfoList - An array of ColumnInfo objects containing details about each column.
+   * @return The name of the primary key column if found; otherwise, undefined.
+   */
   getPrimaryKeyColumn(columnInfoList) {
     for (const columnInfo of columnInfoList) {
       if (columnInfo.isPrimaryKey)
         return columnInfo.name;
     }
   }
+  /**
+   * Handles the renaming of columns in database tables by generating SQL changes for both applying and reverting the renames.
+   * Skips tables that are marked for recreation.
+   */
   renameColumns() {
     const changes = {
       up: "\n\n-- Rename columns\n",
@@ -883,7 +988,8 @@ async function prepareMigration(db, instructions, overwriteExisting) {
 async function runPreparedMigrations(db, instructions) {
   Logger.setMode(instructions.loggerMode);
   const migrationHistoryManager = new MigrationHistoryManager(instructions.configPath);
-  const fromVersion = migrationHistoryManager.getLastHistoryVersion();
+  const dialect = getDialect(instructions);
+  const fromVersion = await dialect.getVersion(db);
   const toVersion = instructions.version;
   if (fromVersion == toVersion)
     return;
@@ -894,17 +1000,25 @@ async function runPreparedMigrations(db, instructions) {
     await db.runMultipleWriteStatements(upChanges);
     instructions.version = i;
   }
-  migrationHistoryManager.setLastHistoryVersion(toVersion);
+  await dialect.setVersion(db, toVersion);
 }
 async function prepareAndRunMigration(db, instructions, overwriteExisting) {
   Logger.setMode(instructions.loggerMode);
   await prepareMigration(db, instructions, overwriteExisting);
   await runPreparedMigrations(db, instructions);
 }
+async function runMigrationWithoutHistory(db, instructions) {
+  Logger.setMode(instructions.loggerMode);
+  const mm = new MigrationManager(db, instructions);
+  const changes = await mm.getMigrateSql();
+  if (changes)
+    await db.runMultipleWriteStatements(changes.up);
+}
 async function rollback(db, instructions, toVersion) {
   Logger.setMode(instructions.loggerMode);
   const migrationHistoryManager = new MigrationHistoryManager(instructions.configPath);
-  const fromVersion = migrationHistoryManager.getLastHistoryVersion();
+  const dialect = getDialect(instructions);
+  const fromVersion = await dialect.getVersion(db);
   Logger.log(`Rolling back from ${fromVersion} to ${toVersion}`);
   for (let i = fromVersion - 1; i >= toVersion; --i) {
     const upChanges = migrationHistoryManager.getDownMigration(i);
@@ -912,7 +1026,7 @@ async function rollback(db, instructions, toVersion) {
     await db.runMultipleWriteStatements(upChanges);
     instructions.version = i;
   }
-  migrationHistoryManager.setLastHistoryVersion(toVersion);
+  await dialect.setVersion(db, toVersion);
 }
 export {
   DbTable,
@@ -920,5 +1034,6 @@ export {
   prepareAndRunMigration,
   prepareMigration,
   rollback,
+  runMigrationWithoutHistory,
   runPreparedMigrations
 };

package/package.json

@@ -1,39 +1,39 @@
-{
-  "name": "sqlmorpheus",
-  "version": "0.1.4",
-  "author": "JodliDev",
-  "keywords": [],
-  "license": "MIT",
-  "description": "",
-  "repository": {
-    "type": "git",
-    "url": "git://github.com/JodliDev/SqlMorpheus.git"
-  },
-  "bugs": {
-    "url": "https://github.com/JodliDev/SqlMorpheus/issues"
-  },
-  "homepage": "https://github.com/JodliDev/SqlMorpheus#readme",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "/dist"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "publish": "npm publish"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^24.0.13",
-    "better-sqlite3": "^12.2.0",
-    "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
-  },
-  "dependencies": {
-    "polyfill-symbol-metadata": "^0.0.2"
-  }
-}
+{
+  "name": "sqlmorpheus",
+  "version": "0.1.6",
+  "author": "JodliDev",
+  "keywords": [],
+  "license": "MIT",
+  "description": "",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/JodliDev/SqlMorpheus.git"
+  },
+  "bugs": {
+    "url": "https://github.com/JodliDev/SqlMorpheus/issues"
+  },
+  "homepage": "https://github.com/JodliDev/SqlMorpheus#readme",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "run_publish": "npm publish"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^24.0.13",
+    "better-sqlite3": "^12.2.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "polyfill-symbol-metadata": "^0.0.2"
+  }
+}