taon 21.0.44 → 21.0.48

package/lib-prod/context-db-migrations.ts

@@ -0,0 +1,488 @@
+//#region imports
+import { ___NS__add, ___NS__after, ___NS__ary, ___NS__assign, ___NS__assignIn, ___NS__assignInWith, ___NS__assignWith, ___NS__at, ___NS__attempt, ___NS__before, ___NS__bind, ___NS__bindAll, ___NS__bindKey, ___NS__camelCase, ___NS__capitalize, ___NS__castArray, ___NS__ceil, ___NS__chain, ___NS__chunk, ___NS__clamp, ___NS__clone, ___NS__cloneDeep, ___NS__cloneDeepWith, ___NS__cloneWith, ___NS__compact, ___NS__concat, ___NS__cond, ___NS__conforms, ___NS__conformsTo, ___NS__constant, ___NS__countBy, ___NS__create, ___NS__curry, ___NS__curryRight, ___NS__debounce, ___NS__deburr, ___NS__defaults, ___NS__defaultsDeep, ___NS__defaultTo, ___NS__defer, ___NS__delay, ___NS__difference, ___NS__differenceBy, ___NS__differenceWith, ___NS__divide, ___NS__drop, ___NS__dropRight, ___NS__dropRightWhile, ___NS__dropWhile, ___NS__each, ___NS__eachRight, ___NS__endsWith, ___NS__entries, ___NS__entriesIn, ___NS__eq, ___NS__escape, ___NS__escapeRegExp, ___NS__every, ___NS__extend, ___NS__extendWith, ___NS__fill, ___NS__filter, ___NS__find, ___NS__findIndex, ___NS__findKey, ___NS__findLast, ___NS__findLastIndex, ___NS__findLastKey, ___NS__first, ___NS__flatMap, ___NS__flatMapDeep, ___NS__flatMapDepth, ___NS__flatten, ___NS__flattenDeep, ___NS__flattenDepth, ___NS__flip, ___NS__floor, ___NS__flow, ___NS__flowRight, ___NS__forEach, ___NS__forEachRight, ___NS__forIn, ___NS__forInRight, ___NS__forOwn, ___NS__forOwnRight, ___NS__fromPairs, ___NS__functions, ___NS__functionsIn, ___NS__get, ___NS__groupBy, ___NS__gt, ___NS__gte, ___NS__has, ___NS__hasIn, ___NS__head, ___NS__identity, ___NS__includes, ___NS__indexOf, ___NS__initial, ___NS__inRange, ___NS__intersection, ___NS__intersectionBy, ___NS__intersectionWith, ___NS__invert, ___NS__invertBy, ___NS__invoke, ___NS__invokeMap, ___NS__isArguments, ___NS__isArray, ___NS__isArrayBuffer, ___NS__isArrayLike, ___NS__isArrayLikeObject, ___NS__isBoolean, ___NS__isBuffer, ___NS__isDate, ___NS__isElement, ___NS__isEmpty, ___NS__isEqual, ___NS__isEqualWith, ___NS__isError, ___NS__isFinite, ___NS__isFunction, ___NS__isInteger, ___NS__isLength, ___NS__isMap, ___NS__isMatch, ___NS__isMatchWith, ___NS__isNaN, ___NS__isNative, ___NS__isNil, ___NS__isNull, ___NS__isNumber, ___NS__isObject, ___NS__isObjectLike, ___NS__isPlainObject, ___NS__isRegExp, ___NS__isSafeInteger, ___NS__isSet, ___NS__isString, ___NS__isSymbol, ___NS__isTypedArray, ___NS__isUndefined, ___NS__isWeakMap, ___NS__isWeakSet, ___NS__iteratee, ___NS__join, ___NS__kebabCase, ___NS__keyBy, ___NS__keys, ___NS__keysIn, ___NS__last, ___NS__lastIndexOf, ___NS__lowerCase, ___NS__lowerFirst, ___NS__lt, ___NS__lte, ___NS__map, ___NS__mapKeys, ___NS__mapValues, ___NS__matches, ___NS__matchesProperty, ___NS__max, ___NS__maxBy, ___NS__mean, ___NS__meanBy, ___NS__memoize, ___NS__merge, ___NS__mergeWith, ___NS__method, ___NS__methodOf, ___NS__min, ___NS__minBy, ___NS__mixin, ___NS__multiply, ___NS__negate, ___NS__noop, ___NS__now, ___NS__nth, ___NS__nthArg, ___NS__omit, ___NS__omitBy, ___NS__once, ___NS__orderBy, ___NS__over, ___NS__overArgs, ___NS__overEvery, ___NS__overSome, ___NS__pad, ___NS__padEnd, ___NS__padStart, ___NS__parseInt, ___NS__partial, ___NS__partialRight, ___NS__partition, ___NS__pick, ___NS__pickBy, ___NS__property, ___NS__propertyOf, ___NS__pull, ___NS__pullAll, ___NS__pullAllBy, ___NS__pullAllWith, ___NS__pullAt, ___NS__random, ___NS__range, ___NS__rangeRight, ___NS__rearg, ___NS__reduce, ___NS__reduceRight, ___NS__reject, ___NS__remove, ___NS__repeat, ___NS__replace, ___NS__rest, ___NS__result, ___NS__reverse, ___NS__round, ___NS__sample, ___NS__sampleSize, ___NS__set, ___NS__setWith, ___NS__shuffle, ___NS__size, ___NS__slice, ___NS__snakeCase, ___NS__some, ___NS__sortBy, ___NS__sortedIndex, ___NS__sortedIndexBy, ___NS__sortedIndexOf, ___NS__sortedLastIndex, ___NS__sortedLastIndexBy, ___NS__sortedLastIndexOf, ___NS__sortedUniq, ___NS__sortedUniqBy, ___NS__split, ___NS__spread, ___NS__startCase, ___NS__startsWith, ___NS__stubArray, ___NS__stubFalse, ___NS__stubObject, ___NS__stubString, ___NS__stubTrue, ___NS__subtract, ___NS__sum, ___NS__sumBy, ___NS__tail, ___NS__take, ___NS__takeRight, ___NS__takeRightWhile, ___NS__takeWhile, ___NS__tap, ___NS__template, ___NS__templateSettings, ___NS__throttle, ___NS__thru, ___NS__times, ___NS__toArray, ___NS__toFinite, ___NS__toInteger, ___NS__toLength, ___NS__toLower, ___NS__toNumber, ___NS__toPairs, ___NS__toPairsIn, ___NS__toPath, ___NS__toPlainObject, ___NS__toSafeInteger, ___NS__toString, ___NS__toUpper, ___NS__transform, ___NS__trim, ___NS__trimEnd, ___NS__trimStart, ___NS__truncate, ___NS__unary, ___NS__unescape, ___NS__union, ___NS__unionBy, ___NS__unionWith, ___NS__uniq, ___NS__uniqBy, ___NS__uniqueId, ___NS__uniqWith, ___NS__unset, ___NS__unzip, ___NS__unzipWith, ___NS__update, ___NS__updateWith, ___NS__upperCase, ___NS__upperFirst, ___NS__values, ___NS__valuesIn, ___NS__without, ___NS__words, ___NS__wrap, ___NS__xor, ___NS__xorBy, ___NS__xorWith, ___NS__zip, ___NS__zipObject, ___NS__zipObjectDeep, ___NS__zipWith, Helpers__NS___fixCommand, Helpers__NS__bigMaxBuffer, Helpers__NS__checkProcess, Helpers__NS__cleanExit, Helpers__NS__clearConsole, Helpers__NS__command, Helpers__NS__commandOutputAsString, Helpers__NS__commandOutputAsStringAsync, Helpers__NS__compilationWrapper, Helpers__NS__contain, Helpers__NS__createFolder, Helpers__NS__createSymLink, Helpers__NS__error, Helpers__NS__execute, Helpers__NS__exists, Helpers__NS__filesFrom, Helpers__NS__foldersFrom, Helpers__NS__getFilesFrom, Helpers__NS__getFoldersFrom, Helpers__NS__getIsBrowser, Helpers__NS__getIsElectron, Helpers__NS__getIsNode, Helpers__NS__getIsRunningInGitBash, Helpers__NS__getIsSupportedTaonTerminal, Helpers__NS__getIsVerboseMode, Helpers__NS__getIsWebSQL, Helpers__NS__getIsWsl, Helpers__NS__getStdio, Helpers__NS__hideNodeWarnings, Helpers__NS__info, Helpers__NS__isBlob, Helpers__NS__isBuffer, Helpers__NS__isClass, Helpers__NS__isExistedSymlink, Helpers__NS__isFile, Helpers__NS__isFolder, Helpers__NS__isRunningInDocker, Helpers__NS__isRunningInLinuxGraphicsCapableEnvironment, Helpers__NS__isSymlinkFileExitedOrUnexisted, Helpers__NS__isSymlinkThatMatchesUrl, Helpers__NS__isUnexistedLink, Helpers__NS__killOnPort, Helpers__NS__killProcess, Helpers__NS__killProcessByPort, Helpers__NS__linksToFolderFrom, Helpers__NS__linksToFoldersFrom, Helpers__NS__log, Helpers__NS__logError, Helpers__NS__logInfo, Helpers__NS__logProc, Helpers__NS__logSuccess, Helpers__NS__logWarn, Helpers__NS__mediaTypeFromSrc, Helpers__NS__mkdirp, Helpers__NS__modifyLineByLine, Helpers__NS__msgCacheClear, Helpers__NS__openFolderInFileExplorer, Helpers__NS__parse, Helpers__NS__pathContainLink, Helpers__NS__questionYesNo, Helpers__NS__readFile, Helpers__NS__readJson, Helpers__NS__readJson5, Helpers__NS__readJsonC, Helpers__NS__relative, Helpers__NS__remove, Helpers__NS__removeEmptyLineFromString, Helpers__NS__removeFileIfExists, Helpers__NS__removeFolderIfExists, Helpers__NS__removeIfExists, Helpers__NS__removeSlashAtBegin, Helpers__NS__removeSlashAtEnd, Helpers__NS__removeSymlinks, Helpers__NS__renderError, Helpers__NS__replaceLinesInFile, Helpers__NS__run, Helpers__NS__runAsyncIn, Helpers__NS__runSyncIn, Helpers__NS__runSyncOrAsync, Helpers__NS__sleep, Helpers__NS__stopApplication, Helpers__NS__stringify, Helpers__NS__success, Helpers__NS__taskDone, Helpers__NS__taskStarted, Helpers__NS__throwError, Helpers__NS__timeout, Helpers__NS__tryCatchError, Helpers__NS__tryReadFile, Helpers__NS__tryRemoveDir, Helpers__NS__values, Helpers__NS__wait, Helpers__NS__warn, Helpers__NS__writeFile, Helpers__NS__writeJson, Helpers__NS__writeJson5, Helpers__NS__writeJsonC, UtilsMigrations__NS__formatTimestamp, UtilsMigrations__NS__getFormattedTimestampFromClassName, UtilsMigrations__NS__getTimestampFromClassName, UtilsMigrations__NS__isValidTimestamp } from 'tnp-core/lib-prod';
+import { TaonBaseMigration } from './base-classes/base-migration';
+import type { EndpointContext } from './endpoint-context';
+import { Models__NS__ClassType, Models__NS__ClassTypeKey, Models__NS__ConnectionOptionsLogs, Models__NS__ContextOptions, Models__NS__DatabaseConfig, Models__NS__DatabaseConfigTypeOrm, Models__NS__DatabasesFolder, Models__NS__DBRecreateMode, Models__NS__FrameworkMode, Models__NS__Http__NS__AsyncResponse, Models__NS__Http__NS__AuthCallBack, Models__NS__Http__NS__ClientAction, Models__NS__Http__NS__ContextENDPOINT, Models__NS__Http__NS__ExpressContext, Models__NS__Http__NS__FormlyFromType, Models__NS__Http__NS__MixResponse, Models__NS__Http__NS__Response, Models__NS__Http__NS__ResponseFuncOpt, Models__NS__Http__NS__SyncResponse, Models__NS__Http__NS__SyncResponseFunc, Models__NS__ISession, Models__NS__MiddlewareType, Models__NS__StartParams, Models__NS__TaonCtxCloneParams, Models__NS__TaonInitializeParams } from './models';
+import { ClassHelpers__NS__asyncHandler, ClassHelpers__NS__ensureClassConfig, ClassHelpers__NS__ensureMethodConfig, ClassHelpers__NS__getClassConfig, ClassHelpers__NS__getClassFnFromObject, ClassHelpers__NS__getControllerConfigs, ClassHelpers__NS__getFullInternalName, ClassHelpers__NS__getMethodsNames, ClassHelpers__NS__getName, ClassHelpers__NS__getOrginalClass, ClassHelpers__NS__getUniqueKey, ClassHelpers__NS__hasParentClassWithName, ClassHelpers__NS__isContextClassObject, ClassHelpers__NS__setName } from './helpers/class-helpers';
+import {
+  Column,
+  DataSource,
+  Entity,
+  EntitySchema,
+  Index,
+  PrimaryGeneratedColumn,
+  QueryRunner,
+  Table,
+  TableColumn,
+  TableIndex,
+} from 'taon-typeorm/lib-prod';
+//#endregion
+
+//#region models
+export type MigrationStatus = 'completed' | 'pending';
+
+export class ContextDbMigrations {
+  //#region fields
+
+  //#region fields / migration table name
+  readonly DEFAULT_MIGRATION_TABLE_NAME = 'TAON_MIGRATION_META';
+  //#endregion
+
+  //#region fields / migration statuses
+  readonly MIGRATION_STATUS_COMPLETED: MigrationStatus = 'completed';
+  readonly MIGRATION_STATUS_PENDING: MigrationStatus = 'pending';
+  //#endregion
+
+  //#region fields / migration table schema
+  readonly table = new Table({
+    name: this.DEFAULT_MIGRATION_TABLE_NAME,
+    columns: [
+      {
+        name: 'id',
+        type: 'integer',
+        isPrimary: true, // Mark it as the primary key
+        isGenerated: true, // Enable auto-generation
+        generationStrategy: 'increment', // Use auto-increment strategy
+      },
+      {
+        name: 'name',
+        type: 'varchar',
+        length: '255',
+        isUnique: true, // Ensure the name is unique
+        isNullable: false, // Ensure this field is required
+      },
+      {
+        // context is a part of name
+        name: 'context',
+        type: 'varchar',
+        length: '255',
+        isNullable: false, // Optional context for migrations (e.g., tenant or module name)
+      },
+      {
+        name: 'applied_at',
+        type: 'timestamp',
+        default: 'CURRENT_TIMESTAMP', // Automatically set the timestamp
+        isNullable: true,
+      },
+      {
+        name: 'status',
+        type: 'varchar',
+        length: '50',
+        default: `'${this.MIGRATION_STATUS_COMPLETED}'`,
+        isNullable: false,
+      },
+      // { // TODO not needed for now
+      //   name: 'checksum',
+      //   type: 'varchar',
+      //   length: '64',
+      //   isNullable: true, // Optional field to store a hash/checksum of migration file
+      // },
+    ],
+  });
+  //#endregion
+
+  //#endregion
+
+  //#region constructor
+  constructor(private ctx: EndpointContext) {}
+  //#endregion
+
+  //#region methods & getters / make sure migration table exists
+  async ensureMigrationTableExists(): Promise<void> {
+    //#region @websqlFunc
+    if (this.ctx.isRemoteHost || !this.ctx.connection) {
+      return;
+    }
+    const queryRunner = this.ctx.connection.createQueryRunner();
+    await queryRunner.connect();
+    await queryRunner.startTransaction();
+
+    // Check if the table already exists
+    const hasTable = await queryRunner.hasTable(
+      this.DEFAULT_MIGRATION_TABLE_NAME,
+    );
+    if (hasTable) {
+      this.ctx.logMigrations &&
+        console.log(
+          `Table ${this.DEFAULT_MIGRATION_TABLE_NAME} already exists.`,
+        );
+      await queryRunner.commitTransaction();
+      await queryRunner.release();
+      return; // Exit early if the table exists
+    }
+
+    try {
+      await queryRunner.createTable(this.table);
+      await queryRunner.createIndex(
+        this.DEFAULT_MIGRATION_TABLE_NAME,
+        new TableIndex({
+          name: 'IDX_NAME',
+          columnNames: ['name'],
+        }),
+      );
+
+      await queryRunner.commitTransaction();
+    } catch (error) {
+      this.ctx.logMigrations &&
+        console.error(
+          `Transaction failed [ensureMigrationTableExists]` + `, rolling back:`,
+          error,
+        );
+      await queryRunner.rollbackTransaction();
+    } finally {
+      await queryRunner.release();
+    }
+
+    //#endregion
+  }
+  //#endregion
+
+  //#region methods & getters / revert migration to timestamp
+  private async logSelectALl(name: string, queryRunner: QueryRunner) {
+    console.log(
+      name,
+      (
+        await queryRunner.query(
+          `SELECT * FROM ${this.DEFAULT_MIGRATION_TABLE_NAME} WHERE context = $1`,
+          [this.ctx.contextName],
+        )
+      ).map(m => m.name),
+    );
+  }
+
+  async revertMigrationToTimestamp(timestamp: number) {
+    //#region @websqlFunc
+    if (this.ctx.isRemoteHost || !this.ctx.connection) {
+      return;
+    }
+    if (!UtilsMigrations__NS__isValidTimestamp(timestamp)) {
+      Helpers__NS__throwError(
+        `Invalid timestamp provided for migration revert: ${timestamp}`,
+      );
+    }
+
+    // Get all migration class functions and reverse the order
+    const migrationsClassFns: Function[] = this.ctx
+      .getClassFunByArr(Models__NS__ClassType.MIGRATION)
+      .reverse();
+
+    // Filter migrations that need to be reverted
+    const migrationClassesInstancesToRevert: TaonBaseMigration[] =
+      migrationsClassFns
+        .map(classFn => {
+          const timestampFromClassName = Number(
+            UtilsMigrations__NS__getTimestampFromClassName(
+              ClassHelpers__NS__getName(classFn),
+            ),
+          );
+
+          if (timestampFromClassName <= timestamp) {
+            // this.ctx.logMigrations &&
+            //   console.log(
+            //     `Stopping migration filter at: ${ClassHelpers__NS__getName(classFn)} ` +
+            //       `with timestamp ${timestampFromClassName}`,
+            //   );
+            return null;
+          }
+
+          return this.ctx.getInstanceBy(classFn as any) as any;
+        })
+        .filter(f => !!f)
+        .map(f => f as TaonBaseMigration)
+        .filter(migrationInstance => migrationInstance.isReadyToRun());
+
+    const queryRunner = this.ctx.connection.createQueryRunner();
+    await queryRunner.connect();
+
+    try {
+      await queryRunner.startTransaction();
+
+      // Fetch applied migrations from the database
+      const appliedMigrationsForContext = await queryRunner.query(
+        `SELECT name FROM ${this.DEFAULT_MIGRATION_TABLE_NAME}
+         WHERE status = $1 AND context = $2`,
+        [this.MIGRATION_STATUS_COMPLETED, this.ctx.contextName],
+      );
+
+      const appliedMigrationsForContextNames = appliedMigrationsForContext.map(
+        m => m.name,
+      );
+      // console.log({ appliedMigrationsForContextNames });
+
+      for (const migrationClassInstance of migrationClassesInstancesToRevert) {
+        const migrationName = ClassHelpers__NS__getName(migrationClassInstance);
+
+        if (!appliedMigrationsForContextNames.includes(migrationName)) {
+          this.ctx.logMigrations &&
+            console.warn(
+              `Skipping migration not marked as applied: ${migrationName}`,
+            );
+          continue;
+        }
+
+        this.ctx.logMigrations &&
+          console.log(
+            `Reverting migration: ${migrationName} , context: ${this.ctx.contextName}`,
+          );
+        await migrationClassInstance.down(queryRunner);
+
+        // Remove the reverted migration from the tracking table
+        await queryRunner.query(
+          `DELETE FROM ${this.DEFAULT_MIGRATION_TABLE_NAME} WHERE name = $1`,
+          [migrationName],
+        );
+      }
+
+      await queryRunner.commitTransaction();
+      this.ctx.logMigrations &&
+        console.log(
+          `Migrations successfully reverted ` +
+            `to the specified timestamp ${timestamp} .`,
+        );
+    } catch (error) {
+      this.ctx.logMigrations &&
+        console.error('Transaction failed, rolling back:', error);
+      await queryRunner.rollbackTransaction();
+    } finally {
+      await queryRunner.release();
+    }
+    //#endregion
+  }
+  //#endregion
+
+  //#region methods & getters / clear migration table
+  async clearMigrationTable() {
+    //#region @websqlFunc
+    if (this.ctx.isRemoteHost || !this.ctx.connection) {
+      return;
+    }
+    const queryRunner = this.ctx.connection.createQueryRunner();
+    await queryRunner.connect();
+    await queryRunner.startTransaction();
+
+    try {
+      await queryRunner.clearTable(this.DEFAULT_MIGRATION_TABLE_NAME);
+      await queryRunner.commitTransaction();
+    } catch (error) {
+      this.ctx.logMigrations &&
+        console.error('Transaction failed, rolling back:', error);
+      await queryRunner.rollbackTransaction();
+    } finally {
+      await queryRunner.release();
+    }
+    //#endregion
+  }
+  //#endregion
+
+  //#region methods & getters / mark all migrations as applied
+  async markAllMigrationsAsApplied() {
+    //#region @websqlFunc
+    if (this.ctx.isRemoteHost || !this.ctx.connection) {
+      return;
+    }
+    const migrationsClassFns: Function[] = this.ctx.getClassFunByArr(
+      Models__NS__ClassType.MIGRATION,
+    );
+
+    const migrationClassesInstances: TaonBaseMigration[] = migrationsClassFns
+      .map(classFn => this.ctx.getInstanceBy(classFn as any))
+      .map(f => f as TaonBaseMigration)
+      .filter(migrationInstance => migrationInstance.isReadyToRun());
+
+    const queryRunner = this.ctx.connection.createQueryRunner();
+    await queryRunner.connect();
+
+    try {
+      await queryRunner.startTransaction();
+
+      // Fetch already applied migrations from the database
+      const allMigrationsInDb = await queryRunner.query(
+        `SELECT name FROM ${this.DEFAULT_MIGRATION_TABLE_NAME}`,
+      );
+
+      const allMigrationInDBNames = allMigrationsInDb.map(m => m.name);
+
+      for (const instance of migrationClassesInstances) {
+        const migrationName = ClassHelpers__NS__getName(instance);
+
+        if (allMigrationInDBNames.includes(migrationName)) {
+          this.ctx.logMigrations &&
+            console.log(`Skipping already applied migration: ${migrationName}`);
+          continue;
+        }
+
+        this.ctx.logMigrations &&
+          console.log(`Marking migration as applied: ${migrationName}`);
+
+        // Insert migration as 'complete' without running
+        await queryRunner.query(
+          `INSERT INTO ${this.DEFAULT_MIGRATION_TABLE_NAME} (name, status, context, applied_at) ` +
+            `VALUES ($1, $2, $3, CURRENT_TIMESTAMP)`,
+          [
+            migrationName,
+            this.MIGRATION_STATUS_COMPLETED,
+            instance.ctx.contextName,
+          ],
+        );
+      }
+
+      // update all pending migrations to completed
+      await queryRunner.query(
+        `UPDATE ${this.DEFAULT_MIGRATION_TABLE_NAME}
+         SET status = $1, applied_at = CURRENT_TIMESTAMP
+         WHERE status = $2`,
+        [this.MIGRATION_STATUS_COMPLETED, this.MIGRATION_STATUS_PENDING],
+      );
+
+      await queryRunner.commitTransaction();
+      this.ctx.logMigrations &&
+        console.log('All migrations marked as applied.');
+    } catch (error) {
+      this.ctx.logMigrations &&
+        console.error(
+          'Failed to mark all migrations as applied, rolling back:',
+          error,
+        );
+      await queryRunner.rollbackTransaction();
+    } finally {
+      await queryRunner.release();
+    }
+    //#endregion
+  }
+  //#endregion
+
+  //#region methods & getters / run all migrations
+  async runAllNotCompletedMigrations() {
+    //#region @websqlFunc
+    if (this.ctx.isRemoteHost || !this.ctx.connection) {
+      return;
+    }
+    const migrationsClassFns: Function[] = this.ctx.getClassFunByArr(
+      Models__NS__ClassType.MIGRATION,
+    );
+
+    // console.log({
+    //   migrationClassesALl: migrationsClassFns.map(f => ClassHelpers__NS__getName(f)),
+    // });
+
+    const migrationClassesInstances: TaonBaseMigration[] = migrationsClassFns
+      .map(classFn => this.ctx.getInstanceBy(classFn as any))
+      .map(f => f as TaonBaseMigration)
+      .filter(migrationInstance => migrationInstance.isReadyToRun());
+
+    // console.log({
+    //   migrationClassesInstances: migrationsClassFns.map(f =>
+    //     ClassHelpers__NS__getName(f),
+    //   ),
+    // });
+
+    const queryRunner = this.ctx.connection.createQueryRunner();
+    await queryRunner.connect();
+
+    try {
+      await queryRunner.startTransaction();
+
+      // Check if the migrations table exists
+      // TODO: Implement check for migrations table existence here
+
+      // Fetch applied migrations from the database
+      const appliedMigrationsForContext = await queryRunner.query(
+        `SELECT name, status FROM ${this.DEFAULT_MIGRATION_TABLE_NAME} ` +
+          `WHERE context = $1`,
+        [this.ctx.contextName],
+      );
+
+      //#region check and update pending migrations
+      const pendingMigrationsForContext = appliedMigrationsForContext.filter(
+        m => m.status === this.MIGRATION_STATUS_PENDING,
+      );
+
+      // Run pending migrations first
+      for (const pendingContextMigration of pendingMigrationsForContext) {
+        const migrationInstance = migrationClassesInstances.find(
+          instance =>
+            ClassHelpers__NS__getName(instance) === pendingContextMigration.name,
+        );
+
+        if (!migrationInstance) {
+          this.ctx.logMigrations &&
+            console.warn(
+              `Pending migration ${pendingContextMigration.name} not found in loaded migrations.`,
+            );
+          continue;
+        }
+
+        this.ctx.logMigrations &&
+          console.log(
+            `Completing pending migration: ${pendingContextMigration.name}`,
+          );
+        await migrationInstance.up(queryRunner);
+
+        // Update migration status to 'complete'
+        await queryRunner.query(
+          `UPDATE ${this.DEFAULT_MIGRATION_TABLE_NAME}
+           SET status = $1, applied_at = CURRENT_TIMESTAMP
+           WHERE name = $2`,
+          [this.MIGRATION_STATUS_COMPLETED, pendingContextMigration.name],
+        );
+      }
+      //#endregion
+
+      //#region run new migrations
+      for (const instance of migrationClassesInstances) {
+        const migrationName = ClassHelpers__NS__getName(instance);
+
+        if (appliedMigrationsForContext.some(m => m.name === migrationName)) {
+          this.ctx.logMigrations &&
+            console.log(`Skipping already applied migration: ${migrationName}`);
+          continue;
+        }
+
+        this.ctx.logMigrations &&
+          console.log(`Applying new migration: ${migrationName}`);
+        // Insert migration as 'pending' before execution
+        await queryRunner.query(
+          `INSERT INTO ${this.DEFAULT_MIGRATION_TABLE_NAME} (name, status, context, applied_at) ` +
+            `VALUES ($1, $2, $3, NULL)`,
+          [migrationName, this.MIGRATION_STATUS_PENDING, this.ctx.contextName],
+        );
+
+        try {
+          // Apply migration
+          await instance.up(queryRunner);
+
+          // Update migration to 'complete' after successful execution
+          await queryRunner.query(
+            `UPDATE ${this.DEFAULT_MIGRATION_TABLE_NAME} ` +
+              `SET status = '${this.MIGRATION_STATUS_COMPLETED}', applied_at = CURRENT_TIMESTAMP ` +
+              `WHERE name = $1`,
+            [migrationName],
+          );
+        } catch (error) {
+          this.ctx.logMigrations &&
+            console.error(`Failed to apply migration: ${migrationName}`, error);
+
+          // Rollback pending migration entry
+          await queryRunner.query(
+            `DELETE FROM ${this.DEFAULT_MIGRATION_TABLE_NAME} WHERE name = $1`,
+            [migrationName],
+          );
+
+          throw error; // Rethrow to ensure the transaction is rolled back
+        }
+      }
+
+      //#endregion
+
+      await queryRunner.commitTransaction();
+    } catch (error) {
+      this.ctx.logMigrations &&
+        console.error('Transaction failed, rolling back:', error);
+      await queryRunner.rollbackTransaction();
+    } finally {
+      await queryRunner.release();
+    }
+    //#endregion
+  }
+  //#endregion
+}