@warlock.js/cascade 5.31.0 → 5.32.0

package/esm/migration/migration-runner.mjs

@@ -11,8 +11,8 @@ import path from "path";
 /** Name of the lock document Mongo migrations claim inside the migrations collection. */
 const MIGRATION_LOCK_NAME = "__warlock_migration_lock__";
 const MIGRATION_LOCK_KEY = "warlock:migrations";
-const MIGRATION_LOCK_TTL_MS = 600 * 1e3;
-const MIGRATION_LOCK_WAIT_MS = 60 * 1e3;
+const MIGRATION_LOCK_TTL_MS = 6e5;
+const MIGRATION_LOCK_WAIT_MS = 6e4;
 const MIGRATION_LOCK_RETRY_MS = 1e3;
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
@@ -119,7 +119,7 @@ var MigrationRunner = class {
 	}
 	/** Distinct data sources across the registered migrations (runner's own included). */
 	getSources() {
-		const sources = new Set([this.getDataSource()]);
+		const sources = /* @__PURE__ */ new Set([this.getDataSource()]);
 		for (const MigrationClass of this.migrations) sources.add(this.sourceOf(MigrationClass));
 		return [...sources];
 	}
@@ -689,17 +689,21 @@ var MigrationRunner = class {
 				};
 				if (shouldUseTransaction && databaseDriver.transaction) await databaseDriver.transaction(async () => {
 					await applyMigration();
-					if (record) if (direction === "up") {
-						const batch = options.batch ?? await this.getNextBatchNumber(dataSource);
-						await this.recordMigration(name, batch, MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : /* @__PURE__ */ new Date(), dataSource);
-					} else await this.removeMigrationRecord(name, dataSource);
+					if (record) {
+						if (direction === "up") {
+							const batch = options.batch ?? await this.getNextBatchNumber(dataSource);
+							await this.recordMigration(name, batch, MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : /* @__PURE__ */ new Date(), dataSource);
+						} else await this.removeMigrationRecord(name, dataSource);
+					}
 				});
 				else {
 					await applyMigration();
-					if (record) if (direction === "up") {
-						const batch = options.batch ?? await this.getNextBatchNumber(dataSource);
-						await this.recordMigration(name, batch, MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : /* @__PURE__ */ new Date(), dataSource);
-					} else await this.removeMigrationRecord(name, dataSource);
+					if (record) {
+						if (direction === "up") {
+							const batch = options.batch ?? await this.getNextBatchNumber(dataSource);
+							await this.recordMigration(name, batch, MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : /* @__PURE__ */ new Date(), dataSource);
+						} else await this.removeMigrationRecord(name, dataSource);
+					}
 				}
 			}
 		} catch (err) {

package/esm/migration/migration-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migration-runner.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/migration-runner.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { MigrationDriverContract } from \"../contracts/migration-driver.contract\";\nimport type { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\nimport {\n  type Migration,\n  type MigrationContract,\n  type MigrationOrigin,\n  type MigrationStep,\n} from \"./migration\";\nimport { sortMigrations, sortMigrationsForRollback } from \"./migration-order\";\nimport { parseCreatedAt } from \"./parse-created-at\";\nimport { SQLGrammar } from \"./sql-grammar\";\nimport type { MigrationRecord, MigrationResult, TaggedSQL } from \"./types\";\n\n/**\n * Migration class type with static name property.\n */\ntype MigrationClass = (new () => Migration) & {\n  migrationName: string;\n  createdAt?: string;\n  origin?: MigrationOrigin;\n};\n\n/**\n * What a caller may hand to {@link MigrationRunner.register}.\n *\n * Looser than {@link MigrationClass} in exactly one way: `migrationName` may be\n * absent. That is the documented workflow — the CLI imports a migration file and\n * sets the name from the filename afterwards — and `register()` enforces it at\n * runtime, throwing a message that says so. Once past that check the name IS\n * present, which is why everything stored and read downstream uses the stricter\n * type. Requiring it on the INPUT made the runner reject the very classes the\n * public `MigrationConstructor` describes.\n *\n * It constructs a MigrationContract rather than the abstract Migration class for the\n * same reason: `typeof Migration` is abstract and cannot satisfy `new () => Migration`,\n * and the public MigrationConstructor is declared against the contract. The runner only\n * ever uses contract members on what it registers.\n */\ntype RegisterableMigration = (new () => MigrationContract) & {\n  migrationName?: string;\n  createdAt?: string;\n  origin?: MigrationOrigin;\n};\n\n/**\n * Resolved instance data for a single pending migration.\n * @internal\n */\ntype MigrationData = {\n  MigrationClass: MigrationClass;\n  migration: Migration;\n  name: string;\n  /** Data source this migration runs against (its own, else the runner's). */\n  dataSource: DataSource;\n  /** Serialized `up()` statements (empty for direct-execution drivers). */\n  statements: string[];\n  /** Same as `statements`, with queued data steps kept in authored order. */\n  steps: MigrationStep[];\n  /** Whether the migration runs inside a transaction. */\n  transactional: boolean;\n  /** Driver has no SQL dialect (MongoDB): executed through `runMigration`. */\n  direct: boolean;\n};\n\n/**\n * Options for migration execution.\n */\ntype ExecuteOptions = {\n  /** Run in dry-run mode (no actual changes) */\n  readonly dryRun?: boolean;\n  /** Record to migrations table (default: true for batch, false for single) */\n  readonly record?: boolean;\n  /**\n   * Rollback only: delete the `_migrations` rows whose migration file is no\n   * longer registered, instead of failing on them.\n   */\n  readonly pruneMissing?: boolean;\n};\n\n/** Name of the lock document Mongo migrations claim inside the migrations collection. */\nconst MIGRATION_LOCK_NAME = \"__warlock_migration_lock__\";\nconst MIGRATION_LOCK_KEY = \"warlock:migrations\";\nconst MIGRATION_LOCK_TTL_MS = 10 * 60 * 1000;\nconst MIGRATION_LOCK_WAIT_MS = 60 * 1000;\nconst MIGRATION_LOCK_RETRY_MS = 1000;\n\n/** Held lock for one data source. `refresh` extends the TTL; `release` frees it. */\ntype MigrationLock = {\n  refresh: () => Promise<void>;\n  release: () => Promise<void>;\n};\n\ntype PgLockClient = {\n  query: (sql: string, params?: unknown[]) => Promise<unknown>;\n  release: () => void;\n};\n\n/** Minimal Mongo surface the lock needs (kept structural: no driver import). */\ntype MongoLockDatabase = {\n  collection: (name: string) => {\n    findOneAndUpdate: (filter: object, update: object, options: object) => Promise<unknown>;\n    findOne: (filter: object) => Promise<{ owner?: string; expiresAt?: unknown } | null>;\n    deleteOne: (filter: object) => Promise<unknown>;\n  };\n};\n\nconst sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\n/**\n * Derive a migration name from a file path: drop everything after the first dot\n * and strip a trailing `-migration` / `_migration` suffix. Shared by every CLI\n * so the same file is recorded under the same name.\n */\nexport function inferMigrationName(file: string): string {\n  const basename = path.basename(file).split(\".\")[0] ?? \"\";\n\n  return basename.replace(/-migration$/, \"\").replace(/_migration$/, \"\");\n}\n\n/**\n * Migration runner that executes migrations.\n *\n * This is a pure executor - it doesn't discover migrations.\n * Discovery is handled by the framework (e.g., @warlock.js/core CLI).\n *\n * The migration name is read from the static `name` property on the class,\n * which should be set by the CLI after importing:\n *\n * @example\n * ```typescript\n * // In CLI after importing:\n * const { default: MigrationClass } = await import(\"./create-users.migration.ts\");\n * MigrationClass.migrationName ??= \"create-users\";\n *\n * // Then register or execute:\n * runner.register(MigrationClass);\n * // or\n * await runner.execute(MigrationClass);\n * ```\n *\n * @example\n * ```typescript\n * // Simple direct execution\n * await runner.execute(CreateUsersTable);\n * await runner.rollback(CreateUsersTable);\n *\n * // Registry pattern for batch operations\n * runner.register(CreateUsersTable);\n * runner.register(AddEmailIndex);\n * await runner.runAll();\n * await runner.rollbackAll();\n * ```\n */\nexport class MigrationRunner {\n  /** Registered migrations */\n  public readonly migrations: MigrationClass[] = [];\n\n  /** Data source to use */\n  private dataSource?: DataSource;\n\n  /** Cached migration drivers, one per data source */\n  private readonly migrationDrivers = new Map<DataSource, MigrationDriverContract>();\n\n  /** Table name for tracking migrations */\n  private readonly migrationsTable: string;\n\n  /** Whether to log operations */\n  private readonly verbose: boolean;\n\n  /**\n   * Create a new migration runner.\n   *\n   * @param options - Runner options\n   */\n  public constructor(\n    options: {\n      dataSource?: DataSource;\n      migrationsTable?: string;\n      verbose?: boolean;\n    } = {},\n  ) {\n    this.dataSource = options.dataSource;\n    this.migrationsTable = options.migrationsTable ?? \"_migrations\";\n    this.verbose = options.verbose ?? true;\n  }\n\n  // ============================================================================\n  // DATA SOURCE\n  // ============================================================================\n\n  /**\n   * Set the data source.\n   */\n  public setDataSource(dataSource: DataSource): this {\n    this.dataSource = dataSource;\n    this.migrationDrivers.clear();\n    return this;\n  }\n\n  /**\n   * Get the data source.\n   */\n  private getDataSource(): DataSource {\n    if (!this.dataSource) {\n      this.dataSource = dataSourceRegistry.get();\n    }\n    return this.dataSource;\n  }\n\n  /**\n   * Get the migration driver.\n   */\n  private getMigrationDriver(\n    dataSource: DataSource = this.getDataSource(),\n  ): MigrationDriverContract {\n    let driver = this.migrationDrivers.get(dataSource);\n    if (!driver) {\n      driver = dataSource.driver.migrationDriver();\n      this.migrationDrivers.set(dataSource, driver);\n    }\n    return driver;\n  }\n\n  /**\n   * Resolve a migration's declared data source (name or instance).\n   * Falls back to the runner's own data source when it declares none.\n   */\n  private resolveDataSource(declared?: string | DataSource): DataSource {\n    if (!declared) return this.getDataSource();\n    if (typeof declared === \"string\") return dataSourceRegistry.get(declared);\n    return declared;\n  }\n\n  /** Data source a registered migration class runs against. */\n  private sourceOf(MigrationClass: MigrationClass): DataSource {\n    return this.resolveDataSource(new MigrationClass().dataSource);\n  }\n\n  /** Distinct data sources across the registered migrations (runner's own included). */\n  private getSources(): DataSource[] {\n    const sources = new Set<DataSource>([this.getDataSource()]);\n    for (const MigrationClass of this.migrations) {\n      sources.add(this.sourceOf(MigrationClass));\n    }\n    return [...sources];\n  }\n\n  /**\n   * Resolve whether a migration runs in a transaction:\n   * 1. migration-level flag (instance, else the static from `Migration.create/alter`)\n   * 2. `CONCURRENTLY` statements cannot run in a transaction block\n   * 3. data-source config\n   * 4. driver default\n   */\n  private resolveTransactional(\n    MigrationClass: MigrationClass,\n    migration: Migration,\n    dataSource: DataSource,\n    statements: string[] = [],\n  ): boolean {\n    const explicit =\n      migration.transactional ?? (MigrationClass as { transactional?: boolean }).transactional;\n\n    if (explicit !== undefined) return explicit;\n\n    if (statements.some((sql) => /\\bCONCURRENTLY\\b/i.test(sql))) return false;\n\n    return (\n      dataSource.migrations?.transactional ??\n      this.getMigrationDriver(dataSource).getDefaultTransactional()\n    );\n  }\n\n  // ============================================================================\n  // LOCKING\n  // ============================================================================\n\n  /** Locks held by the run in progress (Mongo TTL heartbeat). */\n  private activeLocks: MigrationLock[] = [];\n\n  /** Extend every held lock's TTL; called between migrations. */\n  private async refreshLocks(): Promise<void> {\n    for (const lock of this.activeLocks) {\n      await lock.refresh();\n    }\n  }\n\n  /**\n   * Run `callback` while holding a migration lock on every given data source, so\n   * concurrent `migrate` invocations (replicas, init containers) serialize.\n   */\n  private async withLock<T>(sources: DataSource[], callback: () => Promise<T>): Promise<T> {\n    const held: MigrationLock[] = [];\n\n    try {\n      for (const dataSource of sources) {\n        const lock = await this.acquireLock(dataSource);\n        if (lock) held.push(lock);\n      }\n\n      this.activeLocks = held;\n\n      return await callback();\n    } finally {\n      this.activeLocks = [];\n\n      for (const lock of held.reverse()) {\n        try {\n          await lock.release();\n        } catch (error) {\n          log.warn(\n            \"database\",\n            \"migration\",\n            `Failed to release migration lock: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n      }\n    }\n  }\n\n  /** Acquire the lock for one data source; `undefined` when its driver has no lock support. */\n  private async acquireLock(dataSource: DataSource): Promise<MigrationLock | undefined> {\n    const driver = dataSource.driver as unknown as {\n      name: string;\n      getClient?: () => { connect?: () => Promise<PgLockClient> };\n      getDatabase?: () => MongoLockDatabase;\n    };\n\n    if (driver.name === \"postgres\" && driver.getClient) {\n      // A dedicated client: advisory locks are per-session, not per-pool.\n      const client = await driver.getClient().connect?.();\n      if (!client) return undefined;\n\n      try {\n        await client.query(\"SELECT pg_advisory_lock(hashtext($1))\", [MIGRATION_LOCK_KEY]);\n      } catch (error) {\n        client.release();\n        throw error;\n      }\n\n      return {\n        refresh: async () => {},\n        release: async () => {\n          try {\n            await client.query(\"SELECT pg_advisory_unlock(hashtext($1))\", [MIGRATION_LOCK_KEY]);\n          } finally {\n            client.release();\n          }\n        },\n      };\n    }\n\n    if (driver.getDatabase) {\n      // The unique index on `name` (created here) makes the claim below atomic.\n      await this.getMigrationDriver(dataSource).ensureMigrationsTable(this.migrationsTable);\n\n      const collection = driver.getDatabase().collection(this.migrationsTable);\n      const owner = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n      const deadline = Date.now() + MIGRATION_LOCK_WAIT_MS;\n\n      const claim = async (): Promise<boolean> => {\n        const now = new Date();\n\n        try {\n          await collection.findOneAndUpdate(\n            {\n              name: MIGRATION_LOCK_NAME,\n              $or: [{ expiresAt: { $lt: now } }, { owner }],\n            },\n            {\n              $set: { owner, expiresAt: new Date(now.getTime() + MIGRATION_LOCK_TTL_MS) },\n              $setOnInsert: { batch: 0 },\n            },\n            { upsert: true },\n          );\n\n          return true;\n        } catch (error) {\n          // Held by someone else: the upsert collides with the unique `name` index.\n          if ((error as { code?: number }).code === 11000) return false;\n          throw error;\n        }\n      };\n\n      while (!(await claim())) {\n        if (Date.now() >= deadline) {\n          const holder = await collection.findOne({ name: MIGRATION_LOCK_NAME });\n          throw new Error(\n            `Could not acquire the migration lock within ${MIGRATION_LOCK_WAIT_MS / 1000}s; ` +\n              `held by \"${holder?.owner ?? \"unknown\"}\" until ${holder?.expiresAt ?? \"unknown\"}.`,\n          );\n        }\n\n        await sleep(MIGRATION_LOCK_RETRY_MS);\n      }\n\n      return {\n        refresh: async () => {\n          await claim();\n        },\n        release: async () => {\n          await collection.deleteOne({ name: MIGRATION_LOCK_NAME, owner });\n        },\n      };\n    }\n\n    return undefined;\n  }\n\n  // ============================================================================\n  // REGISTRATION\n  // ============================================================================\n\n  /**\n   * Register a migration.\n   *\n   * The migration name is read from `MigrationClass.migrationName`.\n   *\n   * @param MigrationClass - Migration class (must have static `name` set)\n   * @param origin - Registration source; defaults to `\"app\"` for direct registrations.\n   * @returns This runner for chaining\n   *\n   * @example\n   * ```typescript\n   * CreateUsersTable.migrationName = \"2024-01-15_create-users\";\n   * runner.register(CreateUsersTable);\n   * ```\n   */\n  public register(MigrationClass: RegisterableMigration, origin: MigrationOrigin = \"app\"): this {\n    const name = MigrationClass.migrationName;\n    if (!name) {\n      throw new Error(\n        `Migration class must have a static 'migrationName' property set. ` +\n          `Set it in CLI after importing: MigrationClass.migrationName = \"filename\";`,\n      );\n    }\n    const existing = this.migrations.find((m) => m.migrationName === name);\n\n    if (existing) {\n      // Re-registering the same class is idempotent; a DIFFERENT class under the\n      // same name would silently never run, so fail loudly.\n      if ((existing as unknown) !== MigrationClass) {\n        throw new Error(\n          `Duplicate migration name \"${name}\": two different migration classes resolve to the same name. ` +\n            `Rename one of the files (or set a unique static 'migrationName').`,\n        );\n      }\n\n      return this;\n    }\n\n    // `name` is proven present by the throw above, so this satisfies the stricter\n    // stored type that every reader downstream relies on.\n    MigrationClass.origin = origin;\n    this.migrations.push(MigrationClass as MigrationClass);\n\n    return this;\n  }\n\n  /**\n   * Register multiple migrations.\n   *\n   * @param migrations - Array of migration classes\n   * @returns This runner for chaining\n   */\n  public registerMany(migrations: RegisterableMigration[]): this {\n    for (const MigrationClass of migrations) {\n      this.register(MigrationClass);\n    }\n    return this;\n  }\n\n  /**\n   * Clear all registered migrations.\n   */\n  public clear(): this {\n    this.migrations.length = 0;\n    return this;\n  }\n\n  /**\n   * Get all registered migration names.\n   */\n  public getRegisteredNames(): string[] {\n    return this.migrations.map((m) => m.migrationName);\n  }\n\n  // ============================================================================\n  // SINGLE EXECUTION\n  // ============================================================================\n\n  /**\n   * Execute a single migration's up() method.\n   *\n   * @param MigrationClass - Migration class to execute\n   * @param options - Execution options\n   * @returns Migration result\n   *\n   * @example\n   * ```typescript\n   * await runner.execute(CreateUsersTable);\n   * await runner.execute(AddEmailIndex, { dryRun: true });\n   * ```\n   */\n  public async run(\n    MigrationClass: MigrationClass,\n    options: ExecuteOptions = {},\n  ): Promise<MigrationResult> {\n    return this.runMigration(MigrationClass, \"up\", {\n      dryRun: options.dryRun,\n      record: options.record ?? false,\n    });\n  }\n\n  /**\n   * Execute a single migration's down() method.\n   *\n   * @param MigrationClass - Migration class to rollback\n   * @param options - Execution options\n   * @returns Migration result\n   *\n   * @example\n   * ```typescript\n   * await runner.rollback(CreateUsersTable);\n   * ```\n   */\n  public async rollback(\n    MigrationClass: MigrationClass,\n    options: ExecuteOptions = {},\n  ): Promise<MigrationResult> {\n    return this.runMigration(MigrationClass, \"down\", {\n      dryRun: options.dryRun,\n      record: options.record ?? false,\n    });\n  }\n\n  // ============================================================================\n  // BATCH EXECUTION (REGISTERED MIGRATIONS)\n  // ============================================================================\n\n  /**\n   * Run all pending registered migrations.\n   *\n   * Only runs migrations not already in the migrations table.\n   *\n   * @param options - Execution options\n   * @returns Results for each migration\n   *\n   * @example\n   * ```typescript\n   * runner.register(CreateUsersTable);\n   * runner.register(AddEmailIndex);\n   * const results = await runner.runAll();\n   * ```\n   */\n  public async runAll(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    // A dry run writes nothing, so it needs no lock.\n    if (options.dryRun) return this.runAllUnlocked(options);\n\n    // The pending set is computed INSIDE the lock, so a replica that waited sees\n    // what the winner already applied.\n    return this.withLock(this.getSources(), () => this.runAllUnlocked(options));\n  }\n\n  private async runAllUnlocked(options: ExecuteOptions): Promise<MigrationResult[]> {\n    const { dryRun = false, record = true } = options;\n\n    const results: MigrationResult[] = [];\n\n    // Get pending migrations (a dry run must not create the migrations table)\n    const pending = await this.getPendingMigrations({ readOnly: dryRun });\n\n    if (pending.length === 0) {\n      log.warn(\"database\", \"migration\", \"Nothing to migrate.\");\n      return results;\n    }\n\n    // Next batch number per data source: each source has its own migrations table.\n    const sources = new Set<DataSource>();\n    const migrationsData: MigrationData[] = [];\n\n    log.info(\"database\", \"migration\", `Found ${pending.length} pending migration(s).`);\n\n    // 1. Resolve each migration's data source and transactional mode, and collect\n    //    its SQL. Drivers without SQL serialization (MongoDB) are executed\n    //    directly through the migration driver instead.\n    //    Extension checks fire concurrently as CREATE EXTENSION statements are met.\n    const extensionChecks: Promise<void>[] = [];\n\n    for (const MigrationClass of pending) {\n      const migration = this.createMigrationInstance(MigrationClass);\n      const name = MigrationClass.migrationName;\n      const dataSource = this.resolveDataSource(migration.dataSource);\n      sources.add(dataSource);\n\n      if (dataSource.driver.supportsSqlSerialization === false) {\n        migrationsData.push({\n          MigrationClass,\n          migration,\n          name,\n          dataSource,\n          statements: [],\n          steps: [],\n          transactional: false,\n          direct: true,\n        });\n        continue;\n      }\n\n      migration.setDriver(this.getMigrationDriver(dataSource));\n      migration.setMigrationDefaults(dataSource.migrationDefaults);\n      // Collection must not run `withConnection` side effects during a dry run.\n      migration.setDryRun?.(dryRun);\n\n      await migration.up();\n      const steps: MigrationStep[] = migration.toSteps?.() ?? migration.toSQL();\n      const statements = steps.map((step) =>\n        typeof step === \"string\" ? step : \"-- data step (withConnection) skipped\",\n      );\n      migration.setDryRun?.(false);\n\n      migrationsData.push({\n        MigrationClass,\n        migration,\n        name,\n        dataSource,\n        statements,\n        steps,\n        transactional:\n          !!dataSource.driver.transaction &&\n          this.resolveTransactional(MigrationClass, migration, dataSource, statements),\n        direct: false,\n      });\n\n      for (const sql of statements) {\n        if (SQLGrammar.classify(sql) === \"CREATE_EXTENSION\") {\n          const ext = SQLGrammar.extractExtensionName(sql);\n          if (ext) extensionChecks.push(this.informIfExtensionMissing(ext, dataSource));\n        }\n      }\n    }\n\n    // 2. Resolve all extension checks before any SQL is executed.\n    await Promise.all(extensionChecks);\n\n    // 3. Dry run: print statements in migration order (authored order kept; no\n    //    global phase sort, which would reorder add-column → backfill → NOT NULL).\n    if (dryRun) {\n      log.info(\"database\", \"migration\", \"Dry run enabled. Would execute the following statements:\");\n      for (const data of migrationsData) {\n        for (const sql of data.statements) {\n          console.log(\n            `-- [${SQLGrammar.classify(sql)}] Phase ${SQLGrammar.phase(sql)} [${data.name}]`,\n          );\n          console.log(sql + \";\\n\");\n        }\n      }\n      return [];\n    }\n\n    const batches = new Map<DataSource, number>();\n    for (const dataSource of sources) {\n      batches.set(dataSource, await this.getNextBatchNumber(dataSource));\n    }\n\n    // 4. Split into runs: consecutive transactional migrations on the same data\n    //    source share one transaction; every other migration (non-transactional\n    //    or direct) runs alone.\n    const runs: MigrationData[][] = [];\n    for (const data of migrationsData) {\n      const last = runs[runs.length - 1];\n      const lastFirst = last?.[0];\n      if (\n        data.transactional &&\n        last &&\n        lastFirst?.transactional &&\n        lastFirst.dataSource === data.dataSource\n      ) {\n        last.push(data);\n      } else {\n        runs.push([data]);\n      }\n    }\n\n    for (const run of runs) {\n      const first = run[0];\n      if (!first) continue;\n      await this.refreshLocks();\n      const dataSource = first.dataSource;\n      const nextBatch = batches.get(dataSource)!;\n      const startTime = Date.now();\n\n      if (first.direct) {\n        const result = await this.runMigration(first.MigrationClass, \"up\", {\n          dryRun,\n          record,\n          batch: nextBatch,\n        });\n        results.push(result);\n        if (!result.success) break;\n        continue;\n      }\n\n      const driver = dataSource.driver;\n      let failed = false;\n      let errorMessage = \"\";\n      /** The migration that owns the SQL statement that threw. */\n      let failingMigrationName: string | undefined;\n\n      const executeRun = async (): Promise<void> => {\n        for (const data of run) {\n          for (const step of data.steps) {\n            try {\n              if (typeof step === \"string\") await driver.query(step);\n              else await step.data();\n            } catch (err) {\n              failingMigrationName = data.name;\n              throw err;\n            }\n          }\n\n          // A non-transactional migration is recorded right after it applied.\n          // Transactional ones are recorded inside the shared transaction.\n          if (record) {\n            await this.recordMigration(\n              data.name,\n              nextBatch,\n              data.MigrationClass.createdAt\n                ? parseCreatedAt(data.MigrationClass.createdAt)\n                : new Date(),\n              dataSource,\n            );\n          }\n        }\n      };\n\n      try {\n        if (first.transactional && driver.transaction) {\n          await driver.transaction(executeRun);\n        } else {\n          await executeRun();\n        }\n      } catch (err) {\n        failed = true;\n        errorMessage = err instanceof Error ? err.message : String(err);\n      }\n\n      const durationMs = Date.now() - startTime;\n\n      // Only the migration that owns the failing statement is marked failed;\n      // the rest of its run is reported as rolled back.\n      for (const data of run) {\n        const isCulprit = failed && data.name === failingMigrationName;\n        const wasSkipped = failed && !isCulprit;\n\n        results.push({\n          name: data.name,\n          table: data.migration.table,\n          direction: \"up\",\n          success: !failed,\n          error: isCulprit ? errorMessage : undefined,\n          durationMs: Math.round(durationMs / run.length),\n          executedAt: new Date(),\n        });\n\n        if (isCulprit) {\n          log.error(\n            \"database\",\n            \"migration\",\n            `${colors.magenta(data.name)}: ✗ Failed: ${errorMessage}`,\n          );\n        } else if (wasSkipped) {\n          log.warn(\n            \"database\",\n            \"migration\",\n            `${colors.magenta(data.name)}: rolled back (batch transaction failed)`,\n          );\n        } else {\n          log.success(\n            \"database\",\n            \"migration\",\n            `Migrated: ${colors.magenta(data.name)} successfully`,\n          );\n        }\n      }\n\n      if (failed) {\n        log.error(\n          \"database\",\n          \"migration\",\n          `Batch execution failed. Rollback performed if transactional.`,\n        );\n        throw new Error(\"Migration batch failed: \" + errorMessage);\n      }\n    }\n\n    const successCount = results.filter((r) => r.success).length;\n    log.success(\n      \"database\",\n      \"migration\",\n      `Migration execution complete: ${successCount}/${pending.length} migrations processed successfully.`,\n    );\n\n    return results;\n  }\n\n  /**\n   * Export migrations as phase-ordered SQL files in database/sql/ directory.\n   * By default, it exports all registered migrations. Use `pendingOnly: true` to export only pending ones.\n   */\n  public async exportSQL(\n    options: { pendingOnly?: boolean; compact?: boolean } = {},\n  ): Promise<void> {\n    if (this.getDataSource().driver.supportsSqlSerialization === false) {\n      throw new Error(\n        \"SQL export is not supported on this data source — its driver has no SQL dialect. \" +\n          \"Migrations on this driver execute native commands through the migration driver instead.\",\n      );\n    }\n\n    const migrationsToExport = options.pendingOnly\n      ? await this.getPendingMigrations({ readOnly: true })\n      : this.migrations;\n\n    if (migrationsToExport.length === 0) {\n      log.warn(\"database\", \"migration\", \"No migrations to export.\");\n      return;\n    }\n\n    log.info(\n      \"database\",\n      \"migration\",\n      `Exporting ${migrationsToExport.length} ${options.pendingOnly ? \"pending \" : \"\"}migration(s) to SQL files...`,\n    );\n\n    const upStatements: TaggedSQL[] = [];\n    // Down SQL is grouped per migration so only the migration order is reversed,\n    // never the statements inside one migration's down().\n    const downGroups: { createdAt?: string; index: number; statements: TaggedSQL[] }[] = [];\n\n    for (const [index, MigrationClass] of migrationsToExport.entries()) {\n      const migration = this.createMigrationInstance(MigrationClass);\n      const name = MigrationClass.migrationName;\n\n      // Export performs no writes: `withConnection` callbacks are skipped.\n      migration.setDryRun?.(true);\n\n      // Collect up SQL\n      await migration.up();\n      for (const sql of migration.toSQL()) {\n        upStatements.push({\n          sql,\n          phase: SQLGrammar.phase(sql),\n          statementType: SQLGrammar.classify(sql),\n          createdAt: MigrationClass.createdAt,\n          migrationName: name,\n        });\n      }\n\n      // Collect down SQL (reuse same instance — toSQL() cleared pendingOps)\n      await migration.down();\n      const statements: TaggedSQL[] = [];\n      for (const sql of migration.toSQL()) {\n        statements.push({\n          sql,\n          phase: SQLGrammar.phase(sql),\n          statementType: SQLGrammar.classify(sql),\n          createdAt: MigrationClass.createdAt,\n          migrationName: name,\n        });\n      }\n      downGroups.push({ createdAt: MigrationClass.createdAt, index, statements });\n    }\n\n    const sortedUp = SQLGrammar.sort(upStatements);\n    // Down SQL: newest migration first (chronological, registration order breaks\n    // ties), each migration's own down() statements keep their order.\n    const sortedDown = downGroups\n      .sort((a, b) => {\n        const byDate = (a.createdAt ?? \"\").localeCompare(b.createdAt ?? \"\");\n        return byDate !== 0 ? byDate : a.index - b.index;\n      })\n      .reverse()\n      .flatMap((group) => group.statements);\n\n    const upSQLString = this.formatSQLForExport(sortedUp, options.compact);\n    const downSQLString = this.formatSQLForExport(sortedDown, options.compact);\n\n    const rootPath = process.cwd();\n    const sqlDir = path.join(rootPath, \"database\", \"sql\");\n\n    if (!fs.existsSync(sqlDir)) {\n      fs.mkdirSync(sqlDir, { recursive: true });\n    }\n\n    const timestamp = new Date().toISOString().replace(/T/, \"_\").replace(/:/g, \"-\").split(\".\")[0];\n    const upPath = path.join(sqlDir, `migration_${timestamp}.up.sql`);\n    const downPath = path.join(sqlDir, `migration_${timestamp}.down.sql`);\n\n    fs.writeFileSync(upPath, upSQLString);\n    fs.writeFileSync(downPath, downSQLString);\n\n    log.success(\"database\", \"migration\", `Exported to:\\n- ${upPath}\\n- ${downPath}`);\n  }\n\n  /**\n   * Rollback the last batch of migrations.\n   *\n   * @param options - Execution options\n   * @returns Results for each migration\n   */\n  public async rollbackLast(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    return this.rollbackBatches(1, options);\n  }\n\n  /**\n   * Rollback N batches of migrations.\n   *\n   * @param batches - Number of batches to rollback\n   * @param options - Execution options\n   * @returns Results for each migration\n   */\n  public async rollbackBatches(\n    batches: number,\n    options: ExecuteOptions = {},\n  ): Promise<MigrationResult[]> {\n    if (options.dryRun) return this.rollbackBatchesUnlocked(batches, options);\n\n    return this.withLock(this.getSources(), () => this.rollbackBatchesUnlocked(batches, options));\n  }\n\n  private async rollbackBatchesUnlocked(\n    batches: number,\n    options: ExecuteOptions,\n  ): Promise<MigrationResult[]> {\n    const dryRun = options.dryRun ?? false;\n    const record = options.record ?? true;\n    const results: MigrationResult[] = [];\n\n    const toRollback = await this.getMigrationsToRollback(batches, {\n      pruneMissing: options.pruneMissing,\n      readOnly: dryRun,\n    });\n\n    if (toRollback.length === 0) {\n      log.warn(\"database\", \"migration\", \"Nothing to rollback.\");\n      return results;\n    }\n\n    log.info(\"database\", \"migration\", `Rolling back ${toRollback.length} migration(s).`);\n\n    for (const MigrationClass of toRollback) {\n      await this.refreshLocks();\n\n      const result = await this.runMigration(MigrationClass, \"down\", {\n        dryRun,\n        record,\n      });\n      results.push(result);\n\n      if (!result.success) {\n        break;\n      }\n    }\n\n    const successCount = results.filter((r) => r.success).length;\n    log.success(\n      \"database\",\n      \"migration\",\n      `Rollback complete: ${successCount}/${toRollback.length} successful.`,\n    );\n\n    return results;\n  }\n\n  /**\n   * Rollback all executed migrations.\n   *\n   * @param options - Execution options\n   * @returns Results for each migration\n   */\n  public async rollbackAll(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    // Batch numbers are per data source; rolling back \"all\" is every batch of each.\n    return this.rollbackBatches(Number.POSITIVE_INFINITY, options);\n  }\n\n  /**\n   * Reset and re-run: rollback all then run all.\n   *\n   * @param options - Execution options\n   * @returns Combined results\n   */\n  public async fresh(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    const rollbackResults = await this.rollbackAll(options);\n    const runResults = await this.runAll(options);\n    return [...rollbackResults, ...runResults];\n  }\n\n  // ============================================================================\n  // STATUS\n  // ============================================================================\n\n  /**\n   * Get status of all registered migrations.\n   */\n  public async status(): Promise<\n    Array<{\n      name: string;\n      table: string;\n      executed: boolean;\n      batch: number | null;\n    }>\n  > {\n    const executedBySource = new Map<DataSource, Map<string, MigrationRecord>>();\n\n    for (const dataSource of this.getSources()) {\n      const executed = await this.getExecutedMigrations(dataSource, { readOnly: true });\n      executedBySource.set(dataSource, new Map(executed.map((r) => [r.name, r])));\n    }\n\n    return this.migrations.map((MigrationClass) => {\n      const instance = new MigrationClass();\n      const name = MigrationClass.migrationName;\n      const record = executedBySource.get(this.sourceOf(MigrationClass))?.get(name);\n      return {\n        name,\n        table: instance.table,\n        executed: !!record,\n        batch: record?.batch ?? null,\n      };\n    });\n  }\n\n  // ============================================================================\n  // EXTENSION PRE-FLIGHT\n  // ============================================================================\n\n  /**\n   * Check whether a database extension is available and inform the developer\n   * if it is not installed.\n   *\n   * Does NOT throw — execution proceeds normally. If the extension is truly\n   * missing, the database will surface its own error with full context already\n   * displayed to the developer.\n   *\n   * @example\n   * await this.informIfExtensionMissing(\"vector\");\n   */\n  private async informIfExtensionMissing(\n    extension: string,\n    dataSource: DataSource = this.getDataSource(),\n  ): Promise<void> {\n    try {\n      const migrationDriver = this.getMigrationDriver(dataSource);\n      const isAvailable = await migrationDriver.isExtensionAvailable(extension);\n\n      if (!isAvailable) {\n        const hr = \"─\".repeat(60);\n        console.log(`\\n${colors.yellow(hr)}`);\n        console.log(colors.yellow(`  ⚠  Missing Database Extension: ${colors.bold(extension)}`));\n        console.log(colors.yellow(hr));\n        console.log();\n        console.log(`  A pending migration requires the ${colors.cyan(extension)} extension,`);\n        console.log(`  which is not installed on your database server.`);\n        console.log();\n        console.log(\n          `  ${colors.bold(\"This means the physical database server is missing the extension package.\")}`,\n        );\n        console.log(`  You cannot simply run CREATE EXTENSION until the package is installed`);\n        console.log(`  on the host machine or Docker container.`);\n        console.log();\n\n        const docsUrl = migrationDriver.getExtensionDocsUrl(extension);\n        if (docsUrl) {\n          console.log(`  ${colors.bold(\"Or follow the installation guide:\")}`);\n          console.log(`    ${colors.cyan(docsUrl)}`);\n        }\n        console.log(`\\n${colors.yellow(hr)}\\n`);\n      }\n    } catch {\n      // If the check itself fails, silently skip — don't break the migration.\n    }\n  }\n\n  // ============================================================================\n  // PRIVATE HELPERS\n  // ============================================================================\n\n  /**\n   * Run a single migration.\n   */\n  private async runMigration(\n    MigrationClass: MigrationClass,\n    direction: \"up\" | \"down\",\n    options: {\n      dryRun?: boolean;\n      record?: boolean;\n      batch?: number;\n    } = {},\n  ): Promise<MigrationResult> {\n    const { dryRun = false, record = true } = options;\n    const startTime = Date.now();\n    let success = true;\n    let error: string | undefined;\n\n    const migration = new MigrationClass();\n    const name = MigrationClass.migrationName;\n\n    log.info(\n      \"database\",\n      \"migration\",\n      `${direction === \"up\" ? \"Migrating\" : \"Rolling back\"}: ${colors.magenta(name)}...`,\n    );\n\n    try {\n      if (!dryRun) {\n        // The migration runs against its declared data source (default: the runner's)\n        // and is recorded in THAT source's migrations table.\n        const dataSource = this.resolveDataSource(migration.dataSource);\n        const driver = this.getMigrationDriver(dataSource);\n        migration.setDriver(driver);\n        migration.setMigrationDefaults(dataSource.migrationDefaults);\n\n        // ============================================================================\n        // TRANSACTION RESOLUTION (3-tier hierarchy)\n        // ============================================================================\n        // 1. Migration-level explicit override (instance or static)\n        // 2. CONCURRENTLY statements (cannot run in a transaction block)\n        // 3. Config-level global override\n        // 4. Driver default (PostgreSQL: true, MongoDB: false)\n        // Resolved below, once the statements are known.\n\n        // ============================================================================\n        // EXECUTE WITH OR WITHOUT TRANSACTION\n        // ============================================================================\n\n        // Collect the requested direction's operations\n        if (direction === \"up\") {\n          await migration.up();\n        } else {\n          await migration.down();\n        }\n\n        const databaseDriver = dataSource.driver;\n\n        // SQL-capable drivers serialize the queued operations to SQL strings;\n        // drivers without SQL serialization (MongoDB) keep them queued and\n        // execute them directly through the migration driver.\n        const directExecution = databaseDriver.supportsSqlSerialization === false;\n        const steps: MigrationStep[] = directExecution\n          ? []\n          : (migration.toSteps?.() ?? migration.toSQL());\n        const sqlStatements = steps.filter((step): step is string => typeof step === \"string\");\n        const shouldUseTransaction = this.resolveTransactional(\n          MigrationClass,\n          migration,\n          dataSource,\n          sqlStatements,\n        );\n\n        const applyMigration = async (): Promise<void> => {\n          if (directExecution) {\n            await migration.execute();\n            return;\n          }\n\n          // Execute generated SQL statements sequentially (no phase-sorting here since it's single execution)\n          for (const step of steps) {\n            if (typeof step === \"string\") await databaseDriver.query(step);\n            else await step.data();\n          }\n        };\n\n        if (shouldUseTransaction && databaseDriver.transaction) {\n          // Transactional execution\n          await databaseDriver.transaction(async () => {\n            await applyMigration();\n\n            // Record migration tracking\n            if (record) {\n              if (direction === \"up\") {\n                const batch = options.batch ?? (await this.getNextBatchNumber(dataSource));\n                await this.recordMigration(\n                  name,\n                  batch,\n                  MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : new Date(),\n                  dataSource,\n                );\n              } else {\n                await this.removeMigrationRecord(name, dataSource);\n              }\n            }\n          });\n        } else {\n          // Non-transactional execution\n          await applyMigration();\n\n          if (record) {\n            if (direction === \"up\") {\n              const batch = options.batch ?? (await this.getNextBatchNumber(dataSource));\n              await this.recordMigration(\n                name,\n                batch,\n                MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : new Date(),\n                dataSource,\n              );\n            } else {\n              await this.removeMigrationRecord(name, dataSource);\n            }\n          }\n        }\n      }\n    } catch (err) {\n      success = false;\n      error = err instanceof Error ? err.message : String(err);\n      log.error(\"database\", \"migration\", `${colors.magenta(name)}: ✗ Failed: ${error}`);\n      throw err;\n    }\n\n    const durationMs = Date.now() - startTime;\n\n    if (success) {\n      log.success(\n        \"database\",\n        \"migration\",\n        `${direction == \"up\" ? \"Migrated\" : \"Rolled back\"}: ${colors.magenta(name)} successfully (${durationMs}ms)`,\n      );\n    }\n\n    return {\n      name,\n      table: migration.table,\n      direction,\n      success,\n      error,\n      durationMs,\n      executedAt: new Date(),\n    };\n  }\n\n  /**\n   * Create, configure, and return a ready-to-use migration instance.\n   *\n   * Centralises the repeated \"new + setDriver + setMigrationDefaults\" boilerplate\n   * that all batch/single execution paths need.\n   *\n   * @internal\n   */\n  private createMigrationInstance(MigrationClass: MigrationClass): Migration {\n    const migration = new MigrationClass();\n    const dataSource = this.resolveDataSource(migration.dataSource);\n    migration.setDriver(this.getMigrationDriver(dataSource));\n    migration.setMigrationDefaults(dataSource.migrationDefaults);\n    return migration;\n  }\n\n  /**\n   * Format an ordered array of TaggedSQL into a human-readable SQL file string.\n   *\n   * Consecutive statements that belong to the same (phase, migration) group share\n   * a single block comment at the top, avoiding the noisy per-statement repetition.\n   *\n   * Example output:\n   * ```sql\n   * /* Phase 3 [create-users] *\\/\n   * ALTER TABLE \"users\" ADD COLUMN \"name\" TEXT NOT NULL;\n   * ALTER TABLE \"users\" ADD COLUMN \"email\" TEXT NOT NULL;\n   *\n   * /* Phase 4 [create-users] *\\/\n   * CREATE UNIQUE INDEX ...;\n   * ```\n   *\n   * @internal\n   */\n  private formatSQLForExport(statements: TaggedSQL[], compact: boolean = false): string {\n    const lines: string[] = [];\n\n    if (compact) {\n      // Just output raw statements, no grouping, no blank lines\n      for (const stmt of statements) {\n        lines.push(`${stmt.sql};`);\n      }\n      return lines.join(\"\\n\");\n    }\n\n    // Group statements by their phase and migration name\n    const grouped = new Map<string, string[]>();\n\n    for (const stmt of statements) {\n      const groupKey = `Phase ${stmt.phase} [${stmt.migrationName}]`;\n      if (!grouped.has(groupKey)) {\n        grouped.set(groupKey, []);\n      }\n      grouped.get(groupKey)!.push(stmt.sql);\n    }\n\n    // Format each group\n    for (const [groupKey, sqls] of grouped.entries()) {\n      if (lines.length > 0) lines.push(\"\"); // blank line between groups\n      lines.push(`/* ${groupKey} */`);\n      for (const sql of sqls) {\n        lines.push(`${sql};`);\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Get pending (not executed) registered migrations, in the order they would\n   * execute.\n   *\n   * ⚠️ \"Registered\" is load-bearing. This filters `this.migrations`, which is\n   * populated only by `register()` / `registerMany()`. A caller that has not\n   * registered anything gets `[]` — indistinguishable from a database with\n   * nothing pending. Anything reporting this set to a human MUST register\n   * migrations first, or it will print a confident all-clear over an unknown.\n   *\n   * @see listPendingMigrations\n   */\n  public async getPendingMigrations(\n    options: { readOnly?: boolean } = {},\n  ): Promise<MigrationClass[]> {\n    // \"Executed\" is judged in each migration's own data source's migrations table.\n    const executedNames = new Map<DataSource, Set<string>>();\n    for (const dataSource of this.getSources()) {\n      const executed = await this.getExecutedMigrations(dataSource, options);\n      executedNames.set(dataSource, new Set(executed.map((r) => r.name)));\n    }\n\n    const migrations = this.migrations.filter(\n      (m) => !executedNames.get(this.sourceOf(m))?.has(m.migrationName),\n    );\n\n    return migrations.sort(sortMigrations);\n  }\n\n  /**\n   * Get migrations to rollback, newest-first.\n   *\n   * A rollback must undo migrations in the exact inverse of the order `up`\n   * applied them, or a `down()` will hit schema its predecessor already\n   * removed — dropping a table before dropping the column added to it, say.\n   *\n   * The sort has to be explicitly **descending**. Reversing the executed list\n   * is not enough: `getExecutedMigrations` orders by `batch, name`, so the\n   * input is alphabetical rather than chronological, and reversing it only\n   * yields reverse-alphabetical order. (Sorting *ascending* here — which is\n   * what this method used to do after a `.reverse()` — silently restored the\n   * forward `up` order and made the reverse dead code.)\n   */\n  private async getMigrationsToRollback(\n    batches: number,\n    options: { pruneMissing?: boolean; readOnly?: boolean } = {},\n  ): Promise<MigrationClass[]> {\n    const migrations: MigrationClass[] = [];\n    const batchOf = new Map<MigrationClass, number>();\n    const orphans: Array<{ name: string; dataSource: DataSource }> = [];\n\n    // Batches are numbered per data source (each has its own migrations table).\n    for (const dataSource of this.getSources()) {\n      const executed = await this.getExecutedMigrations(dataSource, {\n        readOnly: options.readOnly,\n      });\n      if (executed.length === 0) continue;\n\n      const batchNumbers = [...new Set(executed.map((r) => r.batch))]\n        .sort((a, b) => b - a)\n        .slice(0, batches);\n\n      for (const record of executed) {\n        if (!batchNumbers.includes(record.batch)) continue;\n\n        const MigrationClass = this.migrations.find(\n          (m) => m.migrationName === record.name && this.sourceOf(m) === dataSource,\n        );\n        if (MigrationClass) {\n          migrations.push(MigrationClass);\n          batchOf.set(MigrationClass, record.batch);\n        } else {\n          orphans.push({ name: record.name, dataSource });\n        }\n      }\n    }\n\n    if (orphans.length > 0) {\n      if (!options.pruneMissing) {\n        throw new Error(\n          `Cannot roll back: ${orphans.length} executed migration(s) have no registered file: ` +\n            `${orphans.map((o) => o.name).join(\", \")}. ` +\n            `They were renamed, deleted, or not matched by the migration pattern. ` +\n            `Restore the file(s), or pass pruneMissing (--prune-missing) to delete those records.`,\n        );\n      }\n\n      if (!options.readOnly) {\n        for (const orphan of orphans) {\n          await this.removeMigrationRecord(orphan.name, orphan.dataSource);\n          log.warn(\"database\", \"migration\", `Pruned orphaned migration record: ${orphan.name}`);\n        }\n      }\n    }\n\n    // Newest batch first, then newest migration first within a batch.\n    return migrations.sort(\n      (a, b) => (batchOf.get(b) ?? 0) - (batchOf.get(a) ?? 0) || sortMigrationsForRollback(a, b),\n    );\n  }\n\n  /**\n   * Get executed migration records.\n   */\n  public async getExecutedMigrations(\n    dataSource: DataSource = this.getDataSource(),\n    options: { readOnly?: boolean } = {},\n  ): Promise<MigrationRecord[]> {\n    const driver = dataSource.driver;\n    const migrationDriver = this.getMigrationDriver(dataSource);\n\n    if (options.readOnly) {\n      // Dry runs and listings must not create the migrations table.\n      if (!(await migrationDriver.tableExists(this.migrationsTable))) return [];\n    } else {\n      // A missing table is created here; every other error (connection,\n      // permission…) propagates instead of looking like \"nothing executed\".\n      await migrationDriver.ensureMigrationsTable(this.migrationsTable);\n    }\n\n    const queryBuilder = driver.queryBuilder<MigrationRecord>(this.migrationsTable);\n    const records = await queryBuilder.orderBy(\"batch\", \"asc\").orderBy(\"name\", \"asc\").get();\n\n    // The Mongo lock document lives in this collection; it is not a migration.\n    return records.filter((record) => record.name !== MIGRATION_LOCK_NAME);\n  }\n\n  /**\n   * Record a migration.\n   */\n  private async recordMigration(\n    name: string,\n    batch: number,\n    createdAt?: Date,\n    dataSource: DataSource = this.getDataSource(),\n  ): Promise<void> {\n    const driver = dataSource.driver;\n    const migrationDriver = this.getMigrationDriver(dataSource);\n\n    // Ensure migrations table exists\n    await migrationDriver.ensureMigrationsTable(this.migrationsTable);\n\n    await driver.insert(this.migrationsTable, {\n      name,\n      batch,\n      executedAt: new Date(),\n      createdAt,\n    });\n  }\n\n  /**\n   * Remove a migration record.\n   */\n  private async removeMigrationRecord(\n    name: string,\n    dataSource: DataSource = this.getDataSource(),\n  ): Promise<void> {\n    const driver = dataSource.driver;\n    await driver.delete(this.migrationsTable, { name });\n  }\n\n  /**\n   * Get next batch number.\n   */\n  private async getNextBatchNumber(\n    dataSource: DataSource = this.getDataSource(),\n    readOnly = false,\n  ): Promise<number> {\n    const executed = await this.getExecutedMigrations(dataSource, { readOnly });\n    if (executed.length === 0) return 1;\n    return Math.max(...executed.map((r) => r.batch)) + 1;\n  }\n}\n\nexport const migrationRunner = new MigrationRunner();\n"],"mappings":"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"}
+{"version":3,"file":"migration-runner.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/migration-runner.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { MigrationDriverContract } from \"../contracts/migration-driver.contract\";\nimport type { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\nimport {\n  type Migration,\n  type MigrationContract,\n  type MigrationOrigin,\n  type MigrationStep,\n} from \"./migration\";\nimport { sortMigrations, sortMigrationsForRollback } from \"./migration-order\";\nimport { parseCreatedAt } from \"./parse-created-at\";\nimport { SQLGrammar } from \"./sql-grammar\";\nimport type { MigrationRecord, MigrationResult, TaggedSQL } from \"./types\";\n\n/**\n * Migration class type with static name property.\n */\ntype MigrationClass = (new () => Migration) & {\n  migrationName: string;\n  createdAt?: string;\n  origin?: MigrationOrigin;\n};\n\n/**\n * What a caller may hand to {@link MigrationRunner.register}.\n *\n * Looser than {@link MigrationClass} in exactly one way: `migrationName` may be\n * absent. That is the documented workflow — the CLI imports a migration file and\n * sets the name from the filename afterwards — and `register()` enforces it at\n * runtime, throwing a message that says so. Once past that check the name IS\n * present, which is why everything stored and read downstream uses the stricter\n * type. Requiring it on the INPUT made the runner reject the very classes the\n * public `MigrationConstructor` describes.\n *\n * It constructs a MigrationContract rather than the abstract Migration class for the\n * same reason: `typeof Migration` is abstract and cannot satisfy `new () => Migration`,\n * and the public MigrationConstructor is declared against the contract. The runner only\n * ever uses contract members on what it registers.\n */\ntype RegisterableMigration = (new () => MigrationContract) & {\n  migrationName?: string;\n  createdAt?: string;\n  origin?: MigrationOrigin;\n};\n\n/**\n * Resolved instance data for a single pending migration.\n * @internal\n */\ntype MigrationData = {\n  MigrationClass: MigrationClass;\n  migration: Migration;\n  name: string;\n  /** Data source this migration runs against (its own, else the runner's). */\n  dataSource: DataSource;\n  /** Serialized `up()` statements (empty for direct-execution drivers). */\n  statements: string[];\n  /** Same as `statements`, with queued data steps kept in authored order. */\n  steps: MigrationStep[];\n  /** Whether the migration runs inside a transaction. */\n  transactional: boolean;\n  /** Driver has no SQL dialect (MongoDB): executed through `runMigration`. */\n  direct: boolean;\n};\n\n/**\n * Options for migration execution.\n */\ntype ExecuteOptions = {\n  /** Run in dry-run mode (no actual changes) */\n  readonly dryRun?: boolean;\n  /** Record to migrations table (default: true for batch, false for single) */\n  readonly record?: boolean;\n  /**\n   * Rollback only: delete the `_migrations` rows whose migration file is no\n   * longer registered, instead of failing on them.\n   */\n  readonly pruneMissing?: boolean;\n};\n\n/** Name of the lock document Mongo migrations claim inside the migrations collection. */\nconst MIGRATION_LOCK_NAME = \"__warlock_migration_lock__\";\nconst MIGRATION_LOCK_KEY = \"warlock:migrations\";\nconst MIGRATION_LOCK_TTL_MS = 10 * 60 * 1000;\nconst MIGRATION_LOCK_WAIT_MS = 60 * 1000;\nconst MIGRATION_LOCK_RETRY_MS = 1000;\n\n/** Held lock for one data source. `refresh` extends the TTL; `release` frees it. */\ntype MigrationLock = {\n  refresh: () => Promise<void>;\n  release: () => Promise<void>;\n};\n\ntype PgLockClient = {\n  query: (sql: string, params?: unknown[]) => Promise<unknown>;\n  release: () => void;\n};\n\n/** Minimal Mongo surface the lock needs (kept structural: no driver import). */\ntype MongoLockDatabase = {\n  collection: (name: string) => {\n    findOneAndUpdate: (filter: object, update: object, options: object) => Promise<unknown>;\n    findOne: (filter: object) => Promise<{ owner?: string; expiresAt?: unknown } | null>;\n    deleteOne: (filter: object) => Promise<unknown>;\n  };\n};\n\nconst sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\n/**\n * Derive a migration name from a file path: drop everything after the first dot\n * and strip a trailing `-migration` / `_migration` suffix. Shared by every CLI\n * so the same file is recorded under the same name.\n */\nexport function inferMigrationName(file: string): string {\n  const basename = path.basename(file).split(\".\")[0] ?? \"\";\n\n  return basename.replace(/-migration$/, \"\").replace(/_migration$/, \"\");\n}\n\n/**\n * Migration runner that executes migrations.\n *\n * This is a pure executor - it doesn't discover migrations.\n * Discovery is handled by the framework (e.g., @warlock.js/core CLI).\n *\n * The migration name is read from the static `name` property on the class,\n * which should be set by the CLI after importing:\n *\n * @example\n * ```typescript\n * // In CLI after importing:\n * const { default: MigrationClass } = await import(\"./create-users.migration.ts\");\n * MigrationClass.migrationName ??= \"create-users\";\n *\n * // Then register or execute:\n * runner.register(MigrationClass);\n * // or\n * await runner.execute(MigrationClass);\n * ```\n *\n * @example\n * ```typescript\n * // Simple direct execution\n * await runner.execute(CreateUsersTable);\n * await runner.rollback(CreateUsersTable);\n *\n * // Registry pattern for batch operations\n * runner.register(CreateUsersTable);\n * runner.register(AddEmailIndex);\n * await runner.runAll();\n * await runner.rollbackAll();\n * ```\n */\nexport class MigrationRunner {\n  /** Registered migrations */\n  public readonly migrations: MigrationClass[] = [];\n\n  /** Data source to use */\n  private dataSource?: DataSource;\n\n  /** Cached migration drivers, one per data source */\n  private readonly migrationDrivers = new Map<DataSource, MigrationDriverContract>();\n\n  /** Table name for tracking migrations */\n  private readonly migrationsTable: string;\n\n  /** Whether to log operations */\n  private readonly verbose: boolean;\n\n  /**\n   * Create a new migration runner.\n   *\n   * @param options - Runner options\n   */\n  public constructor(\n    options: {\n      dataSource?: DataSource;\n      migrationsTable?: string;\n      verbose?: boolean;\n    } = {},\n  ) {\n    this.dataSource = options.dataSource;\n    this.migrationsTable = options.migrationsTable ?? \"_migrations\";\n    this.verbose = options.verbose ?? true;\n  }\n\n  // ============================================================================\n  // DATA SOURCE\n  // ============================================================================\n\n  /**\n   * Set the data source.\n   */\n  public setDataSource(dataSource: DataSource): this {\n    this.dataSource = dataSource;\n    this.migrationDrivers.clear();\n    return this;\n  }\n\n  /**\n   * Get the data source.\n   */\n  private getDataSource(): DataSource {\n    if (!this.dataSource) {\n      this.dataSource = dataSourceRegistry.get();\n    }\n    return this.dataSource;\n  }\n\n  /**\n   * Get the migration driver.\n   */\n  private getMigrationDriver(\n    dataSource: DataSource = this.getDataSource(),\n  ): MigrationDriverContract {\n    let driver = this.migrationDrivers.get(dataSource);\n    if (!driver) {\n      driver = dataSource.driver.migrationDriver();\n      this.migrationDrivers.set(dataSource, driver);\n    }\n    return driver;\n  }\n\n  /**\n   * Resolve a migration's declared data source (name or instance).\n   * Falls back to the runner's own data source when it declares none.\n   */\n  private resolveDataSource(declared?: string | DataSource): DataSource {\n    if (!declared) return this.getDataSource();\n    if (typeof declared === \"string\") return dataSourceRegistry.get(declared);\n    return declared;\n  }\n\n  /** Data source a registered migration class runs against. */\n  private sourceOf(MigrationClass: MigrationClass): DataSource {\n    return this.resolveDataSource(new MigrationClass().dataSource);\n  }\n\n  /** Distinct data sources across the registered migrations (runner's own included). */\n  private getSources(): DataSource[] {\n    const sources = new Set<DataSource>([this.getDataSource()]);\n    for (const MigrationClass of this.migrations) {\n      sources.add(this.sourceOf(MigrationClass));\n    }\n    return [...sources];\n  }\n\n  /**\n   * Resolve whether a migration runs in a transaction:\n   * 1. migration-level flag (instance, else the static from `Migration.create/alter`)\n   * 2. `CONCURRENTLY` statements cannot run in a transaction block\n   * 3. data-source config\n   * 4. driver default\n   */\n  private resolveTransactional(\n    MigrationClass: MigrationClass,\n    migration: Migration,\n    dataSource: DataSource,\n    statements: string[] = [],\n  ): boolean {\n    const explicit =\n      migration.transactional ?? (MigrationClass as { transactional?: boolean }).transactional;\n\n    if (explicit !== undefined) return explicit;\n\n    if (statements.some((sql) => /\\bCONCURRENTLY\\b/i.test(sql))) return false;\n\n    return (\n      dataSource.migrations?.transactional ??\n      this.getMigrationDriver(dataSource).getDefaultTransactional()\n    );\n  }\n\n  // ============================================================================\n  // LOCKING\n  // ============================================================================\n\n  /** Locks held by the run in progress (Mongo TTL heartbeat). */\n  private activeLocks: MigrationLock[] = [];\n\n  /** Extend every held lock's TTL; called between migrations. */\n  private async refreshLocks(): Promise<void> {\n    for (const lock of this.activeLocks) {\n      await lock.refresh();\n    }\n  }\n\n  /**\n   * Run `callback` while holding a migration lock on every given data source, so\n   * concurrent `migrate` invocations (replicas, init containers) serialize.\n   */\n  private async withLock<T>(sources: DataSource[], callback: () => Promise<T>): Promise<T> {\n    const held: MigrationLock[] = [];\n\n    try {\n      for (const dataSource of sources) {\n        const lock = await this.acquireLock(dataSource);\n        if (lock) held.push(lock);\n      }\n\n      this.activeLocks = held;\n\n      return await callback();\n    } finally {\n      this.activeLocks = [];\n\n      for (const lock of held.reverse()) {\n        try {\n          await lock.release();\n        } catch (error) {\n          log.warn(\n            \"database\",\n            \"migration\",\n            `Failed to release migration lock: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n      }\n    }\n  }\n\n  /** Acquire the lock for one data source; `undefined` when its driver has no lock support. */\n  private async acquireLock(dataSource: DataSource): Promise<MigrationLock | undefined> {\n    const driver = dataSource.driver as unknown as {\n      name: string;\n      getClient?: () => { connect?: () => Promise<PgLockClient> };\n      getDatabase?: () => MongoLockDatabase;\n    };\n\n    if (driver.name === \"postgres\" && driver.getClient) {\n      // A dedicated client: advisory locks are per-session, not per-pool.\n      const client = await driver.getClient().connect?.();\n      if (!client) return undefined;\n\n      try {\n        await client.query(\"SELECT pg_advisory_lock(hashtext($1))\", [MIGRATION_LOCK_KEY]);\n      } catch (error) {\n        client.release();\n        throw error;\n      }\n\n      return {\n        refresh: async () => {},\n        release: async () => {\n          try {\n            await client.query(\"SELECT pg_advisory_unlock(hashtext($1))\", [MIGRATION_LOCK_KEY]);\n          } finally {\n            client.release();\n          }\n        },\n      };\n    }\n\n    if (driver.getDatabase) {\n      // The unique index on `name` (created here) makes the claim below atomic.\n      await this.getMigrationDriver(dataSource).ensureMigrationsTable(this.migrationsTable);\n\n      const collection = driver.getDatabase().collection(this.migrationsTable);\n      const owner = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n      const deadline = Date.now() + MIGRATION_LOCK_WAIT_MS;\n\n      const claim = async (): Promise<boolean> => {\n        const now = new Date();\n\n        try {\n          await collection.findOneAndUpdate(\n            {\n              name: MIGRATION_LOCK_NAME,\n              $or: [{ expiresAt: { $lt: now } }, { owner }],\n            },\n            {\n              $set: { owner, expiresAt: new Date(now.getTime() + MIGRATION_LOCK_TTL_MS) },\n              $setOnInsert: { batch: 0 },\n            },\n            { upsert: true },\n          );\n\n          return true;\n        } catch (error) {\n          // Held by someone else: the upsert collides with the unique `name` index.\n          if ((error as { code?: number }).code === 11000) return false;\n          throw error;\n        }\n      };\n\n      while (!(await claim())) {\n        if (Date.now() >= deadline) {\n          const holder = await collection.findOne({ name: MIGRATION_LOCK_NAME });\n          throw new Error(\n            `Could not acquire the migration lock within ${MIGRATION_LOCK_WAIT_MS / 1000}s; ` +\n              `held by \"${holder?.owner ?? \"unknown\"}\" until ${holder?.expiresAt ?? \"unknown\"}.`,\n          );\n        }\n\n        await sleep(MIGRATION_LOCK_RETRY_MS);\n      }\n\n      return {\n        refresh: async () => {\n          await claim();\n        },\n        release: async () => {\n          await collection.deleteOne({ name: MIGRATION_LOCK_NAME, owner });\n        },\n      };\n    }\n\n    return undefined;\n  }\n\n  // ============================================================================\n  // REGISTRATION\n  // ============================================================================\n\n  /**\n   * Register a migration.\n   *\n   * The migration name is read from `MigrationClass.migrationName`.\n   *\n   * @param MigrationClass - Migration class (must have static `name` set)\n   * @param origin - Registration source; defaults to `\"app\"` for direct registrations.\n   * @returns This runner for chaining\n   *\n   * @example\n   * ```typescript\n   * CreateUsersTable.migrationName = \"2024-01-15_create-users\";\n   * runner.register(CreateUsersTable);\n   * ```\n   */\n  public register(MigrationClass: RegisterableMigration, origin: MigrationOrigin = \"app\"): this {\n    const name = MigrationClass.migrationName;\n    if (!name) {\n      throw new Error(\n        `Migration class must have a static 'migrationName' property set. ` +\n          `Set it in CLI after importing: MigrationClass.migrationName = \"filename\";`,\n      );\n    }\n    const existing = this.migrations.find((m) => m.migrationName === name);\n\n    if (existing) {\n      // Re-registering the same class is idempotent; a DIFFERENT class under the\n      // same name would silently never run, so fail loudly.\n      if ((existing as unknown) !== MigrationClass) {\n        throw new Error(\n          `Duplicate migration name \"${name}\": two different migration classes resolve to the same name. ` +\n            `Rename one of the files (or set a unique static 'migrationName').`,\n        );\n      }\n\n      return this;\n    }\n\n    // `name` is proven present by the throw above, so this satisfies the stricter\n    // stored type that every reader downstream relies on.\n    MigrationClass.origin = origin;\n    this.migrations.push(MigrationClass as MigrationClass);\n\n    return this;\n  }\n\n  /**\n   * Register multiple migrations.\n   *\n   * @param migrations - Array of migration classes\n   * @returns This runner for chaining\n   */\n  public registerMany(migrations: RegisterableMigration[]): this {\n    for (const MigrationClass of migrations) {\n      this.register(MigrationClass);\n    }\n    return this;\n  }\n\n  /**\n   * Clear all registered migrations.\n   */\n  public clear(): this {\n    this.migrations.length = 0;\n    return this;\n  }\n\n  /**\n   * Get all registered migration names.\n   */\n  public getRegisteredNames(): string[] {\n    return this.migrations.map((m) => m.migrationName);\n  }\n\n  // ============================================================================\n  // SINGLE EXECUTION\n  // ============================================================================\n\n  /**\n   * Execute a single migration's up() method.\n   *\n   * @param MigrationClass - Migration class to execute\n   * @param options - Execution options\n   * @returns Migration result\n   *\n   * @example\n   * ```typescript\n   * await runner.execute(CreateUsersTable);\n   * await runner.execute(AddEmailIndex, { dryRun: true });\n   * ```\n   */\n  public async run(\n    MigrationClass: MigrationClass,\n    options: ExecuteOptions = {},\n  ): Promise<MigrationResult> {\n    return this.runMigration(MigrationClass, \"up\", {\n      dryRun: options.dryRun,\n      record: options.record ?? false,\n    });\n  }\n\n  /**\n   * Execute a single migration's down() method.\n   *\n   * @param MigrationClass - Migration class to rollback\n   * @param options - Execution options\n   * @returns Migration result\n   *\n   * @example\n   * ```typescript\n   * await runner.rollback(CreateUsersTable);\n   * ```\n   */\n  public async rollback(\n    MigrationClass: MigrationClass,\n    options: ExecuteOptions = {},\n  ): Promise<MigrationResult> {\n    return this.runMigration(MigrationClass, \"down\", {\n      dryRun: options.dryRun,\n      record: options.record ?? false,\n    });\n  }\n\n  // ============================================================================\n  // BATCH EXECUTION (REGISTERED MIGRATIONS)\n  // ============================================================================\n\n  /**\n   * Run all pending registered migrations.\n   *\n   * Only runs migrations not already in the migrations table.\n   *\n   * @param options - Execution options\n   * @returns Results for each migration\n   *\n   * @example\n   * ```typescript\n   * runner.register(CreateUsersTable);\n   * runner.register(AddEmailIndex);\n   * const results = await runner.runAll();\n   * ```\n   */\n  public async runAll(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    // A dry run writes nothing, so it needs no lock.\n    if (options.dryRun) return this.runAllUnlocked(options);\n\n    // The pending set is computed INSIDE the lock, so a replica that waited sees\n    // what the winner already applied.\n    return this.withLock(this.getSources(), () => this.runAllUnlocked(options));\n  }\n\n  private async runAllUnlocked(options: ExecuteOptions): Promise<MigrationResult[]> {\n    const { dryRun = false, record = true } = options;\n\n    const results: MigrationResult[] = [];\n\n    // Get pending migrations (a dry run must not create the migrations table)\n    const pending = await this.getPendingMigrations({ readOnly: dryRun });\n\n    if (pending.length === 0) {\n      log.warn(\"database\", \"migration\", \"Nothing to migrate.\");\n      return results;\n    }\n\n    // Next batch number per data source: each source has its own migrations table.\n    const sources = new Set<DataSource>();\n    const migrationsData: MigrationData[] = [];\n\n    log.info(\"database\", \"migration\", `Found ${pending.length} pending migration(s).`);\n\n    // 1. Resolve each migration's data source and transactional mode, and collect\n    //    its SQL. Drivers without SQL serialization (MongoDB) are executed\n    //    directly through the migration driver instead.\n    //    Extension checks fire concurrently as CREATE EXTENSION statements are met.\n    const extensionChecks: Promise<void>[] = [];\n\n    for (const MigrationClass of pending) {\n      const migration = this.createMigrationInstance(MigrationClass);\n      const name = MigrationClass.migrationName;\n      const dataSource = this.resolveDataSource(migration.dataSource);\n      sources.add(dataSource);\n\n      if (dataSource.driver.supportsSqlSerialization === false) {\n        migrationsData.push({\n          MigrationClass,\n          migration,\n          name,\n          dataSource,\n          statements: [],\n          steps: [],\n          transactional: false,\n          direct: true,\n        });\n        continue;\n      }\n\n      migration.setDriver(this.getMigrationDriver(dataSource));\n      migration.setMigrationDefaults(dataSource.migrationDefaults);\n      // Collection must not run `withConnection` side effects during a dry run.\n      migration.setDryRun?.(dryRun);\n\n      await migration.up();\n      const steps: MigrationStep[] = migration.toSteps?.() ?? migration.toSQL();\n      const statements = steps.map((step) =>\n        typeof step === \"string\" ? step : \"-- data step (withConnection) skipped\",\n      );\n      migration.setDryRun?.(false);\n\n      migrationsData.push({\n        MigrationClass,\n        migration,\n        name,\n        dataSource,\n        statements,\n        steps,\n        transactional:\n          !!dataSource.driver.transaction &&\n          this.resolveTransactional(MigrationClass, migration, dataSource, statements),\n        direct: false,\n      });\n\n      for (const sql of statements) {\n        if (SQLGrammar.classify(sql) === \"CREATE_EXTENSION\") {\n          const ext = SQLGrammar.extractExtensionName(sql);\n          if (ext) extensionChecks.push(this.informIfExtensionMissing(ext, dataSource));\n        }\n      }\n    }\n\n    // 2. Resolve all extension checks before any SQL is executed.\n    await Promise.all(extensionChecks);\n\n    // 3. Dry run: print statements in migration order (authored order kept; no\n    //    global phase sort, which would reorder add-column → backfill → NOT NULL).\n    if (dryRun) {\n      log.info(\"database\", \"migration\", \"Dry run enabled. Would execute the following statements:\");\n      for (const data of migrationsData) {\n        for (const sql of data.statements) {\n          console.log(\n            `-- [${SQLGrammar.classify(sql)}] Phase ${SQLGrammar.phase(sql)} [${data.name}]`,\n          );\n          console.log(sql + \";\\n\");\n        }\n      }\n      return [];\n    }\n\n    const batches = new Map<DataSource, number>();\n    for (const dataSource of sources) {\n      batches.set(dataSource, await this.getNextBatchNumber(dataSource));\n    }\n\n    // 4. Split into runs: consecutive transactional migrations on the same data\n    //    source share one transaction; every other migration (non-transactional\n    //    or direct) runs alone.\n    const runs: MigrationData[][] = [];\n    for (const data of migrationsData) {\n      const last = runs[runs.length - 1];\n      const lastFirst = last?.[0];\n      if (\n        data.transactional &&\n        last &&\n        lastFirst?.transactional &&\n        lastFirst.dataSource === data.dataSource\n      ) {\n        last.push(data);\n      } else {\n        runs.push([data]);\n      }\n    }\n\n    for (const run of runs) {\n      const first = run[0];\n      if (!first) continue;\n      await this.refreshLocks();\n      const dataSource = first.dataSource;\n      const nextBatch = batches.get(dataSource)!;\n      const startTime = Date.now();\n\n      if (first.direct) {\n        const result = await this.runMigration(first.MigrationClass, \"up\", {\n          dryRun,\n          record,\n          batch: nextBatch,\n        });\n        results.push(result);\n        if (!result.success) break;\n        continue;\n      }\n\n      const driver = dataSource.driver;\n      let failed = false;\n      let errorMessage = \"\";\n      /** The migration that owns the SQL statement that threw. */\n      let failingMigrationName: string | undefined;\n\n      const executeRun = async (): Promise<void> => {\n        for (const data of run) {\n          for (const step of data.steps) {\n            try {\n              if (typeof step === \"string\") await driver.query(step);\n              else await step.data();\n            } catch (err) {\n              failingMigrationName = data.name;\n              throw err;\n            }\n          }\n\n          // A non-transactional migration is recorded right after it applied.\n          // Transactional ones are recorded inside the shared transaction.\n          if (record) {\n            await this.recordMigration(\n              data.name,\n              nextBatch,\n              data.MigrationClass.createdAt\n                ? parseCreatedAt(data.MigrationClass.createdAt)\n                : new Date(),\n              dataSource,\n            );\n          }\n        }\n      };\n\n      try {\n        if (first.transactional && driver.transaction) {\n          await driver.transaction(executeRun);\n        } else {\n          await executeRun();\n        }\n      } catch (err) {\n        failed = true;\n        errorMessage = err instanceof Error ? err.message : String(err);\n      }\n\n      const durationMs = Date.now() - startTime;\n\n      // Only the migration that owns the failing statement is marked failed;\n      // the rest of its run is reported as rolled back.\n      for (const data of run) {\n        const isCulprit = failed && data.name === failingMigrationName;\n        const wasSkipped = failed && !isCulprit;\n\n        results.push({\n          name: data.name,\n          table: data.migration.table,\n          direction: \"up\",\n          success: !failed,\n          error: isCulprit ? errorMessage : undefined,\n          durationMs: Math.round(durationMs / run.length),\n          executedAt: new Date(),\n        });\n\n        if (isCulprit) {\n          log.error(\n            \"database\",\n            \"migration\",\n            `${colors.magenta(data.name)}: ✗ Failed: ${errorMessage}`,\n          );\n        } else if (wasSkipped) {\n          log.warn(\n            \"database\",\n            \"migration\",\n            `${colors.magenta(data.name)}: rolled back (batch transaction failed)`,\n          );\n        } else {\n          log.success(\n            \"database\",\n            \"migration\",\n            `Migrated: ${colors.magenta(data.name)} successfully`,\n          );\n        }\n      }\n\n      if (failed) {\n        log.error(\n          \"database\",\n          \"migration\",\n          `Batch execution failed. Rollback performed if transactional.`,\n        );\n        throw new Error(\"Migration batch failed: \" + errorMessage);\n      }\n    }\n\n    const successCount = results.filter((r) => r.success).length;\n    log.success(\n      \"database\",\n      \"migration\",\n      `Migration execution complete: ${successCount}/${pending.length} migrations processed successfully.`,\n    );\n\n    return results;\n  }\n\n  /**\n   * Export migrations as phase-ordered SQL files in database/sql/ directory.\n   * By default, it exports all registered migrations. Use `pendingOnly: true` to export only pending ones.\n   */\n  public async exportSQL(\n    options: { pendingOnly?: boolean; compact?: boolean } = {},\n  ): Promise<void> {\n    if (this.getDataSource().driver.supportsSqlSerialization === false) {\n      throw new Error(\n        \"SQL export is not supported on this data source — its driver has no SQL dialect. \" +\n          \"Migrations on this driver execute native commands through the migration driver instead.\",\n      );\n    }\n\n    const migrationsToExport = options.pendingOnly\n      ? await this.getPendingMigrations({ readOnly: true })\n      : this.migrations;\n\n    if (migrationsToExport.length === 0) {\n      log.warn(\"database\", \"migration\", \"No migrations to export.\");\n      return;\n    }\n\n    log.info(\n      \"database\",\n      \"migration\",\n      `Exporting ${migrationsToExport.length} ${options.pendingOnly ? \"pending \" : \"\"}migration(s) to SQL files...`,\n    );\n\n    const upStatements: TaggedSQL[] = [];\n    // Down SQL is grouped per migration so only the migration order is reversed,\n    // never the statements inside one migration's down().\n    const downGroups: { createdAt?: string; index: number; statements: TaggedSQL[] }[] = [];\n\n    for (const [index, MigrationClass] of migrationsToExport.entries()) {\n      const migration = this.createMigrationInstance(MigrationClass);\n      const name = MigrationClass.migrationName;\n\n      // Export performs no writes: `withConnection` callbacks are skipped.\n      migration.setDryRun?.(true);\n\n      // Collect up SQL\n      await migration.up();\n      for (const sql of migration.toSQL()) {\n        upStatements.push({\n          sql,\n          phase: SQLGrammar.phase(sql),\n          statementType: SQLGrammar.classify(sql),\n          createdAt: MigrationClass.createdAt,\n          migrationName: name,\n        });\n      }\n\n      // Collect down SQL (reuse same instance — toSQL() cleared pendingOps)\n      await migration.down();\n      const statements: TaggedSQL[] = [];\n      for (const sql of migration.toSQL()) {\n        statements.push({\n          sql,\n          phase: SQLGrammar.phase(sql),\n          statementType: SQLGrammar.classify(sql),\n          createdAt: MigrationClass.createdAt,\n          migrationName: name,\n        });\n      }\n      downGroups.push({ createdAt: MigrationClass.createdAt, index, statements });\n    }\n\n    const sortedUp = SQLGrammar.sort(upStatements);\n    // Down SQL: newest migration first (chronological, registration order breaks\n    // ties), each migration's own down() statements keep their order.\n    const sortedDown = downGroups\n      .sort((a, b) => {\n        const byDate = (a.createdAt ?? \"\").localeCompare(b.createdAt ?? \"\");\n        return byDate !== 0 ? byDate : a.index - b.index;\n      })\n      .reverse()\n      .flatMap((group) => group.statements);\n\n    const upSQLString = this.formatSQLForExport(sortedUp, options.compact);\n    const downSQLString = this.formatSQLForExport(sortedDown, options.compact);\n\n    const rootPath = process.cwd();\n    const sqlDir = path.join(rootPath, \"database\", \"sql\");\n\n    if (!fs.existsSync(sqlDir)) {\n      fs.mkdirSync(sqlDir, { recursive: true });\n    }\n\n    const timestamp = new Date().toISOString().replace(/T/, \"_\").replace(/:/g, \"-\").split(\".\")[0];\n    const upPath = path.join(sqlDir, `migration_${timestamp}.up.sql`);\n    const downPath = path.join(sqlDir, `migration_${timestamp}.down.sql`);\n\n    fs.writeFileSync(upPath, upSQLString);\n    fs.writeFileSync(downPath, downSQLString);\n\n    log.success(\"database\", \"migration\", `Exported to:\\n- ${upPath}\\n- ${downPath}`);\n  }\n\n  /**\n   * Rollback the last batch of migrations.\n   *\n   * @param options - Execution options\n   * @returns Results for each migration\n   */\n  public async rollbackLast(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    return this.rollbackBatches(1, options);\n  }\n\n  /**\n   * Rollback N batches of migrations.\n   *\n   * @param batches - Number of batches to rollback\n   * @param options - Execution options\n   * @returns Results for each migration\n   */\n  public async rollbackBatches(\n    batches: number,\n    options: ExecuteOptions = {},\n  ): Promise<MigrationResult[]> {\n    if (options.dryRun) return this.rollbackBatchesUnlocked(batches, options);\n\n    return this.withLock(this.getSources(), () => this.rollbackBatchesUnlocked(batches, options));\n  }\n\n  private async rollbackBatchesUnlocked(\n    batches: number,\n    options: ExecuteOptions,\n  ): Promise<MigrationResult[]> {\n    const dryRun = options.dryRun ?? false;\n    const record = options.record ?? true;\n    const results: MigrationResult[] = [];\n\n    const toRollback = await this.getMigrationsToRollback(batches, {\n      pruneMissing: options.pruneMissing,\n      readOnly: dryRun,\n    });\n\n    if (toRollback.length === 0) {\n      log.warn(\"database\", \"migration\", \"Nothing to rollback.\");\n      return results;\n    }\n\n    log.info(\"database\", \"migration\", `Rolling back ${toRollback.length} migration(s).`);\n\n    for (const MigrationClass of toRollback) {\n      await this.refreshLocks();\n\n      const result = await this.runMigration(MigrationClass, \"down\", {\n        dryRun,\n        record,\n      });\n      results.push(result);\n\n      if (!result.success) {\n        break;\n      }\n    }\n\n    const successCount = results.filter((r) => r.success).length;\n    log.success(\n      \"database\",\n      \"migration\",\n      `Rollback complete: ${successCount}/${toRollback.length} successful.`,\n    );\n\n    return results;\n  }\n\n  /**\n   * Rollback all executed migrations.\n   *\n   * @param options - Execution options\n   * @returns Results for each migration\n   */\n  public async rollbackAll(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    // Batch numbers are per data source; rolling back \"all\" is every batch of each.\n    return this.rollbackBatches(Number.POSITIVE_INFINITY, options);\n  }\n\n  /**\n   * Reset and re-run: rollback all then run all.\n   *\n   * @param options - Execution options\n   * @returns Combined results\n   */\n  public async fresh(options: ExecuteOptions = {}): Promise<MigrationResult[]> {\n    const rollbackResults = await this.rollbackAll(options);\n    const runResults = await this.runAll(options);\n    return [...rollbackResults, ...runResults];\n  }\n\n  // ============================================================================\n  // STATUS\n  // ============================================================================\n\n  /**\n   * Get status of all registered migrations.\n   */\n  public async status(): Promise<\n    Array<{\n      name: string;\n      table: string;\n      executed: boolean;\n      batch: number | null;\n    }>\n  > {\n    const executedBySource = new Map<DataSource, Map<string, MigrationRecord>>();\n\n    for (const dataSource of this.getSources()) {\n      const executed = await this.getExecutedMigrations(dataSource, { readOnly: true });\n      executedBySource.set(dataSource, new Map(executed.map((r) => [r.name, r])));\n    }\n\n    return this.migrations.map((MigrationClass) => {\n      const instance = new MigrationClass();\n      const name = MigrationClass.migrationName;\n      const record = executedBySource.get(this.sourceOf(MigrationClass))?.get(name);\n      return {\n        name,\n        table: instance.table,\n        executed: !!record,\n        batch: record?.batch ?? null,\n      };\n    });\n  }\n\n  // ============================================================================\n  // EXTENSION PRE-FLIGHT\n  // ============================================================================\n\n  /**\n   * Check whether a database extension is available and inform the developer\n   * if it is not installed.\n   *\n   * Does NOT throw — execution proceeds normally. If the extension is truly\n   * missing, the database will surface its own error with full context already\n   * displayed to the developer.\n   *\n   * @example\n   * await this.informIfExtensionMissing(\"vector\");\n   */\n  private async informIfExtensionMissing(\n    extension: string,\n    dataSource: DataSource = this.getDataSource(),\n  ): Promise<void> {\n    try {\n      const migrationDriver = this.getMigrationDriver(dataSource);\n      const isAvailable = await migrationDriver.isExtensionAvailable(extension);\n\n      if (!isAvailable) {\n        const hr = \"─\".repeat(60);\n        console.log(`\\n${colors.yellow(hr)}`);\n        console.log(colors.yellow(`  ⚠  Missing Database Extension: ${colors.bold(extension)}`));\n        console.log(colors.yellow(hr));\n        console.log();\n        console.log(`  A pending migration requires the ${colors.cyan(extension)} extension,`);\n        console.log(`  which is not installed on your database server.`);\n        console.log();\n        console.log(\n          `  ${colors.bold(\"This means the physical database server is missing the extension package.\")}`,\n        );\n        console.log(`  You cannot simply run CREATE EXTENSION until the package is installed`);\n        console.log(`  on the host machine or Docker container.`);\n        console.log();\n\n        const docsUrl = migrationDriver.getExtensionDocsUrl(extension);\n        if (docsUrl) {\n          console.log(`  ${colors.bold(\"Or follow the installation guide:\")}`);\n          console.log(`    ${colors.cyan(docsUrl)}`);\n        }\n        console.log(`\\n${colors.yellow(hr)}\\n`);\n      }\n    } catch {\n      // If the check itself fails, silently skip — don't break the migration.\n    }\n  }\n\n  // ============================================================================\n  // PRIVATE HELPERS\n  // ============================================================================\n\n  /**\n   * Run a single migration.\n   */\n  private async runMigration(\n    MigrationClass: MigrationClass,\n    direction: \"up\" | \"down\",\n    options: {\n      dryRun?: boolean;\n      record?: boolean;\n      batch?: number;\n    } = {},\n  ): Promise<MigrationResult> {\n    const { dryRun = false, record = true } = options;\n    const startTime = Date.now();\n    let success = true;\n    let error: string | undefined;\n\n    const migration = new MigrationClass();\n    const name = MigrationClass.migrationName;\n\n    log.info(\n      \"database\",\n      \"migration\",\n      `${direction === \"up\" ? \"Migrating\" : \"Rolling back\"}: ${colors.magenta(name)}...`,\n    );\n\n    try {\n      if (!dryRun) {\n        // The migration runs against its declared data source (default: the runner's)\n        // and is recorded in THAT source's migrations table.\n        const dataSource = this.resolveDataSource(migration.dataSource);\n        const driver = this.getMigrationDriver(dataSource);\n        migration.setDriver(driver);\n        migration.setMigrationDefaults(dataSource.migrationDefaults);\n\n        // ============================================================================\n        // TRANSACTION RESOLUTION (3-tier hierarchy)\n        // ============================================================================\n        // 1. Migration-level explicit override (instance or static)\n        // 2. CONCURRENTLY statements (cannot run in a transaction block)\n        // 3. Config-level global override\n        // 4. Driver default (PostgreSQL: true, MongoDB: false)\n        // Resolved below, once the statements are known.\n\n        // ============================================================================\n        // EXECUTE WITH OR WITHOUT TRANSACTION\n        // ============================================================================\n\n        // Collect the requested direction's operations\n        if (direction === \"up\") {\n          await migration.up();\n        } else {\n          await migration.down();\n        }\n\n        const databaseDriver = dataSource.driver;\n\n        // SQL-capable drivers serialize the queued operations to SQL strings;\n        // drivers without SQL serialization (MongoDB) keep them queued and\n        // execute them directly through the migration driver.\n        const directExecution = databaseDriver.supportsSqlSerialization === false;\n        const steps: MigrationStep[] = directExecution\n          ? []\n          : (migration.toSteps?.() ?? migration.toSQL());\n        const sqlStatements = steps.filter((step): step is string => typeof step === \"string\");\n        const shouldUseTransaction = this.resolveTransactional(\n          MigrationClass,\n          migration,\n          dataSource,\n          sqlStatements,\n        );\n\n        const applyMigration = async (): Promise<void> => {\n          if (directExecution) {\n            await migration.execute();\n            return;\n          }\n\n          // Execute generated SQL statements sequentially (no phase-sorting here since it's single execution)\n          for (const step of steps) {\n            if (typeof step === \"string\") await databaseDriver.query(step);\n            else await step.data();\n          }\n        };\n\n        if (shouldUseTransaction && databaseDriver.transaction) {\n          // Transactional execution\n          await databaseDriver.transaction(async () => {\n            await applyMigration();\n\n            // Record migration tracking\n            if (record) {\n              if (direction === \"up\") {\n                const batch = options.batch ?? (await this.getNextBatchNumber(dataSource));\n                await this.recordMigration(\n                  name,\n                  batch,\n                  MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : new Date(),\n                  dataSource,\n                );\n              } else {\n                await this.removeMigrationRecord(name, dataSource);\n              }\n            }\n          });\n        } else {\n          // Non-transactional execution\n          await applyMigration();\n\n          if (record) {\n            if (direction === \"up\") {\n              const batch = options.batch ?? (await this.getNextBatchNumber(dataSource));\n              await this.recordMigration(\n                name,\n                batch,\n                MigrationClass.createdAt ? parseCreatedAt(MigrationClass.createdAt) : new Date(),\n                dataSource,\n              );\n            } else {\n              await this.removeMigrationRecord(name, dataSource);\n            }\n          }\n        }\n      }\n    } catch (err) {\n      success = false;\n      error = err instanceof Error ? err.message : String(err);\n      log.error(\"database\", \"migration\", `${colors.magenta(name)}: ✗ Failed: ${error}`);\n      throw err;\n    }\n\n    const durationMs = Date.now() - startTime;\n\n    if (success) {\n      log.success(\n        \"database\",\n        \"migration\",\n        `${direction == \"up\" ? \"Migrated\" : \"Rolled back\"}: ${colors.magenta(name)} successfully (${durationMs}ms)`,\n      );\n    }\n\n    return {\n      name,\n      table: migration.table,\n      direction,\n      success,\n      error,\n      durationMs,\n      executedAt: new Date(),\n    };\n  }\n\n  /**\n   * Create, configure, and return a ready-to-use migration instance.\n   *\n   * Centralises the repeated \"new + setDriver + setMigrationDefaults\" boilerplate\n   * that all batch/single execution paths need.\n   *\n   * @internal\n   */\n  private createMigrationInstance(MigrationClass: MigrationClass): Migration {\n    const migration = new MigrationClass();\n    const dataSource = this.resolveDataSource(migration.dataSource);\n    migration.setDriver(this.getMigrationDriver(dataSource));\n    migration.setMigrationDefaults(dataSource.migrationDefaults);\n    return migration;\n  }\n\n  /**\n   * Format an ordered array of TaggedSQL into a human-readable SQL file string.\n   *\n   * Consecutive statements that belong to the same (phase, migration) group share\n   * a single block comment at the top, avoiding the noisy per-statement repetition.\n   *\n   * Example output:\n   * ```sql\n   * /* Phase 3 [create-users] *\\/\n   * ALTER TABLE \"users\" ADD COLUMN \"name\" TEXT NOT NULL;\n   * ALTER TABLE \"users\" ADD COLUMN \"email\" TEXT NOT NULL;\n   *\n   * /* Phase 4 [create-users] *\\/\n   * CREATE UNIQUE INDEX ...;\n   * ```\n   *\n   * @internal\n   */\n  private formatSQLForExport(statements: TaggedSQL[], compact: boolean = false): string {\n    const lines: string[] = [];\n\n    if (compact) {\n      // Just output raw statements, no grouping, no blank lines\n      for (const stmt of statements) {\n        lines.push(`${stmt.sql};`);\n      }\n      return lines.join(\"\\n\");\n    }\n\n    // Group statements by their phase and migration name\n    const grouped = new Map<string, string[]>();\n\n    for (const stmt of statements) {\n      const groupKey = `Phase ${stmt.phase} [${stmt.migrationName}]`;\n      if (!grouped.has(groupKey)) {\n        grouped.set(groupKey, []);\n      }\n      grouped.get(groupKey)!.push(stmt.sql);\n    }\n\n    // Format each group\n    for (const [groupKey, sqls] of grouped.entries()) {\n      if (lines.length > 0) lines.push(\"\"); // blank line between groups\n      lines.push(`/* ${groupKey} */`);\n      for (const sql of sqls) {\n        lines.push(`${sql};`);\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Get pending (not executed) registered migrations, in the order they would\n   * execute.\n   *\n   * ⚠️ \"Registered\" is load-bearing. This filters `this.migrations`, which is\n   * populated only by `register()` / `registerMany()`. A caller that has not\n   * registered anything gets `[]` — indistinguishable from a database with\n   * nothing pending. Anything reporting this set to a human MUST register\n   * migrations first, or it will print a confident all-clear over an unknown.\n   *\n   * @see listPendingMigrations\n   */\n  public async getPendingMigrations(\n    options: { readOnly?: boolean } = {},\n  ): Promise<MigrationClass[]> {\n    // \"Executed\" is judged in each migration's own data source's migrations table.\n    const executedNames = new Map<DataSource, Set<string>>();\n    for (const dataSource of this.getSources()) {\n      const executed = await this.getExecutedMigrations(dataSource, options);\n      executedNames.set(dataSource, new Set(executed.map((r) => r.name)));\n    }\n\n    const migrations = this.migrations.filter(\n      (m) => !executedNames.get(this.sourceOf(m))?.has(m.migrationName),\n    );\n\n    return migrations.sort(sortMigrations);\n  }\n\n  /**\n   * Get migrations to rollback, newest-first.\n   *\n   * A rollback must undo migrations in the exact inverse of the order `up`\n   * applied them, or a `down()` will hit schema its predecessor already\n   * removed — dropping a table before dropping the column added to it, say.\n   *\n   * The sort has to be explicitly **descending**. Reversing the executed list\n   * is not enough: `getExecutedMigrations` orders by `batch, name`, so the\n   * input is alphabetical rather than chronological, and reversing it only\n   * yields reverse-alphabetical order. (Sorting *ascending* here — which is\n   * what this method used to do after a `.reverse()` — silently restored the\n   * forward `up` order and made the reverse dead code.)\n   */\n  private async getMigrationsToRollback(\n    batches: number,\n    options: { pruneMissing?: boolean; readOnly?: boolean } = {},\n  ): Promise<MigrationClass[]> {\n    const migrations: MigrationClass[] = [];\n    const batchOf = new Map<MigrationClass, number>();\n    const orphans: Array<{ name: string; dataSource: DataSource }> = [];\n\n    // Batches are numbered per data source (each has its own migrations table).\n    for (const dataSource of this.getSources()) {\n      const executed = await this.getExecutedMigrations(dataSource, {\n        readOnly: options.readOnly,\n      });\n      if (executed.length === 0) continue;\n\n      const batchNumbers = [...new Set(executed.map((r) => r.batch))]\n        .sort((a, b) => b - a)\n        .slice(0, batches);\n\n      for (const record of executed) {\n        if (!batchNumbers.includes(record.batch)) continue;\n\n        const MigrationClass = this.migrations.find(\n          (m) => m.migrationName === record.name && this.sourceOf(m) === dataSource,\n        );\n        if (MigrationClass) {\n          migrations.push(MigrationClass);\n          batchOf.set(MigrationClass, record.batch);\n        } else {\n          orphans.push({ name: record.name, dataSource });\n        }\n      }\n    }\n\n    if (orphans.length > 0) {\n      if (!options.pruneMissing) {\n        throw new Error(\n          `Cannot roll back: ${orphans.length} executed migration(s) have no registered file: ` +\n            `${orphans.map((o) => o.name).join(\", \")}. ` +\n            `They were renamed, deleted, or not matched by the migration pattern. ` +\n            `Restore the file(s), or pass pruneMissing (--prune-missing) to delete those records.`,\n        );\n      }\n\n      if (!options.readOnly) {\n        for (const orphan of orphans) {\n          await this.removeMigrationRecord(orphan.name, orphan.dataSource);\n          log.warn(\"database\", \"migration\", `Pruned orphaned migration record: ${orphan.name}`);\n        }\n      }\n    }\n\n    // Newest batch first, then newest migration first within a batch.\n    return migrations.sort(\n      (a, b) => (batchOf.get(b) ?? 0) - (batchOf.get(a) ?? 0) || sortMigrationsForRollback(a, b),\n    );\n  }\n\n  /**\n   * Get executed migration records.\n   */\n  public async getExecutedMigrations(\n    dataSource: DataSource = this.getDataSource(),\n    options: { readOnly?: boolean } = {},\n  ): Promise<MigrationRecord[]> {\n    const driver = dataSource.driver;\n    const migrationDriver = this.getMigrationDriver(dataSource);\n\n    if (options.readOnly) {\n      // Dry runs and listings must not create the migrations table.\n      if (!(await migrationDriver.tableExists(this.migrationsTable))) return [];\n    } else {\n      // A missing table is created here; every other error (connection,\n      // permission…) propagates instead of looking like \"nothing executed\".\n      await migrationDriver.ensureMigrationsTable(this.migrationsTable);\n    }\n\n    const queryBuilder = driver.queryBuilder<MigrationRecord>(this.migrationsTable);\n    const records = await queryBuilder.orderBy(\"batch\", \"asc\").orderBy(\"name\", \"asc\").get();\n\n    // The Mongo lock document lives in this collection; it is not a migration.\n    return records.filter((record) => record.name !== MIGRATION_LOCK_NAME);\n  }\n\n  /**\n   * Record a migration.\n   */\n  private async recordMigration(\n    name: string,\n    batch: number,\n    createdAt?: Date,\n    dataSource: DataSource = this.getDataSource(),\n  ): Promise<void> {\n    const driver = dataSource.driver;\n    const migrationDriver = this.getMigrationDriver(dataSource);\n\n    // Ensure migrations table exists\n    await migrationDriver.ensureMigrationsTable(this.migrationsTable);\n\n    await driver.insert(this.migrationsTable, {\n      name,\n      batch,\n      executedAt: new Date(),\n      createdAt,\n    });\n  }\n\n  /**\n   * Remove a migration record.\n   */\n  private async removeMigrationRecord(\n    name: string,\n    dataSource: DataSource = this.getDataSource(),\n  ): Promise<void> {\n    const driver = dataSource.driver;\n    await driver.delete(this.migrationsTable, { name });\n  }\n\n  /**\n   * Get next batch number.\n   */\n  private async getNextBatchNumber(\n    dataSource: DataSource = this.getDataSource(),\n    readOnly = false,\n  ): Promise<number> {\n    const executed = await this.getExecutedMigrations(dataSource, { readOnly });\n    if (executed.length === 0) return 1;\n    return Math.max(...executed.map((r) => r.batch)) + 1;\n  }\n}\n\nexport const migrationRunner = new MigrationRunner();\n"],"mappings":"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"}

package/esm/migration/migration.d.mts

@@ -8,30 +8,29 @@ import { Model } from "../model/model.mjs";
 import { DatabaseDriver } from "../utils/connect-to-database.mjs";
 import { ForeignKeyBuilder } from "./foreign-key-builder.mjs";
 import { DataSource } from "../data-source/data-source.mjs";
-
 //#region ../../packages/cascade/src/migration/migration.d.ts
 /**
  * Pending operation types supported by migrations.
  */
-type OperationType = "addColumn" | "dropColumn" | "dropColumns" | "renameColumn" | "modifyColumn" | "createIndex" | "dropIndex" | "createUniqueIndex" | "dropUniqueIndex" | "createFullTextIndex" | "dropFullTextIndex" | "createGeoIndex" | "dropGeoIndex" | "createVectorIndex" | "dropVectorIndex" | "createTTLIndex" | "dropTTLIndex" | "addForeignKey" | "dropForeignKey" | "addPrimaryKey" | "dropPrimaryKey" | "addCheck" | "dropCheck" | "createTable" | "createTableIfNotExists" | "dropTable" | "dropTableIfExists" | "renameTable" | "truncateTable" | "createTimestamps" | "rawStatement" | "dataStep" | "setSchemaValidation" | "removeSchemaValidation";
+export type OperationType = "addColumn" | "dropColumn" | "dropColumns" | "renameColumn" | "modifyColumn" | "createIndex" | "dropIndex" | "createUniqueIndex" | "dropUniqueIndex" | "createFullTextIndex" | "dropFullTextIndex" | "createGeoIndex" | "dropGeoIndex" | "createVectorIndex" | "dropVectorIndex" | "createTTLIndex" | "dropTTLIndex" | "addForeignKey" | "dropForeignKey" | "addPrimaryKey" | "dropPrimaryKey" | "addCheck" | "dropCheck" | "createTable" | "createTableIfNotExists" | "dropTable" | "dropTableIfExists" | "renameTable" | "truncateTable" | "createTimestamps" | "rawStatement" | "dataStep" | "setSchemaValidation" | "removeSchemaValidation";
 /**
  * One executable step of a migration, in authored order: a serialized SQL
  * statement, or a queued data step (`withConnection` callback).
  */
-type MigrationStep = string | {
+export type MigrationStep = string | {
   readonly data: () => Promise<unknown>;
 };
 /**
  * Pending operation to be executed when migration runs.
  */
-type PendingOperation = {
+export type PendingOperation = {
   readonly type: OperationType;
   readonly payload: unknown;
 };
 /**
  * Contract for a migration class.
  */
-interface MigrationContract {
+export interface MigrationContract {
   /**
    * Table/collection name for this migration.
    */
@@ -489,11 +488,11 @@ interface MigrationContract {
   vector(column: string, dimensions: number): ColumnBuilder;
 }
 /** The source that registered a migration with a runner. */
-type MigrationOrigin = "package" | "app";
+export type MigrationOrigin = "package" | "app";
 /**
  * Constructor for the migration class.
  */
-interface MigrationConstructor {
+export interface MigrationConstructor {
   new (): MigrationContract;
   migrationName?: string;
   createdAt?: string;
@@ -549,7 +548,7 @@ interface MigrationConstructor {
  * }
  * ```
  */
-declare abstract class Migration implements MigrationContract {
+export declare abstract class Migration implements MigrationContract {
   /**
    * Migration name that will be labeled with
    * If record is enabled in migration, it will be stored as migration name
@@ -1742,7 +1741,7 @@ declare abstract class Migration implements MigrationContract {
    */
   static alter: (model: ChildModel<Model<any>>, schema: AlterSchema, options?: MigrationAlterOptions) => MigrationConstructor;
 }
-declare function migrate(model: ChildModel<Model<any>>, options?: {
+export declare function migrate(model: ChildModel<Model<any>>, options?: {
   createdAt?: string;
   name?: string;
   up?: (this: MigrationContract) => void | Promise<void>;
@@ -1764,15 +1763,19 @@ declare function migrate(model: ChildModel<Model<any>>, options?: {
  * { columns: ["embedding"], using: "ivfflat" }
  * ```
  */
-type IndexEntry = {
-  /** Column(s) to include in the index. */columns: string | string[]; /** Optional explicit index name. Auto-generated when omitted. */
+export type IndexEntry = {
+  /** Column(s) to include in the index. */
+  columns: string | string[];
+  /** Optional explicit index name. Auto-generated when omitted. */
   name?: string;
   /**
    * Index access method (PostgreSQL).
    * Defaults to `"btree"` when omitted.
    */
-  using?: "btree" | "hash" | "gin" | "gist" | "brin" | "ivfflat" | "hnsw" | (string & {}); /** Extra columns to include in a covering index (PostgreSQL `INCLUDE`). */
-  include?: string[]; /** Build the index without locking the table (PostgreSQL). */
+  using?: "btree" | "hash" | "gin" | "gist" | "brin" | "ivfflat" | "hnsw" | (string & {});
+  /** Extra columns to include in a covering index (PostgreSQL `INCLUDE`). */
+  include?: string[];
+  /** Build the index without locking the table (PostgreSQL). */
   concurrently?: boolean;
 };
 /**
@@ -1787,16 +1790,20 @@ type IndexEntry = {
  * { columns: ["org_id", "content_id", "lang"], name: "uq_summary_idempotency" }
  * ```
  */
-type UniqueEntry = {
-  /** Column(s) that must be unique together. */columns: string | string[]; /** Optional explicit constraint name. Auto-generated when omitted. */
-  name?: string; /** Extra columns to include (PostgreSQL covering unique index). */
-  include?: string[]; /** Build the constraint without locking the table (PostgreSQL). */
+export type UniqueEntry = {
+  /** Column(s) that must be unique together. */
+  columns: string | string[];
+  /** Optional explicit constraint name. Auto-generated when omitted. */
+  name?: string;
+  /** Extra columns to include (PostgreSQL covering unique index). */
+  include?: string[];
+  /** Build the constraint without locking the table (PostgreSQL). */
   concurrently?: boolean;
 };
 /**
  * Options accepted by `Migration.create()`.
  */
-type MigrationCreateOptions = {
+export type MigrationCreateOptions = {
   /**
    * Sort order override.
    * @default 0
@@ -1902,13 +1909,16 @@ type MigrationCreateOptions = {
  * Keys become the column names; values are `DetachedColumnBuilder` instances
  * produced by the standalone column helpers (`uuid()`, `text()`, etc.).
  */
-type ColumnMap = Record<string, DetachedColumnBuilder>;
+export type ColumnMap = Record<string, DetachedColumnBuilder>;
 /**
  * Options accepted by `Migration.alter()`.
  */
-type MigrationAlterOptions = {
-  /** Sort order override. */order?: number; /** ISO timestamp override. */
-  createdAt?: string; /** Whether to wrap in a transaction. */
+export type MigrationAlterOptions = {
+  /** Sort order override. */
+  order?: number;
+  /** ISO timestamp override. */
+  createdAt?: string;
+  /** Whether to wrap in a transaction. */
   transactional?: boolean;
   /**
    * Custom logic to execute after the declarative definitions.
@@ -1944,10 +1954,14 @@ type MigrationAlterOptions = {
  * });
  * ```
  */
-type AlterSchema = {
-  /** Columns to add. Keys become column names. */add?: ColumnMap; /** Column names to drop. */
-  drop?: string[]; /** Rename map: `{ oldName: newName }`. */
-  rename?: Record<string, string>; /** Columns to modify. Keys become column names. */
+export type AlterSchema = {
+  /** Columns to add. Keys become column names. */
+  add?: ColumnMap;
+  /** Column names to drop. */
+  drop?: string[];
+  /** Rename map: `{ oldName: newName }`. */
+  rename?: Record<string, string>;
+  /** Columns to modify. Keys become column names. */
   modify?: ColumnMap;
   /**
    * Regular indexes to add.
@@ -2031,7 +2045,8 @@ type AlterSchema = {
   addFullText?: Array<{
     columns: string | string[];
     options?: FullTextIndexOptions;
-  }>; /** Full-text indexes to drop (by name). */
+  }>;
+  /** Full-text indexes to drop (by name). */
   dropFullText?: string[];
   /**
    * Geo-spatial indexes to add.
@@ -2044,7 +2059,8 @@ type AlterSchema = {
   addGeoIndex?: Array<{
     column: string;
     options?: GeoIndexOptions;
-  }>; /** Geo indexes to drop (by column name). */
+  }>;
+  /** Geo indexes to drop (by column name). */
   dropGeoIndex?: string[];
   /**
    * Vector search indexes to add.
@@ -2057,7 +2073,8 @@ type AlterSchema = {
   addVectorIndex?: Array<{
     column: string;
     options: VectorIndexOptions;
-  }>; /** Vector indexes to drop (by column name). */
+  }>;
+  /** Vector indexes to drop (by column name). */
   dropVectorIndex?: string[];
   /**
    * TTL indexes to add (MongoDB-primary).
@@ -2070,7 +2087,8 @@ type AlterSchema = {
   addTTLIndex?: Array<{
     column: string;
     expireAfterSeconds: number;
-  }>; /** TTL indexes to drop (by column name). */
+  }>;
+  /** TTL indexes to drop (by column name). */
   dropTTLIndex?: string[];
   /**
    * Foreign keys to add to existing columns.
@@ -2116,7 +2134,8 @@ type AlterSchema = {
   addCheck?: Array<{
     name: string;
     expression: string;
-  }>; /** CHECK constraints to drop (by name). */
+  }>;
+  /** CHECK constraints to drop (by name). */
   dropCheck?: string[];
   /**
    * Raw SQL queries to execute as part of this alter operation.
@@ -2124,5 +2143,4 @@ type AlterSchema = {
   raw?: string | string[];
 };
 //#endregion
-export { AlterSchema, ColumnMap, IndexEntry, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationOrigin, MigrationStep, OperationType, PendingOperation, UniqueEntry, migrate };
 //# sourceMappingURL=migration.d.mts.map