@prairielearn/migrations 1.1.0 → 1.2.0

package/dist/batched-migrations/batched-migrations-runner.js

@@ -0,0 +1,273 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.finalizeBatchedMigration = exports.enqueueBatchedMigration = exports.stopBatchedMigrations = exports.startBatchedMigrations = exports.initBatchedMigrations = exports.BatchedMigrationsRunner = void 0;
+const node_events_1 = __importDefault(require("node:events"));
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:timers/promises");
+const postgres_1 = require("@prairielearn/postgres");
+const named_locks_1 = require("@prairielearn/named-locks");
+const load_migrations_1 = require("../load-migrations");
+const batched_migration_1 = require("./batched-migration");
+const batched_migration_runner_1 = require("./batched-migration-runner");
+const sql = (0, postgres_1.loadSqlEquiv)(__filename);
+const DEFAULT_MIN_VALUE = 1n;
+const DEFAULT_BATCH_SIZE = 1000;
+const DEFAULT_WORK_DURATION_MS = 60000;
+const DEFAULT_SLEEP_DURATION_MS = 30000;
+const EXTENSIONS = ['.js', '.ts', '.mjs', '.mts'];
+class BatchedMigrationsRunner extends node_events_1.default {
+    constructor(options) {
+        super();
+        this.running = false;
+        this.migrationFiles = null;
+        this.abortController = new AbortController();
+        this.getMigrationFiles = async () => {
+            if (!this.migrationFiles) {
+                this.migrationFiles = await (0, load_migrations_1.readAndValidateMigrationsFromDirectories)(this.options.directories, EXTENSIONS);
+            }
+            return this.migrationFiles;
+        };
+        this.options = options;
+        this.lockName = `batched-migrations:${this.options.project}`;
+    }
+    lockNameForTimestamp(timestamp) {
+        return `${this.lockName}:${timestamp}`;
+    }
+    async getMigrationForIdentifier(identifier) {
+        const timestamp = identifier.split('_')[0];
+        const migrationFiles = await this.getMigrationFiles();
+        const migrationFile = migrationFiles.find((m) => m.timestamp === timestamp);
+        return migrationFile ?? null;
+    }
+    /**
+     * Loads the implementation for the migration with the given identifier. The identifier
+     * must start with a 14-character timestamp. It may optionally be followed by
+     * an underscore with additional characters, which are ignored. These should
+     * typically be used to provide a human-readable name for the migration.
+     */
+    async loadMigrationImplementation(migrationFile) {
+        var _a;
+        // We use dynamic imports to handle both CJS and ESM modules.
+        const migrationModulePath = node_path_1.default.join(migrationFile.directory, migrationFile.filename);
+        const migrationModule = await (_a = migrationModulePath, Promise.resolve().then(() => __importStar(require(_a))));
+        const migrationImplementation = migrationModule.default;
+        (0, batched_migration_1.validateBatchedMigrationImplementation)(migrationImplementation);
+        return migrationImplementation;
+    }
+    async enqueueBatchedMigration(identifier) {
+        const migrationFile = await this.getMigrationForIdentifier(identifier);
+        if (!migrationFile) {
+            throw new Error(`No migration found for identifier ${identifier}`);
+        }
+        const migrationImplementation = await this.loadMigrationImplementation(migrationFile);
+        const migrationParameters = await migrationImplementation.getParameters();
+        // If `max` is null, that implies that there are no rows to process, so
+        // we can immediately mark the migration as finished.
+        const status = migrationParameters.max === null ? 'succeeded' : 'pending';
+        const minValue = BigInt(migrationParameters.min ?? DEFAULT_MIN_VALUE);
+        const maxValue = BigInt(migrationParameters.max ?? minValue);
+        const batchSize = migrationParameters.batchSize ?? DEFAULT_BATCH_SIZE;
+        await (0, batched_migration_1.insertBatchedMigration)({
+            project: this.options.project,
+            filename: migrationFile.filename,
+            timestamp: migrationFile.timestamp,
+            batch_size: batchSize,
+            min_value: minValue,
+            max_value: maxValue,
+            status,
+        });
+    }
+    async finalizeBatchedMigration(identifier, options) {
+        const timestamp = identifier.split('_')[0];
+        let migration = await (0, batched_migration_1.selectBatchedMigrationForTimestamp)(this.options.project, timestamp);
+        if (migration.status === 'succeeded')
+            return;
+        // If the migration isn't already in the finalizing state, mark it as such.
+        if (migration.status !== 'finalizing') {
+            migration = await (0, batched_migration_1.updateBatchedMigrationStatus)(migration.id, 'finalizing');
+        }
+        await (0, named_locks_1.doWithLock)(this.lockNameForTimestamp(timestamp), { autoRenew: true }, async () => {
+            const migrationFile = await this.getMigrationForIdentifier(identifier);
+            if (!migrationFile) {
+                throw new Error(`No migration found for identifier ${identifier}`);
+            }
+            const migrationImplementation = await this.loadMigrationImplementation(migrationFile);
+            const runner = new batched_migration_runner_1.BatchedMigrationRunner(migration, migrationImplementation, {
+                // Always log progress unless explicitly disabled.
+                logProgress: options?.logProgress ?? true,
+            });
+            // Because we don't give any arguments to `run()`, it will run until it
+            // has attempted every job.
+            await runner.run();
+        });
+        migration = await (0, batched_migration_1.selectBatchedMigrationForTimestamp)(this.options.project, timestamp);
+        if (migration.status === 'succeeded')
+            return;
+        throw new Error(`Expected batched migration with identifier ${identifier} to be marked as 'succeeded', but it is '${migration.status}'.`);
+    }
+    start(options = {}) {
+        if (this.running) {
+            throw new Error('BatchedMigrationsRunner is already running');
+        }
+        this.loop(options);
+    }
+    async loop({ workDurationMs, sleepDurationMs }) {
+        workDurationMs ?? (workDurationMs = DEFAULT_WORK_DURATION_MS);
+        sleepDurationMs ?? (sleepDurationMs = DEFAULT_SLEEP_DURATION_MS);
+        this.running = true;
+        while (this.running) {
+            if (this.abortController.signal.aborted) {
+                // We assign this here so that `stop()` can tell when this loop is done
+                // processing jobs.
+                this.running = false;
+                return;
+            }
+            let didWork = false;
+            try {
+                didWork = await this.maybePerformWork(workDurationMs);
+            }
+            catch (err) {
+                this.emit('error', err);
+            }
+            // If we did work, we'll immediately try again since there's probably more
+            // work to be done. If not, we'll sleep for a while - maybe some more work
+            // will become available!
+            if (!didWork) {
+                // We provide the signal here so that we can more quickly stop things
+                // when we're shutting down.
+                try {
+                    await (0, promises_1.setTimeout)(sleepDurationMs, null, { ref: false, signal: this.abortController.signal });
+                }
+                catch (err) {
+                    // We don't care about errors here, they should only ever occur when
+                    // the AbortController is aborted. Continue to the next iteration of
+                    // the loop so we can shut down.
+                    continue;
+                }
+            }
+        }
+    }
+    async getOrStartMigration() {
+        return (0, named_locks_1.doWithLock)(this.lockName, {}, async () => {
+            let migration = await (0, postgres_1.queryValidatedZeroOrOneRow)(sql.select_running_migration, { project: this.options.project }, batched_migration_1.BatchedMigrationRowSchema);
+            if (!migration) {
+                migration = await (0, postgres_1.queryValidatedZeroOrOneRow)(sql.start_next_pending_migration, { project: this.options.project }, batched_migration_1.BatchedMigrationRowSchema);
+            }
+            return migration;
+        });
+    }
+    async maybePerformWork(durationMs) {
+        const migration = await this.getOrStartMigration();
+        if (!migration) {
+            // No work to do. Handle this case.
+            return false;
+        }
+        // This server may not yet know about the current running migration. If
+        // that's the case, we'll just skip it for now.
+        const migrationFile = await this.getMigrationForIdentifier(migration.timestamp);
+        if (!migrationFile) {
+            return false;
+        }
+        let didWork = false;
+        await (0, named_locks_1.tryWithLock)(this.lockNameForTimestamp(migrationFile.timestamp), { autoRenew: true }, async () => {
+            didWork = true;
+            const migrationImplementation = await this.loadMigrationImplementation(migrationFile);
+            const runner = new batched_migration_runner_1.BatchedMigrationRunner(migration, migrationImplementation);
+            try {
+                await runner.run({ signal: this.abortController.signal, durationMs });
+            }
+            catch (err) {
+                this.emit('error', err);
+            }
+        });
+        return didWork;
+    }
+    async stop() {
+        this.abortController.abort();
+        // Spin until we're no longer running.
+        while (this.running) {
+            await (0, promises_1.setTimeout)(1000);
+        }
+    }
+}
+exports.BatchedMigrationsRunner = BatchedMigrationsRunner;
+let runner = null;
+function assertRunner(runner) {
+    if (!runner)
+        throw new Error('Batched migrations not initialized');
+}
+function initBatchedMigrations(options) {
+    if (runner)
+        throw new Error('Batched migrations already initialized');
+    runner = new BatchedMigrationsRunner(options);
+    return runner;
+}
+exports.initBatchedMigrations = initBatchedMigrations;
+function startBatchedMigrations(options = {}) {
+    assertRunner(runner);
+    runner.start(options);
+    return runner;
+}
+exports.startBatchedMigrations = startBatchedMigrations;
+async function stopBatchedMigrations() {
+    assertRunner(runner);
+    await runner.stop();
+    runner = null;
+}
+exports.stopBatchedMigrations = stopBatchedMigrations;
+/**
+ * Given a batched migration identifier like `20230406184103_migration`,
+ * enqueues it for execution by creating a row in the `batched_migrations`
+ * table.
+ *
+ * Despite taking a full identifier, only the timestamp is used to uniquely
+ * identify the batched migration. The remaining part is just used to make
+ * calls more human-readable.
+ *
+ * @param identifier The identifier of the batched migration to enqueue.
+ */
+async function enqueueBatchedMigration(identifier) {
+    assertRunner(runner);
+    await runner.enqueueBatchedMigration(identifier);
+}
+exports.enqueueBatchedMigration = enqueueBatchedMigration;
+/**
+ * Given a batched migration identifier like `20230406184103_migration`,
+ * synchronously runs it to completion. An error will be thrown if the final
+ * status of the migration is not `succeeded`.
+ *
+ * @param identifier The identifier of the batched migration to finalize.
+ * @param options Options for finalizing the batched migration.
+ */
+async function finalizeBatchedMigration(identifier, options) {
+    assertRunner(runner);
+    await runner.finalizeBatchedMigration(identifier, options);
+}
+exports.finalizeBatchedMigration = finalizeBatchedMigration;
+//# sourceMappingURL=batched-migrations-runner.js.map

package/dist/batched-migrations/batched-migrations-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batched-migrations-runner.js","sourceRoot":"","sources":["../../src/batched-migrations/batched-migrations-runner.ts"],"names":[],"mappings":"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"}

package/dist/batched-migrations/batched-migrations-runner.sql

@@ -0,0 +1,35 @@
+-- BLOCK select_running_migration
+SELECT
+  *
+FROM
+  batched_migrations
+WHERE
+  status = 'running'
+  AND project = $project
+ORDER BY
+  id ASC
+LIMIT
+  1;
+
+-- BLOCK start_next_pending_migration
+UPDATE batched_migrations
+SET
+  status = 'running',
+  started_at = CURRENT_TIMESTAMP,
+  updated_at = CURRENT_TIMESTAMP
+WHERE
+  id = (
+    SELECT
+      id
+    FROM
+      batched_migrations
+    WHERE
+      status = 'pending'
+      AND project = $project
+    ORDER BY
+      id ASC
+    LIMIT
+      1
+  )
+RETURNING
+  *;

package/dist/batched-migrations/batched-migrations-runner.test.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = __importStar(require("chai"));
+const chai_as_promised_1 = __importDefault(require("chai-as-promised"));
+const node_path_1 = __importDefault(require("node:path"));
+const postgres_1 = require("@prairielearn/postgres");
+const namedLocks = __importStar(require("@prairielearn/named-locks"));
+const index_1 = require("../index");
+const batched_migrations_runner_1 = require("./batched-migrations-runner");
+const batched_migration_1 = require("./batched-migration");
+chai_1.default.use(chai_as_promised_1.default);
+const postgresTestUtils = (0, postgres_1.makePostgresTestUtils)({
+    database: 'prairielearn_migrations',
+});
+describe('BatchedMigrationsRunner', () => {
+    before(async () => {
+        await postgresTestUtils.createDatabase();
+        await namedLocks.init(postgresTestUtils.getPoolConfig(), (err) => {
+            throw err;
+        });
+        await (0, index_1.init)([index_1.SCHEMA_MIGRATIONS_PATH], 'prairielearn_migrations');
+    });
+    afterEach(async () => {
+        await postgresTestUtils.resetDatabase();
+    });
+    after(async () => {
+        await namedLocks.close();
+        await postgresTestUtils.dropDatabase();
+    });
+    it('enqueues migrations', async () => {
+        const runner = new batched_migrations_runner_1.BatchedMigrationsRunner({
+            project: 'test',
+            directories: [node_path_1.default.join(__dirname, 'fixtures')],
+        });
+        await runner.enqueueBatchedMigration('20230406184103_successful_migration');
+        await runner.enqueueBatchedMigration('20230406184107_failing_migration');
+        await runner.enqueueBatchedMigration('20230407230446_no_rows_migration');
+        const migrations = await (0, batched_migration_1.selectAllBatchedMigrations)('test');
+        chai_1.assert.lengthOf(migrations, 3);
+        chai_1.assert.equal(migrations[0].timestamp, '20230406184103');
+        chai_1.assert.equal(migrations[0].filename, '20230406184103_successful_migration.ts');
+        chai_1.assert.equal(migrations[0].status, 'pending');
+        chai_1.assert.equal(migrations[1].timestamp, '20230406184107');
+        chai_1.assert.equal(migrations[1].filename, '20230406184107_failing_migration.js');
+        chai_1.assert.equal(migrations[1].status, 'pending');
+        chai_1.assert.equal(migrations[2].timestamp, '20230407230446');
+        chai_1.assert.equal(migrations[2].filename, '20230407230446_no_rows_migration.ts');
+        chai_1.assert.equal(migrations[2].status, 'succeeded');
+    });
+    it('safely enqueues migrations multiple times', async () => {
+        const runner = new batched_migrations_runner_1.BatchedMigrationsRunner({
+            project: 'test',
+            directories: [node_path_1.default.join(__dirname, 'fixtures')],
+        });
+        await runner.enqueueBatchedMigration('20230406184103_successful_migration');
+        await runner.enqueueBatchedMigration('20230406184103_successful_migration');
+        await runner.enqueueBatchedMigration('20230406184103_successful_migration');
+        const migrations = await (0, batched_migration_1.selectAllBatchedMigrations)('test');
+        chai_1.assert.lengthOf(migrations, 1);
+    });
+    it('finalizes a successful migration', async () => {
+        const runner = new batched_migrations_runner_1.BatchedMigrationsRunner({
+            project: 'test',
+            directories: [node_path_1.default.join(__dirname, 'fixtures')],
+        });
+        await runner.enqueueBatchedMigration('20230406184103_successful_migration');
+        await runner.finalizeBatchedMigration('20230406184103_successful_migration', {
+            logProgress: false,
+        });
+        const migrations = await (0, batched_migration_1.selectAllBatchedMigrations)('test');
+        chai_1.assert.lengthOf(migrations, 1);
+        chai_1.assert.equal(migrations[0].timestamp, '20230406184103');
+        chai_1.assert.equal(migrations[0].status, 'succeeded');
+    });
+    it('finalizes a failing migration', async () => {
+        const runner = new batched_migrations_runner_1.BatchedMigrationsRunner({
+            project: 'test',
+            directories: [node_path_1.default.join(__dirname, 'fixtures')],
+        });
+        await runner.enqueueBatchedMigration('20230406184107_failing_migration');
+        await chai_1.assert.isRejected(runner.finalizeBatchedMigration('20230406184107_failing_migration', {
+            logProgress: false,
+        }), "but it is 'failed'");
+        const migrations = await (0, batched_migration_1.selectAllBatchedMigrations)('test');
+        chai_1.assert.lengthOf(migrations, 1);
+        chai_1.assert.equal(migrations[0].timestamp, '20230406184107');
+        chai_1.assert.equal(migrations[0].status, 'failed');
+    });
+});
+//# sourceMappingURL=batched-migrations-runner.test.js.map

package/dist/batched-migrations/batched-migrations-runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batched-migrations-runner.test.js","sourceRoot":"","sources":["../../src/batched-migrations/batched-migrations-runner.test.ts"],"names":[],"mappings":"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"}

package/dist/batched-migrations/fixtures/20230406184103_successful_migration.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    getParameters(): Promise<{
+        min: bigint;
+        max: bigint;
+        batchSize: number;
+    }>;
+    execute(_min: bigint, _max: bigint): Promise<void>;
+};
+export default _default;

package/dist/batched-migrations/fixtures/20230406184103_successful_migration.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const batched_migration_1 = require("../batched-migration");
+exports.default = (0, batched_migration_1.makeBatchedMigration)({
+    async getParameters() {
+        return {
+            min: 1n,
+            max: 100n,
+            batchSize: 10,
+        };
+    },
+    async execute(_min, _max) { },
+});
+//# sourceMappingURL=20230406184103_successful_migration.js.map

package/dist/batched-migrations/fixtures/20230406184103_successful_migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20230406184103_successful_migration.js","sourceRoot":"","sources":["../../../src/batched-migrations/fixtures/20230406184103_successful_migration.ts"],"names":[],"mappings":";;AAAA,4DAA4D;AAE5D,kBAAe,IAAA,wCAAoB,EAAC;IAClC,KAAK,CAAC,aAAa;QACjB,OAAO;YACL,GAAG,EAAE,EAAE;YACP,GAAG,EAAE,IAAI;YACT,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAY,IAAG,CAAC;CAC7C,CAAC,CAAC"}

package/dist/batched-migrations/fixtures/20230407230446_no_rows_migration.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    getParameters(): Promise<{
+        max: null;
+        batchSize: number;
+    }>;
+    execute(_min: bigint, _max: bigint): Promise<void>;
+};
+export default _default;

package/dist/batched-migrations/fixtures/20230407230446_no_rows_migration.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const batched_migration_1 = require("../batched-migration");
+exports.default = (0, batched_migration_1.makeBatchedMigration)({
+    async getParameters() {
+        return {
+            // Simulates the case where there are no rows to process. A null
+            // max value is what we would get for some query like
+            // `SELECT MAX(id) FROM table;`.
+            max: null,
+            batchSize: 10,
+        };
+    },
+    async execute(_min, _max) { },
+});
+//# sourceMappingURL=20230407230446_no_rows_migration.js.map

package/dist/batched-migrations/fixtures/20230407230446_no_rows_migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20230407230446_no_rows_migration.js","sourceRoot":"","sources":["../../../src/batched-migrations/fixtures/20230407230446_no_rows_migration.ts"],"names":[],"mappings":";;AAAA,4DAA4D;AAE5D,kBAAe,IAAA,wCAAoB,EAAC;IAClC,KAAK,CAAC,aAAa;QACjB,OAAO;YACL,gEAAgE;YAChE,qDAAqD;YACrD,gCAAgC;YAChC,GAAG,EAAE,IAAI;YACT,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAY,IAAG,CAAC;CAC7C,CAAC,CAAC"}

package/dist/batched-migrations/index.d.ts

@@ -0,0 +1,3 @@
+export { BatchedMigrationRow, BatchedMigrationStatus, makeBatchedMigration, selectAllBatchedMigrations, selectBatchedMigration, selectBatchedMigrationForTimestamp, retryFailedBatchedMigrationJobs, } from './batched-migration';
+export { BatchedMigrationJobRow, BatchedMigrationJobStatus, selectRecentJobsWithStatus, } from './batched-migration-job';
+export { initBatchedMigrations, startBatchedMigrations, stopBatchedMigrations, enqueueBatchedMigration, finalizeBatchedMigration, } from './batched-migrations-runner';

package/dist/batched-migrations/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.finalizeBatchedMigration = exports.enqueueBatchedMigration = exports.stopBatchedMigrations = exports.startBatchedMigrations = exports.initBatchedMigrations = exports.selectRecentJobsWithStatus = exports.retryFailedBatchedMigrationJobs = exports.selectBatchedMigrationForTimestamp = exports.selectBatchedMigration = exports.selectAllBatchedMigrations = exports.makeBatchedMigration = void 0;
+var batched_migration_1 = require("./batched-migration");
+Object.defineProperty(exports, "makeBatchedMigration", { enumerable: true, get: function () { return batched_migration_1.makeBatchedMigration; } });
+Object.defineProperty(exports, "selectAllBatchedMigrations", { enumerable: true, get: function () { return batched_migration_1.selectAllBatchedMigrations; } });
+Object.defineProperty(exports, "selectBatchedMigration", { enumerable: true, get: function () { return batched_migration_1.selectBatchedMigration; } });
+Object.defineProperty(exports, "selectBatchedMigrationForTimestamp", { enumerable: true, get: function () { return batched_migration_1.selectBatchedMigrationForTimestamp; } });
+Object.defineProperty(exports, "retryFailedBatchedMigrationJobs", { enumerable: true, get: function () { return batched_migration_1.retryFailedBatchedMigrationJobs; } });
+var batched_migration_job_1 = require("./batched-migration-job");
+Object.defineProperty(exports, "selectRecentJobsWithStatus", { enumerable: true, get: function () { return batched_migration_job_1.selectRecentJobsWithStatus; } });
+var batched_migrations_runner_1 = require("./batched-migrations-runner");
+Object.defineProperty(exports, "initBatchedMigrations", { enumerable: true, get: function () { return batched_migrations_runner_1.initBatchedMigrations; } });
+Object.defineProperty(exports, "startBatchedMigrations", { enumerable: true, get: function () { return batched_migrations_runner_1.startBatchedMigrations; } });
+Object.defineProperty(exports, "stopBatchedMigrations", { enumerable: true, get: function () { return batched_migrations_runner_1.stopBatchedMigrations; } });
+Object.defineProperty(exports, "enqueueBatchedMigration", { enumerable: true, get: function () { return batched_migrations_runner_1.enqueueBatchedMigration; } });
+Object.defineProperty(exports, "finalizeBatchedMigration", { enumerable: true, get: function () { return batched_migrations_runner_1.finalizeBatchedMigration; } });
+//# sourceMappingURL=index.js.map

package/dist/batched-migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/batched-migrations/index.ts"],"names":[],"mappings":";;;AAAA,yDAQ6B;AAL3B,yHAAA,oBAAoB,OAAA;AACpB,+HAAA,0BAA0B,OAAA;AAC1B,2HAAA,sBAAsB,OAAA;AACtB,uIAAA,kCAAkC,OAAA;AAClC,oIAAA,+BAA+B,OAAA;AAEjC,iEAIiC;AAD/B,mIAAA,0BAA0B,OAAA;AAE5B,yEAMqC;AALnC,kIAAA,qBAAqB,OAAA;AACrB,mIAAA,sBAAsB,OAAA;AACtB,kIAAA,qBAAqB,OAAA;AACrB,oIAAA,uBAAuB,OAAA;AACvB,qIAAA,wBAAwB,OAAA"}

package/dist/index.d.ts

@@ -1,12 +1,3 @@
-export declare function init(migrationDir: string, project: string): Promise<void>;
-interface MigrationFile {
-    filename: string;
-    timestamp: string;
-}
-export declare function readAndValidateMigrationsFromDirectory(dir: string, extensions: string[]): Promise<MigrationFile[]>;
-export declare function sortMigrationFiles(migrationFiles: MigrationFile[]): MigrationFile[];
-export declare function getMigrationsToExecute(migrationFiles: MigrationFile[], executedMigrations: {
-    timestamp: string | null;
-}[]): MigrationFile[];
-export declare function initWithLock(migrationDir: string, project: string): Promise<void>;
-export {};
+export { init } from './migrations';
+export { BatchedMigrationRow, BatchedMigrationStatus, BatchedMigrationJobRow, BatchedMigrationJobStatus, makeBatchedMigration, initBatchedMigrations, startBatchedMigrations, stopBatchedMigrations, enqueueBatchedMigration, finalizeBatchedMigration, selectAllBatchedMigrations, selectBatchedMigration, selectBatchedMigrationForTimestamp, selectRecentJobsWithStatus, } from './batched-migrations';
+export declare const SCHEMA_MIGRATIONS_PATH: string;