steroids-api 0.2.7

package/dist/src/migrations/manifest.js

@@ -0,0 +1,255 @@
+/**
+ * Migration manifest management
+ * Handles reading, parsing, and validating the migration manifest
+ */
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+// Cache for package root to avoid repeated filesystem operations
+let _packageRoot = null;
+/**
+ * Get the CLI package root directory
+ * Works whether running from src/ or dist/
+ */
+function getPackageRoot() {
+    if (_packageRoot)
+        return _packageRoot;
+    // Try multiple strategies to find the package root
+    const candidates = [];
+    // Strategy 1: Check process.argv[1] - this is the executed script path
+    if (process.argv[1]) {
+        let dir = dirname(process.argv[1]);
+        for (let i = 0; i < 5; i++) {
+            candidates.push(dir);
+            dir = dirname(dir);
+        }
+    }
+    // Strategy 2: Check require.main.filename if available
+    // In ESM, `require` is not defined, so guard with typeof.
+    if (typeof require !== 'undefined' && require.main?.filename) {
+        let dir = dirname(require.main.filename);
+        for (let i = 0; i < 5; i++) {
+            candidates.push(dir);
+            dir = dirname(dir);
+        }
+    }
+    // Strategy 3: Check __dirname of this module (works in CommonJS)
+    // In compiled output this will be dist/migrations/
+    if (typeof __dirname !== 'undefined') {
+        let dir = __dirname;
+        for (let i = 0; i < 5; i++) {
+            candidates.push(dir);
+            dir = dirname(dir);
+        }
+    }
+    // Find the first candidate that contains package.json with name 'steroids-cli'
+    for (const dir of candidates) {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name === 'steroids-cli') {
+                    _packageRoot = dir;
+                    return dir;
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // Last resort: try cwd (useful during development)
+    const cwdPkg = join(process.cwd(), 'package.json');
+    if (existsSync(cwdPkg)) {
+        try {
+            const pkg = JSON.parse(readFileSync(cwdPkg, 'utf-8'));
+            if (pkg.name === 'steroids-cli') {
+                _packageRoot = process.cwd();
+                return process.cwd();
+            }
+        }
+        catch { /* ignore */ }
+    }
+    throw new Error('Could not locate steroids-cli package root');
+}
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+const GLOBAL_STEROIDS_DIR = join(homedir(), '.steroids');
+const CACHE_DIR = join(GLOBAL_STEROIDS_DIR, 'migrations');
+const CACHE_FILE = join(CACHE_DIR, 'manifest-cache.json');
+/**
+ * Get the path to the bundled manifest (in the package)
+ */
+export function getBundledManifestPath() {
+    // Resolve relative to CLI package root, not cwd
+    return join(getPackageRoot(), 'migrations', 'manifest.json');
+}
+/**
+ * Get the path to a migration file (in the package)
+ */
+export function getMigrationFilePath(filename) {
+    return join(getPackageRoot(), 'migrations', filename);
+}
+/**
+ * Get the path to the cached manifest
+ */
+export function getCachedManifestPath() {
+    return join(CACHE_DIR, 'manifest.json');
+}
+/**
+ * Read the bundled manifest from the package
+ */
+export function readBundledManifest() {
+    const manifestPath = getBundledManifestPath();
+    if (!existsSync(manifestPath)) {
+        throw new Error(`Bundled manifest not found at: ${manifestPath}`);
+    }
+    const content = readFileSync(manifestPath, 'utf-8');
+    return parseManifest(content);
+}
+/**
+ * Read the cached manifest if it exists and is valid
+ */
+export function readCachedManifest() {
+    if (!existsSync(CACHE_FILE)) {
+        return null;
+    }
+    try {
+        const cacheContent = readFileSync(CACHE_FILE, 'utf-8');
+        const cache = JSON.parse(cacheContent);
+        // Check if cache is still valid
+        if (Date.now() - cache.fetchedAt > CACHE_TTL) {
+            return null;
+        }
+        return cache.manifest;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save manifest to cache
+ */
+export function cacheManifest(manifest) {
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    const cache = {
+        fetchedAt: Date.now(),
+        manifest,
+    };
+    writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+    // Also save the manifest itself for offline access
+    writeFileSync(getCachedManifestPath(), JSON.stringify(manifest, null, 2));
+}
+/**
+ * Parse and validate manifest content
+ */
+export function parseManifest(content) {
+    const manifest = JSON.parse(content);
+    validateManifest(manifest);
+    return manifest;
+}
+/**
+ * Validate manifest structure
+ */
+export function validateManifest(manifest) {
+    if (!manifest.version) {
+        throw new Error('Manifest missing version field');
+    }
+    if (typeof manifest.latestDbVersion !== 'number' || manifest.latestDbVersion < 1) {
+        throw new Error('Manifest missing or invalid latestDbVersion field');
+    }
+    if (!Array.isArray(manifest.migrations)) {
+        throw new Error('Manifest missing migrations array');
+    }
+    // Validate each migration entry
+    for (const migration of manifest.migrations) {
+        validateMigrationEntry(migration);
+    }
+    // Validate migrations are in order
+    const ids = manifest.migrations.map(m => m.id);
+    for (let i = 1; i < ids.length; i++) {
+        if (ids[i] <= ids[i - 1]) {
+            throw new Error(`Migrations not in order: ${ids[i - 1]} followed by ${ids[i]}`);
+        }
+    }
+    // Validate latestDbVersion matches
+    if (manifest.migrations.length > 0) {
+        const maxId = Math.max(...ids);
+        if (maxId !== manifest.latestDbVersion) {
+            throw new Error(`latestDbVersion (${manifest.latestDbVersion}) does not match highest migration id (${maxId})`);
+        }
+    }
+}
+/**
+ * Validate a single migration entry
+ */
+function validateMigrationEntry(entry) {
+    if (typeof entry.id !== 'number' || entry.id < 1) {
+        throw new Error(`Invalid migration id: ${entry.id}`);
+    }
+    if (!entry.name || typeof entry.name !== 'string') {
+        throw new Error(`Migration ${entry.id} missing name`);
+    }
+    if (!entry.file || typeof entry.file !== 'string') {
+        throw new Error(`Migration ${entry.id} missing file`);
+    }
+    if (!entry.description || typeof entry.description !== 'string') {
+        throw new Error(`Migration ${entry.id} missing description`);
+    }
+    if (!entry.cliVersion || typeof entry.cliVersion !== 'string') {
+        throw new Error(`Migration ${entry.id} missing cliVersion`);
+    }
+    // Checksum can be empty for new migrations
+}
+/**
+ * Calculate SHA256 checksum for migration file content
+ */
+export function calculateChecksum(content) {
+    const hash = createHash('sha256');
+    hash.update(content);
+    return `sha256:${hash.digest('hex')}`;
+}
+/**
+ * Verify checksum matches
+ */
+export function verifyChecksum(content, expectedChecksum) {
+    if (!expectedChecksum) {
+        // No checksum to verify
+        return true;
+    }
+    const actual = calculateChecksum(content);
+    return actual === expectedChecksum;
+}
+/**
+ * Find pending migrations that need to be applied
+ */
+export function findPendingMigrations(manifest, appliedMigrations) {
+    const appliedIds = new Set(appliedMigrations.map(m => m.id));
+    return manifest.migrations.filter(m => !appliedIds.has(m.id));
+}
+/**
+ * Find migrations to rollback (applied but not in manifest)
+ */
+export function findOrphanedMigrations(manifest, appliedMigrations) {
+    const manifestIds = new Set(manifest.migrations.map(m => m.id));
+    return appliedMigrations.filter(m => !manifestIds.has(m.id));
+}
+/**
+ * Get migration entry by ID
+ */
+export function getMigrationById(manifest, id) {
+    return manifest.migrations.find(m => m.id === id) ?? null;
+}
+/**
+ * Get the current supported database version range for this CLI
+ */
+export function getCliSupportedVersions(manifest) {
+    if (manifest.migrations.length === 0) {
+        return { min: 0, max: 0 };
+    }
+    return {
+        min: 1, // Always support from version 1
+        max: manifest.latestDbVersion,
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/migrations/manifest.js.map

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

package/dist/src/migrations/runner.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Migration runner
+ * Applies and rolls back database migrations with transaction safety
+ */
+import Database from 'better-sqlite3';
+import { MigrationManifest, MigrationEntry, AppliedMigration } from './manifest.js';
+/**
+ * Result of a migration operation
+ */
+export interface MigrationResult {
+    success: boolean;
+    applied: string[];
+    failed?: string;
+    error?: string;
+}
+/**
+ * Migration SQL sections
+ */
+interface MigrationSql {
+    up: string;
+    down: string;
+}
+/**
+ * Parse migration file into UP and DOWN sections
+ */
+export declare function parseMigrationFile(content: string): MigrationSql;
+/**
+ * Read migration file content
+ */
+export declare function readMigrationFile(entry: MigrationEntry): string;
+/**
+ * Get applied migrations from database
+ */
+export declare function getAppliedMigrations(db: Database.Database): AppliedMigration[];
+/**
+ * Get current database version
+ */
+export declare function getDatabaseVersion(db: Database.Database): number;
+/**
+ * Create backup of database before migration
+ */
+export declare function createBackup(dbPath: string): string;
+/**
+ * Apply a single migration
+ * Handles idempotent migrations (e.g., duplicate column errors are treated as success)
+ */
+export declare function applyMigration(db: Database.Database, entry: MigrationEntry, content: string): void;
+/**
+ * Rollback a single migration
+ */
+export declare function rollbackMigration(db: Database.Database, entry: MigrationEntry, content: string): void;
+/**
+ * Run all pending migrations
+ */
+export declare function runMigrations(db: Database.Database, manifest: MigrationManifest, options?: {
+    toVersion?: number;
+    dryRun?: boolean;
+}): MigrationResult;
+/**
+ * Rollback to a specific version
+ */
+export declare function rollbackToVersion(db: Database.Database, manifest: MigrationManifest, targetVersion: number): MigrationResult;
+/**
+ * Get migration status
+ */
+export interface MigrationStatus {
+    currentVersion: number;
+    latestVersion: number;
+    isUpToDate: boolean;
+    pending: MigrationEntry[];
+    applied: AppliedMigration[];
+}
+export declare function getMigrationStatus(db: Database.Database, manifest: MigrationManifest): MigrationStatus;
+/**
+ * Check and apply any pending migrations automatically
+ * Returns true if migrations were applied, false if already up to date
+ */
+export declare function autoMigrate(db: Database.Database, dbPath?: string): {
+    applied: boolean;
+    migrations: string[];
+    error?: string;
+};
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/migrations/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/migrations/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAMjB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA8BhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAQ/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,gBAAgB,EAAE,CAQ9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAiBhE;AA4BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyBnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,GACd,IAAI,CAwCN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,GACd,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,eAAe,CA+CjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,MAAM,GACpB,eAAe,CA8CjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,iBAAiB,GAC1B,eAAe,CAYjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAyCA"}

package/dist/src/migrations/runner.js

@@ -0,0 +1,338 @@
+/**
+ * Migration runner
+ * Applies and rolls back database migrations with transaction safety
+ */
+import { readFileSync, existsSync, copyFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { readBundledManifest, getMigrationFilePath, calculateChecksum, verifyChecksum, findPendingMigrations, } from './manifest.js';
+/**
+ * Parse migration file into UP and DOWN sections
+ */
+export function parseMigrationFile(content) {
+    const lines = content.split('\n');
+    let currentSection = 'none';
+    const upLines = [];
+    const downLines = [];
+    for (const line of lines) {
+        const trimmed = line.trim().toUpperCase();
+        if (trimmed === '-- UP') {
+            currentSection = 'up';
+            continue;
+        }
+        if (trimmed === '-- DOWN') {
+            currentSection = 'down';
+            continue;
+        }
+        if (currentSection === 'up') {
+            upLines.push(line);
+        }
+        else if (currentSection === 'down') {
+            downLines.push(line);
+        }
+    }
+    return {
+        up: upLines.join('\n').trim(),
+        down: downLines.join('\n').trim(),
+    };
+}
+/**
+ * Read migration file content
+ */
+export function readMigrationFile(entry) {
+    const filePath = getMigrationFilePath(entry.file);
+    if (!existsSync(filePath)) {
+        throw new Error(`Migration file not found: ${filePath}`);
+    }
+    return readFileSync(filePath, 'utf-8');
+}
+/**
+ * Get applied migrations from database
+ */
+export function getAppliedMigrations(db) {
+    try {
+        const rows = db.prepare('SELECT id, name, checksum, applied_at FROM _migrations ORDER BY id').all();
+        return rows;
+    }
+    catch {
+        // Table may not exist yet
+        return [];
+    }
+}
+/**
+ * Get current database version
+ */
+export function getDatabaseVersion(db) {
+    try {
+        const row = db.prepare('SELECT value FROM _schema WHERE key = ?').get('version');
+        if (!row)
+            return 0;
+        // Parse version - could be semver "0.1.0" or just a number
+        const version = row.value;
+        if (/^\d+$/.test(version)) {
+            return parseInt(version, 10);
+        }
+        // For semver, use the number of applied migrations as the version
+        const migrations = getAppliedMigrations(db);
+        return migrations.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Update database version in _schema table
+ */
+function updateDatabaseVersion(db, version, migrationName) {
+    db.prepare('INSERT OR REPLACE INTO _schema (key, value) VALUES (?, ?)').run('version', version.toString());
+    db.prepare('INSERT OR REPLACE INTO _schema (key, value) VALUES (?, ?)').run('last_migration', migrationName);
+}
+/**
+ * Record applied migration
+ */
+function recordMigration(db, entry, checksum) {
+    db.prepare('INSERT INTO _migrations (id, name, checksum) VALUES (?, ?, ?)').run(entry.id, entry.name, checksum);
+}
+/**
+ * Remove migration record (for rollback)
+ */
+function removeMigrationRecord(db, id) {
+    db.prepare('DELETE FROM _migrations WHERE id = ?').run(id);
+}
+/**
+ * Create backup of database before migration
+ */
+export function createBackup(dbPath) {
+    const steroidsDir = dirname(dbPath);
+    const backupDir = join(steroidsDir, 'backup');
+    if (!existsSync(backupDir)) {
+        mkdirSync(backupDir, { recursive: true });
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = join(backupDir, `pre-migrate-${timestamp}.db`);
+    copyFileSync(dbPath, backupPath);
+    // Also copy WAL and SHM files if they exist
+    const walPath = `${dbPath}-wal`;
+    const shmPath = `${dbPath}-shm`;
+    if (existsSync(walPath)) {
+        copyFileSync(walPath, `${backupPath}-wal`);
+    }
+    if (existsSync(shmPath)) {
+        copyFileSync(shmPath, `${backupPath}-shm`);
+    }
+    return backupPath;
+}
+/**
+ * Apply a single migration
+ * Handles idempotent migrations (e.g., duplicate column errors are treated as success)
+ */
+export function applyMigration(db, entry, content) {
+    const parsed = parseMigrationFile(content);
+    const checksum = calculateChecksum(content);
+    if (entry.checksum && !verifyChecksum(content, entry.checksum)) {
+        throw new Error(`Checksum mismatch for migration ${entry.name}. ` +
+            `Expected ${entry.checksum}, got ${checksum}. ` +
+            'The migration file may have been corrupted or tampered with.');
+    }
+    if (!parsed.up) {
+        throw new Error(`Migration ${entry.name} has no UP section`);
+    }
+    // Apply the migration in a transaction
+    // Handle idempotent cases like "duplicate column name" or "table already exists"
+    const transaction = db.transaction(() => {
+        try {
+            db.exec(parsed.up);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // These errors indicate the migration was already effectively applied
+            const idempotentErrors = [
+                'duplicate column name',
+                'table already exists',
+                'index already exists',
+            ];
+            const isIdempotent = idempotentErrors.some(e => msg.toLowerCase().includes(e));
+            if (!isIdempotent) {
+                throw err;
+            }
+            // Migration already applied, continue to record it
+        }
+        recordMigration(db, entry, checksum);
+        updateDatabaseVersion(db, entry.id, entry.name);
+    });
+    transaction();
+}
+/**
+ * Rollback a single migration
+ */
+export function rollbackMigration(db, entry, content) {
+    const parsed = parseMigrationFile(content);
+    if (!parsed.down) {
+        throw new Error(`Migration ${entry.name} has no DOWN section - cannot rollback`);
+    }
+    // Rollback in a transaction
+    const transaction = db.transaction(() => {
+        db.exec(parsed.down);
+        removeMigrationRecord(db, entry.id);
+        // Update version to previous migration
+        const previousId = entry.id - 1;
+        if (previousId > 0) {
+            const manifest = readBundledManifest();
+            const previousMigration = manifest.migrations.find(m => m.id === previousId);
+            if (previousMigration) {
+                updateDatabaseVersion(db, previousId, previousMigration.name);
+            }
+        }
+        else {
+            // No more migrations, set version to 0
+            db.prepare('DELETE FROM _schema WHERE key = ?').run('version');
+            db.prepare('DELETE FROM _schema WHERE key = ?').run('last_migration');
+        }
+    });
+    transaction();
+}
+/**
+ * Run all pending migrations
+ */
+export function runMigrations(db, manifest, options = {}) {
+    const applied = getAppliedMigrations(db);
+    const pending = findPendingMigrations(manifest, applied);
+    // Filter by target version if specified
+    const migrationsToApply = options.toVersion
+        ? pending.filter(m => m.id <= options.toVersion)
+        : pending;
+    if (migrationsToApply.length === 0) {
+        return {
+            success: true,
+            applied: [],
+        };
+    }
+    // Sort by ID to ensure correct order
+    migrationsToApply.sort((a, b) => a.id - b.id);
+    if (options.dryRun) {
+        return {
+            success: true,
+            applied: migrationsToApply.map(m => m.name),
+        };
+    }
+    const appliedNames = [];
+    for (const migration of migrationsToApply) {
+        try {
+            const content = readMigrationFile(migration);
+            applyMigration(db, migration, content);
+            appliedNames.push(migration.name);
+        }
+        catch (error) {
+            return {
+                success: false,
+                applied: appliedNames,
+                failed: migration.name,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    return {
+        success: true,
+        applied: appliedNames,
+    };
+}
+/**
+ * Rollback to a specific version
+ */
+export function rollbackToVersion(db, manifest, targetVersion) {
+    const applied = getAppliedMigrations(db);
+    // Find migrations to rollback (those with id > targetVersion)
+    const toRollback = applied
+        .filter(m => m.id > targetVersion)
+        .sort((a, b) => b.id - a.id); // Rollback in reverse order
+    if (toRollback.length === 0) {
+        return {
+            success: true,
+            applied: [],
+        };
+    }
+    const rolledBack = [];
+    for (const migration of toRollback) {
+        const entry = manifest.migrations.find(m => m.id === migration.id);
+        if (!entry) {
+            return {
+                success: false,
+                applied: rolledBack,
+                failed: migration.name,
+                error: `Migration ${migration.name} not found in manifest`,
+            };
+        }
+        try {
+            const content = readMigrationFile(entry);
+            rollbackMigration(db, entry, content);
+            rolledBack.push(migration.name);
+        }
+        catch (error) {
+            return {
+                success: false,
+                applied: rolledBack,
+                failed: migration.name,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    return {
+        success: true,
+        applied: rolledBack,
+    };
+}
+export function getMigrationStatus(db, manifest) {
+    const applied = getAppliedMigrations(db);
+    const pending = findPendingMigrations(manifest, applied);
+    const currentVersion = applied.length > 0 ? Math.max(...applied.map(m => m.id)) : 0;
+    return {
+        currentVersion,
+        latestVersion: manifest.latestDbVersion,
+        isUpToDate: pending.length === 0,
+        pending,
+        applied,
+    };
+}
+/**
+ * Check and apply any pending migrations automatically
+ * Returns true if migrations were applied, false if already up to date
+ */
+export function autoMigrate(db, dbPath) {
+    try {
+        const manifest = readBundledManifest();
+        const status = getMigrationStatus(db, manifest);
+        if (status.isUpToDate) {
+            return { applied: false, migrations: [] };
+        }
+        // Create backup before migrating if path provided
+        if (dbPath) {
+            try {
+                createBackup(dbPath);
+            }
+            catch (backupErr) {
+                // Log but don't fail - backup is optional
+                console.error('Warning: Could not create backup before migration:', backupErr);
+            }
+        }
+        // Apply pending migrations
+        const result = runMigrations(db, manifest);
+        if (!result.success) {
+            return {
+                applied: false,
+                migrations: result.applied,
+                error: `Migration failed at ${result.failed}: ${result.error}`,
+            };
+        }
+        return {
+            applied: result.applied.length > 0,
+            migrations: result.applied,
+        };
+    }
+    catch (err) {
+        return {
+            applied: false,
+            migrations: [],
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map