@dotdo/postgres 0.1.0

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

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

package/dist/migrations/registry.js

@@ -0,0 +1,376 @@
+/**
+ * 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
+ */
+/**
+ * Validation error for migration definitions
+ */
+export class MigrationValidationError extends Error {
+    migrationId;
+    details;
+    constructor(message, migrationId, details) {
+        super(message);
+        this.migrationId = migrationId;
+        this.details = details;
+        this.name = 'MigrationValidationError';
+    }
+}
+/**
+ * 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 class MigrationRegistry {
+    migrations = new Map();
+    versionIndex = new Map();
+    sortedMigrations = [];
+    latestVersion = 0;
+    constructor(config) {
+        const { migrations, validateOnCreate = true, allowVersionGaps = false } = config;
+        // Register all migrations
+        for (const migration of migrations) {
+            this.register(migration);
+        }
+        // Sort by version
+        this.sortedMigrations = Array.from(this.migrations.values()).sort((a, b) => a.version - b.version);
+        // Calculate latest version
+        if (this.sortedMigrations.length > 0) {
+            const lastMigration = this.sortedMigrations[this.sortedMigrations.length - 1];
+            if (lastMigration) {
+                this.latestVersion = lastMigration.version;
+            }
+        }
+        // Validate if requested
+        if (validateOnCreate) {
+            const result = this.validate({ allowVersionGaps });
+            if (!result.valid) {
+                const errorMessages = result.errors.map((e) => `${e.migrationId}: ${e.message}`).join('; ');
+                throw new MigrationValidationError(`Migration validation failed: ${errorMessages}`, undefined, { errors: result.errors });
+            }
+        }
+    }
+    /**
+     * Register a single migration
+     */
+    register(migration) {
+        // Check for duplicate IDs
+        if (this.migrations.has(migration.id)) {
+            throw new MigrationValidationError(`Duplicate migration ID: ${migration.id}`, migration.id);
+        }
+        // Check for duplicate versions
+        if (this.versionIndex.has(migration.version)) {
+            const existingId = this.versionIndex.get(migration.version);
+            throw new MigrationValidationError(`Duplicate migration version ${migration.version}: ` +
+                `${migration.id} conflicts with ${existingId}`, migration.id);
+        }
+        this.migrations.set(migration.id, migration);
+        this.versionIndex.set(migration.version, migration.id);
+    }
+    /**
+     * Validate the registry
+     */
+    validate(options = {}) {
+        const { allowVersionGaps = false } = options;
+        const errors = [];
+        const warnings = [];
+        for (const migration of this.sortedMigrations) {
+            // Validate ID format
+            if (!migration.id || typeof migration.id !== 'string') {
+                errors.push({
+                    migrationId: migration.id || 'unknown',
+                    message: 'Migration ID must be a non-empty string',
+                    field: 'id',
+                });
+            }
+            // Validate name
+            if (!migration.name || typeof migration.name !== 'string') {
+                errors.push({
+                    migrationId: migration.id,
+                    message: 'Migration name must be a non-empty string',
+                    field: 'name',
+                });
+            }
+            // Validate version
+            if (typeof migration.version !== 'number' || migration.version < 1) {
+                errors.push({
+                    migrationId: migration.id,
+                    message: 'Migration version must be a positive integer',
+                    field: 'version',
+                });
+            }
+            // Validate up SQL
+            if (!migration.up || typeof migration.up !== 'string') {
+                errors.push({
+                    migrationId: migration.id,
+                    message: 'Migration up SQL must be a non-empty string',
+                    field: 'up',
+                });
+            }
+            // Warn if no down migration
+            if (!migration.down) {
+                warnings.push({
+                    migrationId: migration.id,
+                    message: 'Migration has no down SQL - rollback not supported',
+                    field: 'down',
+                });
+            }
+        }
+        // Check for version gaps if not allowed
+        if (!allowVersionGaps && this.sortedMigrations.length > 0) {
+            const versions = this.sortedMigrations.map((m) => m.version);
+            const minVersion = versions[0] ?? 1;
+            const maxVersion = versions[versions.length - 1] ?? 1;
+            for (let v = minVersion; v <= maxVersion; v++) {
+                if (!this.versionIndex.has(v)) {
+                    errors.push({
+                        migrationId: `version_${v}`,
+                        message: `Missing migration for version ${v}`,
+                        field: 'version',
+                    });
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Get all migrations in version order
+     */
+    getMigrations() {
+        return [...this.sortedMigrations];
+    }
+    /**
+     * Get migrations as MigrationInput format (for runner)
+     */
+    getMigrationInputs(direction = 'up') {
+        const migrations = direction === 'up'
+            ? this.sortedMigrations
+            : [...this.sortedMigrations].reverse();
+        return migrations.map((m) => ({
+            id: m.id,
+            name: m.name,
+            version: m.version,
+            sql: direction === 'up' ? m.up : (m.down ?? ''),
+        })).filter((m) => m.sql.trim().length > 0);
+    }
+    /**
+     * Get a specific migration by ID
+     */
+    getMigration(id) {
+        return this.migrations.get(id);
+    }
+    /**
+     * Get a migration by version number
+     */
+    getMigrationByVersion(version) {
+        const id = this.versionIndex.get(version);
+        return id ? this.migrations.get(id) : undefined;
+    }
+    /**
+     * Get migrations up to a specific version (inclusive)
+     */
+    getMigrationsUpTo(version) {
+        return this.sortedMigrations.filter((m) => m.version <= version);
+    }
+    /**
+     * Get migrations after a specific version (exclusive)
+     */
+    getMigrationsAfter(version) {
+        return this.sortedMigrations.filter((m) => m.version > version);
+    }
+    /**
+     * Get migrations between two versions (inclusive)
+     */
+    getMigrationsBetween(fromVersion, toVersion) {
+        return this.sortedMigrations.filter((m) => m.version >= fromVersion && m.version <= toVersion);
+    }
+    /**
+     * Get the latest version number
+     */
+    getLatestVersion() {
+        return this.latestVersion;
+    }
+    /**
+     * Get the total count of migrations
+     */
+    getCount() {
+        return this.migrations.size;
+    }
+    /**
+     * Check if a migration ID exists
+     */
+    hasMigration(id) {
+        return this.migrations.has(id);
+    }
+    /**
+     * Check if a version exists
+     */
+    hasVersion(version) {
+        return this.versionIndex.has(version);
+    }
+    /**
+     * Get migrations by tag
+     */
+    getMigrationsByTag(tag) {
+        return this.sortedMigrations.filter((m) => m.tags?.includes(tag));
+    }
+    /**
+     * Get all migration IDs
+     */
+    getMigrationIds() {
+        return this.sortedMigrations.map((m) => m.id);
+    }
+    /**
+     * Get all migration versions
+     */
+    getMigrationVersions() {
+        return this.sortedMigrations.map((m) => m.version);
+    }
+    /**
+     * Export migrations for serialization
+     */
+    toJSON() {
+        return this.getMigrations();
+    }
+}
+/**
+ * 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 function createMigrationRegistry(config) {
+    return new MigrationRegistry(config);
+}
+/**
+ * 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 function createMigrationFromDrizzle(options) {
+    const { id, name, version, sql, tags } = options;
+    // Drizzle uses --> statement-breakpoint comments to separate statements
+    // We preserve these for compatibility
+    const cleanSql = sql
+        .replace(/-->\s*statement-breakpoint\s*/g, '\n')
+        .trim();
+    return {
+        id,
+        name,
+        version,
+        up: cleanSql,
+        tags: tags ? [...tags, 'drizzle'] : ['drizzle'],
+        transactional: true,
+    };
+}
+/**
+ * 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 function defineMigration(migration) {
+    return 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 function combineMigrations(migrations, options) {
+    return createMigrationRegistry({
+        migrations,
+        ...options,
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/migrations/registry.js.map

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

package/dist/migrations/runner.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Migration Runner
+ *
+ * Executes migrations against a PGLite database instance.
+ * Designed for postgres.do's unique multi-database model where
+ * each user gets their own Durable Object database.
+ *
+ * Key features:
+ * - Auto-migration on first connection to new databases
+ * - Idempotent execution (safe to run multiple times)
+ * - Transaction-based migrations with automatic rollback on failure
+ * - Advisory locks to prevent concurrent migrations
+ * - Checksum validation to detect modified migrations
+ *
+ * @module migrations/runner
+ */
+import type { Migration, BatchMigrationResult, MigrationRunnerConfig, MigrationEventListener, MigrationRecord, SchemaVersion, VersionComparison, QueryExecutor, RollbackOptions, RollbackResult, BatchRollbackResult, RollbackEventListener, RollbackHistoryRecord } from './types';
+import type { MigrationRegistry } from './registry';
+import { MigrationError } from '@dotdo/postgres-shared/errors';
+export { MigrationError };
+export type { RollbackProgressEvent } from './types';
+export declare class MigrationRunner {
+    private executor;
+    private registry;
+    private config;
+    private onProgress;
+    private initialized;
+    private listeners;
+    private rollbackListeners;
+    private currentLock;
+    constructor(executor: QueryExecutor, registry: MigrationRegistry, config?: MigrationRunnerConfig);
+    /**
+     * Log debug message
+     */
+    private log;
+    /**
+     * Emit a migration event
+     */
+    private emitEvent;
+    /**
+     * Add an event listener
+     */
+    onEvent(listener: MigrationEventListener): () => void;
+    /**
+     * Emit a rollback event
+     */
+    private emitRollbackEvent;
+    /**
+     * Add a rollback event listener
+     */
+    onRollbackEvent(listener: RollbackEventListener): () => void;
+    /**
+     * Get the full qualified table name
+     */
+    private getTableName;
+    /**
+     * Initialize the migration runner
+     *
+     * Creates the migrations table and rollback history table if they don't exist.
+     * Safe to call multiple times.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the rollback history table name
+     */
+    private getRollbackHistoryTableName;
+    /**
+     * Acquire a migration lock
+     *
+     * Uses PostgreSQL advisory locks to prevent concurrent migrations.
+     * This is important in Cloudflare Workers where multiple requests
+     * might hit the same DO simultaneously.
+     */
+    private acquireLock;
+    /**
+     * Release the migration lock
+     */
+    private releaseLock;
+    /**
+     * Get the current schema version and all migration records
+     */
+    getSchemaVersion(): Promise<SchemaVersion>;
+    /**
+     * Compare current schema version against the registry
+     */
+    compareVersion(): Promise<VersionComparison>;
+    /**
+     * Get a migration record by ID
+     */
+    getMigrationRecord(id: string): Promise<MigrationRecord | null>;
+    /**
+     * Check if a migration has been applied
+     */
+    isMigrationApplied(id: string): Promise<boolean>;
+    /**
+     * Apply a single migration
+     */
+    private applyMigration;
+    /**
+     * Run all pending migrations
+     *
+     * This is the main entry point for migration execution.
+     * Migrations are run in version order, stopping on first failure.
+     */
+    migrate(): Promise<BatchMigrationResult>;
+    /**
+     * Migrate up to a specific version
+     */
+    migrateToVersion(targetVersion: number): Promise<BatchMigrationResult>;
+    /**
+     * Check if a migration is reversible
+     *
+     * A migration is reversible if:
+     * 1. It has down SQL defined
+     * 2. isReversible is not explicitly set to false
+     */
+    isReversible(migration: Migration): boolean;
+    /**
+     * Record a rollback in the history table
+     */
+    private recordRollbackHistory;
+    /**
+     * Get rollback history
+     */
+    getRollbackHistory(): Promise<RollbackHistoryRecord[]>;
+    /**
+     * Plan a rollback operation
+     *
+     * Returns what would be rolled back without making changes.
+     * Useful for dry-run mode.
+     */
+    planRollback(options: RollbackOptions): Promise<{
+        migrations: Migration[];
+        blockers: Array<{
+            id: string;
+            version: number;
+            reason: string;
+        }>;
+    }>;
+    /**
+     * Rollback the last migration
+     *
+     * Enhanced version with dry-run and force support.
+     *
+     * @param options Optional rollback options
+     */
+    rollbackLast(options?: {
+        dryRun?: boolean;
+        force?: boolean;
+        reason?: string;
+    }): Promise<RollbackResult | null>;
+    /**
+     * Rollback to a specific version
+     *
+     * Enhanced version with dry-run, force mode, and comprehensive error handling.
+     * Rolls back all migrations after the specified version in reverse order.
+     *
+     * @param options Rollback options including target version, dry-run, and force flags
+     */
+    rollback(options: RollbackOptions): Promise<BatchRollbackResult>;
+    /**
+     * Rollback to a specific version (legacy API)
+     *
+     * @deprecated Use rollback() instead for more options
+     */
+    rollbackToVersion(targetVersion: number): Promise<BatchMigrationResult>;
+    /**
+     * Reset all migrations
+     *
+     * Drops the migrations table and all tracked migrations.
+     * USE WITH CAUTION - this doesn't undo the schema changes!
+     */
+    reset(): Promise<void>;
+    /**
+     * Check if the runner has been initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the registry
+     */
+    getRegistry(): MigrationRegistry;
+}
+/**
+ * Create a migration runner
+ *
+ * @example
+ * ```typescript
+ * const runner = createMigrationRunner(pglite, registry, {
+ *   debug: true,
+ *   onProgress: (event) => console.log(event),
+ * })
+ *
+ * await runner.migrate()
+ * ```
+ */
+export declare function createMigrationRunner(executor: QueryExecutor, registry: MigrationRegistry, config?: MigrationRunnerConfig): MigrationRunner;
+//# sourceMappingURL=runner.d.ts.map

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

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