@zintrust/d1-migrator 0.4.0

package/dist/cli/ProgressTracker.js

@@ -0,0 +1,95 @@
+/**
+ * Progress Tracker
+ * Tracks migration progress and provides status updates
+ */
+import { Logger } from '@zintrust/core';
+/**
+ * ProgressTracker - Sealed namespace for progress tracking
+ * Provides migration progress monitoring and reporting
+ */
+export const ProgressTracker = Object.freeze({
+    /**
+     * Create new progress tracker
+     */
+    create(migrationId) {
+        return {
+            migrationId,
+            startTime: new Date(),
+            currentTable: '',
+            table: '',
+            totalTables: 0,
+            totalRows: 0,
+            processedRows: 0,
+            percentage: 0,
+            errors: {},
+            status: 'pending',
+        };
+    },
+    /**
+     * Update progress
+     */
+    update(progress, updates) {
+        const updated = { ...progress, ...updates };
+        // Log progress updates
+        if (updates.currentTable && updates.currentTable !== progress.currentTable) {
+            Logger.info(`Migrating table: ${updates.currentTable}`);
+        }
+        if (updates.processedRows !== undefined) {
+            const percentage = progress.totalRows > 0 ? Math.round((updates.processedRows / progress.totalRows) * 100) : 0;
+            Logger.info(`Progress: ${updates.processedRows}/${progress.totalRows} (${percentage}%)`);
+        }
+        return updated;
+    },
+    /**
+     * Add error to progress
+     */
+    addError(progress, table, error) {
+        const updated = {
+            ...progress,
+            errors: {
+                ...progress.errors,
+                [table]: error,
+            },
+            status: 'failed',
+        };
+        Logger.error(`Migration error for table ${table}: ${error}`);
+        return updated;
+    },
+    /**
+     * Mark as completed
+     */
+    complete(progress) {
+        const completed = {
+            ...progress,
+            status: 'completed',
+        };
+        Logger.info(`Migration completed: ${progress.migrationId}`);
+        return completed;
+    },
+    /**
+     * Generate progress report
+     */
+    generateReport(progress) {
+        const startTime = progress.startTime || new Date();
+        const duration = Date.now() - startTime.getTime();
+        const durationMinutes = Math.round(duration / 60000);
+        let report = '# Migration Progress Report\n\n';
+        report += `## Migration ID: ${progress.migrationId}\n`;
+        report += `## Status: ${progress.status}\n`;
+        report += `## Duration: ${durationMinutes} minutes\n\n`;
+        report += `## Tables\n`;
+        report += `- Completed: ${progress.processedRows}/${progress.totalRows}\n`;
+        report += `- Current: ${progress.currentTable || 'None'}\n\n`;
+        report += `## Rows\n`;
+        report += `- Migrated: ${progress.processedRows}/${progress.totalRows}\n`;
+        const percentage = progress.totalRows > 0 ? Math.round((progress.processedRows / progress.totalRows) * 100) : 0;
+        report += `- Progress: ${percentage}%\n\n`;
+        if (progress.errors && Object.keys(progress.errors).length > 0) {
+            report += `## Errors\n`;
+            Object.values(progress.errors).forEach((error, index) => {
+                report += `${index + 1}. ${error}\n`;
+            });
+        }
+        return report;
+    },
+});

package/dist/cli/SchemaAnalyzer.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Schema Analyzer
+ * Analyzes database schemas for migration compatibility
+ */
+import type { ColumnSchema, DatabaseSchema, ForeignKeySchema, IndexSchema, TableConstraint, TableRelationship, TableSchema } from '../types';
+export interface IDatabaseAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query(sql: string, parameters: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount?: number;
+    }>;
+    queryOne(sql: string, parameters: unknown[]): Promise<Record<string, unknown> | null>;
+    ping(): Promise<void>;
+    transaction<T>(callback: (adapter: IDatabaseAdapter) => Promise<T>): Promise<T>;
+    rawQuery<T = unknown>(sql: string, parameters?: unknown[]): Promise<T[]>;
+    ensureMigrationsTable?(): Promise<void>;
+    getType(): string;
+    isConnected(): boolean;
+    getPlaceholder(index: number): string;
+}
+/**
+ * SchemaAnalyzer - Sealed namespace for schema analysis
+ * Provides database schema analysis and compatibility checking
+ */
+export declare const SchemaAnalyzer: Readonly<{
+    /**
+     * Analyze source database schema
+     */
+    analyzeSchema(connection: {
+        driver: string;
+        connectionString: string;
+    }): Promise<DatabaseSchema>;
+    /**
+     * Extract tables from source database
+     */
+    extractTables(connection: {
+        driver: string;
+        connectionString: string;
+    }): Promise<TableSchema[]>;
+    /**
+     * Extract relationships from source database
+     */
+    extractRelationships(_connection: {
+        driver: string;
+        connectionString: string;
+    }, _tables: TableSchema[]): Promise<TableRelationship[]>;
+    /**
+     * Extract constraints from source database
+     */
+    extractConstraints(_connection: {
+        driver: string;
+        connectionString: string;
+    }, _tables: TableSchema[]): Promise<TableConstraint[]>;
+    /**
+     * Check schema compatibility with D1
+     */
+    checkD1Compatibility(schema: DatabaseSchema): {
+        compatible: boolean;
+        issues: string[];
+        warnings: string[];
+    };
+    /**
+     * Check if column type is supported by D1
+     */
+    isSupportedType(type: string): boolean;
+    /**
+     * Check if table name is valid for D1
+     */
+    isValidTableName(name: string): boolean;
+    /**
+     * Generate schema analysis report
+     */
+    generateReport(schema: DatabaseSchema): string;
+    /**
+     * Get table list from database based on driver type
+     */
+    getTableList(adapter: IDatabaseAdapter, driver: string): Promise<string[]>;
+    /**
+     * Get detailed schema for a specific table
+     */
+    getTableSchema(adapter: IDatabaseAdapter, tableName: string, driver: string): Promise<TableSchema>;
+    /**
+     * Get column information for a table
+     */
+    getTableColumns(adapter: IDatabaseAdapter, tableName: string, driver: string): Promise<ColumnSchema[]>;
+    /**
+     * Get primary key for a table
+     */
+    getPrimaryKey(adapter: IDatabaseAdapter, tableName: string, driver: string): Promise<string | null>;
+    /**
+     * Normalize data type from different database systems to D1-compatible types
+     */
+    normalizeDataType(dataType: string, _driver: string): string;
+    /**
+     * Get indexes for a table
+     */
+    getTableIndexes(adapter: IDatabaseAdapter, tableName: string, driver: string): Promise<IndexSchema[]>;
+    /**
+     * Build index query for specific driver
+     */
+    buildIndexQuery(tableName: string, driver: string): string | null;
+    /**
+     * Process index results into IndexSchema format
+     */
+    processIndexResults(result: {
+        rows: Record<string, unknown>[];
+    }, driver: string): IndexSchema[];
+    /**
+     * Check if index is unique based on driver-specific data
+     */
+    isIndexUnique(row: Record<string, unknown>, driver: string): boolean;
+    /**
+     * Get foreign keys for a table
+     */
+    getForeignKeys(adapter: IDatabaseAdapter, tableName: string, driver: string): Promise<ForeignKeySchema[]>;
+    /**
+     * Build foreign key query for specific driver
+     */
+    buildForeignKeyQuery(tableName: string, driver: string): string | null;
+    /**
+     * Process foreign key row into ForeignKeySchema format
+     */
+    processForeignKeyRow(row: Record<string, unknown>, tableName: string): ForeignKeySchema;
+    /**
+     * Map referential action string to enum value
+     */
+    mapReferentialAction(action: string): "CASCADE" | "SET NULL" | "RESTRICT";
+}>;
+//# sourceMappingURL=SchemaAnalyzer.d.ts.map

package/dist/cli/SchemaAnalyzer.d.ts.map

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