@ku6epxboctuk/sqlite-up 0.0.0-stage → 0.6.1

package/dist/index.js

@@ -0,0 +1,533 @@
+// src/index.ts
+import { EventEmitter } from "events";
+import { promises as fs } from "fs";
+import path from "path";
+import { pathToFileURL } from "url";
+
+// src/errors.ts
+var MigrationError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "MigrationError";
+  }
+};
+var MigrationFileError = class extends MigrationError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MigrationFileError";
+  }
+};
+var MigrationLockError = class extends MigrationError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MigrationLockError";
+  }
+};
+var MigrationExecutionError = class extends MigrationError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MigrationExecutionError";
+  }
+};
+
+// src/providers/manual-transaction.ts
+function createManualTransactionProvider(db) {
+  return {
+    db,
+    /**
+     * Runs the callback between BEGIN IMMEDIATE and COMMIT, rolling back on failure.
+     */
+    transaction: async (fn) => {
+      await db.exec("BEGIN IMMEDIATE");
+      try {
+        await fn();
+        await db.exec("COMMIT");
+      } catch (err) {
+        try {
+          await db.exec("ROLLBACK");
+        } catch {
+        }
+        throw err;
+      }
+    }
+  };
+}
+
+// src/providers/better-sqlite3.ts
+function isBetterSqlite3Database(db) {
+  const candidate = db;
+  return typeof candidate.exec === "function" && typeof candidate.prepare === "function" && typeof candidate.transaction === "function" && typeof candidate.open === "boolean";
+}
+function createBetterSqlite3Provider(db) {
+  return createManualTransactionProvider(db);
+}
+
+// src/providers/bun-sql.ts
+async function executeBunSql(client, sql, params = []) {
+  return await client.unsafe(sql, params.length > 0 ? params : void 0);
+}
+function isBunSqlDatabase(db) {
+  const candidate = db;
+  return typeof candidate.unsafe === "function" && typeof candidate.exec !== "function";
+}
+function createBunSqlProvider(rootClient) {
+  let activeClient = rootClient;
+  const db = {
+    /**
+     * Executes a SQL statement through the currently active Bun SQL client.
+     */
+    exec: async (sql) => {
+      await executeBunSql(activeClient, sql);
+    },
+    /**
+     * Creates a prepared-statement facade backed by Bun SQL unsafe execution.
+     */
+    prepare: (sql) => ({
+      /**
+       * Runs the statement and returns all rows.
+       */
+      all: (...params) => executeBunSql(activeClient, sql, params),
+      /**
+       * Runs the statement and returns the first row.
+       */
+      get: async (...params) => {
+        const rows = await executeBunSql(activeClient, sql, params);
+        return rows[0];
+      },
+      /**
+       * Runs the statement for side effects and returns the driver result.
+       */
+      run: (...params) => executeBunSql(activeClient, sql, params)
+    }),
+    /**
+     * Creates a transaction runner using Bun SQL native transactions when available.
+     */
+    transaction: (fn) => {
+      const run = async (...args) => {
+        if (typeof rootClient.begin === "function") {
+          return await rootClient.begin(async (tx) => {
+            const previousClient = activeClient;
+            activeClient = tx;
+            try {
+              return await fn(...args);
+            } finally {
+              activeClient = previousClient;
+            }
+          });
+        }
+        await db.exec("BEGIN");
+        try {
+          const result = await fn(...args);
+          await db.exec("COMMIT");
+          return result;
+        } catch (err) {
+          try {
+            await db.exec("ROLLBACK");
+          } catch {
+          }
+          throw err;
+        }
+      };
+      return run;
+    }
+  };
+  return {
+    db,
+    /**
+     * Runs migration work inside the Bun SQL transaction facade.
+     */
+    transaction: async (fn) => {
+      const transaction = db.transaction(fn);
+      await transaction();
+    }
+  };
+}
+
+// src/providers/bun-sqlite.ts
+function isBunSqliteDatabase(db) {
+  const candidate = db;
+  return typeof candidate.exec === "function" && typeof candidate.prepare === "function" && typeof candidate.query === "function";
+}
+function createBunSqliteProvider(db) {
+  return createManualTransactionProvider(db);
+}
+
+// src/providers/node-sqlite.ts
+function isNodeSqliteDatabase(db) {
+  const candidate = db;
+  return typeof candidate.exec === "function" && typeof candidate.prepare === "function" && typeof candidate.isOpen === "boolean";
+}
+function createNodeSqliteProvider(db) {
+  return createManualTransactionProvider(db);
+}
+
+// src/providers/index.ts
+function isSqliteDatabase(db) {
+  const candidate = db;
+  return typeof candidate.exec === "function" && typeof candidate.prepare === "function";
+}
+function createSqliteProvider(db) {
+  if (isBunSqlDatabase(db)) {
+    return createBunSqlProvider(db);
+  }
+  if (isBunSqliteDatabase(db)) {
+    return createBunSqliteProvider(db);
+  }
+  if (isBetterSqlite3Database(db)) {
+    return createBetterSqlite3Provider(db);
+  }
+  if (isNodeSqliteDatabase(db)) {
+    return createNodeSqliteProvider(db);
+  }
+  if (isSqliteDatabase(db)) {
+    return createManualTransactionProvider(db);
+  }
+  if (typeof db === "object" && db !== null) {
+    return createManualTransactionProvider(db);
+  }
+  throw new TypeError("Unsupported SQLite database provider.");
+}
+
+// src/index.ts
+var Migrator = class extends EventEmitter {
+  constructor(options) {
+    super();
+    /**
+     * Migration modules loaded from disk in execution order.
+     */
+    this.migrations = [];
+    /**
+     * Whether internal tables and migration files have already been initialized.
+     */
+    this.initialized = false;
+    this.provider = createSqliteProvider(options.db);
+    this.db = this.provider.db;
+    this.migrationsDir = options.migrationsDir;
+    this.migrationsTable = options.migrationsTable ?? "schema_migrations";
+    this.lockTable = options.migrationsLockTable ?? "schema_migrations_lock";
+    this.fileExtensions = options.fileExtensions ?? ["ts", "js"];
+  }
+  /**
+   * Ensures the `schema_migrations` and `schema_migrations_lock` tables exist,
+   * and loads migration files from the migrations directory.
+   */
+  async init() {
+    if (this.initialized) {
+      return;
+    }
+    await this.initTables();
+    await this.loadMigrationsFromDirectory();
+    this.initialized = true;
+  }
+  /**
+   * Initializes the `schema_migrations` and `schema_migrations_lock` tables.
+   */
+  async initTables() {
+    try {
+      await this.db.exec(`
+        CREATE TABLE IF NOT EXISTS ${this.migrationsTable} (
+          name TEXT PRIMARY KEY,
+          executed_at TEXT NOT NULL,   -- ISO string
+          batch INTEGER NOT NULL
+        )
+      `);
+      await this.db.exec(`
+        CREATE TABLE IF NOT EXISTS ${this.lockTable} (
+          id INTEGER PRIMARY KEY CHECK (id = 1),
+          locked INTEGER NOT NULL DEFAULT 0
+        )
+      `);
+      await this.db.exec(`
+        INSERT OR IGNORE INTO ${this.lockTable} (id, locked) VALUES (1, 0)
+      `);
+    } catch (err) {
+      throw new MigrationError("Failed to initialize migrator", err);
+    }
+  }
+  /**
+   * Load migration files from the `migrationsDir`.
+   * Migration files must export { up, down }.
+   * The migrations are loaded in alphabetical order.
+   */
+  async loadMigrationsFromDirectory() {
+    try {
+      const entries = await fs.readdir(this.migrationsDir);
+      const migrationFiles = entries.filter((file) => {
+        if (file.endsWith(".d.ts")) {
+          return false;
+        }
+        return this.fileExtensions.some((ext) => file.endsWith(`.${ext}`));
+      }).sort();
+      const loadedMigrations = [];
+      for (const file of migrationFiles) {
+        const fullPath = path.join(this.migrationsDir, file);
+        let imported;
+        try {
+          imported = await import(pathToFileURL(fullPath).href);
+        } catch (err) {
+          throw new MigrationFileError(`Error loading migration "${file}": ${String(err)}`, err);
+        }
+        const { up, down } = imported;
+        if (typeof up !== "function" || typeof down !== "function") {
+          throw new MigrationFileError(`Migration "${file}" must export "up" and "down" functions.`);
+        }
+        loadedMigrations.push({ name: file, up, down });
+      }
+      this.migrations = loadedMigrations;
+    } catch (err) {
+      throw err instanceof MigrationFileError ? err : new MigrationFileError("Failed to load migrations", err);
+    }
+  }
+  /**
+   * Acquire a lock to prevent concurrent migrations.
+   * Throws an error if the lock is already held.
+   */
+  async acquireLock() {
+    try {
+      await this.runTransaction(async () => {
+        const row = await this.db.prepare(`SELECT locked FROM ${this.lockTable} WHERE id = 1`).get();
+        if (row.locked === 1) {
+          throw new MigrationLockError("Migration lock already held by another process.");
+        }
+        await this.db.prepare(`UPDATE ${this.lockTable} SET locked = 1 WHERE id = 1`).run();
+      });
+    } catch (err) {
+      if (err instanceof MigrationLockError) {
+        throw err;
+      }
+      throw new MigrationLockError("Failed to acquire migration lock", err);
+    }
+  }
+  /**
+   * Release the migration lock.
+   */
+  async releaseLock() {
+    try {
+      await this.db.prepare(`UPDATE ${this.lockTable} SET locked = 0 WHERE id = 1`).run();
+    } catch (err) {
+      throw new MigrationLockError("Failed to release migration lock", err);
+    }
+  }
+  /**
+   * Get the highest batch number.
+   */
+  async getCurrentBatch() {
+    const row = await this.db.prepare(`SELECT MAX(batch) as batch FROM ${this.migrationsTable}`).get();
+    return row?.batch ?? 0;
+  }
+  /**
+   * Insert a record for an applied migration.
+   */
+  async recordMigration(name, batch) {
+    const executedAt = (/* @__PURE__ */ new Date()).toISOString();
+    await this.db.prepare(
+      `
+        INSERT INTO ${this.migrationsTable} (name, executed_at, batch)
+        VALUES (?, ?, ?)
+      `
+    ).run(name, executedAt, batch);
+  }
+  /**
+   * Delete a record for a migration that is being rolled back.
+   */
+  async removeMigration(name, batch) {
+    await this.db.prepare(
+      `
+        DELETE FROM ${this.migrationsTable}
+        WHERE name = ? AND batch = ?
+      `
+    ).run(name, batch);
+  }
+  /**
+   * Run SQL operations in a transaction.
+   * @param fn The function to run in the transaction.
+   */
+  async runTransaction(fn) {
+    await this.provider.transaction(fn);
+  }
+  /**
+   * Apply all pending migrations in a single batch.
+   * Returns the names of applied migrations.
+   */
+  async apply(...args) {
+    try {
+      await this.init();
+    } catch (err) {
+      return {
+        success: false,
+        error: err,
+        appliedMigrations: []
+      };
+    }
+    try {
+      await this.acquireLock();
+    } catch (err) {
+      return {
+        success: false,
+        error: err,
+        appliedMigrations: []
+      };
+    }
+    const appliedMigrations = [];
+    try {
+      const currentBatch = await this.getCurrentBatch();
+      const nextBatch = currentBatch + 1;
+      const appliedNames = new Set(
+        (await this.db.prepare(`SELECT name FROM ${this.migrationsTable}`).all()).map(
+          (row) => row.name
+        )
+      );
+      const pendingMigrations = this.migrations.filter((m) => !appliedNames.has(m.name));
+      if (pendingMigrations.length === 0) {
+        return { success: true, appliedMigrations };
+      }
+      await this.runTransaction(async () => {
+        for (const migration of pendingMigrations) {
+          try {
+            await migration.up(this.db, ...args);
+            await this.recordMigration(migration.name, nextBatch);
+            appliedMigrations.push(migration.name);
+          } catch (err) {
+            throw new MigrationExecutionError(`Failed to apply migration "${migration.name}"`, err);
+          }
+        }
+      });
+      for (const migrationName of appliedMigrations) {
+        this.emit("migration:applied", migrationName, nextBatch);
+      }
+      return { success: true, appliedMigrations };
+    } catch (error) {
+      const err = error instanceof MigrationExecutionError ? error : new MigrationExecutionError("Migration failed", error);
+      return { success: false, error: err, appliedMigrations: [] };
+    } finally {
+      await this.releaseLock();
+    }
+  }
+  /**
+   * Roll back the most recent batch of migrations.
+   * Returns the names of rolled back migrations.
+   */
+  async rollback(...args) {
+    try {
+      await this.init();
+    } catch (err) {
+      return {
+        success: false,
+        error: err,
+        appliedMigrations: []
+      };
+    }
+    try {
+      await this.acquireLock();
+    } catch (err) {
+      return {
+        success: false,
+        error: err,
+        appliedMigrations: []
+      };
+    }
+    const appliedMigrations = [];
+    try {
+      const currentBatch = await this.getCurrentBatch();
+      if (currentBatch === 0) {
+        return { success: true, appliedMigrations };
+      }
+      const rows = await this.db.prepare(
+        `
+          SELECT name
+          FROM ${this.migrationsTable}
+          WHERE batch = ?
+          ORDER BY name DESC
+        `
+      ).all(currentBatch);
+      if (rows.length === 0) {
+        return { success: true, appliedMigrations };
+      }
+      await this.runTransaction(async () => {
+        for (const row of rows) {
+          const migration = this.migrations.find((m) => m.name === row.name);
+          if (!migration) {
+            throw new MigrationFileError(`Migration "${row.name}" not found.`);
+          }
+          try {
+            await migration.down(this.db, ...args);
+            await this.removeMigration(migration.name, currentBatch);
+            appliedMigrations.push(migration.name);
+          } catch (err) {
+            throw new MigrationExecutionError(`Failed to rollback migration "${migration.name}"`, err);
+          }
+        }
+      });
+      for (const migrationName of appliedMigrations) {
+        this.emit("migration:rollback", migrationName, currentBatch);
+      }
+      return { success: true, appliedMigrations };
+    } catch (error) {
+      const err = error instanceof MigrationExecutionError ? error : new MigrationExecutionError("Rollback failed", error);
+      return { success: false, error: err, appliedMigrations: [] };
+    } finally {
+      await this.releaseLock();
+    }
+  }
+  /**
+   * Get the status of migrations.
+   * Returns:
+   * - currentBatch: the highest batch number applied
+   * - pending: number of migrations not yet applied
+   * - applied: list of all applied migrations
+   */
+  async status() {
+    await this.init();
+    try {
+      const currentBatch = await this.getCurrentBatch();
+      const rows = await this.db.prepare(
+        `
+          SELECT name, executed_at, batch
+          FROM ${this.migrationsTable}
+          ORDER BY batch ASC, name ASC
+        `
+      ).all();
+      const appliedNames = new Set(rows.map((r) => r.name));
+      const pending = this.migrations.length - appliedNames.size;
+      return {
+        currentBatch,
+        pending,
+        applied: rows
+      };
+    } catch (err) {
+      throw new MigrationError("Failed to get migration status", err);
+    }
+  }
+  /**
+   * Plan the pending migrations without applying them.
+   * Returns the next batch number and the list of pending migration names in order.
+   */
+  async plan() {
+    await this.init();
+    try {
+      const currentBatch = await this.getCurrentBatch();
+      const nextBatch = currentBatch + 1;
+      const appliedNames = new Set(
+        (await this.db.prepare(`SELECT name FROM ${this.migrationsTable}`).all()).map(
+          (row) => row.name
+        )
+      );
+      const pendingMigrations = this.migrations.filter((m) => !appliedNames.has(m.name)).map((m) => m.name);
+      return {
+        nextBatch,
+        pendingMigrations
+      };
+    } catch (err) {
+      throw new MigrationError("Failed to create migration plan", err);
+    }
+  }
+};
+export {
+  MigrationError,
+  MigrationExecutionError,
+  MigrationFileError,
+  MigrationLockError,
+  Migrator
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/providers/manual-transaction.ts","../src/providers/better-sqlite3.ts","../src/providers/bun-sql.ts","../src/providers/bun-sqlite.ts","../src/providers/node-sqlite.ts","../src/providers/index.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { MigrationError, MigrationExecutionError, MigrationFileError, MigrationLockError } from './errors.js';\nimport { createSqliteProvider, type SqliteProvider } from './providers/index.js';\nimport type {\n  ContextArg,\n  MaybePromise,\n  Migration,\n  MigrationPlan,\n  MigrationRecord,\n  MigrationResult,\n  MigrationStatus,\n  MigratorOptions,\n  SqliteDatabase,\n} from './types.js';\n\n/**\n * Migration provider for SQLite databases.\n * @example\n * const db = new DatabaseSync('database.db');\n * const migrator = new Migrator({ db, migrationsDir: 'migrations' });\n * await migrator.apply();\n */\nexport class Migrator<T = undefined> extends EventEmitter {\n  /**\n   * Driver-specific provider normalized to the sqlite-up database surface.\n   */\n  private provider: SqliteProvider;\n\n  /**\n   * Database handle used by migrations and internal bookkeeping queries.\n   */\n  private db: SqliteDatabase;\n\n  /**\n   * Directory where migration modules are loaded from.\n   */\n  private migrationsDir: string;\n\n  /**\n   * Table that records successfully applied migrations.\n   */\n  private migrationsTable: string;\n\n  /**\n   * Table that stores the single-row migration lock.\n   */\n  private lockTable: string;\n\n  /**\n   * Migration modules loaded from disk in execution order.\n   */\n  private migrations: Migration<T>[] = [];\n\n  /**\n   * Whether internal tables and migration files have already been initialized.\n   */\n  private initialized = false;\n\n  /**\n   * File extensions considered when loading migration modules.\n   */\n  private fileExtensions: string[];\n\n  constructor(options: MigratorOptions) {\n    super();\n\n    this.provider = createSqliteProvider(options.db);\n    this.db = this.provider.db;\n    this.migrationsDir = options.migrationsDir;\n    this.migrationsTable = options.migrationsTable ?? 'schema_migrations';\n    this.lockTable = options.migrationsLockTable ?? 'schema_migrations_lock';\n    this.fileExtensions = options.fileExtensions ?? ['ts', 'js'];\n  }\n\n  /**\n   * Ensures the `schema_migrations` and `schema_migrations_lock` tables exist,\n   * and loads migration files from the migrations directory.\n   */\n  private async init(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    await this.initTables();\n    await this.loadMigrationsFromDirectory();\n\n    this.initialized = true;\n  }\n\n  /**\n   * Initializes the `schema_migrations` and `schema_migrations_lock` tables.\n   */\n  private async initTables(): Promise<void> {\n    try {\n      // Create the migrations table if it doesn't exist\n      await this.db.exec(`\n        CREATE TABLE IF NOT EXISTS ${this.migrationsTable} (\n          name TEXT PRIMARY KEY,\n          executed_at TEXT NOT NULL,   -- ISO string\n          batch INTEGER NOT NULL\n        )\n      `);\n\n      // Create the lock table if it doesn't exist\n      await this.db.exec(`\n        CREATE TABLE IF NOT EXISTS ${this.lockTable} (\n          id INTEGER PRIMARY KEY CHECK (id = 1),\n          locked INTEGER NOT NULL DEFAULT 0\n        )\n      `);\n\n      // Ensure exactly one row in the lock table (id=1)\n      await this.db.exec(`\n        INSERT OR IGNORE INTO ${this.lockTable} (id, locked) VALUES (1, 0)\n      `);\n\n      // Load all migration files\n    } catch (err) {\n      throw new MigrationError('Failed to initialize migrator', err as Error);\n    }\n  }\n\n  /**\n   * Load migration files from the `migrationsDir`.\n   * Migration files must export { up, down }.\n   * The migrations are loaded in alphabetical order.\n   */\n  private async loadMigrationsFromDirectory(): Promise<void> {\n    try {\n      const entries = await fs.readdir(this.migrationsDir);\n      // Filter and sort migration files alphabetically\n      const migrationFiles = entries\n        .filter((file) => {\n          // Ignore .d.ts files\n          if (file.endsWith('.d.ts')) {\n            return false;\n          }\n          // Check if file has one of the allowed extensions\n          return this.fileExtensions.some((ext) => file.endsWith(`.${ext}`));\n        })\n        .sort();\n\n      const loadedMigrations: Migration<T>[] = [];\n      for (const file of migrationFiles) {\n        const fullPath = path.join(this.migrationsDir, file);\n\n        let imported: {\n          up: Migration<T>['up'];\n          down: Migration<T>['down'];\n        };\n\n        try {\n          imported = await import(pathToFileURL(fullPath).href);\n        } catch (err) {\n          throw new MigrationFileError(`Error loading migration \"${file}\": ${String(err)}`, err as Error);\n        }\n\n        const { up, down } = imported;\n        if (typeof up !== 'function' || typeof down !== 'function') {\n          throw new MigrationFileError(`Migration \"${file}\" must export \"up\" and \"down\" functions.`);\n        }\n\n        loadedMigrations.push({ name: file, up, down });\n      }\n\n      // Only update migrations array after all files are loaded successfully\n      this.migrations = loadedMigrations;\n    } catch (err) {\n      throw err instanceof MigrationFileError ? err : new MigrationFileError('Failed to load migrations', err as Error);\n    }\n  }\n\n  /**\n   * Acquire a lock to prevent concurrent migrations.\n   * Throws an error if the lock is already held.\n   */\n  private async acquireLock(): Promise<void> {\n    try {\n      await this.runTransaction(async () => {\n        const row = (await this.db.prepare(`SELECT locked FROM ${this.lockTable} WHERE id = 1`).get()) as {\n          locked: number;\n        };\n\n        if (row.locked === 1) {\n          throw new MigrationLockError('Migration lock already held by another process.');\n        }\n\n        await this.db.prepare(`UPDATE ${this.lockTable} SET locked = 1 WHERE id = 1`).run();\n      });\n    } catch (err) {\n      if (err instanceof MigrationLockError) {\n        throw err;\n      }\n\n      throw new MigrationLockError('Failed to acquire migration lock', err as Error);\n    }\n  }\n\n  /**\n   * Release the migration lock.\n   */\n  private async releaseLock(): Promise<void> {\n    try {\n      await this.db.prepare(`UPDATE ${this.lockTable} SET locked = 0 WHERE id = 1`).run();\n    } catch (err) {\n      throw new MigrationLockError('Failed to release migration lock', err as Error);\n    }\n  }\n\n  /**\n   * Get the highest batch number.\n   */\n  private async getCurrentBatch(): Promise<number> {\n    const row = (await this.db.prepare(`SELECT MAX(batch) as batch FROM ${this.migrationsTable}`).get()) as {\n      batch: number | null;\n    };\n    return row?.batch ?? 0;\n  }\n\n  /**\n   * Insert a record for an applied migration.\n   */\n  private async recordMigration(name: string, batch: number): Promise<void> {\n    const executedAt = new Date().toISOString();\n    await this.db\n      .prepare(\n        `\n        INSERT INTO ${this.migrationsTable} (name, executed_at, batch)\n        VALUES (?, ?, ?)\n      `\n      )\n      .run(name, executedAt, batch);\n  }\n\n  /**\n   * Delete a record for a migration that is being rolled back.\n   */\n  private async removeMigration(name: string, batch: number): Promise<void> {\n    await this.db\n      .prepare(\n        `\n        DELETE FROM ${this.migrationsTable}\n        WHERE name = ? AND batch = ?\n      `\n      )\n      .run(name, batch);\n  }\n\n  /**\n   * Run SQL operations in a transaction.\n   * @param fn The function to run in the transaction.\n   */\n  private async runTransaction(fn: () => MaybePromise<void>): Promise<void> {\n    await this.provider.transaction(fn);\n  }\n\n  /**\n   * Apply all pending migrations in a single batch.\n   * Returns the names of applied migrations.\n   */\n  async apply(...args: ContextArg<T>): Promise<MigrationResult> {\n    // Initialize the migrator\n    try {\n      await this.init();\n    } catch (err) {\n      return {\n        success: false,\n        error: err as Error,\n        appliedMigrations: [],\n      };\n    }\n\n    // Acquire lock\n    try {\n      await this.acquireLock();\n    } catch (err) {\n      return {\n        success: false,\n        error: err as Error,\n        appliedMigrations: [],\n      };\n    }\n\n    const appliedMigrations: string[] = [];\n    try {\n      const currentBatch = await this.getCurrentBatch();\n      const nextBatch = currentBatch + 1;\n\n      // Determine pending migrations: not present in schema_migrations\n      const appliedNames = new Set(\n        (await this.db.prepare(`SELECT name FROM ${this.migrationsTable}`).all()).map(\n          (row) => (row as { name: string }).name\n        )\n      );\n\n      // Get pending migrations, if any\n      const pendingMigrations = this.migrations.filter((m) => !appliedNames.has(m.name));\n      if (pendingMigrations.length === 0) {\n        return { success: true, appliedMigrations };\n      }\n\n      // Perform the migration\n      await this.runTransaction(async () => {\n        for (const migration of pendingMigrations) {\n          try {\n            // Apply migration\n            await migration.up(this.db, ...args);\n\n            // Record migration\n            await this.recordMigration(migration.name, nextBatch);\n            appliedMigrations.push(migration.name);\n          } catch (err) {\n            throw new MigrationExecutionError(`Failed to apply migration \"${migration.name}\"`, err as Error);\n          }\n        }\n      });\n\n      for (const migrationName of appliedMigrations) {\n        this.emit('migration:applied', migrationName, nextBatch);\n      }\n\n      return { success: true, appliedMigrations };\n    } catch (error) {\n      const err =\n        error instanceof MigrationExecutionError\n          ? error\n          : new MigrationExecutionError('Migration failed', error as Error);\n      return { success: false, error: err, appliedMigrations: [] };\n    } finally {\n      await this.releaseLock();\n    }\n  }\n\n  /**\n   * Roll back the most recent batch of migrations.\n   * Returns the names of rolled back migrations.\n   */\n  async rollback(...args: ContextArg<T>): Promise<MigrationResult> {\n    // Initialize the migrator\n    try {\n      await this.init();\n    } catch (err) {\n      return {\n        success: false,\n        error: err as Error,\n        appliedMigrations: [],\n      };\n    }\n\n    // Acquire lock\n    try {\n      await this.acquireLock();\n    } catch (err) {\n      return {\n        success: false,\n        error: err as Error,\n        appliedMigrations: [],\n      };\n    }\n\n    const appliedMigrations: string[] = [];\n    try {\n      // Check if there are migrations to rollback\n      const currentBatch = await this.getCurrentBatch();\n      if (currentBatch === 0) {\n        return { success: true, appliedMigrations };\n      }\n\n      // Get migrations in the last batch, sorted descending\n      const rows = (await this.db\n        .prepare(\n          `\n          SELECT name\n          FROM ${this.migrationsTable}\n          WHERE batch = ?\n          ORDER BY name DESC\n        `\n        )\n        .all(currentBatch)) as { name: string }[];\n\n      // No migrations found in the last batch\n      if (rows.length === 0) {\n        return { success: true, appliedMigrations };\n      }\n\n      // Perform the rollback\n      await this.runTransaction(async () => {\n        for (const row of rows) {\n          const migration = this.migrations.find((m) => m.name === row.name);\n          if (!migration) {\n            throw new MigrationFileError(`Migration \"${row.name}\" not found.`);\n          }\n\n          try {\n            // Revert migration\n            await migration.down(this.db, ...args);\n\n            // Remove migration record\n            await this.removeMigration(migration.name, currentBatch);\n\n            appliedMigrations.push(migration.name);\n          } catch (err) {\n            throw new MigrationExecutionError(`Failed to rollback migration \"${migration.name}\"`, err as Error);\n          }\n        }\n      });\n\n      for (const migrationName of appliedMigrations) {\n        this.emit('migration:rollback', migrationName, currentBatch);\n      }\n\n      return { success: true, appliedMigrations };\n    } catch (error) {\n      const err =\n        error instanceof MigrationExecutionError\n          ? error\n          : new MigrationExecutionError('Rollback failed', error as Error);\n      return { success: false, error: err, appliedMigrations: [] };\n    } finally {\n      await this.releaseLock();\n    }\n  }\n\n  /**\n   * Get the status of migrations.\n   * Returns:\n   * - currentBatch: the highest batch number applied\n   * - pending: number of migrations not yet applied\n   * - applied: list of all applied migrations\n   */\n  async status(): Promise<MigrationStatus> {\n    await this.init();\n\n    try {\n      const currentBatch = await this.getCurrentBatch();\n\n      // Get all applied migrations\n      const rows = (await this.db\n        .prepare(\n          `\n          SELECT name, executed_at, batch\n          FROM ${this.migrationsTable}\n          ORDER BY batch ASC, name ASC\n        `\n        )\n        .all()) as MigrationRecord[];\n\n      // Determine pending migrations\n      const appliedNames = new Set(rows.map((r) => r.name));\n      const pending = this.migrations.length - appliedNames.size;\n\n      return {\n        currentBatch,\n        pending,\n        applied: rows,\n      };\n    } catch (err) {\n      throw new MigrationError('Failed to get migration status', err as Error);\n    }\n  }\n\n  /**\n   * Plan the pending migrations without applying them.\n   * Returns the next batch number and the list of pending migration names in order.\n   */\n  async plan(): Promise<MigrationPlan> {\n    await this.init();\n\n    try {\n      const currentBatch = await this.getCurrentBatch();\n      const nextBatch = currentBatch + 1;\n\n      // Determine pending migrations: not present in schema_migrations\n      const appliedNames = new Set(\n        (await this.db.prepare(`SELECT name FROM ${this.migrationsTable}`).all()).map(\n          (row) => (row as { name: string }).name\n        )\n      );\n\n      const pendingMigrations = this.migrations.filter((m) => !appliedNames.has(m.name)).map((m) => m.name);\n\n      return {\n        nextBatch,\n        pendingMigrations,\n      };\n    } catch (err) {\n      throw new MigrationError('Failed to create migration plan', err as Error);\n    }\n  }\n}\n\nexport {\n  MigrationError,\n  MigrationExecutionError,\n  MigrationFileError,\n  MigrationLockError,\n} from './errors.js';\nexport type {\n  BunSqliteDatabase,\n  ContextArg,\n  MaybePromise,\n  Migration,\n  MigrationPlan,\n  MigrationRecord,\n  MigrationResult,\n  MigrationStatus,\n  MigratorDatabase,\n  MigratorOptions,\n  SqliteDatabase,\n  SqliteRunResult,\n  SqliteStatement,\n  SqliteTransaction,\n} from './types.js';\n","/**\n * Base error class for all sqlite-up errors\n */\nexport class MigrationError extends Error {\n  constructor(\n    message: string,\n    public readonly cause?: Error\n  ) {\n    super(message);\n    this.name = 'MigrationError';\n  }\n}\n\n/**\n * Thrown when there's an issue with migration files\n */\nexport class MigrationFileError extends MigrationError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MigrationFileError';\n  }\n}\n\n/**\n * Thrown when there's a locking issue\n */\nexport class MigrationLockError extends MigrationError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MigrationLockError';\n  }\n}\n\n/**\n * Thrown when there's an issue during migration execution\n */\nexport class MigrationExecutionError extends MigrationError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MigrationExecutionError';\n  }\n}\n","import type { MaybePromise, SqliteDatabase } from '../types.js';\nimport type { SqliteProvider } from './types.js';\n\n/**\n * Creates a provider that wraps migration work in explicit SQL transactions.\n */\nexport function createManualTransactionProvider(db: SqliteDatabase): SqliteProvider {\n  return {\n    db,\n\n    /**\n     * Runs the callback between BEGIN IMMEDIATE and COMMIT, rolling back on failure.\n     */\n    transaction: async (fn: () => MaybePromise<void>): Promise<void> => {\n      await db.exec('BEGIN IMMEDIATE');\n      try {\n        await fn();\n        await db.exec('COMMIT');\n      } catch (err) {\n        try {\n          await db.exec('ROLLBACK');\n        } catch {\n          // Preserve the original transaction failure.\n        }\n        throw err;\n      }\n    },\n  };\n}\n","import type { SqliteDatabase } from '../types.js';\nimport { createManualTransactionProvider } from './manual-transaction.js';\nimport type { SqliteProvider } from './types.js';\n\n/**\n * Structural database shape used to identify better-sqlite3 connections.\n */\nexport type BetterSqlite3Database = SqliteDatabase & {\n  transaction?: unknown;\n  open?: boolean;\n};\n\n/**\n * Checks whether a value looks like a better-sqlite3 database instance.\n */\nexport function isBetterSqlite3Database(db: unknown): db is BetterSqlite3Database {\n  const candidate = db as Partial<BetterSqlite3Database>;\n  return (\n    typeof candidate.exec === 'function' &&\n    typeof candidate.prepare === 'function' &&\n    typeof candidate.transaction === 'function' &&\n    typeof candidate.open === 'boolean'\n  );\n}\n\n/**\n * Creates a sqlite-up provider for better-sqlite3 database instances.\n */\nexport function createBetterSqlite3Provider(db: BetterSqlite3Database): SqliteProvider {\n  return createManualTransactionProvider(db);\n}\n","import type { BunSqliteDatabase, MaybePromise, SqliteDatabase, SqliteTransaction } from '../types.js';\nimport type { SqliteProvider } from './types.js';\n\n/**\n * SQLite database facade whose transactions may complete asynchronously.\n */\ninterface AsyncTransactionalSqliteDatabase extends SqliteDatabase {\n  /**\n   * Creates a transaction runner that can await asynchronous transaction work.\n   */\n  transaction<Args extends unknown[], Result>(\n    fn: (...args: Args) => MaybePromise<Result>\n  ): SqliteTransaction<Args, Result>;\n}\n\n/**\n * Executes SQL through Bun SQL and normalizes empty parameter lists.\n */\nasync function executeBunSql(client: BunSqliteDatabase, sql: string, params: unknown[] = []): Promise<unknown[]> {\n  return await client.unsafe(sql, params.length > 0 ? params : undefined);\n}\n\n/**\n * Checks whether a value looks like Bun's Promise-based SQL client for SQLite.\n */\nexport function isBunSqlDatabase(db: unknown): db is BunSqliteDatabase {\n  const candidate = db as Partial<BunSqliteDatabase>;\n  return typeof candidate.unsafe === 'function' && typeof (candidate as Partial<SqliteDatabase>).exec !== 'function';\n}\n\n/**\n * Creates a sqlite-up provider for Bun SQL SQLite clients.\n */\nexport function createBunSqlProvider(rootClient: BunSqliteDatabase): SqliteProvider {\n  let activeClient = rootClient;\n\n  const db: AsyncTransactionalSqliteDatabase = {\n    /**\n     * Executes a SQL statement through the currently active Bun SQL client.\n     */\n    exec: async (sql: string) => {\n      await executeBunSql(activeClient, sql);\n    },\n\n    /**\n     * Creates a prepared-statement facade backed by Bun SQL unsafe execution.\n     */\n    prepare: (sql: string) => ({\n      /**\n       * Runs the statement and returns all rows.\n       */\n      all: (...params: unknown[]) => executeBunSql(activeClient, sql, params),\n\n      /**\n       * Runs the statement and returns the first row.\n       */\n      get: async (...params: unknown[]) => {\n        const rows = await executeBunSql(activeClient, sql, params);\n        return rows[0];\n      },\n\n      /**\n       * Runs the statement for side effects and returns the driver result.\n       */\n      run: (...params: unknown[]) => executeBunSql(activeClient, sql, params),\n    }),\n\n    /**\n     * Creates a transaction runner using Bun SQL native transactions when available.\n     */\n    transaction: <Args extends unknown[], Result>(fn: (...args: Args) => MaybePromise<Result>) => {\n      /**\n       * Executes the transaction callback with the active transaction client.\n       */\n      const run = async (...args: Args): Promise<Result> => {\n        if (typeof rootClient.begin === 'function') {\n          return await rootClient.begin(async (tx) => {\n            const previousClient = activeClient;\n            activeClient = tx;\n\n            try {\n              return await fn(...args);\n            } finally {\n              activeClient = previousClient;\n            }\n          });\n        }\n\n        await db.exec('BEGIN');\n        try {\n          const result = await fn(...args);\n          await db.exec('COMMIT');\n          return result;\n        } catch (err) {\n          try {\n            await db.exec('ROLLBACK');\n          } catch {\n            // Preserve the original transaction failure.\n          }\n          throw err;\n        }\n      };\n\n      return run;\n    },\n  };\n\n  return {\n    db,\n\n    /**\n     * Runs migration work inside the Bun SQL transaction facade.\n     */\n    transaction: async (fn: () => MaybePromise<void>) => {\n      const transaction = db.transaction(fn);\n      await transaction();\n    },\n  };\n}\n","import type { SqliteDatabase, SqliteStatement } from '../types.js';\nimport { createManualTransactionProvider } from './manual-transaction.js';\nimport type { SqliteProvider } from './types.js';\n\n/**\n * Structural database shape used to identify Bun's synchronous SQLite client.\n */\nexport type BunSqliteSyncDatabase = SqliteDatabase & {\n  query?: (sql: string) => SqliteStatement;\n};\n\n/**\n * Checks whether a value looks like a Bun SQLite database instance.\n */\nexport function isBunSqliteDatabase(db: unknown): db is BunSqliteSyncDatabase {\n  const candidate = db as Partial<BunSqliteSyncDatabase>;\n  return (\n    typeof candidate.exec === 'function' &&\n    typeof candidate.prepare === 'function' &&\n    typeof candidate.query === 'function'\n  );\n}\n\n/**\n * Creates a sqlite-up provider for Bun SQLite database instances.\n */\nexport function createBunSqliteProvider(db: BunSqliteSyncDatabase): SqliteProvider {\n  return createManualTransactionProvider(db);\n}\n","import type { SqliteDatabase } from '../types.js';\nimport { createManualTransactionProvider } from './manual-transaction.js';\nimport type { SqliteProvider } from './types.js';\n\n/**\n * Structural database shape used to identify Node's node:sqlite DatabaseSync.\n */\nexport type NodeSqliteDatabase = SqliteDatabase & {\n  isOpen?: boolean;\n};\n\n/**\n * Checks whether a value looks like a node:sqlite database instance.\n */\nexport function isNodeSqliteDatabase(db: unknown): db is NodeSqliteDatabase {\n  const candidate = db as Partial<NodeSqliteDatabase>;\n  return (\n    typeof candidate.exec === 'function' &&\n    typeof candidate.prepare === 'function' &&\n    typeof candidate.isOpen === 'boolean'\n  );\n}\n\n/**\n * Creates a sqlite-up provider for node:sqlite database instances.\n */\nexport function createNodeSqliteProvider(db: NodeSqliteDatabase): SqliteProvider {\n  return createManualTransactionProvider(db);\n}\n","import type { MigratorDatabase, SqliteDatabase } from '../types.js';\nimport { createBetterSqlite3Provider, isBetterSqlite3Database } from './better-sqlite3.js';\nimport { createBunSqlProvider, isBunSqlDatabase } from './bun-sql.js';\nimport { createBunSqliteProvider, isBunSqliteDatabase } from './bun-sqlite.js';\nimport { createManualTransactionProvider } from './manual-transaction.js';\nimport { createNodeSqliteProvider, isNodeSqliteDatabase } from './node-sqlite.js';\nimport type { SqliteProvider } from './types.js';\n\n/**\n * Checks for the minimal SQLite database surface sqlite-up can use directly.\n */\nfunction isSqliteDatabase(db: unknown): db is SqliteDatabase {\n  const candidate = db as Partial<SqliteDatabase>;\n  return typeof candidate.exec === 'function' && typeof candidate.prepare === 'function';\n}\n\n/**\n * Creates the best provider adapter for a supported SQLite database client.\n */\nexport function createSqliteProvider(db: MigratorDatabase): SqliteProvider {\n  if (isBunSqlDatabase(db)) {\n    return createBunSqlProvider(db);\n  }\n\n  if (isBunSqliteDatabase(db)) {\n    return createBunSqliteProvider(db);\n  }\n\n  if (isBetterSqlite3Database(db)) {\n    return createBetterSqlite3Provider(db);\n  }\n\n  if (isNodeSqliteDatabase(db)) {\n    return createNodeSqliteProvider(db);\n  }\n\n  if (isSqliteDatabase(db)) {\n    return createManualTransactionProvider(db);\n  }\n\n  if (typeof db === 'object' && db !== null) {\n    return createManualTransactionProvider(db as SqliteDatabase);\n  }\n\n  throw new TypeError('Unsupported SQLite database provider.');\n}\n\nexport { createBetterSqlite3Provider, isBetterSqlite3Database } from './better-sqlite3.js';\nexport { createBunSqlProvider, isBunSqlDatabase } from './bun-sql.js';\nexport { createBunSqliteProvider, isBunSqliteDatabase } from './bun-sqlite.js';\nexport { createNodeSqliteProvider, isNodeSqliteDatabase } from './node-sqlite.js';\nexport type { SqliteProvider } from './types.js';\n"],"mappings":"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","names":[]}

package/dist/providers/better-sqlite3.d.ts

@@ -0,0 +1,18 @@
+import type { SqliteDatabase } from '../types.js';
+import type { SqliteProvider } from './types.js';
+/**
+ * Structural database shape used to identify better-sqlite3 connections.
+ */
+export type BetterSqlite3Database = SqliteDatabase & {
+    transaction?: unknown;
+    open?: boolean;
+};
+/**
+ * Checks whether a value looks like a better-sqlite3 database instance.
+ */
+export declare function isBetterSqlite3Database(db: unknown): db is BetterSqlite3Database;
+/**
+ * Creates a sqlite-up provider for better-sqlite3 database instances.
+ */
+export declare function createBetterSqlite3Provider(db: BetterSqlite3Database): SqliteProvider;
+//# sourceMappingURL=better-sqlite3.d.ts.map

package/dist/providers/better-sqlite3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-sqlite3.d.ts","sourceRoot":"","sources":["../../src/providers/better-sqlite3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,qBAAqB,CAQhF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,qBAAqB,GAAG,cAAc,CAErF"}

package/dist/providers/bun-sql.d.ts

@@ -0,0 +1,11 @@
+import type { BunSqliteDatabase } from '../types.js';
+import type { SqliteProvider } from './types.js';
+/**
+ * Checks whether a value looks like Bun's Promise-based SQL client for SQLite.
+ */
+export declare function isBunSqlDatabase(db: unknown): db is BunSqliteDatabase;
+/**
+ * Creates a sqlite-up provider for Bun SQL SQLite clients.
+ */
+export declare function createBunSqlProvider(rootClient: BunSqliteDatabase): SqliteProvider;
+//# sourceMappingURL=bun-sql.d.ts.map

package/dist/providers/bun-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-sql.d.ts","sourceRoot":"","sources":["../../src/providers/bun-sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAmD,MAAM,aAAa,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,iBAAiB,CAGrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,GAAG,cAAc,CAqFlF"}

package/dist/providers/bun-sqlite.d.ts

@@ -0,0 +1,17 @@
+import type { SqliteDatabase, SqliteStatement } from '../types.js';
+import type { SqliteProvider } from './types.js';
+/**
+ * Structural database shape used to identify Bun's synchronous SQLite client.
+ */
+export type BunSqliteSyncDatabase = SqliteDatabase & {
+    query?: (sql: string) => SqliteStatement;
+};
+/**
+ * Checks whether a value looks like a Bun SQLite database instance.
+ */
+export declare function isBunSqliteDatabase(db: unknown): db is BunSqliteSyncDatabase;
+/**
+ * Creates a sqlite-up provider for Bun SQLite database instances.
+ */
+export declare function createBunSqliteProvider(db: BunSqliteSyncDatabase): SqliteProvider;
+//# sourceMappingURL=bun-sqlite.d.ts.map

package/dist/providers/bun-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-sqlite.d.ts","sourceRoot":"","sources":["../../src/providers/bun-sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;CAC1C,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,qBAAqB,CAO5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,qBAAqB,GAAG,cAAc,CAEjF"}