@dotdo/postgres 0.1.0

package/dist/migrations/drizzle-compat.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Drizzle ORM Compatibility
+ *
+ * Utilities for integrating with Drizzle ORM's migration system.
+ * Allows loading Drizzle-generated migrations and converting them
+ * to postgres.do's format.
+ *
+ * @module migrations/drizzle-compat
+ */
+import type { Migration, DrizzleJournal, DrizzleJournalEntry, DrizzleMigrationFile } from './types';
+/**
+ * Parse a Drizzle migration journal
+ *
+ * Drizzle uses a _journal.json file in the migrations folder
+ * to track migration history and ordering.
+ *
+ * @example
+ * ```typescript
+ * const journal = parseDrizzleJournal(journalContent)
+ * // { version: '5', dialect: 'postgresql', entries: [...] }
+ * ```
+ */
+export declare function parseDrizzleJournal(content: string): DrizzleJournal;
+/**
+ * Convert a Drizzle journal entry to a migration
+ *
+ * @example
+ * ```typescript
+ * const migration = convertDrizzleEntry(entry, sqlContent)
+ * ```
+ */
+export declare function convertDrizzleEntry(entry: DrizzleJournalEntry, sql: string): Migration;
+/**
+ * Load migrations from Drizzle format
+ *
+ * This function takes a journal and a map of SQL files,
+ * and converts them to postgres.do migrations.
+ *
+ * @example
+ * ```typescript
+ * // Load from file system
+ * const journal = JSON.parse(readFileSync('drizzle/meta/_journal.json', 'utf-8'))
+ * const sqlFiles = {
+ *   '0000_init': readFileSync('drizzle/0000_init.sql', 'utf-8'),
+ *   '0001_add_users': readFileSync('drizzle/0001_add_users.sql', 'utf-8'),
+ * }
+ *
+ * const migrations = loadDrizzleMigrations(journal, sqlFiles)
+ * ```
+ */
+export declare function loadDrizzleMigrations(journal: DrizzleJournal, sqlFiles: Record<string, string>): Migration[];
+/**
+ * Drizzle migration file structure
+ *
+ * This represents the expected format for bundled Drizzle migrations.
+ */
+export interface BundledDrizzleMigrations {
+    journal: DrizzleJournal;
+    migrations: Record<string, string>;
+}
+/**
+ * Load bundled Drizzle migrations
+ *
+ * For Cloudflare Workers, migrations need to be bundled at build time.
+ * This function loads pre-bundled migrations.
+ *
+ * @example
+ * ```typescript
+ * // In your build process, bundle migrations like:
+ * // export const bundledMigrations = {
+ * //   journal: require('./drizzle/meta/_journal.json'),
+ * //   migrations: {
+ * //     '0000_init': require('./drizzle/0000_init.sql'),
+ * //     '0001_add_users': require('./drizzle/0001_add_users.sql'),
+ * //   },
+ * // }
+ *
+ * const migrations = loadBundledDrizzleMigrations(bundledMigrations)
+ * ```
+ */
+export declare function loadBundledDrizzleMigrations(bundled: BundledDrizzleMigrations): Migration[];
+/**
+ * Generate a Drizzle-compatible migration ID
+ *
+ * Creates a migration ID in Drizzle's format: NNNN_snake_case_name
+ *
+ * @example
+ * ```typescript
+ * const id = generateDrizzleMigrationId(0, 'create_users')
+ * // '0000_create_users'
+ * ```
+ */
+export declare function generateDrizzleMigrationId(index: number, name: string): string;
+/**
+ * Generate a Drizzle-compatible journal entry
+ *
+ * @example
+ * ```typescript
+ * const entry = generateDrizzleJournalEntry(0, 'create_users')
+ * // { idx: 0, version: '20240115120000', when: 1705320000000, tag: 'create_users' }
+ * ```
+ */
+export declare function generateDrizzleJournalEntry(index: number, name: string, timestamp?: number): DrizzleJournalEntry;
+/**
+ * Create a migration in Drizzle-compatible format
+ *
+ * This is useful for writing migrations that can also be used
+ * with Drizzle's CLI tools.
+ *
+ * @example
+ * ```typescript
+ * const migration = createDrizzleMigration({
+ *   index: 0,
+ *   name: 'create_users',
+ *   up: `
+ *     CREATE TABLE users (
+ *       id SERIAL PRIMARY KEY,
+ *       email TEXT NOT NULL UNIQUE
+ *     );
+ *   `,
+ *   down: 'DROP TABLE users;',
+ * })
+ * ```
+ */
+export declare function createDrizzleMigration(options: {
+    index: number;
+    name: string;
+    up: string;
+    down?: string;
+    tags?: string[];
+}): Migration;
+/**
+ * Export migrations to Drizzle format
+ *
+ * Converts postgres.do migrations to Drizzle's format for
+ * compatibility with Drizzle tools.
+ *
+ * @example
+ * ```typescript
+ * const drizzleFormat = exportToDrizzleFormat(migrations)
+ * // {
+ * //   journal: { version: '7', dialect: 'postgresql', entries: [...] },
+ * //   files: [{ folderName: '0000_init', sql: '...' }, ...]
+ * // }
+ * ```
+ */
+export declare function exportToDrizzleFormat(migrations: Migration[]): {
+    journal: DrizzleJournal;
+    files: DrizzleMigrationFile[];
+};
+/**
+ * Validate that a migration is compatible with Drizzle
+ *
+ * @example
+ * ```typescript
+ * const issues = validateDrizzleCompatibility(migration)
+ * if (issues.length > 0) {
+ *   console.warn('Migration has compatibility issues:', issues)
+ * }
+ * ```
+ */
+export declare function validateDrizzleCompatibility(migration: Migration): string[];
+//# sourceMappingURL=drizzle-compat.d.ts.map

package/dist/migrations/drizzle-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-compat.d.ts","sourceRoot":"","sources":["../../src/migrations/drizzle-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAGhB;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAWnE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,MAAM,GACV,SAAS,CAcX;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,SAAS,EAAE,CAgBb;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC,SAAS,EAAE,CAEb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,CAqBrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,GAAG,SAAS,CAkBZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG;IAC9D,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,oBAAoB,EAAE,CAAA;CAC9B,CAoCA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAqB3E"}

package/dist/migrations/drizzle-compat.js

@@ -0,0 +1,273 @@
+/**
+ * Drizzle ORM Compatibility
+ *
+ * Utilities for integrating with Drizzle ORM's migration system.
+ * Allows loading Drizzle-generated migrations and converting them
+ * to postgres.do's format.
+ *
+ * @module migrations/drizzle-compat
+ */
+import { ValidationError, NotFoundError } from '@dotdo/postgres-shared/errors';
+/**
+ * Parse a Drizzle migration journal
+ *
+ * Drizzle uses a _journal.json file in the migrations folder
+ * to track migration history and ordering.
+ *
+ * @example
+ * ```typescript
+ * const journal = parseDrizzleJournal(journalContent)
+ * // { version: '5', dialect: 'postgresql', entries: [...] }
+ * ```
+ */
+export function parseDrizzleJournal(content) {
+    try {
+        const journal = JSON.parse(content);
+        return journal;
+    }
+    catch (error) {
+        throw new ValidationError('Failed to parse Drizzle journal', {
+            code: 'INVALID_FORMAT',
+            cause: error instanceof Error ? error : undefined,
+            context: { contentLength: content.length },
+        });
+    }
+}
+/**
+ * Convert a Drizzle journal entry to a migration
+ *
+ * @example
+ * ```typescript
+ * const migration = convertDrizzleEntry(entry, sqlContent)
+ * ```
+ */
+export function convertDrizzleEntry(entry, sql) {
+    // Clean up the SQL (remove Drizzle breakpoint comments)
+    const cleanSql = sql
+        .replace(/-->\s*statement-breakpoint\s*/g, '\n')
+        .trim();
+    return {
+        id: `${entry.idx.toString().padStart(4, '0')}_${entry.tag}`,
+        name: entry.tag.replace(/_/g, ' ').replace(/(^|\s)\w/g, (c) => c.toUpperCase()),
+        version: entry.idx + 1, // Convert 0-indexed to 1-indexed
+        up: cleanSql,
+        tags: ['drizzle'],
+        transactional: entry.breakpoints !== false,
+    };
+}
+/**
+ * Load migrations from Drizzle format
+ *
+ * This function takes a journal and a map of SQL files,
+ * and converts them to postgres.do migrations.
+ *
+ * @example
+ * ```typescript
+ * // Load from file system
+ * const journal = JSON.parse(readFileSync('drizzle/meta/_journal.json', 'utf-8'))
+ * const sqlFiles = {
+ *   '0000_init': readFileSync('drizzle/0000_init.sql', 'utf-8'),
+ *   '0001_add_users': readFileSync('drizzle/0001_add_users.sql', 'utf-8'),
+ * }
+ *
+ * const migrations = loadDrizzleMigrations(journal, sqlFiles)
+ * ```
+ */
+export function loadDrizzleMigrations(journal, sqlFiles) {
+    const migrations = [];
+    for (const entry of journal.entries) {
+        // Drizzle folder names are like "0000_init"
+        const folderName = `${entry.idx.toString().padStart(4, '0')}_${entry.tag}`;
+        const sql = sqlFiles[folderName] || sqlFiles[entry.tag];
+        if (!sql) {
+            throw new NotFoundError('MigrationFile', folderName);
+        }
+        migrations.push(convertDrizzleEntry(entry, sql));
+    }
+    return migrations.sort((a, b) => a.version - b.version);
+}
+/**
+ * Load bundled Drizzle migrations
+ *
+ * For Cloudflare Workers, migrations need to be bundled at build time.
+ * This function loads pre-bundled migrations.
+ *
+ * @example
+ * ```typescript
+ * // In your build process, bundle migrations like:
+ * // export const bundledMigrations = {
+ * //   journal: require('./drizzle/meta/_journal.json'),
+ * //   migrations: {
+ * //     '0000_init': require('./drizzle/0000_init.sql'),
+ * //     '0001_add_users': require('./drizzle/0001_add_users.sql'),
+ * //   },
+ * // }
+ *
+ * const migrations = loadBundledDrizzleMigrations(bundledMigrations)
+ * ```
+ */
+export function loadBundledDrizzleMigrations(bundled) {
+    return loadDrizzleMigrations(bundled.journal, bundled.migrations);
+}
+/**
+ * Generate a Drizzle-compatible migration ID
+ *
+ * Creates a migration ID in Drizzle's format: NNNN_snake_case_name
+ *
+ * @example
+ * ```typescript
+ * const id = generateDrizzleMigrationId(0, 'create_users')
+ * // '0000_create_users'
+ * ```
+ */
+export function generateDrizzleMigrationId(index, name) {
+    const paddedIndex = index.toString().padStart(4, '0');
+    const snakeCaseName = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_|_$/g, '');
+    return `${paddedIndex}_${snakeCaseName}`;
+}
+/**
+ * Generate a Drizzle-compatible journal entry
+ *
+ * @example
+ * ```typescript
+ * const entry = generateDrizzleJournalEntry(0, 'create_users')
+ * // { idx: 0, version: '20240115120000', when: 1705320000000, tag: 'create_users' }
+ * ```
+ */
+export function generateDrizzleJournalEntry(index, name, timestamp) {
+    const when = timestamp ?? Date.now();
+    const date = new Date(when);
+    // Generate version string in Drizzle's format: YYYYMMDDHHmmss
+    const version = [
+        date.getFullYear(),
+        (date.getMonth() + 1).toString().padStart(2, '0'),
+        date.getDate().toString().padStart(2, '0'),
+        date.getHours().toString().padStart(2, '0'),
+        date.getMinutes().toString().padStart(2, '0'),
+        date.getSeconds().toString().padStart(2, '0'),
+    ].join('');
+    return {
+        idx: index,
+        version,
+        when,
+        tag: name,
+        breakpoints: true,
+    };
+}
+/**
+ * Create a migration in Drizzle-compatible format
+ *
+ * This is useful for writing migrations that can also be used
+ * with Drizzle's CLI tools.
+ *
+ * @example
+ * ```typescript
+ * const migration = createDrizzleMigration({
+ *   index: 0,
+ *   name: 'create_users',
+ *   up: `
+ *     CREATE TABLE users (
+ *       id SERIAL PRIMARY KEY,
+ *       email TEXT NOT NULL UNIQUE
+ *     );
+ *   `,
+ *   down: 'DROP TABLE users;',
+ * })
+ * ```
+ */
+export function createDrizzleMigration(options) {
+    const { index, name, up, down, tags = [] } = options;
+    const id = generateDrizzleMigrationId(index, name);
+    const migration = {
+        id,
+        name: name.replace(/_/g, ' ').replace(/(^|\s)\w/g, (c) => c.toUpperCase()),
+        version: index + 1,
+        up: up.trim(),
+        tags: [...tags, 'drizzle'],
+        transactional: true,
+    };
+    if (down) {
+        migration.down = down.trim();
+    }
+    return migration;
+}
+/**
+ * Export migrations to Drizzle format
+ *
+ * Converts postgres.do migrations to Drizzle's format for
+ * compatibility with Drizzle tools.
+ *
+ * @example
+ * ```typescript
+ * const drizzleFormat = exportToDrizzleFormat(migrations)
+ * // {
+ * //   journal: { version: '7', dialect: 'postgresql', entries: [...] },
+ * //   files: [{ folderName: '0000_init', sql: '...' }, ...]
+ * // }
+ * ```
+ */
+export function exportToDrizzleFormat(migrations) {
+    const sorted = [...migrations].sort((a, b) => a.version - b.version);
+    const entries = [];
+    const files = [];
+    for (let i = 0; i < sorted.length; i++) {
+        const migration = sorted[i];
+        if (!migration)
+            continue;
+        const index = i;
+        const tag = migration.id.replace(/^\d+_/, '');
+        entries.push({
+            idx: index,
+            version: new Date().toISOString().replace(/[-:T.Z]/g, '').substring(0, 14),
+            when: Date.now(),
+            tag,
+            breakpoints: migration.transactional !== false,
+        });
+        files.push({
+            folderName: `${index.toString().padStart(4, '0')}_${tag}`,
+            sql: migration.up,
+            tag,
+        });
+    }
+    return {
+        journal: {
+            version: '7',
+            dialect: 'postgresql',
+            entries,
+        },
+        files,
+    };
+}
+/**
+ * Validate that a migration is compatible with Drizzle
+ *
+ * @example
+ * ```typescript
+ * const issues = validateDrizzleCompatibility(migration)
+ * if (issues.length > 0) {
+ *   console.warn('Migration has compatibility issues:', issues)
+ * }
+ * ```
+ */
+export function validateDrizzleCompatibility(migration) {
+    const issues = [];
+    // Check ID format (should be NNNN_snake_case)
+    if (!/^\d{4}_[a-z0-9_]+$/.test(migration.id)) {
+        issues.push(`ID "${migration.id}" should match Drizzle format: NNNN_snake_case`);
+    }
+    // Check for Drizzle-specific SQL features
+    if (migration.up.includes('---> statement-breakpoint')) {
+        issues.push('Migration contains raw Drizzle breakpoint comments');
+    }
+    // Check version is sequential from ID
+    const idPart = migration.id.split('_')[0];
+    const idVersion = idPart ? parseInt(idPart, 10) : NaN;
+    if (!isNaN(idVersion) && idVersion !== migration.version - 1) {
+        issues.push(`Version ${migration.version} doesn't match ID index ${idVersion}`);
+    }
+    return issues;
+}
+//# sourceMappingURL=drizzle-compat.js.map

package/dist/migrations/drizzle-compat.js.map

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

package/dist/migrations/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Migration System for postgres.do
+ *
+ * A complete migration system 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**: Each DO database is automatically
+ *   migrated to the latest schema version on first access.
+ * - **Drizzle ORM compatibility**: Works with Drizzle-generated migrations
+ *   and exports Drizzle-compatible schemas.
+ * - **Schema version tracking**: Each DO instance tracks its own schema version.
+ * - **Concurrent migration safety**: Advisory locks prevent race conditions.
+ * - **Rollback support**: Full support for down migrations.
+ * - **Type-safe schema generation**: Generate TypeScript types from schema.
+ *
+ * @module migrations
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import {
+ *   createMigrationRegistry,
+ *   createAutoMigrator,
+ *   defineMigration,
+ * } from '@dotdo/postgres/migrations'
+ *
+ * // Define migrations
+ * const migrations = [
+ *   defineMigration({
+ *     id: '0001_create_users',
+ *     name: 'Create users table',
+ *     version: 1,
+ *     up: `
+ *       CREATE TABLE users (
+ *         id SERIAL PRIMARY KEY,
+ *         email TEXT NOT NULL UNIQUE,
+ *         created_at TIMESTAMP DEFAULT NOW()
+ *       );
+ *     `,
+ *     down: `
+ *       DROP TABLE users;
+ *     `,
+ *   }),
+ * ]
+ *
+ * // Create auto-migrator for DO
+ * const migrator = createAutoMigrator({ migrations })
+ *
+ * // In your DO
+ * class PostgresDO {
+ *   async fetch(request: Request) {
+ *     await migrator.ensureMigrated(this.pglite)
+ *     // Handle request...
+ *   }
+ * }
+ * ```
+ *
+ * @example Drizzle Integration
+ * ```typescript
+ * import {
+ *   loadBundledDrizzleMigrations,
+ *   createAutoMigrator,
+ * } from '@dotdo/postgres/migrations'
+ *
+ * // Load Drizzle migrations bundled at build time
+ * import bundledMigrations from './drizzle-bundle'
+ *
+ * const migrations = loadBundledDrizzleMigrations(bundledMigrations)
+ * const migrator = createAutoMigrator({ migrations })
+ * ```
+ *
+ * @example Type Generation
+ * ```typescript
+ * import { generateSchemaTypes } from '@dotdo/postgres/migrations'
+ *
+ * const types = await generateSchemaTypes(pglite)
+ * console.log(types)
+ * // interface Users {
+ * //   id: number;
+ * //   email: string;
+ * //   created_at: Date | null;
+ * // }
+ * ```
+ */
+export type { Migration, MigrationStatus, MigrationDirection, MigrationRecord, MigrationInput, MigrationResult, BatchMigrationResult, MigrationProgressEvent, SchemaVersion, VersionComparison, QueryExecutor, MigrationRegistryConfig, MigrationRunnerConfig, MigrationLock, MigrationEventType, MigrationEvent, MigrationEventListener, RollbackOptions, RollbackProgressEvent, RollbackResult, BatchRollbackResult, RollbackHistoryRecord, RollbackEventType, RollbackEvent, RollbackEventListener, DrizzleMigrationFile, DrizzleJournalEntry, DrizzleJournal, } from './types';
+export { MigrationRegistry, MigrationValidationError, createMigrationRegistry, defineMigration, combineMigrations, createMigrationFromDrizzle, } from './registry';
+export type { ValidationResult } from './registry';
+export { MigrationRunner, MigrationError, createMigrationRunner, } from './runner';
+export { AutoMigrator, createAutoMigrator, withAutoMigration, } from './auto-migrator';
+export type { AutoMigratorConfig, AutoMigratorState, } from './auto-migrator';
+export { parseDrizzleJournal, convertDrizzleEntry, loadDrizzleMigrations, loadBundledDrizzleMigrations, generateDrizzleMigrationId, generateDrizzleJournalEntry, createDrizzleMigration, exportToDrizzleFormat, validateDrizzleCompatibility, } from './drizzle-compat';
+export type { BundledDrizzleMigrations } from './drizzle-compat';
+export { pgTypeToTs, introspectSchema, generateTableInterface, generateSchemaTypes, } from './schema-generator';
+export type { ColumnDefinition, IndexDefinition, TableDefinition, DatabaseSchema, } from './schema-generator';
+export { MigrationValidator, createMigrationValidator, validateMigration, validateMigrations, } from './validator';
+export type { ValidationSeverity, ValidationCategory, ValidationIssue, MigrationValidationResult, BatchValidationResult, DetectedOperation, ValidationOptions, } from './validator';
+export { SchemaCompatibilityValidator, createCompatibilityValidator, validateCompatibility, isBackwardCompatible, getSafeChanges, getBreakingChanges, } from './compatibility';
+export type { SchemaChangeType, SchemaChange, CompatibilityReport, CompatibilityOptions, } from './compatibility';
+export { BulkMigrationOrchestrator, createBulkMigrationOrchestrator, InMemoryBulkMigrationStorage, } from './bulk-orchestrator';
+export type { DOSelector, MigrationJobStatus, DOBulkMigrationJob, MigrationBatch, BulkMigrationProgress, MigrationQueueMessage, BulkOrchestratorConfig, BulkMigrationStorage, } from './bulk-orchestrator';
+export { createTestDatabase, createTestContext, testMigration, verifyMigrationSequence, testRollbackSequence, assertTableExists, assertTableNotExists, assertTableHasColumns, assertIndexExists, assertRowCount, createMockExecutor, } from './testing';
+export type { TestDatabase, ColumnInfo, ConstraintInfo, ForeignKeyInfo, TestMigrationOptions, TestMigrationResult, TestContextOptions, MigrationTestContext, } from './testing';
+export { MigrationProgressTracker, InMemoryProgressStorage, createProgressTracker, } from './progress-tracker';
+export type { MigrationOperationStatus, DOMigrationStatus, DOProgressState, ProgressStats, MigrationOperation, ProgressStorage, ProgressTrackerConfig, } from './progress-tracker';
+export { KVProgressStorage, createKVProgressStorage, } from './progress-tracker-kv';
+export type { KVProgressStorageConfig, } from './progress-tracker-kv';
+export { ProgressTrackerDO, DOProgressStorageClient, createDOProgressStorage, } from './progress-tracker-do';
+export type { ProgressTrackerDOInterface, } from './progress-tracker-do';
+//# sourceMappingURL=index.d.ts.map

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

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