uql-orm 0.9.5 → 0.10.2

package/dist/migrate/sync/schemaSync.js

@@ -0,0 +1,260 @@
+/**
+ * Schema Sync
+ *
+ * Orchestrates schema synchronization between entities and database
+ * with configurable direction modes.
+ */
+import { SchemaASTBuilder } from '../../schema/schemaASTBuilder.js';
+import { SchemaASTDiffer } from '../../schema/schemaASTDiffer.js';
+/**
+ * Service for synchronizing schemas between entities and database.
+ */
+export class SchemaSync {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Execute schema synchronization.
+     */
+    async sync() {
+        const direction = this.options.direction ?? 'bidirectional';
+        switch (direction) {
+            case 'entity-to-db':
+                return this.syncEntityToDb();
+            case 'db-to-entity':
+                return this.syncDbToEntity();
+            case 'bidirectional':
+                return this.syncBidirectional();
+        }
+    }
+    /**
+     * Sync from entities to database (push).
+     */
+    async syncEntityToDb() {
+        const entityAST = this.buildEntityAST();
+        const dbAST = await this.buildDatabaseAST();
+        const differ = new SchemaASTDiffer();
+        const diff = differ.diff(entityAST, dbAST);
+        // In safe mode, filter out destructive changes
+        const safeDiff = this.options.safe ? this.filterDestructiveChanges(diff) : diff;
+        return {
+            direction: 'entity-to-db',
+            success: true,
+            dbChanges: safeDiff,
+            entityChanges: undefined,
+            conflicts: [],
+            summary: this.formatSummary('entity-to-db', safeDiff),
+            details: {
+                db: this.getDiffCounts(safeDiff),
+                entity: { created: 0, dropped: 0, altered: 0 },
+            },
+        };
+    }
+    /**
+     * Sync from database to entities (pull).
+     */
+    async syncDbToEntity() {
+        const entityAST = this.buildEntityAST();
+        const dbAST = await this.buildDatabaseAST();
+        const differ = new SchemaASTDiffer();
+        // Diff in opposite direction: DB is source, entity is target
+        const diff = differ.diff(dbAST, entityAST);
+        // Apply safe mode if enabled
+        const safeDiff = this.options.safe ? this.filterDestructiveChanges(diff) : diff;
+        return {
+            direction: 'db-to-entity',
+            success: true,
+            dbChanges: undefined,
+            entityChanges: safeDiff,
+            conflicts: [],
+            summary: this.formatSummary('db-to-entity', safeDiff),
+            details: {
+                db: { created: 0, dropped: 0, altered: 0 },
+                entity: this.getDiffCounts(safeDiff),
+            },
+        };
+    }
+    /**
+     * Bidirectional sync with conflict detection.
+     */
+    async syncBidirectional() {
+        const entityAST = this.buildEntityAST();
+        const dbAST = await this.buildDatabaseAST();
+        const differ = new SchemaASTDiffer();
+        // Get both directions
+        const entityToDb = differ.diff(entityAST, dbAST);
+        const dbToEntity = differ.diff(dbAST, entityAST);
+        // Detect conflicts (changes in both directions for same elements)
+        const conflicts = this.detectConflicts(entityToDb, dbToEntity);
+        // Filter out conflicting changes
+        let safeEntityToDb = this.filterConflictingChanges(entityToDb, conflicts);
+        let safeDbToEntity = this.filterConflictingChanges(dbToEntity, conflicts);
+        // Apply safe mode if enabled
+        if (this.options.safe) {
+            safeEntityToDb = this.filterDestructiveChanges(safeEntityToDb);
+            safeDbToEntity = this.filterDestructiveChanges(safeDbToEntity);
+        }
+        return {
+            direction: 'bidirectional',
+            success: conflicts.length === 0,
+            dbChanges: safeEntityToDb,
+            entityChanges: safeDbToEntity,
+            conflicts,
+            summary: this.formatBidirectionalSummary(safeEntityToDb, safeDbToEntity, conflicts),
+            details: {
+                db: this.getDiffCounts(safeEntityToDb),
+                entity: this.getDiffCounts(safeDbToEntity),
+            },
+        };
+    }
+    /**
+     * Build SchemaAST from entities.
+     */
+    buildEntityAST() {
+        const builder = new SchemaASTBuilder();
+        return builder.fromEntities(this.options.entities);
+    }
+    /**
+     * Build SchemaAST from database.
+     */
+    async buildDatabaseAST() {
+        return this.options.introspector.introspect();
+    }
+    /**
+     * Filter destructive changes for safe mode.
+     */
+    filterDestructiveChanges(diff) {
+        return {
+            ...diff,
+            tablesToDrop: [], // Never drop tables in safe mode
+            columnDiffs: diff.columnDiffs.filter((d) => d.type !== 'drop'), // Never drop columns
+            indexDiffs: diff.indexDiffs.filter((d) => d.type !== 'drop'),
+            relationshipDiffs: diff.relationshipDiffs.filter((d) => d.type !== 'drop'),
+        };
+    }
+    /**
+     * Detect conflicts between bidirectional changes.
+     */
+    detectConflicts(entityToDb, dbToEntity) {
+        const conflicts = [];
+        // Find column alterations that exist in both directions (type conflicts)
+        const entityColAlters = new Map(entityToDb.columnDiffs.filter((d) => d.type === 'alter').map((d) => [`${d.table}.${d.column}`, d]));
+        for (const dbColDiff of dbToEntity.columnDiffs.filter((d) => d.type === 'alter')) {
+            const key = `${dbColDiff.table}.${dbColDiff.column}`;
+            const entityColDiff = entityColAlters.get(key);
+            if (entityColDiff) {
+                // Both sides want to alter the same column - conflict
+                conflicts.push({
+                    type: 'type_mismatch',
+                    table: dbColDiff.table,
+                    column: dbColDiff.column,
+                    entityValue: entityColDiff.expected?.type,
+                    dbValue: dbColDiff.expected?.type,
+                    suggestion: `Column has different types. Entity: ${this.formatType(entityColDiff.expected?.type)}, DB: ${this.formatType(dbColDiff.expected?.type)}`,
+                });
+            }
+        }
+        return conflicts;
+    }
+    /**
+     * Filter out conflicting changes.
+     */
+    filterConflictingChanges(diff, conflicts) {
+        const conflictKeys = new Set(conflicts.map((c) => `${c.table}.${c.column ?? ''}`));
+        return {
+            ...diff,
+            columnDiffs: diff.columnDiffs.filter((d) => !conflictKeys.has(`${d.table}.${d.column}`)),
+            tablesToAlter: diff.tablesToAlter.filter((t) => !conflictKeys.has(`${t.name}.`)),
+        };
+    }
+    /**
+     * Get counts of changes from a diff.
+     */
+    getDiffCounts(diff) {
+        return {
+            created: diff.tablesToCreate.length + diff.columnDiffs.filter((d) => d.type === 'add').length,
+            dropped: diff.tablesToDrop.length + diff.columnDiffs.filter((d) => d.type === 'drop').length,
+            altered: diff.columnDiffs.filter((d) => d.type === 'alter').length,
+        };
+    }
+    /**
+     * Format summary for single-direction sync.
+     */
+    formatSummary(direction, diff) {
+        const lines = [];
+        if (direction === 'entity-to-db') {
+            lines.push('Entity → Database Changes:');
+        }
+        else {
+            lines.push('Database → Entity Changes:');
+        }
+        if (diff.tablesToCreate.length > 0) {
+            lines.push(`  + ${diff.tablesToCreate.length} table(s) to create`);
+        }
+        if (diff.tablesToDrop.length > 0) {
+            lines.push(`  - ${diff.tablesToDrop.length} table(s) to drop`);
+        }
+        if (diff.columnDiffs.length > 0) {
+            const adds = diff.columnDiffs.filter((d) => d.type === 'add').length;
+            const drops = diff.columnDiffs.filter((d) => d.type === 'drop').length;
+            const alters = diff.columnDiffs.filter((d) => d.type === 'alter').length;
+            if (adds)
+                lines.push(`  + ${adds} column(s) to add`);
+            if (drops)
+                lines.push(`  - ${drops} column(s) to drop`);
+            if (alters)
+                lines.push(`  ~ ${alters} column(s) to alter`);
+        }
+        if (diff.indexDiffs.length > 0) {
+            lines.push(`  ${diff.indexDiffs.length} index change(s)`);
+        }
+        if (!diff.hasDifferences) {
+            lines.push('  Schema is already in sync.');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format summary for bidirectional sync.
+     */
+    formatBidirectionalSummary(entityToDb, dbToEntity, conflicts) {
+        const lines = [];
+        lines.push('Bidirectional Sync Report');
+        lines.push('========================\n');
+        if (conflicts.length > 0) {
+            lines.push(`⚠️  ${conflicts.length} conflict(s) require manual resolution:\n`);
+            for (const conflict of conflicts) {
+                lines.push(`  • ${conflict.table}.${conflict.column ?? ''}: ${conflict.suggestion}`);
+            }
+            lines.push('');
+        }
+        if (entityToDb.hasDifferences) {
+            lines.push('Entity → Database:');
+            lines.push(this.formatSummary('entity-to-db', entityToDb).split('\n').slice(1).join('\n'));
+            lines.push('');
+        }
+        if (dbToEntity.hasDifferences) {
+            lines.push('Database → Entity:');
+            lines.push(this.formatSummary('db-to-entity', dbToEntity).split('\n').slice(1).join('\n'));
+        }
+        if (!entityToDb.hasDifferences && !dbToEntity.hasDifferences && conflicts.length === 0) {
+            lines.push('✓ Schema is in sync.');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format type for display.
+     */
+    formatType(type) {
+        if (!type?.category)
+            return 'unknown';
+        return type.length ? `${type.category}(${type.length})` : type.category;
+    }
+}
+/**
+ * Create a SchemaSync instance.
+ */
+export function createSchemaSync(options) {
+    return new SchemaSync(options);
+}
+//# sourceMappingURL=schemaSync.js.map

package/dist/migrate/sync/schemaSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaSync.js","sourceRoot":"","sources":["../../../src/migrate/sync/schemaSync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AA2DlE;;GAEG;AACH,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,OAA0B;QAA1B,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAE3D;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC;QAE5D,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/B,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/B,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE3C,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEhF,OAAO;YACL,SAAS,EAAE,cAAc;YACzB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,SAAS;YACxB,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC;YACrD,OAAO,EAAE;gBACP,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAChC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;aAC/C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,6DAA6D;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAE3C,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEhF,OAAO;YACL,SAAS,EAAE,cAAc;YACzB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,SAAS;YACpB,aAAa,EAAE,QAAQ;YACvB,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC;YACrD,OAAO,EAAE;gBACP,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;gBAC1C,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;aACrC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAErC,sBAAsB;QACtB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAEjD,kEAAkE;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAE/D,iCAAiC;QACjC,IAAI,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC1E,IAAI,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAE1E,6BAA6B;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC;YAC/D,cAAc,GAAG,IAAI,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,SAAS,EAAE,eAAe;YAC1B,OAAO,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;YAC/B,SAAS,EAAE,cAAc;YACzB,aAAa,EAAE,cAAc;YAC7B,SAAS;YACT,OAAO,EAAE,IAAI,CAAC,0BAA0B,CAAC,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC;YACnF,OAAO,EAAE;gBACP,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC;gBACtC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,IAAsB;QACrD,OAAO;YACL,GAAG,IAAI;YACP,YAAY,EAAE,EAAE,EAAE,iCAAiC;YACnD,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,qBAAqB;YACrF,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;YAC5D,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAC3E,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,UAA4B,EAAE,UAA4B;QAChF,MAAM,SAAS,GAAmB,EAAE,CAAC;QAErC,yEAAyE;QACzE,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CACnG,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;YACjF,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrD,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE/C,IAAI,aAAa,EAAE,CAAC;gBAClB,sDAAsD;gBACtD,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,eAAe;oBACrB,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,MAAM,EAAE,SAAS,CAAC,MAAM;oBACxB,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI;oBACzC,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI;oBACjC,UAAU,EAAE,uCAAuC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE;iBACrJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,IAAsB,EAAE,SAAyB;QAChF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAEnF,OAAO;YACL,GAAG,IAAI;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACxF,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;SACjF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,IAAsB;QAC1C,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM;YAC7F,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,MAAM;YAC5F,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM;SACnE,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,SAAwB,EAAE,IAAsB;QACpE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,qBAAqB,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,mBAAmB,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;YACrE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;YACvE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;YACzE,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;YACrD,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,oBAAoB,CAAC,CAAC;YACxD,IAAI,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,qBAAqB,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,0BAA0B,CAChC,UAA4B,EAC5B,UAA4B,EAC5B,SAAyB;QAEzB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAEzC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,MAAM,2CAA2C,CAAC,CAAC;YAC/E,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvF,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAA6C;QAC9D,IAAI,CAAC,IAAI,EAAE,QAAQ;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC1E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/mongo/index.d.ts

@@ -0,0 +1,6 @@
+export { MongoSchemaGenerator } from '../migrate/generator/mongoSchemaGenerator.js';
+export * from './mongoDialect.js';
+export * from './mongodbNativeDialect.js';
+export * from './mongodbQuerier.js';
+export * from './mongodbQuerierPool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mongo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/mongo/index.js

@@ -0,0 +1,6 @@
+export { MongoSchemaGenerator } from '../migrate/generator/mongoSchemaGenerator.js';
+export * from './mongoDialect.js';
+export * from './mongodbNativeDialect.js';
+export * from './mongodbQuerier.js';
+export * from './mongodbQuerierPool.js';
+//# sourceMappingURL=index.js.map

package/dist/mongo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mongo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/mongo/mongoDialect.d.ts

@@ -0,0 +1,83 @@
+import { type Document, type Filter, ObjectId, type Sort } from 'mongodb';
+import type { DialectOptions } from '../dialect/abstractDialect.js';
+import { AbstractDialect } from '../dialect/abstractDialect.js';
+import type { DialectFeatures, EntityMeta, FieldValue, Query, QueryAggregate, QueryExclude, QueryOptions, QuerySelect, QuerySortMap, QueryVectorSearch, QueryWhere, RelationKey, Type } from '../type/index.js';
+import { type CallbackKey, type RelationRequestSummary } from '../util/index.js';
+export declare class MongoDialect extends AbstractDialect {
+    /** Default {@link DialectFeatures} for MongoDB; shared by {@link MongoSchemaGenerator}. */
+    static readonly defaultDialectFeatures: DialectFeatures;
+    readonly dialectName = "mongodb";
+    readonly insertIdStrategy = "last";
+    constructor(options?: DialectOptions);
+    private static readonly ID_KEY;
+    private static readonly VECTOR_INDEX_TYPES;
+    private static readonly AGGREGATE_OP_MAP;
+    where<E extends Document>(entity: Type<E>, where?: QueryWhere<E>, { softDelete }?: QueryOptions): Filter<E>;
+    /**
+     * Check if an object has operator keys (keys starting with $).
+     */
+    private hasOperatorKeys;
+    protected mapTableNameRow(row: {
+        table_name: string;
+    }): string;
+    /** String operators → { pattern: (v) => regex, caseInsensitive } */
+    private static readonly REGEX_OP_MAP;
+    /** MongoDB native operators — pass through as-is. */
+    private static readonly NATIVE_OPS;
+    /**
+     * Transform UQL operators to MongoDB operators.
+     */
+    private transformOperators;
+    select<E extends Document>(entity: Type<E>, select?: QuerySelect<E>, exclude?: QueryExclude<E>): Record<string, 1>;
+    sort<E extends Document>(entity: Type<E>, sort?: QuerySortMap<E>): Sort;
+    aggregationPipeline<E extends Document>(entity: Type<E>, q: Query<E>, relationSummary?: RelationRequestSummary<E>): MongoAggregationPipelineEntry<E>[];
+    normalizeIds<E extends Document>(meta: EntityMeta<E>, docs: E[] | undefined): E[] | undefined;
+    normalizeId<E extends Document>(meta: EntityMeta<E>, doc: E | undefined): E | undefined;
+    getIdValue<T extends IdValue>(value: T): T;
+    getPersistable<E extends Document>(meta: EntityMeta<E>, payload: E, callbackKey: CallbackKey): Partial<E>;
+    getPersistables<E extends Document>(meta: EntityMeta<E>, payload: E | E[], callbackKey: CallbackKey): Partial<E>[];
+    /**
+     * Build MongoDB aggregation pipeline stages from a QueryAggregate.
+     */
+    buildAggregateStages<E extends Document>(entity: Type<E>, q: QueryAggregate<E>): Record<string, unknown>[];
+    private buildHavingFilter;
+    /**
+     * Separate vector sort entries from regular sort entries.
+     * Returns `undefined` if no vector sort is present.
+     */
+    extractVectorSort<E extends Document>(sort: QuerySortMap<E> | undefined): ExtractedVectorSort<E> | undefined;
+    /**
+     * Build a `$vectorSearch` aggregation pipeline stage.
+     * Merges `$where` into `$vectorSearch.filter` for optimal pre-filtering.
+     */
+    buildVectorSearchStage<E extends Document>(entity: Type<E>, meta: EntityMeta<E>, key: string, search: QueryVectorSearch, where: QueryWhere<E> | undefined, limit: number): Record<string, unknown>;
+}
+export type MongoAggregationPipelineEntry<E extends Document> = {
+    $lookup?: MongoAggregationLookup<E>;
+    $match?: Filter<E> | Record<string, unknown>;
+    $sort?: Sort;
+    $unwind?: MongoAggregationUnwind;
+    $group?: Record<string, unknown>;
+    $project?: Record<string, unknown>;
+    $skip?: number;
+    $limit?: number;
+};
+type MongoAggregationLookup<E extends Document> = {
+    readonly from?: string;
+    readonly foreignField?: string;
+    readonly localField?: string;
+    readonly pipeline?: MongoAggregationPipelineEntry<FieldValue<E>>[];
+    readonly as?: RelationKey<E>;
+};
+type MongoAggregationUnwind = {
+    readonly path?: string;
+    readonly preserveNullAndEmptyArrays?: boolean;
+};
+type IdValue = string | ObjectId;
+export type ExtractedVectorSort<E> = {
+    readonly vectorKey: string;
+    readonly vectorSearch: QueryVectorSearch;
+    readonly regularSort: QuerySortMap<E>;
+};
+export {};
+//# sourceMappingURL=mongoDialect.d.ts.map

package/dist/mongo/mongoDialect.d.ts.map

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