@shepai/cli 1.111.0 → 1.112.0

package/dist/packages/core/src/infrastructure/persistence/sqlite/sqlite-migration-storage.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Custom umzug storage adapter for better-sqlite3.
+ *
+ * Wraps better-sqlite3's synchronous API in async methods to satisfy
+ * umzug's UmzugStorage interface. Manages the `umzug_migrations` tracking
+ * table with columns: name (TEXT PK) and created_at (TEXT NOT NULL).
+ *
+ * Includes a bootstrap seeder that auto-detects existing databases
+ * (PRAGMA user_version > 0 with empty umzug_migrations table) and seeds
+ * migration records for versions 1 through user_version.
+ */
+import type Database from 'better-sqlite3';
+import type { UmzugStorage, MigrationParams } from 'umzug';
+/**
+ * SQLite-backed migration storage for umzug.
+ *
+ * Tracks which migrations have been applied in a `umzug_migrations` table
+ * within the same SQLite database as the application data.
+ */
+export declare class SQLiteMigrationStorage implements UmzugStorage<Database.Database> {
+    private readonly db;
+    /**
+     * @param db - The better-sqlite3 database instance.
+     * @param legacyMigrationNames - Ordered list of legacy migration names (e.g.,
+     *   ['001-create-settings-table', '002-add-agent-config', ...]). When provided,
+     *   the constructor checks if this is an existing database transitioning from
+     *   PRAGMA user_version tracking and seeds the umzug_migrations table accordingly.
+     */
+    constructor(db: Database.Database, legacyMigrationNames?: string[]);
+    /**
+     * Returns the names of all executed migrations, sorted lexicographically.
+     */
+    executed(_meta: Pick<MigrationParams<Database.Database>, 'context'>): Promise<string[]>;
+    /**
+     * Records a migration as executed.
+     */
+    logMigration(params: MigrationParams<Database.Database>): Promise<void>;
+    /**
+     * Removes a migration record (marks it as pending).
+     */
+    unlogMigration(params: MigrationParams<Database.Database>): Promise<void>;
+    /**
+     * Creates the umzug_migrations table if it does not exist.
+     */
+    private ensureTable;
+    /**
+     * Auto-detects existing databases that used PRAGMA user_version tracking
+     * and seeds the umzug_migrations table so umzug does not re-apply them.
+     *
+     * Conditions for bootstrap:
+     * - PRAGMA user_version > 0 (database has been migrated before)
+     * - umzug_migrations table is empty (not yet transitioned to umzug)
+     *
+     * When both conditions are met, inserts records for migrations 1 through
+     * user_version using the provided legacy migration names.
+     */
+    private bootstrapLegacyMigrations;
+}
+//# sourceMappingURL=sqlite-migration-storage.d.ts.map

package/dist/packages/core/src/infrastructure/persistence/sqlite/sqlite-migration-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-migration-storage.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/infrastructure/persistence/sqlite/sqlite-migration-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IAEvC;;;;;;OAMG;gBACS,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,MAAM,EAAE;IAQlE;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO7F;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;CA+BlC"}

package/dist/packages/core/src/infrastructure/persistence/sqlite/sqlite-migration-storage.js

@@ -0,0 +1,98 @@
+/**
+ * Custom umzug storage adapter for better-sqlite3.
+ *
+ * Wraps better-sqlite3's synchronous API in async methods to satisfy
+ * umzug's UmzugStorage interface. Manages the `umzug_migrations` tracking
+ * table with columns: name (TEXT PK) and created_at (TEXT NOT NULL).
+ *
+ * Includes a bootstrap seeder that auto-detects existing databases
+ * (PRAGMA user_version > 0 with empty umzug_migrations table) and seeds
+ * migration records for versions 1 through user_version.
+ */
+/**
+ * SQLite-backed migration storage for umzug.
+ *
+ * Tracks which migrations have been applied in a `umzug_migrations` table
+ * within the same SQLite database as the application data.
+ */
+export class SQLiteMigrationStorage {
+    db;
+    /**
+     * @param db - The better-sqlite3 database instance.
+     * @param legacyMigrationNames - Ordered list of legacy migration names (e.g.,
+     *   ['001-create-settings-table', '002-add-agent-config', ...]). When provided,
+     *   the constructor checks if this is an existing database transitioning from
+     *   PRAGMA user_version tracking and seeds the umzug_migrations table accordingly.
+     */
+    constructor(db, legacyMigrationNames) {
+        this.db = db;
+        this.ensureTable();
+        if (legacyMigrationNames && legacyMigrationNames.length > 0) {
+            this.bootstrapLegacyMigrations(legacyMigrationNames);
+        }
+    }
+    /**
+     * Returns the names of all executed migrations, sorted lexicographically.
+     */
+    async executed(_meta) {
+        const rows = this.db.prepare('SELECT name FROM umzug_migrations ORDER BY name').all();
+        return rows.map((r) => r.name);
+    }
+    /**
+     * Records a migration as executed.
+     */
+    async logMigration(params) {
+        this.db
+            .prepare('INSERT INTO umzug_migrations (name, created_at) VALUES (?, ?)')
+            .run(params.name, new Date().toISOString());
+    }
+    /**
+     * Removes a migration record (marks it as pending).
+     */
+    async unlogMigration(params) {
+        this.db.prepare('DELETE FROM umzug_migrations WHERE name = ?').run(params.name);
+    }
+    /**
+     * Creates the umzug_migrations table if it does not exist.
+     */
+    ensureTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS umzug_migrations (
+        name TEXT PRIMARY KEY NOT NULL,
+        created_at TEXT NOT NULL
+      )
+    `);
+    }
+    /**
+     * Auto-detects existing databases that used PRAGMA user_version tracking
+     * and seeds the umzug_migrations table so umzug does not re-apply them.
+     *
+     * Conditions for bootstrap:
+     * - PRAGMA user_version > 0 (database has been migrated before)
+     * - umzug_migrations table is empty (not yet transitioned to umzug)
+     *
+     * When both conditions are met, inserts records for migrations 1 through
+     * user_version using the provided legacy migration names.
+     */
+    bootstrapLegacyMigrations(legacyMigrationNames) {
+        const result = this.db.prepare('PRAGMA user_version').get();
+        const userVersion = result.user_version;
+        if (userVersion <= 0) {
+            return;
+        }
+        const count = this.db.prepare('SELECT COUNT(*) as count FROM umzug_migrations').get();
+        if (count.count > 0) {
+            return;
+        }
+        // Seed records for migrations 1 through user_version
+        const now = new Date().toISOString();
+        const insert = this.db.prepare('INSERT INTO umzug_migrations (name, created_at) VALUES (?, ?)');
+        const seedAll = this.db.transaction(() => {
+            const count = Math.min(userVersion, legacyMigrationNames.length);
+            for (let i = 0; i < count; i++) {
+                insert.run(legacyMigrationNames[i], now);
+            }
+        });
+        seedAll();
+    }
+}