@dotdo/postgres 0.1.0

package/dist/worker/migration-manager.js

@@ -0,0 +1,461 @@
+import { SchemaVersionManager } from './schema-version';
+/**
+ * DO Storage keys for migration tracking
+ */
+const SCHEMA_VERSION_KEY = '__postgres_schema_version__';
+const MIGRATION_STATE_KEY = '__postgres_migration_state__';
+/**
+ * MigrationManager handles all migration-related functionality for PostgresDO.
+ *
+ * Features:
+ * - Schema version tracking via DO storage
+ * - Migration execution with transaction support
+ * - Progress callbacks for monitoring
+ * - Support for on-create and on-demand strategies
+ * - Concurrent migration protection
+ *
+ * @example
+ * ```typescript
+ * const migrationManager = new MigrationManager(
+ *   state.storage,
+ *   pglite,
+ *   { migrations: { migrations: [...] } }
+ * )
+ *
+ * // Run migrations
+ * const result = await migrationManager.ensureMigrated()
+ *
+ * // Check status
+ * console.log('Current version:', await migrationManager.getSchemaVersion())
+ * ```
+ */
+export class MigrationManager {
+    storage;
+    executor = null;
+    config;
+    migrated = false;
+    migratePromise = null;
+    schemaVersionManager = null;
+    constructor(storage, executor, config = {}) {
+        this.storage = storage;
+        this.executor = executor;
+        this.config = config;
+    }
+    /**
+     * Set the query executor (called after PGlite initialization)
+     */
+    setExecutor(executor) {
+        this.executor = executor;
+        this.schemaVersionManager = null; // Reset to recreate with new executor
+    }
+    /**
+     * Get the current schema version from DO storage
+     * Returns 0 if no migrations have been applied (fresh database)
+     */
+    async getSchemaVersion() {
+        const version = await this.storage.get(SCHEMA_VERSION_KEY);
+        return version ?? 0;
+    }
+    /**
+     * Set the schema version in DO storage
+     */
+    async setSchemaVersion(version) {
+        await this.storage.put(SCHEMA_VERSION_KEY, version);
+    }
+    /**
+     * Check if this is a fresh database (no schema version set)
+     */
+    async isFreshDatabase() {
+        const version = await this.storage.get(SCHEMA_VERSION_KEY);
+        return version === undefined;
+    }
+    /**
+     * Check if migrations have been applied this session
+     */
+    isMigrated() {
+        return this.migrated;
+    }
+    /**
+     * Get the migration strategy from configuration
+     */
+    getMigrationStrategy() {
+        return this.config.migrations?.strategy ?? 'on-create';
+    }
+    /**
+     * Get the current migration state from DO storage
+     */
+    async getMigrationState() {
+        return (await this.storage.get(MIGRATION_STATE_KEY)) ?? null;
+    }
+    /**
+     * Update the migration state in DO storage
+     */
+    async setMigrationState(state) {
+        await this.storage.put(MIGRATION_STATE_KEY, state);
+    }
+    /**
+     * Get the schema version manager instance
+     * Creates one if it doesn't exist and executor is available
+     */
+    getSchemaVersionManager() {
+        if (!this.executor) {
+            return null;
+        }
+        if (!this.schemaVersionManager) {
+            // Build config without undefined values for exactOptionalPropertyTypes
+            const schemaVersionConfig = {};
+            if (this.config.debug !== undefined) {
+                schemaVersionConfig.debug = this.config.debug;
+            }
+            this.schemaVersionManager = new SchemaVersionManager(this.executor, schemaVersionConfig);
+        }
+        return this.schemaVersionManager;
+    }
+    /**
+     * Add a listener for migration events
+     */
+    onMigrationEvent(listener) {
+        const manager = this.getSchemaVersionManager();
+        if (manager) {
+            return manager.onMigrationEvent(listener);
+        }
+        return () => { };
+    }
+    /**
+     * Run a single migration
+     */
+    async runSingleMigration(migration, index, total, onProgress) {
+        if (!this.executor) {
+            return {
+                success: false,
+                id: migration.id,
+                executionTimeMs: 0,
+                error: 'Executor not initialized',
+            };
+        }
+        const startTime = performance.now();
+        // Emit progress: starting
+        onProgress?.({
+            migration,
+            index,
+            total,
+            phase: 'starting',
+        });
+        try {
+            // Check if already applied via DO storage
+            const currentVersion = await this.getSchemaVersion();
+            if (migration.version <= currentVersion) {
+                return {
+                    success: true,
+                    id: migration.id,
+                    executionTimeMs: 0,
+                    skipped: true,
+                };
+            }
+            // Emit progress: executing
+            onProgress?.({
+                migration,
+                index,
+                total,
+                phase: 'executing',
+            });
+            // Execute migration SQL within a transaction
+            await this.executor.query('BEGIN');
+            try {
+                // Execute the migration SQL (may contain multiple statements)
+                if (this.executor.exec) {
+                    await this.executor.exec(migration.sql);
+                }
+                else {
+                    // Fallback: split by semicolons (basic approach)
+                    const statements = migration.sql
+                        .split(';')
+                        .map((s) => s.trim())
+                        .filter((s) => s.length > 0);
+                    for (const stmt of statements) {
+                        await this.executor.query(stmt);
+                    }
+                }
+                // Update schema version in DO storage
+                await this.setSchemaVersion(migration.version);
+                await this.executor.query('COMMIT');
+            }
+            catch (error) {
+                await this.executor.query('ROLLBACK');
+                throw error;
+            }
+            const executionTimeMs = performance.now() - startTime;
+            // Emit progress: completed
+            onProgress?.({
+                migration,
+                index,
+                total,
+                phase: 'completed',
+                durationMs: executionTimeMs,
+            });
+            return {
+                success: true,
+                id: migration.id,
+                executionTimeMs,
+            };
+        }
+        catch (error) {
+            const executionTimeMs = performance.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            // Emit progress: failed
+            onProgress?.({
+                migration,
+                index,
+                total,
+                phase: 'failed',
+                durationMs: executionTimeMs,
+                error: errorMessage,
+            });
+            return {
+                success: false,
+                id: migration.id,
+                executionTimeMs,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Run all pending migrations in sequence
+     * This method is safe to call multiple times - it will skip already-applied migrations
+     */
+    async runMigrations(migrations, onProgress) {
+        const startTime = performance.now();
+        const fromVersion = await this.getSchemaVersion();
+        // Sort migrations by version
+        const sortedMigrations = [...migrations].sort((a, b) => a.version - b.version);
+        // Filter to only pending migrations
+        const pendingMigrations = sortedMigrations.filter((m) => m.version > fromVersion);
+        if (pendingMigrations.length === 0) {
+            return {
+                success: true,
+                fromVersion,
+                toVersion: fromVersion,
+                durationMs: 0,
+                results: [],
+                migrationsRun: 0,
+                migrationsSkipped: sortedMigrations.length,
+            };
+        }
+        const results = [];
+        let migrationsRun = 0;
+        let migrationsSkipped = sortedMigrations.length - pendingMigrations.length;
+        for (let i = 0; i < pendingMigrations.length; i++) {
+            const migration = pendingMigrations[i];
+            if (!migration)
+                continue;
+            const result = await this.runSingleMigration(migration, i, pendingMigrations.length, onProgress);
+            results.push(result);
+            if (result.skipped) {
+                migrationsSkipped++;
+            }
+            else if (result.success) {
+                migrationsRun++;
+            }
+            else {
+                // Migration failed - stop here
+                const durationMs = performance.now() - startTime;
+                const toVersion = await this.getSchemaVersion();
+                return {
+                    success: false,
+                    fromVersion,
+                    toVersion,
+                    durationMs,
+                    results,
+                    migrationsRun,
+                    migrationsSkipped,
+                };
+            }
+        }
+        const durationMs = performance.now() - startTime;
+        const toVersion = await this.getSchemaVersion();
+        return {
+            success: true,
+            fromVersion,
+            toVersion,
+            durationMs,
+            results,
+            migrationsRun,
+            migrationsSkipped,
+        };
+    }
+    /**
+     * Ensure database is migrated to latest version
+     *
+     * @returns Migration result or null if no migrations configured
+     */
+    async ensureMigrated() {
+        // If already migrated this session, return early
+        if (this.migrated) {
+            return null;
+        }
+        // If no migrations configured, mark as migrated and return
+        const migrations = this.config.migrations?.migrations;
+        if (!migrations || migrations.length === 0) {
+            this.migrated = true;
+            return null;
+        }
+        // If already running migrations, wait for that to complete
+        if (this.migratePromise) {
+            return this.migratePromise;
+        }
+        // Ensure executor is available
+        if (!this.executor) {
+            throw new Error('Executor not initialized - cannot run migrations');
+        }
+        // Run migrations with deduplication
+        this.migratePromise = this.performMigrations();
+        try {
+            const result = await this.migratePromise;
+            // result is non-null here because performMigrations() returns BatchMigrationResult
+            this.migrated = result.success;
+            return result;
+        }
+        finally {
+            this.migratePromise = null;
+        }
+    }
+    /**
+     * Internal migration implementation
+     */
+    async performMigrations() {
+        const migrationConfig = this.config.migrations;
+        const migrations = migrationConfig.migrations;
+        const onProgress = migrationConfig.onProgress;
+        return this.runMigrations(migrations, onProgress);
+    }
+    /**
+     * Check if migrations need to run (for lazy migration strategy)
+     */
+    async needsLazyMigration() {
+        const strategy = this.getMigrationStrategy();
+        if (strategy !== 'on-demand') {
+            return false;
+        }
+        const migrations = this.config.migrations?.migrations;
+        if (!migrations || migrations.length === 0) {
+            return false;
+        }
+        // Already marked as migrated this session
+        if (this.migrated) {
+            return false;
+        }
+        // Check DO storage for migration state
+        const migrationState = await this.getMigrationState();
+        // If no state exists, we need to run migrations
+        if (!migrationState) {
+            return true;
+        }
+        // If status is completed, check if we have new migrations
+        if (migrationState.status === 'completed') {
+            // Compare current version with highest migration version
+            const highestVersion = Math.max(...migrations.map((m) => m.version));
+            return migrationState.version < highestVersion;
+        }
+        // If status is 'pending' or 'failed', we need to retry
+        return migrationState.status !== 'in-progress';
+    }
+    /**
+     * Run lazy migrations (on-demand strategy)
+     */
+    async runLazyMigrations() {
+        // If already migrated this session, return early
+        if (this.migrated) {
+            return null;
+        }
+        const migrations = this.config.migrations?.migrations;
+        if (!migrations || migrations.length === 0) {
+            this.migrated = true;
+            return null;
+        }
+        // Set state to in-progress
+        await this.setMigrationState({
+            status: 'in-progress',
+            version: await this.getSchemaVersion(),
+            lastAttemptAt: new Date().toISOString(),
+        });
+        const startTime = performance.now();
+        try {
+            const result = await this.runMigrations(migrations, this.config.migrations?.onProgress);
+            const durationMs = Math.round(performance.now() - startTime);
+            if (result.success) {
+                this.migrated = true;
+                await this.setMigrationState({
+                    status: 'completed',
+                    version: result.toVersion,
+                    lastAttemptAt: new Date().toISOString(),
+                    durationMs,
+                });
+            }
+            else {
+                const failedMigration = result.results.find((r) => !r.success);
+                await this.setMigrationState({
+                    status: 'failed',
+                    version: result.toVersion,
+                    lastAttemptAt: new Date().toISOString(),
+                    error: failedMigration?.error ?? 'Unknown error',
+                    durationMs,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            const durationMs = Math.round(performance.now() - startTime);
+            await this.setMigrationState({
+                status: 'failed',
+                version: await this.getSchemaVersion(),
+                lastAttemptAt: new Date().toISOString(),
+                error: error instanceof Error ? error.message : 'Unknown error',
+                durationMs,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Ensure migrations have run (for on-demand strategy)
+     *
+     * This should be called before executing queries when using lazy migration.
+     * It's safe to call multiple times - migrations only run once.
+     */
+    async ensureMigratedForQuery() {
+        // Check if we need lazy migration
+        if (!(await this.needsLazyMigration())) {
+            return null;
+        }
+        // Use existing promise if migration is already running
+        if (this.migratePromise) {
+            return this.migratePromise;
+        }
+        // Run lazy migrations
+        this.migratePromise = this.runLazyMigrations();
+        try {
+            return await this.migratePromise;
+        }
+        finally {
+            this.migratePromise = null;
+        }
+    }
+    /**
+     * Check if auto-migration should run during initialization
+     */
+    shouldAutoMigrate() {
+        const strategy = this.getMigrationStrategy();
+        if (strategy !== 'on-create') {
+            return false;
+        }
+        const shouldAutoMigrate = this.config.migrations?.autoMigrate !== false;
+        const hasMigrations = (this.config.migrations?.migrations?.length ?? 0) > 0;
+        return shouldAutoMigrate && hasMigrations;
+    }
+}
+/**
+ * Create a migration manager instance
+ */
+export function createMigrationManager(storage, executor, config = {}) {
+    return new MigrationManager(storage, executor, config);
+}
+//# sourceMappingURL=migration-manager.js.map

package/dist/worker/migration-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-manager.js","sourceRoot":"","sources":["../../src/worker/migration-manager.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,oBAAoB,EAA+B,MAAM,kBAAkB,CAAA;AAEpF;;GAEG;AACH,MAAM,kBAAkB,GAAG,6BAA6B,CAAA;AACxD,MAAM,mBAAmB,GAAG,8BAA8B,CAAA;AA2B1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,gBAAgB;IACnB,OAAO,CAAsB;IAC7B,QAAQ,GAAyB,IAAI,CAAA;IACrC,MAAM,CAAwB;IAC9B,QAAQ,GAAG,KAAK,CAAA;IAChB,cAAc,GAAgD,IAAI,CAAA;IAClE,oBAAoB,GAAgC,IAAI,CAAA;IAEhE,YACE,OAA6B,EAC7B,QAA8B,EAC9B,SAAiC,EAAE;QAEnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAuB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA,CAAC,sCAAsC;IACzE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAS,kBAAkB,CAAC,CAAA;QAClE,OAAO,OAAO,IAAI,CAAC,CAAA;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAA;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAS,kBAAkB,CAAC,CAAA;QAClE,OAAO,OAAO,KAAK,SAAS,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,IAAI,WAAW,CAAA;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAiB,mBAAmB,CAAC,CAAC,IAAI,IAAI,CAAA;IAC9E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAqB;QAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAA;IACpD,CAAC;IAED;;;OAGG;IACH,uBAAuB;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,uEAAuE;YACvE,MAAM,mBAAmB,GAAwB,EAAE,CAAA;YACnD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpC,mBAAmB,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAA;YAC/C,CAAC;YACD,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAA;QAC1F,CAAC;QAED,OAAO,IAAI,CAAC,oBAAoB,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAgC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAA;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,SAAyB,EACzB,KAAa,EACb,KAAa,EACb,UAAoD;QAEpD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,eAAe,EAAE,CAAC;gBAClB,KAAK,EAAE,0BAA0B;aAClC,CAAA;QACH,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAEnC,0BAA0B;QAC1B,UAAU,EAAE,CAAC;YACX,SAAS;YACT,KAAK;YACL,KAAK;YACL,KAAK,EAAE,UAAU;SAClB,CAAC,CAAA;QAEF,IAAI,CAAC;YACH,0CAA0C;YAC1C,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;YACpD,IAAI,SAAS,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;gBACxC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,eAAe,EAAE,CAAC;oBAClB,OAAO,EAAE,IAAI;iBACd,CAAA;YACH,CAAC;YAED,2BAA2B;YAC3B,UAAU,EAAE,CAAC;gBACX,SAAS;gBACT,KAAK;gBACL,KAAK;gBACL,KAAK,EAAE,WAAW;aACnB,CAAC,CAAA;YAEF,6CAA6C;YAC7C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAClC,IAAI,CAAC;gBACH,8DAA8D;gBAC9D,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;gBACzC,CAAC;qBAAM,CAAC;oBACN,iDAAiD;oBACjD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG;yBAC7B,KAAK,CAAC,GAAG,CAAC;yBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;oBAC9B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;wBAC9B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBACjC,CAAC;gBACH,CAAC;gBAED,sCAAsC;gBACtC,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;gBAE9C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;gBACrC,MAAM,KAAK,CAAA;YACb,CAAC;YAED,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;YAErD,2BAA2B;YAC3B,UAAU,EAAE,CAAC;gBACX,SAAS;gBACT,KAAK;gBACL,KAAK;gBACL,KAAK,EAAE,WAAW;gBAClB,UAAU,EAAE,eAAe;aAC5B,CAAC,CAAA;YAEF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,eAAe;aAChB,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;YACrD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;YAE7E,wBAAwB;YACxB,UAAU,EAAE,CAAC;gBACX,SAAS;gBACT,KAAK;gBACL,KAAK;gBACL,KAAK,EAAE,QAAQ;gBACf,UAAU,EAAE,eAAe;gBAC3B,KAAK,EAAE,YAAY;aACpB,CAAC,CAAA;YAEF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,eAAe;gBACf,KAAK,EAAE,YAAY;aACpB,CAAA;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,UAA4B,EAC5B,UAAoD;QAEpD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QACnC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAEjD,6BAA6B;QAC7B,MAAM,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QAE9E,oCAAoC;QACpC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,CAAA;QAEjF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW;gBACX,SAAS,EAAE,WAAW;gBACtB,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,CAAC;gBAChB,iBAAiB,EAAE,gBAAgB,CAAC,MAAM;aAC3C,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAsB,EAAE,CAAA;QACrC,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,IAAI,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAA;QAE1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAA;YACtC,IAAI,CAAC,SAAS;gBAAE,SAAQ;YACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAC1C,SAAS,EACT,CAAC,EACD,iBAAiB,CAAC,MAAM,EACxB,UAAU,CACX,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAEpB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,iBAAiB,EAAE,CAAA;YACrB,CAAC;iBAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC1B,aAAa,EAAE,CAAA;YACjB,CAAC;iBAAM,CAAC;gBACN,+BAA+B;gBAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;gBAChD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;gBAE/C,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,WAAW;oBACX,SAAS;oBACT,UAAU;oBACV,OAAO;oBACP,aAAa;oBACb,iBAAiB;iBAClB,CAAA;YACH,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QAChD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAE/C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW;YACX,SAAS;YACT,UAAU;YACV,OAAO;YACP,aAAa;YACb,iBAAiB;SAClB,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc;QAClB,iDAAiD;QACjD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,2DAA2D;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAA;QACrD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,2DAA2D;QAC3D,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAA;QAC5B,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAE9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAA;YACxC,mFAAmF;YACnF,IAAI,CAAC,QAAQ,GAAG,MAAO,CAAC,OAAO,CAAA;YAC/B,OAAO,MAAO,CAAA;QAChB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,UAAW,CAAA;QAC/C,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,CAAA;QAC7C,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,CAAA;QAE7C,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAC5C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAA;QACrD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAA;QACd,CAAC;QAED,0CAA0C;QAC1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,uCAAuC;QACvC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAErD,gDAAgD;QAChD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,0DAA0D;QAC1D,IAAI,cAAc,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC1C,yDAAyD;YACzD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;YACpE,OAAO,cAAc,CAAC,OAAO,GAAG,cAAc,CAAA;QAChD,CAAC;QAED,uDAAuD;QACvD,OAAO,cAAc,CAAC,MAAM,KAAK,aAAa,CAAA;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QACrB,iDAAiD;QACjD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAA;QACrD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,2BAA2B;QAC3B,MAAM,IAAI,CAAC,iBAAiB,CAAC;YAC3B,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,MAAM,IAAI,CAAC,gBAAgB,EAAE;YACtC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACxC,CAAC,CAAA;QAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAEnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;YAEvF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAA;YAE5D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;gBACpB,MAAM,IAAI,CAAC,iBAAiB,CAAC;oBAC3B,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,MAAM,CAAC,SAAS;oBACzB,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACvC,UAAU;iBACX,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;gBAC9D,MAAM,IAAI,CAAC,iBAAiB,CAAC;oBAC3B,MAAM,EAAE,QAAQ;oBAChB,OAAO,EAAE,MAAM,CAAC,SAAS;oBACzB,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACvC,KAAK,EAAE,eAAe,EAAE,KAAK,IAAI,eAAe;oBAChD,UAAU;iBACX,CAAC,CAAA;YACJ,CAAC;YAED,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAA;YAC5D,MAAM,IAAI,CAAC,iBAAiB,CAAC;gBAC3B,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,MAAM,IAAI,CAAC,gBAAgB,EAAE;gBACtC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACvC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,UAAU;aACX,CAAC,CAAA;YACF,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB;QAC1B,kCAAkC;QAClC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,uDAAuD;QACvD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAA;QAC5B,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAE9C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,cAAc,CAAA;QAClC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAC5C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,KAAK,KAAK,CAAA;QACvE,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAE3E,OAAO,iBAAiB,IAAI,aAAa,CAAA;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA6B,EAC7B,QAA8B,EAC9B,SAAiC,EAAE;IAEnC,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AACxD,CAAC"}

package/dist/worker/plugin-manager.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Plugin Manager for PostgresDO
+ *
+ * Handles plugin/extension lifecycle management including loading,
+ * enabling, disabling, and creating extensions.
+ * Extracted from PostgresDO to reduce class size and separate concerns.
+ *
+ * @module worker/plugin-manager
+ */
+import { type PluginName, type PluginConfig } from '../extensions/plugins';
+import { type PluginLoadBatchResult, type PluginLoaderOptions } from '../extensions/loader';
+import type { PluginStatus, PluginToggleResponse } from './types';
+/**
+ * Interface for a query executor (minimal interface for plugin operations)
+ */
+export interface PluginQueryExecutor {
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+    }>;
+}
+/**
+ * Plugin manager configuration
+ */
+export interface PluginManagerConfig {
+    /** Initial plugin configuration */
+    plugins?: PluginConfig;
+    /** Debug mode for verbose logging */
+    debug?: boolean;
+    /** Plugin loader options */
+    loaderOptions?: PluginLoaderOptions;
+}
+/**
+ * PluginManager handles plugin lifecycle for PostgresDO.
+ *
+ * Features:
+ * - Plugin loading via PluginLoader
+ * - Extension enable/disable
+ * - CREATE/DROP EXTENSION management
+ * - Plugin status queries
+ *
+ * @example
+ * ```typescript
+ * const pluginManager = new PluginManager({
+ *   plugins: { vector: { enabled: true, autoCreate: true } },
+ *   debug: true,
+ * })
+ *
+ * // Load extensions for PGlite
+ * const extensions = await pluginManager.loadEnabledExtensions()
+ *
+ * // Later, with initialized PGlite
+ * await pluginManager.runAutoCreate(pglite)
+ * ```
+ */
+export declare class PluginManager {
+    private plugins;
+    private debug;
+    private loaderOptions;
+    private loader;
+    private lastLoadResult;
+    constructor(config?: PluginManagerConfig);
+    /**
+     * Get the current plugin configuration
+     */
+    getConfig(): PluginConfig;
+    /**
+     * Update the plugin configuration
+     */
+    setConfig(plugins: PluginConfig): void;
+    /**
+     * Get or create the plugin loader (singleton per manager)
+     */
+    private getLoader;
+    /**
+     * Get the last plugin load result
+     */
+    getLastLoadResult(): PluginLoadBatchResult | null;
+    /**
+     * Load enabled plugin extensions for PGlite initialization
+     *
+     * @returns Record of loaded extensions keyed by name
+     */
+    loadEnabledExtensions(): Promise<Record<string, unknown>>;
+    /**
+     * Run auto-create SQL for plugins that have autoCreate enabled
+     *
+     * @param executor Query executor to run CREATE EXTENSION statements
+     */
+    runAutoCreate(executor: PluginQueryExecutor): Promise<void>;
+    /**
+     * List all available plugins with their status
+     *
+     * @param executor Query executor to check installed extensions
+     */
+    listPlugins(executor: PluginQueryExecutor): Promise<PluginStatus[]>;
+    /**
+     * Get the status of a specific plugin
+     *
+     * @param name Plugin name to get status for
+     * @param executor Query executor to check if extension is installed
+     */
+    getPluginStatus(name: PluginName, executor: PluginQueryExecutor): Promise<PluginStatus | null>;
+    /**
+     * Enable a plugin
+     *
+     * @param name Plugin name to enable
+     * @param executor Query executor for CREATE EXTENSION
+     * @param autoCreate Whether to run CREATE EXTENSION immediately
+     */
+    enablePlugin(name: PluginName, executor: PluginQueryExecutor | null, autoCreate?: boolean): Promise<PluginToggleResponse>;
+    /**
+     * Disable a plugin
+     *
+     * Note: This does NOT drop the extension from the database
+     *
+     * @param name Plugin name to disable
+     */
+    disablePlugin(name: PluginName): PluginToggleResponse;
+    /**
+     * Create an extension in the database
+     *
+     * @param name Plugin name to create extension for
+     * @param executor Query executor to run CREATE EXTENSION
+     */
+    createExtension(name: PluginName, executor: PluginQueryExecutor): Promise<PluginToggleResponse>;
+    /**
+     * Drop an extension from the database
+     *
+     * @param name Plugin name to drop extension for
+     * @param executor Query executor to run DROP EXTENSION
+     * @param cascade Whether to drop dependent objects
+     */
+    dropExtension(name: PluginName, executor: PluginQueryExecutor, cascade?: boolean): Promise<PluginToggleResponse>;
+    /**
+     * Check if a specific plugin is enabled
+     */
+    isEnabled(name: PluginName): boolean;
+    /**
+     * Clear the plugin loader cache
+     */
+    clearCache(): void;
+}
+/**
+ * Create a plugin manager instance
+ */
+export declare function createPluginManager(config?: PluginManagerConfig): PluginManager;
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/worker/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/worker/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EAMlB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAA;CAC5E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,4BAA4B;IAC5B,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAAqC;gBAE/C,MAAM,GAAE,mBAAwB;IAM5C;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,iBAAiB,IAAI,qBAAqB,GAAG,IAAI;IAIjD;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAmC/D;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjE;;;;OAIG;IACG,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwCzE;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAqCpG;;;;;;OAMG;IACG,YAAY,CAChB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,mBAAmB,GAAG,IAAI,EACpC,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAoDhC;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB;IAuBrD;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0CrG;;;;;;OAMG;IACG,aAAa,CACjB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,oBAAoB,CAAC;IAmChC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAIpC;;OAEG;IACH,UAAU,IAAI,IAAI;CAKnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAE/E"}