steroids-cli 0.4.47

package/dist/locking/task-lock.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Task locking with atomic operations
+ * Prevents multiple runners from working on the same task
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCK_CONSTANTS = void 0;
+exports.acquireTaskLock = acquireTaskLock;
+exports.releaseTaskLock = releaseTaskLock;
+exports.forceRelease = forceRelease;
+exports.heartbeat = heartbeat;
+exports.extend = extend;
+exports.createTaskLockManager = createTaskLockManager;
+exports.createHeartbeatLoop = createHeartbeatLoop;
+exports.isTaskLocked = isTaskLocked;
+exports.isTaskLockedBy = isTaskLockedBy;
+exports.getTimeUntilExpiry = getTimeUntilExpiry;
+const queries_js_1 = require("./queries.js");
+// Default lock timeout in minutes
+const DEFAULT_LOCK_TIMEOUT_MINUTES = 60;
+const HEARTBEAT_INTERVAL_MS = 30 * 1000; // 30 seconds
+// ============ Lock Acquisition ============
+/**
+ * Acquire a task lock with atomic operations
+ *
+ * Flow:
+ * 1. Try INSERT (fails if lock exists)
+ * 2. If exists, check if we own it
+ * 3. If owned by another, check if expired
+ * 4. If expired, claim atomically
+ * 5. If not expired, return failure
+ */
+function acquireTaskLock(db, taskId, runnerId, timeoutMinutes = DEFAULT_LOCK_TIMEOUT_MINUTES) {
+    // Step 1: Try to insert new lock
+    if ((0, queries_js_1.tryInsertTaskLock)(db, taskId, runnerId, timeoutMinutes)) {
+        const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+        return {
+            acquired: true,
+            lock: lock ?? undefined,
+            reason: 'acquired_new',
+        };
+    }
+    // Step 2: Lock exists, get current state
+    const existingLock = (0, queries_js_1.getTaskLock)(db, taskId);
+    if (!existingLock) {
+        // Race condition: lock was deleted between insert attempt and now
+        // Try to acquire again
+        if ((0, queries_js_1.tryInsertTaskLock)(db, taskId, runnerId, timeoutMinutes)) {
+            const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'acquired_new',
+            };
+        }
+        // Still failed, get the current lock
+        const currentLock = (0, queries_js_1.getTaskLock)(db, taskId);
+        return createLockedError(taskId, currentLock);
+    }
+    // Step 3: Check if we already own the lock
+    if (existingLock.runner_id === runnerId) {
+        // Refresh the lock expiry
+        (0, queries_js_1.extendTaskLock)(db, taskId, runnerId, timeoutMinutes);
+        const updatedLock = (0, queries_js_1.getTaskLock)(db, taskId);
+        return {
+            acquired: true,
+            lock: updatedLock ?? undefined,
+            reason: 'already_owned',
+        };
+    }
+    // Step 4: Check if lock is expired
+    if ((0, queries_js_1.isTaskLockExpired)(existingLock)) {
+        // Try to claim the expired lock atomically
+        if ((0, queries_js_1.claimExpiredTaskLock)(db, taskId, runnerId, timeoutMinutes)) {
+            const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+            return {
+                acquired: true,
+                lock: lock ?? undefined,
+                reason: 'claimed_expired',
+            };
+        }
+        // Another runner claimed it first
+        const currentLock = (0, queries_js_1.getTaskLock)(db, taskId);
+        return createLockedError(taskId, currentLock);
+    }
+    // Step 5: Lock is held by another runner and not expired
+    return createLockedError(taskId, existingLock);
+}
+/**
+ * Create a TASK_LOCKED error response
+ */
+function createLockedError(taskId, lock) {
+    return {
+        acquired: false,
+        error: {
+            code: 'TASK_LOCKED',
+            message: 'Task is locked by another runner',
+            details: {
+                taskId,
+                runnerId: lock?.runner_id,
+                expiresAt: lock?.expires_at,
+            },
+        },
+    };
+}
+// ============ Lock Release ============
+/**
+ * Release a task lock (only by owner)
+ */
+function releaseTaskLock(db, taskId, runnerId) {
+    const existingLock = (0, queries_js_1.getTaskLock)(db, taskId);
+    if (!existingLock) {
+        return {
+            released: false,
+            error: {
+                code: 'LOCK_NOT_FOUND',
+                message: 'Lock does not exist',
+                details: { taskId },
+            },
+        };
+    }
+    if (existingLock.runner_id !== runnerId) {
+        return {
+            released: false,
+            error: {
+                code: 'PERMISSION_DENIED',
+                message: 'Cannot release lock owned by another runner',
+                details: {
+                    taskId,
+                    runnerId: existingLock.runner_id,
+                    expiresAt: existingLock.expires_at,
+                },
+            },
+        };
+    }
+    (0, queries_js_1.releaseTaskLock)(db, taskId, runnerId);
+    return { released: true };
+}
+/**
+ * Force release a task lock (admin operation, ignores owner)
+ */
+function forceRelease(db, taskId) {
+    const existed = (0, queries_js_1.forceReleaseTaskLock)(db, taskId);
+    if (!existed) {
+        return {
+            released: false,
+            error: {
+                code: 'LOCK_NOT_FOUND',
+                message: 'Lock does not exist',
+                details: { taskId },
+            },
+        };
+    }
+    return { released: true };
+}
+// ============ Lock Heartbeat ============
+/**
+ * Update heartbeat for a task lock
+ * Should be called periodically while holding the lock
+ */
+function heartbeat(db, taskId, runnerId) {
+    return (0, queries_js_1.updateTaskLockHeartbeat)(db, taskId, runnerId);
+}
+/**
+ * Extend a task lock's expiry time
+ */
+function extend(db, taskId, runnerId, additionalMinutes = DEFAULT_LOCK_TIMEOUT_MINUTES) {
+    return (0, queries_js_1.extendTaskLock)(db, taskId, runnerId, additionalMinutes);
+}
+// ============ Lock Manager ============
+/**
+ * Create a task lock manager for a specific task
+ * Provides a convenient interface for managing a single lock
+ */
+function createTaskLockManager(db, taskId, runnerId, timeoutMinutes = DEFAULT_LOCK_TIMEOUT_MINUTES) {
+    return {
+        acquire: () => acquireTaskLock(db, taskId, runnerId, timeoutMinutes),
+        release: () => releaseTaskLock(db, taskId, runnerId),
+        heartbeat: () => (0, queries_js_1.updateTaskLockHeartbeat)(db, taskId, runnerId),
+        extend: (additionalMinutes = timeoutMinutes) => (0, queries_js_1.extendTaskLock)(db, taskId, runnerId, additionalMinutes),
+        isHeld: () => {
+            const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+            return lock !== null && lock.runner_id === runnerId && !(0, queries_js_1.isTaskLockExpired)(lock);
+        },
+    };
+}
+/**
+ * Create an automatic heartbeat manager that updates
+ * the lock heartbeat at regular intervals
+ */
+function createHeartbeatLoop(db, taskId, runnerId, intervalMs = HEARTBEAT_INTERVAL_MS) {
+    let intervalId = null;
+    const beat = () => {
+        (0, queries_js_1.updateTaskLockHeartbeat)(db, taskId, runnerId);
+    };
+    const start = () => {
+        if (intervalId)
+            return; // Already running
+        beat(); // Immediate first beat
+        intervalId = setInterval(beat, intervalMs);
+    };
+    const stop = () => {
+        if (intervalId) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+    return { start, stop };
+}
+// ============ Lock Status Check ============
+/**
+ * Check if a task is locked
+ */
+function isTaskLocked(db, taskId) {
+    const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+    if (!lock)
+        return false;
+    return !(0, queries_js_1.isTaskLockExpired)(lock);
+}
+/**
+ * Check if a task is locked by a specific runner
+ */
+function isTaskLockedBy(db, taskId, runnerId) {
+    const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+    if (!lock)
+        return false;
+    return lock.runner_id === runnerId && !(0, queries_js_1.isTaskLockExpired)(lock);
+}
+/**
+ * Get time until lock expires (in milliseconds)
+ * Returns null if not locked, 0 if already expired
+ */
+function getTimeUntilExpiry(db, taskId) {
+    const lock = (0, queries_js_1.getTaskLock)(db, taskId);
+    if (!lock)
+        return null;
+    const expiresAt = new Date(lock.expires_at).getTime();
+    const remaining = expiresAt - Date.now();
+    return Math.max(0, remaining);
+}
+// ============ Constants Export ============
+exports.LOCK_CONSTANTS = {
+    DEFAULT_TIMEOUT_MINUTES: DEFAULT_LOCK_TIMEOUT_MINUTES,
+    HEARTBEAT_INTERVAL_MS,
+};
+//# sourceMappingURL=task-lock.js.map

package/dist/locking/task-lock.js.map

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

package/dist/migrations/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Migration system exports
+ * Re-exports all migration-related functionality
+ */
+export { MigrationEntry, MigrationManifest, AppliedMigration, getBundledManifestPath, getMigrationFilePath, getCachedManifestPath, readBundledManifest, readCachedManifest, cacheManifest, parseManifest, validateManifest, calculateChecksum, verifyChecksum, findPendingMigrations, findOrphanedMigrations, getMigrationById, getCliSupportedVersions, } from './manifest.js';
+export { MigrationResult, MigrationStatus, parseMigrationFile, readMigrationFile, getAppliedMigrations, getDatabaseVersion, createBackup, applyMigration, rollbackMigration, runMigrations, rollbackToVersion, getMigrationStatus, autoMigrate, } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Migration system exports
+ * Re-exports all migration-related functionality
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoMigrate = exports.getMigrationStatus = exports.rollbackToVersion = exports.runMigrations = exports.rollbackMigration = exports.applyMigration = exports.createBackup = exports.getDatabaseVersion = exports.getAppliedMigrations = exports.readMigrationFile = exports.parseMigrationFile = exports.getCliSupportedVersions = exports.getMigrationById = exports.findOrphanedMigrations = exports.findPendingMigrations = exports.verifyChecksum = exports.calculateChecksum = exports.validateManifest = exports.parseManifest = exports.cacheManifest = exports.readCachedManifest = exports.readBundledManifest = exports.getCachedManifestPath = exports.getMigrationFilePath = exports.getBundledManifestPath = void 0;
+// Manifest management
+var manifest_js_1 = require("./manifest.js");
+Object.defineProperty(exports, "getBundledManifestPath", { enumerable: true, get: function () { return manifest_js_1.getBundledManifestPath; } });
+Object.defineProperty(exports, "getMigrationFilePath", { enumerable: true, get: function () { return manifest_js_1.getMigrationFilePath; } });
+Object.defineProperty(exports, "getCachedManifestPath", { enumerable: true, get: function () { return manifest_js_1.getCachedManifestPath; } });
+Object.defineProperty(exports, "readBundledManifest", { enumerable: true, get: function () { return manifest_js_1.readBundledManifest; } });
+Object.defineProperty(exports, "readCachedManifest", { enumerable: true, get: function () { return manifest_js_1.readCachedManifest; } });
+Object.defineProperty(exports, "cacheManifest", { enumerable: true, get: function () { return manifest_js_1.cacheManifest; } });
+Object.defineProperty(exports, "parseManifest", { enumerable: true, get: function () { return manifest_js_1.parseManifest; } });
+Object.defineProperty(exports, "validateManifest", { enumerable: true, get: function () { return manifest_js_1.validateManifest; } });
+Object.defineProperty(exports, "calculateChecksum", { enumerable: true, get: function () { return manifest_js_1.calculateChecksum; } });
+Object.defineProperty(exports, "verifyChecksum", { enumerable: true, get: function () { return manifest_js_1.verifyChecksum; } });
+Object.defineProperty(exports, "findPendingMigrations", { enumerable: true, get: function () { return manifest_js_1.findPendingMigrations; } });
+Object.defineProperty(exports, "findOrphanedMigrations", { enumerable: true, get: function () { return manifest_js_1.findOrphanedMigrations; } });
+Object.defineProperty(exports, "getMigrationById", { enumerable: true, get: function () { return manifest_js_1.getMigrationById; } });
+Object.defineProperty(exports, "getCliSupportedVersions", { enumerable: true, get: function () { return manifest_js_1.getCliSupportedVersions; } });
+// Migration runner
+var runner_js_1 = require("./runner.js");
+Object.defineProperty(exports, "parseMigrationFile", { enumerable: true, get: function () { return runner_js_1.parseMigrationFile; } });
+Object.defineProperty(exports, "readMigrationFile", { enumerable: true, get: function () { return runner_js_1.readMigrationFile; } });
+Object.defineProperty(exports, "getAppliedMigrations", { enumerable: true, get: function () { return runner_js_1.getAppliedMigrations; } });
+Object.defineProperty(exports, "getDatabaseVersion", { enumerable: true, get: function () { return runner_js_1.getDatabaseVersion; } });
+Object.defineProperty(exports, "createBackup", { enumerable: true, get: function () { return runner_js_1.createBackup; } });
+Object.defineProperty(exports, "applyMigration", { enumerable: true, get: function () { return runner_js_1.applyMigration; } });
+Object.defineProperty(exports, "rollbackMigration", { enumerable: true, get: function () { return runner_js_1.rollbackMigration; } });
+Object.defineProperty(exports, "runMigrations", { enumerable: true, get: function () { return runner_js_1.runMigrations; } });
+Object.defineProperty(exports, "rollbackToVersion", { enumerable: true, get: function () { return runner_js_1.rollbackToVersion; } });
+Object.defineProperty(exports, "getMigrationStatus", { enumerable: true, get: function () { return runner_js_1.getMigrationStatus; } });
+Object.defineProperty(exports, "autoMigrate", { enumerable: true, get: function () { return runner_js_1.autoMigrate; } });
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,sBAAsB;AACtB,6CAkBuB;AAdrB,qHAAA,sBAAsB,OAAA;AACtB,mHAAA,oBAAoB,OAAA;AACpB,oHAAA,qBAAqB,OAAA;AACrB,kHAAA,mBAAmB,OAAA;AACnB,iHAAA,kBAAkB,OAAA;AAClB,4GAAA,aAAa,OAAA;AACb,4GAAA,aAAa,OAAA;AACb,+GAAA,gBAAgB,OAAA;AAChB,gHAAA,iBAAiB,OAAA;AACjB,6GAAA,cAAc,OAAA;AACd,oHAAA,qBAAqB,OAAA;AACrB,qHAAA,sBAAsB,OAAA;AACtB,+GAAA,gBAAgB,OAAA;AAChB,sHAAA,uBAAuB,OAAA;AAGzB,mBAAmB;AACnB,yCAcqB;AAXnB,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,iHAAA,oBAAoB,OAAA;AACpB,+GAAA,kBAAkB,OAAA;AAClB,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,8GAAA,iBAAiB,OAAA;AACjB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,wGAAA,WAAW,OAAA"}

package/dist/migrations/manifest.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Migration manifest management
+ * Handles reading, parsing, and validating the migration manifest
+ */
+/**
+ * Single migration entry in the manifest
+ */
+export interface MigrationEntry {
+    id: number;
+    name: string;
+    file: string;
+    description: string;
+    checksum: string;
+    cliVersion: string;
+}
+/**
+ * Migration manifest structure
+ */
+export interface MigrationManifest {
+    version: string;
+    latestDbVersion: number;
+    migrations: MigrationEntry[];
+}
+/**
+ * Applied migration record from database
+ */
+export interface AppliedMigration {
+    id: number;
+    name: string;
+    checksum: string;
+    applied_at: string;
+}
+/**
+ * Get the path to the bundled manifest (in the package)
+ */
+export declare function getBundledManifestPath(): string;
+/**
+ * Get the path to a migration file (in the package)
+ */
+export declare function getMigrationFilePath(filename: string): string;
+/**
+ * Get the path to the cached manifest
+ */
+export declare function getCachedManifestPath(): string;
+/**
+ * Read the bundled manifest from the package
+ */
+export declare function readBundledManifest(): MigrationManifest;
+/**
+ * Read the cached manifest if it exists and is valid
+ */
+export declare function readCachedManifest(): MigrationManifest | null;
+/**
+ * Save manifest to cache
+ */
+export declare function cacheManifest(manifest: MigrationManifest): void;
+/**
+ * Parse and validate manifest content
+ */
+export declare function parseManifest(content: string): MigrationManifest;
+/**
+ * Validate manifest structure
+ */
+export declare function validateManifest(manifest: MigrationManifest): void;
+/**
+ * Calculate SHA256 checksum for migration file content
+ */
+export declare function calculateChecksum(content: string): string;
+/**
+ * Verify checksum matches
+ */
+export declare function verifyChecksum(content: string, expectedChecksum: string): boolean;
+/**
+ * Find pending migrations that need to be applied
+ */
+export declare function findPendingMigrations(manifest: MigrationManifest, appliedMigrations: AppliedMigration[]): MigrationEntry[];
+/**
+ * Find migrations to rollback (applied but not in manifest)
+ */
+export declare function findOrphanedMigrations(manifest: MigrationManifest, appliedMigrations: AppliedMigration[]): AppliedMigration[];
+/**
+ * Get migration entry by ID
+ */
+export declare function getMigrationById(manifest: MigrationManifest, id: number): MigrationEntry | null;
+/**
+ * Get the current supported database version range for this CLI
+ */
+export declare function getCliSupportedVersions(manifest: MigrationManifest): {
+    min: number;
+    max: number;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/migrations/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/migrations/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6EH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CASvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,GAAG,IAAI,CAkB7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAIhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAmClE;AA6BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAQjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,iBAAiB,EAAE,gBAAgB,EAAE,GACpC,cAAc,EAAE,CAGlB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,iBAAiB,EAAE,gBAAgB,EAAE,GACpC,gBAAgB,EAAE,CAGpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAE/F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CASjG"}

package/dist/migrations/manifest.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * Migration manifest management
+ * Handles reading, parsing, and validating the migration manifest
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBundledManifestPath = getBundledManifestPath;
+exports.getMigrationFilePath = getMigrationFilePath;
+exports.getCachedManifestPath = getCachedManifestPath;
+exports.readBundledManifest = readBundledManifest;
+exports.readCachedManifest = readCachedManifest;
+exports.cacheManifest = cacheManifest;
+exports.parseManifest = parseManifest;
+exports.validateManifest = validateManifest;
+exports.calculateChecksum = calculateChecksum;
+exports.verifyChecksum = verifyChecksum;
+exports.findPendingMigrations = findPendingMigrations;
+exports.findOrphanedMigrations = findOrphanedMigrations;
+exports.getMigrationById = getMigrationById;
+exports.getCliSupportedVersions = getCliSupportedVersions;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const node_os_1 = require("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 = (0, node_path_1.dirname)(process.argv[1]);
+        for (let i = 0; i < 5; i++) {
+            candidates.push(dir);
+            dir = (0, node_path_1.dirname)(dir);
+        }
+    }
+    // Strategy 2: Check require.main.filename if available
+    if (require.main?.filename) {
+        let dir = (0, node_path_1.dirname)(require.main.filename);
+        for (let i = 0; i < 5; i++) {
+            candidates.push(dir);
+            dir = (0, node_path_1.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 = (0, node_path_1.dirname)(dir);
+        }
+    }
+    // Find the first candidate that contains package.json with name 'steroids-cli'
+    for (const dir of candidates) {
+        const pkgPath = (0, node_path_1.join)(dir, 'package.json');
+        if ((0, node_fs_1.existsSync)(pkgPath)) {
+            try {
+                const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, 'utf-8'));
+                if (pkg.name === 'steroids-cli') {
+                    _packageRoot = dir;
+                    return dir;
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // Last resort: try cwd (useful during development)
+    const cwdPkg = (0, node_path_1.join)(process.cwd(), 'package.json');
+    if ((0, node_fs_1.existsSync)(cwdPkg)) {
+        try {
+            const pkg = JSON.parse((0, node_fs_1.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 = (0, node_path_1.join)((0, node_os_1.homedir)(), '.steroids');
+const CACHE_DIR = (0, node_path_1.join)(GLOBAL_STEROIDS_DIR, 'migrations');
+const CACHE_FILE = (0, node_path_1.join)(CACHE_DIR, 'manifest-cache.json');
+/**
+ * Get the path to the bundled manifest (in the package)
+ */
+function getBundledManifestPath() {
+    // Resolve relative to CLI package root, not cwd
+    return (0, node_path_1.join)(getPackageRoot(), 'migrations', 'manifest.json');
+}
+/**
+ * Get the path to a migration file (in the package)
+ */
+function getMigrationFilePath(filename) {
+    return (0, node_path_1.join)(getPackageRoot(), 'migrations', filename);
+}
+/**
+ * Get the path to the cached manifest
+ */
+function getCachedManifestPath() {
+    return (0, node_path_1.join)(CACHE_DIR, 'manifest.json');
+}
+/**
+ * Read the bundled manifest from the package
+ */
+function readBundledManifest() {
+    const manifestPath = getBundledManifestPath();
+    if (!(0, node_fs_1.existsSync)(manifestPath)) {
+        throw new Error(`Bundled manifest not found at: ${manifestPath}`);
+    }
+    const content = (0, node_fs_1.readFileSync)(manifestPath, 'utf-8');
+    return parseManifest(content);
+}
+/**
+ * Read the cached manifest if it exists and is valid
+ */
+function readCachedManifest() {
+    if (!(0, node_fs_1.existsSync)(CACHE_FILE)) {
+        return null;
+    }
+    try {
+        const cacheContent = (0, node_fs_1.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
+ */
+function cacheManifest(manifest) {
+    if (!(0, node_fs_1.existsSync)(CACHE_DIR)) {
+        (0, node_fs_1.mkdirSync)(CACHE_DIR, { recursive: true });
+    }
+    const cache = {
+        fetchedAt: Date.now(),
+        manifest,
+    };
+    (0, node_fs_1.writeFileSync)(CACHE_FILE, JSON.stringify(cache, null, 2));
+    // Also save the manifest itself for offline access
+    (0, node_fs_1.writeFileSync)(getCachedManifestPath(), JSON.stringify(manifest, null, 2));
+}
+/**
+ * Parse and validate manifest content
+ */
+function parseManifest(content) {
+    const manifest = JSON.parse(content);
+    validateManifest(manifest);
+    return manifest;
+}
+/**
+ * Validate manifest structure
+ */
+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
+ */
+function calculateChecksum(content) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    hash.update(content);
+    return `sha256:${hash.digest('hex')}`;
+}
+/**
+ * Verify checksum matches
+ */
+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
+ */
+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)
+ */
+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
+ */
+function getMigrationById(manifest, id) {
+    return manifest.migrations.find(m => m.id === id) ?? null;
+}
+/**
+ * Get the current supported database version range for this CLI
+ */
+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