@dotdo/postgres 0.1.0

package/dist/migrations/progress-tracker.js

@@ -0,0 +1,443 @@
+/**
+ * Migration Progress Tracker
+ *
+ * Tracks migration progress across thousands of Durable Objects.
+ * Provides centralized progress reporting, pause/resume capabilities,
+ * and aggregate statistics.
+ *
+ * @module migrations/progress-tracker
+ */
+import { createLogger, LogLevel } from '@dotdo/postgres-shared';
+// Module-level logger for ProgressTracker
+// Level is DEBUG because the debug config flag gates whether log() is called at all.
+// The logger just provides structured output - the filtering happens at call site.
+const progressTrackerLogger = createLogger({
+    level: LogLevel.DEBUG,
+    prefix: '[ProgressTracker]',
+});
+/**
+ * In-memory storage implementation (for testing/single-instance use)
+ */
+export class InMemoryProgressStorage {
+    operations = new Map();
+    doProgress = new Map();
+    async setOperation(migrationId, operation) {
+        this.operations.set(migrationId, operation);
+    }
+    async getOperation(migrationId) {
+        return this.operations.get(migrationId) ?? null;
+    }
+    async setDOProgress(migrationId, doId, progress) {
+        if (!this.doProgress.has(migrationId)) {
+            this.doProgress.set(migrationId, new Map());
+        }
+        this.doProgress.get(migrationId).set(doId, progress);
+    }
+    async getDOProgress(migrationId, doId) {
+        return this.doProgress.get(migrationId)?.get(doId) ?? null;
+    }
+    async getAllDOProgress(migrationId) {
+        const progressMap = this.doProgress.get(migrationId);
+        return progressMap ? Array.from(progressMap.values()) : [];
+    }
+    async getDOProgressByStatus(migrationId, status) {
+        const allProgress = await this.getAllDOProgress(migrationId);
+        return allProgress.filter((p) => p.status === status);
+    }
+    async deleteOperation(migrationId) {
+        this.operations.delete(migrationId);
+        this.doProgress.delete(migrationId);
+    }
+    async listOperations() {
+        return Array.from(this.operations.values());
+    }
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear() {
+        this.operations.clear();
+        this.doProgress.clear();
+    }
+}
+/**
+ * Migration Progress Tracker
+ *
+ * Tracks migration progress across many Durable Objects, providing
+ * aggregate statistics and pause/resume capabilities.
+ *
+ * @example
+ * ```typescript
+ * const tracker = new MigrationProgressTracker({
+ *   storage: new InMemoryProgressStorage(),
+ * })
+ *
+ * // Start tracking a migration
+ * await tracker.startMigration('migration-2024-01', [
+ *   'do-1', 'do-2', 'do-3'
+ * ], 5)
+ *
+ * // Report progress from individual DOs
+ * await tracker.reportProgress('migration-2024-01', {
+ *   doId: 'do-1',
+ *   status: 'running',
+ *   currentVersion: 3,
+ *   targetVersion: 5,
+ *   migrationsCompleted: 3,
+ *   totalMigrations: 5,
+ * })
+ *
+ * // Get overall progress
+ * const progress = await tracker.getProgress('migration-2024-01')
+ * console.log(`${progress.stats.percentComplete}% complete`)
+ * ```
+ */
+export class MigrationProgressTracker {
+    storage;
+    debug;
+    constructor(config) {
+        this.storage = config.storage;
+        this.debug = config.debug ?? false;
+    }
+    /**
+     * Log debug message
+     */
+    log(message, ...args) {
+        if (this.debug) {
+            progressTrackerLogger.debug(message, args.length > 0 ? { args } : undefined);
+        }
+    }
+    /**
+     * Calculate progress statistics
+     */
+    async calculateStats(migrationId) {
+        const allProgress = await this.storage.getAllDOProgress(migrationId);
+        const total = allProgress.length;
+        if (total === 0) {
+            return {
+                total: 0,
+                pending: 0,
+                running: 0,
+                completed: 0,
+                failed: 0,
+                skipped: 0,
+                percentComplete: 0,
+                estimatedTimeRemainingMs: null,
+                avgExecutionTimeMs: 0,
+            };
+        }
+        const pending = allProgress.filter((p) => p.status === 'pending').length;
+        const running = allProgress.filter((p) => p.status === 'running').length;
+        const completed = allProgress.filter((p) => p.status === 'completed').length;
+        const failed = allProgress.filter((p) => p.status === 'failed').length;
+        const skipped = allProgress.filter((p) => p.status === 'skipped').length;
+        const percentComplete = Math.round(((completed + failed + skipped) / total) * 100);
+        // Calculate average execution time from completed DOs
+        const completedDOs = allProgress.filter((p) => (p.status === 'completed' || p.status === 'failed') && p.executionTimeMs);
+        const avgExecutionTimeMs = completedDOs.length > 0
+            ? completedDOs.reduce((sum, p) => sum + (p.executionTimeMs ?? 0), 0) / completedDOs.length
+            : 0;
+        // Estimate remaining time
+        let estimatedTimeRemainingMs = null;
+        if (avgExecutionTimeMs > 0 && pending + running > 0) {
+            estimatedTimeRemainingMs = Math.round(avgExecutionTimeMs * (pending + running));
+        }
+        return {
+            total,
+            pending,
+            running,
+            completed,
+            failed,
+            skipped,
+            percentComplete,
+            estimatedTimeRemainingMs,
+            avgExecutionTimeMs: Math.round(avgExecutionTimeMs),
+        };
+    }
+    /**
+     * Start tracking a migration operation
+     *
+     * @param migrationId Unique identifier for this migration operation
+     * @param doIds Array of Durable Object IDs to migrate
+     * @param targetVersion Target schema version
+     * @param options Optional operation metadata
+     * @returns The created migration operation
+     */
+    async startMigration(migrationId, doIds, targetVersion, options) {
+        this.log(`Starting migration ${migrationId} for ${doIds.length} DOs to version ${targetVersion}`);
+        // Check if migration already exists
+        const existing = await this.storage.getOperation(migrationId);
+        if (existing) {
+            throw new Error(`Migration operation ${migrationId} already exists`);
+        }
+        // Create operation record
+        const operation = {
+            migrationId,
+            targetVersion,
+            status: 'pending',
+            totalDOs: doIds.length,
+            startedAt: new Date().toISOString(),
+            ...(options?.initiatedBy !== undefined && { initiatedBy: options.initiatedBy }),
+            ...(options?.description !== undefined && { description: options.description }),
+            stats: {
+                total: doIds.length,
+                pending: doIds.length,
+                running: 0,
+                completed: 0,
+                failed: 0,
+                skipped: 0,
+                percentComplete: 0,
+                estimatedTimeRemainingMs: null,
+                avgExecutionTimeMs: 0,
+            },
+        };
+        await this.storage.setOperation(migrationId, operation);
+        // Initialize all DOs as pending
+        for (const doId of doIds) {
+            const doProgress = {
+                doId,
+                status: 'pending',
+                currentVersion: null,
+                targetVersion,
+                migrationsCompleted: 0,
+                totalMigrations: 0, // Will be updated when migration starts
+            };
+            await this.storage.setDOProgress(migrationId, doId, doProgress);
+        }
+        this.log(`Migration ${migrationId} started`);
+        return operation;
+    }
+    /**
+     * Report progress for a specific DO
+     *
+     * @param migrationId Migration operation ID
+     * @param progress Progress update for a DO
+     */
+    async reportProgress(migrationId, progress) {
+        const operation = await this.storage.getOperation(migrationId);
+        if (!operation) {
+            throw new Error(`Migration operation ${migrationId} not found`);
+        }
+        // Get existing progress or create new
+        const existing = await this.storage.getDOProgress(migrationId, progress.doId);
+        if (!existing) {
+            throw new Error(`DO ${progress.doId} not registered for migration ${migrationId}`);
+        }
+        // Merge updates
+        const updated = {
+            ...existing,
+            ...progress,
+        };
+        // Set timestamps
+        if (progress.status === 'running' && !existing.startedAt) {
+            updated.startedAt = new Date().toISOString();
+        }
+        if ((progress.status === 'completed' || progress.status === 'failed' || progress.status === 'skipped') &&
+            !existing.completedAt) {
+            updated.completedAt = new Date().toISOString();
+            // Calculate execution time if we have start time
+            if (updated.startedAt) {
+                updated.executionTimeMs =
+                    new Date(updated.completedAt).getTime() - new Date(updated.startedAt).getTime();
+            }
+        }
+        await this.storage.setDOProgress(migrationId, progress.doId, updated);
+        // Update operation stats and status
+        const stats = await this.calculateStats(migrationId);
+        operation.stats = stats;
+        // Update operation status based on progress
+        if (operation.status === 'pending' && stats.running > 0) {
+            operation.status = 'running';
+        }
+        else if (stats.running === 0 && stats.pending === 0) {
+            if (stats.failed > 0) {
+                operation.status = 'failed';
+            }
+            else {
+                operation.status = 'completed';
+            }
+            operation.completedAt = new Date().toISOString();
+        }
+        await this.storage.setOperation(migrationId, operation);
+        this.log(`Progress for ${progress.doId}: ${progress.status} (${stats.percentComplete}% overall)`);
+    }
+    /**
+     * Get overall progress for a migration operation
+     *
+     * @param migrationId Migration operation ID
+     * @returns Migration operation with current stats
+     */
+    async getProgress(migrationId) {
+        const operation = await this.storage.getOperation(migrationId);
+        if (!operation) {
+            throw new Error(`Migration operation ${migrationId} not found`);
+        }
+        // Refresh stats
+        const stats = await this.calculateStats(migrationId);
+        operation.stats = stats;
+        return operation;
+    }
+    /**
+     * Get DOs that are still pending migration
+     *
+     * @param migrationId Migration operation ID
+     * @returns Array of DO IDs that haven't started migration
+     */
+    async getPendingDOs(migrationId) {
+        const pending = await this.storage.getDOProgressByStatus(migrationId, 'pending');
+        return pending.map((p) => p.doId);
+    }
+    /**
+     * Get DOs that are currently running migration
+     *
+     * @param migrationId Migration operation ID
+     * @returns Array of DO IDs currently migrating
+     */
+    async getRunningDOs(migrationId) {
+        const running = await this.storage.getDOProgressByStatus(migrationId, 'running');
+        return running.map((p) => p.doId);
+    }
+    /**
+     * Get DOs that failed migration
+     *
+     * @param migrationId Migration operation ID
+     * @returns Array of progress states for failed DOs
+     */
+    async getFailedDOs(migrationId) {
+        return this.storage.getDOProgressByStatus(migrationId, 'failed');
+    }
+    /**
+     * Get progress for a specific DO
+     *
+     * @param migrationId Migration operation ID
+     * @param doId Durable Object ID
+     * @returns Progress state for the DO
+     */
+    async getDOProgress(migrationId, doId) {
+        return this.storage.getDOProgress(migrationId, doId);
+    }
+    /**
+     * Pause a migration operation
+     *
+     * This doesn't stop in-flight migrations but marks the operation as paused,
+     * preventing new migrations from starting.
+     *
+     * @param migrationId Migration operation ID
+     */
+    async pauseMigration(migrationId) {
+        const operation = await this.storage.getOperation(migrationId);
+        if (!operation) {
+            throw new Error(`Migration operation ${migrationId} not found`);
+        }
+        if (operation.status !== 'running') {
+            throw new Error(`Cannot pause migration ${migrationId} with status ${operation.status}`);
+        }
+        operation.status = 'paused';
+        await this.storage.setOperation(migrationId, operation);
+        this.log(`Migration ${migrationId} paused`);
+    }
+    /**
+     * Resume a paused migration operation
+     *
+     * @param migrationId Migration operation ID
+     */
+    async resumeMigration(migrationId) {
+        const operation = await this.storage.getOperation(migrationId);
+        if (!operation) {
+            throw new Error(`Migration operation ${migrationId} not found`);
+        }
+        if (operation.status !== 'paused') {
+            throw new Error(`Cannot resume migration ${migrationId} with status ${operation.status}`);
+        }
+        operation.status = 'running';
+        await this.storage.setOperation(migrationId, operation);
+        this.log(`Migration ${migrationId} resumed`);
+    }
+    /**
+     * Cancel a migration operation
+     *
+     * This marks the operation as failed and stops tracking.
+     * It doesn't rollback any completed migrations.
+     *
+     * @param migrationId Migration operation ID
+     */
+    async cancelMigration(migrationId) {
+        const operation = await this.storage.getOperation(migrationId);
+        if (!operation) {
+            throw new Error(`Migration operation ${migrationId} not found`);
+        }
+        if (operation.status === 'completed' || operation.status === 'failed') {
+            throw new Error(`Cannot cancel migration ${migrationId} with status ${operation.status}`);
+        }
+        operation.status = 'failed';
+        operation.completedAt = new Date().toISOString();
+        await this.storage.setOperation(migrationId, operation);
+        this.log(`Migration ${migrationId} cancelled`);
+    }
+    /**
+     * Delete a migration operation and all progress data
+     *
+     * @param migrationId Migration operation ID
+     */
+    async deleteMigration(migrationId) {
+        await this.storage.deleteOperation(migrationId);
+        this.log(`Migration ${migrationId} deleted`);
+    }
+    /**
+     * List all migration operations
+     *
+     * @returns Array of all migration operations
+     */
+    async listMigrations() {
+        return this.storage.listOperations();
+    }
+    /**
+     * Retry failed DOs in a migration operation
+     *
+     * Resets failed DOs to pending status so they can be retried.
+     *
+     * @param migrationId Migration operation ID
+     * @returns Number of DOs reset to pending
+     */
+    async retryFailedDOs(migrationId) {
+        const failed = await this.getFailedDOs(migrationId);
+        for (const progress of failed) {
+            // Create new object without error/completedAt/executionTimeMs
+            const { error: _error, completedAt: _completedAt, executionTimeMs: _execTime, ...rest } = progress;
+            await this.storage.setDOProgress(migrationId, progress.doId, {
+                ...rest,
+                status: 'pending',
+            });
+        }
+        // Update operation stats
+        const operation = await this.storage.getOperation(migrationId);
+        if (operation) {
+            const stats = await this.calculateStats(migrationId);
+            operation.stats = stats;
+            if (operation.status === 'failed' || operation.status === 'completed') {
+                operation.status = 'running';
+                delete operation.completedAt;
+            }
+            await this.storage.setOperation(migrationId, operation);
+        }
+        this.log(`Reset ${failed.length} failed DOs to pending in migration ${migrationId}`);
+        return failed.length;
+    }
+}
+/**
+ * Create a migration progress tracker
+ *
+ * @param config Progress tracker configuration
+ * @returns Configured progress tracker instance
+ *
+ * @example
+ * ```typescript
+ * const tracker = createProgressTracker({
+ *   storage: new InMemoryProgressStorage(),
+ *   debug: true,
+ * })
+ * ```
+ */
+export function createProgressTracker(config) {
+    return new MigrationProgressTracker(config);
+}
+//# sourceMappingURL=progress-tracker.js.map

package/dist/migrations/progress-tracker.js.map

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

package/dist/migrations/registry.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Migration Registry
+ *
+ * A compile-time registry of all migrations for an application.
+ * Validates migration definitions and provides ordered access.
+ *
+ * The registry is designed to be created at application startup
+ * and shared across all Durable Object instances.
+ *
+ * @module migrations/registry
+ */
+import type { Migration, MigrationRegistryConfig, MigrationInput } from './types';
+/**
+ * Validation error for migration definitions
+ */
+export declare class MigrationValidationError extends Error {
+    migrationId?: string | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, migrationId?: string | undefined, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Validation result for a migration registry
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        migrationId: string;
+        message: string;
+        field?: string;
+    }>;
+    warnings: Array<{
+        migrationId: string;
+        message: string;
+        field?: string;
+    }>;
+}
+/**
+ * Migration Registry
+ *
+ * Holds all migrations for an application and provides
+ * validated, ordered access to them.
+ *
+ * @example
+ * ```typescript
+ * // Create a registry with migrations
+ * const registry = createMigrationRegistry({
+ *   migrations: [
+ *     {
+ *       id: '0001_create_users',
+ *       name: 'Create users table',
+ *       version: 1,
+ *       up: 'CREATE TABLE users (...)',
+ *       down: 'DROP TABLE users',
+ *     },
+ *     {
+ *       id: '0002_add_posts',
+ *       name: 'Add posts table',
+ *       version: 2,
+ *       up: 'CREATE TABLE posts (...)',
+ *       down: 'DROP TABLE posts',
+ *     },
+ *   ],
+ * })
+ *
+ * // Get all migrations for a runner
+ * const migrations = registry.getMigrations()
+ *
+ * // Get migrations up to a specific version
+ * const subset = registry.getMigrationsUpTo(5)
+ *
+ * // Get latest version
+ * const latest = registry.getLatestVersion() // 2
+ * ```
+ */
+export declare class MigrationRegistry {
+    private migrations;
+    private versionIndex;
+    private sortedMigrations;
+    private latestVersion;
+    constructor(config: MigrationRegistryConfig);
+    /**
+     * Register a single migration
+     */
+    private register;
+    /**
+     * Validate the registry
+     */
+    validate(options?: {
+        allowVersionGaps?: boolean;
+    }): ValidationResult;
+    /**
+     * Get all migrations in version order
+     */
+    getMigrations(): Migration[];
+    /**
+     * Get migrations as MigrationInput format (for runner)
+     */
+    getMigrationInputs(direction?: 'up' | 'down'): MigrationInput[];
+    /**
+     * Get a specific migration by ID
+     */
+    getMigration(id: string): Migration | undefined;
+    /**
+     * Get a migration by version number
+     */
+    getMigrationByVersion(version: number): Migration | undefined;
+    /**
+     * Get migrations up to a specific version (inclusive)
+     */
+    getMigrationsUpTo(version: number): Migration[];
+    /**
+     * Get migrations after a specific version (exclusive)
+     */
+    getMigrationsAfter(version: number): Migration[];
+    /**
+     * Get migrations between two versions (inclusive)
+     */
+    getMigrationsBetween(fromVersion: number, toVersion: number): Migration[];
+    /**
+     * Get the latest version number
+     */
+    getLatestVersion(): number;
+    /**
+     * Get the total count of migrations
+     */
+    getCount(): number;
+    /**
+     * Check if a migration ID exists
+     */
+    hasMigration(id: string): boolean;
+    /**
+     * Check if a version exists
+     */
+    hasVersion(version: number): boolean;
+    /**
+     * Get migrations by tag
+     */
+    getMigrationsByTag(tag: string): Migration[];
+    /**
+     * Get all migration IDs
+     */
+    getMigrationIds(): string[];
+    /**
+     * Get all migration versions
+     */
+    getMigrationVersions(): number[];
+    /**
+     * Export migrations for serialization
+     */
+    toJSON(): Migration[];
+}
+/**
+ * Create a migration registry
+ *
+ * @example
+ * ```typescript
+ * const registry = createMigrationRegistry({
+ *   migrations: [
+ *     {
+ *       id: '0001_initial',
+ *       name: 'Initial schema',
+ *       version: 1,
+ *       up: 'CREATE TABLE ...',
+ *       down: 'DROP TABLE ...',
+ *     },
+ *   ],
+ * })
+ * ```
+ */
+export declare function createMigrationRegistry(config: MigrationRegistryConfig): MigrationRegistry;
+/**
+ * Create a migration from Drizzle SQL file content
+ *
+ * Parses a Drizzle-generated migration file and converts it
+ * to our migration format.
+ *
+ * @example
+ * ```typescript
+ * const migration = createMigrationFromDrizzle({
+ *   id: '0001_initial',
+ *   name: 'Initial schema',
+ *   version: 1,
+ *   sql: sqlContent,
+ * })
+ * ```
+ */
+export declare function createMigrationFromDrizzle(options: {
+    id: string;
+    name: string;
+    version: number;
+    sql: string;
+    tags?: string[];
+}): Migration;
+/**
+ * Helper to define a migration with type safety
+ *
+ * @example
+ * ```typescript
+ * export const createUsers = defineMigration({
+ *   id: '0001_create_users',
+ *   name: 'Create users table',
+ *   version: 1,
+ *   up: `
+ *     CREATE TABLE users (
+ *       id SERIAL PRIMARY KEY,
+ *       email TEXT NOT NULL UNIQUE
+ *     );
+ *   `,
+ *   down: `
+ *     DROP TABLE users;
+ *   `,
+ * })
+ * ```
+ */
+export declare function defineMigration(migration: Migration): Migration;
+/**
+ * Combine multiple migrations into a registry
+ *
+ * @example
+ * ```typescript
+ * import { createUsers } from './migrations/0001_create_users'
+ * import { addPosts } from './migrations/0002_add_posts'
+ *
+ * export const registry = combineMigrations([
+ *   createUsers,
+ *   addPosts,
+ * ])
+ * ```
+ */
+export declare function combineMigrations(migrations: Migration[], options?: Omit<MigrationRegistryConfig, 'migrations'>): MigrationRegistry;
+//# sourceMappingURL=registry.d.ts.map