sandstream-kit 1.0.0

package/dist/migration-runner.js

@@ -0,0 +1,192 @@
+// ─── Migration Runner ────────────────────────────────────────────────────────
+import { MIGRATIONS } from "./migrations.js";
+/**
+ * Migration runner with status tracking and rollback support.
+ */
+export class MigrationRunner {
+    db;
+    executedMigrations = new Set();
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Initialize migration tracking tables and load executed migrations.
+     */
+    async init() {
+        // Create migrations table if not exists
+        await this.db.query(`
+      CREATE TABLE IF NOT EXISTS schema_migrations (
+        id VARCHAR(255) PRIMARY KEY,
+        name VARCHAR(255) NOT NULL,
+        version VARCHAR(20) NOT NULL,
+        executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        rolled_back_at TIMESTAMP,
+        execution_time INTEGER,
+        status VARCHAR(20) DEFAULT 'success'
+      )
+    `);
+        // Load executed migrations
+        const result = await this.db.query("SELECT id FROM schema_migrations WHERE rolled_back_at IS NULL AND status = 'success'");
+        for (const row of result.rows) {
+            this.executedMigrations.add(row.id);
+        }
+    }
+    /**
+     * Get list of pending migrations.
+     */
+    getPendingMigrations() {
+        return MIGRATIONS.filter((m) => !this.executedMigrations.has(m.id));
+    }
+    /**
+     * Get list of executed migrations.
+     */
+    getExecutedMigrations() {
+        return MIGRATIONS.filter((m) => this.executedMigrations.has(m.id));
+    }
+    /**
+     * Run all pending migrations.
+     */
+    async runPending() {
+        await this.init();
+        const pending = this.getPendingMigrations();
+        const errors = [];
+        let executed = 0;
+        for (const migration of pending) {
+            try {
+                const startTime = Date.now();
+                // Execute migration in transaction
+                await this.db.transaction(async (db) => {
+                    await db.query(migration.sql);
+                    await db.query(`INSERT INTO schema_migrations (id, name, version, execution_time, status)
+             VALUES ($1, $2, $3, $4, 'success')`, [migration.id, migration.name, migration.version, Date.now() - startTime]);
+                });
+                this.executedMigrations.add(migration.id);
+                executed++;
+                console.log(`✓ ${migration.name}`);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                errors.push({
+                    migration: migration.name,
+                    error: errorMsg,
+                });
+                // Mark as failed
+                await this.db.query(`INSERT INTO schema_migrations (id, name, version, status)
+           VALUES ($1, $2, $3, 'failed')`, [migration.id, migration.name, migration.version]);
+                console.error(`✗ ${migration.name}: ${errorMsg}`);
+            }
+        }
+        return {
+            executed,
+            failed: errors.length,
+            total: pending.length,
+            errors,
+        };
+    }
+    /**
+     * Run a specific migration by ID.
+     */
+    async runMigration(migrationId) {
+        await this.init();
+        const migration = MIGRATIONS.find((m) => m.id === migrationId);
+        if (!migration) {
+            return { success: false, error: `Migration ${migrationId} not found` };
+        }
+        if (this.executedMigrations.has(migrationId)) {
+            return { success: false, error: `Migration ${migrationId} already executed` };
+        }
+        try {
+            const startTime = Date.now();
+            await this.db.transaction(async (db) => {
+                await db.query(migration.sql);
+                await db.query(`INSERT INTO schema_migrations (id, name, version, execution_time, status)
+           VALUES ($1, $2, $3, $4, 'success')`, [migration.id, migration.name, migration.version, Date.now() - startTime]);
+            });
+            this.executedMigrations.add(migrationId);
+            console.log(`✓ ${migration.name}`);
+            return { success: true };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            await this.db.query(`INSERT INTO schema_migrations (id, name, version, status)
+         VALUES ($1, $2, $3, 'failed')`, [migration.id, migration.name, migration.version]);
+            console.error(`✗ ${migration.name}: ${errorMsg}`);
+            return { success: false, error: errorMsg };
+        }
+    }
+    /**
+     * Get migration status summary.
+     */
+    async getStatus() {
+        await this.init();
+        const failedResult = await this.db.query("SELECT COUNT(*) as count FROM schema_migrations WHERE status = 'failed'");
+        const failedCount = failedResult.rows[0]?.count || 0;
+        return {
+            executed: this.executedMigrations.size,
+            pending: this.getPendingMigrations().length,
+            failed: failedCount,
+            total: MIGRATIONS.length,
+        };
+    }
+    /**
+     * Print migration report to console.
+     */
+    async printReport() {
+        const status = await this.getStatus();
+        const executed = this.getExecutedMigrations();
+        const pending = this.getPendingMigrations();
+        console.log("\n┌─ Migration Status ─────────────────────────────────────────┐");
+        console.log(`│ Executed: ${String(status.executed).padEnd(50)} │`);
+        console.log(`│ Pending:  ${String(status.pending).padEnd(50)} │`);
+        console.log(`│ Failed:   ${String(status.failed).padEnd(50)} │`);
+        console.log(`│ Total:    ${String(status.total).padEnd(50)} │`);
+        console.log("└────────────────────────────────────────────────────────────┘\n");
+        if (executed.length > 0) {
+            console.log("Executed Migrations:");
+            for (const m of executed) {
+                console.log(`  ✓ ${m.id}: ${m.name}`);
+            }
+            console.log();
+        }
+        if (pending.length > 0) {
+            console.log("Pending Migrations:");
+            for (const m of pending) {
+                console.log(`  ○ ${m.id}: ${m.name}`);
+            }
+            console.log();
+        }
+    }
+}
+/**
+ * Create backup before migrations.
+ */
+export async function createPreMigrationBackup(db) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const backupName = `pre-migration-${timestamp}`;
+    const result = await db.createBackup(backupName);
+    return result.backupFile;
+}
+/**
+ * Run migrations with backup strategy.
+ */
+export async function runMigrationsWithBackup(db) {
+    // Create backup
+    const backupFile = await createPreMigrationBackup(db);
+    console.log(`Backup created: ${backupFile}`);
+    // Run migrations
+    const runner = new MigrationRunner(db);
+    const result = await runner.runPending();
+    if (result.failed > 0) {
+        console.error("\nMigrations failed! Consider restoring backup:");
+        console.error(`  db.restoreBackup('${backupFile}')`);
+        return {
+            success: false,
+            backupFile,
+            errors: result.errors.map((e) => `${e.migration}: ${e.error}`),
+        };
+    }
+    console.log(`\n${result.executed} migrations executed successfully`);
+    await runner.printReport();
+    return { success: true, backupFile };
+}
+//# sourceMappingURL=migration-runner.js.map

package/dist/migration-runner.js.map

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

package/dist/migrations.d.ts

@@ -0,0 +1,25 @@
+import { type Migration } from "./database.js";
+/**
+ * All database migrations for kit marketplace.
+ * Execute in order by version number.
+ */
+export declare const MIGRATIONS: Migration[];
+/**
+ * Get migration by ID.
+ */
+export declare function getMigrationById(id: string): Migration | undefined;
+/**
+ * Get all migrations after a specific version.
+ */
+export declare function getMigrationsAfter(version: string): Migration[];
+/**
+ * Get total migration count.
+ */
+export declare function getMigrationCount(): number;
+/**
+ * Generate migration summary.
+ */
+export declare function getMigrationSummary(): {
+    total: number;
+    byVersion: Record<string, number>;
+};